Připojení k serveru IBM MQ z Azure Logic AppsConnect to an IBM MQ server from Azure Logic Apps

Konektor MQ odesílá a načítá zprávy uložené na serveru MQ místně nebo v Azure.The MQ connector sends and retrieves messages stored in an MQ server on premises or in Azure. Tento konektor zahrnuje klienta Microsoft MQ, který komunikuje se vzdáleným serverem IBM MQ napříč sítí TCP/IP.This connector includes a Microsoft MQ client that communicates with a remote IBM MQ server across a TCP/IP network. Tento článek poskytuje Úvodní příručku k používání konektoru MQ.This article provides a starter guide to use the MQ connector. Můžete začít procházením jedné zprávy ve frontě a následným pokusem o další akce.You can start by browsing a single message on a queue and then try other actions.

Konektor MQ zahrnuje tyto akce, ale neposkytuje žádné triggery:The MQ connector includes these actions but provides no triggers:

  • Procházejte jednu zprávu bez odstranění zprávy ze serveru MQ.Browse a single message without deleting the message from the MQ server.
  • Projděte si dávku zpráv, aniž byste museli odstraňovat zprávy ze serveru MQ.Browse a batch of messages without deleting the messages from the MQ server.
  • Obdržení jedné zprávy a odstranění zprávy ze serveru MQ.Receive a single message and delete the message from the MQ server.
  • Obdrží dávku zpráv a odstraní zprávy ze serveru MQ.Receive a batch of messages and delete the messages from the MQ server.
  • Odešlete jednu zprávu na server MQ.Send a single message to the MQ server.

Tady jsou oficiálně podporované verze IBM WebSphere MQ: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

PožadavkyPrerequisites

  • Pokud používáte místní server MQ, musíte nainstalovat místní bránu dat na server v rámci vaší sítě.If you use an on-premises MQ server, you need to install the on-premises data gateway on a server within your network.

    Poznámka

    Pokud je váš server MQ veřejně dostupný nebo dostupný v rámci Azure, nemusíte používat bránu dat.If your MQ server is publicly available or available within Azure, you don't have to use the data gateway.

    • Aby mohl konektor MQ fungovat, musí mít server, na který instalujete místní bránu dat, taky nainstalovanou .NET Framework 4,6.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.

    • Po instalaci místní brány dat musíte také vytvořit prostředek brány Azure pro místní bránu dat , kterou konektor MQ používá pro přístup k místnímu serveru MQ.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.

  • Aplikace logiky, ve které chcete použít konektor MQ.The logic app where you want to use the MQ connector. Konektor MQ nemá žádné triggery, takže musíte nejdřív přidat Trigger do aplikace logiky.The MQ connector doesn't have any triggers, so you must add a trigger to your logic app first. Můžete například použít Trigger opakování.For example, you can use the Recurrence trigger. Pokud s Logic Apps začínáte, vyzkoušejte si tento rychlý Start, abyste vytvořili svoji první aplikaci logiky.If you're new to logic apps, try this quickstart to create your first logic app.

OmezeníLimitations

Konektor MQ nepodporuje nebo nepoužívá pole formátu zprávy a neprovádí převody žádné znakové sady.The MQ connector doesn't support or use the message's Format field and doesn't perform any character set conversions. Konektor vloží jenom data, která se zobrazí v poli zpráva, do zprávy JSON a pošle zprávu společně.The connector only puts whatever data appears in the message field into a JSON message and sends the message along.

Vytvořit připojení MQCreate MQ connection

Pokud ještě nemáte připojení MQ, když přidáte akci MQ, budete vyzváni k vytvoření připojení, například:If you don't already have an MQ connection when you add an MQ action, you're prompted to create the connection, for example:

Zadání informací o připojení

  1. Pokud se připojujete k místnímu serveru MQ, vyberte připojit přes místní bránu dat.If you're connecting to an on-premises MQ server, select Connect via on-premises data gateway.

  2. Zadejte informace o připojení pro váš server MQ.Provide the connection information for your MQ server.

    • Pro Server můžete zadat název serveru MQ nebo zadat IP adresu následovaný dvojtečkou a číslem portu.For Server, you can enter the MQ server name, or enter the IP address followed by a colon and the port number.

    • Chcete-li použít protokol TLS (Transport Layer Security) nebo SSL (Secure Sockets Layer) (SSL), vyberte možnost Povolit SSL?.To use Transport Layer Security (TLS) or Secure Sockets Layer (SSL), select Enable SSL?.

      Konektor MQ aktuálně podporuje pouze ověřování serveru, nikoli ověřování klientů.The MQ connector currently supports only server authentication, not client authentication. Další informace najdete v tématu problémy s připojením a ověřováním.For more information, see Connection and authentication problems.

  3. V části Brána proveďte tyto kroky:In the gateway section, follow these steps:

    1. V seznamu předplatné vyberte předplatné Azure, které je přidružené k vašemu prostředku brány Azure.From the Subscription list, select the Azure subscription that's associated with your Azure gateway resource.

    2. V seznamu Brána připojení vyberte prostředek brány Azure, který chcete použít.From the Connection Gateway list, select the Azure gateway resource that you want to use.

  4. Po dokončení vyberte Vytvořit.When you're done, select Create.

