Nawiązywanie połączenia z serwerem IBM MQ z przepływu pracy w programie Azure Logic AppsConnect to an IBM MQ server from a workflow in Azure Logic Apps

Łącznik MQ ułatwia łączenie przepływów pracy aplikacji logiki z serwerem IBM MQ, który działa lokalnie lub na platformie Azure.The MQ connector helps you connect your logic app workflows to an IBM MQ server that's either on premises or in Azure. Następnie przepływy pracy mogą odbierać i wysyłać komunikaty przechowywane na serwerze MQ.You can then have your workflows receive and send messages stored in your MQ server. Ten artykuł zawiera przewodnik wprowadzenie do korzystania z łącznika MQ, w którym pokazano, jak nawiązać połączenie z serwerem MQ i dodać akcję MQ do przepływu pracy.This article provides a get started guide to using the MQ connector by showing how to connect to your MQ server and add an MQ action to your workflow. Na przykład możesz rozpocząć od przeglądania pojedynczego komunikatu w kolejce, a następnie spróbować wykonać inne akcje.For example, you can start by browsing a single message in a queue and then try other actions.

Ten łącznik zawiera klienta MQ firmy Microsoft, który komunikuje się ze zdalnym serwerem MQ za pomocą sieci TCP/IP.This connector includes a Microsoft MQ client that communicates with a remote MQ server across a TCP/IP network. Możesz nawiązać połączenie z następującymi wersjami oprogramowania IBM WebSphere MQ:You can connect to the following IBM WebSphere MQ versions:

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

Dostępne operacjeAvailable operations

Łącznik IBM MQ udostępnia akcje, ale nie wyzwalacze.The IBM MQ connector provides actions but no triggers.

  • Wielodostępne Azure Logic Apps: podczas tworzenia przepływu pracy aplikacji logiki opartej na użyciu można nawiązać połączenie z serwerem MQ przy użyciu zarządzanego łącznika MQ.Multi-tenant Azure Logic Apps: When you create a consumption-based logic app workflow, you can connect to an MQ server by using the managed MQ connector.

  • Tryb Azure Logic Apps dzierżawy (wersja zapoznawcza): podczas tworzenia przepływu pracy aplikacji logiki w wersji zapoznawczej można nawiązać połączenie z serwerem MQ przy użyciu zarządzanego łącznika MQ lub wbudowanych operacji MQ (wersja zapoznawcza).Single-tenant Azure Logic Apps (preview): When you create a preview logic app workflow, you can connect to an MQ server by using either the managed MQ connector or the built-in MQ operations (preview).

Aby uzyskać więcej informacji o różnicach między łącznikiem zarządzanym a operacjami wbudowanymi, zapoznaj się z kluczowymiterminami w Logic Apps .For more information about the difference between a managed connector and built-in operations, review key terms in Logic Apps.

Na poniższej liście opisano tylko niektóre operacje zarządzane dostępne dla usługi MQ:The following list describes only some of the managed operations available for MQ:

  • Przeglądaj pojedynczy komunikat lub tablicę komunikatów bez usuwania z serwera MQ.Browse a single message or an array of messages without deleting from the MQ server. W przypadku wielu komunikatów można określić maksymalną liczbę komunikatów do zwrócenia na partię.For multiple messages, you can specify the maximum number of messages to return per batch. W przeciwnym razie zostaną zwrócone wszystkie komunikaty.Otherwise, all messages are returned.
  • Usuń pojedynczą lub tablicę komunikatów z serwera MQ.Delete a single or an array of messages from the MQ server.
  • Odbierz jeden komunikat lub tablicę komunikatów, a następnie usuń go z serwera MQ.Receive a single message or an array of messages and then delete from the MQ server.
  • Wyślij pojedynczy komunikat do serwera MQ.Send a single message to the MQ server.

Wszystkie operacje łącznika zarządzanego i inne informacje techniczne, takie jak właściwości, limity itp., można znaleźć na stronie referencyjnej łącznika MQ.For all the managed connector operations and other technical information, such as properties, limits, and so on, review the MQ connector's reference page.

