Azure Logic Apps'de bir iş akışından IBM MQ sunucusuna bağlanma

MQ bağlayıcısı, mantıksal uygulama iş akışlarınızı şirket içinde veya Azure'da bulunan bir IBM MQ sunucusuna bağlamanıza yardımcı olur. Bundan sonra iş akışlarınızı MQ sunucunuzda depolanan iletileri alıtabilir ve gönderebilirsiniz. Bu makalede, MQ sunucunuza bağlanmayı ve iş akışınıza bir MQ eylemi eklemeyi göstererek MQ bağlayıcısı kullanmaya başlama kılavuzu ve sağlar. Örneğin, bir kuyrukta tek bir iletiye göz atarak başlayabilir ve ardından diğer eylemleri denemeniz gerekir.

Bu bağlayıcı, TCP/IP ağı üzerinden uzak bir MQ sunucusuyla iletişim kuran bir Microsoft MQ istemcisi içerir. Aşağıdaki IBM WebSphere MQ sürümlerine bağlanebilirsiniz:

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

Kullanılabilir işlemler

  • Çok kiracılı Azure Logic Apps: Mantıksal Uygulama (Tüketim) kaynağı ekleyebilirsiniz, bir MQ sunucusuna yalnızca yönetilen MQ bağlayıcısı kullanarak bağlanabilirsiniz. Bu bağlayıcı yalnızca eylemler sağlar, tetikleyici yoktur.

  • Tek kiracılı Azure Logic Apps: Tek kiracılı tabanlı mantıksal uygulama iş akışı ekleyebilirsiniz. Yönetilen MQ bağlayıcısı kullanarak MQ sunucusuna bağlanabilirsiniz. Bu bağlayıcı yalnızca eylemleri veya tetikleyicileri ve eylemleri içeren yerleşik MQ işlemlerini içerir.

Yönetilen bağlayıcı ile yerleşik işlemler arasındaki fark hakkında daha fazla bilgi için, Logic Apps.

Aşağıdaki listede MQ için kullanılabilen yönetilen işlemlerden yalnızca bazıları açıkmektedir:

  • MQ sunucusundan silmeden tek bir iletiye veya bir ileti dizisine göz atma. Birden çok ileti için, toplu iş başına en fazla ileti sayısını belirtebilirsiniz. Aksi takdirde, tüm iletiler döndürülür.
  • MQ sunucusundan tek bir veya bir ileti dizisini silin.
  • Tek bir ileti veya bir ileti dizisi alır ve MQ sunucusundan siler.
  • MQ sunucusuna tek bir ileti gönderin.

Tüm yönetilen bağlayıcı işlemleri ve özellikler, sınırlar gibi diğer teknik bilgiler için MQ bağlayıcısı başvuru sayfasını gözden geçirebilirsiniz.

Sınırlamalar

MQ bağlayıcısı iletinin Biçim alanını kullanmaz ve herhangi bir karakter kümesi dönüştürmesi yapmaz. Bağlayıcı, ileti alanında görünen verileri yalnızca bir JSON iletisine koyar ve iletiyi birlikte gönderir.

Önkoşullar

  • Bir Azure hesabı ve aboneliği Azure aboneliğiniz yoksa ücretsiz bir Azure hesabı için kaydolun.

  • Şirket içi MQ sunucusu kullanıyorsanız şirket içi veri ağ geçidini ağınız içindeki bir sunucuya yükleyin. MQ bağlayıcının çalışması için şirket içi veri ağ geçidine sahip sunucuda da 4.6 .NET Framework yüklü olması gerekir.

    Ağ geçidini yükledikten sonra Azure 'da bir veri ağ geçidi kaynağı da oluşturmanız gerekir. MQ Bağlayıcısı, MQ sunucunuza erişmek için bu kaynağı kullanır. Daha fazla bilgi için veri ağ geçidi bağlantısını ayarlamakonusunu gözden geçirin.

    Not

    Aşağıdaki senaryolarda ağ geçidine ihtiyacınız yoktur:

    • Yönetilen bağlayıcıyı değil yerleşik işlemleri kullanacaksınız.
    • MQ Server, Azure 'da genel kullanıma sunuldu veya kullanılabilir.
  • MQ sunucunuza erişmek istediğiniz mantıksal uygulama iş akışı. Mantıksal uygulama kaynağınız, Azure 'daki ağ geçidi kaynağınız ile aynı konuma sahip olmalıdır.

    MQ bağlayıcısının hiçbir tetikleyicisi yoktur, bu nedenle iş akışınız bir tetikleyiciyle başlamalıdır ya da ilk olarak iş akışınıza bir tetikleyici eklemeniz gerekir. Örneğin, yinelenme tetikleyicisinikullanabilirsiniz.

    Azure Logic Apps yeni başladıysanız, çok kiracılı Logic Apps hizmetinde çalışan örnek bir mantıksal uygulama iş akışı oluşturmak için bu hızlıbaşlangıcı deneyin.

MQ bağlantısı oluşturma

İlk kez bir MQ eylemi eklediğinizde, MQ sunucunuza bir bağlantı oluşturmanız istenir.

Not

