Mulai cepat: Membuat alur kerja Konsumsi di Azure Logic Apps multipenyewa dengan menggunakan Visual Studio Code

Berlaku pada: Azure Logic Apps (Konsumsi)

Sebagai pengembang integrasi, Anda sering kali perlu mengotomatiskan proses bisnis di seluruh aplikasi SaaS, sistem perusahaan, dan sumber data tanpa mengelola infrastruktur. Anda juga memerlukan pendekatan berbasis kode untuk membangun alur kerja sehingga Anda dapat memversi definisi, menyusun pembaruan, dan meninjau perubahan secara efisien.

Mulai cepat ini menunjukkan cara membuat dan mengelola alur kerja konsumsi di Azure Logic Apps multipenyewa dengan menggunakan alat lokal berbasis kode di Visual Studio Code. Alur kerja konsumsi menyediakan model integrasi tanpa server untuk alur kerja berbasis peristiwa dan terjadwal, sehingga Anda dapat menghubungkan layanan dan mengotomatiskan proses sambil membayar hanya untuk tindakan yang berjalan.

Di Visual Studio Code, Anda dapat mengedit definisi alur kerja di JavaScript Object Notation (JSON) dengan menggunakan editor kode, menggunakan desainer visual saat diperlukan, dan mengelola alur kerja yang disebarkan di Azure. Anda juga dapat mengerjakan alur kerja dan akun integrasi dari platform pengembangan apa pun tempat Visual Studio Code berjalan, seperti Linux, Windows, dan macOS.

Cuplikan layar berikut menunjukkan bagaimana contoh definisi alur kerja Konsumsi mungkin terlihat:

Untuk informasi selengkapnya, lihat:

• Apa itu Azure Logic Apps
• Penyewa tunggal versus multipenyewa di Azure Logic Apps.

Prasyarat

• Akun dan langganan Azure. Dapatkan akun Azure gratis.

• Pengetahuan dasar tentang definisi alur kerja aplikasi logika dan strukturnya dalam format JSON.

  Contoh dalam artikel ini membuat alur kerja aplikasi logika yang sama seperti dalam mulai cepat ini yang lebih berfokus pada konsep dasar. Anda juga dapat belajar membuat dan mengelola alur kerja melalui Azure CLI.

• Akses ke web untuk masuk ke Azure dan langganan Azure Anda.

• Unduh dan instal alat berikut, jika Anda belum memilikinya:

  • Visual Studio Code versi 1.25.1 atau yang lebih baru, yang gratis.

  • Ekstensi Visual Studio Code untuk Azure Logic Apps (Konsumsi).

    1. Instal ekstensi ini dari Visual Studio Marketplace atau langsung dari dalam Visual Studio Code.

       

    2. Muat ulang Visual Studio Code setelah penginstalan.

    Untuk informasi selengkapnya, lihat Extension Marketplace. Untuk berkontribusi pada versi sumber terbuka ekstensi ini, kunjungi ekstensi Azure Logic Apps untuk Visual Studio Code di GitHub.

• Jika alur kerja aplikasi logika Anda perlu berkomunikasi melalui firewall yang membatasi lalu lintas ke alamat IP tertentu, firewall harus mengizinkan akses untuk alamat IP masuk dan keluar yang digunakan oleh Azure Logic Apps atau runtime di wilayah Azure tempat alur kerja aplikasi logika Anda berada.

  Jika alur kerja aplikasi logika Anda juga menggunakan konektor terkelola, seperti konektor Office 365 Outlook atau konektor SQL, atau menggunakan konektor kustom, firewall harus mengizinkan akses untuk semuaalamat IP keluar konektor terkelola di wilayah Azure aplikasi logika Anda.

Mengakses Azure dari Visual Studio Code

1. Di Visual Studio Code, masuk ke akun Azure Anda.

   Jika masuk membutuhkan waktu lebih lama dari biasanya, Visual Studio Code meminta Anda untuk masuk melalui situs web autentikasi Microsoft dengan memberi Anda kode perangkat. Untuk masuk dengan menggunakan kode sebagai gantinya, ikuti langkah-langkah berikut:

   1. Pilih Gunakan Kode Perangkat, lalu pilih Salin & Buka.

   2. Pilih Buka Tautan untuk membuka jendela browser baru dan lanjutkan ke situs web autentikasi.

   3. Di halaman Masuk ke akun Anda, masukkan kode autentikasi Anda, dan pilih Berikutnya.