OgraniczeniaLimitations

Łącznik MQ nie używa pola Format komunikatu i nie dokona żadnych konwersji zestawu znaków.The MQ connector doesn't use the message's Format field and doesn't make any character set conversions. Łącznik umieszcza tylko dane wyświetlane w polu komunikatu w komunikacie JSON i wysyła komunikat.The connector only puts whatever data appears in the message field into a JSON message and sends the message along.

Wymagania wstępnePrerequisites

  • Konto i subskrypcja platformy Azure.An Azure account and subscription. Jeśli nie masz subskrypcji platformy Azure, zarejestruj się w celu założenia bezpłatnego konta platformy Azure.If you don't have an Azure subscription, sign up for a free Azure account.

  • Jeśli używasz lokalnego serwera MQ, zainstaluj lokalną bramę danych na serwerze w sieci.If you're using an on-premises MQ server, install the on-premises data gateway on a server within your network. Aby łącznik MQ działał, serwer z lokalną bramą danych również musi mieć zainstalowaną .NET Framework 4.6.For the MQ connector to work, the server with the on-premises data gateway also must have .NET Framework 4.6 installed.

    Po zainstalowaniu bramy należy również utworzyć zasób bramy danych na platformie Azure.After you install the gateway, you must also create a data gateway resource in Azure. Łącznik MQ używa tego zasobu do uzyskiwania dostępu do serwera MQ.The MQ connector uses this resource to access your MQ server. Aby uzyskać więcej informacji, zapoznaj się z tematem Konfigurowanie połączenia bramy danych.For more information, review Set up the data gateway connection.

    Uwaga

    Brama nie jest potrzebna w następujących scenariuszach:You don't need the gateway in the following scenarios:

    • Użyjemy operacji wbudowanych, a nie łącznika zarządzanego.You're going to use the built-in operations, not the managed connector.
    • Serwer MQ jest publicznie dostępny lub dostępny na platformie Azure.Your MQ server is publicly available or available in Azure.
  • Przepływ pracy aplikacji logiki, w którym chcesz uzyskać dostęp do serwera MQ.The logic app workflow where you want to access your MQ server. Zasób aplikacji logiki musi mieć tę samą lokalizację co zasób bramy na platformie Azure.Your logic app resource must have the same location as your gateway resource in Azure.

    Łącznik MQ nie ma żadnych wyzwalaczy, dlatego przepływ pracy musi już rozpoczynać się od wyzwalacza lub najpierw musisz dodać wyzwalacz do przepływu pracy.The MQ connector doesn't have any triggers, so either your workflow must already start with a trigger, or you first have to add a trigger to your workflow. Można na przykład użyć wyzwalacza Cykl.For example, you can use the Recurrence trigger.

    Jeśli jesteś nowym użytkownikom 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 usłudze wielodostępnej Logic Apps service.If you're new to Azure Logic Apps, try this quickstart to create an example logic app workflow, which runs in the multi-tenant Logic Apps service.

Tworzenie połączenia MQCreate an MQ connection

Podczas dodawania akcji MQ po raz pierwszy zostanie wyświetlony monit o utworzenie połączenia z serwerem MQ.When you add an MQ action for the first time, you're prompted to create a connection to your MQ server.

Uwaga

