XML-Dateistruktur und Beispiel

Anmerkungen zur XML-Dateistruktur:

  • Das System entfernt führende Leerzeichen in Attributnamen.
  • Das System entfernt in manchen Fällen führende Leerzeichen in Attributwerten.
  • Verwenden Sie Kleinbuchstaben für alle Elemente und Attributnamen.
  • Bei unbekannten Elementen oder Attributnamen schlägt der Import fehl.

Im folgenden Beispiel werden die meisten Aspekte der XML-Dateistruktur beschrieben.

<?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>

Zeichenerklärung:

XML-Element Beschreibung und Attribute
<?XML version="1.0"?> Die Datei muss mit diesem Element beginnen.
<XML> Dieses Element umschließt das transactions-Element.
<transactions> Die Datei enthält nur ein transactions-Element.
<transaction …> Die Datei kann mehrere transaction-Elemente enthalten.
Attribute:
date

Die Anzahl Sekunden, die seit 00:00 Uhr am 1. Januar 1970 verstrichen sind. Dies muss eine Ganzzahl größer als 0 sein.
type

Weist darauf hin, dass die Transaktion Daten enthält, die in Dateien oder Elementen im Tresor importiert werden sollen.

Vaultname

Der Name des Tresors, auf den sich diese Transaktion bezieht. Die Import-Regel verarbeitet Transaktionen mit einem passenden Tresornamen.
Aliasset

Der Alias-Satz, mit dem untergeordnete Attributknoten abgerufen werden. Die Attributnamen in der XML-Datei werden der Variable zugeordnet, die vom Alias vorgegeben ist.

Wenn ein Alias-Satz beispielsweise die Variable X2Number mit dem Attribut NR in der XML-Datei enthält, erfolgt die Zuordnung zur Datenkartenvariablen Number.

Bei einem leeren Wert werden die Datenkartenvariablen den Attributnamen in der XML-Datei zugeordnet.
<document …> Enthält Kriterien, mit denen die Importwerte einer Datei oder einem Element im Tresor zugeordnet werden. Die Zuordnung erfolgt anhand der eindeutigen internen Kennung einer Datei, eines Elements oder eines Variablenwerts.
Attribute:
Pdmweid

Ordnet die Transaktion anhand der internen DocumentID-Kennung aus der Documents-Tabelle einer Datei oder einem Element in der Tresordatenbank zu.

Bei Verwendung dieses Attributs werden [id], [idattribute] und [idcfgname] ignoriert. Wenn Sie eine andere Zuordnungsmethode verwenden möchten, stellen Sie den Wert auf 0 ein oder lassen Sie dieses Attribut weg.

Idattribute

Die Datenkartenvariable oder der Alias zum Zuordnen einer Datei oder eines Elements im Tresor.

Kennung

Variablenwert, der zum Suchen von Dateien oder Elementen verwendet werden soll. Die Suche nach dem Wert erfolgt anhand des Variablennamens idattribute und der optionalen Konfiguration Idcfgname in der VariableValue-Datenbanktabelle.

Wenn mehrere Dateien oder Elemente passen, werden die Werte zwar für alle importiert, aber nur in jene geschrieben, die die Import-Übergangsaktion durchlaufen.

Idcfgname

Name der Konfiguration, der der Variablenwert zugeordnet werden soll (sofern zutreffend). Wenn dieses Attribut keinen Wert aufweist, werden für die Zuordnung alle Konfigurationen einer Datei überprüft.
<configuration …> Konfiguration der Dateidatenkarte, die mit den Attributwerten aktualisiert werden soll. Wenn dieses Attribut keinen Wert aufweist, werden alle Konfigurationen aktualisiert.

Durch Erstellung mehrerer Konfigurationselemente können verschiedene Werte in unterschiedliche Konfigurationen importiert werden.

Attribut:
Name
<attribute …>
Attribute:
Name

Name der zu aktualisierenden Datenkartenvariable im Format VariableAlias.Alias oder Variable.VariableName .
value

Wert, der zum Einstellen der festgelegten Variable verwendet werden soll. Dieser Wert kann maximal 1024 Zeichen enthalten.