Partager via


Échanger des messages RosettaNet pour l’intégration B2B à l’aide de workflows dans Azure Logic Apps

S’applique à : Azure Logic Apps (Consommation)

Pour envoyer et recevoir des messages RosettaNet dans des workflows que vous créez à l’aide d’Azure Logic Apps, vous pouvez utiliser le connecteur RosettaNet, qui fournit des actions pour gérer et prendre en charge la communication conforme aux normes RosettaNet. RosettaNet est un consortium à but non lucratif qui a établi un processus standard pour le partage des informations métier. Ces normes sont couramment utilisées dans les processus de chaîne d’approvisionnement et sont répandues dans les secteurs des semi-conducteurs, de l’électronique ainsi que de la logistique. Le consortium RosettaNet crée et gère des processus PIP (Partner Interface Process) qui fournissent des définitions de processus métier communes pour tous les échanges de messages RosettaNet. RosettaNet repose sur XML et définit des directives de messages, des interfaces pour les processus métier, ainsi que des cadres d’implémentations à des fins de communication entre les entreprises. Pour plus d’informations, consultez le site RosettaNet.

Le connecteur est basé sur la version 2.0.01 de la norme RNIF (RosettaNet Implementation Framework) et prend en charge tous les processus PIP définis par cette version. RNIF est une infrastructure d’application réseau ouverte qui permet aux partenaires professionnels d’exécuter de façon collaborative des processus PIP RosettaNet. Cette infrastructure définit la structure des messages, la nécessité d’accusés de réception, le codage MIME (Multipurpose Internet Mail Extensions) et la signature numérique. La communication avec le partenaire peut être synchrone ou asynchrone. Le connecteur fournit les fonctionnalités suivantes :

  • Recevoir ou décoder des messages RosettaNet.
  • Envoyer ou encoder des messages RosettaNet.
  • Attendre la réponse et la génération d’une notification d’échec.

Ce guide pratique explique comment envoyer et recevoir des messages RosettaNet dans des workflows à l’aide d’Azure Logic Apps et du connecteur RosettaNet en procédant comme suit :

  • Ajoutez une configuration de processus PIP le cas échéant.
  • Créez un contrat RosettaNet.
  • Ajoutez une action pour recevoir ou décoder les messages RosettaNet.
  • Ajoutez une action pour envoyer ou encoder les messages RosettaNet.

Concepts RosettaNet

Les concepts et termes suivants sont propres à la spécification RosettaNet. Il est important de les connaître quand vous créez des workflows d’intégration basés sur RosettaNet :

  • PIP

    L’organisation RosettaNet crée et gère des processus PIP qui fournissent des définitions de processus métier communes pour tous les échanges de messages RosettaNet. Chaque spécification PIP fournit un fichier de définition de type de document (DTD) et un document d’orientation de message. Le fichier DTD définit la structure des messages de contenu de service. Le document d’orientation de message (fichier HTML lisible par l’homme) spécifie des contraintes au niveau de l’élément. Ensemble, ces fichiers fournissent une définition complète du processus d’entreprise.

    Les processus PIP sont classés par fonction d’entreprise de haut niveau ou cluster, et sous-fonction ou segment. Par exemple, « 3A4 » est le processus PIP lié au bon de commande, où « 3 » correspond à la fonction de gestion des commandes et « 3A » à la sous-fonction de saisie de devis et de commande. Pour plus d’informations, consultez le site RosettaNet.

  • Action

    Dans le cadre d’un processus PIP, les messages d’action sont les messages professionnels échangés entre partenaires.

  • Signal

    Dans le cadre d’un processus PIP, les messages de signal sont les accusés de réception envoyés en réponse aux messages d’action.

  • Action unique et double action

    Dans le cadre d’un processus PIP à action unique, la seule réponse est un message de signal d’accusé de réception. Dans le cadre d’un processus PIP à double action, l’initiateur reçoit un message de réponse et y répond avec un accusé de réception en plus du flux de messages d’action unique.

