Se connecter à un serveur IBM MQ depuis Azure Logic AppsConnect to an IBM MQ server from Azure Logic Apps

Le connecteur IBM MQ envoie et récupère les messages stockés dans un serveur IBM MQ local ou dans Azure.The IBM MQ connector sends and retrieves messages stored in an IBM MQ server on premises or in Azure. Ce connecteur inclut un client Microsoft MQ qui communique avec un serveur IBM MQ distant sur un réseau TCP/IP.This connector includes a Microsoft MQ client that communicates with a remote IBM MQ server across a TCP/IP network. Cet article offre un guide de démarrage pour l’utilisation du connecteur MQ.This article provides a starter guide to use the MQ connector. Vous pouvez commencer par parcourir un message dans une file d’attente, avant de tenter les autres actions.You can start by browsing a single message on a queue and then try other actions.

Le connecteur IBM MQ inclut ces actions, mais ne fournit aucun déclencheur :The IBM MQ connector includes these actions but provides no triggers:

  • Parcourir un seul message sans le supprimer du serveur IBM MQBrowse a single message without deleting the message from the IBM MQ server
  • Parcourir un lot de messages sans supprimer ceux-ci du serveur IBM MQBrowse a batch of messages without deleting the messages from the IBM MQ server
  • Recevoir un message unique et supprimer le message à partir du serveur IBM MQReceive a single message and delete the message from the IBM MQ server
  • Recevoir un lot de messages et supprimer les messages du serveur IBM MQReceive a batch of messages and delete the messages from the IBM MQ server
  • Envoyer un message unique au serveur IBM MQSend a single message to the IBM MQ server

PrérequisPrerequisites

  • Si vous utilisez un serveur MQ local, installez la passerelle de données locale sur un serveur au sein de votre réseau.If you're using an on-premises MQ server, install the on-premises data gateway on a server within your network. Pour que le connecteur MQ fonctionne, .NET Framework 4.6 doit également être installé sur le serveur sur lequel la passerelle de données locale est installée.The server where the on-premises data gateway is installed must also have .NET Framework 4.6 installed for the MQ connector to work. Vous devez également créer une ressource dans Azure pour la passerelle de données locale.You must also create a resource in Azure for the on-premises data gateway. Pour plus d’informations, consultez Configurer la connexion à la passerelle de données.For more information, see Set up the data gateway connection.

    Toutefois, si votre serveur MQ est disponible publiquement ou dans Azure, vous n’avez pas à utiliser la passerelle de données.However, if your MQ server is publicly available or available within Azure, you don't have to use the data gateway.

  • Versions d’IBM WebSphere MQ Officiellement prises en charge :Officially supported IBM WebSphere MQ versions:

    • MQ 7.5MQ 7.5
    • MQ 8.0MQ 8.0
    • MQ 9.0MQ 9.0
  • L’application logique dans laquelle vous souhaitez ajouter l’action MQ.The logic app where you want to add the MQ action. Cette application logique doit utiliser le même emplacement que la connexion de votre passerelle de données locale et vous devez avoir un déclencheur qui démarre votre workflow.This logic app must use the same location as your on-premises data gateway connection and must already have a trigger that starts your workflow.

    Le connecteur MQ ne possède aucun déclencheur. Vous devez donc d’abord en ajouter un à votre application logique.The MQ connector doesn't have any triggers, so you must add a trigger to your logic app first. Par exemple, vous pouvez utiliser le déclencheur Recurrence.For example, you can use the Recurrence trigger. Si vous débutez avec les applications logiques, essayez ce Démarrage rapide pour créer votre première application logique.If you're new to logic apps, try this quickstart to create your first logic app.

