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