Csatlakozás IBM MQ-kiszolgálóhoz egy munkafolyamatból a Azure Logic Apps

Az MQ-összekötővel összekapcsolhatja a logikai alkalmazás munkafolyamatait egy helyszíni vagy Azure-beli IBM MQ-kiszolgálóval. Ezután a munkafolyamatok az MQ-kiszolgálón tárolt üzeneteket fogadhatják és küldhetik el. Ez a cikk bevezető útmutatót nyújt az MQ-összekötő használatának folyamatához, és bemutatja, hogyan csatlakozhat az MQ-kiszolgálóhoz, és hogyan adhat hozzá MQ-műveletet a munkafolyamathoz. Kezdésként például egy üzenetsorban böngészhet, majd más műveleteket is kipróbálhat.

Ez az összekötő tartalmaz egy Microsoft MQ-ügyfelet, amely tcp/IP-hálózaton keresztül kommunikál egy távoli MQ-kiszolgálóval. A következő IBM WebSphere MQ-verziókhoz csatlakozhat:

  • MQ 7.5
  • MQ 8.0
  • MQ 9.0, 9.1 és 9.2

Elérhető műveletek

  • Több-bérlős Azure Logic Apps: Logikaialkalmazás-erőforrás létrehozásakor csak a felügyelt MQ-összekötővel csatlakozhat egy MQ-kiszolgálóhoz. Ez az összekötő csak műveleteket biztosít, eseményindítókat nem.

  • Egybérlős Azure Logic Apps: Egybérlős logikaialkalmazás-munkafolyamat létrehozásakor csatlakozhat egy MQ-kiszolgálóhoz a felügyelt MQ-összekötővel, amely csak műveleteket tartalmaz, vagy a beépített MQ-műveleteket, amelyek eseményindítókat és műveleteket tartalmaznak.

A felügyelt összekötők és a beépített műveletek közötti különbségekkel kapcsolatos további információkért tekintse át a legfontosabb kifejezéseket a Logic Apps.

Az alábbi lista csak néhányat ismertet az MQ-hez elérhető felügyelt műveletek közül:

  • Egyetlen üzenet vagy üzenettömb tallózása az MQ-kiszolgálóról való törlés nélkül. Több üzenet esetén megadhatja a kötegenként visszavetni kívánt üzenetek maximális számát. Ellenkező esetben a rendszer az összes üzenetet visszaadja.
  • Töröljön egy vagy több üzenettömböt az MQ-kiszolgálóról.
  • Egyetlen üzenet vagy üzenettömb fogadása, majd törlése az MQ-kiszolgálóról.
  • Egyetlen üzenet küldése az MQ-kiszolgálónak.

Az MQ-összekötőreferenciaoldalán minden felügyelt összekötőműveletet és egyéb technikai információt (például tulajdonságokat, korlátokat stb.)

Korlátozások

Az MQ-összekötő nem használja az üzenet Formátum mezőjét, és nem hoz létre semmilyen karakterkészlet-konverziót. Az összekötő csak az üzenetmezőben megjelenő adatokat helyezi egy JSON-üzenetbe, és elküldi az üzenetet.

Előfeltételek

  • Azure-fiók és -előfizetés. Ha nem rendelkezik Azure-előfizetéssel, regisztráljon egy ingyenes Azure-fiókra.

  • Ha helyszíni MQ-kiszolgálót használ, telepítse a helyszíni adatátjárót a hálózaton belüli kiszolgálóra. Ahhoz, hogy az MQ-összekötő működjön, a helyszíni adatátjáróval ellátott kiszolgálónak a 4.6-os .NET-keretrendszer is telepítve kell lennie.

    Az átjáró telepítése után létre kell hoznia egy adatátjáró-erőforrást is az Azure-ban. Az MQ-összekötő ezt az erőforrást használja az MQ-kiszolgáló eléréséhez. További információ: Adatátjáró-kapcsolat beállítása.

    Megjegyzés

    Az átjáróra a következő esetekben nincs szükség:

    • A beépített műveleteket fogja használni, nem a felügyelt összekötőt.
    • Az MQ-kiszolgáló nyilvánosan elérhető vagy elérhető az Azure-ban.
  • A logikai alkalmazás munkafolyamata, ahol hozzá szeretne férni az MQ-kiszolgálóhoz. A logikai alkalmazás erőforrásának és az Azure-beli átjáró-erőforrásnak ugyanannak a helynek kell lennie.

    Az MQ-összekötő nem rendelkezik eseményindítókkal, ezért vagy a munkafolyamatnak már egy eseményindítóval kell kezdődnie, vagy először hozzá kell adni egy eseményindítót a munkafolyamathoz. Használhatja például az Ismétlődés eseményindítót.

    Ha még nem használja a Azure Logic Apps, próbálja ki ezt a rövid útmutatót egy példa logikaialkalmazás-munkafolyamat létrehozásához, amely a több-bérlős Logic Apps fut.

MQ-kapcsolat létrehozása

Amikor először ad hozzá MQ-műveletet, a rendszer arra kéri, hogy hozzon létre egy kapcsolatot az MQ-kiszolgálóval.

Megjegyzés

