Struktur

Beim Auftragsimport sollten die einzulesenden XML-Quelldaten im Idealfall mit folgender Struktur aufgebaut sein:

 

<Hauptknoten>

 <Datensatz, hier Auftragsdatensatz 1>

   <Feld_1>...</Feld_1>

   <Feld_2>...</Feld_2>

   <Detaildatensatz, hier Auftragsposition 1>

     <Feld_1>...</Feld_1>

     <Feld_2>...</Feld_2>

   </Detaildatensatz>

   <Detaildatensatz, hier Auftragsposition 2>

     <Feld_1>...</Feld_1>

     <Feld_2>...</Feld_2>

   </Detaildatensatz>

 </Datensatz>

 

 <Datensatz, hier Auftragsdatensatz 2>

   ...

 </Datensatz>

 

 <Datensatz, hier Auftragsdatensatz 3>

   ...

 </Datensatz>

</Hauptknoten>

 

Die XML-Daten können entweder einen einzelnen Auftrag inkl. Auftragspositionen enthalten oder auch mehrere Aufträge.

 

Wenn ein Auftrag mehrere Artikel bzw. Auftragspositionen enhält, müssen diese strukturiert wie in folgendem Beispiel aufgelistet werden:

 

<Artikel>

 <Menge>1.00</Menge>

 <Bezeichnung>Schrank</Bezeichnung>

 <EPreis>122.50</EPreis>

</Artikel>

<Artikel>

 <Menge>1.00</Menge>

 <Bezeichnung>Rollcontainer</Bezeichnung>

 <EPreis>80.50</EPreis>

</Artikel>

 

Eine Auflistung durch Hochzählen der Tag-Bezeichnung wie im folgenden Beispiel wird nicht unterstützt:

 

<Itemamount_1>1.00</Itemamount_1>

<Itemname_1>Schrank</Itemname_1>

<Itemeprice_1>122.50</Itemeprice_1>

<Itemamount_2>1.00</Itemamount_2>

<Itemname_2>Rollcontainer</Itemname_2>

<Itemeprice_2>80.50</Itemeprice_2>

 

Inhalt

Der Inhalt eines XML-Tags wird 1 zu 1 in das Zielfeld übernommen, das dem Tag über die Importdefinition zugeordnet wurde.

 

CDATA für Sonderzeichen

Wenn der Inhalt in einem <Tag> mit CDATA umschlossen ist, wird nur der Inhalt innerhalb [] übernommen.

 

Beispiel:

 

<Ort><![CDATA[Paderborn]]></Ort>

 

entspricht

 

<Ort>Paderborn</Ort>

 

Der Ausdruck <![CDATA[Feldinhalt]]> wird verwendet, um auszuschließen, dass in der XML-Datei Fehler auftreten, wenn in den Feldinhalten bestimmte Sonderzeichen auftreten (z.B. < oder >) . Diese Sonderzeichen würden den Aufbau der XML-Datei zerstören und unbrauchbar machen.

 

Der folgende Artikeltext mit Sonderzeichen wird korrekt verarbeitet...

 

<Text><![CDATA[Dieser Text enthält die Sonderzeichen < und >]]></Text>

 

... der folgende Text kann zu einem Fehler führen:

 

<Text>Artikeltext enthält die Sonderzeichen < und ></Ort>

 

Mehrfache Wiederholung eines identischen Tags

Wenn ein und derselbe Tag mehrfach vorkommt wie im folgenden Beispiel, dann wird nur der Inhalt aus dem letzten Tag übernommen (diese Einschränkung gilt nicht für Auftragspositionen).

 

<ram:IncludedNote>

   <ram:Content>Rechnung gemäß Bestellung 4711 vom 01.07.2018.</ram:Content>

</ram:IncludedNote>

<ram:IncludedNote>

   <ram:Content>Es bestehen Rabatt- und Bonusvereinbarungen.</ram:Content>

</ram:IncludedNote>

 

---

www.Amicron.org - Stand: 13.01.2022.

Bitte hier klicken, wenn Sie uns Ihr Feedback zu diesem Hilfethema senden moechten.