2. Pada bilah Aktivitas, pilih ikon Azure.

   

   Di panel Azure, bagian Logic Apps (Konsumsi) dan Akun Integrasi sekarang menampilkan langganan Azure yang terkait dengan akun Anda. Jika Anda tidak melihat langganan yang Anda harapkan, atau jika bagian menampilkan terlalu banyak langganan, ikuti langkah-langkah berikut:

   1. Di bagian Logic Apps (Konsumsi) , pilih Pilih Langganan.

      

   2. Dari daftar langganan, pilih langganan yang ingin Anda gunakan.

3. Di bagian Logic Apps (Konsumsi) , perluas langganan Anda untuk melihat aplikasi logika yang disebarkan dalam langganan tersebut.

   

Membuat aplikasi logika

1. Di Visual Studio Code, pada bagian Logic Apps (Konsumsi), dari menu pintasan untuk langganan, pilih Buat Aplikasi Logika.

   

   Daftar muncul dan memperlihatkan grup sumber daya Azure apa pun di langganan Anda.

2. Dari daftar grup sumber daya, pilih Buat grup sumber daya baru atau grup sumber daya yang sudah ada.

   Untuk contoh ini, pilih Buat grup sumber daya baru, misalnya:

   

3. Masukkan nama untuk grup sumber daya Azure Anda.

   

4. Pilih wilayah Azure tempat menyimpan metadata aplikasi logika.

   

5. Masukkan nama untuk aplikasi logika Anda.

   

   Di jendela Azure, di bawah langganan Azure Anda, aplikasi logika baru dan alur kerja kosong Anda muncul. Visual Studio Code juga membuka file JSON (.logicapp.json), yang menyertakan definisi alur kerja kerangka, misalnya:

   

   Anda sekarang dapat mulai menulis definisi alur kerja Anda secara manual dalam file JSON ini. Untuk referensi teknis tentang struktur dan sintaks definisi alur kerja, lihat Skema Bahasa Definisi Alur Kerja untuk Azure Logic Apps.

   Contoh definisi alur kerja aplikasi logika berikut dimulai dengan pemicu RSS dan tindakan Outlook Office 365. Biasanya, elemen JSON muncul menurut abjad di setiap bagian. Namun, sampel ini menunjukkan elemen-elemen ini kira-kira dalam urutan munculnya operasi alur kerja di perancang.

   {
      "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
      "contentVersion": "1.0.0.0",
      "parameters": {
         "$connections": {
            "defaultValue": {},
            "type": "Object"
         }
      },
      "triggers": {
         "When_a_feed_item_is_published": {
            "recurrence": {
               "frequency": "Minute",
               "interval": 30
            },
            "splitOn": "@triggerBody()?['value']",
            "type": "ApiConnection",
            "inputs": {
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['rss']['connectionId']"
                  }
               },
               "method": "get",
               "path": "/OnNewFeed",
               "queries": {
                  "feedUrl": "@{encodeURIComponent('https://feeds.content.dowjones.io/public/rss/RSSMarketsMain')}",
                  "sinceProperty": "PublishDate"
               }
            }
         }
      },
      "actions": {
         "Send_an_email_(V2)": {
            "runAfter": {},
            "type": "ApiConnection",
            "inputs": {
               "body": {
                  "Body": "<p>Title: @{triggerBody()?['title']}<br>\n<br>\nDate published: @{triggerBody()?['updatedOn']}<br>\n<br>\nLink: @{triggerBody()?['primaryLink']}</p>",
                  "Subject": "RSS item: @{triggerBody()?['title']}",
                  "To": "sophia-owen@fabrikam.com"
               },
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['office365']['connectionId']"
                  }
               },
               "method": "post",
               "path": "/v2/Mail"
            }
         }
      },
      "outputs": {}
   }
   

   Penting

   Untuk memanfaatkan kembali definisi alur kerja sampel ini, Anda memerlukan akun kerja atau sekolah organisasi—misalnya, @fabrikam.com. Pastikan Anda mengganti alamat email fiktif dengan alamat email Anda sendiri.

   Untuk menggunakan konektor email yang berbeda, seperti Outlook.com atau Gmail, ganti Send_an_email_action tindakan dengan tindakan serupa yang tersedia dari konektor email yang didukung Azure Logic Apps.

   Jika ingin menggunakan konektor Gmail, hanya akun bisnis G-Suite yang dapat menggunakan konektor ini tanpa pembatasan di Logic App. Jika Anda memiliki akun konsumen Gmail, Anda dapat menggunakan konektor ini hanya dengan layanan tertentu yang disetujui Google, atau membuat aplikasi klien Google untuk digunakan untuk autentikasi dengan konektor Gmail Anda. Untuk informasi selengkapnya, lihatKebijakan keamanan dan privasi data untuk konektor Google di Azure Logic Apps.

6. Setelah selesai, simpan definisi alur kerja. (File>Simpan atau tekan Ctrl+S).

