指定以指示為基礎之封裝的內容
在您完成
建立以指示為基礎之封裝的先決條件與
建立封裝的步驟 1 至 6 之後,請執行下列操作來指定以指示為基礎之封裝的內容:
1. 在「建立封裝」頁中,選取「以指示為基礎的封裝」標籤。
2. 欲選取您要遞送至資產的指示類型,請按一下「新增指示」。
3. 從「指示類型」清單中,選取下列指示之一,然後完成相關聯的步驟。此程序之後的部份中提供了每種指示類型的詳細資訊。
4. 如果您要新增其他指示,請重複步驟 3。您可以將多個指示新增至單一以指示為基礎的封裝。
5. 審核指示清單中的指示,其提供下列詳細資訊:
◦ 「順序」- 指定對代理程式執行指示的順序。
◦ 「類型」- 指定指示的類型。
◦ 「詳細資訊」- 指定您在建立指示時指定的指示詳細資訊。
從清單中選取指示,並使用下列其中一個選項修改指示:
◦ 欲編輯指示,請按一下

。
◦ 欲重新排序指示,請按一下

或

。
|
|
請確保清單中只有一個「重新啟動」指示,且「重新啟動」指示是最後一個指示。
|
◦ 欲刪除指示,請按一下

。
6. 按一下「儲存」,儲存封裝。
以下幾部份提供定義每種指示類型的詳細資訊:
下載
欲從 ThingWorx 存放庫中選取您要下載至代理程式的檔案,請完成下列步驟:
1. 「目標存放庫」欄位會顯示適用於下載的已配置目標存放庫。欲變更目標下載存放庫,請按一下

,然後按一下

。
如需有關配置下載目標存放庫的詳細資訊,請參閱
部署設定。
2. 「目錄結構」與「目錄內容」窗格會顯示所選存放庫的內容。使用這些窗格,導覽至您要下載至資產的指令集檔案。
下列資訊適用於「目錄內容」窗格中的每個檔案:
◦ 「名稱」- 指定檔案的名稱,且包含副檔名。如果已將檔案上載至存放庫,會將時間戳記 (紀元時間) 附加至檔案名稱。此時間戳記可區分具有相同名稱的兩個檔案。
◦ 「上載日期」- 指定將檔案新增至 ThingWorx 存放庫的日期與時間。
◦ 「大小」- 指定檔案的大小,以位元組為單位。
◦ 「路徑」- 指定 ThingWorx 存放庫中檔案的絕對路徑。
3. 在「目錄內容」窗格中,選取要在「所選內容檔案名稱」欄位中顯示其名稱的指令集檔案。
您可在「目錄內容」部份下執行下列動作:
◦ 如果所選存放庫中沒有要遞送至資產的檔案,按一下

可將檔案上載至
ThingWorx 存放庫。
◦ 欲從存放庫刪除檔案,請按一下

