Anslut till en IBM MQ-Server från Azure Logic AppsConnect to an IBM MQ server from Azure Logic Apps

MQ-anslutningen skickar och hämtar meddelanden som lagras i en MQ-server lokalt eller i Azure.The MQ connector sends and retrieves messages stored in an MQ server on premises or in Azure. Den här anslutningen innehåller en Microsoft MQ-klient som kommunicerar med en IBM MQ-server i ett TCP/IP-nätverk.This connector includes a Microsoft MQ client that communicates with a remote IBM MQ server across a TCP/IP network. Den här artikeln innehåller en start guide för att använda MQ-anslutaren.This article provides a starter guide to use the MQ connector. Du kan börja med att bläddra i ett enskilt meddelande i en kö och sedan försöka med andra åtgärder.You can start by browsing a single message on a queue and then try other actions.

MQ-kopplingen innehåller följande åtgärder, men ger inga utlösare:The MQ connector includes these actions but provides no triggers:

  • Bläddra i ett enskilt meddelande utan att ta bort meddelandet från MQ-servern.Browse a single message without deleting the message from the MQ server.
  • Bläddra i en batch med meddelanden utan att ta bort meddelandena från MQ-servern.Browse a batch of messages without deleting the messages from the MQ server.
  • Ta emot ett enda meddelande och ta bort meddelandet från MQ-servern.Receive a single message and delete the message from the MQ server.
  • Ta emot en batch med meddelanden och ta bort meddelandena från MQ-servern.Receive a batch of messages and delete the messages from the MQ server.
  • Skicka ett enskilt meddelande till MQ-servern.Send a single message to the MQ server.

Här är de officiellt IBM WebSphere MQ-versioner som stöds:Here are the officially supported IBM WebSphere MQ versions:

  • MQ 7,5MQ 7.5
  • MQ 8,0MQ 8.0
  • MQ 9,0MQ 9.0
  • MQ 9,1MQ 9.1

FörutsättningarPrerequisites

  • Om du använder en lokal MQ-Server måste du installera den lokala datagatewayen på en server i nätverket.If you use an on-premises MQ server, you need to install the on-premises data gateway on a server within your network.

    Anteckning

    Om din MQ-Server är offentligt tillgänglig eller tillgänglig i Azure behöver du inte använda data gatewayen.If your MQ server is publicly available or available within Azure, you don't have to use the data gateway.

    • För att MQ-kopplingen ska fungera måste den server där du installerar den lokala datagatewayen också ha .NET Framework 4,6 installerat.For the MQ connector to work, the server where you install the on-premises data gateway also needs to have .NET Framework 4.6 installed.

    • När du har installerat den lokala datagatewayen måste du också skapa en Azure gateway-resurs för den lokala datagatewayen som MQ-anslutningen använder för att komma åt din lokala MQ-Server.After you install the on-premises data gateway, you also need to create an Azure gateway resource for the on-premises data gateway that the MQ connector uses to access your on-premises MQ server.

  • Den Logic app där du vill använda MQ-anslutningsprogrammet.The logic app where you want to use the MQ connector. MQ-anslutningen har inga utlösare, så du måste först lägga till en utlösare i din Logic app.The MQ connector doesn't have any triggers, so you must add a trigger to your logic app first. Du kan till exempel använda upprepnings utlösaren.For example, you can use the Recurrence trigger. Om du inte har använt Logic Apps igen kan du prova den här snabb starten för att skapa din första Logic-app.If you're new to logic apps, try this quickstart to create your first logic app.

BegränsningarLimitations

MQ-anslutningsprogrammet stöder eller använder inte meddelandets format fält och utför inte några teckenuppsättningar för teckenuppsättning.The MQ connector doesn't support or use the message's Format field and doesn't perform any character set conversions. Kopplingen placerar bara de data som visas i meddelande fältet i ett JSON-meddelande och skickar meddelandet tillsammans.The connector only puts whatever data appears in the message field into a JSON message and sends the message along.

Skapa MQ-anslutningCreate MQ connection

