Servigistics InService 發佈與載入 > 使用發佈與載入 > 使用 CSV 載入工具 > CSV 檔案格式
  
CSV 檔案格式
在 CSV 配套中使用的 CSV 檔案必須遵循指定的格式。本節說明包含在 CSV 配套中的檔案以及每個檔案的所需格式。
CSV 配套結構
CSV 配套具有下列結構︰
資料載入期間,系統會處理下列檔案與資料夾︰
properties.csv 檔案 - 包含一般內容
DataScripts 資料夾 - 包含下列圖元的 CSV 檔案︰
producthierarchy.csv 中的產品階層
toc.csv 中的資訊結構
productinstance.csv 中的產品實例
part.csv 中的零件
assembly.csv 中的零件清單
Part_relations.csv 中的零件關係
hotspot.csv 中的作用區資訊
bom.csv 中的產品實例 (BOM) 資訊
bomcollections.csv 中的 BOM 集合資訊
OptionsChoiceDefinition.csv 中的選項與選擇
OptionsChoices_Applicablity.csv 中前後關聯的選項與選擇規則
Mapping 資料夾 - 包含下列內容的對應 CSV 檔案:
images.csv 中的圖像
xml.csv 中的 XML 文件
pdf.csv 中的 PDF 文件
graphic.csv 中的 GRAPHIC 文件
PDF 資料夾 - 包含在 PDF 對應檔中參照的所有 PDF 檔案。
Images 資料夾 - 包含在圖像對應檔中參照的所有圖像。
XML 資料夾 - 包含在 XML 對應檔中參照的所有 XML 檔案。
GRAPHIC 資料夾 - 包含在 GRAPHIC 對應檔中參照的所有圖形檔案。
請注意,非 IS 關聯資訊元素 (IE-PDF、IE-XML 或 IE-GRAPHICS) 位於 IE 相關資料夾中。例如,不與資訊結構相關聯的 XML 檔案位於 XML 資料夾中。
必須提供零件清單,以及相關資訊,包括零件與作用區資訊。
* 
針對包含 Org Name 欄的任何 CSV 檔案,當您需要再次 TAL 資料時,不會移轉「書籤」與「註記」資訊,且會提供 Org Name 作為輸入。
一般屬性
CSV 配套包含 properties.csv 檔案,內含下列一般資訊與內容。
* 
欄格式使用常規運算式提供。我們會假設您熟悉常規運算式
CSV 欄
描述
必要/選用
格式
Creation Date
提供指令集建立日期,例如,03-24-2011
* 
Creation Date 欄需要以預先定義的 mm/dd/yyyy hh:mm 格式提供日期。這需要在伺服器端預先配置本機設定。
必要
時間戳記
Org Name
「組織名稱」提供「廠商代碼」。這會在 IMAN 檔案中對應。
選用
字串
CollectionID
提供這些 CSV 檔案描述的集合 ID。可以包含將載入資料的多個值。
若未提供集合,系統會尋找前後關聯 ID。
CollectionID 是在 Servigistics InService 中使用的集合 ID。
CollectionID 將會連接至產品階層中的層級。ProductHierarchy.csv 檔案中的 CollectionID 與節點之間必須有相符項。
選用
字串
IsAuthoredDoc
提供預設語言,例如,en-US
必要
字串
ContextIDs
提供適用於配套之所有前後關聯的以分號分隔清單。系統會使用此資訊來解析對於集合的對應。
若未提供前後關聯,必須在配套中提供 toc.csv 檔案。否則,配套載入將會因遺失前後關聯或集合而失敗。
如果提供集合與前後關聯,系統會使用這兩者的聯集。
選用
字串
產品階層
CSV 配套包含 producthierarchy.csv 檔案,該檔案具有可供建立產品結構的下列資訊:
CSV 欄
描述
必要/選用
格式
Toc Code
提供此 PH 圖元的具唯一性代碼
必要
字串
Parent Entity Code
Toc Code 的父項提供 PH 圖元代碼。這可用來建構產品階層結構。根 PH 代碼必須參照 properties.csv 檔案中的 ContextIDs (或 CollectionID) 值。
必要
字串
Order
PH 中相同層級的同等節點之間的圖元順序。
可能的值︰firstlast 或數字。
不在發行版本 6.3 中使用。
第一個|最後一個 - 例如 1-9
Image Code
表示目前 PH 節點的縮圖圖像。
欲新增圖像,必須在 CSV 輸入配套中包括 image.csv 檔案與關聯的圖像檔案。如果圖像不在配套中,PH 會在沒有圖像的情況下載入。
選用
字串
Description_lang
此 PH 項目的指定語言文字描述。
請注意,lang 代表 ISO 639-1 格式的語言代碼。例如︰英文描述為 Description_en
最少一個出現位置及最多五個出現位置需要
字串{1,256}
Applicability
提供前後關聯、序號、其他選項與選擇,或 APEX 格式的日期適用性。
使用下列內容定義適用性:
PRODUCT - 用來指定產品前後關聯生失效
INSTANCE_RANGE - 用來指定序號生失效
DATE_RANGE - 用來指定日期生失效
IS - 用來指定選項與選擇生失效
下列範例僅顯示產品前後關聯與序號生失效:
(AND (PRODUCT '0000016615')) (AND (PRODUCT '0000016615') (INSTANCE_RANGE '1' '200') ) (AND (PRODUCT '0000016615') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0')) (AND (PRODUCT '0000016615') (OR (INSTANCE_RANGE '1' '200') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0')))
下列範例顯示所有服務生失效內容:
(AND (AND (PRODUCT '0000016615') (OR (INSTANCE_RANGE '1' '200') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0'))) (AND (IS 'Color' 'Blue' 'Red') (IS 'Country' 'USA' 'UK' 'India') ) )
選用
請參閱描述
請注意有關產品階層 (PH) 資料的以下資訊︰
您可載入及合併來自不同來源 (例如,SIM 與 CSV 輸入) 的多個產品階層檔案。
載入不同來源的優先順序在 IMAN 組態檔案 (IMANConfig.xml) 中決定。所有產品階層檔案都將在根層級合併。
您可以載入並支援所需數量的產品階層層級。
PH 中的最後層級將會是模型。所有模型相關功能皆應起作用。
產品階層層級將在 producthierarchy.csv 中進行設定,並且資訊結構層級是 toc.csv 的一部份。您可以設定所需數量的 PH 與 IS 層級。
針對每個集合,必須複製產品階層 CSV 與支援圖像及圖像對應檔案,並針對每個集合重複使用它們。
Applicability 欄中允許的邏輯運算式受到限制。Servigistics InService 介面中的篩選器顯示適用於目前 PH 前後關聯的選項與選擇。通常,系統會顯示,在 PH 前後關聯的定義以及在 PH 節點中定義的邏輯運算式中,通用的選項與選擇。為了在 PH 轉換期間支援此功能,會對可以使用的邏輯運算式類型進行限制。
支援具有 AND 運算的簡單邏輯運算式。例如:(AND (IS ‘region’ ‘india’ ‘us’) (IS ‘color’ ‘white’ ‘blue’) … )。此運算式表明區域為印度或美國,「且」顏色為白色或藍色。
不支援下列類型的邏輯運算式︰
具有 ANDOR 運算的複雜邏輯運算式
例如:(OR (AND (IS ‘region’ ‘india’) (IS ‘color’ ‘white’ )) (AND (IS ‘region’ ‘us’) (IS ‘color’ ‘blue’ )) … )
數字比較運算,例如 LESS THENGREATER THEN
具有 NOT 運算的邏輯運算式
資訊結構
CSV 配套包含 toc.csv 檔案,該檔案具有可用於建立資訊結構 (目錄或資訊結構) 的下列資訊︰
CSV 欄
描述
必要/選用
格式
Toc Code
提供完整目錄結構中目錄節點的唯一 ID。
必要
字串{1,115}
Parent Entity Code
可用來在對應於此資訊結構的 PH 中指定層級。這可在產品階層與資訊結構之間提供連結。
必要
字串{1,115}
Type
定義圖元所在目錄內的層級。必須依數字順序建立層級。可能的值包括:
4 - 群組 (資料夾)
5 - 文件 (組件或服務資訊 PDF/XML)
必要
[4–5]{1}
Format
提供文件的格式。可能的值有 assemblyiepdfiexmliegraphics
僅類型 5 需要
assembly|pdf
Order
提供目錄中相同層級的同層級節點之間的圖元順序。如果沒有指定任何值,則以字母順序進行排列。
必要
Numeric[1-9][0-9]*
Document Code
是指與此目錄項目相關聯的文件 (組件、PDF 或 XML 文件)
目錄類型 = 5 (文件) 需要
字串{1,115}
Image Code
表示目前 TOC 節點的縮圖圖像。
欲新增圖像,必須在 CSV 輸入配套中包括 image.csv 檔案與關聯的圖像檔案。如果圖像不在配套中,TOC 會在沒有圖像的情況下載入。
選用
字串{1,64}
Description_lang
此 PH 項目的指定語言文字描述。
請注意,lang 代表 ISO 639-1 格式的語言代碼。例如︰英文描述為 Description_en
最少一個出現位置及最多五個出現位置需要
。{1,256}
Context and SN
也可以使用只有 SN 欄名稱的欄。
提供適用於每個 IS (資料夾) 項目層級的前後關聯與序號組合。您可以提供 SN、前後關聯或下列格式的組合︰Context1:SN1; Context2:SN2。例如:
僅前後關聯 - Context1:;Context2:
僅 SN - SN1;:SN2
組合 - Context1:SN1;Context2:SN2
欲指定序號範圍,開始序號與結束序號應用「~」串連。例如:
12532~12899;20001~20100
選用
字串
Applicability
提供前後關聯、序號、其他選項與選擇,或 APEX 格式的日期適用性。
使用下列內容定義適用性:
PRODUCT - 用來指定產品前後關聯生失效
INSTANCE_RANGE - 用來指定序號生失效
DATE_RANGE - 用來指定日期生失效
IS - 用來指定選項與選擇生失效
下列範例僅顯示產品前後關聯與序號生失效:
(AND (PRODUCT '0000016615')) (AND (PRODUCT '0000016615') (INSTANCE_RANGE '1' '200') ) (AND (PRODUCT '0000016615') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0')) (AND (PRODUCT '0000016615') (OR (INSTANCE_RANGE '1' '200') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0')))
下列範例顯示所有服務生失效內容:
(AND (AND (PRODUCT '0000016615') (OR (INSTANCE_RANGE '1' '200') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0'))) (AND (IS 'Color' 'Blue' 'Red') (IS 'Country' 'USA' 'UK' 'India') ) )
選用
請參閱描述
Delete
用來標記將某一 IE (XML、PDF、GRAPHIC 或 PARTSLIST) 作為增量更新流程的一部份刪除的布林值旗標。
將此欄設定為 True (不區分大小寫) 值來標記要刪除的某一項目,否則,將欄保留空白。
選用
布林值
每個資訊結構都必須完整載入,不得以增量的方式載入。您仍可使用不同的toc.csv檔案維護不同的資訊結構,並分別載入。
產品實例
CSV 配套包含 productinstance.csv 檔案,該檔案具有可供建立模型對應序號的下列資訊︰
CSV 欄
描述
必要/選用
格式
Model
從 PH 指定特定 PH 層級 (產品系列或模型)。
必要
字串
SN
指定僅在 TOC.csv 檔案中使用的現有序號。不需要在此指定前後關聯,因為它使用與模型相關聯的目錄階層解析。
必要時,會使用它來篩選目錄中不適用於此產品的資料。
如有多個序號與目錄及組件項目相關聯,則需要多行。每行必須有一個序號。
必要
字串
Delete
用來標記將某一 PI 項目作為增量更新流程的一部份刪除的布林值旗標。
將此欄設定為 True (不區分大小寫) 值來標記要刪除的某一項目,否則,保留空白。
選用
布林值
Title
指定 PI 的標題。
選用
字串{1,115}
Description
提供 PI 的描述。
選用
字串{1,115}
AlternateSerialNumber
指定 PI 的全域替代序號。
選用
字串{1,115}
SalesOrderNumber
指定 PI 的銷售訂單編號。
選用
字串{1,115}
alias1
提供 PI 的中繼資料資訊。
選用
字串{1,115}
alias2
提供 PI 的中繼資料資訊。
選用
字串{1,115}
alias3
提供 PI 的中繼資料資訊。
選用
字串{1,115}
Image Code
是指與此 PI 相關聯的圖像檔案名稱。此圖像用於可視導覽。
請注意,您必須將 image.csv 檔案與圖像檔案包含在配套中,才能載入縮圖圖像。
選用
字串{1,115}
組件
CSV 配套包含 assembly.csv (零件清單) 檔案,該檔案具有可供建立組件資訊的下列資訊︰
CSV 欄
描述
必要/選用
格式
Assembly Code
指定此組件 (零件清單) 的唯一代碼。這應該與現有目錄圖元的代碼相符。
必要
字串{1,115}
Part Code
指定現有零件的代碼。
指定描述零件,其中「組件代碼 = 零件代碼」。若將描述零件識別為套件 (在 part.csv 中),則整個組件將會標記為套件。
必要
字串{0,63}
Conf Code
如果零件代碼不具唯一性且相同的零件在組件中出現超過一次,則會包括此值以提供具唯一性代碼,進而區別零件。
選用
字串{0,63}
Part Order
以數值指定此零件在零件清單中的順序。
必要
大於零的整數值
Part Quantity
指定此零件在組件中的數量。
必要
字串{1,16}
Image Code
指定顯示此零件所在圖像的代碼。這可能包含適用於組件中特定零件的多個圖像。
選用
字串{1,64}
Hotspot Key
是指在 hotspot.csv 檔案中指定的作用區資訊。
選用
字串{0,64}
Orderable
指定是否可以訂購此零件。
可能的值為 yesno
可選用預設的 yes
yes|no
Additional_Detail_xxx
提供可載入到零件清單中的彈性欄位,以提供預設不支援的其他中繼資料屬性。這些新屬性在多種語言中不受支援。
如果您要新增其他任何參數,可使用 Additional_Detail_xxx 傳遞這些參數。請注意,xxx 是儲存在 Servigistics InService 中的實際屬性名稱。
如果名稱的 xxx 部份與預設 Servigistics InService 零件清單 XML 結構描述的元素名稱完全相符,則此欄位的值會對應至元素。
選用
當對應至預設的 Servigistics InService 零件清單元素時,該值應遵循元素的格式。亦即,Additional_Detail_Indenture 的值必須有數字值。
否則,您可以在此指定任何字串,但欄位不能有語言變體。
Context and SN
也可以使用只有 SN 欄名稱的欄。
提供適用於組件的前後關聯與序號組合。您可以提供 SN、前後關聯或下列格式的組合︰Context1:SN1; Context2:SN2。例如:
僅前後關聯 - Context1:;Context2:
僅 SN - SN1;:SN2
組合 - Context1:SN1;Context2:SN2
欲指定序號範圍,開始序號與結束序號應用「~」串連。例如:
12532~12899;20001~20100
選用
請參閱描述
Applicability
提供前後關聯、序號、其他選項與選擇,或 APEX 格式的日期適用性。
使用下列內容定義適用性:
PRODUCT - 用來指定產品前後關聯生失效
INSTANCE_RANGE - 用來指定序號生失效
DATE_RANGE - 用來指定日期生失效
IS - 用來指定選項與選擇生失效
下列範例僅顯示產品前後關聯與序號生失效:
(AND (PRODUCT '0000016615')) (AND (PRODUCT '0000016615') (INSTANCE_RANGE '1' '200') ) (AND (PRODUCT '0000016615') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0')) (AND (PRODUCT '0000016615') (OR (INSTANCE_RANGE '1' '200') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0')))
下列範例顯示所有服務生失效內容:
(AND (AND (PRODUCT '0000016615') (OR (INSTANCE_RANGE '1' '200') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0'))) (AND (IS 'Color' 'Blue' 'Red') (IS 'Country' 'USA' 'UK' 'India') ) )
選用
請參閱描述
Org Name
「組織名稱」提供「廠商代碼」。這會在 IMAN 檔案中對應。
會向未指派 Org Name 的任何組件,指派 properties.csv 中的 Org Name 值作為預設值。
選用
字串{1,115}
組件資訊必須完整載入。不得以增量方式載入或更新。
還必須提供此檔案以及相關的組件資訊,其中包括零件和作用區。
零件與零件文件
CSV 配套包含 part.csv 檔案,其中具有零件的下列資訊。它也可透過 Related Dcouments 欄,選擇性地提供零件的相關文件。
CSV 欄
描述
必要/選用
格式
Part Code
指定零件的具唯一性代碼。
必要
字串
Obsolete
指定此零件是否作廢。
可能的值為 yesno
可選用預設的 no
yes|no
Orderable
指定是否可以訂購此零件。
可能的值為 yesno
可選用預設的 yes
yes|no
Image Code
是指零件的相片代碼
選用
字串{1,64}
Description_lang
此項目的指定語言文字描述。
請注意,lang 代表 ISO 639-1 格式的語言代碼。例如︰英文描述為 Description_en
最少一個出現位置及最多五個出現位置需要
字串{1,256}
Additional Detail_name
提供一個彈性欄位,讓您為零件指定預設不提供的新中繼資料屬性。這些新屬性在多種語言中不受支援。
請注意,name 表示您產生之零件新中繼資料具唯一性的名稱。例如,如果您想要新增經銷商價格作為中繼資料,可以使用 Additional Detail_DealerPrice 欄。
另一個範例是,如果您想要將零件識別為套件,請新增值為 trueAdditional_Details_isKit 欄。
如果零件是描述零件 (請參閱 assembly.csv 中的 Part Code),該零件所描述的整個組件都將標記為套件。
選用
字串{0,256}
Context and SN
也可以使用只有 SN 欄名稱的欄。
提供適用於零件的前後關聯與序號組合。您可以提供 SN、前後關聯或下列格式的組合︰Context1:SN1; Context2:SN2。例如:
僅前後關聯 - Context1:;Context2:
僅 SN - SN1;:SN2
組合 - Context1:SN1;Context2:SN2
欲指定序號範圍,開始序號與結束序號應用「~」串連。例如:
12532~12899;20001~20100
選用
請參閱描述
Applicability
為零件項目提供前後關聯、序號、其他選項與選擇,或 APEX 格式的日期適用性。如果您要定義零件清單行項目的適用性,必須在 assembly.csv 檔案中進行定義。
使用下列內容定義適用性:
PRODUCT - 用來指定產品前後關聯生失效
INSTANCE_RANGE - 用來指定序號生失效
DATE_RANGE - 用來指定日期生失效
IS - 用來指定選項與選擇生失效
下列範例僅顯示產品前後關聯與序號生失效:
(AND (PRODUCT '0000016615')) (AND (PRODUCT '0000016615') (INSTANCE_RANGE '1' '200') ) (AND (PRODUCT '0000016615') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0')) (AND (PRODUCT '0000016615') (OR (INSTANCE_RANGE '1' '200') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0')))
下列範例顯示所有服務生失效內容:
(AND (AND (PRODUCT '0000016615') (OR (INSTANCE_RANGE '1' '200') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0'))) (AND (IS 'Color' 'Blue' 'Red') (IS 'Country' 'USA' 'UK' 'India') ) )
選用
請參閱描述
Org Name
「組織名稱」提供「廠商代碼」。這會在 IMAN 檔案中對應。
會向未指派 Org Name 的任何零件,指派 properties.csv 中的 Org Name 值作為預設值。
選用
字串{1,115}
Related Documents
提供與此零件相關之 IE 文件程式碼的以分號 (;) 分隔清單。
支援的 IE 類型有 IEXML、PDF 與 GRAPHIC。請注意,指定文件程式碼應參閱 IE 對應檔案中包含之 IE 的文件程式碼或識別碼。
選用
[IEXML| IEPDF|IEGRAPHIC]: <DOC_CODE>;
例如:IEXML: XML49; XML33; IEPDF: P444; IEGRAPHIC:9888;
請注意,文件程式碼清單中的每個項目都必須以分號分隔,即使其為單一值也是如此。
Delete
用來標記將某一零件作為增量更新流程的一部份刪除的布林值旗標。
將此欄設定為 True (不區分大小寫) 值來標記要刪除的某一項目,否則,將欄保留空白。
選用
布林值
作用區
CSV 載入工具支援 2D 點陣圖格式 (例如 .jpg.png) 的作用區。hotspot.csv 檔案包括作用區定義。此定義包括下列資訊︰
CSV 欄
描述
必要/選用
格式
Image Code
指定組件圖像。請注意,這並不適用於 CGM、PVZ 與 SVG 格式插圖。
必要
字串{1,64}
Hotspot Key
指定圖像中的作用區數與 assembly.csv 檔案之零件清單中零件的參照。
必要
字串{1,64}
Hotspot Left X
指定左側圖像中作用區區域的左側水平座標 (以像素為單位)。
必要
整數
Hotspot Top Y
指定上方圖像中作用區區域的上方垂直座標 (以像素為單位)。
必要
整數
Hotspot Width
指定圖像中作用區區域的寬度 (以像素為單位)。
必要
整數
Hotspot Height
指定圖像中作用區區域的高度 (以像素為單位)。
必要
整數
此資訊也將與 CSV 格式的零件清單資訊搭配使用。產生零件清單檔案時,工具會將作用區資訊插入到零件清單中繼資料區段中。
零件關係
CSV 配套包含 part_relations.csv 檔案,其中含有已汰換、替代、交叉參照與補充零件的下列資訊︰
CSV 欄
描述
必要/選用
格式
Source Part Code
指定位於關係來源中的零件。指現有零件的代碼。
如果汰換鏈內的來源零件由多個零件組成或構成,您必須提供零件代碼的以分號分隔清單。
如果是汰換鏈,這用來代表 N:1 關係。
必要
字串{0,63}
Target Part Code
指定作為零件關係中的目標的零件。指現有零件的代碼。
如果汰換鏈內的目標零件由多個零件組成或構成,您必須提供零件代碼的以分號分隔清單。
如果是汰換鏈,這將用來代表 1:N 關係。
必要。最少一個出現位置
字串{0,63}
Target Part Quantity
指定此零件在組件中的數量。
如果 Target Part Code 欄由多個零件組成,請為每個對應零件提供零件數量的以分號分隔清單。
必要
整數{1,16}
Relation
指定零件關係類型。可能的值:
Supersession
Alternate
Xref
Supplementary
必要
Supersession|Alternate|Xref| Supplementary
Comment_lang
以指定的語言提供關於此項目的註解。
請注意,lang 代表 ISO 639-1 格式的語言代碼。例如︰英文名稱為 Comment_en
此欄位僅供資料編寫者使用,不可用於 Servigistics InService
選用。
最多五個出現位置
字串{1,256}
Source Org Name
「組織名稱」提供「廠商代碼」。這會在 IMAN 檔案中對應。可以有多個項目,以分號 (;) 分隔。
會向未指派 Org Name 的任何來源零件,指派 properties.csv 中的 Org Name 值作為預設值。
選用
字串{1,115}
Target Org Name
「組織名稱」提供「廠商代碼」。這會在 IMAN 檔案中對應。可以有多個項目,以分號 (;) 分隔。
會向未指派 Org Name 的任何目標零件,指派 properties.csv 中的 Org Name 值作為預設值。
選用
字串{1,115}
Delete
用來標記將某一零件關係作為增量更新流程的一部份刪除的布林值旗標。
將此欄設定為 True (不區分大小寫) 值來標記要刪除的某一項目,否則,將欄保留空白。
選用
布林值
Source Part CodeTarget Part Code 欄是指 part.csv 檔案中的現有 Part Code 項目。
* 
在之前的發行版本中,此資訊包括在 alternative_parts.csv 檔案中。現在,不再支援此檔案。舊檔案中的第一個欄名為 Alternate Source Part Code。該欄在新檔案中名為 Source Part Code。唯一零件關係包含下列元素:
Source Part Code
Source Org Name
Target Part Code
Target Org Name
Relation
產品實例資訊
CSV 配套包含 bom.csv 檔案,其中含有產品實例或 BOM 的資訊。BOM 提供專門適用於特定序號或其他前後關聯之發行版本的零件與其他資訊。此檔案包含下列資訊:
CSV 欄
描述
必要/選用
格式
Object Number
指定 BOM 的唯一識別元。
必要
字串{0,64}
Context ID
指定適用於 BOM 的前後關聯 ID。這應該與產品階層中的節點相符。
必要
字串{0,64}
Sales Model
指定產品的銷售模型。
* 
目前不使用此欄。
選用
字串{0,64}
Build Date
指定產品的建立日期。
* 
目前不使用此欄。
選用
字串
Test Date
指定產品的測試日期。
* 
目前不使用此欄。
選用
字串
Ship Date
指定產品的出貨日期。
* 
目前不使用此欄。
選用
字串
Delete BOM
用來標記將某一 BOM 結構作為增量更新流程的一部份刪除的布林值旗標。
將此欄設定為 True (不區分大小寫) 值來標記要刪除的某一項目,否則,將欄保留空白。
選用
布林值
Comment_lang
以指定的語言提供關於此項目的註解。
請注意,lang 代表 ISO 639-1 格式的語言代碼。例如︰英文名稱為 Comment_en
此欄位僅供資料編寫者使用,不可用於 Servigistics InService
可選用最多五個出現位置
字串{1,256}
產品實例資訊集合
CSV 配套包含 bomcollections.csv 檔案,其中含有包含在產品實例或 BOM 中之零件的資訊。BOM 提供專門適用於特定序號或其他前後關聯之發行版本的零件與其他資訊。此檔案包含下列資訊:
CSV 欄
描述
必要/選用
格式
Object Number
在與此集合相關聯的 bom.csv 檔案中提供 BOM 識別元的參照。
一個集合可對應至多個 BOM 結構 (bom.csv 檔案)。
必要
字串{0,64}
SerializedComponent Object Number
serializedcomponent 集合類型指定「系列元件」物件 (SN) 序號。其他類型會略過此值。
選用
字串{0,64}
Collection Type
指定 BOM 集合的類型。可能的值為 partsserializedcomponents。如果提供其他值或未提供值,則不會載入項目。會載入其他或不同的類別,但不會反映在使用者介面中。
選用
字串
Display Order
指定此集合的顯示順序。1 為最高順序。
選用
整數
Part Number
指定包括在集合中的零件編號。
必要
字串{0,63}
Part Name_lang
指定語言的文字零件名稱。您必須為每種語言包括單獨的欄。
請注意,lang 代表 ISO 639-1 格式的語言代碼。例如︰英文名稱為 Part Name_en
選用
字串
Quantity
指定 BOM 中零件編號 (零件行項目) 的數量。
必要
整數{1,16}
Part Indenture
指定要在 Servigistics InService 使用者介面中將零件名稱縮排多少。
選用
整數
Processed Date
指定 BOM 的處理日期。
僅用於 serializedcomponent 項目。
選用
字串
Build Date
指定 BOM 的建立日期。
僅用於 serializedcomponent 項目。
選用
字串
Test Date
指定 BOM 的測試日期。
僅用於 serializedcomponent 項目。
選用
字串
Ship Date
指定 BOM 的出貨日期。
僅用於 serializedcomponent 項目。
選用
字串
Last Modified Date
指定上次修改 BOM 的日期。
僅用於 serializedcomponent 項目。
選用
字串
Comment_lang
以指定的語言提供關於此項目的註解。
請注意,lang 代表 ISO 639-1 格式的語言代碼。例如︰英文名稱為 Comment_en
此欄位僅供資料編寫者使用,不可用於 Servigistics InService
選用。
最多五個出現位置
字串
Org Name
「組織名稱」提供「廠商代碼」。這會在 IMAN 檔案中對應。
會向未指派 Org Name 的任何 BOM,指派 properties.csv 中的 Org Name 值作為預設值。
選用
字串{1,115}
圖形對應
CSV 配套包含 graphic.csv 檔案,其中具有下列圖形對應資訊︰
CSV 欄
描述
必要/選用
格式
GRAPHIC Code
指定圖形的唯一識別元。
必要
字串{1,256}
Info Type
指定在 Servigistics InService 中使用的資訊類型。
資訊類型是可讓使用者篩選資訊結構與搜尋結果中之項目的中繼資料。例如,您可以將資訊類型設定為「服務資訊」或「零件清單」。此中繼資料資訊也可供搜尋。
選用
字串{1,128}
File Name_lang
指定 GRAPHIC 的相對路徑 (在 GRAPHIC 根目錄中),包括檔案名稱。
請注意,lang 代表 ISO 639-1 格式的語言代碼。例如︰英文名稱為 File Name_en
必要。最少一個出現位置。
字串{1,256}
Description_lang
以指定語言指定圖形的文字描述。
請注意,lang 代表 ISO 639-1 格式的語言代碼。例如︰英文名稱為 File Name_en
必要。最少一個出現位置,最多五個出現位置。
字串{1,256}
Context and SN
也可以使用只有 SN 欄名稱的欄。
提供適用於 GRAPHIC IE 的前後關聯與序號組合。您可以提供 SN、前後關聯或下列格式的組合︰Context1:SN1; Context2:SN2。例如:
僅前後關聯 - Context1:;Context2:
僅 SN - SN1;:SN2
組合 - Context1:SN1;Context2:SN2
欲指定序號範圍,開始序號與結束序號應用「~」串連。例如:
12532~12899;20001~20100
選用
請參閱描述
Applicability
提供前後關聯、序號、其他選項與選擇,或 APEX 格式的日期適用性。
使用下列內容定義適用性:
PRODUCT - 用來指定產品前後關聯生失效
INSTANCE_RANGE - 用來指定序號生失效
DATE_RANGE - 用來指定日期生失效
IS - 用來指定選項與選擇生失效
下列範例僅顯示產品前後關聯與序號生失效:
(AND (PRODUCT '0000016615')) (AND (PRODUCT '0000016615') (INSTANCE_RANGE '1' '200') ) (AND (PRODUCT '0000016615') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0')) (AND (PRODUCT '0000016615') (OR (INSTANCE_RANGE '1' '200') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0')))
下列範例顯示所有服務生失效內容:
(AND (AND (PRODUCT '0000016615') (OR (INSTANCE_RANGE '1' '200') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0'))) (AND (IS 'Color' 'Blue' 'Red') (IS 'Country' 'USA' 'UK' 'India') ) )
選用
請參閱描述
Delete
用來標記將某一 GRAPHIC IE 作為增量更新流程的一部份刪除的布林值旗標。
將此欄設定為 True (不區分大小寫) 值來標記要刪除的某一項目,否則,將欄保留空白。
選用
布林值
請注意,您可以載入各種不同格式的圖形檔案作為圖形資訊元素 (GRAPHIC IE),包括 3D 模型插圖 (PVZ 或 SVG) 以及含作用區的 3D 模型插圖。您也可以檢視與存取內嵌於 IE XML 檔案中的圖像。
圖像對應
CSV 配套包含 image.csv 檔案,其中具有下列圖像對應資訊︰
CSV 欄
描述
必要/選用
格式
Image Code
指定此圖像的具唯一性代碼。
必要
字串{1,64}
File Name
指定圖像檔案的相對路徑 (在 Images 根目錄中),包括檔案名稱。
必要
字串
Image Height
指定圖像高度。如果未提供,會使用預設使用者介面大小。
選用
整數
Image Width
指定圖像寬度。如果未提供,會使用預設使用者介面大小。
選用
整數
Title_lang
以指定語言指定此圖元的標題。
請注意,lang 代表 ISO 639-1 格式的語言代碼。例如︰英文描述為 Description_en
可選用最多五個出現位置
字串{0,256}
Context and SN
也可以使用只有 SN 欄名稱的欄。
提供適用於圖像的前後關聯與序號組合。您可以提供 SN、前後關聯或下列格式的組合︰Context1:SN1; Context2:SN2。例如:
僅前後關聯 - Context1:;Context2:
僅 SN - SN1;:SN2
組合 - Context1:SN1;Context2:SN2
欲指定序號範圍,開始序號與結束序號應用「~」串連。例如:
12532~12899;20001~20100
選用
[0-9A-Za-z\-]{0,64}
Applicability
提供前後關聯、序號、其他選項與選擇,或 APEX 格式的日期適用性。
使用下列內容定義適用性:
PRODUCT - 用來指定產品前後關聯生失效
INSTANCE_RANGE - 用來指定序號生失效
DATE_RANGE - 用來指定日期生失效
IS - 用來指定選項與選擇生失效
下列範例僅顯示產品前後關聯與序號生失效:
(AND (PRODUCT '0000016615')) (AND (PRODUCT '0000016615') (INSTANCE_RANGE '1' '200') ) (AND (PRODUCT '0000016615') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0')) (AND (PRODUCT '0000016615') (OR (INSTANCE_RANGE '1' '200') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0')))
下列範例顯示所有服務生失效內容:
(AND (AND (PRODUCT '0000016615') (OR (INSTANCE_RANGE '1' '200') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0'))) (AND (IS 'Color' 'Blue' 'Red') (IS 'Country' 'USA' 'UK' 'India') ) )
選用
請參閱描述
Delete
用來標記將某一圖像作為增量更新流程的一部份刪除的布林值旗標。
將此欄設定為 True (不區分大小寫) 值來標記要刪除的某一項目,否則,將欄保留空白。
選用
布林值
PDF 對應
CSV 配套包含 pdf.csv 檔案,其中具有 PDF 檔案位置的下列資訊︰
CSV 欄
描述
必要/選用
格式
PDF Code
以多種語言指定 PDF 的唯一識別元及其翻譯 (如果存在)。
必要
字串{1,256}
Info Type
指定在 Servigistics InService 中使用的資訊類型。
資訊類型是可讓使用者篩選資訊結構與搜尋結果中之項目的中繼資料。例如,您可以將資訊類型設定為「服務資訊」或「零件清單」。此中繼資料資訊也可供搜尋。
選用
字串{1,128}
File Name_lang
指定 PDF 的相對路徑 (在 PDF 根目錄中),包括檔案名稱。
請注意,lang 代表 ISO 639-1 格式的語言代碼。例如︰英文名稱為 File Name_en
必要。最少一個出現位置。
字串{1,128}
Context and SN
也可以使用只有 SN 欄名稱的欄。
提供適用於 PDF IE 的前後關聯與序號組合。您可以提供 SN、前後關聯或下列格式的組合︰Context1:SN1; Context2:SN2。例如:
僅前後關聯 - Context1:;Context2:
僅 SN - SN1;:SN2
組合 - Context1:SN1;Context2:SN2
欲指定序號範圍,開始序號與結束序號應用「~」串連。例如:
12532~12899;20001~20100
選用
請參閱描述
Applicability
提供前後關聯、序號、其他選項與選擇,或 APEX 格式的日期適用性。
使用下列內容定義適用性:
PRODUCT - 用來指定產品前後關聯生失效
INSTANCE_RANGE - 用來指定序號生失效
DATE_RANGE - 用來指定日期生失效
IS - 用來指定選項與選擇生失效
下列範例僅顯示產品前後關聯與序號生失效:
(AND (PRODUCT '0000016615')) (AND (PRODUCT '0000016615') (INSTANCE_RANGE '1' '200') ) (AND (PRODUCT '0000016615') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0')) (AND (PRODUCT '0000016615') (OR (INSTANCE_RANGE '1' '200') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0')))
下列範例顯示所有服務生失效內容:
(AND (AND (PRODUCT '0000016615') (OR (INSTANCE_RANGE '1' '200') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0'))) (AND (IS 'Color' 'Blue' 'Red') (IS 'Country' 'USA' 'UK' 'India') ) )
選用
請參閱描述
Delete
用來標記將某一 PDF IE 作為增量更新流程的一部份刪除的布林值旗標。
將此欄設定為 True (不區分大小寫) 值來標記要刪除的某一項目,否則,將欄保留空白。
選用
布林值
XML 對應
CSV 配套包含 xml.csv 檔案,其中具有 XML 檔案位置的下列資訊︰
CSV 欄
描述
必要/選用
格式
XML Code
指定 XML 檔案的唯一識別元。
必要
字串{1,256}
Info Type
指定在 Servigistics InService 中使用的資訊類型。
資訊類型是可讓使用者篩選資訊結構與搜尋結果中之項目的中繼資料。例如,您可以將資訊類型設定為「服務資訊」或「零件清單」。此中繼資料資訊也可供搜尋。
選用
字串{1,128}
File Name_lang
指定 XML 的相對路徑 (在 XML 根目錄中),包括檔案名稱。
請注意,lang 代表 ISO 639-1 格式的語言代碼。例如︰英文名稱為 File Name_en
必要。最少一個出現位置。
字串{1,256}
Context and SN
也可以使用只有 SN 欄名稱的欄。
提供適用於 XML IE 的前後關聯與序號組合。您可以提供 SN、前後關聯或下列格式的組合︰Context1:SN1; Context2:SN2。例如:
僅前後關聯 - Context1:;Context2:
僅 SN - SN1;:SN2
組合 - Context1:SN1;Context2:SN2
欲指定序號範圍,開始序號與結束序號應用「~」串連。例如:
12532~12899;20001~20100
選用
請參閱描述
Applicability
提供前後關聯、序號、其他選項與選擇,或 APEX 格式的日期適用性。
使用下列內容定義適用性:
PRODUCT - 用來指定產品前後關聯生失效
INSTANCE_RANGE - 用來指定序號生失效
DATE_RANGE - 用來指定日期生失效
IS - 用來指定選項與選擇生失效
下列範例僅顯示產品前後關聯與序號生失效:
(AND (PRODUCT '0000016615')) (AND (PRODUCT '0000016615') (INSTANCE_RANGE '1' '200') ) (AND (PRODUCT '0000016615') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0')) (AND (PRODUCT '0000016615') (OR (INSTANCE_RANGE '1' '200') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0')))
下列範例顯示所有服務生失效內容:
(AND (AND (PRODUCT '0000016615') (OR (INSTANCE_RANGE '1' '200') (DATE_RANGE '2015-01-01 00:00:00.0' '2017-01-01 00:00:00.0'))) (AND (IS 'Color' 'Blue' 'Red') (IS 'Country' 'USA' 'UK' 'India') ) )
選用
請參閱描述
Delete
用來標記將某一 XML IE 作為增量更新流程的一部份刪除的布林值旗標。
將此欄設定為 True (不區分大小寫) 值來標記要刪除的某一項目,否則,將欄保留空白。
選用
布林值
請注意,您可以檢視與存取內嵌於 IE XML 檔案中的圖像。
選項和選擇項
CSV 配套包含下列兩個檔案,以提供選項與選擇相關資料︰
OptionsChoiceDefinition.csv - 提供選項與選擇的多語資訊
OptionsChoices_Applicablity.csv - 提供選項與選擇和對應 PH 項目的對應
OptionsChoiceDefinition.csv 具有下列幾欄︰
CSV 欄
描述
必要/選用
格式
Option_Code
指定選項的名稱。例如:Color。此欄僅允許單一值。
必要
字串
Option_lang
以指定語言指定選項的名稱。
請注意,lang 代表 ISO 639-1 格式的語言代碼。例如︰法文名稱為 Option_fr
選用
字串
Choice_Code
指定選擇的名稱。例如:Green。此欄僅允許單一值。
必要
字串
Choice_lang
以指定語言指定選擇的名稱。
請注意,lang 代表 ISO 639-1 格式的語言代碼。例如︰法文名稱為 Choice_fr
選用
字串
OptionsChoices_Applicablity.csv 具有下列幾欄︰
CSV 欄
描述
必要/選用
格式
Applicablity
指定套用選項與選擇之 PH 項目的值。
必要
字串
Option_Code
指定選項的名稱。例如:Color。此欄僅允許單一值。如果您需要指定多個值,請使用多個欄。
必要
字串
Choice_Code
指定選擇的名稱。例如:Green。此欄僅允許單一值。如果您需要指定多個值,請使用多個欄。
必要
字串