Échanger des messages dans le cloud en utilisant Azure Logic Apps avec Azure Service BusExchange messages in the cloud by using Azure Logic Apps with Azure Service Bus

Avec Azure Logic Apps et le connecteur Azure Service Bus, vous pouvez créer des tâches et des workflows automatisés pour transférer des données, comme des documents de vente, des bons de commande, des journaux ou des mouvements de stock, entre des applications de votre organisation.With Azure Logic Apps and the Azure Service Bus connector, you can create automated tasks and workflows that transfer data, such as sales and purchase orders, journals, and inventory movements across applications for your organization. Non seulement le connecteur surveille, envoie et gère les messages, mais il effectue également des actions relatives aux files d’attente, sessions, rubriques, abonnements, etc. Par exemple :The connector not only monitors, sends, and manages messages, but also performs actions with queues, sessions, topics, subscriptions, and so on, for example:

  • Surveillance de la réception des messages (semi-automatique ou passage furtif) dans les files d’attente, les rubriques et les abonnements aux rubriquesMonitor when messages arrive (auto-complete) or are received (peek-lock) in queues, topics, and topic subscriptions.
  • Envoi de messagesSend messages.
  • Création et suppression des abonnements de rubriqueCreate and delete topic subscriptions.
  • Gestion des messages dans les files d’attente et les abonnements aux rubriques, par exemple : obtention, obtention différée, exécution, report, abandon et lettre morteManage messages in queues and topic subscriptions, for example, get, get deferred, complete, defer, abandon, and dead-letter.
  • Renouvellement des verrous sur les messages et les sessions dans les files d’attente et les abonnements aux rubriquesRenew locks on messages and sessions in queues and topic subscriptions.
  • Clôture des sessions dans les rubriques et les files d’attenteClose sessions in queues and topics.

Vous pouvez utiliser des déclencheurs afin d’obtenir des réponses de Service Bus et mettre la sortie à la disposition d’autres actions dans vos applications logiques.You can use triggers that get responses from Service Bus and make the output available to other actions in your logic apps. Vous pouvez également faire en sorte que d’autres actions utilisent la sortie d’actions Service Bus.You can also have other actions use the output from Service Bus actions. Si vous ne connaissez pas Service Bus et Logic Apps, consultez Qu’est-ce qu’Azure Service Bus ? et Qu’est-ce qu’Azure Logic Apps ?If you're new to Service Bus and Logic Apps, review What is Azure Service Bus? and What is Azure Logic Apps?

Important

Soyez prudent lorsque vous sélectionnez un déclencheur et une action qui ont le même type de connecteur et que vous les utilisez pour travailler avec la même entité, telle qu’une file d’attente de messagerie ou un abonnement à une rubrique.Use caution when you select both a trigger and action that have the same connector type and use them to work with the same entity, such as a messaging queue or topic subscription. Cette combinaison peut créer une boucle infinie, ce qui aboutit à une application logique dont l’exécution ne se termine jamais.This combination can create an infinite loop, which results in a logic app that never ends.

PrérequisPrerequisites

Vérifier les autorisationsCheck permissions

