Menyambungkan ke server IBM MQ dari alur kerja Azure Logic Apps

Konektor MQ membantu Anda menyambungkan alur kerja aplikasi logika Anda ke server IBM MQ yang ada di tempat atau di Azure. Lalu, Anda dapat menerima alur kerja dan mengirim pesan yang disimpan di server MQ Anda. Artikel ini menyediakan panduan memulai menggunakan konektor MQ dengan memperlihatkan cara menyambungkan ke server MQ Anda dan menambahkan tindakan MQ ke alur kerja Anda. Contohnya, Anda dapat memulai dengan menelusuri satu pesan dalam antrean lalu mencoba tindakan lain.

Konektor ini mencakup klien Microsoft MQ yang berkomunikasi dengan server MQ jarak jauh di seluruh jaringan TCP/IP. Anda dapat menyambungkan ke versi IBM WebSphere MQ berikut:

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

Operasi yang tersedia

  • Aplikasi logika konsumsi: Anda dapat terhubung ke server MQ hanya dengan menggunakan konektor MQ terkelola. Konektor ini hanya menyediakan aksi, tanpa pemicu.

  • Aplikasi logika standar: Anda dapat terhubung ke server MQ dengan menggunakan konektor MQ terkelola, yang hanya mencakup tindakan, atau operasi MQ bawaan , yang mencakup pemicu dan tindakan.

Untuk informasi selengkapnya tentang perbedaan antara konektor terkelola dan operasi bawaan, tinjau istilah kunci di Azure Logic Apps.

Daftar berikut hanya menjelaskan beberapa operasi terkelola yang tersedia untuk MQ:

  • Telusuri satu pesan atau array pesan tanpa menghapus dari server MQ. Untuk beberapa pesan, Anda dapat menentukan jumlah maksimum pesan yang akan dikembalikan per batch. Jika tidak, semua pesan dikembalikan.
  • Menghapus satu atau array pesan dari server MQ.
  • Terima satu pesan atau array pesan lalu hapus dari server MQ.
  • Kirim satu pesan ke server MQ.

Untuk semua operasi konektor terkelola dan informasi teknis lainnya, seperti properti, batas, dan sebagainya, ulas halaman referensi konektor MQ.

Batasan

  • Konektor MQ tidak mendukung pesan tersegmentasi.

  • Konektor MQ tidak menggunakan bidang Format pesan dan tidak membuat konversi kumpulan karakter. Konektor hanya menempatkan data yang muncul di bidang pesan ke dalam pesan JSON dan mengirim pesan bersama.

Prasyarat

  • Akun dan langganan Azure. Jika Anda tidak memiliki langganan Azure, daftar akun Azure gratis.

  • Jika Anda menggunakan server MQ lokal, pasang gateway data lokal di server dalam jaringan Anda. Agar konektor MQ berfungsi, server dengan gateway data lokal juga harus memasang .NET Framework 4.6.

    Setelah memasang gateway, Anda juga harus membuat sumber daya gateway data di Azure. Konektor MQ menggunakan sumber daya ini untuk mengakses server MQ Anda. Untuk informasi selengkapnya, ulas Menyiapkan koneksi gateway data.

    Catatan

    Anda tidak memerlukan gateway dalam skenario berikut:

    • Anda akan menggunakan operasi bawaan, bukan konektor terkelola.
    • Server MQ Anda tersedia untuk umum atau tersedia di Azure.
  • Alur kerja aplikasi logika tempat Anda ingin mengakses server MQ Anda. Sumber daya aplikasi logika Anda harus memiliki lokasi yang sama dengan sumber daya gateway Anda di Azure.

    Konektor MQ tidak memiliki pemicu, sehingga alur kerja Anda harus sudah dimulai dengan pemicu, atau Anda harus terlebih dahulu menambahkan pemicu ke alur kerja Anda. Contohnya, Anda dapat menggunakan pemicu Pengulangan.

    Jika Anda baru menggunakan Azure Logic Apps, coba mulai cepat ini untuk membuat contoh alur kerja aplikasi logika, yang berjalan di layanan Aplikasi Logika beberapa penyewa.

Membuat koneksi MQ

Saat menambahkan tindakan MQ untuk pertama kali, Anda diminta untuk membuat koneksi ke server MQ Anda.

Catatan

