Tutorial: Menanggapi peristiwa Azure Service Bus yang diterima melalui Azure Event Grid dengan menggunakan Azure Logic Apps

  • Artikel

Dalam tutorial ini, Anda mempelajari cara menanggapi peristiwa Azure Service Bus yang diterima melalui Azure Event Grid dengan menggunakan Azure Logic Apps.

Prasyarat

Jika Anda tidak memiliki langganan Azure, buatlah akun gratis sebelum Anda memulai.

Buat ruang nama Bus Layanan

Ikuti instruksi di tutorial ini: Mulai Cepat: Menggunakan portal Azure untuk membuat topik Bus Layanan dan berlangganan ke topik untuk melakukan tugas berikut:

  • Buat namespace Bus Layanan premium.
  • Dapatkan string koneksi.
  • Pilih topik Bus Layanan.
  • Buat langganan ke topik tersebut. Anda hanya perlu satu langganan dalam tutorial ini, jadi tidak perlu membuat langganan S2 dan S3.

Mengirim pesan ke topik Service Bus

Dalam langkah ini, Anda menggunakan aplikasi sampel untuk mengirim pesan ke topik Bus Layanan yang Anda buat di langkah sebelumnya.

  1. Kloning repositori GitHub azure-service-bus atau unduh file zip dan ekstrak file darinya.

  2. Di Visual Studio, buka folder \samples\DotNet\Azure.Messaging.ServiceBus\ServiceBusEventGridIntegrationV2, kemudian buka file SBEventGridIntegration.sln.

  3. Di jendela Penjelajah Solusi, perluas proyek MessageSender, dan pilih Program.cs.

  4. Ganti <SERVICE BUS NAMESPACE - CONNECTION STRING> dengan string koneksi ke namespace Bus Layanan Anda dan <TOPIC NAME> dengan nama topik.

    const string ServiceBusConnectionString = "<SERVICE BUS NAMESPACE - CONNECTION STRING>";
const string TopicName = "<TOPIC NAME>";

  5. Bangun dan jalankan program untuk mengirim 5 pesan pengujian (const int numberOfMessages = 5;) ke topik Bus Layanan.

    Output aplikasi konsol

Menerima pesan dengan menggunakan Logic Apps

Dalam langkah ini, Anda membuat aplikasi logika Azure yang menerima peristiwa Service Bus melalui Azure Event Grid.

  1. Pilih + Buat sumber daya, pilih Integrasi, lalu pilih Logic App.

    Cuplikan layar yang memperlihatkan menu Buat sumber daya -> Integrasi -> Aplikasi logika.

  2. Pada halaman Buat Aplikasi Logika, ikuti langkah-langkah berikut:

    1. Pilih langganan Azure Anda.
    2. Pilih Gunakan yang sudah ada untuk Grup sumber daya, dan pilih grup sumber daya yang Anda gunakan untuk sumber daya lain (seperti fungsi Azure, namespace Service Bus) yang Anda buat sebelumnya.
    3. Masukkan nama untuk aplikasi logika tersebut.
    4. Pilih Wilayah untuk aplikasi logika.
    5. Untuk Jenis paket, pilih Konsumsi.
    6. Pilih Tinjau + Buat. Cuplikan layar yang memperlihatkan halaman Buat aplikasi logika.
    7. Pada halaman Tinjau + Buat, pilih Buat untuk membuat aplikasi logika.

  3. Pada halaman Penyebaran selesai , pilih Buka sumber daya untuk menavigasi ke halaman Aplikasi logika.

  4. Pada halaman Logic Apps Designer, pilih Logic App Kosong di bawah Templat.