Vérifiez que votre application logique dispose des autorisations pour accéder à l’espace de noms Service Bus.Confirm that your logic app has permissions for accessing your Service Bus namespace.

  1. Connectez-vous au Portail Azure.Sign in to the Azure portal.

  2. Accédez à votre espace de noms Service Bus.Go to your Service Bus namespace. Dans la page de l’espace de noms, sous Paramètres, sélectionnez Stratégies d’accès partagé.On the namespace page, under Settings, select Shared access policies. Sous Revendications, vérifiez que vous disposez des autorisations Gérer pour cet espace de noms.Under Claims, check that you have Manage permissions for that namespace.

    Gérer les autorisations pour l’espace de noms Service Bus

  3. Récupérez la chaîne de connexion pour votre espace de noms Service Bus.Get the connection string for your Service Bus namespace. Vous avez besoin de cette chaîne au moment où vous fournissez les informations de connexion dans votre application logique.You need this string when you provide the connection information in your logic app.

    1. Dans le volet Stratégies d’accès partagé, sélectionnez RootManageSharedAccessKey.On the Shared access policies pane, select RootManageSharedAccessKey.

    2. En regard de votre chaîne de connexion principale, sélectionnez le bouton de copie.Next to your primary connection string, select the copy button. Enregistrez la chaîne de connexion en vue d’une utilisation ultérieure.Save the connection string for later use.

      Copier la chaîne de connexion de l’espace de noms Service Bus

    Conseil

    Pour vous assurer que votre chaîne de connexion est bien associée à votre espace de noms Service Bus ou à une entité de messagerie (une file d’attente par exemple), recherchez la chaîne de connexion pour le paramètre EntityPath .To confirm whether your connection string is associated with your Service Bus namespace or a messaging entity, such as a queue, search the connection string for the EntityPath parameter. Si vous trouvez ce paramètre, la chaîne de connexion correspond à une entité spécifique. De fait, il ne s’agit pas de la chaîne appropriée à utiliser avec votre application logique.If you find this parameter, the connection string is for a specific entity, and isn't the correct string to use with your logic app.

Ajouter un déclencheur Service BusAdd Service Bus trigger

