XPath-Zuordnungsdatei in Jitterbit EDI

Einführung

Hinweis

Diese Seite gilt nur für Legacy-XCBL-Workflows. EDIXml ist das empfohlene Austauschformat für alle neuen Projekte und Workflows.

Eine Zuordnungsdatei ist eine herunterladbare Referenzdatei, die die XPaths für alle X12-EDI-Segmentelementcodes in einer Zuordnung enthält und zeigt, wie das EDI-Backend Raw-X12-EDI-Dateien zu xCBL zuordnet. Diese XPath-Informationen können in den Transformationen von Studio oder Design Studio verwendet werden.

Die Datei ist eine Textdatei mit der Erweiterung .csv, die durch Kommas getrennte Felder enthält.

Zuordnungsdatei verwenden

Um die Zuordnungsdatei in einem Studio- oder Design Studio-Projekt zu verwenden, führe diese Schritte aus:

Lade die Zuordnungsdatei herunter für den Workflow eines Dokuments.
Öffne die Seite Transaktionen und suche das Dokument.
Erweitere den Eintrag, um den Bereich Ansichten anzuzeigen.
Klicke auf den ersten Link Raw, um den X12-EDI-Inhalt für das Dokument zu öffnen.
Klicke auf den zweiten Link Raw, um denselben Inhalt im xCBL-Format konvertiert zu öffnen.
Suche in der X12-EDI-Datei das zu transformierende Feld und notiere den EDI-Elementcode.
Suche in der XPath-Zuordnungsdatei den EDI-Elementcode und den entsprechenden XPath. Verwende die xCBL-Version, um zu bestätigen, dass der XPath und der zugeordnete Wert übereinstimmen.

Beispiel

In diesem Beispiel werden äquivalente Felder in Beispielen einer X12-EDI-Datei, der konvertierten xCBL-Datei und einem Auszug der XPath-Zuordnungsdatei hervorgehoben.

X12-EDI-Datei (Bestellung, 850)

example_850.edi


ISA*00*          *00*          *12*7703844115CHQT *02*9050999992211  *200107*1214*U*00401*000000006*0*T*>
GS*PO*7703844115CHQT*9050999992211*20230924*12142024*6*X*004010
ST*850*0002
BEG*00*SA*99340993**20230924*60006342
REF*X9*881807
REF*IA*60006342
REF*CO*W138156910
REF*DP*25
DTM*010*20230924
TD5*****UPSN
N9*SD*8119
N1*BT*Jane Smith
N3*2 Woodbridge Ave
N4*Edison*NJ*08837
PER*BD**TE*555-555-5555
N1*ST*Jane Smith
N3*2 Woodbridge Ave
N4*Edison*NJ*08837
PER*BD**TE*555-555-5555
N1*SO*Jane Smith*93*8119
N1*PO*Home Depot*93*8119
PO1*06*2*EA*9.7*TE*SK*H2520*VN*H2520***UP*H2520***PI*H2520
PID*F*08***BOOK LISTING
DTM*038*20610467
TD5*****UPSN
CTT*1
SE*25*0002
GE*7*6
IEA*1*000000007

xCBL-Datei

example_850.xml

