Verbinding maken met een IBM MQ-server vanuit een werkstroom in Azure Logic Apps

Van toepassing op: Azure Logic Apps (verbruik + standaard)

In dit artikel wordt beschreven hoe u toegang krijgt tot een MQ-server die zich on-premises of in Azure bevindt vanuit een werkstroom in Azure Logic Apps met de MQ-connector. U kunt vervolgens geautomatiseerde werkstromen maken die berichten ontvangen en verzenden die zijn opgeslagen op uw MQ-server. Uw werkstroom kan bijvoorbeeld bladeren naar één bericht in een wachtrij en vervolgens andere acties uitvoeren. De MQ-connector bevat een Microsoft MQ-client die communiceert met een externe MQ-server via een TCP/IP-netwerk.

Ondersteunde VERSIES van IBM WebSphere MQ

  • MQ 7.5
  • MQ 8.0
  • MQ 9.0, 9.1 en 9.2

Technische naslaginformatie voor connector

De MQ-connector heeft verschillende versies, op basis van het type logische app en de hostomgeving.

Logische apps Omgeving Verbindingsversie
Verbruik Azure Logic Apps met meerdere tenants Beheerde connector, die wordt weergegeven in de ontwerpfunctie onder het label Enterprise . Deze connector biedt alleen acties, geen triggers. Raadpleeg de volgende documentatie voor meer informatie:

- Naslaginformatie over beheerde MQ-connector
- Beheerde connectors in Azure Logic Apps
Verbruik Integratieserviceomgeving (ISE) Beheerde connector, die wordt weergegeven in de ontwerpfunctie onder het label Enterprise . Raadpleeg de volgende documentatie voor meer informatie:

- Naslaginformatie over beheerde MQ-connector
- Beheerde connectors in Azure Logic Apps
Standard Azure Logic Apps en App Service Environment v3 met één tenant (alleen Windows-abonnementen) Beheerde connector, die wordt weergegeven in de ontwerpfunctie onder het Azure-label , en de ingebouwde connector, die in de ontwerpfunctie wordt weergegeven onder het label Ingebouwd en is gebaseerd op een serviceprovider. De ingebouwde versie verschilt op de volgende manieren:

- De ingebouwde versie bevat acties en triggers.

- De ingebouwde versie kan rechtstreeks verbinding maken met een MQ-server en toegang krijgen tot virtuele Azure-netwerken. U hebt geen on-premises gegevensgateway nodig.

- De ingebouwde versie ondersteunt TLS-versleuteling (Transport Layer Security) voor gegevens in transit, berichtcodering voor zowel de verzend- als ontvangstbewerkingen en integratie van virtuele Azure-netwerken wanneer uw logische app gebruikmaakt van het Azure Functions Premium-abonnement

Raadpleeg de volgende documentatie voor meer informatie:

- Naslaginformatie over beheerde MQ-connector
- Naslaginformatie over ingebouwde MQ-connector
- Ingebouwde connectors in Azure Logic Apps

Beperkingen

  • De MQ-connector biedt geen ondersteuning voor gesegmenteerde berichten.

  • De MQ-connector maakt geen gebruik van het veld Format van het bericht en er worden geen tekensetconversies uitgevoerd. De connector plaatst alleen de gegevens die in het berichtveld worden weergegeven in een JSON-bericht en verzendt het bericht mee.

Raadpleeg de naslaginformatie over beheerde MQ-connectors of de naslaginformatie over de ingebouwde MQ-connector voor meer informatie.

Vereisten

  • Een Azure-account en -abonnement. Als u nog geen abonnement op Azure hebt, registreer u dan nu voor een gratis Azure-account.

  • Als u een on-premises MQ-server gebruikt, installeert u de on-premises gegevensgateway op een server in uw netwerk. De MQ-connector werkt alleen als op de server met de on-premises gegevensgateway ook .NET Framework 4.6 is geïnstalleerd.

    Nadat u de gateway hebt geïnstalleerd, moet u ook een gegevensgatewayresource maken in Azure. De MQ-connector gebruikt deze resource voor toegang tot uw MQ-server. Zie De gegevensgatewayverbinding instellen voor meer informatie.

    Notitie

    U hebt de gateway niet nodig in de volgende scenario's:

    • Uw MQ-server is openbaar beschikbaar of beschikbaar in Azure.
    • U gaat de ingebouwde MQ-connector gebruiken, niet de beheerde connector.
  • De werkstroom van de logische app waar u toegang wilt krijgen tot uw MQ-server.

    • Als u de beheerde MQ-connector gebruikt, die geen triggers biedt, moet u ervoor zorgen dat uw werkstroom al begint met een trigger of dat u eerst een trigger aan uw werkstroom toevoegt. U kunt bijvoorbeeld de trigger Terugkeerpatroon gebruiken.

    • Als u een trigger van de ingebouwde MQ-connector gebruikt, moet u beginnen met een lege werkstroom.

    • Als u de on-premises gegevensgateway gebruikt, moet uw logische app-resource dezelfde locatie gebruiken als uw gatewayresource in Azure.

Een MQ-trigger toevoegen (alleen standaard logische app)

De volgende stappen zijn alleen van toepassing op standaardwerkstromen voor logische apps, die gebruikmaken van triggers van de ingebouwde MQ-connector. De beheerde MQ-connector bevat geen triggers.