Quand vous utilisez un déclencheur ou une action qui accède à un service pour la première fois, le concepteur Logic Apps vous invite à créer une connexion avec ce service.When you use a trigger or action that accesses a service for the first time, the Logic Apps Designer prompts you to create a connection to that service. Vous pouvez ensuite fournir les informations de connexion nécessaires directement à partir de votre application logique, à l’intérieur du concepteur.You can then provide the necessary connection information directly from your logic app inside the designer.

  1. Connectez-vous au portail Azure et ouvrez votre application logique vide dans le concepteur d’application logique.Sign in to the Azure portal, and open your blank logic app in the Logic App Designer.

  2. Dans la zone de recherche, entrez « azure service bus » en guise de filtre.In the search box, enter "azure service bus" as your filter. Dans la liste des déclencheurs, sélectionnez celui qui vous intéresse.From the triggers list, select the trigger that you want.

    Par exemple, pour déclencher votre application logique quand un nouvel élément est envoyé à une file d’attente Service Bus, sélectionnez le déclencheur Quand une file d’attente reçoit un message (saisie semi-automatique) .For example, to trigger your logic app when a new item gets sent to a Service Bus queue, select the When a message is received in a queue (auto-complete) trigger.

    Sélectionner un déclencheur Service Bus

    Tous les déclencheurs Service Bus sont des déclencheurs à interrogation longue.All Service Bus triggers are long-polling triggers. Cette description signifie que lorsqu’un déclencheur est activé, celui-ci traite tous les messages et attend 30 secondes le temps qu’un plus grand nombre de messages apparaissent dans la file d’attente ou l’abonnement à la rubrique.This description means that when the trigger fires, the trigger processes all the messages and then waits 30 seconds for more messages to appear in the queue or topic subscription. Si aucun message n’apparaît au bout de 30 secondes, l’exécution du déclencheur est ignorée.If no messages appear in 30 seconds, the trigger run is skipped. Dans le cas contraire, le déclencheur poursuit la lecture des messages jusqu’à ce que la rubrique d’abonnement ou la file d’attente soit vide.Otherwise, the trigger continues reading messages until the queue or topic subscription is empty. La prochaine interrogation de déclencheur est basée sur l’intervalle de récurrence spécifié dans les propriétés du déclencheur.The next trigger poll is based on the recurrence interval specified in the trigger's properties.

    Certains déclencheurs peuvent retourner un ou plusieurs messages. Tel est le cas du déclencheur Quand une file d’attente reçoit un ou des messages (saisie semi-auto) .Some triggers, such as the When one or more messages arrive in a queue (auto-complete) trigger, can return one or messages. Quand ces déclencheurs sont activés, ils retournent entre un et le nombre de messages spécifié par la propriété Nombre maximal de messages du déclencheur.When these triggers fire, they return between one and the number of messages that's specified by the trigger's Maximum message count property.

  3. Si votre déclencheur se connecte à votre espace de noms Service Bus pour la première fois, suivez ces étapes quand le concepteur d’application logique vous invite à fournir vos informations de connexion.If your trigger is connecting to your Service Bus namespace for the first time, follow these steps when the Logic App Designer prompts you for connection information.

    1. Fournissez un nom pour votre connexion, puis sélectionnez votre espace de noms Service Bus.Provide a name for your connection, and select your Service Bus namespace.

      Créer une connexion Service Bus, partie 1

      Pour entrer manuellement la chaîne de connexion, sélectionnez Entrer manuellement les informations de connexion.To manually enter the connection string instead, select Manually enter connection information. Si vous ne disposez pas de chaîne de connexion, découvrez comment obtenir votre chaîne de connexion.If you don't have your connection string, learn how to find your connection string.

    2. Sélectionnez votre stratégie Service Bus, puis Créer.Select your Service Bus policy, and select Create.

      Créer une connexion Service Bus, partie 2

    3. Sélectionnez l’entité de messagerie souhaitée, comme une file d’attente ou une rubrique.Select the messaging entity you want, such as a queue or topic. Pour cet exemple, sélectionnez votre file d’attente Service Bus.For this example, select your Service Bus queue.

      Sélectionner la file d’attente Service Bus.

  4. Fournissez les informations nécessaires pour le déclencheur sélectionné.Provide the necessary information for your selected trigger. Pour ajouter d’autres propriétés disponibles à l’action, ouvrez la liste Ajouter un nouveau paramètre, puis sélectionnez les propriétés souhaitées.To add other available properties to the action, open the Add new parameter list, and select the properties that you want.

    Pour le déclencheur de cet exemple, sélectionnez l’intervalle d’interrogation et la fréquence de vérification de la file d’attente.For this example's trigger, select the polling interval and frequency for checking the queue.

    Définir l’intervalle d'interrogation

    Pour plus d’informations sur les déclencheurs et les propriétés disponibles, consultez la page d’informations de référence du connecteur.For more information about available triggers and properties, see the connector's reference page.

  5. Poursuivez la création de votre application logique en ajoutant les actions de votre choix.Continue building your logic app by adding the actions that you want.

    Par exemple, vous pouvez ajouter une action qui envoie un e-mail lorsqu’un nouveau message arrive.For example, you can add an action that sends email when a new message arrives. Lorsque votre déclencheur vérifie la file d’attente et trouve un nouveau message, l’application logique exécute les actions que vous avez sélectionnées pour le message trouvé.When your trigger checks your queue and finds a new message, your logic app runs your selected actions for the found message.

Ajouter une action Service BusAdd Service Bus action

