Mulai cepat: Membuat dan mengelola definisi alur kerja aplikasi logika dengan Azure Logic Apps multipenyewa dan Visual Studio Code

Berlaku pada: Azure Logic Apps (Konsumsi)

Mulai cepat ini menunjukkan cara membuat dan mengelola alur kerja aplikasi logika yang membantu Anda mengotomatiskan tugas dan proses yang mengintegrasikan aplikasi, data, sistem, dan layanan di seluruh organisasi dan perusahaan dengan menggunakan Azure Logic Apps multipenyewa dan Visual Studio Code. Anda dapat membuat dan mengedit definisi alur kerja yang mendasarinya, yang menggunakan JavaScript Object Notation (JSON), untuk aplikasi logika melalui pengalaman berbasis kode. Anda juga dapat mengerjakan aplikasi logika yang sudah ada yang sudah disebarkan ke Azure. Untuk informasi selengkapnya tentang model multipenyewa versus penyewa tunggal, tinjau Penyewa tunggal versus lingkungan layanan multipenyewa dan integrasi.

Meskipun Anda dapat melakukan tugas yang sama di portal Microsoft Azure dan di Visual Studio, Anda dapat memulai lebih cepat di Visual Studio Code jika Anda sudah terbiasa dengan definisi aplikasi logika dan ingin bekerja langsung dalam kode. Misalnya, Anda dapat menonaktifkan, mengaktifkan, menghapus, dan menyegarkan aplikasi logika yang sudah dibuat. Selain itu, Anda dapat mengerjakan aplikasi logika dan akun integrasi dari platform pengembangan apa pun yang dijalankan Visual Studio Code, seperti Linux, Windows, dan Mac.

Untuk artikel ini, Anda dapat membuat aplikasi logika yang sama dari mulai cepat ini, yang lebih berfokus pada konsep dasar. Anda juga dapat belajar membuat aplikasi contoh di Visual Studio, dan belajar membuat dan mengelola aplikasi melalui Azure CLI. Di Visual Studio Code, aplikasi logika terlihat seperti contoh ini:

Prasyarat

Sebelum memulai, pastikan Anda memiliki item ini:

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

• Pengetahuan dasar tentang definisi alur kerja aplikasi logika dan strukturnya seperti yang dijelaskan dengan JSON

  Jika Anda baru menggunakan Azure Logic Apps, coba mulai cepat ini, yang membuat alur kerja aplikasi logika pertama Anda di portal Azure dan lebih berfokus pada konsep dasar.

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

• Unduh dan instal alat-alat ini, 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

    Anda dapat mengunduh dan menginstal ekstensi ini dari Visual Studio Marketplace atau langsung dari dalam Visual Studio Code. Pastikan Anda memuat ulang Visual Studio Code setelah diinstal.

    

    Untuk memeriksa apakah ekstensi diinstal dengan benar, pilih ikon Azure yang muncul di toolbar Visual Studio Code Anda.

    

    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 aplikasi logika Anda perlu berkomunikasi melalui firewall yang membatasi lalu lintas ke alamat IP tertentu, firewall tersebut harus mengizinkan akses untuk alamat IP masuk dan keluar digunakan oleh Azure Logic Apps atau runtime di wilayah Azure tempat aplikasi logika Anda berada. Jika aplikasi logika Anda juga menggunakan konektor terkelola, seperti konektor Office 365 Outlook atau konektor SQL, atau menggunakan konektor kustom, firewall juga perlu mengizinkan akses untuk semuaalamat IP keluar konektor terkelola di wilayah Azure aplikasi logika Anda.

Mengakses Azure dari Visual Studio Code

1. Buka Visual Studio Code. Pada toolbar Visual Studio Code, pilih ikon Azure.

   

2. Di jendela Azure, pada Azure Logic Apps, pilih Masuk ke Azure. Saat halaman masuk Microsoft meminta Anda, masuk dengan akun Azure Anda.

   

   1. 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 kode, pilih Gunakan Kode Perangkat.

      

   2. Untuk menyalin kode, pilih Salin & Buka.

      

   3. Untuk membuka jendela browser baru dan melanjutkan ke situs web autentikasi, pilih Buka Tautan.

      

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

      