。
4. 在「目的地目錄」欄位中,指定資產中您要下載檔案的位置。
5. 如果您已在「目的地目錄」欄位中提供絕對路徑,請選取「目的地目錄是絕對路徑」核取方塊。
6. 如果您想讓資產在下載檔案之後解壓縮該檔案,請選取選用的「下載後代理程式會解壓縮此檔案」核取方塊。
|
|
eMessage 代理程式只能解壓縮 tar.gz 格式的檔案。
欲解壓縮其他任何格式的檔案,請將「執行」指示新增至包含解壓縮可執行檔的封裝。
|
7. 如果您要在檔案下載至指定目錄時覆寫任何現有檔案,請選取選用的「此檔案下載至指定目錄時覆寫現有檔案」核取方塊。
8. 欲將指示新增至指示清單,請按一下「新增」。
執行
欲定義「執行」指示 (用於對遠端物件執行指令),請完成下列步驟:
1. 在「可執行檔」欄位中,輸入您要執行的指令。
2. 在「引數」欄位中,指定您在「可執行檔」欄位中定義的指令的引數。此欄位是選用欄位。
|
|
所執行的指令是「可執行檔」與「引數」欄位的值的組合。
|
3. 如果可執行檔的路徑是絕對路徑,請選取「可執行檔路徑是絕對路徑」核取方塊。
4. 如果您希望指令在執行期間以非同步方式或彼此獨立執行,請選取「以非同步方式執行該指令」核取方塊。預設會同步執行。
5. 欲將指示新增至指示清單,請按一下「新增」。
註冊指令集
欲將指示新增為可部署至 Axeda 代理程式一或多個資產的指令集,請完成下列步驟。在註冊指令集之後,您可以執行下列操作:
• 驗證您要針對一或多個資產執行的指示。
• 使用您已註冊的指令集名稱,針對相同的一或多個資產多次執行指令集。
1. 在「指令集檔案」欄位中,輸入您要註冊之檔案的絕對路徑。
|
|
如果您收到驗證錯誤,請檢查在檔案路徑中輸入為前綴或後綴的空格。
|
2. 在「指令集名稱」欄位中,輸入您要新增為指示的指令集名稱。
3. 欲將指示新增至指示清單,請按一下「新增」。
重新啟動
欲定義指示來重新啟動代理程式,請完成下列步驟:
1. 欲終止目前代理程式流程並啟動新的代理程式流程,請選取「硬重啟。取消核取後變為軟重啟」核取方塊。
如果您不想終止目前代理程式流程,但想重新初始化所有元件並從磁碟重新載入資料,請務必清除「硬重啟。取消核取後變為軟重啟」核取方塊。
2. 欲將指示新增至指示清單,請按一下「新增」。
|
|
請確保「重新啟動」指示是指示清單中的最後一個指示。
|
執行指令集
欲定義指示來執行可針對 Axeda 代理程式一或多個資產部署的已註冊指令集,請完成下列步驟。
1. 在「指令集名稱」欄位中,輸入您要執行的指令集名稱。
2. 欲將指示新增至指示清單,請按一下「新增」。
設定內容
欲定義指示來在遠端資產上設定指定的內容值,請完成下列步驟:
1. 在「內容名稱」與「內容值」欄位中,指定內容的名稱與值。
|
|
內容名稱是 ThingWorx Composer 中的物件內容名稱。為使得「設定內容」指令正常工作,物件內容名稱必須正確對應至遠端內容名稱。遠端內容名稱會傳送至資產。
如果物件內容未配置為遠端或者指定的物件內容遺失,則系統會將部署標記為 不合格。
|
2. 欲將指示新增至指示清單,請按一下「新增」。
取消註冊指令集
欲定義指示來取消註冊 Axeda 代理程式一或多個資產的指令集,請完成下列步驟。
1. 在「指令集名稱」欄位中,輸入您要取消註冊的指令集名稱。
2. 欲將指示新增至指示清單,請按一下「新增」。
上載
欲定義指示來讓 Axeda eMessage 代理程式將一或多個檔案上載至 ThingWorx Platform,請完成下列步驟:
1. 在
「目標存放庫」欄位中,按一下

來選取您要將檔案上載到的存放庫。
您可以建立專門用於上載的檔案存放庫,例如 UploadRepository。
2. 在「目標路徑」欄位中,指定要在其中儲存已上載檔案的存放庫的位置。
例如,輸入 /UploadFiles 可將檔案儲存至 /UploadRepository/UploadFiles 目錄。
如果您輸入 /,會將上載的檔案儲存至您在步驟 1 中定義的存放庫。
|
|
檔案會儲存在以上載檔案之物件命名的目錄中。此目錄位於「目標存放庫」或「目標路徑」欄位的值下。
例如,如果已將封裝部署至 MyThing 物件且「目標存放庫」與「目標路徑」欄位的值為 /UploadRepository/UploadFiles,則檔案將上載至 /UploadRepository/UploadFiles/MyThing 目錄。
|
|
|
如果「目標路徑」欄位中指定的位置不存在,則會在部署期間在「目標存放庫」下建立位置。
|
3. 在
「要上載的檔案」欄位中,輸入您要上載之檔案的名稱,然後按一下

。請確保此檔案存在於您的裝置的相對路徑中。
如果您要在成功部署封裝之後從存放庫中刪除檔案,請選取
「上載後刪除檔案」核取方塊,然後按一下

您可以在檔案名稱中包含如 * 或 ? 萬用字元項目。使用 * 可表示多個字元,而 ? 表示單一字元。針對在 Windows 上執行的代理程式,? 字元會傳回與 * 字元相同的結果。
4. 「要上載的檔案」欄位下的表格會顯示要上載至 ThingWorx Platform 的檔案清單,及其「上載後刪除檔案」狀況。從此表格,您可以執行下列動作:
◦ 如果您要從清單中移除檔案,可在清單中選取該項目,然後按一下「移除」。欲選取所有檔案,請選取「檔案名稱」旁邊工具列中的核取方塊。
◦ 如果您要變更檔案的
「上載後刪除檔案」狀況,請按一下

,然後視需要選取或清除
「上載後刪除檔案」核取方塊。
5. 欲將指示新增至指示清單,請按一下「新增」。