Menambahkan langkah menerima pesan dari Microsoft Azure Service Bus melalui Event Grid

  1. Pada halaman Aplikasi logika, pilih Perancang aplikasi logika di menu sebelah kiri.

  2. Di panel kanan, di bawah Templat, pilih Aplikasi Logika Kosong.

    Cuplikan layar yang memperlihatkan halaman Perancang aplikasi logika dengan opsi Aplikasi logika kosong dipilih.

  3. Pada perancang, lakukan langkah-langkah berikut:

    1. Cari Event Grid.

    2. Pilih Saat peristiwa sumber daya terjadi - Azure Event Grid.

      Cuplikan layar yang memperlihatkan Perancang Logic Apps dengan pemicu Event Grid dipilih.

  4. Pilih Masuk.

    Cuplikan layar yang memperlihatkan Logic Apps Designer dengan tombol Masuk dipilih.

  5. Pada halaman Masuk ke akun Anda, pilih akun yang ingin Anda gunakan untuk masuk ke Azure. 1.

  6. Pada halaman Saat peristiwa sumber daya terjadi, lakukan langkah-langkah berikut:

    1. Pilih langganan Azure Anda.

    2. Untuk Jenis Sumber Daya, pilih Microsoft.ServiceBus.Namespaces.

    3. Untuk Nama Sumber Daya, pilih namespace Service Bus Anda.

    4. Pilih Tambahkan parameter baru, pilih Filter Akhiran, lalu pindahkan fokus di luar menu drop-down.

      Cuplikan layar yang memperlihatkan penambahan parameter baru jenis filter Akhiran.

    5. Untuk Filter Akhiran, masukkan nama langganan topik Azure Service Bus Anda.

      Cuplikan layar yang memperlihatkan Perancang Logic Apps dengan konfigurasi koneksi untuk namespace Bus Layanan.

  7. Pilih + Langkah Baru dalam perancang, dan lakukan langkah-langkah berikut:

    1. Cari Service Bus.

    2. Pilih Service Bus dalam daftar.

      Cuplikan layar yang memperlihatkan pilihan Bus Layanan.

    3. Pilih untuk Mendapatkan pesan di daftar Tindakan.

    4. Pilih Ambil pesan dari langganan topik (intip-kunci).

      Cuplikan layar yang memperlihatkan Perancang Logic Apps dengan Dapatkan pesan dari langganan topik dipilih.

    5. Ikuti langkah-langkah ini:

      1. Masukkan nama untuk koneksi. Misalnya: Dapatkan pesan dari langganan topik.

      2. Konfirmasikan bahwa Jenis Autentikasi diatur ke Kunci Akses.

      3. Untuk String Koneksi ion, salin dan tempel string koneksi ke namespace Bus Layanan yang Anda simpan sebelumnya.

      4. Pilih Buat.

        Cuplikan layar yang memperlihatkan Logic Apps Designer dengan Bus Layanan string koneksi ditentukan.

    6. Pilih topik dan langganan Anda.

      Cuplikan layar yang memperlihatkan Logic Apps Designer dengan topik Bus Layanan dan langganan yang ditentukan.

Menambahkan langkah untuk memproses dan menyelesaikan pesan yang diterima

Dalam langkah ini, Anda menambahkan langkah-langkah untuk mengirim pesan yang diterima dalam email lalu menyelesaikan pesan. Dalam skenario dunia nyata, Anda memproses pesan di aplikasi logika sebelum menyelesaikan pesan.

Menambahkan perulangan ForEach

  1. Pilih + Langkah baru.

  2. Cari lalu pilih Kontrol.

    Cuplikan layar yang memperlihatkan kategori Kontrol.

  3. Di daftar Tindakan, pilih ForEach.

    Cuplikan layar yang memperlihatkan operasi Untuk setiap dipilih.

  4. Untuk Memilih output dari langkah sebelumnya (klik di dalam kotak teks jika diperlukan), pilih Isi di bawah Dapatkan pesan dari langganan topik (kunci layar).

    Cuplikan layar yang memperlihatkan pilihan Untuk setiap input.

Tambahkan langkah di dalam perulangan ForEach untuk mengirim email dengan isi pesan

  1. Di perulangan ForEach, pilih Tambah tindakan.

    Cuplikan layar yang memperlihatkan pilihan tombol Tambahkan tindakan di perulangan For-each.

  2. Di dalam kotak teks Cari konektor dan tindakan, masukkan Office 365.

  3. Pilih Office 365 Outlook dalam hasil pencarian.

    Cuplikan layar yang memperlihatkan pilihan Office 365.

  4. Di daftar tindakan, pilih Kirim email (V2).

    Cuplikan layar yang memperlihatkan pilihan Kirim operasi email.

  5. Pilih Masuk, dan ikuti langkah-langkah untuk membuat koneksi ke Office 365 Outlook.

  6. Di jendela Kirim email (V2), ikuti langkah-langkah berikut:

  7. Pilih di dalam kotak teks untuk Isi, dan ikuti langkah-langkah ini:

    1. Untuk Ke, masukkan alamat email.

    2. Untuk Subjek, masukkan Pesan yang diterima dari langganan topik Microsoft Azure Service Bus.

    3. Beralih ke Ekspresi.

    4. Masukkan ekspresi berikut:

      base64ToString(items('For_each')?['ContentData'])

    5. Pilih OK.

      Cuplikan layar yang memperlihatkan ekspresi untuk Isi aktivitas Kirim email.