3. Pilih akun Azure Anda. Setelah masuk, Anda dapat menutup browser, dan kembali ke Visual Studio Code.

   Pada panel Azure, bagian Azure Logic Apps dan Akun Integrasi sekarang memperlihatkan langganan Azure yang terkait dengan akun Anda. Namun, jika Anda tidak melihat langganan yang Anda harapkan, atau jika bagian tersebut memperlihatkan terlalu banyak langganan, ikuti langkah-langkah ini:

   1. Pindahkan penunjuk Anda ke label Azure Logic Apps. Saat toolbar muncul, pilih Pilih Langganan (ikon filter).

      

   2. Dari daftar yang muncul, pilih langganan yang ingin Anda munculkan.

4. Pada Azure Logic Apps, pilih langganan yang Anda inginkan. Simpul langganan diperluas dan menampilkan aplikasi logika apa pun yang ada dalam langganan tersebut.

   

   Tip

   Pada Akun Integrasi, memilih langganan Anda memperlihatkan akun integrasi apa pun yang ada di langganan tersebut.

Membuat aplikasi logika baru

1. Jika Anda belum masuk ke akun dan langganan Azure dari dalam Visual Studio Code, ikuti langkah-langkah sebelumnya untuk masuk sekarang.

2. Di Visual Studio Code, pada Azure Logic Apps, buka menu pintasan langganan Anda, dan pilih Buat Aplikasi Logika.

   

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

3. Dari daftar grup sumber daya, pilih Buat grup sumber daya baru atau grup sumber daya yang sudah ada. Buat grup sumber daya baru untuk contoh ini.

   

4. Berikan nama untuk grup sumber daya Azure Anda, dan tekan ENTER.

   

5. Pilih wilayah Azure tempat Anda ingin menyimpan metadata aplikasi logika Anda.

   

6. Berikan nama untuk aplikasi logika Anda, dan tekan Enter.

   

   Di jendela Azure, pada langganan Azure Anda, aplikasi logika baru dan kosong Anda muncul. Visual Studio Code juga membuka file JSON (.logicapp.json), yang menyertakan definisi alur kerja kerangka untuk aplikasi logika Anda. Sekarang Anda dapat memulai penulisan definisi alur kerja aplikasi logika secara manual dalam file JSON ini. Untuk referensi teknis tentang struktur dan sintaks untuk definisi alur kerja, lihat skema Bahasa Definisi Alur Kerja untuk Azure Logic Apps.

   

   Misalnya, berikut adalah contoh definisi alur kerja aplikasi logika, yang dimulai dengan pemicu RSS dan tindakan Office 365 Outlook. Biasanya, elemen JSON muncul menurut abjad di setiap bagian. Namun, sampel ini menunjukkan elemen tersebut secara kasar dalam urutan langkah-langkah aplikasi logika muncul di desainer.

   Penting

   Jika Anda ingin menggunakan kembali contoh definisi aplikasi logika ini, Anda memerlukan akun organisasi, misalnya, @fabrikam.com. Pastikan Anda mengganti alamat email fiktif dengan alamat email Anda sendiri. Untuk menggunakan konektor email lain, seperti Outlook.com atau Gmail, ganti tindakan Send_an_email_action dengan tindakan serupa yang tersedia dari konektor email yang didukung oleh Azure Logic Apps.

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

   {
      "$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": 1
            },
            "splitOn": "@triggerBody()?['value']",
            "type": "ApiConnection",
            "inputs": {
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['rss']['connectionId']"
                  }
               },
               "method": "get",
               "path": "/OnNewFeed",
               "queries": {
                  "feedUrl": "http://feeds.reuters.com/reuters/topNews"
               }
            }
         }
      },
      "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": {}
   }
   

7. Setelah selesai, simpan definisi alur kerja aplikasi logika Anda. (Menu Berkas > Simpan, atau tekan Ctrl+S)

8. Saat diminta untuk mengunggah aplikasi logika ke langganan Azure Anda, pilih Unggah.

   Langkah ini menerbitkan aplikasi logika Anda ke portal Microsoft Azure, yang membuat logika Anda aktif dan berjalan di Azure.

   

Menampilkan aplikasi logika di desainer

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

Di jendela Azure, pada Azure Logic Apps, buka menu pintasan aplikasi logika Anda, dan pilih Buka di Designer.

Desainer baca-saja terbuka di jendela terpisah dan memperlihatkan alur kerja aplikasi logika Anda, misalnya:

Ditampilkan di portal Azure

Untuk meninjau aplikasi logika Anda di portal Microsoft Azure, ikuti langkah-langkah ini:

1. Masuk ke portal Microsoft Azure dengan menggunakan akun dan langganan Azure yang sama yang terkait dengan aplikasi logika Anda.

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

   

Mengedit aplikasi logika yang disebarkan

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

Penting

