Připojení k serveru IBM MQ z pracovního postupu v Azure Logic Apps

Konektor MQ vám pomůže připojit pracovní postupy aplikace logiky k serveru IBM MQ, který je místní nebo v Azure. Pracovní postupy pak můžete přijímat a posílat zprávy uložené na serveru MQ. Tento článek obsahuje úvodní příručku k používání konektoru MQ, který ukazuje, jak se připojit k serveru MQ a přidat akci MQ do pracovního postupu. Můžete například začít procházením jedné zprávy ve frontě a následným vyzkoušením dalších akcí.

Tento konektor zahrnuje klienta Microsoft MQ, který komunikuje se vzdáleným serverem MQ přes síť TCP/IP. Můžete se připojit k následujícím verzím IBM WebSphere MQ:

  • MQ 7,5
  • MQ 8.0
  • MQ 9.0, 9.1 a 9.2

Dostupné operace

  • Aplikace logiky consumption: K serveru MQ se můžete připojit pouze pomocí spravovaného konektoru MQ. Tento konektor poskytuje pouze akce, žádné triggery.

  • Standardní aplikace logiky: K serveru MQ se můžete připojit pomocí spravovaného konektoru MQ, který zahrnuje pouze akce, nebo integrované operace MQ, které zahrnují triggery a akce.

Další informace o rozdílu mezi spravovaným konektorem a integrovanými operacemi najdete v klíčových pojmech v Logic Apps.

Následující seznam popisuje pouze některé spravované operace dostupné pro MQ:

  • Procházejte jednu zprávu nebo pole zpráv bez odstranění ze serveru MQ. U více zpráv můžete určit maximální počet zpráv, které se mají vrátit na dávku. V opačném případě se vrátí všechny zprávy.
  • Odstraňte jednu nebo matici zpráv ze serveru MQ.
  • Přijměte jednu zprávu nebo pole zpráv a pak odstraňte ze serveru MQ.
  • Odešlete jednu zprávu na server MQ.

Pro všechny operace spravovaného konektoru a další technické informace, jako jsou vlastnosti, limity atd., si projděte referenční stránku konektoru MQ.

Omezení

  • Konektor MQ nepodporuje segmentované zprávy.

  • Konektor MQ nepoužívá pole Formát zprávy a neprovádí převody znakové sady. Konektor vloží do pole zprávy jenom data, která se zobrazí, do zprávy JSON a odešle zprávu.

Požadavky

  • Účet a předplatné Azure. Pokud nemáte předplatné Azure, zaregistrujte si bezplatný účet Azure.

  • Pokud používáte místní server MQ, nainstalujte místní bránu dat na server v síti. Aby konektor MQ fungoval, musí mít server s místní bránou dat také nainstalovanou .NET Framework 4.6.

    Po instalaci brány musíte také vytvořit prostředek brány dat v Azure. Konektor MQ používá tento prostředek pro přístup k serveru MQ. Další informace najdete v tématu Nastavení připojení brány dat.

    Poznámka

    Bránu nepotřebujete v následujících scénářích:

    • Použijete integrované operace, ne spravovaný konektor.
    • Váš server MQ je veřejně dostupný nebo dostupný v Azure.
  • Pracovní postup aplikace logiky, ve kterém chcete získat přístup k serveru MQ. Prostředek aplikace logiky musí mít stejné umístění jako prostředek brány v Azure.

    Konektor MQ nemá žádné triggery, takže pracovní postup už musí začínat triggerem, nebo musíte nejdřív do pracovního postupu přidat trigger. Můžete například použít trigger Opakování.

    Pokud s Azure Logic Apps začínáte, zkuste v tomto rychlém startu vytvořit ukázkový pracovní postup aplikace logiky, který běží ve službě Logic Apps s více tenanty.

Vytvoření připojení MQ

Když poprvé přidáte akci MQ, zobrazí se výzva k vytvoření připojení k serveru MQ.

Poznámka

