建立以指示為基礎的封裝
以指示為基礎的封裝可讓您建立用於定義 Edge 應執行的一組指示的封裝。eMessage 連接器內建了對以指示為基礎之封裝的支援。
完成下列步驟來建立以指示為基礎的封裝：
1. 從 ThingWorx Software Content Management 左窗格中的「封裝」部份下，導覽至 > 。
「建立封裝」頁即會出現。
2. 在「封裝名稱」欄位中，輸入封裝名稱。
3. 在「封裝描述」欄位中，輸入封裝的簡短描述。
4. 在「版本」欄位中，輸入封裝的版本編號。
下列規則適用於封裝的版本：
◦ 您必須輸入主要封裝版本編號。
◦ 只能輸入非負整數。
◦ 在版本欄位的每個方塊中，您可以針對封裝版本，輸入長度上限為 4 的數值字串，如下圖所示：
| 依預設，主版本編號會填入 1，並會將剩餘欄位的值視為 0。以下是無效值的範例： • 如果「版本」欄位的最後一個欄位中有值，則前面欄位的空白值無效，其會以紅色反白，如下所示： 在空白欄位中輸入下列值 (或其他任何值)，而不是將欄位保留空白： • 如果您在任何欄位中輸入負值，該特定欄位會以紅色反白，如下所示： 在欄位中僅輸入非負整數來修正該錯誤。 • 如果您在任何欄位中輸入字母或英數字元字串，該特定欄位會以紅色反白，如下所示： 在欄位中僅輸入非負整數來修正該錯誤。 |
5. 欲指示封裝是否有到期日，請從「到期」欄位中選取下列其中一個選項：
◦ 「從不」- 封裝不會到期。依預設，此選項會將到期日設定為距離建立封裝日期的 100 年。
◦ 「日期」- 使用日期與時間選取器小器具可指定您想讓封裝到期的日期。
| 您無法建立具有相同名稱與版本編號的兩個封裝。如果顯示一則訊息，表示封裝名稱與版本已存在，請提供具唯一性的名稱及版本組合。 |
6. 選取「以指示為基礎的封裝」標籤。
7. 按一下「新增指示」，選取您要遞送至資產的指示類型。
8. 在「指示類型」清單中選取下列其中一個選項：
◦ 「下載」- 可從 ThingWorx 存放庫中選取您要下載至代理程式的檔案。
完成下列步驟來從 ThingWorx 存放庫新增檔案：
1. 「目標存放庫」欄位會在
「部署組態」頁上顯示已配置的
「下載目標存放庫」。按一下
可修改已配置的下載存放庫。
2. 「目錄結構」部份顯示所選存放庫的內容。
您可在「目錄結構」部份下執行下列動作：
▪ 如果所選存放庫中沒有要遞送至資產的檔案，則按一下
可將檔案上載至
ThingWorx 存放庫。
▪ 按一下
可將檔案下載至電腦中的預設下載位置。
▪ 按一下
可從存放庫刪除檔案。
3. 在「目錄結構」部份下，導覽至您要下載至資產的檔案，然後在「目錄內容」部份下，選取要在「所選內容壓縮檔名稱」欄位中顯示其名稱的檔案。
在「目錄內容」部份下，下列資訊適用於每個檔案：
▪ 「名稱」- 如果檔案在 ThingWorx 存放庫中可用，該欄位會指定檔案的名稱，且包含副檔名。如果將檔案上載至存放庫，則會將時間戳記 (紀元時間) 附加至檔案名稱。此時間戳記可區分具有相同名稱的兩個檔案。
▪ 「上載日期」- 指定將檔案新增至 ThingWorx 存放庫的日期與時間。
▪ 「大小」- 指定檔案的大小，以位元組為單位。
▪ 「路徑」- 指定 ThingWorx 存放庫中檔案的絕對路徑。
4. 在「目的地目錄」欄位中，指定資產中您要下載檔案的位置。
5. 如果您已在「目的地目錄」欄位中提供絕對路徑，請選取「目的地目錄是絕對路徑」核取方塊。此為選用選項。依預設，不會選取此選項。
6. 如果您想讓 Edge 裝置在下載檔案之後解壓縮該檔案，請選取「下載後代理程式會解壓縮此檔案」核取方塊。此為選用選項。依預設，不會選取此選項。
| eMessage 代理程式只能解壓縮 tar.gz 格式的檔案。 欲解壓縮其他任何格式的檔案，請新增包含解壓縮可執行檔的「執行」指示。 |
7. 如果您要在檔案下載至指定目錄時覆寫現有檔案，請選取「此檔案下載至指定目錄時覆寫現有檔案」核取方塊。此為選用選項。依預設，不會選取此選項。
8. 按一下「新增」，將指示新增至指示清單。
◦ 「執行」- 可對遠端物件執行指令。
完成下列步驟來對物件執行指令：
1. 在「可執行檔」欄位中，輸入您要執行的指令。
2. 在「引數」欄位中，指定您在「可執行檔」欄位中定義的指令的引數。此欄位是選用欄位。
| 所執行的指令是「可執行檔」與「引數」欄位的值的組合。 |
3. 如果可執行檔的路徑是絕對路徑，請選取「可執行檔路徑是絕對路徑」核取方塊。
依預設，不會選取此選項。
4. 按一下「新增」，將指示新增至指示清單。
◦ 「上載」- 允許 Axeda eMessage 代理程式將一或多個檔案上載至 ThingWorx 平台。
1. 在
「目標存放庫」欄位中，按一下
來選取您要將檔案上載到的存放庫。
您可建立用於上載的檔案存放庫，並選取該檔案存放庫，例如 UploadRepository。
2. 在「目標路徑」欄位中，指定要在其中儲存已上載檔案的存放庫的位置。
例如：/UploadFiles 可將檔案儲存至 /UploadRepository/UploadFiles 目錄。
/ 值將已上載的檔案儲存至 UploadRepository 目錄。
| 檔案會儲存在以上載檔案之物件命名的目錄下。此物件目錄位於「目標存放庫/目標路徑」欄位的值所代表的目錄下。 例如，如果封裝已部署至 MyThing 物件，且「目標存放庫/目標路徑」欄位的值為 /UploadRepository/UploadFiles，則檔案將上載至 /UploadRepository/UploadFiles/MyThing 目錄。 |
| 如果「目標路徑」欄位中指定的路徑不存在，則它會在部署期間在「目標存放庫」下建立路徑。 |
3. 在
旁邊的欄位中，鍵入您要上載的檔案的名稱，然後按一下
。您可以在檔案名稱中包含如 * 或 ? 萬用字元項目。使用 * 可表示多個字元，而 ? 表示單一字元。請確保此檔案存在於您的裝置的相對路徑中。
Linux 代理程式允許使用萬用字元 (*,?)。針對在 Windows 上執行的代理程式，? 字元與 * 字元具有相同的效果。
| ThingWorx Software Content Management 不支援絕對路徑。 |
「要上載的檔案」部份會顯示必須要上載至
ThingWorx 平台的檔案清單。如果您要從清單中刪除任何檔案，可在清單中選取該項目，然後按一下
。
4. 按一下「新增」，將指示新增至指示清單。
◦ 「重新啟動」- 可重新啟動代理程式。
1. 選取「硬重啟。取消核取後變為軟重啟」核取方塊可終止目前代理程式流程，並啟動新的代理程式流程。「硬重啟。取消核取後變為軟重啟」預設為已選取。
如果您不想終止目前代理程式流程，只想重新初始化所有元件並從磁碟重新載入資料，請務必清除「硬重啟。取消核取後變為軟重啟」核取方塊。此為軟重啟。
2. 按一下「新增」，將指示新增至指示清單。
| 請確保「重新啟動」指示是指示清單中的最後一個指示。 |
9. 審核指示清單中的指示，其提供下列詳細資訊：
◦ 「順序」- 指定對代理程式執行指示的順序。
◦ 「類型」- 將指示類型指定為下列其中一項：
▪ 下載
▪ 執行
▪ 上載
▪ 「重新啟動」
◦ 「詳細資訊」- 指定您在建立指示時指定的指示詳細資訊。
從清單中選取指示，並使用下列其中一個選項修改指示：
◦ 按一下
可編輯指示。
◦ 按一下
或
可重新排序指示。
| 請確保指示清單中只有一個「重新啟動」指示，且「重新啟動」指示是指示清單中的最後一個指示。 |
◦ 按一下
可刪除指示。
10. 按一下「儲存」，儲存封裝。
「新增或修改相依性」頁即會出現。新增或修改相依性是選用步驟。如需詳細資訊，請參閱
新增或修改封裝相依性。
11. 如果您已新增封裝相依性，請按一下「儲存」。
「建立測試部署」頁即會顯示。建立測試部署是選用步驟。如需詳細資訊，請參閱
測試封裝部署。
12. 或者，您也可以指定要為特定使用者或使用者群組提供的存取層級。如需詳細資訊，請參閱
指定使用者存取控制。