Référence technique du connecteur

Le connecteur RosettaNet est disponible uniquement pour les workflows d’application logique Consommation.

Application logique Environnement Version du connecteur
Consommation Azure Logic Apps multilocataire Connecteur managé, qui apparaît dans le concepteur sous l’étiquette Standard. Le connecteur RosettaNet fournit uniquement des actions. Cependant, vous pouvez utiliser n’importe quel déclencheur qui convient à votre scénario. Pour plus d’informations, consultez la documentation suivante :

- Opérations de connecteur RosettaNet
- Limites du protocole B2B pour les tailles de message
- Connecteurs managés dans Azure Logic Apps

Opérations RosettaNet

Le connecteur RosettaNet ne comporte aucun déclencheur. Le tableau suivant décrit les actions réalisées par le connecteur RosettaNet pour établir la sécurité et la fiabilité lors de la transmission de messages :

Action Description
Action Encoder RosettaNet Envoyer des messages RosettaNet à l’aide d’un encodage qui respecte les normes RosettaNet.
Action Décoder RosettaNet Recevoir des messages RosettaNet à l’aide d’un décodage qui respecte les normes RosettaNet.
Action Attente de réponse par RosettaNet Demander à l’hôte d’attendre une réponse RosettaNet ou un message de signal du récepteur.

Prérequis

  • Un compte et un abonnement Azure. Si vous n’avez pas d’abonnement, créez un compte gratuit.

  • La ressource d’application logique Consommation et le flux de travail dans lesquels vous souhaitez utiliser les opérations RosettaNet.

  • Compte d’intégration pour stocker votre contrat et d’autres artefacts B2B (interentreprise).

    Important

    Pour opérer ensemble, votre compte d’intégration et votre ressource d’application logique doivent exister dans le même abonnement et la même région Azure. Pour utiliser des artefacts de compte d’intégration dans votre workflow, assurez-vous de lier votre ressource d’application logique à votre compte d’intégration.

  • Au moins deux partenaires définis dans votre compte d’intégration et utilisant le qualificateur DUNS sous Identités d’entreprise dans le portail Microsoft Azure.

    Remarque

    Assurez-vous que vous sélectionnez DUNS comme qualificateur, que vous pouvez trouver en bas de la liste Qualificateurs, et non 1 - D-U-N-S (Dun & Bradstreet).

  • Des certificats facultatifs pour chiffrer, déchiffrer ou signer les messages que vous chargez sur le compte d’intégration. Les certificats sont nécessaires uniquement si vous utilisez la signature ou le chiffrement.

Ajouter une configuration de processus PIP

Pour envoyer ou recevoir des messages RosettaNet, votre compte d’intégration nécessite une configuration de processus PIP le cas échéant. La configuration du processus stocke toutes les caractéristiques de configuration du processus PIP. Vous pouvez ensuite faire référence à cette configuration quand vous créez un contrat avec un partenaire.

  1. Dans le portail Azure, accédez à votre compte d’intégration.

  2. Dans le menu de navigation du compte d’intégration, sous Paramètres, sélectionnez PIP RosettaNet.

    Capture d’écran du portail Azure et de la page du compte d’intégration. Dans le menu de navigation, PIP RosettaNet est sélectionné.

  3. Dans la page RosettaNet PIP, sélectionnez Ajouter. Dans le volet Ajouter un processus PIP (Partner Interface Process), entrez vos détails PIP.

    Capture d’écran de la page PIP RosettaNet avec l’option Ajouter sélectionnée. Le volet Ajouter un processus PIP (Partner Interface Process) contient des zones pour le nom, le code et la version.

    Propriété Obligatoire Description
    Nom Oui Nom de votre processus PIP.
    PIP Code (Code de PIP) Oui Le code PIP à trois chiffres. Pour plus d’informations, consultez les processus PIP RosettaNet.
    PIP Version (Version de PIP) Oui Numéro de version du processus PIP, en fonction du code PIP sélectionné.

    Pour plus d’informations sur ces propriétés de processus PIP, visitez le site web de RosettaNet.

  4. Quand vous avez terminé, sélectionnez OK pour créer la configuration PIP.

  5. Pour afficher ou modifier la configuration du processus, sélectionnez le PIP, puis choisissez Modifier au format JSON.

    Tous les paramètres de configuration du processus proviennent les spécifications du processus PIP. Azure Logic Apps remplit la plupart des paramètres avec les valeurs par défaut qui sont les valeurs généralement les plus utilisées pour ces propriétés.

    Capture d’écran de la page RosettaNet PIP, avec Modifier au format JSON et un processus PIP sélectionné. Sous Modifier au format JSON, les propriétés PIP encodées sont visibles.

  6. Vérifiez que les paramètres correspondent aux valeurs dans la spécification de processus PIP appropriée et répondent aux besoins de votre entreprise. Si nécessaire, mettez à jour les valeurs dans JSON et enregistrez ces modifications.