Problémy s připojením a ověřovánímConnection and authentication problems

Když se aplikace logiky pokusí připojit k místnímu serveru MQ, může se zobrazit tato chyba: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."

  • Pokud používáte konektor MQ přímo v Azure, musí server MQ používat certifikát vydaný důvěryhodnou certifikační autoritou.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.

  • Pokud používáte místní bránu dat, zkuste použít certifikát vydaný důvěryhodnou certifikační autoritou , pokud je to možné.If you're using the on-premises data gateway, try to use a certificate that's issued by a trusted certificate authority when possible. Pokud však tato možnost není možná, můžete použít certifikát podepsaný svým držitelem, který není vydán důvěryhodnou certifikační autoritou a který je považován za méně bezpečný.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.

    Chcete-li nainstalovat certifikát podepsaný svým držitelem, můžete použít nástroj správce certifikace systému Windows (certmgr. msc).To install the server's self-signed certificate, you can use the Windows Certification Manager (certmgr.msc) tool. V tomto scénáři je potřeba nainstalovat certifikát do úložiště certifikátů místního počítače na úrovni důvěryhodných kořenových certifikačních autorit v místním počítači, na kterém je spuštěná služba místní brány dat.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. V počítači, kde je spuštěna služba místní brána dat, otevřete nabídku Start, vyhledejte a vyberte možnost Spravovat uživatelské certifikáty.On the computer where the on-premises-data gateway service is running, open the start menu, find and select Manage user certificates.

    2. Po otevření nástroje Správce certifikace systému Windows přejdete do složky certifikáty – místní počítač > Důvěryhodné kořenové certifikační autority a certifikát nainstalujete.After the Windows Certification Manager tool opens, go to the Certificates - Local Computer > Trusted Root Certification Authorities folder, and install the certificate.

      Důležité

      Ujistěte se, že jste nainstalovali certifikát do > úložiště Důvěryhodné kořenové certifikační autority počítače místní počítač.Make sure that you install certificate in the Certificates - Local Computer > Trusted Root Certification Authorities store.

  • Server MQ vyžaduje, abyste definovali specifikaci šifrování, kterou chcete použít pro připojení TLS/SSL.The MQ server requires that you define the cipher specification that you want to use for TLS/SSL connections. SslStream v rozhraní .NET ale neumožňuje zadat pořadí pro specifikace šifry.However, SslStream in .NET doesn't permit you to specify the order for cipher specifications. Pokud chcete toto omezení obejít, můžete změnit konfiguraci serveru MQ tak, aby odpovídala první specifikaci šifry v sadě, kterou konektor odesílá při vyjednávání TLS/SSL.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.

    Když se pokusíte o připojení, server MQ zaznamená zprávu události, která indikuje, že připojení selhalo, protože druhý konec použil nesprávnou specifikaci šifry.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. Zpráva o události obsahuje specifikace šifry, která se v seznamu zobrazuje jako první.The event message contains the cipher specification that appears first in the list. Aktualizujte specifikaci šifry v konfiguraci kanálu tak, aby odpovídala specifikaci šifry ve zprávě události.Update the cipher specification in the channel configuration to match the cipher specification in the event message.

Procházet jednu zprávuBrowse single message

  1. V aplikaci logiky pod triggerem nebo jinou akcí vyberte Nový krok.In your logic app, under the trigger or another action, select New step.

  2. Do vyhledávacího pole zadejte mq a vyberte akci Procházet zprávu .In the search box, enter mq, and select the Browse message action.

    Vybrat akci procházet zprávu

  3. Pokud jste ještě nevytvořili připojení MQ, budete vyzváni k vytvoření tohoto připojení.If you haven't already created an MQ connection, you're prompted to create that connection.

  4. Po vytvoření připojení nastavte vlastnosti akce zprávy procházet :After you create the connection, set up the Browse message action's properties:

    VlastnostProperty PopisDescription
    FrontaQueue Pokud se liší od fronty zadané v rámci připojení, zadejte tuto frontu.If different from the queue specified in the connection, specify that queue.
    MessageID, ID korelace, identifikátor skupiny a další vlastnostiMessageId, CorrelationId, GroupId, and other properties Vyhledat zprávu, která je založena na různých vlastnostech zprávy MQBrowse for a message that's based on the different MQ message properties
    IncludeInfoIncludeInfo Pokud chcete do výstupu zahrnout další informace o zprávě, vyberte true.To include additional message information in the output, select true. Pokud chcete ve výstupu vynechat další informace o zprávě, vyberte false (NEPRAVDA).To omit additional message information in the output, select false.
    ProdlevTimeout Zadejte hodnotu, která určuje, jak dlouho se má čekat na doručení zprávy do prázdné fronty.Enter a value to determine how long to wait for a message to arrive in an empty queue. Pokud nezadáte žádnou hodnotu, načte se první zpráva ve frontě a nestrávená doba čekání na zobrazení zprávy.If nothing is entered, the first message in the queue is retrieved, and there is no time spent waiting for a message to appear.

    Například:For example:

    Vlastnosti pro akci procházet zprávu

  5. Až budete hotovi, na panelu nástrojů návrháře vyberte Uložit.When you're done, on the designer toolbar, select Save. Pokud chcete aplikaci otestovat, vyberte Spustit.To test your app, select Run.

    Po dokončení běhu Návrhář zobrazí kroky pracovního postupu a jejich stav, abyste mohli zkontrolovat výstup.After the run finishes, the designer shows the workflow steps and their status so that you can review the output.

  6. Chcete-li zobrazit podrobnosti o jednotlivých krocích, klikněte na záhlaví kroku.To view the details about each step, click the step's title bar. Chcete-li zobrazit další informace o výstupu kroku, vyberte možnost Zobrazit nezpracované výstupy.To review more information about a step's output, select Show raw outputs.

    Procházet výstup zprávy

    Zde je ukázkový nezpracovaný výstup:Here is some sample raw output:

    Procházet nezpracovaný výstup zprávy

  7. Pokud nastavíte IncludeInfo na hodnotu true, zobrazí se další výstup:If you set IncludeInfo to true, additional output is shown:

    Procházet informace o zahrnutí zprávy

