使用 LoadFromFile 載入產品系列物件

資料管理能力 > 管理產品系列 > 產品系列管理 > 產品系列管理 > 使用 LoadFromFile 載入產品系列物件

LoadFromFile 是指令行公用程式，可用於將單一的自訂資料檔案載入 Windchill 資料庫，以便輕鬆地建立大量的舊有資料，或將其移轉到新 Windchill 實行。如需有關此公用程式的詳細資訊，請參閱使用 LoadFromFile 公用程式與載入公用程式概觀。

利用下列指令可使用 LoadFromFile 公用程式：

windchill wt.load.LoadFromFile -d <ExampleLoadfile.xml>

在此指令中，<ExampleLoadFile.xml> 是您要載入的載入檔案名稱。

載入公用程式僅能處理 XML 檔案。使用 CSV2XML 公用程式可將 CSV 檔案轉換為 XML 格式檔案。如果您的資料是 CSV 格式，就可以在將資料載入資料庫之前，使用 CSV2XML 公用程式將 CSV 格式的資料重新格式化為 XML 格式。如需詳細資訊，請參閱 Converting CSV Files to XML Format Files。

您可以使用此公用程式來執行下列產品系列作業：

• 建立產品系列、產品模型群組、產品模型或受管理變體規格

• 建立產品系列成員物件之間的使用關係連結

• 將可供配置模組物件指派給產品系列或產品模型

• 將獨立變體規格轉換為組織變體規格

• 變更變體規格的 LifeCycleTemplate 或 LifeCycleState 值

• 建立手動選取規則

「產品系列成員」這個辭彙，指的是下列物件：

• 產品系列

• 產品模型群組

• 產品模型

• 變體規格

對這些物件類型有讀寫權限的使用者可以執行此公用程式。

建立產品系列物件

使用 createProductFamilyMember 元件建立下列類型的物件：

• 產品系列

• 產品模型群組

• 產品模型

• 管理變體規格

您可以在單一載入檔案中使用不同的元件。支援任何組合。

• 下表中的編號與版本值可以是字母數字。

• 所有的值 (布林值除外) 皆為區分大小寫。

元素	資料類型	描述
csvpfmName	字串	選用。指定產品系列成員物件的名稱。
csvpfmNumber	字串	選用。指定產品系列成員物件的識別碼。
csvpfmType	字串	以 <WCTYPE\|objectName> 格式，指定產品系列成員物件的物件類型。例如，WCTYPE\|wt.productfamily.ProductFamily、WCTYPE\|wt.productfamily.ProductModelGroup、WCTYPE\|wt.productfamily.ProductModel、WCTYPE\|com.ptc.wpcfg.doc.VariantSpec。
csvtopPFNumber	字串	指定產品系列的識別碼，其為此產品系列成員物件之所在。如果建立產品系列，則該值必須是其自身編號值。
csvversion	字串	選用。目前僅支援預先存在之變體規格使用此元素。指定要針對預先存在的變體規格建立的新版本，而非建立新物件。
csvcontainerPath	字串	選用。指定產品系列成員物件的容器。
csvnavcriteria	字串	選用。針對欲設定之新變體規格的導覽條件，指定其條件名稱。

建立產品系列成員物件之間的使用關係連結

使用 createUsageLink 將產品系列、產品模型群組、產品模型與變體規格物件連結在一起，形成產品系列結構。

元素	資料類型	描述
csvpfmParentNumber	字串	針對用來作為連結的父項角色之物件，指定該物件的編號值。
csvpfmChildNumber	字串	針對用來作為連結的子項角色之物件，指定該物件的編號值。

將可供配置模組物件指派給產品系列或產品模型

使用 setConfigurableModule 來指派產品系列或產品模型物件的可供配置模組 (WTPart) 物件。

元素	資料類型	描述
csvpfmNumber	字串	指定可供配置模組參照所依據之產品系列或產品模型的編號值。
csvcsNumber	字串	指定用來作為某個產品系列或產品模型的可供配置模組之 WTPart 的編號值。

將獨立變體規格轉換為組織變體規格

使用 createOrganizedVariantSpec 將獨立變體規格轉換為組織變體規格。

元素	資料類型	描述
csvtopPFNumber	字串	指定用來存放此變體規格物件之產品系列的編號。
csvpfmParentNumber	字串	指定用來作為此變體規格的父項物件之產品模型的編號值。
csvvsNumber	字串	指定藉由關聯至產品系列與產品模型而轉換為組織變體規格的獨立變體規格之編號值。

