Azure Logic Apps'ten bir IBM MQ sunucuya bağlanınConnect to an IBM MQ server from Azure Logic Apps

IBM MQ bağlayıcı gönderir ve bir IBM MQ server şirket içinde veya Azure'da depolanan iletilerini alır.The IBM MQ connector sends and retrieves messages stored in an IBM MQ server on premises or in Azure. Bu bağlayıcı bir TCP/IP ağı üzerinden uzak bir IBM MQ sunucusu ile iletişim kuran bir Microsoft MQ client içerir.This connector includes a Microsoft MQ client that communicates with a remote IBM MQ server across a TCP/IP network. Bu makalede MQ bağlayıcıyı kullanmak üzere bir başlangıç kılavuzu sağlanmaktadır.This article provides a starter guide to use the MQ connector. Bir iletinin kuyrukta göz atarak başlayın ve diğer eylemler deneyin.You can start by browsing a single message on a queue and then try other actions.

IBM MQ Bağlayıcısı'nı bu eylemleri içerir, ancak hiçbir Tetikleyiciler sağlar:The IBM MQ connector includes these actions but provides no triggers:

  • Tek bir ileti IBM MQ sunucudan ileti silmeden göz atın.Browse a single message without deleting the message from the IBM MQ server
  • Toplu iletiler IBM MQ sunucudan iletileri silmeden göz atın.Browse a batch of messages without deleting the messages from the IBM MQ server
  • Tek bir ileti alırsınız ve IBM MQ sunucudan ileti SilReceive a single message and delete the message from the IBM MQ server
  • Toplu olarak mesaj alır ve IBM MQ sunucudan iletileri silReceive a batch of messages and delete the messages from the IBM MQ server
  • IBM MQ sunucunun tek bir ileti gönderinSend a single message to the IBM MQ server

ÖnkoşullarPrerequisites

  • Bir şirket içi MQ server kullanıyorsanız, şirket içi veri ağ geçidi yükleme ağınızdaki bir sunucuda.If you're using an on-premises MQ server, install the on-premises data gateway on a server within your network. Ayrıca, şirket içi veri ağ geçidinin yüklü olduğu sunucunun çalışması için .NET Framework 4.6 MQ bağlayıcı için yüklü olması gerekir.The server where the on-premises data gateway is installed must also have .NET Framework 4.6 installed for the MQ connector to work. Ayrıca, Azure'da şirket içi veri ağ geçidi için bir kaynak oluşturmalısınız.You must also create a resource in Azure for the on-premises data gateway. Daha fazla bilgi için veri ağ geçidi bağlantısı kurma.For more information, see Set up the data gateway connection.

    Ancak, MQ server'ınıza Azure kapsamında sunulan veya genel olarak kullanılabilir, data gateway kullanın gerekmez.However, if your MQ server is publicly available or available within Azure, you don't have to use the data gateway.

  • Resmi olarak desteklenen IBM WebSphere MQ sürümleri:Officially supported IBM WebSphere MQ versions:

    • MQ 7.5MQ 7.5
    • MQ 8.0MQ 8.0
    • MQ 9.0MQ 9.0
  • MQ eylem eklemek istediğiniz mantıksal uygulaması.The logic app where you want to add the MQ action. Bu mantıksal uygulama, şirket içi veri ağ geçidi bağlantınızı konumun aynısını kullanmanız gerekir ve iş akışınızı başlatan bir tetikleyici zaten olması gerekir.This logic app must use the same location as your on-premises data gateway connection and must already have a trigger that starts your workflow.

    Mantıksal uygulamanızı ilk kez bir tetikleyici eklemelisiniz MQ Bağlayıcısı'nı hiçbir tetikleyici yok.The MQ connector doesn't have any triggers, so you must add a trigger to your logic app first. Örneğin, yinelenme tetikleyicisini kullanabilirsiniz.For example, you can use the Recurrence trigger. Logic apps kullanmaya yeni başladıysanız, bu deneyin ilk mantıksal uygulamanızı oluşturmak için Hızlı Başlangıç.If you're new to logic apps, try this quickstart to create your first logic app.