Konektor MQ aktuálně podporuje pouze ověřování serveru, nikoli ověřování klientů. Další informace najdete v tématu Problémy s připojením a ověřováním.

  1. Pokud se připojujete k místnímu serveru MQ, vyberte Připojení přes místní bránu dat.

  2. Zadejte informace o připojení pro server MQ.

    Vlastnost Místní prostředí nebo Azure Description
    Brány Pouze místní prostředí Vyberte Připojení prostřednictvím místní brány dat.
    Název připojení Obojí Název, který se má použít pro připojení
    Server Obojí Jedna z následujících hodnot:

    – Název hostitele serveru MQ
    – IP adresa následovaná dvojtečku a číslem portu

    Název Správce fronty Obojí Správce front, který chcete použít
    Název kanálu Obojí Kanál pro připojení ke Správci front
    Výchozí název fronty Obojí Výchozí název fronty
    Připojit jako Obojí Uživatelské jméno pro připojení k serveru MQ
    Uživatelské jméno Obojí Přihlašovací údaje k vašemu uživatelskému jménu
    Heslo Obojí Přihlašovací údaje k vašemu heslu
    Povolit SSL? Pouze místní prostředí Použití protokolu TLS (Transport Layer Security) nebo ssl (Secure Sockets Layer)
    Brána – předplatné Pouze místní prostředí Předplatné Azure přidružené k vašemu prostředku brány v Azure
    Brána – brána připojení Pouze místní prostředí Prostředek brány, který se má použít

    Příklad:

    Screenshot showing the managed MQ connection details.

  3. Po dokončení vyberte Vytvořit.

Přidání akce MQ

V Azure Logic Apps akce následuje trigger nebo jinou akci a provede nějakou operaci v pracovním postupu. Následující kroky popisují obecný způsob přidání akce, například Procházení jedné zprávy.

  1. V Návrháři pro Logic Apps otevřete pracovní postup, pokud ještě není otevřený.

  2. Pod triggerem nebo jinou akcí přidejte nový krok.

    Pokud chcete přidat krok mezi existujícími kroky, přesuňte myš na šipku. Vyberte znaménko plus (+), které se zobrazí, a pak vyberte Přidat akci.

  3. Do vyhledávacího pole operace zadejte mq. V seznamu akcí vyberte akci s názvem Procházet zprávu.

  4. Pokud se zobrazí výzva k vytvoření připojení k serveru MQ, zadejte požadované informace o připojení.

  5. V akci zadejte hodnoty vlastností, které akce potřebuje.

    Další vlastnosti získáte tak, že otevřete seznam přidat nový parametr a vyberete vlastnosti, které chcete přidat.

  6. Až to budete hotovi, vyberte na panelu nástrojů návrháře možnost Uložit.

  7. Pokud chcete svůj pracovní postup otestovat, vyberte na panelu nástrojů návrháře možnost Spustit.

    Po dokončení spuštění návrhář zobrazí historii spuštění pracovního postupu spolu se stavem kroku.

  8. Pokud chcete zkontrolovat vstupy a výstupy pro každý krok, který se spustil (není vynechán), rozbalte nebo vyberte krok.

    • Pokud chcete zkontrolovat další podrobnosti o vstupu, vyberte Zobrazit nezpracované vstupy.
    • Pokud chcete zkontrolovat další podrobnosti o výstupu, vyberte Zobrazit nezpracované výstupy. Pokud nastavíte IncludeInfo na hodnotu true, zahrne se další výstup.

Poradce při potížích

Selhání s akcemi procházení nebo příjmu

Pokud spustíte akci procházení nebo přijímání v prázdné frontě, akce selže s následujícími výstupy hlaviček:

MQ

Problémy s připojením a ověřováním

Když se pracovní postup pokusí připojit k místnímu serveru MQ, může se zobrazit tato chyba:

"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.

  • Server MQ vyžaduje, abyste definovali specifikaci šifry, která se má použít s připojeními TLS. Pro účely zabezpečení a zahrnutí nejlepších sad zabezpečení ale operační systém Windows odešle sadu podporovaných specifikací šifr.

    Operační systém, na kterém běží server MQ, zvolí sady, které se mají použít. Aby se konfigurace shodovaly, musíte změnit nastavení serveru MQ tak, aby specifikace šifry odpovídala možnosti zvolené v vyjednávání protokolu TLS.

    Při pokusu o připojení server MQ zaznamená zprávu události, že pokus o připojení selhal, protože server MQ zvolil nesprávnou specifikaci šifry. Zpráva události obsahuje specifikaci šifry, kterou server MQ vybral ze seznamu. V konfiguraci kanálu aktualizujte specifikaci šifry tak, aby odpovídala specifikaci šifry ve zprávě události.

Referenční informace ke konektorům

Pro všechny operace ve spravovaném konektoru a další technické informace, jako jsou vlastnosti, limity atd., si projděte referenční stránku konektoru MQ.

Další kroky