Quand vous utilisez un déclencheur ou une action qui accède à un service pour la première fois, le concepteur Logic Apps vous invite à créer une connexion avec ce service.When you use a trigger or action that accesses a service for the first time, the Logic Apps Designer prompts you to create a connection to that service. Vous pouvez ensuite fournir les informations de connexion nécessaires directement à partir de votre application logique, à l’intérieur du concepteur.You can then provide the necessary connection information directly from your logic app inside the designer.

  1. Connectez-vous au portail Azure, puis ouvrez votre application logique dans le concepteur d’application logique.Sign in to the Azure portal, and open your logic app in the Logic App Designer.

  2. En dessous l’étape où vous voulez ajouter une action, sélectionnez Nouvelle étape.Under the step where you want to add an action, select New step.

    Ou bien, pour ajouter une action entre deux étapes, placez votre pointeur sur la flèche qui les sépare.Or, to add an action between steps, move your pointer over the arrow between those steps. Sélectionnez le signe plus ( + ) qui s’affiche, puis sélectionnez Ajouter une action.Select the plus sign (+) that appears, and select Add an action.

  3. Sous Choisir une action, dans la zone de recherche, entrez « azure service bus » en guise de filtre.Under Choose an action, in the search box, enter "azure service bus" as your filter. Dans la liste des actions, sélectionnez l’action qui vous intéresse.From the actions list, select the action that you want.

    Pour cet exemple, sélectionnez l’action Envoyer un message.For this example, select the Send message action.

    Sélectionner une action Service Bus

  4. Si votre action se connecte à votre espace de noms Service Bus pour la première fois, suivez ces étapes quand le concepteur d’application logique vous invite à fournir vos informations de connexion.If your action is connecting to your Service Bus namespace for the first time, follow these steps when the Logic App Designer prompts you for connection information.

    1. Fournissez un nom pour votre connexion, puis sélectionnez votre espace de noms Service Bus.Provide a name for your connection, and select your Service Bus namespace.

      Créer une connexion Service Bus, partie 1

      Pour entrer manuellement la chaîne de connexion, sélectionnez Entrer manuellement les informations de connexion.To manually enter the connection string instead, select Manually enter connection information. Si vous ne disposez pas de chaîne de connexion, découvrez comment obtenir votre chaîne de connexion.If you don't have your connection string, learn how to find your connection string.

    2. Sélectionnez votre stratégie Service Bus, puis Créer.Select your Service Bus policy, and select Create.

      Créer une connexion Service Bus, partie 2

    3. Sélectionnez l’entité de messagerie souhaitée, comme une file d’attente ou une rubrique.Select the messaging entity you want, such as a queue or topic. Pour cet exemple, sélectionnez votre file d’attente Service Bus.For this example, select your Service Bus queue.

      Sélectionner la file d’attente Service Bus.

  5. Fournissez les informations nécessaires pour l’action sélectionnée.Provide the necessary details for your selected action. Pour ajouter d’autres propriétés disponibles à l’action, ouvrez la liste Ajouter un nouveau paramètre, puis sélectionnez les propriétés souhaitées.To add other available properties to the action, open the Add new parameter list, and select the properties that you want.

    Par exemple, sélectionnez les propriétés Contenu et Type de contenu pour pouvoir les ajouter à l’action.For example, select the Content and Content Type properties so that you add them to the action. Ensuite, spécifiez le contenu du message que vous voulez envoyer.Then, specify the content for the message that you want to send.

    Fournir les détails et le contenu du message

    Pour plus d’informations sur les actions disponibles et leurs propriétés, consultez la page d’informations de référence du connecteur.For more information about available actions and their properties, see the connector's reference page.

  6. Poursuivez la création de votre application logique en ajoutant éventuellement d’autres actions.Continue building your logic app by adding any other actions that you want.

    Par exemple, vous pouvez ajouter une action qui envoie un e-mail confirmant que votre message a bien été envoyé.For example, you can add an action that sends email to confirm that your message was sent.

  7. Enregistrez votre application logique.Save your logic app. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.On the designer toolbar, select Save.

Référence de connecteurConnector reference

Le connecteur Service Bus peut enregistrer jusqu’à 1 500 sessions uniques à la fois entre un bus de service et le cache du connecteur.The Service Bus connector can save up to 1,500 unique sessions at a time from a service bus to the connector cache. Si le nombre de sessions dépasse cette limite, les anciennes sessions sont supprimées du cache.If the session count exceeds this limit, old sessions are removed from the cache. Pour obtenir d’autres détails techniques sur les déclencheurs, les actions et les limites, qui sont décrits par la description OpenAPI du connecteur (anciennement Swagger), consultez la page de référence du connecteur.For other technical details about triggers, actions, and limits, which are described by the connector's OpenAPI (formerly Swagger) description, review the connector's reference page.

Étapes suivantesNext steps