Anslut till en IBM MQ-server från ett arbetsflöde i Azure Logic Apps

MQ-anslutningsappen hjälper dig att ansluta dina logikapparbetsflöden till en IBM MQ-server som antingen finns lokalt eller i Azure. Du kan sedan låta dina arbetsflöden ta emot och skicka meddelanden lagrade på MQ-servern. Den här artikeln innehåller en komma igång-guide för att använda MQ-anslutningsappen genom att visa hur du ansluter till MQ-servern och lägger till en MQ-åtgärd i arbetsflödet. Du kan till exempel börja med att bläddra i ett enda meddelande i en kö och sedan prova andra åtgärder.

Den här anslutningsappen innehåller en Microsoft MQ-klient som kommunicerar med en fjärransluten MQ-server i ett TCP/IP-nätverk. Du kan ansluta till följande IBM WebSphere MQ-versioner:

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

Tillgängliga åtgärder

  • Logikapp för förbrukning: Du kan bara ansluta till en MQ-server med hjälp av den hanterade MQ-anslutningsappen. Den här anslutningsappen innehåller endast åtgärder, inga utlösare.

  • Standardlogikapp: Du kan ansluta till en MQ-server med hjälp av antingen den hanterade MQ-anslutningsappen, som endast innehåller åtgärder, eller de inbyggda MQ-åtgärderna , som omfattar utlösare och åtgärder.

Mer information om skillnaden mellan en hanterad anslutningsapp och inbyggda åtgärder finns i viktiga termer i Logic Apps.

I följande lista beskrivs endast några av de hanterade åtgärder som är tillgängliga för MQ:

  • Bläddra bland ett enskilt meddelande eller en matris med meddelanden utan att ta bort från MQ-servern. För flera meddelanden kan du ange det maximala antalet meddelanden som ska returneras per batch. Annars returneras alla meddelanden.
  • Ta bort en enskild eller en matris med meddelanden från MQ-servern.
  • Ta emot ett enda meddelande eller en matris med meddelanden och ta sedan bort från MQ-servern.
  • Skicka ett enda meddelande till MQ-servern.

För alla åtgärder för hanterade anslutningsappar och annan teknisk information, till exempel egenskaper, gränser och så vidare, kan du gå till MQ-anslutningsappens referenssida.

Begränsningar

  • MQ-anslutningsappen stöder inte segmenterade meddelanden.

  • MQ-anslutningsappen använder inte meddelandets formatfält och gör inga konverteringar av teckenuppsättningar. Anslutningsappen placerar bara de data som visas i meddelandefältet i ett JSON-meddelande och skickar meddelandet vidare.

Förutsättningar

  • Ett Azure-konto och prenumeration. Om du heller inte har någon Azure-prenumeration kan du registrera ett kostnadsfritt Azure-konto.

  • Om du använder en lokal MQ-server installerar du den lokala datagatewayen på en server i nätverket. För att MQ-anslutningsappen ska fungera måste servern med den lokala datagatewayen också ha .NET Framework 4.6 installerat.

    När du har installerat gatewayen måste du också skapa en datagatewayresurs i Azure. MQ-anslutningsappen använder den här resursen för att komma åt MQ-servern. Mer information finns i Konfigurera datagatewayanslutningen.

    Anteckning

    Du behöver inte gatewayen i följande scenarier:

    • Du kommer att använda de inbyggda åtgärderna, inte den hanterade anslutningsappen.
    • MQ-servern är offentligt tillgänglig eller tillgänglig i Azure.
  • Arbetsflödet för logikappen där du vill komma åt MQ-servern. Logikappresursen måste ha samma plats som din gatewayresurs i Azure.

    MQ-anslutningsappen har inga utlösare, så antingen måste arbetsflödet redan börja med en utlösare, eller så måste du först lägga till en utlösare i arbetsflödet. Du kan till exempel använda upprepningsutlösaren.

    Om du inte har Azure Logic Apps kan du prova den här snabbstarten för att skapa ett exempel på ett logikapparbetsflöde som körs i Logic Apps-tjänsten för flera klientorganisationer.

Skapa en MQ-anslutning

När du lägger till en MQ-åtgärd för första gången uppmanas du att skapa en anslutning till MQ-servern.

Anteckning