Créer un contrat RosettaNet

  1. Dans le portail Azure, accédez à votre compte d’intégration.

  2. Dans le menu de navigation du compte d’intégration, sous Paramètres, sélectionnez Contrats.

    Capture d’écran montrant le portail Azure avec la page du compte d’intégration ouverte. Dans le menu de navigation, l’option Accords est sélectionnée.

  3. Dans la page Contrats, sélectionnez Ajouter. Sous Ajouter, entrez les détails de votre contrat.

    Capture d’écran montrant la page Accords avec l’option Ajouter sélectionnée. Dans le volet Nommé Ajouter, les zones s’affichent pour le nom et le type d’accord et pour les informations du partenaire.

    Propriété Obligatoire Description
    Nom Oui Nom du contrat.
    Type d'accord Oui Type de contrat. Sélectionnez RosettaNet.
    Partenaire hôte Oui Organisation qui configure le contrat. Un contrat nécessite un partenaire hôte et un partenaire invité.
    Identité de l'hôte Oui Identificateur du partenaire hôte.
    Partenaire invité Oui Organisation qui travaille avec le partenaire hôte. Un contrat nécessite un partenaire hôte et un partenaire invité.
    Identité de l'invité Oui Identificateur du partenaire invité.
    Paramètres de réception Variable Propriétés qui s’appliquent à tous les messages reçus par le partenaire hôte.
    Paramètres d'envoi Variable Propriétés qui s’appliquent à tous les messages envoyés par le partenaire hôte.
    RosettaNet PIP references (Références de processus PIP RosettaNet) Oui Références de processus PIP du contrat. Tous les messages RosettaNet nécessitent des configurations de processus PIP.
  4. Pour configurer votre contrat pour recevoir des messages entrants du partenaire invité, sélectionnez Paramètres de réception.

    1. Pour activer la signature ou le chiffrement pour les messages entrants, sous Message, sélectionnez Le message doit être signé ou Le message doit être chiffré.

      Propriété Obligatoire Description
      Le message doit être signé Non Option pour signer les messages entrants avec le certificat sélectionné
      Certificate Oui, si la signature est activée Certificat à utiliser pour la signature
      Activer le chiffrement des messages Non Option pour chiffrer les messages entrants avec le certificat sélectionné
      Certificate Oui, si le chiffrement est activé Certificat à utiliser pour le chiffrement
    2. Sous chaque sélection, sélectionnez le certificat dans votre compte d’intégration que vous souhaitez utiliser pour la signature ou le chiffrement.

    Capture d’écran de la page Paramètres de réception, avec des options pour signer et chiffrer les messages, ainsi que pour entrer les certificats.

  5. Pour configurer votre contrat pour envoyer des messages au partenaire invité, sélectionnez Paramètres d’envoi.

    1. Pour activer la signature ou chiffrement pour les messages sortants, sous Messages, sélectionnez Activer la signature des messages ou Activer le chiffrement des messages. Sous chaque sélection, sélectionnez l’algorithme et le certificat dans votre compte d’intégration que vous souhaitez utiliser pour la signature ou le chiffrement.

      Propriété Obligatoire Description
      Activer la signature des messages Non Option pour signer les messages sortants avec l’algorithme de signature et le certificat sélectionnés
      Algorithme de signature Oui, si la signature est activée Algorithme de signature à utiliser, basé sur le certificat sélectionné
      Certificate Oui, si la signature est activée Certificat à utiliser pour la signature
      Activer le chiffrement des messages Non Option pour chiffrer les messages sortants avec l’algorithme de chiffrement et le certificat sélectionnés
      Algorithme de chiffrement Oui, si le chiffrement est activé Algorithme de chiffrement à utiliser, basé sur le certificat sélectionné
      Certificate Oui, si le chiffrement est activé Certificat à utiliser pour le chiffrement
    2. Sous Points de terminaison, spécifiez les URL requises à utiliser pour envoyer des messages d’action et des accusés de réception.

      Propriété Obligatoire Description
      URL d’action Oui URL à utiliser pour envoyer des messages d’action. L’URL est un champ obligatoire pour les messages synchrones et asynchrones.
      Acknowledgment URL (URL d’accusé de réception) Oui URL à utiliser pour envoyer des messages d’accusé de réception. L’URL est un champ obligatoire pour les messages synchrones.

    La capture d’écran montre la page Paramètres d’envoi, avec des options pour signer et chiffrer des messages et pour entrer des algorithmes, des certificats et des points de terminaison.

  6. Pour configurer votre contrat avec les références de processus PIP RosettaNet pour les partenaires, sélectionnez RosettaNet PIP references (Références de processus PIP RosettaNet). Sous Nom PIP, sélectionnez le nom du processus PIP que vous venez de créer.

    Capture d’écran montrant une table d’informations PIP comprenant une ligne. Cette ligne contient des valeurs par défaut, à l’exception du nom, MyPIPConfig, qui est sélectionné.

    Votre sélection remplit les propriétés restantes, qui sont basées sur le processus PIP que vous avez configuré dans votre compte d’intégration. Si nécessaire, vous pouvez modifier le rôle du PIP.

    La capture d’écran montre un tableau avec des informations PIP. La ligne du PIP nommée MyPIPConfig affiche des informations précises.

