Nawiązywanie połączenia z serwerem IBM MQ z przepływu pracy w usłudze Azure Logic Apps

Dotyczy: Azure Logic Apps (Zużycie + Standardowa)

Łącznik MQ ułatwia łączenie przepływów pracy aplikacji logiki z serwerem IBM MQ, który znajduje się lokalnie lub na platformie Azure. Następnie przepływy pracy mogą odbierać i wysyłać komunikaty przechowywane na serwerze MQ. Ten artykuł zawiera przewodnik wprowadzający do korzystania z łącznika MQ, pokazując, jak nawiązać połączenie z serwerem MQ i dodać akcję MQ do przepływu pracy. Możesz na przykład rozpocząć od przeglądania pojedynczego komunikatu w kolejce, a następnie wypróbowania innych akcji.

Ten łącznik zawiera Microsoft klienta MQ, który komunikuje się ze zdalnym serwerem MQ w sieci TCP/IP. Możesz nawiązać połączenie z następującymi wersjami oprogramowania IBM WebSphere MQ:

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

Dostępne operacje

  • Aplikacja logiki użycia: możesz nawiązać połączenie z serwerem MQ tylko przy użyciu zarządzanego łącznika MQ. Ten łącznik udostępnia tylko akcje, bez wyzwalaczy.

  • Standardowa aplikacja logiki: możesz nawiązać połączenie z serwerem MQ przy użyciu zarządzanego łącznika MQ, który obejmuje tylko akcje lub wbudowane operacje MQ, które obejmują wyzwalacze i akcje.

Aby uzyskać więcej informacji na temat różnicy między łącznikiem zarządzanym i wbudowanymi operacjami, zapoznaj się z kluczowymi terminami w usłudze Logic Apps.

Na poniższej liście opisano tylko niektóre operacje zarządzane dostępne dla MQ:

  • Przeglądaj pojedynczy komunikat lub tablicę komunikatów bez usuwania z serwera MQ. W przypadku wielu komunikatów można określić maksymalną liczbę komunikatów do zwrócenia na partię. W przeciwnym razie zwracane są wszystkie komunikaty.
  • Usuń pojedynczą lub tablicę komunikatów z serwera MQ.
  • Odbieranie pojedynczego komunikatu lub tablicy komunikatów, a następnie usuwanie z serwera MQ.
  • Wysyłanie pojedynczego komunikatu do serwera MQ.

Wszystkie operacje łącznika zarządzanego i inne informacje techniczne, takie jak właściwości, limity itd., przejrzyj stronę referencyjną łącznika MQ.

Ograniczenia

  • Łącznik MQ nie obsługuje komunikatów segmentowanych.

  • Łącznik MQ nie używa pola Format komunikatu i nie wykonuje konwersji zestawu znaków. Łącznik umieszcza tylko wszystkie dane wyświetlane w polu komunikatu w komunikacie JSON i wysyła komunikat.

Wymagania wstępne

  • Konto i subskrypcja platformy Azure. Jeśli nie masz subskrypcji platformy Azure, zarejestruj się w celu założenia bezpłatnego konta platformy Azure.

  • Jeśli używasz lokalnego serwera MQ, zainstaluj lokalną bramę danych na serwerze w sieci. Aby łącznik MQ działał, na serwerze z lokalną bramą danych musi być również zainstalowany .NET Framework 4.6.

    Po zainstalowaniu bramy należy również utworzyć zasób bramy danych na platformie Azure. Łącznik MQ używa tego zasobu do uzyskiwania dostępu do serwera MQ. Aby uzyskać więcej informacji, zobacz Konfigurowanie połączenia bramy danych.

    Uwaga

    Brama nie jest potrzebna w następujących scenariuszach:

    • Użyjesz wbudowanych operacji, a nie zarządzanego łącznika.
    • Serwer MQ jest publicznie dostępny lub dostępny na platformie Azure.
  • Przepływ pracy aplikacji logiki, w którym chcesz uzyskać dostęp do serwera MQ. Zasób aplikacji logiki musi mieć taką samą lokalizację jak zasób bramy na platformie Azure.

    Łącznik MQ nie ma żadnych wyzwalaczy, więc przepływ pracy musi już zaczynać się od wyzwalacza lub najpierw musisz dodać wyzwalacz do przepływu pracy. Można na przykład użyć wyzwalacza Cykl.

    Jeśli jesteś nowym użytkownikiem usługi Azure Logic Apps, wypróbuj ten przewodnik Szybki start, aby utworzyć przykładowy przepływ pracy aplikacji logiki, który działa w wielodostępnej usłudze Logic Apps.

Tworzenie połączenia MQ

Po dodaniu akcji MQ po raz pierwszy zostanie wyświetlony monit o utworzenie połączenia z serwerem MQ.

Uwaga