Procházet více zprávBrowse multiple messages

Akce Procházet zprávy obsahuje možnost BatchSize , která určuje, kolik zpráv se má vrátit z fronty.The Browse messages action includes a BatchSize option to indicate how many messages to return from the queue. Pokud BatchSize nemá žádnou hodnotu, vrátí se všechny zprávy.If BatchSize has no value, all messages are returned. Vrácený výstup je pole zpráv.The returned output is an array of messages.

  1. Postupujte podle předchozích kroků, ale místo toho přidejte akci Procházet zprávy .Follow the previous steps, but add the Browse messages action instead.

  2. Pokud jste ještě nevytvořili připojení MQ, budete vyzváni k vytvoření tohoto připojení.If you haven't already created an MQ connection, you're prompted to create that connection. V opačném případě se ve výchozím nastavení použije první dřív nakonfigurované připojení.Otherwise, by default, the first previously configured connection is used. Chcete-li vytvořit nové připojení, vyberte možnost změnit připojení.To create a new connection, select Change connection. Případně vyberte jiné připojení.Or, select a different connection.

  3. Zadejte informace pro akci.Provide the information for the action.

  4. Uložte a spusťte aplikaci logiky.Save and run the logic app.

    Až se aplikace logiky dokončí, tady je ukázkový výstup z akce Procházet zprávy :After the logic app finishes running, here is some sample output from the Browse messages action:

    Ukázka výstupu "Procházet zprávy"

Přijmout jednu zprávuReceive single message

Akce přijmout zprávu má stejné vstupy a výstupy jako akce procházení zprávy .The Receive message action has the same inputs and outputs as the Browse message action. Když použijete zprávu přijmout, zpráva se odstraní z fronty.When you use Receive message, the message is deleted from the queue.

Přijímání více zprávReceive multiple messages

Akce přijmout zprávy má stejné vstupy a výstupy jako akce Procházet zprávy .The Receive messages action has the same inputs and outputs as the Browse messages action. Když použijete přijímat zprávy, zprávy se odstraní z fronty.When you use Receive messages, the messages are deleted from the queue.

Poznámka

Když spustíte akci procházet nebo přijmout ve frontě, která nemá žádné zprávy, akce s tímto výstupem se nezdařila:When running a browse or a receive action on a queue that doesn't have any messages, the action fails with this output:

Chyba typu MQ "žádná zpráva"

Odeslat zprávuSend message

  1. Postupujte podle předchozích kroků, ale místo toho přidejte akci Odeslat zprávu .Follow the previous steps, but add the Send message action instead.

  2. Pokud jste ještě nevytvořili připojení MQ, budete vyzváni k vytvoření tohoto připojení.If you haven't already created an MQ connection, you're prompted to create that connection. V opačném případě se ve výchozím nastavení použije první dřív nakonfigurované připojení.Otherwise, by default, the first previously configured connection is used. Chcete-li vytvořit nové připojení, vyberte možnost změnit připojení.To create a new connection, select Change connection. Případně vyberte jiné připojení.Or, select a different connection.

  3. Zadejte informace pro akci.Provide the information for the action. V případě MessageType Vyberte platný typ zprávy: datagram, Reply nebo Request .For MessageType, select a valid message type: Datagram, Reply, or Request

    Vlastnosti pro akci odeslání zprávy

  4. Uložte a spusťte aplikaci logiky.Save and run the logic app.

    Až se aplikace logiky dokončí, tady je ukázkový výstup z akce Odeslat zprávu :After the logic app finishes running, here is some sample output from the Send message action:

    Ukázka výstupu "Odeslat zprávu"

Referenční informace ke konektorůmConnector reference

Podrobnosti o technických podrobnostech, jako jsou akce a omezení, které jsou popsány v souboru Swagger konektoru, najdete na referenční stránce konektoru.For technical details, such as actions and limits, which are described in the connector's Swagger file, review the connector's reference page.

Další krokyNext steps