Struktura souboru XML a příklad

Poznámky ke struktuře souborů XML:

  • Systém odebere mezery na začátku názvů atributů.
  • Někdy odebírá rovněž mezery na začátku hodnot atributů.
  • Pro všechny prvky a názvy atributů použijte malá písmena.
  • Použití neznámého prvku nebo názvu atributu způsobí selhání importu.

Následující příklad zachycuje většinu aspektů struktury souboru 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="Náklady" value="0.44"/> <attribute name="IDčlánku" value="A-012-BB"/> </configuration> </document> </transaction> </transactions> </xml>

kde:

Prvek XML Popis a atributy
<?XML version="1.0"?> Soubor musí začínat tímto prvkem.
<XML> Tento prvek obaluje prvek transactions.
<transactions> Soubor obsahuje pouze jeden prvek transactions.
<transaction …> Soubor může obsahovat více prvků transaction.
Atributy:
datum

Počet sekund uplynulých od půlnoci 1. ledna 1970. Hodnota musí být celé číslo větší než 0.
typ

Označuje, že transakce obsahuje data, která je třeba importovat do souborů či položek v úschovně.

Vaultname

Název úschovny, které se transakce týká. Pravidlo importu zpracovává transakce s odpovídajícím názvem úschovny.
Aliasset

Sada aliasů, které slouží k vyhledávání podřízených uzlů atributů. Názvy atributů v souboru XML se porovnávají s proměnnou namapovanou na alias.

Například sada aliasů obsahující proměnnou X2Number s atributem NR v souboru XML je nakonfigurována tak, aby odpovídala proměnné datové karty Number.

Prázdná hodnota odpovídá proměnným datové karty s názvy atributů v souboru XML.
<document …> Obsahuje kritéria pro porovnávání hodnot importu se souborem nebo položkou v úschovně. Porovnává jedinečné interní ID souboru či položky nebo hodnotu proměnné.
Atributy:
Pdmweid

Porovnává transakci s interním parametrem DocumentID z tabulky Documents souboru či položky v databázi úschovny.

Použijete-li tento atribut, atributy [id], [idattribute] a [idcfgname] se ignorují. Chcete-li použít jinou techniku porovnávání, nastavte hodnotu na 0 nebo tento atribut vynechejte.

Idattribute

Proměnná datové karty nebo alias, který se má porovnávat se souborem nebo položkou v úschovně.

ID

Hodnota proměnné, která se má použít při vyhledávání souborů a položek. Hledá hodnotu v databázové tabulce VariableValue s využitím názvu proměnné, parametru idattribute a volitelné konfigurace Idcfgname.

Pokud kritériím odpovídá více souborů nebo položek, importují se hodnoty pro všechny, ale zapíšou se pouze ty, které projdou akcí přechodu importu.

Idcfgname

Název konfigurace (pokud se nějaká používá), s kterou se má porovnávat hodnota proměnné. Jestliže tento atribut nemá žádnou hodnotu, zvažují se při porovnávání všechny konfigurace souboru.
<configuration …> Konfigurace datové karty souboru, která se má aktualizovat pomocí hodnot atributu. Jestliže tento atribut nemá žádnou hodnotu, aktualizují se všechny konfigurace.

Chcete-li do různých konfigurací importovat různé hodnoty, vytvořte více prvků konfigurace.

Atribut:
jméno
<attribute …>
Atributy:
jméno

Název proměnné datové karty, která se má aktualizovat, v podobě AliasProměnné.Alias nebo Proměnná.NázevProměnné .
value

Hodnota, která se má použít při nastavování zadané proměnné. Nesmí překročit 1024 znaků.