Om du inte redan har en MQ-anslutning när du lägger till en MQ-åtgärd uppmanas du att skapa anslutningen, till exempel:If you don't already have an MQ connection when you add an MQ action, you're prompted to create the connection, for example:

Ange anslutnings information

  1. Om du ansluter till en lokal MQ-server väljer du Anslut via lokal datagateway.If you're connecting to an on-premises MQ server, select Connect via on-premises data gateway.

  2. Ange anslutnings informationen för din MQ-Server.Provide the connection information for your MQ server.

    • För Server kan du ange namnet på MQ-servern eller ange IP-adressen följt av ett kolon och port numret.For Server, you can enter the MQ server name, or enter the IP address followed by a colon and the port number.

    • Om du vill använda Transport Layer Security (TLS) eller Secure Sockets Layer (SSL) väljer du Aktivera SSL?.To use Transport Layer Security (TLS) or Secure Sockets Layer (SSL), select Enable SSL?.

      MQ-anslutaren stöder för närvarande endast serverautentisering, inte klientautentisering.The MQ connector currently supports only server authentication, not client authentication. Mer information finns i problem med anslutning och autentisering.For more information, see Connection and authentication problems.

  3. I avsnittet Gateway följer du dessa steg:In the gateway section, follow these steps:

    1. I listan prenumeration väljer du den Azure-prenumeration som är kopplad till din Azure gateway-resurs.From the Subscription list, select the Azure subscription that's associated with your Azure gateway resource.

    2. Välj den Azure gateway-resurs som du vill använda från listan anslutnings-Gateway .From the Connection Gateway list, select the Azure gateway resource that you want to use.

  4. När du är färdig väljer du Skapa.When you're done, select Create.

Problem med anslutning och autentiseringConnection and authentication problems

När din Logi Kap par försöker ansluta till din lokala MQ-Server kan du få följande fel meddelande:When your logic app tries connecting to your on-premises MQ server, you might get this error:

"MQ: Could not Connect the Queue Manager '<queue-manager-name>': The Server was expecting an SSL connection."

  • Om du använder MQ-anslutaren direkt i Azure måste MQ-servern använda ett certifikat som utfärdats av en betrodd certifikat utfärdare.If you're using the MQ connector directly in Azure, the MQ server needs to use a certificate that's issued by a trusted certificate authority.

  • Om du använder den lokala datagatewayen kan du försöka använda ett certifikat som utfärdats av en betrodd certifikat utfärdare när det är möjligt.If you're using the on-premises data gateway, try to use a certificate that's issued by a trusted certificate authority when possible. Men om det här alternativet inte är möjligt kan du använda ett självsignerat certifikat, som inte har utfärdats av en betrodd certifikat utfärdare och anses vara mindre säkert.However, if this option isn't possible, you could use a self-signed certificate, which is isn't issued by a trusted certificate authority and is considered less secure.

    Om du vill installera serverns självsignerade certifikat kan du använda verktyget Windows Certification Manager (certmgr. msc).To install the server's self-signed certificate, you can use the Windows Certification Manager (certmgr.msc) tool. I det här scenariot måste du installera certifikatet i den lokala datorns certifikat Arkiv på nivån betrodda rot certifikat utfärdare på den lokala datorn där den lokala data Gateway-tjänsten körs.For this scenario, on your local computer where the on-premises data gateway service is running, you need to install the certificate in your Local Computer certificates store at the Trusted Root Certification Authorities level.

    1. Öppna Start-menyn på datorn där den lokala data Gateway-tjänsten körs, leta upp och välj hantera användar certifikat.On the computer where the on-premises-data gateway service is running, open the start menu, find and select Manage user certificates.

    2. När Windows Certificate Manager-verktyget har öppnats går du till mappen certifikat – lokal dator för > betrodda rot certifikat utfärdare och installerar certifikatet.After the Windows Certification Manager tool opens, go to the Certificates - Local Computer > Trusted Root Certification Authorities folder, and install the certificate.

      Viktigt

      Se till att du installerar certifikat i arkivet certifikat – lokal dator > betrodd rot certifikat utfärdare .Make sure that you install certificate in the Certificates - Local Computer > Trusted Root Certification Authorities store.

  • MQ-servern kräver att du definierar den chiffersviter som du vill använda för TLS/SSL-anslutningar.The MQ server requires that you define the cipher specification that you want to use for TLS/SSL connections. SslStream i .NET tillåter dock inte att du anger ordningen för chiffrering av specifikationer.However, SslStream in .NET doesn't permit you to specify the order for cipher specifications. För att undvika den här begränsningen kan du ändra konfigurationen för MQ-servern så att den matchar den första chiffer-specifikationen i sviten som anslutnings tjänsten skickar i TLS/SSL-förhandlingen.To work around this limitation, you can change your MQ server configuration to match the first cipher specification in the suite that the connector sends in the TLS/SSL negotiation.

    När du försöker ansluta loggar MQ-servern ett händelse meddelande som anger att anslutningen misslyckades på grund av att den andra parten använde felaktig chiffrering-specifikation.When you try the connection, the MQ server logs an event message that indicates the connection failed because the other end used the incorrect cipher specification. Händelse meddelandet innehåller den cipher-specifikation som visas först i listan.The event message contains the cipher specification that appears first in the list. Uppdatera cipher-specifikationen i kanal konfigurationen så att den matchar chiffer-specifikationen i händelse meddelandet.Update the cipher specification in the channel configuration to match the cipher specification in the event message.

