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

Il connettore di messaggi Decode X12 convalida la busta in base all'accordo tra partner commerciali, convalida le proprietà EDI e specifiche del partner, suddivide gli interscambi in set di transazioni o mantiene gli interscambi interi, nonché genera riconoscimenti per le transazioni elaborate.With the Decode X12 message connector, you can validate the envelope against a trading partner agreement, validate EDI and partner-specific properties, split interchanges into transactions sets or preserve entire interchanges, and generate acknowledgments for processed transactions. 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 Decode X12 è necessario un account di integrazione.You must have an integration account to use the Decode 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 Decode X12Decode X12 messages

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

  2. Il connettore di messaggi Decode X12 non dispone di trigger, pertanto è necessario aggiungerne uno per avviare l'app per la logica, ad esempio un trigger di richiesta.The Decode 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 - Decodifica il messaggio X12.Select X12 - Decode X12 message.

    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.

    Fornire i dettagli della 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.

    dettagli della connessione all'account di integrazione

  6. Dopo aver creato la connessione, come illustrato in questo esempio, selezionare il messaggio con file flat X12 da decodificare.After your connection is created, as shown in this example, select the X12 flat file message to decode.

    connessione all'account di integrazione creata

    Ad esempio:For example:

    Selezionare il messaggio con il file flat X12 da decodificare

    Nota

    Il contenuto effettivo del messaggio o il payload per l'array di messaggio, valido o non valido, è con codifica base64.The actual message content or payload for the message array, good or bad, is base64 encoded. Pertanto è necessario specificare un'espressione che elabori questo contenuto.So, you must specify an expression that processes this content. Di seguito è riportato un esempio che elabora il contenuto come XML che è possibile inserire nella visualizzazione codice o usando il Generatore di espressioni nella finestra di progettazione.Here is an example that processes the content as XML that you can enter in code view or by using expression builder in the designer.

    "content": "@xml(base64ToBinary(item()?['Payload']))"
    

    Esempio di contenuto

Dettagli Decode X12X12 Decode details

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

  • Convalida la busta in base all'accordo tra partner commerciali.Validates the envelope against trading partner agreement
  • Convalida le proprietà EDI e specifiche del partner.Validates EDI and partner-specific properties
    • Convalida strutturale EDI e convalida estesa dello schema.EDI structural validation, and extended schema validation
    • Convalida della struttura della busta dell'interscambio.Validation of the structure of the interchange envelope.
    • Convalida dello schema della busta in base allo schema di controllo.Schema validation of the envelope against the control schema.
    • 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
  • Verifica che i numeri di controllo di un set di interscambio, gruppo e di transazioni non siano duplicati.Verifies that the interchange, group, and transaction set control numbers are not duplicates
    • Controlla il numero di controllo dell'interscambio rispetto agli interscambi ricevuti in precedenza.Checks the interchange control number against previously received interchanges.
    • Controlla il numero di controllo del gruppo con gli altri numeri di controllo del gruppo dell'interscambio.Checks the group control number against other group control numbers in the interchange.
    • Controlla il numero di controllo del set di transazioni con gli altri numeri di controllo del set transazioni in tale gruppo.Checks the transaction set control number against other transaction set control numbers in that group.
  • Suddivide l'interscambio in set di transazioni o mantiene l'intero interscambio:Splits the interchange into transaction sets, or preserves the entire interchange:
    • Suddivide l'interscambio in set di transazioni - sospende i set di transazioni in caso di errore: suddivide l'interscambio in set di transazioni e analizza ogni set di transazioni.Split Interchange as transaction sets - suspend transaction sets on error: Splits interchange into transaction sets and parses each transaction set. L'azione X12 Decode restituisce solo i set di transazioni che non sono stati convalidati in badMessages e restituisce i restanti set di transazioni in goodMessages.The X12 Decode action outputs only those transaction sets that fail validation to badMessages, and outputs the remaining transactions sets to goodMessages.
    • Suddivide l'interscambio in set di transazioni - sospende l'interscambio in caso di errore: suddivide l'interscambio in set di transazioni e analizza ogni set di transazioni.Split Interchange as transaction sets - suspend interchange on error: Splits interchange into transaction sets and parses each transaction set. Se la convalida di uno o più set di transazioni dell'interscambio non riesce, l'azione X12 Decode restituisce tutti i set di transazioni in quell'interscambio in badMessages.If one or more transaction sets in the interchange fail validation, the X12 Decode action outputs all the transaction sets in that interchange to badMessages.
    • Mantiene l'interscambio - sospende i set transazioni in caso di errore: mantiene l'interscambio ed elabora l'intero interscambio in batch.Preserve Interchange - suspend transaction sets on error: Preserve the interchange and process the entire batched interchange. L'azione X12 Decode restituisce solo i set di transazioni che non sono stati convalidati in badMessages e restituisce i restanti set di transazioni in goodMessages.The X12 Decode action outputs only those transaction sets that fail validation to badMessages, and outputs the remaining transactions sets to goodMessages.
    • Mantiene l'interscambio - sospende l'interscambio in caso di errore: mantiene l'interscambio ed elabora l'intero interscambio in batch.Preserve Interchange - suspend interchange on error: Preserve the interchange and process the entire batched interchange. Se la convalida di uno o più set di transazioni dell'interscambio non riesce, l'azione X12 Decode restituisce tutti i set di transazioni in quell'interscambio in badMessages.If one or more transaction sets in the interchange fail validation, the X12 Decode action outputs all the transaction sets in that interchange to badMessages.
  • Genera un riconoscimento tecnico e/o funzionale (se configurata).Generates 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