Lorsque vous avez terminé ces étapes, vous êtes prêt à envoyer ou recevoir des messages RosettaNet.

Recevoir et décoder des messages RosettaNet

  1. Sur le portail Azure, ouvrez votre workflow d’application logique dans le concepteur.

    Votre workflow doit déjà disposer d’un déclencheur et de toutes les autres actions que vous souhaitez exécuter avant que vous ajoutiez l’action RosettaNet. Cet exemple continue avec le déclencheur Requête.

  2. Sous le déclencheur ou l’action, sélectionnez Nouvelle étape.

    Capture d’écran du concepteur. Sous le déclencheur Requête, Nouvelle étape est sélectionnée.

  3. Sous la zone de recherche Choisir une opération, sélectionnez Toutes. Dans la zone de recherche, entrez rosettanet. Dans la liste des actions, sélectionnez l’action appelée Décoder RosettaNet.

    Capture d’écran du concepteur. La zone de recherche Choisir une opération contient rosettanet et l’action Décoder RosettaNet est sélectionnée.

  4. Entrez les informations pour les propriétés de l’action :

    Capture d’écran de l’action Décoder RosettaNet où des zones sont disponibles pour le message, les en-têtes et le rôle.

    Propriété Obligatoire Description
    Message Oui Message RosettaNet à décoder
    En-têtes Oui En-têtes HTTP fournissant les valeurs de version, à savoir la version RNIF, et de type de réponse, qui indique le type de communication entre les partenaires et peut être synchrone ou asynchrone
    Rôle Oui Rôle du partenaire hôte dans le processus PIP

    La sortie de l’action Décoder RosettaNet inclut le Signal sortant. Vous pouvez encoder cette sortie et la renvoyer au partenaire, ou vous pouvez effectuer toute autre action sur cette sortie.

