要求載入檔案格式

此主題描述用來載入要求項目的 Microsoft Excel 試算表的格式。

注意事項

• 試算表檔案中的每個工作表對應至一個視點。

• 您可以將多個工作表載入至多個視點。

• 工作表 (及其對應的視點) 使用的標籤必須等於或少於 30 個字元。

  註：

  如果視點名稱長度超過 30 個字元，您需要建立將要求項目載入至視點時要用於工作表的標籤。如需使用標籤的相關資訊，請參閱檢查視點。

• 試算表可包含衍生標準欄之特性值的公式。試算表公式也可用於應用程式專用特性 (FCGL、PLN) 和自訂特性。跳過公式值等於空白的特性儲存格。公式值等於 <clear> 或 <blank> 的特性儲存格。

• 工作表依由左到右順序處理。

• 載入期間不會處理匯入檔案中重複的列。

• 支援的地區設定的日期和時間戳記必須是下列其中一種 JAVA 日期格式樣式：

  • 短

  • 預設

  • 長

  • 中

  註：

  如需 Java 日期與時間格式的相關資訊，請參閱使用預先定義的格式。

• 如果您有超過 10,000 個的節點，請建立多個載入檔案，每個包含 10,000 個以下的節點。

• 在階層視點中新增或插入的節點若父項不明，請在父項欄中使用 <Unknown> 關鍵字，以計算並儲存每個要求項目的父項值。管理員必須定義表示式來計算父項值。請參閱計算並儲存節點的父項。

• 若要計算正在新增或插入之節點的名稱，請將名稱欄保留空白或使用 <cn> 或 <cn ####> 關鍵字。必須設定節點以計算名稱值。請參閱計算並儲存節點的名稱。

欄注意事項

• 試算表必須要有和保留的欄名稱或特性名稱相匹配的保留的欄名稱或特性名稱，請參閱保留的欄名稱。

  註：

  您無法如果缺少「名稱」欄，您將無法載入工作表。

• 特性的欄標頭必須包括特性名稱或特性的自訂顯示標籤 (如果已經設定的話；此選項在「視點」檢查程式的「特性」頁籤中設定)。特性名稱不可以包含命名空間。例如，Core.Description 無效。
• 如果載入檔案具有「替代名稱」特性欄：
  • 如果載入的目標節點類型包含「替代名稱」特性，載入檔案時就會執行下列作業：
    • 如果列包含節點名稱，「替代名稱」欄中就會載入替代名稱。
    • 如果列不包含節點名稱，就會使用「替代名稱」來尋找視點中具有相同「替代名稱」特性值的相符節點。

  • 如果載入的目標節點類型不包含「替代名稱」特性，就會忽略欄。

• 欄可以是任何順序。
• 如果欄標頭沒有任何相匹配的保留的欄名稱或特性名稱，欄會被忽略。這表示試算表可以包含不會被載入的註解。

處理列順序

從要求檔案載入記錄時，載入處理會對檔案內容進行排序，以便將父節點新增至子節點之前的視點。如果在該載入檔案中，子節點的列先於父節點的列，則會防止發生驗證錯誤。

例如，此載入檔案包含一個 Analytics 父項列，而且在載入檔案中，它前面有 Emily 和 Jack 這兩個子項列，它們都將 Analytics 當作它們的父項：

載入此檔案時，載入程序會對內容進行排序，以便先新增 Analytics，然後新增 Emily、Jack 和 Mary。

<Blank> 和 <Clear> 處理與空白欄位

處理要求檔案時，對於在要求載入檔案中輸入 <blank> 或 <clear> 關鍵字與將儲存格保留空白有不同的處理方式：

• <clear> 關鍵字會清除現有的特性值。
• <blank> 關鍵字會將特性的定義值設為空白。
• 檔案中的空白儲存格會被忽略。

所有資料類型都支援 <blank> 和 <clear> 關鍵字與空白儲存格。不過，不支援清單內有空白的清單資料類型項目。也就是說，清單本身可以空白，但清單內的項目不能空白。

以下是一些範例：

• 支援清單值 '<blank>'。請注意，將空白值匯入清單會置換其中任何現有的定義值、繼承值或預設值。
• 支援清單值 'A,B,C'。
• 不支援清單值 'A,,C'。

保留的欄名稱

注意事項

• 如果特性具有與保留欄相同的名稱，您可以使用替代欄名稱。請參閱下方的支援替代名稱。

• 如果正在將試算表載入至清單的視點，階層的欄和動作會被忽略。例如，在清單視點中，移動和插入動作會被忽略。

表格 10-2 動作代碼

動作代碼	描述
Add	建立新節點。
Delete	刪除節點。
<Empty cell>	如果動作代碼儲存格為空白，則會使用更新動作代碼處理該列。
Insert	將現有節點插入至 Parent 和 Parent Node Type 儲存格所指定的節點之下的階層中。
Move	將現有節點移至階層中的新位置，並從現有位置移除節點。
Prop_Update	僅更新現有節點的特性值。若要執行其他動作，請使用更新動作代碼。 您可以清除已定義特性的特性值。清除特性值會刪除儲存的值並將值回復為預設值或繼承的值。例如，以下 Prop_Update 動作會清除「描述」值。
Rename	重新命名現有節點。
重新排序	在階層視點中重新排序節點。 若要重新排序節點，您只能在使用允許重新排序該節點類型 (父節點或底端節點) 之階層集的視點中進行。如需詳細資訊，請參閱重新排序節點。
Remove	從指定的父節點移除節點。
Update	更新現有節點的特性值。 如果列中的儲存格指示需要這種動作，Update 動作還會執行額外的動作。下列清單描述這項工作如何運作： 如果節點不存在，則新增節點。如果為階層式視點，節點會插入至 Parent 和 Parent Node Type 儲存格所指定的階層的位置。 如果為階層式視點而且存在節點但不是在指定父項之下，則產生的動作將由階層集是否允許共用節點決定： 如果允許共用節點，節點會插入到指定父項之下。 如果不允許共用節點，節點會移至指定父項之下。 如果特性允許空白，您可以將特性更新為空白值。您必須在儲存格中使用 <blank> 指標；空白儲存格不會產生相同結果。 例如，以下更新動作可將「法人」特性設定為空白值。即使描述的儲存格為空白，EMA 的現有描述仍不會變更。