Surveiller et suivre les transactions B2B dans les flux de travail Standard pour Azure Logic Apps (préversion)

S’applique à : Azure Logic Apps (Standard)

Pour vous assurer que les opérations métier s’exécutent correctement, conservez la conformité et résolvez les problèmes dans les scénarios d’intégration d’entreprise B2B, vous devez suivre avec précision et fiabilité les transactions B2B qui transitent par vos solutions d’intégration. Si vous avez des flux de travail d’application logique standard qui fonctionnent avec des transactions X12, EDIFACT ou AS2, vous avez accès à des fonctionnalités de suivi robustes qui vous aident à surveiller efficacement les échanges B2B.

Avec un compte d’intégration de niveau Premium, vous pouvez configurer le suivi B2B pour les flux de travail Standard à l’aide d’Azure Data Explorer. Cette fonctionnalité suit avec précision toutes les transactions B2B en stockant chaque transaction dans un cluster et une base de données Azure Data Explorer, qui fournissent un suivi sans perte, ainsi que des fonctionnalités de visualisation et d’interrogation.

Par exemple, vous obtenez un tableau de bord de suivi pour vous permettre de surveiller, de rechercher et d’analyser efficacement les transactions B2B. Pour une analyse plus détaillée, vous pouvez créer des requêtes avancées dans votre base de données de cluster. Avec le suivi des données stockées dans Azure Data Explorer, vous pouvez étendre des tableaux de bord Microsoft Power BI ou créer des tableaux de bord personnalisés avec vos données.

Ce guide fournit une brève vue d’ensemble du fonctionnement du suivi B2B, la configuration de cette fonctionnalité pour vos flux de travail et ressources d’application logique standard, ainsi que l’ouverture du tableau de bord de suivi.

Limitations et problèmes connus

• Dans cette préversion, le suivi gère actuellement uniquement les transactions X12 et AS2.

Fonctionnement du suivi B2B

Le tableau suivant décrit comment différents composants fonctionnent ensemble pour prendre en charge le suivi B2B :

Prerequisites

• Un compte et un abonnement Azure. Si vous n’avez pas encore d’abonnement, vous pouvez vous inscrire pour obtenir un compte Azure gratuitement.

• Un compte d’intégration de niveau Premium. Si vous n’avez pas ce compte d’intégration, consultez Créer et gérer des comptes d’intégration pour les flux de travail B2B dans Azure Logic Apps.

• Flux de travail standard qui utilise des actions intégrées AS2 ou X12

  Actuellement, le suivi B2B prend uniquement en charge les transactions traitées par ces actions.

• Un cluster et une base de données Azure Data Explorer pour stocker les journaux des transactions et les données de suivi.

  Si vous n’avez pas de cluster et de base de données existant, consultez Démarrage rapide : Créer un cluster et une base de données Azure Data Explorer et qu’est-ce qu’Azure Data Explorer.

Configurer le suivi B2B

Pour cette tâche, vous devez créer un magasin de suivi dans votre compte d’intégration. Un compte d’intégration ne prend actuellement en charge qu’un seul magasin de suivi par défaut.

Créer un magasin de suivi pour votre compte d’intégration

1. Dans le portail Azure, ouvrez votre compte d’intégration de niveau Premium.

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

3. Dans la barre d’outils, sélectionnez Ajouter. Dans le volet Ajouter un magasin de suivi , fournissez les informations suivantes :

   Propriété	Valeur
   Subscription	Abonnement Azure pour votre cluster Azure Data Explorer.
   Explorateur de données Azure	Nom du cluster dans Azure Data Explorer.
   Base de données	Nom de la base de données du cluster.

   Par exemple:

   

4. Quand vous avez terminé, sélectionnez OK.

Désactiver ou activer le suivi B2B au niveau du contrat

Si vous avez des accords existants entre partenaires commerciaux dans votre compte d’intégration, vous pouvez désactiver ou réactiver le suivi pour chaque contrat. Par défaut, le suivi est activé pour les contrats. Actuellement, vous pouvez désactiver ou réactiver le suivi d’un contrat uniquement via la vue JSON.

1. Dans le portail Azure, ouvrez votre compte d’intégration de niveau Premium.

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

3. Dans la barre d’outils contrats , sélectionnez Modifier en tant que JSON.

4. Dans l'accord, trouvez les objets sendAgreement et receiveAgreement.

