cXML-Webformulardaten

Als Teil von Release 11 und höheren Versionen von Release 10 können Webformulardaten jetzt in cXML-Bestellungen übertragen werden. Nur als öffentlich markierte Webformularfelder werden mittels cXML übertragen. Nachstehend ist eine Anleitung für Lieferanten zur Analyse der in einem Webformular enthaltenen Daten und der zugehörigen Feldantworten zu finden. 

Formularantworten werden auf ItemDetail-Ebene in folgendem Format ausgegeben:

<Extrinsic name="FORM_NAME">
<Value name="LABEL">VALUE</Value>
<Array name="LABEL">
<Value>VALUE</Value>
</Array>
</Extrinsic>

• Nur öffentliche Felder werden exportiert.
• Wenn das Feld ein Array ist, dann wird das Array-Tag generiert.
• Wenn das Feld kein Array ist, wird das Value-Tag verwendet.
• Grenzfall: Der extrinsische Name sollte innerhalb eines ItemDetail eindeutig sein. Es ist möglich, dass FORM_NAME mit dem Namen des kundenspezifischen Felds einer Bestellung kollidiert. In diesem Fall wird automatisch eine laufende Nummer zum Namen des NAME hinzugefügt, beginnend bei 1. Wenn beispielsweise "basic_details" in Konflikt gerät, wird die zweite Instanz automatisch in "basic_details1" umbenannt
   
• Aus dem cXML-Benutzerhandbuch, Seite 137:
  Jedes benannte Extrinsic kann nur einmal in den Listen erscheinen, die dem OrderRequestHeader und einzelnen ItemOut-Elementen (innerhalb der enthaltenen ItemDetail-Elemente) zugeordnet sind. Es darf nicht derselbe Name sowohl in der OrderRequestHeader-Liste als auch in einer den ItemOut-Elementen zugeordneten Liste erscheinen. Wenn der gleiche Extrinsic-Name und -Wert in allen ItemOut-Listen wiederholt wird, sollte er in den OrderRequestHeader verschoben werden.

Beispiel: Wenn die Felder public_labels für ein Webformular „Basic Details“ die folgenden Daten zurückgeben:

{9=>["Name", "Benjamin", :external], 10=>["Age", "23", :external], 11=>["Gender", "Female", :external], 12=>["Like", ["", "Shrimp", "Fish"], :external], 13=>["Country", "Taiwan", :external], 14=> ["Biography", "Kesera sera\nWhat ever will be will be\nThe future is up to me", :external]}

Wird Folgendes generiert:

<Extrinsic name="Basic Details">
<Value name="Name">Benjamin</Value>
<Value name="Age">23</Value>
<Value name="Gender">Female</Value>
<Array name="Like">
<Value></Value>
<Value>Shrimp</Value>
<Value>Fish</Value>
</Array>
<Value name="Country">Taiwan</Value>
<Value name="Biography">Kesera sera
Whatever will be will be
The future is up to me</Value>
</Extrinsic>