檔案傳輸子系統
檔案傳輸子系統提供在「遠端物件」、檔案存放庫和聯合伺服器之間管理檔案傳輸所需的方法。
除非指定，否則 Edge 用戶端與 ThingWorx Platform 之間的檔案傳輸需要從開始到結束全程與用戶端連線。使用可佇列功能指示 ThingWorx Platform 執行複製動作即可使 Edge 用戶端斷線，進而可啟動 ThingWorx Platform 檔案傳輸。代理程式連線後，系統隨即將可佇列檔案放入離線佇列並執行。
 |
如果您要以 PostgreSQL 作為持續性提供者，離線佇列會持續存在，以支援 ThingWorx 高可用性容錯移轉。
|
啟動傳輸後，Edge 用戶端無法中斷連線或轉換會失敗。若無法在「可佇列檔案傳輸的即時時間 (以秒計)」組態設定值之前開始，排入佇列的檔案傳輸作業將會逾時。
通常情況下，檔案傳輸操作由 ThingWorx Platform 所控制。但是，您可以進行由 Edge 控制的檔案傳輸作業，將 EdgeControlled「物形式」新增至參與檔案傳輸作業的「遠端物件」即可啟動。若是由 Edge 控制的檔案傳輸操作，必須在 ThingWorx Platform 上將來源或目的地設定成 FileRepository 物件。進行 Edge 控制的檔案傳輸作業時，傳輸作業由 Edge 用戶端控制。Edge 會呼叫 Touch 服務，以在作業執行時更新檔案傳輸的時間戳記。如果 Edge 未執行此操作，ThingWorx Platform 的檔案傳輸操作就會逾時。Edge 會指出傳輸成功，或是已完成但有錯誤。
您可以在啟動檔案傳輸時，透過提供 metadata 參數來內嵌前後關聯。此欄位是可包含任何任意 JSON 的 JSON 物件。某些基本功能會造成 ThingWorx Platform 使用此欄位來為 Edge 用戶端提供其他指示。進行這些傳輸操作時，metadata 欄位中的資訊不應由 ThingWorx Platform 以外的任何處理流程所修改。
聯合伺服器之間的檔案傳輸
欲在聯合伺服器之間傳輸檔案，執行下列操作：
2. 使用 FileRepository 物範本將 ThingA 新增至 ServerA。
a. 為 ThingA 選取「已發佈」核取方塊，以使其能夠由其他 ThingWorx 伺服器存取。
3. 使用 RemoteThingWithFileTransfer 物範本將 RemoteThingA 新增至 ServerB。
a. 在「識別元」欄位中，輸入 ThingA@ServerA。
4. 將檔案 (例如，test.txt) 複製到 ServerB 的 SystemRepository 根資料夾。
5. 在 ServerB 上開啟 FileTransferSubsystem，並藉由下列參數值執行 copy 服務：
◦ sourceRepo：SystemRepository
◦ sourcePath: /
◦ sourceFile: test.txt
◦ targetRepo: RemoteThingA
◦ targetPath: /
◦ targetFile: test.txt
◦ 請勿變更其他參數的預設值。
6. 轉至 ServerA 上的 /ThingworxStorage/repository/ThingA 資料夾，並核對是否在此成功複製 test.txt 檔案。
組態
|
檔案傳輸設定
|
資料類型
|
預設
|
註記
|
|---|---|---|---|
|
分配到檔案轉換集區的最小執行緒
|
NUMBER
|
10
|
|
|
分配到檔案轉換集區的最大執行緒
|
NUMBER
|
10
|
如果 ThingWorx 離線，非同步檔案傳輸可能會遺失。例如，此設定的預設值是 10，卻提交了 50 個長執行時間的檔案傳輸作業。如果 ThingWorx 離線，其餘 40 項作業就會遺失。
|
|
新增新工作執行緒前最大佇列項目
|
NUMBER
|
100
|
允許的一次最大使用中傳輸作業數。
|
|
閒置執行緒逾時 (以秒計)
|
NUMBER
|
600000
|
|
|
檔案傳輸閒置逾時 (以秒計)
|
NUMBER
|
30
|
|
|
最大檔案傳輸區塊大小 (以位元計)
|
NUMBER
|
128000
|
此變數會在系統層級進行檔案傳輸時形成最大區塊大小。EMS 組態仍具有優先權，但是如果用較大的 buffer_size (比此變數中配置的值還大) 來配置 EMS，則此變數會選用此區塊大小。如果透過 EMS 配置較大的區塊大小 (128 KB)，必須增加此值。最大編譯層級為 1 MB。
|
|
最大檔案傳輸大小 (以位元計)
|
NUMBER
|
100000000
|
如果來源檔案大於此值，傳輸作業就會失敗，且系統會顯示錯誤訊息。
|
|
離線佇列內所允許的最大檔案傳輸
|
NUMBER
|
50000
|
|
|
離線佇列內所允許的每一物件最大檔案傳輸
|
NUMBER
|
10
|
|
|
可佇列檔案傳輸的即時時間 (以秒計)
|
NUMBER
|
86400
|
在此指定的時間量過後，系統會將檔案傳輸作業從離線佇列中移除。
|
|
所允許的 Edge 控制的最大檔案傳輸總數
|
NUMBER
|
500
|
跨平台間的總同步 Edge 控制傳輸範圍介於 1-1000 項傳輸。這不同於最大的允許始終上線傳輸 (由「新增新工作執行緒前最大佇列項目」設定控制)。
|
|
每個物件所允許的 Edge 控制的最大檔案傳輸總數
|
NUMBER
|
2
|
在 Edge 控制的「物件」間來回傳輸的最大允許同步傳輸數。範圍介於 1-100 項傳輸。例如，值為 2，表示在指定時間內一個 Edge 控制「物件」只能有兩項使用中傳輸作業 (上載或下載)。系統會拒絕後續的取消檔案傳輸輸出要求，直到有容量空出為止。
|
|
Edge 控制的檔案傳輸閒置逾時 (以秒計)
|
NUMBER
|
600
|
使用中作業可維持使用中狀態而不遭到變更的最大時間 (例如，資料傳輸作業或工作狀態更新作業)。範圍是 1-3600 秒。這類似於始終上線傳輸作業的閒置逾時設定，但這通常時間較長，才適用於輪詢裝置的偵測循環。
|