Décoder des messages X12 dans Azure Logic Apps avec Enterprise Integration PackDecode X12 messages in Azure Logic Apps with Enterprise Integration Pack

Avec le connecteur de messages Decode X12, vous pouvez valider l’enveloppe en fonction d’un accord de partenariat commercial, valider l’EDI et les propriétés spécifiques du partenaire, fractionner des échanges en documents informatisés ou conserver les échanges entiers et générer des acquittements pour les transactions traitées.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. Pour utiliser ce connecteur, vous devez ajouter le connecteur à un déclencheur existant dans votre application logique.To use this connector, you must add the connector to an existing trigger in your logic app.

Avant de commencerBefore you start

Voici les éléments dont vous avez besoin :Here's the items you need:

  • Un compte Azure (que vous pouvez créer gratuitement)An Azure account; you can create a free account
  • Un compte d’intégration déjà défini et associé à votre abonnement Azure.An integration account that's already defined and associated with your Azure subscription. Vous devez disposer d’un compte d’intégration pour pouvoir utiliser le connecteur Decode X12 Message.You must have an integration account to use the Decode X12 message connector.
  • Au moins deux partenaires déjà définis dans votre compte d’intégrationAt least two partners that are already defined in your integration account
  • Un contrat X12 déjà défini dans votre compte d’intégrationAn X12 agreement that's already defined in your integration account

Décoder des messages X12Decode X12 messages

  1. Créez une application logique.Create a logic app.

  2. Le connecteur Decode X12 Message ne possède aucun déclencheur, ce qui signifie que vous devez ajouter un déclencheur pour le démarrage de votre application logique, par exemple un déclencheur de requête.The Decode X12 message connector doesn't have triggers, so you must add a trigger for starting your logic app, like a Request trigger. Dans le concepteur d’applications logiques, ajoutez un déclencheur, puis ajoutez une action à votre application logique.In the Logic App Designer, add a trigger, and then add an action to your logic app.

  3. Dans la zone de recherche, entrez le filtre « x12 ».In the search box, enter "x12" for your filter. Sélectionnez X12 – Decode X12 Message.Select X12 - Decode X12 message.

    Recherchez « x12 »

  4. Si vous n’avez pas encore créé de connexions à votre compte d’intégration, vous êtes invité à le faire à cette étape.If you didn't previously create any connections to your integration account, you're prompted to create that connection now. Donnez un nom à votre connexion, puis sélectionnez le compte d’intégration auquel vous souhaitez vous connecter.Name your connection, and select the integration account that you want to connect.

    Fournir les détails de connexion de compte d’intégration

    Les propriétés marquées d’un astérisque sont obligatoires.Properties with an asterisk are required.

    PropriétéProperty DétailsDetails
    Nom de connexion *Connection Name * Entrez un nom pour votre connexion.Enter any name for your connection.
    Compte d’intégration *Integration Account * Entrez un nom pour votre compte d’intégration.Enter a name for your integration account. Vérifiez que votre compte d’intégration et votre application logique se trouvent dans le même emplacement Azure.Make sure that your integration account and logic app are in the same Azure location.
  5. Lorsque vous avez terminé, les détails de votre connexion doivent apparaître tels qu’indiqués dans l’exemple suivant.When you're done, your connection details should look similar to this example. Pour terminer la création de votre connexion, sélectionnez l’option Créer.To finish creating your connection, choose Create.

    détails de connexion de compte d’intégration

  6. Une fois votre connexion est créée, comme indiqué dans cet exemple, sélectionnez le message de fichier plat X12 à décoder.After your connection is created, as shown in this example, select the X12 flat file message to decode.

    connexion de compte d’intégration créée

    Par exemple :For example:

    Sélectionner le message de fichier plat X12 à décoder

    Notes

    Le contenu réel du message ou la charge utile pour le tableau de message, bon ou mauvais, est codé en base64.The actual message content or payload for the message array, good or bad, is base64 encoded. Ainsi, vous devez spécifier une expression qui traite ce contenu.So, you must specify an expression that processes this content. Voici un exemple qui traite le contenu en tant que XML que vous pouvez entrer en mode Code ou à l’aide du Générateur d’expressions dans le concepteur.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']))"
    

    Exemple de contenu

Informations sur X12 DecodeX12 Decode details

