XML 檔案結構與範例

關於 XML 檔案結構的注意事項：

  • 系統會修剪屬性名稱中的前置空格。
  • 系統有時會修剪屬性值中的前置空格。
  • 針對所有元素與屬性名稱使用小寫。
  • 使用不明的元素或屬性名稱會導致輸入失敗。

下列範例描述了 XML 檔案的大部分結構。

<?xml version="1.0"?> <xml> <transactions> <transaction date="1196854268" type="wf_import_document_attributes" vaultname="2008 file vault"> <document aliasset="" pdmweid="0" idattribute="Number" id="89-NOAO-4200-1236" idcfgname=""> <configuration name=""> <attribute name="Cost" value="0.44"/> <attribute name="ArticleID" value="A-012-BB"/> </configuration> </document> </transaction> </transactions> </xml>

其中︰

XML 元素 描述和屬性
<?XML version="1.0"?> 檔案必須從此元素開始。
<XML> 此元素包覆 transactions 元素。
<transactions> 檔案只包含一個 transactions 元素。
<transaction …> 檔案可以包含多個 transaction 元素。
屬性:
日期

從 1970 年 1 月 1 日 12:00 AM 至今經過的秒數。必須是一個大於 0 的整數。
type

表示交易包含要輸入至資料保險箱中之檔案或品項的資料。

Vaultname

與此交易相關之資料保險箱的名稱。 輸入規則會處理具有相符資料保險箱名稱的交易。
Aliasset

用於尋找子屬性節點的別名組。 會將 XML 檔案中的屬性名稱與別名對應變數進行比對。

例如，在 XML 檔案中包含具有屬性 NR 之變數 X2Number 的別名組會設定為符合資料卡變數 Number。

空白的值符合在 XML 檔案中具有屬性名稱的資料卡變數。
<document …> 包含用於將輸入值與資料保險箱中之檔案或品項進行比對的準則。 它符合檔案或品項的獨特內部 ID，或變數值。
屬性:
Pdmweid

將交易與資料保險箱資料庫中檔案或品項之 Documents 表格的內部 DocumentID 進行比對。

當您使用此屬性時，會忽略 [id]、[idattribute] 與 [idcfgname]。 若要使用其他比對技巧，請將值設定為 0 或忽略此屬性。

Idattribute

用於與資料保險箱中之檔案或品項進行比對的資料卡變數或別名。

Id

搜尋檔案或品項時要使用的變數值。 使用 VariableValue 資料庫表格中的變數名稱 idattribute 與選用模型組態 Idcfgname 來搜尋值。

如果多個檔案或品項符合，會為所有項目輸入值，但只會將值寫入至通過輸入轉換動作的項目。

Idcfgname

要將變數值與其進行比對的模型組態名稱 (如果有的話)。 如果此屬性沒有值，會將檔案的所有模型組態視為相符。
<configuration …> 要更新為屬性值之檔案資料卡的模型組態。 如果此屬性沒有值，會更新所有模型組態。

產生多個模型組態元素來將不同值輸入至不同的模型組態。

屬性：
名稱
<attribute …>
屬性:
名稱

要更新之資料卡變數的名稱，格式為 VariableAlias.Alias 或 Variable.VariableName 。
value

設定指定變數時要使用的值。 不得超過 1024 個字元。