Encoder des messages X12 dans Azure Logic Apps avec Enterprise Integration PackEncode X12 messages in Azure Logic Apps with Enterprise Integration Pack

Avec le connecteur Encode X12 Message, vous pouvez valider l’EDI et les propriétés spécifiques au partenaire, convertir des messages codés au format XML en documents informatisés EDI au sein de l’échange, et demander un accusé de réception technique et/ou fonctionnel.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. 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 Encode X12 Message.You must have an integration account to use the Encode 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

Encoder des messages X12Encode X12 messages

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

  2. Le connecteur Encode 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 Encode 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 - Encode X12 Message par nom de contrat ou X12 - Encode to X 12 message par identités.Select either X12 - Encode to X12 message by agreement name or X12 - Encode to X12 message by identities.

    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.

    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.

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

    Votre connexion est maintenant créée.Your connection is now created.

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

Encode X12 message par nom de contratEncode X12 messages by agreement name

Si vous choisissez d’encoder des messages X12 par nom du contrat, ouvrez la liste Nom de l’accord X12, entrez ou sélectionnez votre contrat X12 existant.If you chose to encode X12 messages by agreement name, open the Name of X12 agreement list, enter or select your existing X12 agreement. Saisissez le message XML à encoder.Enter the XML message to encode.

Entrez le nom du contrat X12 et le nom du message XML à encoder

Encode X12 message par identitésEncode X12 messages by identities

Si vous choisissez d’encoder des messages X12 par identités, indiquez l’identificateur et le qualificateur de l’expéditeur ainsi que l’identificateur et le qualificateur du récepteur tels que configurés dans votre contrat 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. Sélectionnez le message XML à encoder.Select the XML message to encode.

Renseigner les identités de l’expéditeur et du destinataire, sélectionner le message XML à encoder

Détails sur X12 EncodeX12 Encode details

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

  • Résolution du contrat en faisant correspondre les propriétés de contexte de l’expéditeur et du récepteur.Agreement resolution by matching sender and receiver context properties.
  • Sérialise l’échange EDI en convertissant les messages codés au format XML en documents informatisés EDI au sein de l’échange.Serializes the EDI interchange, converting XML-encoded messages into EDI transaction sets in the interchange.
  • Applique les segments d’en-tête et de code de fin du document informatiséApplies transaction set header and trailer segments
  • Génère un numéro de contrôle d’échange, un numéro de contrôle de groupe et un numéro de contrôle de document informatisé pour chaque échange sortantGenerates an interchange control number, a group control number, and a transaction set control number for each outgoing interchange
  • Remplace les séparateurs dans les données de charge utileReplaces separators in the payload data
  • Valide l’EDI et les propriétés spécifiques au partenaireValidates EDI and partner-specific properties
    • Validation de schéma des éléments de données du document informatisé par rapport au schéma de messageSchema 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.
    • Validation étendue effectuée sur les éléments de données du document informatiséExtended validation performed on transaction-set data elements
  • Demande un accusé de réception fonctionnel et/ou technique (si configuré).Requests 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’adresseThe 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