XPath-Mapping-Datei in Jitterbit EDI

Einführung

Eine Mapping-Datei ist eine herunterladbare Referenzdatei, die die XPaths für alle X12 EDI-Segmentelementcodes in einer Map enthält und zeigt, wie das EDI-Backend X12-EDI-Rohdateien auf xCBL mappt. Diese XPath-Informationen können in Ihrem Integration Studio oder Design Studio Transformations.

Die Datei ist eine reine Textdatei mit einer .csv Erweiterung mit durch Kommas getrennten Feldern.

Verwenden der Zuordnungsdatei

Um die Zuordnungsdatei in an Integration Studio oder Design Studio Projekt, folgen Sie diesen Schritten:

Laden Sie die Mapping-Datei herunter für den Workflow eines Dokuments.
Öffnen Sie die Transaktionen-Seite und suchen Sie das Dokument.
Erweitern Sie den Eintrag, um den Bereich Ansichten 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 in das xCBL-Format konvertiert zu öffnen.
Suchen Sie in der X12-EDI-Datei das zu transformierende Feld und notieren Sie sich den EDI-Elementcode.
Suchen Sie in der XPath-Zuordnungsdatei den EDI-Elementcode und den entsprechenden XPath. Verwenden Sie die xCBL-Version, um zu bestätigen, dass XPath und zugeordneter Wert übereinstimmen.

Beispiel

In diesem Beispiel werden äquivalente Felder in Beispielen einer X12 EDI-Datei hervorgehoben, die konvertierte xCBL-Datei und ein Auszug der XPath-Mapping-Datei.

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-Mapping-Datei (Auszug)

Diese Tabelle zeigt einen Teil einer Beispiel-Mapping-Datei heruntergeladen aus dem Workflow eines Partners. Für dieses Beispiel nicht relevante Zeilen werden 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