Parcourir un seul messageBrowse a single message

  1. Dans votre application logique, sous le déclencheur ou une autre action, choisissez Nouvelle étape.In your logic app, under the trigger or another action, choose New step.

  2. Dans la zone de recherche, entrez « mq », puis sélectionnez cette action : Parcourir un messageIn the search box, type "mq", and select this action: Browse message

    Parcourir un message

  3. À défaut de connexion MQ existante, créez la connexion :If you don't have an existing MQ connection, create the connection:

    1. Dans l’action, sélectionnez l’option Se connecter via la passerelle de données locale.In the action, select Connect via on-premises data gateway.

    2. Renseignez les propriétés de votre serveur MQ.Enter the properties for your MQ server.

      Pour Serveur, vous pouvez entrer le nom du serveur MQ, ou l’adresse IP suivie par un signe deux-points et le numéro de port.For Server, you can enter the MQ server name, or enter the IP address followed by a colon and the port number.

    3. Ouvrez la liste des passerelles, ce qui affiche toutes les connexions de passerelle précédemment configurées.Open the gateway list, which shows any previously configured gateway connections. Sélectionnez votre passerelle.Select your gateway.

    4. Lorsque vous êtes prêt, choisissez Créer.When you're done, choose Create.

      Votre condition ressemble à cet exemple :Your connection looks like this example:

      Propriétés de connexion

  4. Configurez les propriétés de l’action :Set up the action's properties:

    • Queue (File d’attente) : Spécifiez une file d’attente différente de la connexion.Queue: Specify a queue that's different from the connection.

    • MessageId, CorrelationId, GroupIdet d’autres propriétés : Recherchez un message basé sur les différentes propriétés de message MQMessageId, CorrelationId, GroupId, and other properties: Browse for a message based on the different MQ message properties

    • IncludeInfo : Définissez la propriété sur True pour inclure des informations supplémentaires dans la sortie.IncludeInfo: Specify True to include additional message information in the output. Ou bien définissez la propriété sur False pour ne pas inclure des informations supplémentaires dans la sortie.Or, specify False to not include additional message information in the output.

    • Timeout (Expiration du délai) : Entrer une valeur pour déterminer la durée d’attente de l’arrivée d’un message dans une file d’attente vide.Timeout: Enter a value to determine how long to wait for a message to arrive in an empty queue. Si aucune valeur n’est entrée, le premier message dans la file d’attente est récupéré et aucun temps n’est consacré à l’attente de l’affichage d’un message.If nothing is entered, the first message in the queue is retrieved, and there is no time spent waiting for a message to appear.

      Parcourir les propriétés d’un message

  5. Enregistrez vos modifications, puis exécutez votre application logique.Save your changes, and then Run your logic app.

    Enregistrer et exécuter

    Une fois l’exécution terminée, les étapes de l’exécution sont affichées et vous pouvez consulter la sortie.After the run finishes, the steps from the run are shown, and you can review the output.

  6. Pour passer en revue les détails de chaque étape, choisissez la coche verte.To review the details for each step, choose the green checkmark. Pour consulter plus d’informations sur les données de sortie, choisissez Afficher les sorties brutes.To review more information about the output data, choose Show raw outputs.

    Parcourir une sortie de message

    Voici un exemple de sortie brute :Here is some sample raw output:

    Parcourir une sortie brute de message

  7. Si vous définissez l’option IncludeInfo sur true, la sortie suivante s’affiche :If you set IncludeInfo to true, the following output is displayed:

    Parcourir les informations include d’un message

Parcourir plusieurs messagesBrowse multiple messages

L’action Parcourir des messages inclut une option BatchSize permettant d’indiquer le nombre de messages à retourner à partir de la file d’attente.The Browse messages action includes a BatchSize option to indicate how many messages should be returned from the queue. Si l’option BatchSize ne comporte aucune entrée, tous les messages sont retournés.If BatchSize has no entry, all messages are returned. La sortie retournée est un tableau de messages.The returned output is an array of messages.

  1. Lorsque vous ajoutez l’action Parcourir les messages, la première connexion précédemment configurée est sélectionnée par défaut.When you add the Browse messages action, the first previously configured connection is selected by default. Pour créer une nouvelle connexion, choisissez Modifier la connexion.To create a new connection, choose Change connection. Ou sélectionnez une autre connexion.Or, select a different connection.

  2. Lorsque l’exécution de l’application logique se termine, voici un exemple de sortie de l’action Parcourir les messages :After the logic app run finishes, here is some sample output from the Browse messages action:

    Parcourir la sortie des messages

Recevoir un seul messageReceive single message

L’action Recevoir un message a les mêmes entrées et sorties que l’action Parcourir un message.The Receive message action has the same inputs and outputs as the Browse message action. Lorsque vous utilisez l’action Recevoir un message, le message est supprimé de la file d’attente.When using Receive message, the message is deleted from the queue.

Recevoir plusieurs messagesReceive multiple messages

L’action Recevoir des messages a les mêmes entrées et sorties que l’action Parcourir des messages.The Receive messages action has the same inputs and outputs as the Browse messages action. Lorsque vous utilisez l’action Recevoir des messages, les messages sont supprimés de la file d’attente.When using Receive messages, the messages are deleted from the queue.

S’il n’existe aucun message dans la file d’attente lorsque vous effectuez une opération de recherche ou de réception, l’opération échoue en affichant cette sortie :If there are no messages in the queue when doing a browse or a receive, the step fails with this output:

Erreur MQ Aucun message

Envoyer un messageSend message

Lorsque vous ajoutez l’action Envoyer des messages, la première connexion précédemment configurée est sélectionnée par défaut.When you add the Send messages action, the first previously configured connection is selected by default. Pour créer une nouvelle connexion, choisissez Modifier la connexion.To create a new connection, choose Change connection. Ou sélectionnez une autre connexion.Or, select a different connection.

  1. Sélectionnez un type de message valide : Datagramme, Réponse, ou DemandeSelect a valid message type: Datagram, Reply, or Request

    Propriétés d’envoi des messages

  2. Lorsque l’exécution de l’application logique se termine, voici un exemple de sortie de l’action Envoyer des messages :After the logic app finishes running, here is some sample output from the Send message action:

    Sortie Envoyer un message

Référence de connecteurConnector reference

Pour obtenir des détails techniques sur 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 technical details about actions and limits, which are described by the connector's OpenAPI (formerly Swagger) description, review the connector's reference page.

Étapes suivantesNext steps