Tek bir ileti GözatBrowse a single message

  1. Tetikleyici veya başka bir eylem altında mantıksal uygulamanızı seçin yeni adım.In your logic app, under the trigger or another action, choose New step.

  2. Arama kutusuna "mq" yazın ve şu eylemi seçin: İleti GözatIn the search box, type "mq", and select this action: Browse message

    İleti Gözat

  3. Varolan MQ bağlantısı yoksa, bağlantıyı oluşturun:If you don't have an existing MQ connection, create the connection:

    1. Eylem seçin şirket içi veri ağ geçidi üzerinden Bağlan.In the action, select Connect via on-premises data gateway.

    2. MQ server'ınız için özelliklerini girin.Enter the properties for your MQ server.

      İçin sunucu, MQ server adını veya IP adresini bir iki nokta üst üste ve bağlantı noktası numarası girin.For Server, you can enter the MQ server name, or enter the IP address followed by a colon and the port number.

    3. Açık ağ geçidi herhangi daha önce yapılandırılmış ağ geçidi bağlantıları gösteren bir liste.Open the gateway list, which shows any previously configured gateway connections. Ağ geçidi seçin.Select your gateway.

    4. İşiniz bittiğinde Oluştur’u seçin.When you're done, choose Create.

      Bağlantınız şu örnekteki gibi görünür:Your connection looks like this example:

      Bağlantı özellikleri

  4. Eylemin özelliklerini ayarlayın:Set up the action's properties:

    • Kuyruk: Bağlantıyı farklı bir kuyruk belirtin.Queue: Specify a queue that's different from the connection.

    • MessageID, Correlationıd, GroupIDve diğer özellikleri: Farklı MQ ileti özelliklerine bağlı olarak bir ileti için GözatMessageId, CorrelationId, GroupId, and other properties: Browse for a message based on the different MQ message properties

    • IncludeInfo: Belirtin True çıktısında ek ileti bilgileri içerecek şekilde.IncludeInfo: Specify True to include additional message information in the output. Ya da belirtin False ek ileti bilgileri çıktısında içermeyecek şekilde.Or, specify False to not include additional message information in the output.

    • Zaman aşımı: Bir ileti, boş bir kuyrukta gelmesi için beklenecek süreyi belirlemek için bir değer girin.Timeout: Enter a value to determine how long to wait for a message to arrive in an empty queue. Hiçbir şey girilirse, sıradaki ilk iletiye alınır ve görüntülenecek bir ileti için beklerken geçen hiçbir zaman yoktur.If nothing is entered, the first message in the queue is retrieved, and there is no time spent waiting for a message to appear.

      İleti özelliklerini göz atın

  5. Kaydet yaptığınız değişiklikleri ve ardından çalıştırma mantıksal uygulamanızı.Save your changes, and then Run your logic app.

    Kaydet ve Çalıştır

    Çalıştırmanız tamamlandıktan sonra çalıştırma adımları gösterilir ve çıktıyı gözden geçirin.After the run finishes, the steps from the run are shown, and you can review the output.

  6. Her bir adımın ayrıntılarını gözden geçirmek için yeşil onay işaretini seçin.To review the details for each step, choose the green checkmark. Daha fazla bilgi için çıktı verilerini gözden geçirmek için seçin ham çıkışları görüntüleyin.To review more information about the output data, choose Show raw outputs.

    İleti çıkış Gözat

    Bazı örnek ham çıktı aşağıdaki gibidir:Here is some sample raw output:

    İleti ham çıkış Gözat

  7. Ayarlarsanız IncludeInfo true olarak, aşağıdaki çıkış görüntülenir:If you set IncludeInfo to true, the following output is displayed:

    Göz atma iletiyi bilgisi Ekle

Birden çok ileti GözatBrowse multiple messages

Gözat iletileri eylemi içeren bir BatchSize kaç iletileri kuyruktan döndürülmesi gerektiğini belirtmek için seçeneği.The Browse messages action includes a BatchSize option to indicate how many messages should be returned from the queue. Varsa BatchSize herhangi bir giriş tüm iletileri döndürülür.If BatchSize has no entry, all messages are returned. Döndürülen çıkış iletileri dizisidir.The returned output is an array of messages.

  1. Eklediğinizde Gözat iletileri eylemi, önceden yapılandırılmış bağlantı varsayılan olarak seçilen ilk.When you add the Browse messages action, the first previously configured connection is selected by default. Yeni bir bağlantı oluşturmak için seçin Bağlantıyı Değiştir.To create a new connection, choose Change connection. Ya da farklı bir bağlantı seçin.Or, select a different connection.

  2. Mantık uygulaması Çalıştır bittikten sonra bazı örnek çıktısı şöyledir Gözat iletileri eylem:After the logic app run finishes, here is some sample output from the Browse messages action:

    İletileri çıkış Gözat

Tek bir ileti alırsınız.Receive single message

Alma ileti eylem aynı giriş yapılmış ve olarak çıkaran Gözat ileti eylem.The Receive message action has the same inputs and outputs as the Browse message action. Kullanırken alma ileti, ileti kuyruktan silinir.When using Receive message, the message is deleted from the queue.

Birden çok ileti almaReceive multiple messages

İletileri alma eylem aynı giriş yapılmış ve olarak çıkaran Gözat iletileri eylem.The Receive messages action has the same inputs and outputs as the Browse messages action. Kullanırken iletileri alma, iletileri kuyruktan silinir.When using Receive messages, the messages are deleted from the queue.

Adım varsa ileti kuyrukta bir göz atın veya alma işlemi yapılırken, bu Çıktıyı ile başarısız olur:If there are no messages in the queue when doing a browse or a receive, the step fails with this output:

MQ yok, hata iletisi

İleti GönderSend message

Eklediğinizde ileti gönderme eylemi, önceden yapılandırılmış bağlantı varsayılan olarak seçilen ilk.When you add the Send messages action, the first previously configured connection is selected by default. Yeni bir bağlantı oluşturmak için seçin Bağlantıyı Değiştir.To create a new connection, choose Change connection. Ya da farklı bir bağlantı seçin.Or, select a different connection.

  1. Geçerli ileti türünü seçin: Veri birimi, yanıt, veya isteSelect a valid message type: Datagram, Reply, or Request

    Msg özellikler Gönder

  2. Mantıksal uygulama çalışmayı tamamladıktan sonra bazı örnek çıktısı şöyledir ileti gönder eylem:After the logic app finishes running, here is some sample output from the Send message action:

    Çıkış iletisi gönder

Bağlayıcı başvurusuConnector reference

Eylemler ve sınırları hakkında teknik ayrıntılar için bağlayıcının Openapı'nin açıklanmıştır (önceki adıyla Swagger) açıklama, bağlayıcının gözden başvuru sayfası.For technical details about actions and limits, which are described by the connector's OpenAPI (formerly Swagger) description, review the connector's reference page.

Sonraki adımlarNext steps