Konektor MQ saat ini hanya mendukung autentikasi server, bukan autentikasi klien. Untuk informasi selengkapnya, lihat Masalah koneksi dan autentikasi.

  1. Jika Anda menyambungkan ke server MQ lokal, pilih Sambungkan melalui gateway data lokal.

  2. Berikan informasi koneksi untuk server MQ Anda.

    Properti Lokal atau Azure Deskripsi
    Gateway Khusus lokal Pilih Sambungkan melalui gateway data lokal.
    Nama koneksi Keduanya Nama yang digunakan untuk sambungan Anda
    Server Keduanya Salah satu nilai berikut:

    - Nama host server MQ
    - Alamat IP diikuti oleh titik dua dan nomor port

    nama Pengelola Antrean Keduanya Pengelola Antrean yang ingin Anda gunakan
    Nama saluran Keduanya Saluran untuk menyambungkan ke Pengelola Antrean
    Nama antrean default Keduanya Nama default untuk antrean
    Sambungkan Sebagai Keduanya Nama pengguna untuk menyambungkan ke server MQ
    Nama pengguna Keduanya Informasi masuk nama pengguna
    Kata sandi Keduanya Informasi masuk kata sandi
    Aktifkan SSL? Khusus lokal Gunakan Transport Layer Security (TLS) atau Secure Sockets Layer (SSL)
    Gateway - Langganan Khusus lokal Langganan Azure yang terkait dengan sumber daya gateway Anda di Azure
    Gateway - Gateway Koneksi Khusus lokal Sumber daya gateway yang akan digunakan

    Contohnya:

    Screenshot showing the managed MQ connection details.

  3. Jika sudah selesai, pilih Buat.

Tambah tindakan MQ

Di Azure Logic Apps, tindakan mengikuti pemicu atau tindakan lain dan melakukan beberapa operasi di alur kerja Anda. Langkah-langkah berikut menjelaskan cara umum untuk menambah tindakan, misalnya, Menelusuri satu pesan.

  1. Di Perancang Azure Logic Apps, buka alur kerja Anda, jika belum dibuka.

  2. Di bawah pemicu atau tindakan lain, tambah langkah baru.

    Untuk menambah langkah di antara langkah-langkah yang sudah ada, gerakkan mouse Anda di atas panah. Pilih tanda plus (+) yang muncul, lalu pilih Tambahkan tindakan.

  3. Dalam kotak pencarian operasi, masukkan mq. Dari daftar tindakan, pilih tindakan bernama Telusuri pesan.

  4. Jika Anda diminta untuk membuat koneksi ke server MQ Anda, berikan informasi koneksi yang diminta.

  5. Dalam tindakan, berikan nilai properti yang dibutuhkan tindakan.

    Untuk properti lainnya, buka daftar Tambahkan parameter baru, dan pilih properti yang ingin Anda tambahkan.

  6. Setelah selesai, pilih Simpan di toolbar alat perancang.

  7. Untuk memulai alur kerja Anda secara manual, pilih Jalankan di bar alat perancang.

    Setelah proses selesai, desainer memperlihatkan riwayat jalankan alur kerja bersama dengan status untuk langkah.

  8. Untuk meninjau input dan output untuk setiap langkah yang berjalan (tidak dilewati), perluas atau pilih langkah.

    • Untuk meninjau detail input lainnya, pilih Perlihatkan input mentah.
    • Untuk meninjau detail output lainnya, pilih Tampilkan output mentah. Jika Anda mengatur IncludeInfo ke true, lebih banyak output disertakan.

Memecahkan masalah

Kegagalan dengan tindakan penelusuran atau terima

Jika Anda menjalankan tindakan telusuri atau terima pada antrean kosong, tindakan gagal dengan output header berikut:

MQ

Masalah koneksi dan autentikasi

Saat alur kerja Anda mencoba menyambungkan ke server MQ lokal Anda, Anda mungkin mendapatkan kesalahan ini:

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

  • Jika Anda menggunakan konektor MQ langsung di Azure, server MQ perlu menggunakan sertifikat yang dikeluarkan oleh otoritas sertifikat tepercaya.

  • Server MQ mengharuskan Anda menentukan spesifikasi cipher untuk digunakan dengan koneksi TLS. Namun, untuk tujuan keamanan dan memasukkan suite keamanan terbaik, sistem operasi Windows mengirimkan serangkaian spesifikasi cipher yang didukung.

    Sistem operasi tempat server MQ berjalan memilih suite untuk digunakan. Untuk membuat konfigurasi cocok, Anda harus mengubah pengaturan server MQ Anda sehingga spesifikasi cipher cocok dengan opsi yang dipilih dalam negosiasi TLS.

    Ketika Anda mencoba untuk terhubung, server MQ mencatat pesan kejadian bahwa upaya koneksi gagal karena server MQ memilih spesifikasi cipher yang salah. Pesan peristiwa terdiri atas spesifikasi cipher yang dipilih server MQ dari daftar. Dalam konfigurasi saluran, perbarui spesifikasi cipher agar sesuai dengan spesifikasi cipher dalam pesan kejadian.

Referensi konektor

Untuk semua operasi konektor terkelola dan informasi teknis lainnya, seperti properti, batas, dan sebagainya, ulas halaman referensi konektor MQ.

Langkah berikutnya