Envoyer et encoder des messages RosettaNet

  1. Sur le portail Azure, ouvrez votre workflow d’application logique dans le concepteur.

    Votre workflow doit déjà disposer d’un déclencheur et de toutes les autres actions que vous souhaitez exécuter avant que vous ajoutiez l’action RosettaNet. Cet exemple continue avec le déclencheur Requête.

  2. Sous le déclencheur ou l’action, sélectionnez Nouvelle étape.

    Capture d’écran du concepteur. Sous le déclencheur Requête, Nouvelle étape est sélectionnée.

  3. Sous la zone de recherche Choisir une opération, sélectionnez Toutes. Dans la zone de recherche, entrez rosettanet. Dans la liste des actions, sélectionnez l’action appelée Encoder RosettaNet.

    Capture d’écran du concepteur. La zone de recherche Choisir une opération contient rosettanet et l’action Encoder RosettaNet est sélectionnée.

  4. Entrez les informations pour les propriétés de l’action :

    Capture d’écran de l’action Encoder RosettaNet où des zones s’affichent pour le message, les partenaires, les informations PIP, le type de message et le rôle.

    Propriété Obligatoire Description
    Message Oui Message RosettaNet à encoder
    Partenaire hôte Oui Nom du partenaire hôte
    Partenaire invité Oui Nom du partenaire invité
    PIP Code (Code de PIP) Oui Code de processus PIP
    PIP Version (Version de PIP) Oui Version de processus PIP
    PIP instance identity (Identité d’instance PIP) Oui Identificateur unique de ce message de processus PIP
    Type de message Oui Type du message à encoder
    Rôle Oui Rôle du partenaire hôte

    Le message encodé est maintenant prêt à envoyer au partenaire.

  5. Pour envoyer le message encodé, l’exemple suivant utilise l’action HTTP qui est renommée HTTP – Envoyer le message encodé au partenaire.

    Capture d’écran du concepteur avec une action HTTP renommée HTTP – Envoyer le message encodé au partenaire, avec les valeurs URI, en-tête et corps entrées.

    Conformément aux normes RosettaNet, les transactions commerciales sont considérées comme terminées uniquement quand toutes les étapes définies par le processus PIP sont terminées.

  6. Une fois que l’hôte envoie le message encodé à un partenaire, l’hôte attend le signal et l’accusé de réception. Pour effectuer cette tâche, ajoutez l’action nommée Attente de réponse par RosettaNet.

    Capture d’écran d’une action Attente de réponse par RosettaNet avec des zones disponibles pour le corps, l’identité de l’instance PIP, le nombre de nouvelles tentatives et le rôle.

    La durée d’attente et le nombre de tentatives sont basés sur la configuration du processus PIP dans votre compte d’intégration. Si aucune réponse n’est reçue, une notification d’échec est générée. Pour gérer les nouvelles tentatives, placez toujours les actions Encode and Wait for response dans une boucle Until.

    Capture d’écran du concepteur. Une boucle Until contient des actions pour l’encodage et l’envoi de messages, ainsi que pour l’attente de réponses.

Modèles RosettaNet

Pour accélérer le développement et recommander des modèles d’intégration, vous pouvez utiliser des modèles d’application logique Consommation pour encoder et décoder des messages RosettaNet. Quand vous créez un workflow d’application logique Consommation, vous pouvez effectuer la sélection dans la galerie de modèles du concepteur. Vous pouvez également retrouver ces modèles dans le référentiel GitHub pour Azure Logic Apps.

Capture d’écran du concepteur. La catégorie Intégration Entreprise et les modèles pour le décodage et l’encodage des messages RosettaNet sont sélectionnés.

Étapes suivantes