Sebelum Anda mengedit aplikasi logika yang berjalan aktif dalam produksi, hindari risiko merusak aplikasi logika tersebut dan minimalkan gangguan dengan menonaktifkan aplikasi logika Anda terlebih dahulu.

1. Jika Anda belum masuk ke akun dan langganan Azure dari dalam Visual Studio Code, ikuti langkah-langkah sebelumnya untuk masuk sekarang.

2. Di jendela Azure, pada Azure Logic Apps, perluas langganan Azure Anda, dan pilih aplikasi logika yang Anda inginkan.

3. Buka menu aplikasi logika Anda, dan pilih Buka di Editor. Atau, di samping nama aplikasi logika Anda, pilih ikon edit.

   

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

   

4. Buat perubahan Anda dalam definisi alur kerja aplikasi logika.

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

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

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

   

Menampilkan atau mempromosikan versi lain

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

Penting

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

1. Di jendela Azure, pada Azure Logic Apps, perluas langganan Azure Anda sehingga Anda bisa menampilkan semua aplikasi logika dalam langganan tersebut.

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

   Daftar Versi menampilkan versi aplikasi logika Anda yang lebih lama, jika ada.

   

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

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

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

   • Untuk menampilkan versi dalam tampilan desainer baca-saja, buka menu pintasan versi tersebut, dan pilih Buka di Designer.

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

   1. Pada Versi, buka menu pintasan versi yang lebih lama, dan 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 aplikasi logika yang diterbitkan dan menyimpan perubahan, Anda menimpa aplikasi yang sudah disebarkan. Agar tidak merusak aplikasi logika dalam produksi dan meminimalkan gangguan, nonaktifkan aplikasi logika Anda terlebih dahulu. Anda kemudian dapat mengaktifkan kembali aplikasi logika setelah mengonfirmasi bahwa aplikasi logika masih berfungsi.

• Azure Logic Apps melanjutkan semua proses yang berjalan dan menunggu sampai selesai. Berdasarkan volume atau backlog, proses ini mungkin membutuhkan waktu untuk menyelesaikannya.

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

• Pemicunya tidak akan diaktifkan di kali lain kondisi tersebut terpenuhi.

• Status pemicu mengingat titik di mana aplikasi logika dihentikan. Jadi, jika Anda mengaktifkan kembali aplikasi logika, pemicu akan diaktifkan untuk semua item yang tidak diolah sejak proses terakhir.

  Untuk menghentikan pemicu diaktifkan pada item yang tidak diproses sejak eksekusi terakhir, hapus status pemicu sebelum Anda mengaktifkan kembali aplikasi logika:

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

• Saat alur kerja dinonaktifkan, Anda masih dapat mengirim ulang proses.

1. Jika Anda belum masuk ke akun dan langganan Azure dari dalam Visual Studio Code, ikuti langkah-langkah sebelumnya untuk masuk sekarang.

2. Di jendela Azure, pada Azure Logic Apps, perluas langganan Azure Anda sehingga Anda bisa menampilkan semua aplikasi logika dalam langganan tersebut.

   1. Untuk menonaktifkan aplikasi logika yang Anda inginkan, buka menu aplikasi logika, dan pilih Nonaktifkan.

      

   2. Saat Anda siap mengaktifkan kembali aplikasi logika Anda, buka menu aplikasi logika, dan pilih Aktifkan.

      

Menghapus aplikasi logika

Menghapus aplikasi logika mempengaruhi instans alur kerja dengan cara berikut:

• Azure Logic Apps melakukan upaya terbaik untuk membatalkan proses yang sedang berlangsung dan yang 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, beberapa proses dapat dipilih untuk dieksekusi saat layanan bekerja melalui proses pembatalan.

• 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 tidak akan memiliki metadata yang sama dengan alur kerja yang dihapus. Anda harus menyimpan ulang alur kerja mana pun yang memanggil alur kerja yang dihapus. Dengan begitu, pemanggil 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.

1. Jika Anda belum masuk ke akun dan langganan Azure dari dalam Visual Studio Code, ikuti langkah-langkah sebelumnya untuk masuk sekarang.

2. Di jendela Azure, pada Azure Logic Apps, perluas langganan Azure Anda sehingga Anda bisa menampilkan semua aplikasi logika dalam langganan tersebut.

3. Temukan aplikasi logika yang ingin Anda hapus, buka menu aplikasi logika, dan pilih Hapus.

   

Langkah berikutnya

Membuat alur kerja aplikasi logika berbasis penyewa tunggal di Visual Studio Code