變更變體規格上的生命週期範本與生命週期狀態值

使用 setProductFamilyVariantLifeCycle 設定現有變體規格物件上的 LifeCycleTemplate 或 LifeCycleState 值。

元素	資料類型	描述
csvvsNumber	字串	指定需變更其 LifeCycleTemplate 或 LifeCycleState 值之現有變體規格的編號值。
csvversion	字串	指定需變更其 LifeCycleTemplate 或 LifeCycleState 值之現有變體規格的修訂版本。
csviteration	字串	指定需變更其 LifeCycleTemplate 或 LifeCycleState 值之現有變體規格的版序。
csvlifecycle	字串	指定新的 LifeCycleTemplate 值。此值可以為空值，以保留目前值。
csvlifecyclestate	字串	指定新的 LifeCycleState 值。此值可以為空值，以保留目前值。

為變體規格建立手動規格規則

使用 beginCreateManualSelectionRules、createManualSelectionRules 與 endCreateManualSelectionRules 的組合，快速而輕鬆地為現有變體規格物件建立一組手動選取規則。此載入手動選取規則的方法會假設您要使用變體規格、父零件與子零件的最新版本。它會在建立新規則之前刪除指定父零件 (在指定的變體規格的前後關聯內) 的所有預先存在的規則。這是載入手動選取規則的一種方法。另一種方法是以受控方式建立規則，將在下節中詳細描述該方法。

方法	元素	資料類型	描述
beginCreateManualSelectionRules	csvmanualSelectionRuleVariantSpecNumber	字串	指定用來作為新手動選取規則之前後關聯的現有變體規格的編號值。
beginCreateManualSelectionRules	csvmanualSelectionRuleParentPartNumber	字串	指定零件的編號值，該零件為您想要為其建立手動選取規則之連結的父項角色。
createManualSelectionRules	csvmanualSelectionRuleChildPartNumber	字串	指定零件的編號值，該零件為您想要為其建立手動選取規則之連結的子項角色。
endCreateManualSelectionRules	無。

以受控方式建立手動規格規則

使用 createModuleVariantSelectRule 與 com.ptc.wpcfg.load.LoadHelper 處理常式，以較為受控的方式建立手動選取規則。這種載入手動選取規則的方法，可讓您指定您欲用來建立規則之方式的更精確相關詳細資訊。使用下列任一元素，針對正確的父-子連結建立規則：

• csvchildToSelectNumber

• csvlinkComponentId

• csvlinkLineNumber

藉由此方法建立的新規則，會覆寫使用相同變體規格 - 父零件 - 子零件組合的預先存在規則。

元素	資料類型	描述
csvvariantSpecNumber	字串	指定用來作為新手動選取規則的前後關聯之現有變體規格的編號值。
csvvariantSpecRevision	字串	指定用來作為新手動選取規則的前後關聯之現有變體規格的修訂版本。
csvparentNumber	字串	指定零件的編號值，該零件為您想要為其建立手動選取規則之連結的父項角色。
csvparentView	字串	選用。指定父零件的檢視。必須始終指定此元素，除非父零件沒有 View 值。
csvparentViewVariation1	字串	選用。指定父零件的 BOM 類型檢視變體。範例值為 costing、production、testing。
csvparentViewVariation2	字串	選用。指定父零件的全域替代碼檢視變體。範例值為 001、002、003、004、005。
csvorganizationName	字串	選用。指定父零件與子零件所在的組織名稱。
csvchildToSelectNumber	字串	選用。指定零件的編號值，該零件為您想要為其建立手動選取規則之連結的子項角色。若您要指定 csvlinkComponentId 或 csvlinkLineNumber，則將此留為空白。
csvlinkComponentId	字串	選用。指定您要為其建立手動選取規則之連結的元件 ID。若您要指定 csvchildToSelectNumber 或 csvlinkLineNumber，則將此留為空白。
csvlinkLineNumber	字串	選用。指定您要為其建立手動選取規則之連結的行號。若您要指定 csvchildToSelectNumber 或 csvlinkComponentId，則將此留為空白。
csvactive	布林值	針對要用於篩選的新手動選取規則，指定 true。針對啟動前不用於篩選的新手動選取規則，指定 false。