建立以檔案為基礎的封裝
ThingWorx WebSocket 式 Edge MicroServer (WS EMS) 與 C SDK 支援以檔案為基礎的封裝。
完成下列步驟來建立以檔案為基礎的封裝:
1. 從 ThingWorx Software Content Management 左窗格中的「封裝」部份下,導覽至 > 。
2. 在「封裝名稱」欄位中,輸入封裝名稱。
3. 在「封裝描述」欄位中,輸入封裝的簡短描述。
4. 在「版本」欄位中,輸入封裝的版本編號。
下列規則適用於封裝的版本:
◦ 您必須輸入主要封裝版本編號。
◦ 只能輸入非負整數。
◦ 在版本欄位的每個方塊中,您可以針對封裝版本,輸入長度上限為 4 的數值字串,如下圖所示:
| 依預設,主版本編號會填入 1,並會將剩餘欄位的值視為 0。以下是無效值的範例: • 如果「版本」欄位的最後一個欄位中有值,則前面欄位的空白值無效,其會以紅色反白,如下所示: 在空白欄位中輸入下列值 (或其他任何值),而不是將欄位保留空白: • 如果您在任何欄位中輸入負值,該特定欄位會以紅色反白,如下所示: 在欄位中僅輸入非負整數來修正該錯誤。 • 如果您在任何欄位中輸入字母或英數字元字串,該特定欄位會以紅色反白,如下所示: 在欄位中僅輸入非負整數來修正該錯誤。 |
5. 欲指示封裝是否有到期日,請從「到期」欄位中選取下列其中一個選項:
◦ 「從不」- 封裝不會到期。依預設,此選項會將到期日設定為距離建立封裝日期的 100 年。
◦ 「日期」- 使用日期選取器可選取日期與時間選取器小器具。
| 您無法建立具有相同名稱與版本編號的兩個封裝。如果顯示一則訊息,表示封裝名稱與版本已存在,請提供具唯一性的名稱及版本組合。 |
6. 欲將資產類型 (「物範本」) 關聯至封裝,請從「資產類型」實體選擇器中選取資產類型。依預設,此實體選擇器會根據 ThingWorx Software Content Management 組態中所述組態列出所有「物範本」。
如果您為必須接收以檔案為基礎之封裝的資產選取物範本,則只會顯示「以檔案為基礎的封裝」標籤,「以指示為基礎的封裝」標籤會隱藏。
實體選擇器中顯示的資產類型也取決於「封裝類型」組態。如需詳細資訊,請參閱
封裝類型。如果僅將
「以檔案為基礎的封裝」類型選取為可見,則只有支援「以檔案為基礎的封裝」的範本會顯示在實體選擇器中。
如果您為必須接收以檔案為基礎之封裝的資產選取物範本,則只會顯示「以檔案為基礎的封裝」標籤,「以指示為基礎的封裝」標籤會隱藏。
實體選擇器中顯示的資產類型也取決於「封裝類型」組態。如需詳細資訊,請參閱
封裝類型。如果僅將
「以檔案為基礎的封裝」類型選取為可見,則只有支援「以檔案為基礎的封裝」的範本會顯示在實體選擇器中。
選取「以檔案為基礎的封裝」標籤。
「目錄結構」部份顯示 TW.RSM.Thing.FileRepository 目錄的內容。
您可在「目錄結構」部份下執行下列動作:
• 如果
TW.RSM.Thing.FileRepository 資料夾中沒有要遞送至資產的指令集檔案,按一下
可將檔案上載至
ThingWorx 存放庫。
• 按一下
可將檔案下載至電腦中的預設下載位置。
• 按一下
可從存放庫刪除檔案。
在「目錄結構」部份下,導覽至您要遞送至資產的指令集檔案,然後在「目錄內容」部份下,選取要在「所選內容壓縮檔名稱」欄位中顯示其名稱的指令集檔案。
在「目錄內容」部份下,下列資訊適用於每個檔案:
• 「名稱」- 如果檔案在 ThingWorx 存放庫中可用,該欄位會指定檔案的名稱,且包含副檔名。如果將檔案上載至存放庫,則會將時間戳記 (紀元時間) 附加至檔案名稱。此時間戳記可區分具有相同名稱的兩個檔案。
• 「上載日期」- 指定將檔案新增至 ThingWorx 存放庫的日期與時間。
• 「大小」- 指定檔案的大小,以位元組為單位。
• 「路徑」- 指定 ThingWorx 存放庫中檔案的絕對路徑。
在「壓縮檔中的指示檔名稱」欄位中,輸入所選壓縮檔中包含之指示檔案的完整名稱。
按一下「儲存」,儲存封裝。
「新增或修改相依性」頁即會出現。新增或修改相依性是選用步驟。如需詳細資訊,請參閱
新增或修改封裝相依性。
如果您已新增封裝相依性,請按一下「儲存」。
「建立測試部署」頁即會顯示。建立測試部署是選用步驟。如需詳細資訊,請參閱
測試封裝部署。
或者,您也可以指定要為特定使用者或使用者群組提供的存取層級。如需詳細資訊,請參閱
指定使用者存取控制。