Messaggi Encode X12 in App per la logica di Azure con Enterprise Integration PackEncode X12 messages for Azure Logic Apps with the Enterprise Integration Pack

Il connettore di messaggi Encode X12 convalida le proprietà EDI e specifiche del partner, converte i messaggi con codifica XML in set di transazioni EDI nell'interscambio e richiede un riconoscimento tecnico, funzionale o entrambi.With the Encode X12 message connector, you can validate EDI and partner-specific properties, convert XML-encoded messages into EDI transaction sets in the interchange, and request a Technical Acknowledgement, Functional Acknowledgment, or both. Per usare questo connettore, è necessario aggiungerlo a un trigger esistente nell'app per la logica.To use this connector, you must add the connector to an existing trigger in your logic app.

Prima di iniziareBefore you start

Sono necessari gli elementi seguenti:Here's the items you need:

  • Un account Azure, che è possibile creare gratuitamenteAn Azure account; you can create a free account
  • Un account di integrazione già definito e associato alla sottoscrizione di Azure.An integration account that's already defined and associated with your Azure subscription. Per usare il connettore di messaggi Encode X12 è necessario un account di integrazione.You must have an integration account to use the Encode X12 message connector.
  • Almeno due partner già definiti nell'account di integrazione.At least two partners that are already defined in your integration account
  • Un contratto X12 già definito nell'account di integrazione.An X12 agreement that's already defined in your integration account

Messaggi Encode X12Encode X12 messages

  1. Creare un'app per la logica.Create a logic app.

  2. Il connettore di messaggi Encode X12 non dispone di trigger, pertanto è necessario aggiungerne uno per avviare l'app per la logica, ad esempio un trigger di richiesta.The Encode X12 message connector doesn't have triggers, so you must add a trigger for starting your logic app, like a Request trigger. In Progettazione app per la logica aggiungere un trigger e un'azione all'app per la logica.In the Logic App Designer, add a trigger, and then add an action to your logic app.

  3. Nella casella di ricerca, immettere "x12" come filtro.In the search box, enter "x12" for your filter. Selezionare X12 - Codifica in un messaggio X12 in base al nome dell'accordo o X12 - Codifica in un messaggio X12 in base alle identità.Select either X12 - Encode to X12 message by agreement name or X12 - Encode to X12 message by identities.

    Cercare "X12"

  4. Se non sono state create in precedenza le connessioni all'account di integrazione, a questo punto viene richiesto di creare la connessione.If you didn't previously create any connections to your integration account, you're prompted to create that connection now. Denominare la connessione e selezionare l'account di integrazione al quale connettersi.Name your connection, and select the integration account that you want to connect.

    connessione all'account di integrazione

    Le proprietà con l'asterisco sono obbligatorie.Properties with an asterisk are required.

    ProprietàProperty DettagliDetails
    Nome connessione *Connection Name * Immettere un nome per la connessione.Enter any name for your connection.
    Account di integrazione *Integration Account * Immettere un nome per l'account di integrazione.Enter a name for your integration account. Verificare che l'account di integrazione e l'app per la logica si trovino nella stessa località di Azure.Make sure that your integration account and logic app are in the same Azure location.
  5. Al termine, i dettagli della connessione dovrebbero essere simili a quelli dell'esempio seguente.When you're done, your connection details should look similar to this example. Per completare la creazione della connessione, scegliere Crea.To finish creating your connection, choose Create.

    connessione all'account di integrazione creata

    La connessione è stata creata.Your connection is now created.

    dettagli della connessione all'account di integrazione

Encode X12 Message by agreement name (Messaggio Encode X12 per nome contratto)Encode X12 messages by agreement name

Se si sceglie di codificare i messaggi X12 in base al nome del contratto, aprire l'elenco Nome dell'accordo X12 e digitare o selezionare il contratto X12 esistente.If you chose to encode X12 messages by agreement name, open the Name of X12 agreement list, enter or select your existing X12 agreement. Immettere il messaggio XML da codificare.Enter the XML message to encode.

Immettere il nome del contratto X12 e il messaggio XML da codificare.

Encode X12 Message by identities (Messaggio Encode X12 per identità)Encode X12 messages by identities

Se si sceglie di codificare i messaggi X12 in base alle identità, inserire l'identificatore del mittente, il qualificatore del mittente, l'identificatore del destinatario e il qualificatore del destinatario come configurati nel contratto X12.If you choose to encode X12 messages by identities, enter the sender identifier, sender qualifier, receiver identifier, and receiver qualifier as configured in your X12 agreement. Selezionare il messaggio XML da codificare.Select the XML message to encode.

Fornire le identità del mittente e del destinatario e selezionare il messaggio XML da codificare

Dettagli di Encode X12X12 Encode details

Il connettore Encode X12 esegue queste attività:The X12 Encode connector performs these tasks:

  • Risoluzione del contratto associando le proprietà del contesto di mittente e del destinatario.Agreement resolution by matching sender and receiver context properties.
  • Serializza l'interscambio EDI, conversione dei messaggi con codifica XML in set di transazioni EDI nell'interscambio.Serializes the EDI interchange, converting XML-encoded messages into EDI transaction sets in the interchange.
  • Si applica ai segmenti di intestazione e finali del set di transazioni.Applies transaction set header and trailer segments
  • Genera un numero di controllo di interscambio, un numero di controllo di gruppo e un numero di controllo del set di transazioni per ogni interscambio in uscita.Generates an interchange control number, a group control number, and a transaction set control number for each outgoing interchange
  • Sostituisce i separatori nei dati del payload.Replaces separators in the payload data
  • Convalida le proprietà EDI e specifiche del partner.Validates EDI and partner-specific properties
    • Convalida dello schema degli elementi dati del set di transazioni rispetto allo schema del messaggio.Schema validation of the transaction-set data elements against the message Schema
    • Convalida EDI eseguita sugli elementi dati del set di transazioni.EDI validation performed on transaction-set data elements.
    • Convalida estesa eseguita sugli elementi dati del set di transazioni.Extended validation performed on transaction-set data elements
  • Richiede un riconoscimento tecnico e/o funzionale (se configurata).Requests a Technical and/or Functional acknowledgment (if configured).
    • Un riconoscimento tecnico viene generato in seguito alla convalida dell'intestazione.A Technical Acknowledgment generates as a result of header validation. Il riconoscimento tecnico segnala lo stato dell'elaborazione di un'intestazione e finale di interscambio in base all'indirizzo del ricevitore.The technical acknowledgment reports the status of the processing of an interchange header and trailer by the address receiver
    • Un riconoscimento funzionale viene generato in seguito alla convalida del corpo.A Functional Acknowledgment generates as a result of body validation. Il riconoscimento funzionale segnala ogni errore rilevato durante l'elaborazione del documento ricevuto.The functional acknowledgment reports each error encountered while processing the received document

Visualizzare il file SwaggerView the swagger

Vedere i dettagli del file Swagger.See the swagger details.

Passaggi successiviNext steps

Altre informazioni su Enterprise Integration PackLearn more about the Enterprise Integration Pack