Łącznik MQ obecnie obsługuje tylko uwierzytelnianie serwera, a nie uwierzytelnianie klienta.The MQ connector currently supports only server authentication, not client authentication. Aby uzyskać więcej informacji, zobacz Problemy z połączeniem i uwierzytelnianiem.For more information, see Connection and authentication problems.

  1. Jeśli łączysz się z lokalnym serwerem MQ, wybierz pozycję Połącz za pośrednictwem lokalnej bramy danych.If you're connecting to an on-premises MQ server, select Connect via on-premises data gateway.

  2. Podaj informacje o połączeniu dla serwera MQ.Provide the connection information for your MQ server.

    WłaściwośćProperty Lokalnie lub na platformie AzureOn-premises or Azure OpisDescription
    BramyGateways Tylko lokalnieOn-premises only Wybierz pozycję Połącz za pośrednictwem lokalnej bramy danych.Select Connect via on-premises data gateway.
    Nazwa połączeniaConnection name ObaBoth Nazwa do użycia dla połączeniaThe name to use for your connection
    Server (Serwer)Server ObaBoth Jedną z następujących wartości:Either of the following values:

    - Nazwa hosta serwera MQ- MQ server host name
    - Adres IP, po którym następuje dwukropek i numer portu- IP address followed by a colon and the port number

    Nazwa menedżera kolejekQueue Manager name ObaBoth Menedżer kolejek, którego chcesz użyćThe Queue Manager that you want to use
    Nazwa kanałuChannel name ObaBoth Kanał do łączenia się z menedżerem kolejekThe channel for connecting to the Queue Manager
    Domyślna nazwa kolejkiDefault queue name ObaBoth Domyślna nazwa kolejkiThe default name for the queue
    Połącz jakoConnect As ObaBoth Nazwa użytkownika do nawiązywania połączenia z serwerem MQThe username for connecting to the MQ server
    Nazwa użytkownikaUsername ObaBoth Poświadczenie nazwy użytkownikaYour username credential
    Password (Hasło)Password ObaBoth Twoje poświadczenie hasłaYour password credential
    Czy włączyć protokół SSL?Enable SSL? Tylko lokalnieOn-premises only Używanie Transport Layer Security (TLS) lub Secure Sockets Layer (SSL)Use Transport Layer Security (TLS) or Secure Sockets Layer (SSL)
    Brama — subskrypcjaGateway - Subscription Tylko lokalnieOn-premises only Subskrypcja platformy Azure skojarzona z zasobem bramy na platformie AzureThe Azure subscription associated with your gateway resource in Azure
    Brama — brama połączeńGateway - Connection Gateway Tylko lokalnieOn-premises only Zasób bramy do użyciaThe gateway resource to use

    Na przykład:For example:

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

  3. Gdy wszystko będzie gotowe, wybierz przycisk Utwórz.When you're done, select Create.

Dodawanie akcji MQAdd an MQ action

W Azure Logic Apps akcja następuje po wyzwalaczu lub innej akcji i wykonuje pewne operacje w przepływie pracy.In Azure Logic Apps, an action follows the trigger or another action and performs some operation in your workflow. W poniższych krokach opisano ogólny sposób dodawania akcji, na przykład Przeglądanie pojedynczego komunikatu.The following steps describe the general way to add an action, for example, Browse a single message.

  1. W programie Logic Apps Designer otwórz przepływ pracy, jeśli nie został jeszcze otwarty.In the Logic Apps Designer, open your workflow, if not already open.

  2. W obszarze wyzwalacza lub innej akcji dodaj nowy krok.Under the trigger or another action, add a new step.

    Aby dodać krok między istniejącymi krokami, przesuń wskaźnik myszy na strzałkę.To add a step between existing steps, move your mouse over the arrow. Wybierz wyświetlony znak plus (+), a następnie wybierz pozycję Dodaj akcję.Select the plus sign (+) that appears, and then select Add an action.

  3. W polu wyszukiwania operacji wprowadź mq .In the operation search box, enter mq. Z listy akcji wybierz akcję o nazwie Przeglądaj komunikat.From the actions list, select the action named Browse message.

  4. Jeśli zostanie wyświetlony monit o utworzenie połączenia z serwerem MQ, podaj żądane informacje o połączeniu.If you're prompted to create a connection to your MQ server, provide the requested connection information.

  5. W akcji podaj wartości właściwości, których potrzebuje akcja.In the action, provide the property values that the action needs.

    Aby uzyskać więcej właściwości, otwórz listę Dodaj nowy parametr i wybierz właściwości, które chcesz dodać.For more properties, open the Add new parameter list, and select the properties that you want to add.

  6. Gdy wszystko będzie gotowe, na pasku narzędzi projektanta wybierz pozycję Zapisz.When you're done, on the designer toolbar, select Save.

  7. Aby przetestować przepływ pracy, na pasku narzędzi projektanta wybierz pozycję Uruchom.To test your workflow, on the designer toolbar, select Run.

    Po zakończeniu uruchamiania projektant pokazuje historię uruchamiania przepływu pracy wraz ze stanem kroku.After the run finishes, the designer shows the workflow's run history along with the status for step.

  8. Aby przejrzeć dane wejściowe i wyjściowe dla każdego kroku, który został uruchomiony (bez pominięcia), rozwiń lub wybierz krok.To review the inputs and outputs for each step that ran (not skipped), expand or select the step.

    • Aby przejrzeć więcej szczegółów wejściowych, wybierz pozycję Pokaż nieprzetworzone dane wejściowe.To review more input details, select Show raw inputs.
    • Aby przejrzeć więcej szczegółów danych wyjściowych, wybierz pozycję Pokaż nieprzetworzone dane wyjściowe.To review more output details, select Show raw outputs. Jeśli ustawisz dla includeinfo wartość true, zostanie uwzględnionych więcej danych wyjściowych.If you set IncludeInfo to true, more output is included.