7. Saat Anda diminta untuk mengunggah definisi alur kerja aplikasi logika ke langganan Azure Anda, pilih Unggah.

   Langkah ini menerbitkan definisi alur kerja aplikasi logika Anda dari Visual Studio Code ke portal Microsoft Azure, yang membuat alur kerja aktif dan berjalan di Azure.

   

Menampilkan alur kerja di perancang

Di Visual Studio Code, Anda dapat membuka alur kerja aplikasi logika dalam tampilan desain baca-saja. Meskipun Anda tidak dapat mengedit definisi alur kerja di perancang, Anda dapat memeriksa alur kerja Anda secara visual dengan menggunakan tampilan perancang.

Di jendela Azure, pada bagian Logic Apps (Konsumsi), dari menu pintasan aplikasi logika Anda, pilih Buka di Designer.

Perancang baca-saja terbuka di tab terpisah dan memperlihatkan alur kerja aplikasi logika, misalnya:

Menampilkan alur kerja di portal Microsoft Azure

Untuk meninjau definisi alur kerja aplikasi logika Anda di portal Microsoft Azure, ikuti langkah-langkah berikut:

1. Di portal Microsoft Azure, masuk dengan menggunakan akun Azure dan langganan yang sama yang terkait dengan aplikasi logika Anda.

2. Di kotak pencarian portal Microsoft Azure, masukkan nama aplikasi logika. Dari daftar hasil, pilih aplikasi logika.

   

3. Pada bilah sisi aplikasi logika, di bawah Alat Pengembangan, buka alur kerja dalam tampilan perancang atau kode.

Mengedit aplikasi logika yang disebarkan

Di Visual Studio Code, Anda dapat membuka dan mengedit definisi alur kerja untuk sumber daya aplikasi logika yang sudah disebarkan di Azure.

Penting

Sebelum Anda mengedit alur kerja aplikasi logika yang berjalan secara aktif dalam produksi, minimalkan gangguan dan hindari risiko merusak alur kerja dengan terlebih dahulu menonaktifkan sumber daya aplikasi logika Anda.

1. Di Visual Studio Code, pada bilah Aktivitas, pilih ikon Azure.

2. Di jendela Azure, di bagian Logic Apps (Konsumsi), perluas langganan Azure Anda, dan pilih aplikasi logika yang Anda inginkan.

3. Dari menu pintasan aplikasi logika, pilih Buka di Editor. Atau, di samping nama aplikasi logika, pilih ikon edit.

   

   Visual Studio Code membuka file .logicapp.json di folder sementara lokal sehingga Anda dapat melihat definisi alur kerja.

   

4. Buat perubahan Anda dalam file definisi alur kerja.

5. Setelah selesai, simpan perubahan Anda (Simpan> atau tekan Ctrl+S).

6. Saat Anda diminta untuk mengunggah perubahan dan menimpa alur kerja aplikasi logika yang ada di portal Microsoft Azure, pilih Unggah.

   Langkah ini menerbitkan pembaruan Anda ke sumber daya aplikasi logika Anda di portal Microsoft Azure.

   

Menampilkan atau mempromosikan versi lain

Di Visual Studio Code, Anda dapat membuka dan meninjau versi sebelumnya untuk alur kerja aplikasi logika Anda. Anda juga dapat mempromosikan versi yang lebih lama ke versi saat ini.

Penting

Sebelum Anda mengubah alur kerja aplikasi logika yang berjalan secara aktif dalam produksi, minimalkan gangguan dan hindari risiko merusak aplikasi logika tersebut dengan terlebih dahulu menonaktifkan sumber daya aplikasi logika Anda.

1. Di jendela Azure, di bagian Logic Apps (Konsumsi), perluas langganan Azure Anda untuk melihat aplikasi logika terkait.

2. Pada langganan Anda, perluas aplikasi logika Anda, dan perluas Versi.

   Daftar Versi menampilkan versi aplikasi logika sebelumnya, jika ada.

   

3. Untuk melihat versi yang lebih lama, pilih salah satu langkah berikut:

   • Untuk melihat definisi JSON, pada Versi, pilih nomor versi untuk definisi tersebut. Atau, dari menu pintasan versi, pilih Buka di Editor.

     File baru terbuka di komputer lokal Anda dan menunjukkan definisi JSON versi tersebut.

   • Untuk melihat versi di perancang baca-saja, dari menu pintasan versi, pilih Buka di Perancang.

4. Untuk mempromosikan versi yang lebih lama ke versi saat ini, ikuti langkah-langkah berikut:

   1. Di bawah Versi, dari menu pintasan versi sebelumnya, pilih Promosikan.

      

   2. Untuk melanjutkan setelah Visual Studio Code meminta konfirmasi Anda, pilih Ya.

      Visual Studio Code mempromosikan versi yang dipilih ke versi saat ini dan menetapkan nomor baru ke versi yang dipromosikan. Versi sebelumnya saat ini sekarang muncul pada versi yang dipromosikan.

