XPath-Mapping-Datei in Jitterbit EDI

Einführung

Eine Mapping-Datei ist eine herunterladbare Referenzdatei, die die XPaths für alle X12 EDI-Segment-Elementcodes in einer Map enthält und zeigt, wie das EDI-Backend rohe X12 EDI-Dateien in xCBL abbildet. Diese XPath-Informationen können in Ihren Studio- oder Design Studio-Transformationen verwendet werden.

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

Verwendung der Mapping-Datei

Um die Mapping-Datei in einem Studio- oder Design Studio-Projekt zu verwenden, befolgen Sie diese Schritte:

Laden Sie die Mapping-Datei herunter für den Workflow eines Dokuments.
Öffnen Sie die Seite Transaktionen und suchen Sie das Dokument.
Erweitern Sie den Eintrag, um das Ansichten-Fenster anzuzeigen.
Klicken Sie auf den ersten Raw-Link, um den X12 EDI-Inhalt für das Dokument zu öffnen.
Klicken Sie auf den zweiten Raw-Link, um denselben Inhalt im xCBL-Format zu öffnen.
Suchen Sie im X12 EDI-Dokument das Feld, das transformiert werden soll, und notieren Sie den EDI-Elementcode.
Suchen Sie in der XPath-Mapping-Datei den EDI-Elementcode und den entsprechenden XPath. Verwenden Sie die xCBL-Version, um zu bestätigen, dass der XPath und der abgebildete Wert übereinstimmen.

Beispiel

In diesem Beispiel werden äquivalente Felder in Beispielen einer X12 EDI-Datei, der konvertierten xCBL-Datei und einem Auszug aus der XPath-Mapping-Datei 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***BUCHLISTE
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>Telefonnummer</core:ContactNumberTypeCoded>
              <core:ContactNumberValue>555-555-5555</core:ContactNumberValue>
            </core:ContactNumber>
          </core:ListOfContactNumber>
        </core:PrimaryContact>
      </BillToParty>

XPath-Mapping-Datei (Extrahieren)

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

Kurzname	Langname	XPath	Datentyp
BEG01	Transaktionssatz-Zweckcode	Order/OrderHeader/Purpose[core:PurposeCoded='Other']/core:PurposeCodedOther	string
BEG02	Bestelltyp-Code	Order/OrderHeader/ListOfNameValueSet/core:NameValueSet[core:SetName='HeaderReferences']/core:ListOfNameValuePair/core:NameValuePair[core:Name='POType']/core:Value	string
BEG03	Bestellnummer	Order/OrderHeader/OrderNumber/BuyerOrderNumber	string
BEG05	Bestelldatum	Order/OrderHeader/OrderIssueDate	Datum
BEG06	Vertragsnummer	Order/OrderHeader/OrderReferences/ContractReferences/core:Contract/core:ContractID/core:Ident	string

BT-N102	Rechnungsadresse Name	Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:Name1	string
BT-N103	Rechnungsadresse Identifikationscode Qualifier	Order/OrderHeader/ListOfNameValueSet/core:NameValueSet[core:SetName='PartyReferences']/core:ListOfNameValuePair/core:NameValuePair[core:Name='BillToPartyPartyIdentificationCodeQualifier']/core:Value	string
BT-N104	Rechnungsadresse Identifikationscode	Order/OrderHeader/OrderParty/BillToParty/core:PartyID/core:Ident	string
BT-N301	Rechnungsadresse Zeile 1	Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:Street	string
BT-N302	Rechnungsadresse Zeile 2	Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:StreetSupplement1	string
BT-N401	Rechnungsadresse Stadt	Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:City	string
BT-N402	Rechnungsadresse Bundesland oder Provinzcode	Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:Region[core:RegionCoded='Other']/core:RegionCodedOther	string
BT-N403	Rechnungsadresse Postleitzahl	Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:PostalCode	string