Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à : Azure Logic Apps (Consommation + Standard)
Pour envoyer et recevoir des messages RosettaNet dans des flux de travail que vous créez à l’aide d’Azure Logic Apps, utilisez le connecteur RosettaNet . Ce connecteur fournit des actions qui prennent en charge et gèrent la communication qui suit les normes RosettaNet. 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. 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.
Le connecteur RosettaNet fournit les fonctionnalités suivantes :
- Recevoir et décoder des messages RosettaNet.
- Envoyer et encoder des messages RosettaNet.
- Attendre la réponse et la génération d’une notification d’échec.
Ce guide fournit une brève vue d’ensemble de RosettaNet et montre comment ajouter les actions d’encodage et de décodage pour RosettaNet à un flux de travail d’application logique existant. Le connecteur RosettaNet ne fournit aucun déclencheur. Vous pouvez donc utiliser n’importe quel déclencheur pour démarrer votre workflow. Les exemples de ce guide utilisent le Déclencheur de requête.
Comprendre les concepts de RosettaNet
RosettaNet est une organisation qui a établi des processus standard pour partager des informations métier. Cette organisation crée et gère des processus d’interface partenaire (PIP), qui fournissent des définitions de processus métier courantes pour tous les échanges de messages RosettaNet. Pour plus d’informations, visitez le site web RosettaNet.
Le connecteur RosettaNet est basé sur le RosettaNet Implementation Framework (RNIF) version 2.0.01 et prend en charge toutes les PIPs définies 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 entre les partenaires peut être synchrone ou asynchrone.
Le tableau suivant décrit les concepts et les termes de RosettaNet :
| Concept | Description |
|---|---|
| PIP | Un PIP fournit des définitions de processus métier courantes pour tous les échanges de messages RosettaNet. Les PIPs sont classés par fonction métier de haut niveau, ou cluster, et par 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. 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 de recommandations de message est un fichier HTML lisible par l’homme qui spécifie des contraintes au niveau de l’élément. Ensemble, les fichiers PIP et DTD fournissent une définition complète du processus métier. Pour plus d’informations, visitez le site web RosettaNet. |
| Action | Les messages d'action font partie intégrante d'un PIP et sont des messages commerciaux que les partenaires échangent entre eux. |
| Signal | Les messages de signalisation font partie d’un PIP et sont des accusés de réception envoyés en réponse aux messages d’action. |
| Action unique et double action | Pour un PIP avec une seule action, la seule réponse est un 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 a différentes versions, en fonction du type d’application logique et de l’environnement hôte.
| Application logique | Environnement | Version du connecteur |
|---|---|---|
| Consommation | Azure Logic Apps multilocataire | Connecteur managé RosettaNet, qui apparaît dans la galerie de connecteurs sous Partagé. Le connecteur RosettaNet fournit uniquement des actions. Vous pouvez utiliser n’importe quel déclencheur qui fonctionne pour votre scénario. Pour plus d’informations, consultez : - Opérations RosettaNet - Limites du protocole B2B pour les tailles de message |
| Standard | Azure Logic Apps à locataire unique, App Service Environment v3 (plans Windows uniquement) et déploiement hybride | Connecteur intégré RosettaNet, qui apparaît dans la galerie de connecteurs sous Intégré. Le connecteur RosettaNet fournit uniquement des actions. Vous pouvez utiliser n’importe quel déclencheur qui fonctionne pour votre scénario. Le connecteur intégré peut accéder directement aux réseaux virtuels Azure. Vous n’avez pas besoin d’une passerelle de données locale. Pour plus d’informations, consultez : - Opérations RosettaNet - Limites du protocole B2B pour les tailles de message |
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 :
Prérequis
Un compte et un abonnement Azure. Obtenez un compte Azure gratuit.
Ressource et workflow d’application logique dans lesquels vous souhaitez utiliser les opérations RosettaNet.
Le flux de travail nécessite tout déclencheur qui fonctionne le mieux pour votre scénario et toutes les autres actions que vous souhaitez exécuter avant d’ajouter une action RosettaNet.
Pour plus d’informations, consultez :
Une ressource de compte d'intégration pour définir et stocker les artefacts à utiliser dans des workflows d’intégration d’entreprise et B2B.
Votre compte d’intégration et votre ressource d’application logique doivent exister dans le même abonnement Azure et la même région Azure.
Définit au moins deux partenaires commerciaux qui participent à l’opération RosettaNet utilisée dans votre flux de travail. Les deux définitions de partenaire doivent utiliser le même qualificateur d’identité métier , qui est DUNS.
Important
Assurez-vous de sélectionner DUNS, que vous pouvez trouver en bas de la liste des qualificateurs , et non 1 - D-U-N-S (Dun &Bradstreet).
Contient une configuration de processus PIP qui stocke toutes les caractéristiques de configuration PIP. Vous utilisez cette configuration lorsque vous créez un contrat entre partenaires. Si vous n’avez pas de configuration de processus, ajoutez une configuration de processus PIP.
Définit un accord RosettaNet entre les partenaires commerciaux qui participent à l’opération RosettaNet. Un contrat nécessite un partenaire hôte et un partenaire invité. Le contenu des messages entre les partenaires doit correspondre au type de contrat. Consultez Créer un contrat RosettaNet.
Avant de commencer à utiliser les opérations RosettaNet, vous devez lier votre application logique Consommation ou lier votre application logique Standard au compte d’intégration.
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
Si votre compte d’intégration n’a pas de configuration de processus PIP, procédez comme suit pour ajouter une configuration :
Dans le portail Azure, accédez à votre ressource de compte d’intégration.
Dans la barre latérale des ressources, sous Paramètres, sélectionnez PIP RosettaNet. Dans la barre d’outils de la page PIP RosettaNet , sélectionnez Ajouter.
Dans le volet Ajouter un processus d’interface partenaire , entrez les informations PIP suivantes :
Paramètre Obligatoire Description Nom Oui Nom du PIP. Code PIP Oui Code PIP à trois caractères. Pour plus d’informations, consultez les processus PIP RosettaNet. Version du PIP Oui Version PIP, qui dépend du code PIP sélectionné. Pour plus d’informations, visitez le site web RosettaNet.
L’exemple suivant montre des exemples d’informations pour une configuration de processus PIP :
Quand vous avez terminé, sélectionnez OK pour créer la configuration PIP.
Pour afficher ou modifier la configuration du processus, sélectionnez le PIP. Dans la barre d’outils de la page PIP RosettaNet , sélectionnez Modifier en tant que JSON.
Tous les paramètres de configuration du processus proviennent les spécifications du processus PIP. Par défaut, Azure Logic Apps remplit la plupart des paramètres avec des valeurs par défaut basées sur les valeurs les plus utilisées.
Vérifiez que les valeurs des paramètres correspondent aux valeurs de la spécification PIP appropriée et répondent aux besoins de votre entreprise. Si nécessaire, mettez à jour les valeurs dans l’éditeur JSON et enregistrez les modifications.
Quand vous avez terminé, sélectionnez OK.
Créer un contrat RosettaNet
Si votre compte d’intégration n’a pas de contrat RosettaNet, procédez comme suit pour créer le contrat :
Dans le portail Azure, accédez à votre ressource de compte d’intégration.
Dans la barre latérale des ressources, sous Paramètres, sélectionnez Contrats. Dans la barre d’outils de la page Contrats , sélectionnez Ajouter.
Dans le volet Ajouter , entrez les informations de contrat suivantes :
Paramètre Obligatoire Description Nom Oui Le nom du contrat. Type de contrat Oui Type de protocole pour le contrat. Sélectionnez RosettaNet. Partenaire hôte Oui Nom du partenaire hôte, qui représente votre organisation. 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 Nom du partenaire invité, qui fait affaire 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 du partenaire invité. Paramètres d’envoi Variable Propriétés qui s’appliquent à tous les messages envoyés par le partenaire hôte au partenaire invité. 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. L’exemple suivant montre des exemples d’informations pour un contrat RosettaNet :
Pour spécifier la façon dont le partenaire hôte reçoit des messages du partenaire invité, dans le volet Ajouter , sélectionnez Paramètres de réception.
Le volet Paramètres de réception affiche les paramètres suivants :
Réglage Obligatoire Description Le message doit être signé Non Signer des messages entrants avec le certificat sélectionné. Certificat Oui, si la signature est activée Certificat à utiliser pour la signature. Activer le chiffrement des messages Non Chiffrer les messages entrants avec le certificat sélectionné. Certificat Oui, si le chiffrement est activé Certificat à utiliser pour le chiffrement. Pour activer la signature, le chiffrement ou les deux pour les messages entrants, sous Message, sélectionnez Message doit être signé, Message doit être chiffré ou les deux.
Sous chaque paramètre sélectionné, dans la liste des certificats , sélectionnez le certificat de votre compte d’intégration à utiliser pour la signature, le chiffrement ou les deux.
L’exemple suivant montre les paramètres de signature et de chiffrement dans le volet Paramètres de réception :
Quand vous avez terminé, sélectionnez OK.
Pour spécifier la façon dont le partenaire hôte envoie des messages au partenaire invité, dans le volet Ajouter , sélectionnez Paramètres d’envoi.
Le volet Paramètres d’envoi affiche les paramètres suivants :
Réglage Obligatoire Description Activer la signature des messages Non Signer des 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, en fonction du certificat sélectionné. Certificat Oui, si la signature est activée Certificat à utiliser pour la signature. Activer le chiffrement des messages Non 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, en fonction du certificat sélectionné. Certificat Oui, si le chiffrement est activé Certificat à utiliser pour le chiffrement. Pour activer la signature, le chiffrement ou les deux pour les messages sortants, sous Messages, sélectionnez Activer la signature de message, Activer le chiffrement des messages ou les deux.
Sous chaque paramètre sélectionné, dans la liste des algorithmes, sélectionnez l’algorithme à utiliser. Dans la liste des certificats , sélectionnez le certificat de votre compte d’intégration à utiliser pour la signature, le chiffrement ou les deux.
Dans la section Points de terminaison , spécifiez les URL requises pour l’envoi de messages d’action et d’accusés de réception :
Paramètre Obligatoire Description URL de l’action Oui URL à utiliser pour envoyer des messages d’action. Cette URL est requise pour les messages synchrones et asynchrones. URL de l’accusé de réception Oui URL à utiliser pour envoyer des messages d’accusé de réception. Cette URL est requise pour les messages asynchrones. L’exemple suivant montre les paramètres d’URL de signature, de chiffrement et de point de terminaison dans le volet Paramètres d’envoi avec quelques exemples de valeurs :
Quand vous avez terminé, sélectionnez OK.
Pour spécifier les références PIP RosettaNet pour le contrat, dans le volet Ajouter , sélectionnez références PIP RosettaNet.
La page références PIP RosettaNet affiche la configuration du processus PIP que vous avez créée et ajoutée précédemment.
Dans la colonne Nom pip , ouvrez la liste, puis sélectionnez le PIP.
Votre sélection remplit les propriétés restantes, qui sont basées sur le processus PIP de votre compte d’intégration.
Si nécessaire, vous pouvez modifier le rôle du PIP.
Passez à la section suivante pour recevoir des messages RosettaNet.
Recevoir et décoder des messages RosettaNet
Dans le portail Azure, ouvrez votre ressource d’application logique. Ouvrez votre workflow dans le concepteur.
Le flux de travail doit déjà avoir un déclencheur et toutes les autres actions que vous souhaitez exécuter avant d’ajouter l’action RosettaNet.
Suivez ces étapes générales pour ajouter l’action de décodage RosettaNet à votre flux de travail.
Dans le volet d’informations d’action, fournissez les valeurs suivantes :
Paramètre Obligatoire Description Message Oui Message RosettaNet à décoder. En-têtes Oui En-têtes HTTP qui fournissent les valeurs pour la version et le type de réponse en tant que paires clé-valeur. La version est RNIF. Le type de réponse décrit le type de communication du partenaire et peut être synchrone ou asynchrone.Rôle Oui Rôle partenaire hôte dans le PIP. 
La sortie de l’action de décodage RosettaNet inclut une valeur de signal sortant . Vous pouvez encoder et renvoyer cette sortie au partenaire invité, ou effectuer une action différente sur cette sortie.
Envoyer et encoder des messages RosettaNet
Dans le portail Azure, ouvrez votre ressource d’application logique. Ouvrez votre workflow dans le concepteur.
Le flux de travail doit déjà avoir un déclencheur et toutes les autres actions que vous souhaitez exécuter avant d’ajouter l’action RosettaNet.
Suivez ces étapes générales pour ajouter l’action d’encodage RosettaNet à votre workflow.
Dans le volet d’informations d’action, fournissez les valeurs suivantes :
Paramètre Obligatoire Description Identité d’instance du processus RosettaNet (PIP) Oui ID d’instance du message à encoder. Partenaire hôte Oui Nom du partenaire hôte. Partenaire invité Oui Nom du partenaire invité. Code PIP Oui Code PIP. Version PIP Oui Version PIP. Identité d’instance PIP Oui Identificateur unique de ce message PIP. Type de message Oui Type du message à encoder. Rôle Oui Rôle partenaire hôte. 
Cette action est maintenant configurée pour encoder et envoyer le message RosettaNet au partenaire invité.
Pour envoyer le message RosettaNet encodé, suivez ces étapes générales pour ajouter l’action appropriée pour votre scénario. Fournissez les valeurs que l'action nécessite pour envoyer le message.
Cet exemple utilise l’action HTTP , qui est renommée HTTP - Envoyer un message encodé au partenaire. Les valeurs sont des sorties de l’action d’encodage RosettaNet et sont ajoutées via la liste de contenu dynamique.
Selon les normes RosettaNet, les transactions commerciales ne sont effectuées qu’une fois toutes les étapes définies par le PIP terminées. Une fois que le partenaire hôte a envoyé le message encodé au partenaire invité, l’hôte attend le signal et l’accusé de réception.
Dans votre flux de travail, ajoutez l’action RosettaNet qui attend une réponse. Dans le volet d’informations d’action, fournissez les valeurs suivantes :
Paramètre Obligatoire Description Corps Oui Message encodé d’origine. Identité d’instance PIP Oui ID d’instance du message encodé. Nombre de nouvelles tentatives. Oui Nombre de tentatives pour encoder et envoyer le message. Rôle Oui Rôle partenaire hôte. La durée d’attente de l’action RosettaNet et le nombre de nouvelles tentatives sont basés sur la configuration PIP.
Si l’action RosettaNet ne reçoit pas de réponse, l’action génère une notification d’échec.
Pour gérer les tentatives de nouvelle tentative, placez toujours les actions RosettaNet pour envoyer le message encodé et attendez une réponse à l’intérieur d’une boucle Until , par exemple :