<Order>
  <OrderHeader>
    <OrderNumber>
      <BuyerOrderNumber>99340993</BuyerOrderNumber>
    </OrderNumber>
    <OrderIssueDate>2023-09-24T00:00:00</OrderIssueDate>
    <OrderReferences>
      <ContractReferences>
        <core:Contract>
          <core:ContractID>
            <core:Ident>60006342</core:Ident>
          </core:ContractID>
        </core:Contract>
      </ContractReferences>
      <OtherOrderReferences>
        <core:ReferenceCoded>
          <core:ReferenceTypeCoded>InternalControlNumber</core:ReferenceTypeCoded>
          <core:PrimaryReference>
            <core:RefNum>121521807</core:RefNum>
          </core:PrimaryReference>
        </core:ReferenceCoded>
        <core:ReferenceCoded>
          <core:ReferenceTypeCoded>InternalVendorNumber</core:ReferenceTypeCoded>
          <core:PrimaryReference>
            <core:RefNum>60006342</core:RefNum>
          </core:PrimaryReference>
        </core:ReferenceCoded>
        <core:ReferenceCoded>
          <core:ReferenceTypeCoded>CustomerOrderNumber</core:ReferenceTypeCoded>
          <core:PrimaryReference>
            <core:RefNum>W138156910</core:RefNum>
          </core:PrimaryReference>
        </core:ReferenceCoded>
        <core:ReferenceCoded>
          <core:ReferenceTypeCoded>DepartmentNumber</core:ReferenceTypeCoded>
          <core:PrimaryReference>
            <core:RefNum>25</core:RefNum>
          </core:PrimaryReference>
        </core:ReferenceCoded>
        <core:ReferenceCoded>
          <core:ReferenceTypeCoded>SubdayNumber</core:ReferenceTypeCoded>
          <core:PrimaryReference>
            <core:RefNum>8119</core:RefNum>
          </core:PrimaryReference>
        </core:ReferenceCoded>
      </OtherOrderReferences>
    </OrderReferences>
    <Purpose>
      <core:PurposeCoded>Other</core:PurposeCoded>
      <core:PurposeCodedOther>00</core:PurposeCodedOther>
    </Purpose>
    <OrderType>
      <core:OrderTypeCoded>Other</core:OrderTypeCoded>
      <core:OrderTypeCodedOther>SA</core:OrderTypeCodedOther>
    </OrderType>
    <OrderCurrency>
      <core:CurrencyCoded>Other</core:CurrencyCoded>
      <core:CurrencyCodedOther />
    </OrderCurrency>
    <OrderLanguage />
    <OrderDates>
      <ListOfDateCoded>
        <core:DateCoded>
          <core:DateQualifier>
            <core:DateQualifierCoded>RequestedShip</core:DateQualifierCoded>
          </core:DateQualifier>
          <core:Date>2023-09-11T00:00:00</core:Date>
        </core:DateCoded>
      </ListOfDateCoded>
      <RequestedShipByDate>2023-09-11T00:00:00</RequestedShipByDate>
    </OrderDates>
    <OrderParty>
      <BillToParty>
        <core:NameAddress>
          <core:Name1>Jane Smith</core:Name1>
          <core:Street>2 Woodbridge Ave</core:Street>
          <core:City>Edison</core:City>
          <core:Region>
            <core:RegionCoded>Other</core:RegionCoded>
            <core:RegionCodedOther>NJ</core:RegionCodedOther>
          </core:Region>
          <core:PostalCode>08837</core:PostalCode>
        </core:NameAddress>
        <core:PrimaryContact>
          <core:ContactFunction>
            <core:ContactFunctionCodedOther>BuyerNameOrDepartment</core:ContactFunctionCodedOther>
          </core:ContactFunction>
          <core:ListOfContactNumber>
            <core:ContactNumber>
              <core:ContactNumberTypeCoded>TelephoneNumber</core:ContactNumberTypeCoded>
              <core:ContactNumberValue>555-555-5555</core:ContactNumberValue>
            </core:ContactNumber>
          </core:ListOfContactNumber>
        </core:PrimaryContact>
      </BillToParty>

XPath-Zuordnungsdatei (Auszug)

Diese Tabelle zeigt einen Teil einer Beispiel-Zuordnungsdatei, die aus einem Workflow eines Partners heruntergeladen wurde. Zeilen, die für dieses Beispiel nicht relevant sind, wurden weggelassen.

ShortName	LongName	XPath	DataType
BEG01	Transaction Set Purpose Code	Order/OrderHeader/Purpose[core:PurposeCoded='Other']/core:PurposeCodedOther	string
BEG02	Purchase Order Type Code	Order/OrderHeader/ListOfNameValueSet/core:NameValueSet[core:SetName='HeaderReferences']/core:ListOfNameValuePair/core:NameValuePair[core:Name='POType']/core:Value	string
BEG03	Purchase Order Number	Order/OrderHeader/OrderNumber/BuyerOrderNumber	string
BEG05	Order Issue Date	Order/OrderHeader/OrderIssueDate	Date
BEG06	Contract Number	Order/OrderHeader/OrderReferences/ContractReferences/core:Contract/core:ContractID/core:Ident	string

BT-N102	Bill To Party Name	Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:Name1	string
BT-N103	Bill To Party Identification Code Qualifier	Order/OrderHeader/ListOfNameValueSet/core:NameValueSet[core:SetName='PartyReferences']/core:ListOfNameValuePair/core:NameValuePair[core:Name='BillToPartyPartyIdentificationCodeQualifier']/core:Value	string
BT-N104	Bill To Party Identification Code	Order/OrderHeader/OrderParty/BillToParty/core:PartyID/core:Ident	string
BT-N301	Bill To Party Address Line 1	Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:Street	string
BT-N302	Bill To Party Address Line 2	Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:StreetSupplement1	string
BT-N401	Bill To Party City	Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:City	string
BT-N402	Bill To Party State or Province Code	Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:Region[core:RegionCoded='Other']/core:RegionCodedOther	string
BT-N403	Bill To Party Postal Code	Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:PostalCode	string