Rozwiązywanie problemówTroubleshoot problems

Błędy związane z akcjami przeglądania lub odbieraniaFailures with browse or receive actions

Jeśli uruchamiasz akcję przeglądania lub odbierania w pustej kolejce, akcja kończy się niepowodzeniem z następującymi danych wyjściowych nagłówka:If you run a browse or receive action on an empty queue, the action fails with the following header outputs:

Błąd MQ "brak komunikatu"

Problemy z połączeniem i uwierzytelnianiemConnection and authentication problems

Gdy przepływ pracy próbuje połączyć się z lokalnym serwerem MQ, może wystąpić ten błąd:When your workflow tries connecting to your on-premises MQ server, you might get this error:

"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żyć certyfikatu wystawionego przez zaufany urząd certyfikacji.If you're using the MQ connector directly in Azure, the MQ server needs to use a certificate that's issued by a trusted certificate authority.

  • Serwer MQ wymaga zdefiniowania specyfikacji szyfrowania do użycia z połączeniami TLS.The MQ server requires that you define the cipher specification to use with TLS connections. Jednak ze względów bezpieczeństwa i w celu dołączyć najlepsze pakiety zabezpieczeń system operacyjny Windows wysyła zestaw obsługiwanych specyfikacji szyfrowania.However, for security purposes and to include the best security suites, the Windows operating system sends a set of supported cipher specifications.

    System operacyjny, w którym działa serwer MQ, wybiera pakiety do użycia.The operating system where the MQ server runs chooses the suites to use. Aby dopasować konfigurację, musisz zmienić konfigurację serwera MQ tak, aby specyfikacja szyfru była dopasowana do opcji wybranej podczas negocjacji TLS.To make the configuration match, you have to change your MQ server setup so that the cipher specification matches the option chosen in the TLS negotiation.

    Podczas próby nawiązania połączenia serwer MQ rejestruje komunikat o zdarzeniu informujący o tym, że próba połączenia nie powiodła się, ponieważ serwer MQ wybrał nieprawidłową specyfikację szyfrowania.When you try to connect, the MQ server logs an event message that the connection attempt failed because the MQ server chose the incorrect cipher specification. Komunikat zdarzenia zawiera specyfikację szyfrowania wybraną przez serwer MQ z listy.The event message contains the cipher specification that the MQ server chose from the list. W konfiguracji kanału zaktualizuj specyfikację szyfrowania, aby dopasować specyfikację szyfrowania w komunikacie zdarzenia.In the channel configuration, update the cipher specification to match the cipher specification in the event message.

Dokumentacja łącznikówConnector reference

W przypadku wszystkich operacji w łączniku zarządzanym i innych informacji technicznych, takich jak właściwości, limity itp., zapoznaj się ze stroną referencyjną łącznika MQ.For all the operations in the managed connector and other technical information, such as properties, limits, and so on, review the MQ connector's reference page.

Następne krokiNext steps