Łącznik MQ obsługuje obecnie tylko uwierzytelnianie serwera, a nie uwierzytelnianie klienta. Aby uzyskać więcej informacji, zobacz Problemy z połączeniem i uwierzytelnianiem.

  1. Jeśli nawiązujesz połączenie z lokalnym serwerem MQ, wybierz pozycję Połącz za pośrednictwem lokalnej bramy danych.

  2. Podaj informacje o połączeniu dla serwera MQ.

    Właściwość Lokalnie lub na platformie Azure Opis
    Bramy Tylko lokalnie Wybierz pozycję Połącz za pośrednictwem lokalnej bramy danych.
    Nazwa połączenia Oba Nazwa, która ma być używana dla połączenia
    Server (Serwer) Oba Jedną z następujących wartości:

    - Nazwa hosta serwera MQ
    - Adres IP, po którym następuje dwukropek i numer portu

    Nazwa menedżera kolejek Oba Menedżer kolejek, którego chcesz użyć
    Nazwa kanału Oba Kanał do nawiązywania połączenia z usługą Queue Manager
    Domyślna nazwa kolejki Oba Domyślna nazwa kolejki
    Połącz jako Oba Nazwa użytkownika do nawiązywania połączenia z serwerem MQ
    Nazwa użytkownika Oba Poświadczenia nazwy użytkownika
    Password (Hasło) Oba Poświadczenia hasła
    Czy włączyć protokół SSL? Tylko lokalnie Używanie protokołu Transport Layer Security (TLS) lub Secure Sockets Layer (SSL)
    Brama — subskrypcja Tylko lokalnie Subskrypcja platformy Azure skojarzona z zasobem bramy na platformie Azure
    Brama — brama połączeń Tylko lokalnie Zasób bramy do użycia

    Przykład:

    Zrzut ekranu przedstawiający szczegóły zarządzanego połączenia MQ.

  3. Gdy wszystko będzie gotowe, wybierz przycisk Utwórz.

Dodawanie akcji MQ

W usłudze Azure Logic Apps akcja jest zgodna z wyzwalaczem lub inną akcją i wykonuje pewną operację w przepływie pracy. W poniższych krokach opisano ogólny sposób dodawania akcji, na przykład Przeglądanie pojedynczego komunikatu.

  1. W Projektancie aplikacji usługi Logic Apps otwórz przepływ pracy, jeśli nie został jeszcze otwarty.

  2. W obszarze wyzwalacza lub innej akcji dodaj nowy krok.

    Aby dodać krok między istniejącymi krokami, przesuń wskaźnik myszy na strzałkę. Wybierz wyświetlony znak plus (+), a następnie wybierz pozycję Dodaj akcję.

  3. W polu wyszukiwania operacji wprowadź .mq Z listy akcji wybierz akcję o nazwie Przeglądaj komunikat.

  4. Jeśli zostanie wyświetlony monit o utworzenie połączenia z serwerem MQ, podaj żądane informacje o połączeniu.

  5. W akcji podaj wartości właściwości, których potrzebuje akcja.

    Aby uzyskać więcej właściwości, otwórz listę Dodaj nowy parametr i wybierz właściwości, które chcesz dodać.

  6. Gdy wszystko będzie gotowe, na pasku narzędzi projektanta wybierz pozycję Zapisz.

  7. Aby przetestować przepływ pracy, na pasku narzędzi projektanta wybierz pozycję Uruchom.

    Po zakończeniu przebiegu projektant pokazuje historię uruchamiania przepływu pracy wraz ze stanem kroku.

  8. Aby przejrzeć dane wejściowe i wyjściowe dla każdego kroku, który został uruchomiony (nie został pominięty), rozwiń lub wybierz krok.

    • Aby przejrzeć więcej szczegółów danych wejściowych, wybierz pozycję Pokaż nieprzetworzone dane wejściowe.
    • Aby przejrzeć więcej szczegółów danych wyjściowych, wybierz pozycję Pokaż nieprzetworzone dane wyjściowe. Jeśli ustawisz wartość IncludeInfo na true, zostanie uwzględnionych więcej danych wyjściowych.

Rozwiązywanie problemów

Błędy podczas przeglądania lub odbierania akcji

Jeśli uruchamiasz akcję przeglądania lub odbierania w pustej kolejce, akcja zakończy się niepowodzeniem z następującymi danymi wyjściowymi nagłówka:

Błąd MQ

Problemy z połączeniem i uwierzytelnianiem

Gdy przepływ pracy próbuje nawiązać połączenie z lokalnym serwerem MQ, może wystąpić następujący błąd:

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

  • Jeśli używasz łącznika MQ bezpośrednio na platformie Azure, serwer MQ musi używać certyfikatu wystawionego przez zaufany urząd certyfikacji.

  • Serwer MQ wymaga zdefiniowania specyfikacji szyfrowania do użycia z połączeniami TLS. Jednak w celach bezpieczeństwa i w celu uwzględnienia najlepszych pakietów zabezpieczeń system operacyjny Windows wysyła zestaw obsługiwanych specyfikacji szyfrowania.

    System operacyjny, w którym działa serwer MQ, wybiera pakiety do użycia. Aby dopasować konfigurację, należy zmienić konfigurację serwera MQ, aby specyfikacja szyfrowania była zgodna z opcją wybraną w negocjacjach protokołu TLS.

    Podczas próby nawiązania połączenia serwer MQ rejestruje komunikat o zdarzeniu, że próba połączenia nie powiodła się, ponieważ serwer MQ wybrał nieprawidłową specyfikację szyfrowania. Komunikat o zdarzeniu zawiera specyfikację szyfrowania wybraną z listy przez serwer MQ. W konfiguracji kanału zaktualizuj specyfikację szyfrowania, aby była zgodna ze specyfikacją szyfrowania w komunikacie zdarzenia.

Dokumentacja łączników

Wszystkie operacje w łączniku zarządzanym i inne informacje techniczne, takie jak właściwości, limity itd., przejrzyj stronę referencyjną łącznika MQ.

Następne kroki