Le connecteur X12 Decode effectue les tâches suivantes :The X12 Decode connector performs these tasks:

  • Valide l’enveloppe par rapport au contrat de partenariat commercialValidates the envelope against trading partner agreement
  • Valide l’EDI et les propriétés spécifiques au partenaireValidates EDI and partner-specific properties
    • Validation de la structure EDI et validation du schéma étendueEDI structural validation, and extended schema validation
    • Validation de la structure de l’enveloppe d’échange.Validation of the structure of the interchange envelope.
    • Validation de schéma de l’enveloppe par rapport au schéma de contrôle.Schema validation of the envelope against the control schema.
    • Validation de schéma des éléments de données du document informatisé par rapport au schéma de message.Schema validation of the transaction-set data elements against the message schema.
    • Validation EDI effectuée sur les éléments de données du document informatisé.EDI validation performed on transaction-set data elements
  • Vérifie que les numéros de contrôle de l’échange, du groupe et du document informatisé ne sont pas des doublons.Verifies that the interchange, group, and transaction set control numbers are not duplicates
    • Vérifie le numéro de contrôle de l’échange par rapport aux échanges reçus précédemment.Checks the interchange control number against previously received interchanges.
    • Vérifie le numéro de contrôle du groupe par rapport aux autres numéros de contrôle de groupe dans l’échange.Checks the group control number against other group control numbers in the interchange.
    • Vérifie le numéro de contrôle du document informatisé par rapport aux autres numéros de contrôle de document informatisé dans ce groupe.Checks the transaction set control number against other transaction set control numbers in that group.
  • Fractionne l’échange en documents informatisés ou conserve l’échange entier :Splits the interchange into transaction sets, or preserves the entire interchange:
    • Scinder l’échange en documents informatisés  - suspendre les documents informatisés en cas d’erreur : Scinde l’échange en documents informatisés et analyse chaque document informatisé.Split Interchange as transaction sets - suspend transaction sets on error: Splits interchange into transaction sets and parses each transaction set. L’action X12 Decode ne génère que les documents informatisés qui échouent à la validation badMessages et produit les documents informatisés restants en tant que goodMessages.The X12 Decode action outputs only those transaction sets that fail validation to badMessages, and outputs the remaining transactions sets to goodMessages.
    • Scinder l’échange en documents informatisés - suspendre l’échange en cas d’erreur : Scinde l’échange en documents informatisés et analyse chaque document informatisé.Split Interchange as transaction sets - suspend interchange on error: Splits interchange into transaction sets and parses each transaction set. Si la validation d’un ou de plusieurs documents informatisés de l’échange échoue, l’action X12 Decode génère tous les documents informatisés dans cet échange en tant que 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.
    • Préserver l’échange - suspendre les documents informatisés en cas d’erreur : Préserve l’échange et traite l’intégralité de l’échange par lot.Preserve Interchange - suspend transaction sets on error: Preserve the interchange and process the entire batched interchange. L’action X12 Decode ne génère que les documents informatisés qui échouent à la validation badMessages et produit les documents informatisés restants en tant que goodMessages.The X12 Decode action outputs only those transaction sets that fail validation to badMessages, and outputs the remaining transactions sets to goodMessages.
    • Préserver l’échange - suspendre l’échange en cas d’erreur : Préserve l’échange et traite l’intégralité de l’échange par lot.Preserve Interchange - suspend interchange on error: Preserve the interchange and process the entire batched interchange. Si la validation d’un ou de plusieurs documents informatisés de l’échange échoue, l’action X12 Decode génère tous les documents informatisés dans cet échange en tant que 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.
  • Génère un accusé de réception fonctionnel et/ou technique (si configuré).Generates a Technical and/or Functional acknowledgment (if configured).
    • Suite à la validation de l’en-tête, un accusé de réception technique est généré.A Technical Acknowledgment generates as a result of header validation. L’accusé de réception technique renvoie l’état du traitement de l’en-tête et du code de fin d’un échange par le récepteur de l’adresse.The technical acknowledgment reports the status of the processing of an interchange header and trailer by the address receiver.
    • Suite à la validation du corps, un accusé de réception fonctionnel est généré.A Functional Acknowledgment generates as a result of body validation. L’accusé de réception fonctionnel signale chaque erreur rencontrée lors du traitement du document reçuThe functional acknowledgment reports each error encountered while processing the received document

Afficher le swaggerView the swagger

Consultez les détails sur Swagger.See the swagger details.

Étapes suivantesNext steps

En savoir plus sur Enterprise Integration PackLearn more about the Enterprise Integration Pack