In deze stappen wordt de Azure Portal gebruikt, maar met de juiste Azure Logic Apps-extensie kunt u ook Visual Studio Code gebruiken om een standaardwerkstroom voor logische apps te maken.

  1. Open in de Azure Portal de lege werkstroom van de logische app in de ontwerpfunctie.

  2. Selecteer in de ontwerpfunctie Een bewerking kiezen als deze nog niet is geselecteerd.

  3. Selecteer in het zoekvak Kies een bewerkingde optie Ingebouwd. Voer mq in het zoekvak in.

  4. Selecteer in de lijst met triggers de MQ-trigger die u wilt gebruiken.

  5. Geef de informatie op om uw verbinding te verifiëren. Selecteer Maken als u klaar bent.

  6. Wanneer het informatievak van de trigger wordt weergegeven, geeft u de vereiste informatie voor de trigger op.

  7. Sla uw werkstroom op wanneer u klaar bent. Selecteer Opslaan op de werkbalk van de ontwerper.

Een MQ-actie toevoegen

Een werkstroom voor de logische app Verbruik kan alleen de beheerde MQ-connector gebruiken. Een standaardwerkstroom voor logische apps kan echter gebruikmaken van de beheerde MQ-connector en de ingebouwde MQ-connector. Elke versie heeft meerdere acties. Zowel beheerde als ingebouwde connectorversies hebben bijvoorbeeld hun eigen acties om door een bericht te bladeren.

  • Acties voor beheerde connectors: deze acties worden uitgevoerd in een werkstroom van een logische app Verbruik of Standaard.

  • Ingebouwde connectoracties: deze acties worden alleen uitgevoerd in een standaardwerkstroom voor logische apps.

In de volgende stappen wordt de Azure Portal gebruikt, maar met de juiste Azure Logic Apps-extensie kunt u ook de volgende hulpprogramma's gebruiken om werkstromen voor logische apps te maken:

  1. Open in de Azure Portal de werkstroom van uw logische app in de ontwerpfunctie.

  2. Voer een van deze stappen uit in de werkstroom waar u een MQ-actie wilt toevoegen:

    • Als u een actie wilt toevoegen onder de laatste stap, selecteert u Nieuwe stap.

    • Als u een actie tussen stappen wilt toevoegen, beweegt u de muisaanwijzer over de verbindingspijl zodat het plusteken (+) wordt weergegeven. Selecteer het plusteken en selecteer vervolgens Een actie toevoegen.

  3. Selecteer onder het zoekvak Kies een bewerkingde optie Onderneming. Voer mq in het zoekvak in.

  4. Selecteer in de lijst met acties de MQ-actie die u wilt gebruiken.

  5. Geef de informatie op om uw verbinding te verifiëren. Selecteer Maken als u klaar bent.

  6. Wanneer het actie-informatievak wordt weergegeven, geeft u de vereiste informatie voor uw actie op.

  7. Sla uw werkstroom op wanneer u klaar bent. Selecteer Opslaan op de werkbalk van de ontwerper.

Uw werkstroom testen

Als u wilt controleren of uw werkstroom de verwachte resultaten retourneert, voert u de werkstroom uit en bekijkt u vervolgens de uitvoer van de uitvoeringsgeschiedenis van uw werkstroom.

  1. Voer uw werkstroom uit.

    • Logische app verbruik: selecteer triggeruitvoering> uitvoeren op de werkbalk van de werkstroomontwerper.

    • Standaard logische app: selecteer Overzicht in het menu van de werkstroomresource. Selecteer op de werkbalk van het deelvenster Overzichtde optie Triggeruitvoering>uitvoeren.

    Nadat de uitvoering is voltooid, toont de ontwerpfunctie de uitvoeringsgeschiedenis van de werkstroom, samen met de status voor elke stap.

  2. Als u de invoer en uitvoer wilt bekijken voor elke stap die is uitgevoerd (niet overgeslagen), vouwt u de stap uit of selecteert u deze.

    • Als u meer invoerdetails wilt bekijken, selecteert u Onbewerkte invoer weergeven.

    • Als u meer uitvoerdetails wilt bekijken, selecteert u Onbewerkte uitvoer weergeven. Als u IncludeInfo instelt op true, wordt er meer uitvoer opgenomen.

Problemen oplossen

Fouten met blader- of ontvangstacties

Als u een blader- of ontvangstactie uitvoert op een lege wachtrij, mislukt de actie met de volgende header-uitvoer:

Schermopname van de MQ-fout 'geen bericht'.

Verbinding- en verificatieproblemen

Wanneer uw werkstroom verbinding probeert te maken met uw on-premises MQ-server, krijgt u mogelijk de volgende fout:

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

  • Als u de MQ-connector rechtstreeks in Azure gebruikt, moet de MQ-server een certificaat gebruiken dat is uitgegeven door een vertrouwde certificeringsinstantie.

  • De MQ-server vereist dat u de coderingsspecificatie definieert voor gebruik met TLS-verbindingen. Voor beveiligingsdoeleinden en om de beste beveiligingssuites op te nemen, verzendt het Windows-besturingssysteem echter een set ondersteunde coderingsspecificaties.

    Het besturingssysteem waarop de MQ-server wordt uitgevoerd, kiest de suites die moeten worden gebruikt. Als u de configuratie wilt laten overeenkomen, moet u de configuratie van de MQ-server wijzigen, zodat de coderingsspecificatie overeenkomt met de optie die is gekozen in de TLS-onderhandeling.

    Wanneer u verbinding probeert te maken, registreert de MQ-server een gebeurtenisbericht dat de verbindingspoging is mislukt omdat de MQ-server de onjuiste coderingsspecificatie heeft gekozen. Het gebeurtenisbericht bevat de coderingsspecificatie die de MQ-server in de lijst heeft gekozen. Werk in de kanaalconfiguratie de coderingsspecificatie bij zodat deze overeenkomt met de coderingsspecificatie in het gebeurtenisbericht.

Volgende stappen