MQ Bağlayıcısı Şu anda yalnızca sunucu kimlik doğrulamasını destekler, istemci kimlik doğrulamasını desteklememektedir. Daha fazla bilgi için bkz. bağlantı ve kimlik doğrulama sorunları.

  1. Şirket içi MQ sunucusuna bağlanıyorsanız Şirket içi veri ağ geçidi üzerinden Bağlan' ı seçin.

  2. MQ sunucunuz için bağlantı bilgilerini sağlayın.

    Özellik Şirket içi veya Azure Description
    Ağ geçitleri Yalnızca şirket içi Şirket içi veri ağ geçidi üzerinden Bağlan ' ı seçin.
    Bağlantı adı Her İkisi Bağlantınız için kullanmak istediğiniz ad
    Sunucu Her İkisi Aşağıdaki değerlerden biri:

    - MQ sunucusu ana bilgisayar adı
    - IP adresi ve ardından iki nokta üst üste ve bağlantı noktası numarası

    Kuyruk Yöneticisi adı Her İkisi Kullanmak istediğiniz Kuyruk Yöneticisi
    Kanal adı Her İkisi Kuyruk Yöneticisi'ne bağlanmak için kanal
    Varsayılan kuyruk adı Her İkisi Kuyruk için varsayılan ad
    Farklı Bağlan Her İkisi MQ sunucusuna bağlanmak için kullanıcı adı
    Kullanıcı adı Her İkisi Kullanıcı adı kimlik bilgileriniz
    Parola Her İkisi Parola kimlik bilgileriniz
    SSL etkinleştir mi? Yalnızca şirket içi Aktarım Katmanı Güvenliği (TLS) veya Güvenli Yuva Katmanı (SSL) kullanma
    Ağ Geçidi - Abonelik Yalnızca şirket içi Azure'da ağ geçidi kaynağınız ile ilişkili Azure aboneliği
    Ağ Geçidi - Bağlantı Ağ Geçidi Yalnızca şirket içi Kullanılacak ağ geçidi kaynağı

    Örnek:

    Yönetilen MQ bağlantı ayrıntılarını gösteren ekran görüntüsü.

  3. İşiniz bittiğinde Oluştur'u seçin.

MQ eylemi ekleme

Azure Logic Apps, bir eylem tetikleyiciden veya başka bir eyleme uyar ve iş akışınızda bazı işlemleri gerçekleştirir. Aşağıdaki adımlar, bir eylem eklemenin genel yolunu anlatmaktadır, örneğin tek bir Iletiye gözatın.

  1. Logic Apps tasarımcısında, zaten açık değilse, iş akışınızı açın.

  2. Tetikleyici veya başka bir eylem altında yeni bir adım ekleyin.

    Mevcut adımlar arasında bir adım eklemek için farenizi ok üzerine taşıyın. Görüntülenen artı işaretini (+) seçin ve ardından Eylem Ekle' yi seçin.

  3. İşlem arama kutusuna girin mq . Eylemler listesinden, gözatmış ileti adlı eylemi seçin.

  4. MQ sunucunuza bir bağlantı oluşturmanız istenirse, istenen bağlantı bilgilerini sağlayın.

  5. Eylemde, eylemin ihtiyacı olan özellik değerlerini sağlayın.

    Daha fazla özellik için yeni parametre Ekle listesini açın ve eklemek istediğiniz özellikleri seçin.

  6. İşiniz bittiğinde, Tasarımcı araç çubuğunda Kaydet' i seçin.

  7. İş akışınızı test etmek için tasarımcı araç çubuğunda Çalıştır' ı seçin.

    Çalıştırma bittikten sonra tasarımcı, iş akışının çalışma geçmişini adım durumuyla birlikte gösterir.

  8. Çalıştırılan (atlanan) her adımın giriş ve çıkışlarını gözden geçirmek için, adımı genişletin veya seçin.

    • Daha fazla giriş ayrıntılarını gözden geçirmek için Ham girdileri göster' i seçin.
    • Daha fazla çıkış ayrıntılarını gözden geçirmek için Ham çıkışları göster' i seçin. Includeınfo değerini true olarak ayarlarsanız daha fazla çıktı bulunur.

Sorunları giderme

Tarama veya alma eylemleriyle ilgili sorunlar

Boş bir kuyruk üzerinde bir tarama veya alma eylemi çalıştırırsanız, eylem aşağıdaki üstbilgi çıkışları ile başarısız olur:

MQ "ileti yok" hatası

Bağlantı ve kimlik doğrulaması sorunları

İş akışınız şirket içi MQ sunucunuza bağlanmaya çalıştığında şu hatayı alabilirsiniz:

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

  • MQ bağlayıcısını doğrudan Azure'da kullanıyorsanız, MQ sunucusunun güvenilen bir sertifika yetkilisi tarafından verilen bir sertifikayı kullanması gerekir.

  • MQ sunucusu, TLS bağlantılarıyla kullanmak için şifreleme belirtimi tanımlamanız gerekir. Ancak, windows işletim sistemi, güvenlik amacıyla ve en iyi güvenlik paketlerini dahil etmek için desteklenen bir dizi şifreleme belirtimleri gönderir.

    MQ sunucusunun çalıştır olduğu işletim sistemi, kullanmak üzere paketleri seçer. Yapılandırma eşleşmesini yapmak için MQ sunucusu kurulumlarınızı, şifreleme belirtimi TLS anlaşmasında belirlenen seçenekle eşılacak şekilde değiştirebilirsiniz.

    Bağlanmaya çalışırken, MQ sunucusu bağlantı girişiminin başarısız olduğunu çünkü MQ sunucusunun yanlış şifreleme belirtimlerini seçtiğini bir olay iletisi kaydeder. Olay iletisi, MQ sunucusunun listeden seçtiği şifreleme belirtimlerini içerir. Kanal yapılandırmasında, şifreleme belirtimlerini olay iletisinde şifreleme belirtimleri ile eş olacak şekilde güncelleştirin.

Bağlayıcı başvurusu

Yönetilen bağlayıcıda yapılan tüm işlemler ve özellikler, sınırlar gibi diğer teknik bilgiler için MQ bağlayıcısı başvuru sayfasını gözden geçirebilirsiniz.

Sonraki adımlar