Menonaktifkan atau mengaktifkan aplikasi logika

Di Visual Studio Code, jika Anda mengedit alur kerja aplikasi logika yang diterbitkan dan menyimpan perubahan, Anda menimpa aplikasi logika yang sudah disebarkan. Untuk menghindari merusak alur kerja aplikasi logika Anda dalam produksi dan meminimalkan gangguan, nonaktifkan sumber daya aplikasi logika Anda terlebih dahulu. Setelah mengonfirmasi alur kerja masih berfungsi seperti yang diharapkan, Anda dapat mengaktifkan kembali sumber daya aplikasi logika.

Menonaktifkan atau mengaktifkan sumber daya aplikasi logika memengaruhi instans alur kerja dengan cara berikut:

• Azure Logic Apps melanjutkan menjalankan alur kerja yang sedang berlangsung dan yang tertunda sampai selesai. Berdasarkan volume atau backlog, proses ini mungkin membutuhkan waktu untuk menyelesaikannya.

• Azure Logic Apps tidak membuat atau menjalankan instans alur kerja baru.

• Pemicu tidak diaktifkan lain kali kondisinya terpenuhi.

• Status pemicu mengingat titik di mana alur kerja berhenti. Jadi, jika Anda mengaktifkan kembali aplikasi logika, pemicu akan diaktifkan untuk item apa pun yang belum diproses sejak eksekusi terakhir.

  Untuk menghentikan pemicu menembak pada item yang tidak diproses ini, sebelum Anda mengaktifkan kembali sumber daya aplikasi logika, hapus status pemicu:

  1. Di alur kerja, edit bagian mana pun dari pemicu.
  2. Simpan perubahan Anda. Langkah ini mengatur ulang status pemicu saat ini.
  3. Aktifkan kembali sumber daya aplikasi logika Anda.

• Saat sumber daya aplikasi logika dinonaktifkan, Anda masih dapat mengirim ulang eksekusi alur kerja.

Untuk menonaktifkan atau mengaktifkan sumber daya aplikasi logika di Visual Studio Code, ikuti langkah-langkah berikut:

1. Di Visual Studio Code, buka jendela Azure.

2. Di bagian Logic Apps (Konsumsi), perluas langganan Azure Anda untuk melihat aplikasi logika terkait.

3. Untuk menonaktifkan sumber daya aplikasi logika, dari menu pintasan aplikasi logika, pilih Nonaktifkan.

   

4. Saat Anda siap untuk mengaktifkan kembali sumber daya aplikasi logika, dari menu pintasan aplikasi logika, pilih Aktifkan.

   

Menghapus aplikasi logika

Menghapus aplikasi logika mempengaruhi instans alur kerja dengan cara berikut:

• Azure Logic Apps mencoba membatalkan semua alur kerja yang sedang berlangsung dan yang masih tertunda.

  Bahkan dengan volume besar atau backlog, sebagian besar eksekusi dibatalkan sebelum selesai atau dimulai. Namun, proses pembatalan mungkin membutuhkan waktu untuk menyelesaikannya. Sementara itu, layanan mungkin menjalankan beberapa tugas selama proses pembatalan berlangsung.

• Azure Logic Apps tidak membuat atau menjalankan instans alur kerja baru.

• Jika Anda menghapus alur kerja lalu membuat ulang alur kerja yang sama, alur kerja yang dibuat ulang memiliki metadata yang berbeda. Anda perlu menyimpan ulang alur kerja apa pun yang memanggil alur kerja yang dihapus. Saat Anda menyimpan ulang, penelepon mendapatkan informasi yang benar untuk alur kerja yang dibuat ulang. Jika tidak, panggilan ke alur kerja yang dibuat ulang gagal dengan kesalahan Unauthorized. Perilaku ini juga berlaku untuk alur kerja yang menggunakan artefak dalam akun integrasi dan alur kerja yang memanggil fungsi Azure.

Untuk menghapus sumber daya aplikasi logika dari Visual Studio Code, ikuti langkah-langkah berikut:

1. Di Visual Studio Code, buka jendela Azure.

2. Di bagian Logic Apps (Konsumsi), perluas langganan Azure Anda untuk melihat sumber daya aplikasi logika terkait. Temukan sumber daya aplikasi logika yang ingin Anda hapus.

3. Dari menu pintasan aplikasi logika, pilih Hapus.

   

Konten terkait

• Membuat alur kerja standar di Azure Logic Apps penyewa tunggal dengan menggunakan Visual Studio Code