Bläddra i ett enskilt meddelandeBrowse single message

  1. I din Logic app, under utlösaren eller en annan åtgärd, väljer du nytt steg.In your logic app, under the trigger or another action, select New step.

  2. I sökrutan anger du mq och väljer åtgärden Bläddra meddelande .In the search box, enter mq, and select the Browse message action.

    Välj åtgärd för att bläddra meddelande

  3. Om du inte redan har skapat en MQ-anslutning uppmanas du att skapa anslutningen.If you haven't already created an MQ connection, you're prompted to create that connection.

  4. När du har skapat anslutningen ställer du in egenskaperna för åtgärden Bläddra meddelande :After you create the connection, set up the Browse message action's properties:

    EgenskapProperty BeskrivningDescription
    Queue Om det skiljer sig från den kö som anges i anslutningen anger du den kön.If different from the queue specified in the connection, specify that queue.
    Messageid, correlationId, Egenskaper och andra egenskaperMessageId, CorrelationId, GroupId, and other properties Bläddra efter ett meddelande som baseras på de olika egenskaperna för MQ-meddelandenBrowse for a message that's based on the different MQ message properties
    IncludeInfoIncludeInfo Om du vill inkludera ytterligare meddelande information i utdata väljer du Sant.To include additional message information in the output, select true. Om du vill utelämna ytterligare meddelande information i utdata väljer du falskt.To omit additional message information in the output, select false.
    StandardvärdeTimeout Ange ett värde för att avgöra hur lång tid det tar innan ett meddelande kommer till en tom kö.Enter a value to determine how long to wait for a message to arrive in an empty queue. Om inget anges hämtas det första meddelandet i kön och det finns ingen tids åtgång i väntan på att ett meddelande ska visas.If nothing is entered, the first message in the queue is retrieved, and there is no time spent waiting for a message to appear.

    Exempel:For example:

    Egenskaper för åtgärden "Bläddra meddelande"

  5. När du är klar väljer du Spara i verktygsfältet designer.When you're done, on the designer toolbar, select Save. Om du vill testa appen väljer du Kör.To test your app, select Run.

    När körningen är klar visar designern arbets flödes stegen och deras status så att du kan granska utdata.After the run finishes, the designer shows the workflow steps and their status so that you can review the output.

  6. Om du vill visa information om varje steg klickar du på stegets namn List.To view the details about each step, click the step's title bar. Om du vill granska mer information om ett stegs utdata väljer du Visa rå data.To review more information about a step's output, select Show raw outputs.

    Bläddra i meddelandets utdata

    Här följer några exempel på rå utdata:Here is some sample raw output:

    Bläddra i meddelandets RAW-utdata

  7. Om du anger IncludeInfo till Sant visas ytterligare utdata:If you set IncludeInfo to true, additional output is shown:

    Bläddra bland meddelandet innehåller info