Menambahkan tindakan lain dalam perulangan ForEach untuk menyelesaikan pesan

  1. Di perulangan ForEach, pilih Tambah tindakan.

    1. Pilih Microsoft Azure Service Bus di daftar Terbaru.

    2. Pilih Selesaikan pesan dalam langganan topik dari daftar tindakan.

      Cuplikan layar yang memperlihatkan pilihan Selesaikan pesan dalam langganan topik.

    3. Pilih topik Service Bus Anda.

    4. Pilih langganan ke topik tersebut.

    5. Untuk Token kunci pesan, pilih Kunci Token dari konten Dinamis.

      Cuplikan layar yang memperlihatkan bidang token kunci.

  2. Pilih Simpan pada toolbar di Logic Apps Designer untuk menyimpan aplikasi logika.

    Cuplikan layar yang memperlihatkan tombol Simpan di aplikasi Logika yang dirancang.

Menguji aplikasi

  1. Jika Anda belum mengirim pesan uji ke topik tersebut, ikuti instruksi di bagian Kirim pesan ke bagian topik Service Bus untuk mengirim pesan ke topik tersebut.

  2. Beralih ke halaman Ringkasan aplikasi logika, lalu beralih ke tab Riwayat eksekusi di panel bawah. Anda akan melihat pesan eksekusi aplikasi logika yang dikirim ke topik. Ini bisa memakan waktu beberapa menit sebelum Anda melihat aplikasi logika berjalan. Pilih Refresh pada toolbar untuk merefresh halaman.

    Cuplikan layar yang memperlihatkan riwayat eksekusi aplikasi Logika.

  3. Pilih aplikasi logika yang dijalankan untuk melihat detailnya. Perhatikan bahwa aplikasi logika memproses 5 pesan dalam untuk loop.

    Cuplikan layar yang memperlihatkan detail untuk eksekusi aplikasi logika yang dipilih.

  4. Anda harus mendapatkan email untuk setiap pesan yang diterima aplikasi logika.

    Cuplikan layar Outlook dengan pesan yang diterima dari langganan topik.

Pecahkan masalah

Jika Anda tidak melihat pemanggilan apa pun setelah menunggu dan merefresh selama beberapa saat, ikuti langkah-langkah berikut:

  1. Konfirmasikan bahwa pesan mencapai topik Service Bus. Lihat penghitung pesan masuk di halaman Topik Service Bus. Dalam hal ini, saya menjalankan aplikasi MessageSender sekali, jadi saya melihat 5 pesan.

    Cuplikan layar yang memperlihatkan halaman Topik Bus Layanan dengan jumlah pesan masuk dipilih.

  2. Konfirmasikan bahwa tidak ada pesan aktif di langganan Service Bus. Jika Anda tidak melihat aktivitas apa pun di halaman ini, verifikasi bahwa halaman Langganan Service Bus tidak memperlihatkan jumlah pesan Aktif apa pun. Jika angka untuk penghitung ini lebih besar dari nol, pesan di langganan tidak diteruskan ke fungsi handler (handler langganan aktivitas) karena alasan tertentu. Verifikasi bahwa Anda telah menyiapkan langganan aktivitas dengan benar.

    Cuplikan layar yang memperlihatkan halaman Langganan Bus Layanan dengan jumlah pesan aktif dipilih.

  3. Anda juga melihat aktivitas yang dikirimkan di halaman Aktivitas di kumpulan nama Service Bus.

    Cuplikan layar yang memperlihatkan halaman Peristiwa dari halaman namespace Bus Layanan.

  4. Anda juga dapat melihat bahwa aktivitas dikirimkan di halaman Langganan Aktivitas. Anda bisa masuk ke halaman ini dengan memilih langganan peristiwa di halaman Aktivitas.

    Cuplikan layar yang memperlihatkan halaman Langganan Peristiwa dengan jumlah peristiwa yang dikirimkan dipilih.

Langkah berikutnya