Arquivo de Mapeamento XPath¶
Introdução¶
Um arquivo de mapeamento é um arquivo de referência para download que contém os XPaths para todos os códigos de elemento de segmento EDI X12 em um mapa e mostra como o backend EDI mapeia arquivos EDI X12 brutos para xCBL. Essas informações XPath podem ser usadas nas transformações do Cloud Studio ou do Design Studio.
O arquivo é um arquivo de texto simples com um .csv
extensão contendo campos separados por vírgula.
Use o Arquivo de Mapeamento¶
Para usar o arquivo de mapeamento em um projeto do Cloud Studio ou Design Studio, siga estas etapas:
- Baixe o arquivo de mapeamento para o workflow de um documento.
- Abra Transações página e localize o documento.
- Expanda a entrada para expor o painel Visualizações.
- Clique no primeiro link Raw para abrir o conteúdo EDI X12 do documento.
- Clique no segundo link Raw para abrir o mesmo conteúdo convertido para o formato xCBL.
- No arquivo X12 EDI, localize o campo a ser transformado e anote o código do elemento EDI.
- No arquivo de mapeamento XPath, encontre o código do elemento EDI e o XPath correspondente. Use a versão xCBL para confirmar a correspondência do XPath e do valor mapeado.
Exemplo¶
Neste exemplo, campos equivalentes são destacados em amostras de um arquivo X12 EDI, o arquivo xCBL convertido e uma extração do arquivo de mapeamento XPath.
Arquivo EDI X12 (pedido de Compra, 850)¶
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
IMPLORAR*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*Avenida Woodbridge, 2
N4*Edison*Nova Jersey*08837
PER*BD**TE*555-555-5555
N1*ST*Jane Smith
Avenida Woodbridge N3*2
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***LISTAGEM DE LIVROS
DTM*038*20610467
TD5*****UPSN
CTT*1
SE*25*0002
GE*7*6
AIE*1*000000007
Arquivo Xcbl¶
<Pedido>
<OrderHeader>
<Número do pedido>
<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:Contrato>
</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>
<Objetivo>
<core:PurposeCoded>Outro</core:PurposeCoded>
<core:PurposeCodedOther>00</core:PurposeCodedOther>
</Purpose>
<OrderType>
<core:OrderTypeCoded>Outro</core:OrderTypeCoded>
<core:OrderTypeCodedOther>SA</core:OrderTypeCodedOther>
</OrderType>
<OrderCurrency>
<core:CurrencyCoded>Outros</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</ núcleo:Data>
</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 Avenida</core:Rua>
<core:Cidade>Edison</core:Cidade>
<core:Região>
<core:RegionCoded>Outro</core:RegionCoded>
<core:RegionCodedOther>Nova Jersey</core:RegionCodedOther>
</core:Região>
<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>
Arquivo de Mapeamento XPath (extração)¶
Esta tabela mostra parte de um arquivo de mapeamento de amostra baixado do workflow de um parceiro. As linhas não relevantes para este exemplo são omitidas.
Nome curto | Nome Longo | XPath | Tipo de dados |
---|---|---|---|
BEG01 | Código de finalidade do conjunto de transações | Pedido/OrderHeader/Purpose[core:PurposeCoded='Other']/core:PurposeCodedOther | corda |
BEG02 | Código do tipo de pedido de compra | Order/OrderHeader/ListOfNameValueSet/core:NameValueSet[core:SetName='HeaderReferences']/core:ListOfNameValuePair/core:NameValuePair[core:Name='POType']/core:Value | corda |
BEG03 | Número do pedido de compra | Pedido/OrderHeader/OrderNumber/BuyerOrderNumber | corda |
BEG05 | Data de emissão do pedido | Pedido/OrderHeader/OrderIssueDate | Data |
BEG06 | Número do contrato | Order/OrderHeader/OrderReferences/ContractReferences/core:Contract/core:ContractID/core:Ident | corda |
BT-N102 | Nome da conta para a parte | Pedido/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:Name1 | corda |
BT-N103 | Qualificador de código de identificação de cobrança para parte | Order/OrderHeader/ListOfNameValueSet/core:NameValueSet[core:SetName='PartyReferences']/core:ListOfNameValuePair/core:NameValuePair[core:Name='BillToPartyPartyIdentificationCodeQualifier']/core:Value | corda |
BT-N104 | Código de identificação da fatura para a parte | Order/OrderHeader/OrderParty/BillToParty/core:PartyID/core:Ident | corda |
BT-N301 | Linha 1 do endereço da fatura para a parte | Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:Street | corda |
BT-N302 | Linha 2 do endereço da fatura para a parte | Pedido/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:StreetSupplement1 | corda |
BT-N401 | Projeto de lei para festa na cidade | Pedido/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:Cidade | corda |
BT-N402 | Código do estado ou província da fatura para a parte | Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:Region[core:RegionCoded='Other']/core:RegionCodedOther | corda |
BT-N403 | Cobrar para festa Código Postal | Pedido/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:PostalCode | corda |