MQ-anslutningsappen stöder för närvarande endast serverautentisering, inte klientautentisering. Mer information finns i Problem med anslutning och autentisering.

  1. Om du ansluter till en lokal MQ-server väljer du Anslut via lokal datagateway.

  2. Ange anslutningsinformation för MQ-servern.

    Egenskap Lokalt eller Azure Beskrivning
    Gateways Endast lokalt Välj Anslut via lokal datagateway.
    Anslutningsnamn Båda Namnet som ska användas för anslutningen
    Server Båda Något av följande värden:

    – Värdnamn för MQ-server
    – IP-adress följt av ett kolon och portnumret

    Queue Manager-namn Båda Köhanteraren som du vill använda
    Kanalnamn Båda Kanalen för att ansluta till Queue Manager
    Standardkönamn Båda Standardnamnet för kön
    Anslut som Båda Användarnamnet för att ansluta till MQ-servern
    Användarnamn Båda Din autentiseringsuppgift för användarnamn
    Lösenord Båda Dina lösenordsautentiseringsuppgifter
    Vill du aktivera SSL? Endast lokalt Använda TLS (Transport Layer Security) eller SSL (Secure Sockets Layer)
    Gateway – prenumeration Endast lokalt Azure-prenumerationen som är associerad med din gatewayresurs i Azure
    Gateway – Anslutningsgateway Endast lokalt Gatewayresursen som ska användas

    Till exempel:

    Screenshot showing the managed MQ connection details.

  3. När du är färdig väljer du Skapa.

Lägga till en MQ-åtgärd

I Azure Logic Apps följer en åtgärd utlösaren eller en annan åtgärd och utför en åtgärd i arbetsflödet. Följande steg beskriver det allmänna sättet att lägga till en åtgärd, till exempel Bläddra i ett enda meddelande.

  1. Öppna arbetsflödet i Logikappdesignern om det inte redan är öppet.

  2. Lägg till ett nytt steg under utlösaren eller en annan åtgärd.

    Om du vill lägga till ett steg mellan befintliga steg flyttar du musen över pilen. Välj plustecknet (+) som visas och välj sedan Lägg till en åtgärd.

  3. I åtgärdssökrutan anger du mq. I åtgärdslistan väljer du åtgärden Med namnet Bläddra meddelande.

  4. Om du uppmanas att skapa en anslutning till MQ-servern anger du den begärda anslutningsinformationen.

  5. I åtgärden anger du de egenskapsvärden som åtgärden behöver.

    Om du vill ha fler egenskaper öppnar du listan Lägg till ny parameter och väljer de egenskaper som du vill lägga till.

  6. När du är klar väljer du Spara i designerverktygsfältet.

  7. Om du vill testa arbetsflödet går du till designerverktygsfältet och väljer Kör.

    När körningen är klar visar designern arbetsflödets körningshistorik tillsammans med statusen för steget.

  8. Om du vill granska indata och utdata för varje steg som kördes (inte hoppades över) expanderar eller väljer du steget.

    • Om du vill granska mer information om indata väljer du Visa råa indata.
    • Om du vill granska mer information om utdata väljer du Visa råutdata. Om du anger IncludeInfo till true inkluderas fler utdata.

Felsöka problem

Fel med åtgärder för att bläddra eller ta emot

Om du kör en bläddra eller ta emot en åtgärd i en tom kö misslyckas åtgärden med följande rubrikutdata:

MQ

Problem med anslutning och autentisering

När arbetsflödet försöker ansluta till din lokala MQ-server kan det här felet visas:

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

  • Om du använder MQ-anslutningsappen direkt i Azure måste MQ-servern använda ett certifikat som utfärdats av en betrodd certifikatutfärdare.

  • MQ-servern kräver att du definierar chifferspecifikationen som ska användas med TLS-anslutningar. Men i säkerhetssyfte och för att inkludera de bästa säkerhetspaketen skickar Windows operativsystem en uppsättning chifferspecifikationer som stöds.

    Operativsystemet där MQ-servern körs väljer vilka sviter som ska användas. För att konfigurationen ska matcha måste du ändra MQ-serverkonfigurationen så att chifferspecifikationen matchar det alternativ som valts i TLS-förhandlingen.

    När du försöker ansluta loggar MQ-servern ett händelsemeddelande om att anslutningsförsöket misslyckades eftersom MQ-servern valde den felaktiga chifferspecifikationen. Händelsemeddelandet innehåller chifferspecifikationen som MQ-servern valde i listan. I kanalkonfigurationen uppdaterar du chifferspecifikationen så att den matchar chifferspecifikationen i händelsemeddelandet.

Referens för anslutningsapp

Alla åtgärder i den hanterade anslutningsappen och annan teknisk information, till exempel egenskaper, gränser och så vidare, finns på MQ-anslutningsappens referenssida.

Nästa steg