Bläddra bland flera meddelandenBrowse multiple messages

Åtgärden Bläddra meddelanden innehåller ett batchSize -alternativ för att ange hur många meddelanden som ska returneras från kön.The Browse messages action includes a BatchSize option to indicate how many messages to return from the queue. Om batchSize inte har något värde returneras alla meddelanden.If BatchSize has no value, all messages are returned. Returnerade utdata är en matris med meddelanden.The returned output is an array of messages.

  1. Följ föregående steg, men Lägg till åtgärden Sök meddelanden i stället.Follow the previous steps, but add the Browse messages action instead.

  2. Om du inte redan har skapat en MQ-anslutning uppmanas du att skapa anslutningen.If you haven't already created an MQ connection, you're prompted to create that connection. Annars används den första tidigare konfigurerade anslutningen som standard.Otherwise, by default, the first previously configured connection is used. Om du vill skapa en ny anslutning väljer du ändra anslutning.To create a new connection, select Change connection. Eller Välj en annan anslutning.Or, select a different connection.

  3. Ange informationen för åtgärden.Provide the information for the action.

  4. Spara och kör Logic-appen.Save and run the logic app.

    När Logic-appen har körts klart är följande exempel på utdata från åtgärden Bläddra meddelanden :After the logic app finishes running, here is some sample output from the Browse messages action:

    Exempel på utdata från "Bläddra meddelanden"

Ta emot ett enskilt meddelandeReceive single message

Åtgärden ta emot meddelande har samma indata och utdata som åtgärd för att söka efter meddelanden .The Receive message action has the same inputs and outputs as the Browse message action. När du använder meddelandet tas meddelandet bort från kön.When you use Receive message, the message is deleted from the queue.

Ta emot flera meddelandenReceive multiple messages

Åtgärden ta emot meddelanden har samma indata och utdata som åtgärd för att söka meddelanden .The Receive messages action has the same inputs and outputs as the Browse messages action. När du använder mottagna meddelanden tas meddelandena bort från kön.When you use Receive messages, the messages are deleted from the queue.

Anteckning

När du kör en browse-eller Receive-åtgärd i en kö som inte har några meddelanden, Miss lyckas åtgärden med följande utdata:When running a browse or a receive action on a queue that doesn't have any messages, the action fails with this output:

Felet "inget meddelande" i MQ

Skicka meddelandeSend message

  1. Följ föregående steg, men Lägg till åtgärden Skicka meddelande i stället.Follow the previous steps, but add the Send message action instead.

  2. Om du inte redan har skapat en MQ-anslutning uppmanas du att skapa anslutningen.If you haven't already created an MQ connection, you're prompted to create that connection. Annars används den första tidigare konfigurerade anslutningen som standard.Otherwise, by default, the first previously configured connection is used. Om du vill skapa en ny anslutning väljer du ändra anslutning.To create a new connection, select Change connection. Eller Välj en annan anslutning.Or, select a different connection.

  3. Ange informationen för åtgärden.Provide the information for the action. För MessageType väljer du en giltig meddelande typ: datagram, Reply eller RequestFor MessageType, select a valid message type: Datagram, Reply, or Request

    Egenskaper för "Skicka meddelande åtgärd"

  4. Spara och kör Logic-appen.Save and run the logic app.

    När Logic-appen har körts klart är följande exempel på utdata från åtgärden Skicka meddelande :After the logic app finishes running, here is some sample output from the Send message action:

    Exempel på "Skicka meddelande"-utdata

Referens för anslutningsappConnector reference

För teknisk information, till exempel åtgärder och begränsningar, som beskrivs i anslutningens Swagger-fil, granskar du kopplingens referens sida.For technical details, such as actions and limits, which are described in the connector's Swagger file, review the connector's reference page.

Nästa stegNext steps