在 ThingWorx 中匯入與匯出
匯入與匯出資料、實體和延伸功能
有多個選項可供您在 ThingWorx 中匯入與匯出資料和實體。根據您的起點，將包含資料與實體的延伸功能匯入 ThingWorx 可能是您的流程中的第一步。系統會將串流、值串流、資料表、部落格和 Wiki (列項目、部落格貼文、Wiki 頁面) 中的資訊視為資料。延伸功能則僅可匯入。雖然只有管理員使用者才能使用「匯入/匯出」選單，非管理員仍可手動匯入與匯出資料和實體。請參閱
手動匯出與匯入。
對於較小的匯入與匯出，您可以使用「從檔案」匯入，並使用「至檔案」匯出，因為您要匯入或匯出特定檔案。對於較大型的匯入和匯出，可以匯入「從 Thingworx Storage」以及匯出「至 Thingworx Storage」。這麼做讓您可以非同步方式將所有實體和資料從 ThingworxStorage/exports 資料夾匯入或匯出至其中。
 |
如需有關 ThingWorx 中所有可用匯入和匯出選項的詳細資訊，請參閱下表。
匯入
系統不支援匯入已從較新版本的 ThingWorx 匯出的實體。
|
選項
|
描述
|
支援的格式
|
其他資訊
|
||||
|---|---|---|---|---|---|---|---|
|
從檔案
|
從所選本機檔案 (不是非同步) 或從檔案存放庫匯入包含實體或資料的單一檔案。
|
XML、JSON 與二進位
|
• 對實體而言，如果選取「使用預設持續性提供者」選項，則不具備有效持續性提供者的所匯入實體將會使用系統定義的預設持續性提供者。
• 對於實體，如果選取「包括子系統」選項，則相關聯的子系統組態會連同實體一起匯入。
• 對於資料，如果選取「略過錯誤值串流資料記錄」選項，將略過值串流項目上的任何錯誤，且匯入將繼續進行而不會失敗。
• 對於實體，如果選取「覆寫內容值」選項，則目前存在於實體中的內容值將會由存在於匯入中之該實體的任何內容值所覆寫。若未核取，則會略過匯入中的任何內容值。
|
||||
|
從 Thingworx Storage
|
從位於伺服器上 ThingworxStorage/exports 資料夾中的所選 (伺服器端) 檔案，以非同步方式匯入實體和資料 (選用)。
|
XML、JSON 與二進位
|
• 對於資料，如果選取「略過錯誤值串流資料記錄」選項，將略過值串流項目上的任何錯誤，且匯入將繼續進行而不會失敗。
• 如果選取「使用預設持續性提供者」選項，則不具備有效相關聯持續性提供者的任何所匯入實體將會使用系統定義的預設持續性提供者。具體來說，
◦ 如果匯入的實體已建立有效的持續性提供者，ThingWorx 將會連同該持續性提供者一起將其匯入。
◦ 如果匯入的實體並未建立有效的持續性提供者，ThingWorx 將會使用預設持續性提供者。
• 如果選取「包括子系統」選項，則所有已配置的子系統設定都會在匯入時覆寫。
• 如果選取「覆寫收集權限和組織」設定，則匯入檔案中的收集權限和組織將會覆寫伺服器上的設定。預設行為會將匯入檔案中的集合權限與組織合併到已在伺服器上定義的內容中。
• 每個資料檔案在匯入時都會建立一個關聯的 import.log 檔案。除非刪除此檔案，否則無法匯入相同資料。
• 對於實體，如果選取「覆寫內容值」選項，則目前存在於實體中的內容值將會由存在於匯入中之該實體的任何內容值所覆寫。若未核取，則會略過匯入中的任何內容值。
|
||||
|
來源控制實體
|
XML
|
• 如果選取「使用預設持續性提供者」選項，則不具備有效持續性提供者的所匯入實體將會使用系統定義的預設持續性提供者。
• 如果選取「包括子系統」選項，則相關聯的子系統組態會連同實體一起匯入。
• 若是發生錯誤，將不會匯入資料夾中的任何實體。系統會略過無法剖析為 XML 或 ThingWorx 檔案的檔案。錯誤會記錄在應用程式記錄檔中。
• 對於實體，如果選取「覆寫內容值」選項，則目前存在於實體中的內容值將會由存在於匯入中之該實體的任何內容值所覆寫。若未核取，則會略過匯入中的任何內容值。
|
|||||
|
副檔名
|
匯入延伸功能 zip 檔案。
|
.zip
|
匯出
|
選項
|
描述
|
格式
|
其他資訊
|
||
|---|---|---|---|---|---|
|
至檔案 - 實體集合
|
• 可從指定的實體集合 (應用程式金鑰、圖標板、混搭、媒體實體等) 連同模型標籤或依照專案、日期 (取決於檔案上的「上次修改日期」時間戳記) 來同步匯出實體。
• 若未指定存放庫，系統會在本機匯出實體。
|
二進位和 XML
|
• 若未指定檔案存放庫，系統會自動在下列位置建立一個名為 FileRespository 的資料夾：ThingworxStorage\repository\FileRepository
• 如果選取「匯出相符模型標籤」標籤，則只會匯出包含在「標籤」欄位中所指定之所有標籤的實體。如果未選取「匯出相符模型標籤」標籤，則會匯出包含在「標籤」欄位中所指定之任何標籤的實體。
|
||
|
至檔案 - 資料集合
|
• 可從指定的集合 (部落格、資料表、串流、值串流或 wiki) 連同模型標籤或依照日期 (取決於資料的記錄時間戳記) 來同步匯出資料。
|
二進位
|
• 若未指定存放庫，系統會自動在下列位置建立一個名為 FileRespository 的資料夾：ThingworxStorage\repository\FileRepository
• 如果選取「匯出相符模型標籤」標籤，則只會匯出包含在「標籤」欄位中所指定之所有標籤的實體。如果未選取「匯出相符模型標籤」標籤，則會匯出包含在「標籤」欄位中所指定之任何標籤的實體。
|
||
|
至檔案 - 單一實體
|
可將單一實體匯出至所選的本機目的地 (同步)。
|
二進位或 XML
|
若未指定存放庫，系統會在本機下載實體。
|
||
|
至檔案 - 單一資料
|
可將單一資料匯出至所選的本機目的地 (同步)。
|
二進位
|
• 如果選取「匯出相符模型標籤」標籤，則只會匯出包含在「標籤」欄位中所指定之所有標籤的實體。如果未選取「匯出相符模型標籤」標籤，則會匯出包含在「標籤」欄位中所指定之任何標籤的實體。
|
||
|
至 Thingworx Storage
|
將所有實體與資料 (選用) 以非同步方式匯出至伺服器 (在 ThingworxStorage/exports 資料夾中)。
|
二進位
|
• 匯出至 ThingworxStorage 資料夾時沒有任何大小限制。
• 系統會依照日期、實體/資料類型和資料類型名稱將匯出細分為資料夾。例如：C:\ThingworxStorage\exports\20150625140545\Blogs\AcmeVendingEquiptmentBlog\data-0.twx
• 系統會為每個資料和實體檔案新增一個隨附的加總核對碼 (chk) 檔案。
|
||
|
來源控制實體
|
依照集合、模型標籤、專案、開始和結束日期來匯出 ThingWorx 實體。指定的實體可以導向至 FileRepository 或 SourceControlRepository 物件。匯出實體時，會以類似來源控制系統管理其加工品的方式，在目的地建立一個檔案結構。如果想要將所匯出的檔案移動或複製到另一個位置，您可以將檔案結構匯出為一個 zip 檔案。
|
XML
|
• 下列選項可供您在指定實體的匯出時使用：
◦ 「集合」-「全部」、「應用程式金鑰」、「儀表板」、「資料形式」、「資料標籤」、「目錄服務」、 「延伸功能封裝」、「當地語系化表」、「記錄」、「混搭」、「媒體」、「選單」、 「模型標籤」、「網路」、「組織」、「持續性提供者」、「專案」、「資源」、「指令集函數程式庫」、「狀態定義」、「樣式定義」、「子系統」、「物件封裝」、「物件」、「物形式」、「物範本」、「使用者」、「使用者群組」。
◦ 「專案」- 指定要用於匯出的專案。匯出實體時，系統將會匯出已套用所選專案的所有實體。
◦ 「標籤」- 使用神奇選擇器來依模型標籤匯出。
◦ 「開始日期」- 使用開始日期來根據隨實體記錄的時間戳記限制所匯出實體的內容。開始日期將匯出時間戳記晚於開始日期的實體。
◦ 「結束日期」- 使用結束日期來根據隨資料項目記錄的時間戳記限制所匯出實體的內容。結束日期將匯出時間戳記早於所指定結束日期的實體。如果結束日期為空白，便會使用目前的日期與時間。
◦ 「存放庫」- 指定用於匯出的存放庫。
◦ 「路徑」- 指定匯出的位置。
◦ 「匯出至 Zip 檔案」- 將匯出的實體放入 zip 資料夾的指定位置。必須提供檔案名稱。
|
||
|
經由「更多」選單匯出
|
XML
|
 |
|||
|
通用匯出
|
當每個系統使用唯一加密金鑰時，將資料從一個系統移轉到另一個系統時，此選項很有用。例如，將生產前系統移轉至生產系統時，此選項很有用。在此情況下，從一個系統匯出的加密敏感資訊 (例如基礎類型 PASSWORD 的内容) 無法匯入至另一個系統。
僅適用於管理員使用者，且僅適用於匯出實體，此選項可從一個 ThingWorx 伺服器匯出實體，以便隨後匯入到另一個伺服器。請注意，與實體相關聯的資料並不隨之一起匯出。
|
二進位或 XML
|
如果下列條件為 true，則此選項可在匯出使用者介面內使用：
• 「匯出選項」為「至檔案」或「至 Thingworx Storage」
• 「匯出類型」為「實體集合」或「單一實體」
• 使用者是「管理員」群組的成員。
如果非管理員使用者在啟用通用選項的情況下呼叫 Export 服務目錄，則伺服器將會防止使用者執行匯出。
|