Az MQ-összekötő jelenleg csak a kiszolgálói hitelesítést támogatja, az ügyfél-hitelesítést nem. További információ: Csatlakozási és hitelesítési problémák.

  1. Ha helyszíni MQ-kiszolgálóhoz csatlakozik, válassza a Csatlakozás helyszíni adatátjárón keresztül lehetőséget.

  2. Adja meg az MQ-kiszolgáló kapcsolati adatait.

    Tulajdonság Helyszíni vagy Azure Description
    Átjárók Csak helyszíni Válassza a Csatlakozás helyszíni adatátjárón keresztül lehetőséget.
    Kapcsolat neve Mindkettő A kapcsolathoz használni szükséges név
    Kiszolgáló Mindkettő Az alábbi értékek valamelyike:

    - MQ-kiszolgáló állomásneve
    – IP-cím, majd kettőspont és portszám

    Üzenetsor-kezelő neve Mindkettő A használni kívánt Üzenetsor-kezelő
    Csatorna neve Mindkettő A Queue Managerhez való csatlakozás csatornája
    Alapértelmezett üzenetsornév Mindkettő Az üzenetsor alapértelmezett neve
    Csatlakozás másként Mindkettő Az MQ-kiszolgálóhoz való csatlakozáshoz használt felhasználónév
    Felhasználónév Mindkettő A felhasználónév hitelesítő adatai
    Jelszó Mindkettő A jelszó hitelesítő adatai
    Engedélyezi az SSL-t? Csak helyszíni A Transport Layer Security (TLS) vagy a SSL (SSL) használata
    Átjáró – Előfizetés Csak helyszíni Az Azure-beli átjáró-erőforráshoz társított Azure-előfizetés
    Átjáró – Kapcsolatátjáró Csak helyszíni A használni szükséges átjáró-erőforrás

    Például:

    Képernyőkép a felügyelt MQ-kapcsolat részleteiről.

  3. Ha elkészült, válassza a Létrehozás lehetőséget.

MQ-művelet hozzáadása

Ebben Azure Logic Apps művelet követi az eseményindítót vagy egy másik műveletet, és valamilyen műveletet hajt végre a munkafolyamatban. A következő lépések a művelet hozzáadásának általános módját ismertetik, például egyetlen üzenet tallózása.

  1. A Logic Apps Designerben nyissa meg a munkafolyamatot, ha még nincs megnyitva.

  2. Az eseményindító vagy egy másik művelet alatt adjon hozzá egy új lépést.

    Ha lépést szeretne hozzáadni a meglévő lépések között, helyezze az egeret a nyílra. Válassza a megjelenő pluszjelet (+), majd a Művelet hozzáadása lehetőséget.

  3. A művelet keresőmezőbe írja be a következőt: mq . A műveletek listájából válassza ki a Browse message (Üzenet tallózása) nevű műveletet.

  4. Ha a rendszer arra kéri, hogy hozzon létre egy kapcsolatot az MQ-kiszolgálóval, adja meg a kért kapcsolati adatokat.

  5. A műveletben adja meg a művelethez szükséges tulajdonságértékeket.

    További tulajdonságokért nyissa meg az Új paraméter hozzáadása listát, és válassza ki a hozzáadni kívánt tulajdonságokat.

  6. Ha végzett, a tervező eszköztárán válassza a Mentés lehetőséget.

  7. A munkafolyamat teszteléséhez a tervező eszköztárán válassza a Futtatás lehetőséget.

    A futtatás befejezése után a tervező megjeleníti a munkafolyamat futtatáselőzményeket, valamint a lépés állapotát.

  8. Az egyes (nem kihagyott) lépés bemenetének és kimenetének áttekintéséhez bontsa ki vagy válassza ki a lépést.

    • További bemeneti adatok áttekintéséhez válassza a Nyers bemenetek megjelenítése lehetőséget.
    • A kimenet további részleteinek áttekintéshez válassza a Nyers kimenetek megjelenítése lehetőséget. Ha az IncludeInfo true (igaz) értékre van állítva, több kimenetet is tartalmaz.

Problémák elhárítása

Hibák a tallózási vagy fogadási műveletekkel

Ha üres üzenetsoron futtat tallózási vagy fogadási műveletet, a művelet a következő fejléckimenetekkel meghiúsul:

MQ "nincs üzenet" hiba

Csatlakozási és hitelesítési problémák

Amikor a munkafolyamat megpróbál csatlakozni a helyszíni MQ-kiszolgálóhoz, a következő hibaüzenet jelenhet meg:

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

  • Ha az MQ-összekötőt közvetlenül az Azure-ban használja, az MQ-kiszolgálónak egy megbízható hitelesítésszolgáltató által kiadott tanúsítványt kell használnia.

  • Az MQ-kiszolgáló megköveteli, hogy meghatározza a TLS-kapcsolatokhoz használt titkosítási specifikációt. Biztonsági okokból és a legjobb biztonsági csomagok közé való felvételéhez azonban a Windows operációs rendszer a támogatott titkosítási specifikációk egy halmazát küldi el.

    Az MQ-kiszolgálót üzemeltető operációs rendszer választja ki a használni használt csomagokat. A konfiguráció egyeztetéséhez módosítania kell az MQ-kiszolgáló beállítását, hogy a titkosítási specifikáció megfeleljen a TLS-egyeztetésben kiválasztott beállításnak.

    Amikor megpróbál csatlakozni, az MQ-kiszolgáló egy eseményüzenetet naplóz, amely szerint a kapcsolódási kísérlet meghiúsult, mert az MQ-kiszolgáló helytelen titkosítási specifikációt választott. Az eseményüzenet tartalmazza az MQ-kiszolgáló által a listában kiválasztott titkosítási specifikációt. A csatorna konfigurációjában frissítse a titkosítási specifikációt úgy, hogy megfeleljen az eseményüzenetben található titkosítási specifikációnak.

Összekötő-referencia

A felügyelt összekötő összes műveletét és egyéb technikai információkat, például tulajdonságokat, korlátokat stb., tekintse át az MQ-összekötő referenciaoldalát.

Következő lépések