5. Pour désactiver le suivi, passez trackingState à Disabled. Pour réactiver le suivi, passer trackingState à ou Enabled.

Pour plus d’informations, consultez la documentation suivante :

• Ajouter des contrats entre partenaires dans des comptes d’intégration
• Ajouter des partenaires commerciaux à des comptes d’intégration

Résoudre les problèmes de configuration de suivi

Pour que le suivi fonctionne correctement, vérifiez que toutes les conditions suivantes sont remplies :

• Un magasin de suivi existe dans votre compte d’intégration.
• Dans un accord, l’attribut trackingState est défini sur Enabled.

Ouvrir le tableau de bord de suivi

1. Avant d’utiliser le tableau de bord de suivi, assurez-vous que votre flux de travail exécute des actions intégrées X12, EDIFACT ou AS2 afin que le magasin de suivi contienne des données.

2. Dans le menu de votre compte d’intégration, sous Surveillance, sélectionnez Suivi B2B, qui ouvre le tableau de bord.

   Par défaut, l’onglet Vue d’ensemble est sélectionné et affiche un résumé de haut niveau avec des graphiques pour tous les types de messages pris en charge, les états des messages, les partenaires ayant le plus d’erreurs et un résumé des messages pour chaque partenaire.

   Onglet	Descriptif
   Aperçu	Affichez un résumé de haut niveau pour tous les types de messages pris en charge.
   AS2	Affichez les détails de toutes les transactions AS2 collectées.
   X12	Affichez les détails de toutes les transactions X12 collectées.

   Par exemple:

   

3. Pour modifier l’intervalle de temps du tableau de bord par rapport à la valeur par défaut, dans la liste TimeRange , sélectionnez l’intervalle souhaité.

4. Pour afficher les détails des messages collectés, sélectionnez l’onglet AS2 ou X12 .

   L’onglet sélectionné affiche les messages collectés, ainsi que leurs propriétés et leurs valeurs.

   L’exemple suivant montre les détails disponibles pour les messages X12 collectés :

   

Tables de base de données

Dans votre cluster Azure Data Explorer, la base de données stocke les données de transaction dans un format structuré par table. Cette structure de table vous permet d’interroger et de récupérer efficacement les données de suivi B2B, de fournir des insights structurés sur le flux de messages, l’état du traitement et de résoudre les problèmes.

• La table nommée AS2TrackRecords stocke les transactions AS2.
• La table nommée EdiTrackRecords stocke les transactions X12 et EDIFACT.

Gérer les entrepôts de traçage avec l’API REST

Vous pouvez utiliser l’API REST Azure Logic Apps pour créer, mettre à jour, supprimer et récupérer votre magasin de suivi par programmation.

Créer ou mettre à jour un magasin de suivi

Créez un magasin de suivi ou mettez à jour un magasin existant.

PUT https://management.azure.com/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationAccounts/{integration-account-name}/groups/default/trackingstores/{tracking-store-name}?api-version=2016-06-01

Corps de la demande

{ 
  "properties": {
    "adxClusterUri": "https://{cluster-name}.kusto.windows.net",
    "databaseName": "{database-name}"
  }
}

Réponse

Fournissez les détails de l'entrepôt de suivi créé ou mis à jour.

Obtenir un centre de suivi spécifique

Obtenez les détails d’un magasin de suivi spécifique.

GET https://management.azure.com/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationAccounts/{integration-account-name}/groups/default/trackingstores/{tracking-store-name}?api-version=2016-06-01

Paramètres :

Réponse

Fournissez les détails sur le magasin de suivi spécifié.

Obtenir tous les points de suivi

Accédez à toutes les données de suivi dans votre compte intégré.

GET https://management.azure.com/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationAccounts/{integration-account-name}/groups/default/trackingstores?api-version=2016-06-01

Réponse

Renvoie une liste des centres de suivi associés à votre compte d’intégration.

Supprimer un magasin de suivi

Supprimez un magasin de traçage existant de votre compte d’intégration.

DELETE https://management.azure.com/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationAccounts/{integration-account-name}/groups/default/trackingstores/{tracking-store-name}?api-version=2016-06-01

Réponse

Renvoie une réponse de réussite pour une base de données de suivi supprimée.

Contenu connexe

• Schémas pour le suivi des transactions B2B - Flux de travail standard