建立匯入包

自訂 Operator Advisor > 將資料匯入到 Operator Advisor 中 > 從其他系統匯入資料 > 建立匯入包

建立匯入包

欲建立匯入包：

1. 針對您將要匯入其資料的每個資料形式製作一個 ASCII CSV 文字檔案。編輯這些檔案時，請確保其會開啟並儲存為文字檔案。使用文字編輯器最容易完成此操作。如果您使用 Microsoft Excel，請勿將檔案開啟並儲存為 Excel 文件，因為這樣可能會導致資料損毀，並使檔案無法匯入。

若需進一步資訊，可參閱設定 CSV 檔案的格式。

2. 在名為 Binaires 的目錄中，收集 CSV 檔案參考的所有二進位檔案。根據需要使用子資料夾將具有相同檔案名稱的多個檔案分隔開來。如需詳細資訊，請參閱二進位內容

3. 建立一個 ZIP 檔案，使其頂層包含 CSV 檔案與 Binaries 目錄。下圖顯示匯入包結構的範例：

設定 CSV 檔案的格式

每個 CSV 檔案都會針對 Operator Advisor 資料模型中的資料形式進行命名，而且每個 CSV 檔案都表示一個資料形式。例如，針對 PTC.SCA.SCO.WorkDefinition 資料形式，會將 CSV 檔案命名為 PTC.SCA.SCO.WorkDefinition.csv。

每個 CSV 的第一列都會列出對應資料形式的欄位名稱。後續每一列都表示該資料形式的一個實例，並在匯入時新增為對應資料庫表格中的列。列中每個項目的內容都必須與其「資料形式」欄位的資料類型一致。如果特定欄位值為空白，會以逗號之間沒有資料的形式表示。

以下是 PTC.SCA.SCO.WorkDefinition.csv 檔案的範例：

UID,ID,Description,WorkType,Duration,SiteUID,DurationUnitOfMeasure,Name,LongDescription,ExecutionStatus,Version,SequenceNumber,ExecutionNotes
CREATE:1,1000001,PP Description,,,,,PP Name,PP Long Description,,A.1 (Design),0,
CREATE:2,1000002,OP10 Description,,,,,OP10 Name,OP10 Long Description,,A.2 (Design),10,
CREATE:3,1000003,OP20 Description,,,,,OP20 Name,OP20 Long Description,,A.3 (Design),20,
CREATE:4,1000004,OP1010 Description,,,,,OP1010 Name,OP1010 Long Description,,A.4 (Design),10,
CREATE:5,1000005,OP1020 Description,,,BUNDLE:1,,OP1020 Name,OP1020 Long Description,,A.5 (Design),20,

某些欄位必須以特定方式指定：

UID

UID 的值必須以 CREATE:<#> 格式指定，例如 CREATE:1。前綴表示要針對 CSV 檔案此列執行的動作。在此情況下，CREATE: 表示要在適當的資料庫表格中建立列。編號在 CSV 檔案中必須具唯一性。當新增資料庫列時，實際的 UID 值會由 ThingWorx 自動產生。

外部參考

外部參考是參考已經存在於 Operator Advisor 中之資料庫列 UID 的欄位。例如，如果 CSV 中工作定義的 SiteUID 欄位參考已經存在於 Operator Advisor 中的網站，請指定該現有網站的 UID。

內部參考

內部參考是參考包中另一個 CSV 檔案之項目 UID 的欄位。這些值必須指定為 BUNDLE:<#>。# 必須與 CSV 檔案中該項目 UID 欄位中的 # 相符。

例如，如果 PTC.SCA.SCO.WorkDefinition.csv 檔案中工作定義的 SiteUID 欄位參考 PTC.SCA.SCO.Site.csv 檔案中的項目，而且此檔案的 UID 值指定為 CREATE:7，則會將 SiteUID 值指定為 BUNDLE:7。

URL

針對 URL 欄位，例如工作定義插圖中的 IllustrationURL 或工作定義相關文件中的 DocumentURL，值必須是 web URL (例如 http://abc.com/file.html)，或包的 Binaries 目錄中二進位物件的路徑。值不得為空。Binaries 目錄中檔案的路徑包含 file:// 前綴，且與匯入包的基礎資料夾相關。例如：file://Binaries/Safety.doc 或 file://Binaries/subdir1/Safety.doc。檔案路徑參考的任何二進位物件都必須包含在匯入包中。

二進位內容

從 CSV 檔案參考的任何二進位內容都必須包含在 Binaries 目錄中。如果有多個具有相同名稱的二進位檔案，請使用子資料夾將其分隔開來。例如，如果有多個 Safety.doc 檔案，而每個檔案都包含唯一內容，請針對每個檔案使用一個單獨的子資料夾。每個二進位檔案都只能在匯入包中參考一次。

二進位檔案是具有 PNG、DOC、PDF 等副檔名的任何關聯檔案。這些檔案儲存在檔案存放庫中，而不是資料庫中，並由實體中的 URL 參考，例如工作定義相關文件 (PTC.SCA.SCO.WorkDefinitionRelatedDocument)。如需二進位內容的可能類型，請參閱針對 PTC.SCA.SCO.WorkDefinitionRelatedDocument 的 Type 屬性列出的檔案類型。