Membuat alur kerja aplikasi logika Standar di Azure Logic Apps penyewa tunggal menggunakan Visual Studio Code

Artikel
01/10/2024

Berlaku pada: Azure Logic Apps (Standar)

Panduan cara ini menunjukkan cara membuat contoh alur kerja integrasi yang berjalan di Azure Logic Apps penyewa tunggal dengan menggunakan Visual Studio Code dengan ekstensi Azure Logic Apps (Standar). Sebelum membuat alur kerja ini, Anda akan membuat sumber daya aplikasi logika Standar, yang menyediakan kemampuan berikut:

Aplikasi logika Anda dapat mencakup beberapa alur kerja berstatus dan tanpa status.
Alur kerja dalam aplikasi logika dan penyewa yang sama berjalan dalam proses yang sama pula dengan runtime Azure Logic Apps yang didesain ulang, sehingga keduanya berbagi sumber daya yang sama dan memberikan performa yang lebih baik.
Anda dapat membuat, menjalankan, dan menguji alur kerja secara lokal menggunakan lingkungan pengembangan Visual Studio Code.

Setelah siap, Anda dapat menyebarkan aplikasi logika ke Azure tempat alur kerja Anda dapat berjalan di lingkungan Azure Logic Apps penyewa tunggal atau di Lingkungan App Service v3 (hanya paket App Service berbasis Windows). Anda juga dapat menyebarkan dan menjalankan alur kerja di mana saja yang dapat dijalankan Kubernetes, termasuk Azure, Azure Kubernetes Service, lokal, atau bahkan penyedia cloud lainnya, karena runtime kontainer Azure Logic Apps.

Catatan

Menyebarkan aplikasi logika Anda ke kluster Kubernetes saat ini dalam pratinjau publik.

Untuk informasi selengkapnya tentang Azure Logic Apps penyewa tunggal, tinjau Penyewa tunggal versus lingkungan layanan multipenyewa dan integrasi.

Meskipun alur kerja contoh berbasis cloud dan hanya memiliki dua langkah, Anda dapat membuat alur kerja dari ratusan operasi yang dapat menghubungkan berbagai aplikasi, data, layanan, dan sistem di seluruh cloud, lokal, dan lingkungan hibrid. Contoh alur kerja dimulai dengan pemicu Permintaan bawaan dan diikuti dengan tindakan Office 365 Outlook. Pemicu membuat titik akhir yang dapat dihubungi untuk alur kerja dan menunggu permintaan HTTPS masuk dari penelepon mana pun. Ketika pemicu menerima permintaan dan mengeksekusi, tindakan berikutnya berjalan dengan mengirim email ke alamat email yang ditentukan bersama dengan output yang dipilih dari pemicu.

Tip

Jika Anda tidak memiliki akun Office 365, Anda bisa menggunakan tindakan lain yang tersedia yang bisa mengirim pesan dari akun email Anda, misalnya, Outlook.com.

Untuk membuat contoh alur kerja ini menggunakan portal Microsoft Azure, ikuti langkah-langkah dalam Membuat alur kerja integrasi menggunakan Azure Logic Apps penyewa tunggal dan Azure Microsoft portal. Kedua opsi ini menyediakan kemampuan untuk mengembangkan, menjalankan, dan menggunakan alur kerja aplikasi logika dalam jenis lingkungan yang sama. Namun, dengan Visual Studio Code, Anda dapat mengembangkan, menguji, dan menjalankan alur kerja secara lokal di lingkungan pengembangan Anda.

Cuplikan layar yang memperlihatkan Visual Studio Code, proyek aplikasi logika, dan alur kerja.

Seiring kemajuan, Anda akan menyelesaikan tugas tingkat tinggi ini:

Buat proyek untuk aplikasi logika Anda dan alur kerja stateful kosong.
Menambahkan pemicu dan tindakan.
Jalankan, uji, telusur kesalahan, dan tinjau jalankan riwayat secara lokal.
Temukan detail nama domain untuk akses firewall.
Sebarkan ke Azure, yang mencakup secara opsional mengaktifkan Application Insights.
Kelola aplikasi logika yang Anda sebarkan di Visual Studio Code dan portal Microsoft Azure.
Aktifkan riwayat eksekusi untuk alur kerja tanpa status.
Aktifkan atau buka Application Insights setelah penyebaran.

Prasyarat

Akses dan konektivitas

Jika Anda berencana untuk membangun proyek aplikasi logika Standar secara lokal dan menjalankan alur kerja hanya menggunakan konektor bawaan yang berjalan secara asli pada runtime Azure Logic Apps, Anda tidak memerlukan persyaratan berikut. Namun, pastikan Anda memiliki konektivitas berikut dan kredensial akun Azure untuk menerbitkan atau menyebarkan proyek Anda dari Visual Studio Code ke Azure, gunakan konektor terkelola yang berjalan di Azure global, atau akses sumber daya dan alur kerja aplikasi logika Standar yang sudah disebarkan di Azure:
- Akses internet agar Anda dapat mengunduh persyaratan, menyambung dari Visual Studio Code ke akun Azure Anda, dan menerbitkan dari Visual Studio Code ke Azure.
- Akun dan langganan Azure. Jika Anda tidak memiliki langganan, daftar untuk mendapatkan akun Azure secara gratis.
Untuk membuat contoh alur kerja yang sama dalam artikel ini, Anda memerlukan akun email Office 365 Outlook yang menggunakan akun kantor atau sekolah Microsoft untuk masuk.

Jika Anda memilih konektor email lain, seperti Outlook.com, Anda masih bisa mengikuti contoh, dan langkah keseluruhan umumnya sama. Namun, opsi Anda mungkin berbeda dalam beberapa hal. Misalnya, jika Anda menggunakan Outlook.com, gunakan akun Microsoft privat Anda sebagai gantinya untuk masuk.

Alat

Unduh dan instal Visual Studio Code, yang gratis.
Unduh dan instal ekstensi Akun Azure untuk Visual Studio Code sehingga Anda memiliki satu pengalaman umum untuk pemfilteran masuk dan langganan Azure di semua ekstensi Azure di Visual Studio Code. Panduan cara ini mencakup langkah-langkah yang menggunakan pengalaman ini.

Unduh dan instal dependensi Visual Studio Code berikut untuk sistem operasi spesifik Anda menggunakan salah satu metode:

Instal semua dependensi secara otomatis (pratinjau).
Unduh dan instal setiap dependensi secara terpisah.

Menginstal semua dependensi secara otomatis (pratinjau)

Penting

Kemampuan ini masih dalam pratinjau dan mengacu pada Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.

Dimulai dengan versi 2.81.5, ekstensi Azure Logic Apps (Standar) untuk Visual Studio Code menyertakan alat penginstal dependensi yang secara otomatis menginstal semua dependensi yang diperlukan di folder biner baru dan membiarkan dependensi yang ada tidak berubah. Untuk informasi selengkapnya, lihat Memulai dengan lebih mudah dengan ekstensi Azure Logic Apps (Standar) untuk Visual Studio Code.

Ekstensi ini mencakup dependensi berikut:

Dependensi	Deskripsi
C# untuk Visual Studio Code	Mengaktifkan fungsionalitas F5 untuk menjalankan alur kerja Anda.
Azurite untuk Visual Studio Code	Menyediakan penyimpanan data lokal dan emulator untuk digunakan dengan Visual Studio Code sehingga Anda dapat mengerjakan proyek aplikasi logika dan menjalankan alur kerja di lingkungan pengembangan lokal Anda. Jika Anda tidak ingin Azurite dimulai secara otomatis, Anda dapat menonaktifkan opsi ini: 1. Pada menu File, pilih Preferensi> Pengaturan. 2. Pada tab Pengguna, pilih Ekstensi>Azure Logic Apps (Standar). 3. Temukan pengaturan bernama Azure Logic Apps Standard: Auto Start Azurite, dan kosongkan kotak centang yang dipilih.
.NET SDK 6.x.x	Termasuk .NET Runtime 6.x.x, prasyarat untuk runtime Azure Logic Apps (Standar).
Azure Functions Core Tools - versi 4.x	Menginstal versi berdasarkan sistem operasi Anda (Windows, macOS, atau Linux). Alat-alat ini menyertakan versi runtime yang sama yang mendukung runtime Azure Functions, yang digunakan ekstensi Azure Logic Apps (Standard) di Visual Studio Code.
Node.js versi 16.x.x kecuali versi yang lebih baru sudah diinstal	Diperlukan untuk mengaktifkan tindakan Operasi Kode Sebaris yang menjalankan JavaScript.

Alat penginstal tidak melakukan tugas-tugas berikut:

Periksa apakah dependensi yang diperlukan sudah ada.
Instal hanya dependensi yang hilang.
Perbarui versi lama dependensi yang ada.

Unduh dan instal ekstensi Azure Logic Apps (Standar) untuk Visual Studio Code, dimulai dengan versi 2.81.5).
Di Visual Studio Code, pada bilah Aktivitas, pilih Ekstensi. (Keyboard: Tekan Ctrl+Shift+X)
Pada panel Ekstensi , buka menu elipsis (...), dan pilih Instal dari VSIX.
Temukan dan pilih file VSIX yang diunduh.

Setelah penyiapan selesai, ekstensi secara otomatis mengaktifkan dan menjalankan perintah Validasi dan instal biner dependensi. Untuk melihat log proses, buka jendela Output .
Saat perintah berikut muncul, pilih Ya (Disarankan) untuk mengonfirmasi bahwa Anda ingin menginstal dependensi yang diperlukan secara otomatis:
Muat ulang Visual Studio Code, jika perlu.
Konfirmasikan bahwa dependensi muncul dengan benar di folder berikut:

C:\Users\<your-user-name>\.azurelogicapps\dependencies\<dependency-name>

Konfirmasikan pengaturan ekstensi berikut di Visual Studio Code:

Pada menu File, pilih Preferensi> Pengaturan.
Pada tab Pengguna, pilih Ekstensi>Azure Logic Apps (Standar).

Tinjau pengaturan berikut:

Pengaturan ekstensi	Nilai
Jalur Dependensi	C:\Users\<your-user-name>\.azurelogicapps\dependencies
Batas Waktu Dependensi	60 detik
Jalur Biner Dotnet	C:\Users\<your-user-name>\.azurelogicapps\dependencies\DotNetSDK\dotnet.exe
Jalur Biner Func Core Tools	C:\Users\<your-user-name>\.azurelogicapps\dependencies\FuncCoreTools\func
Jalur Biner Node JS	C:\Users\<your-user-name>\.azurelogicapps\dependencies\NodeJs\node
Mulai Otomatis Azurite	Diaktifkan
Waktu Desain Mulai Otomatis	Diaktifkan

Jika Anda memiliki proyek aplikasi logika yang sudah ada dengan tugas yang ditentukan khusus yang disimpan dalam file .vscode/tasks.json , pastikan Anda menyimpan file tasks.json di tempat lain sebelum membuka proyek Anda.

Saat membuka proyek, Anda diminta untuk memperbarui file tasks.json untuk menggunakan dependensi yang diperlukan. Jika Anda memilih untuk melanjutkan, ekstensi akan menimpa file tasks.json .

Saat Anda membuka proyek aplikasi logika, pemberitahuan berikut muncul:

Pemberitahuan	Perbuatan
Selalu mulai proses design-time latar belakang saat peluncuran?	Untuk membuka perancang alur kerja lebih cepat, pilih Ya (Disarankan).
Mengonfigurasi Azurite untuk memulai otomatis saat peluncuran proyek?	Agar penyimpanan Azurite dimulai secara otomatis saat proyek terbuka, pilih Aktifkan Mulai Otomatis. Di bagian atas Visual Studio Code, di jendela perintah yang muncul, tekan enter untuk menerima jalur default: C\Users\<your-user-name>\.azurelogicapps\.azurite

Masalah yang diketahui dengan pratinjau

Jika Anda memilih untuk menginstal semua dependensi secara otomatis di komputer yang tidak memiliki versi .NET Core SDK, pesan berikut akan muncul:

".NET Core SDK tidak dapat ditemukan: Kesalahan menjalankan dotnet -- info: Kesalahan: Perintah gagal: dotnet --info 'dotnet tidak dikenali sebagai perintah internal atau eksternal, program yang dapat dioperasikan, atau file batch. 'dotnet' tidak dikenali sebagai perintah internal atau eksternal, program yang dapat dioperasikan, atau file batch. . Penelusuran kesalahan .NET Core tidak akan diaktifkan. Pastikan .NET Core SDK diinstal dan berada di jalur."

Anda mendapatkan pesan ini karena kerangka kerja .NET Core masih diinstal saat ekstensi diaktifkan. Anda dapat memilih untuk menonaktifkan pesan ini dengan aman.

Jika Anda mengalami masalah saat membuka proyek aplikasi logika yang ada atau memulai tugas penelusuran kesalahan (tasks.json) untuk memulai host func, dan pesan ini muncul, ikuti langkah-langkah berikut untuk mengatasi masalah:
1. Tambahkan jalur biner dotnet ke variabel PATH lingkungan Anda.
  1. Pada taskbar Windows, di kotak pencarian, masukkan variabel lingkungan, dan pilih Edit variabel lingkungan sistem.
  2. Dalam kotak Properti Sistem, pada tab Tingkat Lanjut , pilih Variabel Lingkungan.
  3. Dalam kotak Variabel Lingkungan, dari variabel Pengguna untuk <daftar nama> pengguna Anda, pilih PATH, lalu pilih Edit.
  4. Jika nilai berikut tidak muncul dalam daftar, pilih Baru untuk menambahkan nilai berikut:
    
    C:\Users\<your-user-name>\.azurelogicapps\dependencies\DotNetSDK
  5. Setelah selesai, pilih OK.
2. Tutup semua jendela Visual Studio Code, dan buka kembali proyek Anda.
Jika Anda mengalami masalah saat menginstal dan memvalidasi dependensi biner, misalnya:
- Masalah izin Linux
- Anda mendapatkan kesalahan berikut: <File atau jalur> tidak ada
- Validasi macet pada <nama> dependensi.
Ikuti langkah-langkah ini untuk menjalankan perintah Validasi dan instal dependensi biner lagi:
1. Dari menu Tampilan , pilih Palet Perintah.
2. Saat jendela perintah muncul, masukkan dan jalankan perintah Validasi dan instal dependensi biner.
Jika Anda tidak menginstal .NET Core 7 atau versi yang lebih baru, dan Anda membuka ruang kerja Azure Logic Apps yang berisi proyek Azure Functions, Anda mendapatkan pesan berikut:

Ada masalah saat memuat proyek [function-name].csproj. Lihat log untuk detailnya.

Komponen yang hilang ini tidak memengaruhi proyek Azure Functions, sehingga Anda dapat mengabaikan pesan ini dengan aman.

Menginstal setiap dependensi secara terpisah

Dependensi	Deskripsi
.NET SDK 6.x.x	Termasuk .NET Runtime 6.x.x, prasyarat untuk runtime Azure Logic Apps (Standar).
Azure Functions Core Tools - versi 4.x	- Windows: Gunakan versi Microsoft Installer (MSI), yaitu `func-cli-X.X.XXXX-x*.msi`. - macOS - Linux Alat-alat ini menyertakan versi runtime yang sama yang mendukung runtime Azure Functions, yang digunakan ekstensi Azure Logic Apps (Standard) di Visual Studio Code. Jika Anda memiliki pengunduhan yang lebih lama dari versi ini, hapus penginstalan versi tersebut terlebih dahulu, atau pastikan bahwa titik variabel lingkungan PATH pada versi yang Anda unduh dan pasang.
Node.js versi 16.x.x kecuali versi yang lebih baru sudah diinstal	Diperlukan untuk mengaktifkan tindakan Operasi Kode Sebaris yang menjalankan JavaScript. Catatan: Untuk Windows, unduh versi MSI. Jika Anda menggunakan versi ZIP sebagai gantinya, Anda harus menyediakan Node.js secara manual menggunakan variabel lingkungan PATH untuk sistem operasi Anda.

Jika Anda sudah menginstal versi ekstensi Azure Logic Apps (Standar) yang secara otomatis menginstal semua dependensi (pratinjau), lewati langkah ini. Jika tidak, unduh dan instal ekstensi Azure Logic Apps (Standar) untuk Visual Studio Code.
1. Di Visual Studio Code, di toolbar kiri, pilih Ekstensi.
2. Dalam kotak pencarian ekstensi, masukkan standar azure logic apps. Dari daftar hasil, pilih Azure Logic Apps (Standar)>Pasang.
  
  Setelah penginstalan selesai, ekstensi muncul di daftar Ekstensi: Terpasang.
  
  Tip
  
  Jika ekstensi tidak muncul di daftar yang terpasang, coba mulai ulang Visual Studio Code.
Saat ini, Anda dapat menginstal ekstensi Konsumsi (multipenyewa) dan Standar (penyewa tunggal) secara bersamaan. Pengalaman pengembangan berbeda satu sama lain dalam beberapa hal, tetapi langganan Azure Anda dapat menyertakan jenis aplikasi logika Standard dan Consumption. Di Visual Studio Code, jendela Azure memperlihatkan semua aplikasi logika yang disebarkan dan dihosting Azure di langganan Azure Anda, tetapi mengatur aplikasi Anda dengan cara berikut:
- Bagian Logic Apps (Konsumsi) : Semua aplikasi logika Konsumsi di langganan Anda.
- Bagian Sumber Daya : Semua aplikasi logika Standar di langganan Anda. Sebelumnya, aplikasi logika ini muncul di bagian Logic Apps (Standar), yang sekarang telah dipindahkan ke bagian Sumber Daya .
Untuk menjalankan pemicu dan tindakan berbasis webhook secara lokal, seperti pemicu WEBHOOK HTTP bawaan, di Visual Studio Code, Anda perlu menyiapkan penerusan untuk panggilan balik URL.
Untuk menguji contoh alur kerja dalam artikel ini, Anda memerlukan alat yang dapat mengirim panggilan ke titik akhir yang dibuat oleh pemicu Permintaan. Jika Anda tidak memiliki alat seperti itu, Anda dapat mengunduh, menginstal, dan menggunakan aplikasi Postman.
Jika Anda membuat sumber daya aplikasi logika dengan pengaturan yang mendukung penggunaan Application Insights, Anda dapat mengaktifkan pengelogan dan pelacakan diagnostik secara opsional untuk sumber daya aplikasi logika Anda. Anda dapat melakukannya saat membuat aplikasi logika atau setelah penyebaran. Anda harus memiliki instans Application Insights, tetapi Anda dapat membuat sumber daya ini terlebih dahulu, saat membuat aplikasi logika, atau setelah penyebaran.

Menyiapkan Visual Studio Code

Untuk memastikan bahwa semua ekstensi dipasang dengan benar, muat ulang atau mulai ulang Visual Studio Code.
Pastikan Visual Studio Code secara otomatis menemukan dan memasang pembaruan ekstensi sehingga semua ekstensi Anda mendapatkan pembaruan terbaru. Jika tidak, Anda harus menghapus versi yang usang secara manual dan memmasang versi terbaru.
1. Pada menu File, buka Preferensi> Pengaturan.
2. Pada tab Pengguna, buka Ekstensi Fitur>.
3. Konfirmasikan bahwa Pembaruan Pemeriksaan Otomatis dipilih, dan pembaruan otomatis diatur ke Semua Ekstensi.
Konfirmasikan bahwa pengaturan Azure Logic Apps Standard: Project Runtime untuk ekstensi Azure Logic Apps (Standar) diatur ke versi ~4:

Catatan

Versi ini diperlukan untuk menggunakan tindakan Operasi Kode Sebaris.
1. Pada menu File, buka Preferensi> Pengaturan.
2. Pada tab Pengguna, buka >Ekstensi>Azure Logic Apps (Standar).
  
  Misalnya, Anda dapat menemukan pengaturan Azure Logic Apps Standard: Project Runtime di sini atau menggunakan kotak pencarian untuk menemukan pengaturan lain:

Menyambungkan ke akun Azure Anda

Di bilah aktivitas Visual Studio Code, pilih ikon Azure.
Di jendela Azure, di bawah Sumber Daya, pilih Masuk ke Azure. Saat halaman autentikasi Visual Studio Code muncul, masuk dengan akun Azure Anda.

Setelah Anda masuk, jendela Azure memperlihatkan langganan Azure yang terkait dengan akun Azure Anda. Jika langganan yang diharapkan tidak muncul, atau Anda ingin panel hanya memperlihatkan langganan tertentu, ikuti langkah-langkah berikut ini:
1. Di daftar langganan, pindahkan penunjuk Anda di samping langganan pertama hingga tombol Pilih Langganan (ikon filter) muncul. Pilih ikon Filter.
  
  Atau, di bilah status Visual Studio Code, pilih akun Azure Anda.
2. Saat daftar langganan lain muncul, pilih langganan yang Anda inginkan, lalu pastikan Anda memilih OK.

Membuat proyek lokal

Sebelum dapat membuat aplikasi logika, buat proyek lokal sehingga Anda dapat mengelola, menjalankan, dan menyebarkan aplikasi logika dari Visual Studio Code. Proyek yang mendasarinya mirip dengan proyek Azure Functions, juga dikenal sebagai proyek aplikasi fungsi. Namun, jenis proyek ini terpisah satu sama lain, sehingga aplikasi logika dan aplikasi fungsi tidak dapat ada dalam proyek yang sama.

Di komputer Anda, buat folder lokal kosong untuk digunakan untuk proyek yang nantinya akan Anda buat di Visual Studio Code.
Di Visual Studio Code, tutup semua folder yang terbuka.
Di jendela Azure , pada toolbar bagian Ruang Kerja, dari menu Azure Logic Apps , pilih Buat Proyek Baru.
Jika Windows Defender Firewall meminta Anda untuk memberikan akses jaringan untuk Code.exe, yaitu Visual Studio Code, dan untuk func.exe, yang merupakan Alat Inti Azure Functions, pilih Jaringan pribadi, seperti jaringan rumah atau kantor saya>Izinkan akses.
Telusur ke lokasi tempat Anda membuat folder proyek, pilih folder tersebut dan lanjutkan.
Dari daftar templat yang muncul, pilih Stateful Workflow (Alur Kerja Berstatus) atau Stateless Workflow (Alur Kerja Tanpa Status). Contoh ini memilih Stateful Workflow.
Berikan nama untuk aplikasi logika Anda, dan tekan Enter. Contoh ini menggunakan Stateful-Workflow sebagai nama.

Catatan

Anda mungkin mendapatkan kesalahan bernama azureLogicAppsStandard.createNewProject dengan pesan kesalahan, Tidak dapat menulis ke Pengaturan Ruang Kerja karena azureFunctions.suppressProject bukan konfigurasi terdaftar. Jika ya, coba pasang ekstensi Azure Functions untuk Visual Studio Code, baik langsung dari Visual Studio Marketplace atau dari dalam Visual Studio Code.
Jika Visual Studio Code meminta Anda untuk membuka proyek di Visual Studio Code saat ini atau di jendela Visual Studio Code baru, pilih Buka di jendela saat ini. Jika tidak, pilih Buka di jendela baru.

Visual Studio Code selesai membuat proyek Anda.

Dari Bilah Aktivitas Visual Studio, buka panel Explorer, jika belum terbuka.

Panel Explorer memperlihatkan proyek Anda, yang sekarang menyertakan file proyek yang dibuat secara otomatis. Misalnya, proyek memiliki folder yang memperlihatkan nama alur kerja Anda. Di dalam folder ini, file workflow.json berisi definisi JSON yang mendasari alur kerja Anda.

Cuplikan layar memperlihatkan panel Explorer dengan folder proyek, folder alur kerja, dan file workflow.json.

Dalam Visual Studio Code, proyek aplikasi logika Anda memiliki salah satu dari jenis berikut:

Berbasis bundel ekstensi (Node.js), yang merupakan jenis default
Berbasis paket NuGet (.NET), yang dapat Anda konversi dari jenis default

Berdasarkan jenis ini, proyek Anda menyertakan folder dan file yang sedikit berbeda. Proyek berbasis NuGet menyertakan folder .bin yang berisi paket dan pustaka lainnya. Proyek berbasis bundel tidak menyertakan folder .bin dan file lainnya. Beberapa skenario memerlukan proyek berbasis NuGet untuk menjalankan aplikasi Anda, misalnya, saat Anda ingin mengembangkan dan menjalankan operasi bawaan kustom. Untuk informasi selengkapnya tentang mengonversi proyek Anda untuk menggunakan NuGet, tinjau Mengaktifkan penulisan konektor bawaan.

Untuk proyek berbasis bundel default, proyek Anda memiliki folder dan struktur file yang mirip dengan contoh berikut:

MyBundleBasedLogicAppProjectName
| .vscode
| Artifacts
  || Maps 
     ||| MapName1
     ||| ...
  || Schemas
     ||| SchemaName1
     ||| ...
| WorkflowName1
  || workflow.json
  || ...
| WorkflowName2
  || workflow.json
  || ...
| workflow-designtime
| .funcignore
| connections.json
| host.json
| local.settings.json

Di tingkat akar proyek, Anda dapat menemukan file dan folder berikut dengan item lain:

Nama	Folder atau file	Deskripsi
.vscode	Folder	Berisi pengaturan terkait Visual Studio Code, seperti file extensions.json, launch.json, settings.json, dan tasks.json files.
Artefak	Folder	Berisi artefak akun integrasi yang Anda tentukan dan gunakan dalam alur kerja yang mendukung skenario business-to-business (B2B). Misalnya, struktur contoh mencakup memetakan dan skema untuk transformasi XML dan operasi validasi.
*<WorkflowName>*	Folder	Untuk setiap alur kerja, folder <WorkflowName> menyertakan file workflow.json, yang berisi definisi JSON yang mendasari alur kerja tersebut.
alur kerja-designtime	Folder	Berisi file pengaturan terkait lingkungan pengembangan.
.funcignore	File	Berisi informasi yang terkait dengan Alat Inti Azure Functions yang Anda pasang.
connections.json	File	Berisi metadata, titik akhir, dan kunci untuk sambungan terkelola dan fungsi Azure yang digunakan alur kerja Anda. Penting: Untuk menggunakan sambungan dan fungsi yang berbeda untuk setiap lingkungan, pastikan Anda membuat parameter file connections.json ini dan memperbarui titik akhir.
host.json	File	Berisi pengaturan dan nilai konfigurasi khusus runtime, misalnya, batas default untuk platform Azure Logic Apps penyewa tunggal, aplikasi logika, alur kerja, pemicu, dan tindakan. Pada tingkat akar proyek aplikasi logika Anda, file metadata host.json berisi pengaturan konfigurasi dan nilai default yang semua alur kerja dalam aplikasi logika yang sama digunakan saat berjalan, baik secara lokal maupun di Azure. Catatan: Saat membuat aplikasi logika, Visual Studio Code akan membuat file *host.snapshot..json** cadangan di kontainer penyimpanan Anda. Jika Anda menghapus aplikasi logika Anda, file cadangan ini tidak dihapus. Jika Anda membuat aplikasi logika lain dengan nama yang sama, file rekam jepret lain dibuat. Anda hanya dapat memiliki hingga 10 rekam jepret untuk aplikasi logika yang sama. Jika Anda melebihi batas ini, Anda akan mendapatkan kesalahan berikut: `Microsoft.Azure.WebJobs.Script.WebHost: Repository has more than 10 non-decryptable secrets backups (host))` Untuk mengatasi kesalahan ini, hapus file rekam jepret tambahan dari kontainer penyimpanan Anda.
local.settings.json	File	Berisi pengaturan aplikasi, string sambungan, dan pengaturan lain yang digunakan alur kerja Anda saat berjalan secara lokal. Dengan kata lain, pengaturan dan nilai ini hanya berlaku saat Anda menjalankan proyek di lingkungan pengembangan lokal. Selama penyebaran ke Azure, file dan pengaturan diabaikan dan tidak disertakan dengan penyebaran Anda. File ini menyimpan pengaturan dan nilai sebagai variabel lingkungan lokal yang digunakan oleh alat pengembangan lokal Anda sebagai nilai `appSettings`. Anda dapat memanggil dan merujuk variabel lingkungan ini pada runtime dan waktu penyebaran dengan menggunakan pengaturan aplikasi dan parameter. Penting: File local.settings.json dapat berisi rahasia, jadi pastikan Anda juga mengecualikan file ini dari kontrol sumber proyek.

Mengonversi proyek Anda ke berbasis paket NuGet (.NET)

Secara default, Visual Studio Code membuat proyek aplikasi logika yang berbasis bundel ekstensi (Node.js), bukan berbasis paket NuGet (.NET). Jika Anda memerlukan proyek aplikasi logika yang berbasis paket NuGet (.NET), misalnya, untuk mengaktifkan penulisan konektor bawaan, Anda harus mengonversi proyek Anda dari berbasis bundel ekstensi (Node.js) ke berbasis paket NuGet (.NET).

Penting

Tindakan ini adalah operasi satu arah yang tidak dapat Anda batalkan.

Di panel Explorer, di akar proyek Anda, gerakkan penunjuk mouse Anda ke area kosong di bawah semua file dan folder lainnya, buka menu pintasan, dan pilih Konversi ke proyek Aplikasi Logika berbasis NuGet.
Saat perintah muncul, konfirmasi konversi proyek.

Mengaktifkan penulisan konektor bawaan

Anda dapat membuat konektor bawaan sendiri untuk layanan apa pun yang Anda butuhkan dengan menggunakan kerangka kerja ekstensibilitas Azure Logic Apps penyewa tunggal. Mirip dengan konektor bawaan seperti Azure Service Bus dan SQL Server, konektor ini menyediakan throughput yang lebih tinggi, latensi rendah, konektivitas lokal, dan berjalan secara asli dalam proses yang sama dengan runtime Azure Logic Apps penyewa tunggal.

Kemampuan penulisan saat ini hanya tersedia di Visual Studio Code, tetapi tidak diaktifkan secara default. Untuk membuat konektor ini, ikuti langkah-langkah berikut:

Jika Anda belum melakukannya, konversikan proyek Anda dari berbasis bundel ekstensi (Node.js) ke berbasis paket NuGet (.NET).
Tinjau dan ikuti langkah-langkah dalam artikel, Azure Logic Apps Berjalan di Mana Saja - Ekstensibilitas konektor bawaan.

Menambahkan artefak kustom ke proyek Anda

Dalam alur kerja aplikasi logika, beberapa konektor memiliki dependensi pada artefak seperti peta, skema, atau rakitan. Di Visual Studio Code, Anda dapat mengunggah artefak ini ke proyek aplikasi logika Anda, mirip dengan bagaimana Anda dapat mengunggah artefak ini di portal Azure melalui menu sumber daya aplikasi logika di bawah Artefak, misalnya:

Menambahkan peta ke proyek Anda

Untuk menambahkan peta ke proyek Anda, dalam hierarki proyek Anda, perluas Artefak> Peta, yang merupakan folder tempat Anda dapat meletakkan peta Anda.

Menambahkan skema ke proyek Anda

Untuk menambahkan skema ke proyek Anda, dalam hierarki proyek Anda, perluas Skema Artefak>, yang merupakan folder tempat Anda dapat meletakkan skema Anda.

Menambahkan rakitan ke proyek Anda

Aplikasi logika Standar dapat menggunakan atau mereferensikan jenis rakitan tertentu, yang dapat Anda unggah ke proyek Anda di Visual Studio Code. Namun, Anda harus menambahkannya ke folder tertentu dalam proyek Anda. Tabel berikut ini menyediakan informasi selengkapnya tentang setiap jenis perakitan dan di mana tepatnya untuk meletakkannya di proyek Anda.

Jenis rakitan	Deskripsi
Rakitan Klien/SDK (.NET Framework)	Jenis perakitan ini menyediakan penyimpanan dan penyebaran klien dan SDK kustom untuk .NET Framework. Misalnya, konektor bawaan SAP menggunakan rakitan ini untuk memuat file DLL yang tidak dapat didistribusikan ulang SAP NCo. Pastikan Anda menambahkan rakitan ini ke folder berikut: \lib\builtinOperationSdks\net472
Rakitan Klien/SDK (Java)	Jenis perakitan ini menyediakan penyimpanan dan penyebaran SDK kustom untuk Java. Misalnya, konektor bawaan JDBC menggunakan file JAR ini untuk menemukan driver JDBC untuk database relasional kustom (RDB). Pastikan untuk menambahkan rakitan ini ke folder berikut: \lib\builtinOperationSdks\JAR
Rakitan Kustom (.NET Framework)	Jenis perakitan ini menyediakan penyimpanan dan penyebaran DLL kustom. Misalnya, operasi Transformasi XML menggunakan rakitan ini untuk fungsi transformasi kustom yang diperlukan selama transformasi XML. Pastikan untuk menambahkan rakitan ini ke folder berikut: \lib\custom\net472

Gambar berikut menunjukkan tempat menempatkan setiap jenis perakitan dalam proyek Anda:

Untuk informasi selengkapnya tentang mengunggah rakitan ke sumber daya aplikasi logika Anda di portal Azure, lihat Menambahkan rakitan yang dirujuk.

Memigrasikan proyek berbasis NuGet untuk menggunakan rakitan "lib\*"

Penting

Tugas ini hanya diperlukan untuk proyek aplikasi logika berbasis NuGet.

Jika Anda membuat proyek aplikasi logika saat dukungan rakitan tidak tersedia untuk alur kerja aplikasi logika Standar, Anda dapat menambahkan baris berikut ke <file project-name.csproj> untuk bekerja dengan proyek yang menggunakan rakitan:

  <ItemGroup>
    <LibDirectory Include="$(MSBuildProjectDirectory)\lib\**\*"/>
  </ItemGroup>
  <Target Name="CopyDynamicLibraries" AfterTargets="_GenerateFunctionsExtensionsMetadataPostPublish">
    <Copy SourceFiles="@(LibDirectory)" DestinationFiles="@(LibDirectory->'$(MSBuildProjectDirectory)\$(PublishUrl)\lib\%(RecursiveDir)%(Filename)%(Extension)')"/>
  </Target>

Penting

Untuk proyek yang berjalan di Linux atau MacOS, pastikan untuk memperbarui pemisah direktori. Misalnya, tinjau gambar berikut yang menunjukkan kode sebelumnya yang ditambahkan ke <file project-name.csproj.>

Membuka file definisi alur kerja di perancang

Perluas folder proyek alur kerja Anda, yang bernama Stateful-Workflow dalam contoh ini, dan buka file workflow.json .
Buka menu pintasan file workflow.json, dan pilih Buka Perancang.
Setelah daftar Aktifkan konektor di Azure terbuka, pilih Gunakan konektor dari Azure, yang berlaku untuk semua konektor terkelola atau "bersama", yang dihosting dan dijalankan di Azure versus konektor bawaan, asli, atau "dalam aplikasi", yang berjalan langsung dengan runtime Azure Logic Apps.

Catatan

Alur kerja tanpa status saat ini hanya mendukung tindakan dari konektor terkelola, bukan pemicu. Meskipun Anda memiliki opsi untuk mengaktifkan konektor di Azure untuk alur kerja tanpa status Anda, perancang tidak menampilkan pemicu konektor terkelola yang Anda pilih.
Setelah daftar Pilih langganan terbuka, pilih langganan Azure yang akan digunakan untuk proyek aplikasi logika Anda.
Setelah daftar grup sumber daya terbuka, pilih Buat grup sumber daya baru.
Berikan nama untuk grup sumber daya Azure Anda, dan tekan ENTER. Contoh ini menggunakan Fabrikam-Workflows-RG.
Dari daftar lokasi, pilih wilayah Azure untuk digunakan saat membuat grup sumber daya dan sumber daya Anda. Contoh ini menggunakan AS Tengah Barat.

Setelah Anda melakukan langkah ini, Visual Studio Code akan membuka perancang alur kerja.

Catatan

Saat Visual Studio Code memulai API waktu desain alur kerja, Anda mungkin mendapatkan pesan bahwa startup mungkin membutuhkan waktu beberapa detik. Anda bisa mengabaikan pesan ini atau memilih OK.

Jika perancang tidak mau membuka, tinjau bagian pemecahan masalah, Perancang gagal membuka.

Setelah perancang muncul, perintah Tambahkan pemicu muncul di perancang.
Pada perancang, pilih Tambahkan pemicu, yang membuka panel Tambahkan pemicu dan galeri yang memperlihatkan semua konektor yang memiliki pemicu untuk Anda pilih.
Selanjutnya, tambahkan pemicu dan tindakan ke alur kerja Anda.

Menambahkan pemicu dan tindakan

Setelah Anda membuka alur kerja kosong di perancang, perintah Tambahkan pemicu muncul di perancang. Sekarang Anda bisa mulai membuat alur kerja dengan menambahkan pemicu dan tindakan.

Penting

Untuk menjalankan alur kerja yang menggunakan pemicu atau tindakan berbasis webhook secara lokal, seperti pemicu atau tindakan Webhook HTTP bawaan,Anda harus mengaktifkan kemampuan ini dengan mengatur penerusan untuk URL panggilan balik webhook.

Alur kerja dalam contoh ini menggunakan pemicu dan tindakan berikut:

Pemicu Konektor bawaan Permintaan bernama Saat permintaan HTTP diterima, yang dapat menerima panggilan masuk atau permintaan dan membuat titik akhir yang dapat dipanggil oleh layanan atau alur kerja aplikasi logika lainnya.
Tindakan konektor terkelola Office 365 Outlook bernama Kirim email. Untuk mengikuti panduan ini, Anda memerlukan akun email Outlook Office 365. Jika Anda memiliki akun email yang didukung oleh konektor lain, Anda dapat menggunakan konektor tersebut, tetapi pengalaman pengguna konektor tersebut akan berbeda dari langkah-langkah dalam contoh ini.
Tindakan Minta konektor bawaan bernama Respons, yang Anda gunakan untuk mengirim balasan dan mengembalikan data kembali ke pemanggil.

Menambahkan pemicu Permintaan

Pada perancang alur kerja, di panel Tambahkan pemicu , buka daftar Runtime , dan pilih Dalam Aplikasi sehingga Anda hanya menampilkan pemicu konektor bawaan yang tersedia.
Temukan pemicu Permintaan bernama Saat permintaan HTTP diterima dengan menggunakan kotak pencarian, dan tambahkan pemicu tersebut ke alur kerja Anda. Untuk informasi selengkapnya, lihat Membangun alur kerja dengan pemicu dan tindakan.

Saat pemicu muncul pada perancang, panel informasi pemicu terbuka dan memperlihatkan parameter pemicu, pengaturan, dan tugas terkait lainnya.

Tip

Jika panel informasi tidak muncul, pastikan bahwa pemicu dipilih pada perancang.
Simpan alur kerja Anda. Di bar alat perancang, pilih Simpan.

Jika Anda perlu menghapus item dari perancang, ikuti langkah-langkah ini untuk menghapus item dari perancang.

Menambahkan tindakan Office 365 Outlook

Pada perancang, di bawah pemicu Permintaan, pilih tanda plus (+) >Tambahkan tindakan.
Di panel Tambahkan tindakan yang terbuka, dari daftar Runtime , pilih Dibagikan sehingga Anda hanya menampilkan tindakan konektor terkelola yang tersedia.
Temukan tindakan konektor terkelola Office 365 Outlook bernama Kirim email (V2) dengan menggunakan kotak pencarian, dan tambahkan tindakan tersebut ke alur kerja Anda. Untuk informasi selengkapnya, lihat Membangun alur kerja dengan pemicu dan tindakan.
Saat panel autentikasi tindakan terbuka, pilih Masuk untuk membuat koneksi ke akun email Anda.
Ikuti perintah berikutnya untuk memilih akun Anda, mengizinkan akses, dan mengizinkan kembali ke Visual Studio Code.

Catatan

Jika terlalu banyak waktu berlalu sebelum Anda menyelesaikan perintah, proses autentikasi akan habis dan gagal. Dalam hal ini, kembali ke desainer dan coba lagi masuk untuk membuat koneksi.
1. Saat perintah Microsoft muncul, pilih akun pengguna untuk Office 365 Outlook, lalu pilih Izinkan akses.
2. Saat Azure Logic Apps meminta untuk membuka tautan Visual Studio Code, pilih Buka.
3. Saat Visual Studio Code meminta untuk membuka Alat Microsoft Azure, pilih Buka.
Tip

Untuk melewati perintah di masa mendatang, pilih opsi berikut saat perintah terkait muncul:
- Izin untuk membuka tautan untuk Visual Studio Code: Pilih Selalu izinkan logic-apis-westcentralus.consent.azure-apim.net untuk membuka tautan jenis ini di aplikasi terkait. Domain ini berubah berdasarkan wilayah Azure yang Anda pilih untuk sumber daya aplikasi logika Anda.
- Izin untuk membuka Alat Microsoft Azure: Pilih Jangan tanyakan lagi ekstensi ini.
Setelah Visual Studio Code membuat koneksi Anda, beberapa konektor menunjukkan pesan bahwa Koneksi akan valid selama {n} hari saja. Batas waktu ini hanya berlaku untuk durasi saat Anda menulis alur kerja aplikasi logika Anda di Visual Studio Code. Setelah penyebaran, batas ini tidak lagi berlaku karena alur kerja Anda dapat mengautentikasi saat runtime dengan menggunakan identitas terkelola yang ditetapkan sistem yang diaktifkan secara otomatis. Identitas ini berbeda dari info masuk autentikasi atau string koneksi yang Anda gunakan saat membuat koneksi. Jika Anda menonaktifkan identitas terkelola yang ditetapkan sistem ini, koneksi tidak akan berfungsi pada waktu proses.
Pada perancang, jika tindakan Kirim email tidak muncul dipilih, pilih tindakan tersebut.

Pada panel informasi tindakan, pada tab Parameter , berikan informasi yang diperlukan untuk tindakan, misalnya:

Cuplikan layar memperlihatkan informasi untuk tindakan Office 365 Outlook bernama Kirim email.

Properti	Diperlukan	Nilai	Deskripsi
Untuk	Ya	<your-email-address>	Penerima email, yang bisa menjadi alamat email Anda untuk tujuan pengujian. Contoh ini menggunakan email fiktif, sophia.owen@fabrikam.com.
Subjek	Ya	Email dari contoh alur kerja Anda	Subjek email
Isi	Ya	Halo dari contoh alur kerja Anda!	Konten isi email

Catatan

Jika Anda membuat perubahan pada tab Pengujian , pastikan Anda memilih Simpan untuk menerapkan perubahan tersebut sebelum beralih tab atau mengubah fokus ke perancang. Jika tidak, Visual Studio Code tidak akan menyimpan perubahan Anda.

Simpan alur kerja Anda. Pada desainer, pilih Simpan.

Aktifkan webhook yang berjalan secara lokal

Saat Anda menggunakan pemicu atau tindakan berbasis webhook, seperti HTTP Webhook, dengan alur kerja aplikasi logika yang berjalan di Azure, runtime Azure Logic Apps berlangganan titik akhir layanan dengan membuat dan mendaftarkan URL panggilan balik dengan titik akhir tersebut. Pemicu atau tindakan kemudian menunggu titik akhir layanan untuk memanggil URL. Namun, saat Anda bekerja di Visual Studio Code, URL panggilan balik yang dihasilkan dimulai dengan http://localhost:7071/.... URL ini untuk server localhost Anda, yang bersifat privat sehingga titik akhir layanan tidak dapat memanggil URL ini.

Untuk menjalankan pemicu dan tindakan berbasis webhook secara lokal di Visual Studio Code, Anda perlu menyiapkan URL publik yang mengekspos server localhost Anda dan mengalihkan panggilan dari titik akhir layanan ke URL callback webhook. Anda dapat menggunakan layanan penerusan dan alat seperti ngrok, yang membuka terowongan HTTP ke port localhost Anda, atau gunakan alat yang serupa milik Anda.

Menyiapkan pengalihan panggilan menggunakan ngrok

Buka situs web ngrok. Daftar untuk akun baru atau masuk ke akun Anda, jika Anda sudah memilikinya.
Dapatkan token autentikasi privat Anda, yang klien ngrok Anda perlu menghubungkan dan mengautentikasi akses ke akun Anda.
1. Untuk menemukan halaman token autentikasi Anda, pada menu dasbor akun Anda, perluas Autentikasi, dan pilih Authtoken Anda.
2. Dari kotak Authtoken Anda, salin token ke lokasi yang aman.
Dari halaman unduhan ngrok atau dasbor akun Anda,unduh versi ngrok yang Anda inginkan, dan ekstrak file .zip anda. Untuk informasi selengkapnya, lihat Langkah 1: Unzip untuk memasang.
Di komputer, buka alat prompt perintah Anda. Telusuri ke lokasi tempat Anda memiliki file filengrok.exe.
Sambungkan klien ngrok ke akun ngrok Anda dengan menjalankan perintah berikut. Untuk informasi selengkapnya, lihat Langkah 2: Menyambungkan akun Anda.

ngrok authtoken <your_auth_token>
Buka terowongan HTTP ke port localhost 7071 dengan menjalankan perintah berikut. Untuk informasi selengkapnya, lihat Langkah 3: Nyalakan.

ngrok http 7071
Dari keluaran, temukan baris berikut:

http://<domain>.ngrok.io -> http://localhost:7071
Salin dan simpan URL yang memiliki format ini: http://<domain>.ngrok.io

Menyiapkan URL penerusan di pengaturan aplikasi Anda

Di Visual Studio Code, pada perancang, tambahkan pemicu atau tindakan berbasis webhook yang ingin Anda gunakan.

Contoh ini berlanjut dengan pemicu HTTP + Webhook .
Saat perintah muncul untuk lokasi titik akhir host, masukkan URL penerusan (pengalihan) yang sebelumnya Anda buat.

Catatan

Mengabaikan perintah menyebabkan peringatan muncul bahwa Anda harus memberikan URL penerusan, jadi pilih Konfigurasikan, dan masukkan URL. Setelah Anda menyelesaikan langkah ini, perintah tidak akan muncul untuk pemicu webhook berikutnya atau tindakan yang mungkin Anda tambahkan.

Untuk membuat perintah muncul, di tingkat akar proyek Anda, buka menu pintasan file local.settings.json , dan pilih Konfigurasikan Titik Akhir Pengalihan Webhook. Perintah sekarang muncul sehingga Anda dapat memberikan URL penerusan.

Visual Studio Code menambahkan URL penerusan ke file local.settings.json di folder akar proyek Anda. Di Values objek, properti bernama Workflows.WebhookRedirectHostUri sekarang muncul dan diatur ke URL penerusan, misalnya:
```
{
   "IsEncrypted": false,
   "Values": {
      "AzureWebJobsStorage": "UseDevelopmentStorage=true",
      "FUNCTIONS_WORKER_RUNTIME": "node",
      "FUNCTIONS_V2_COMPATIBILITY_MODE": "true",
      <...>
      "Workflows.WebhookRedirectHostUri": "http://xxxXXXXxxxXXX.ngrok.io",
      <...>
   }
}
```

Pertama kali ketika Anda memulai sesi penelusuran kesalahan lokal atau menjalankan alur kerja tanpa penelusuran kesalahan, runtime Azure Logic Apps mendaftarkan alur kerja dengan titik akhir layanan dan berlangganan titik akhir tersebut untuk memberi tahu operasi webhook. Saat berikutnya alur kerja Anda berjalan, runtime tidak akan mendaftar atau berlangganan ulang karena pendaftaran langganan sudah ada di penyimpanan lokal.

Saat Anda menghentikan sesi penelusuran kesalahan untuk menjalankan alur kerja yang menggunakan pemicu atau tindakan berbasis webhook yang dijalankan secara lokal, pendaftaran langganan yang ada tidak dihapus. Untuk membatalkan pendaftaran, Anda harus menghapus atau menghapus pendaftaran langganan secara manual.

Catatan

Setelah alur kerja Anda mulai berjalan, jendela terminal mungkin memperlihatkan kesalahan seperti contoh ini:

message='Http request failed with unhandled exception of type 'InvalidOperationException' and message: 'System.InvalidOperationException: Synchronous operations are disallowed. Call ReadAsync or set AllowSynchronousIO to true instead.'

Dalam hal ini, buka file local.settings.json di folder akar proyek Anda, dan pastikan bahwa properti diatur ke true:

"FUNCTIONS_V2_COMPATIBILITY_MODE": "true"

Mengatur titik henti untuk penelusuran kesalahan

Sebelum menjalankan dan menguji alur kerja aplikasi logika dengan memulai sesi penelusuran kesalahan, Anda dapat mengatur titik henti di dalam file workflow.json untuk setiap alur kerja. Tidak diperlukan penyetelan lain.

Namun, titik henti saat ini hanya didukung untuk tindakan, bukan pemicu. Setiap definisi tindakan memiliki lokasi titik henti ini:

Atur titik jeda awal pada baris yang memperlihatkan nama tindakan. Saat titik henti ini mengenai sesi penelusuran kesalahan, Anda dapat meninjau input tindakan sebelum dievaluasi.
Atur titik jeda akhir pada baris yang memperlihatkan kurung kurawal penutup tindakan (}). Saat titik henti ini mengenai sesi penelusuran kesalahan, Anda dapat meninjau hasil tindakan sebelum menyelesaikan eksekusi.

Untuk menambahkan titik henti, ikuti langkah ini:

Buka file workflow.json untuk alur kerja yang ingin Anda telusur kesalahannya.
Pada baris ketika Anda ingin mengatur titik henti, di kolom kiri, pilih di dalam kolom itu. Untuk menghapus titik henti, pilih titik henti tersebut.

Saat Anda memulai sesi penelusuran kesalahan, tampilan Jalankan muncul di sisi kiri jendela kode, sementara toolbar Debug muncul di dekat bagian atas.

Catatan

Jika tampilan Jalankan tidak muncul secara otomatis, tekan Ctrl+Shift+D.
Untuk meninjau informasi yang tersedia saat titik henti mengenai, dalam tampilan Jalankan, periksa panel Variabel.
Untuk melanjutkan eksekusi alur kerja, pada toolbar Debug, pilih Lanjutkan (tombol putar).

Anda dapat menambahkan dan menghapus titik henti kapan saja selama menjalankan alur kerja. Namun, jika Anda memperbarui file workflow.json setelah proses dimulai, titik henti tidak diperbarui secara otomatis. Untuk memperbarui titik henti, mulai ulang aplikasi logika.

Untuk informasi umum, lihat Breakpoints - Visual Studio Code.

Jalankan, uji, dan telusur kesalahan secara lokal

Untuk menguji alur kerja aplikasi logika Anda, ikuti langkah-langkah ini untuk memulai sesi penelusuran kesalahan, dan temukan URL untuk titik akhir yang dibuat oleh pemicu Permintaan. Anda memerlukan URL ini sehingga Anda nantinya dapat mengirim permintaan ke titik akhir tersebut.

Untuk menelusur kesalahan alur kerja tanpa status dengan lebih mudah, Anda dapat mengaktifkan riwayat jalankan untuk alur kerja tersebut.
Jika emulator Azurite Anda sudah berjalan, lanjutkan ke langkah berikutnya. Jika tidak, pastikan untuk memulai emulator sebelum Menjalankan alur kerja Anda:
1. Di Visual Studio Code, dari menu Tampilan , pilih Palet Perintah.
2. Setelah palet perintah muncul, masukkan Azurite: Start.
Untuk informasi selengkapnya tentang perintah Azurite, lihat dokumentasi untuk ekstensi Azurite di Visual Studio Code.
Pada Bilah Aktivitas Visual Studio Code, buka menu Jalankan, dan pilih Start Debugging (F5).

Jendela Terminal terbuka sehingga Anda dapat meninjau sesi penelusuran kesalahan.

Catatan

Jika Anda mendapatkan kesalahan, "Kesalahan terjadi setelah menjalankan praLaunchTask 'generateDebugSymbols'", lihat bagian pemecahan masalah, sesi Penelusuran Kesalahan gagal dimulai.
Sekarang, temukan URL panggilan balik untuk titik akhir pada pemicu Permintaan.
1. Buka kembali panel Explorer sehingga Anda bisa menampilkan proyek Anda.
2. Dari menu pintasan file workflow.json, pilih Ringkasan.
3. Temukan nilai Callback URL, yang terlihat serupa dengan URL ini misalnya Pemicu permintaan:
  
  http://localhost:7071/api/<workflow-name>/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<shared-access-signature>
Untuk menguji URL panggilan balik dengan memicu alur kerja aplikasi logika, buka Postman atau alat pilihan Anda untuk membuat dan mengirim permintaan.

Contoh ini berlanjut menggunakan Postman. Untuk informasi selengkapnya, lihat Memulai Postman.
1. Pada toolbar Postman, pilih Baru.
2. Pada panel Buat Baru, di bawah Blok Pembangun,pilih Permintaan.
3. Di jendela Simpan Permintaan , di bawah Nama permintaan, berikan nama untuk permintaan, misalnya, Uji pemicu alur kerja.
4. Di bawah Pilih koleksi atau folder untuk disimpan ke, pilih Buat Koleksi.
5. Di bawah Semua Kumpulan, berikan nama kumpulan yang akan dibuat untuk mengatur permintaan Anda, tekan Enter, dan pilih Simpan ke <nama-kumpulan>. Contoh ini menggunakan permintaan Logic Apps sebagai nama koleksi.
  
  Di Postman, panel permintaan terbuka sehingga Anda dapat mengirim permintaan ke URL panggilan balik untuk pemicu Permintaan.
6. Kembali ke Visual Studio Code. Dari halaman ringkasan alur kerja, salin nilai properti URL Panggilan Balik.
7. Kembali ke Postman. Pada panel permintaan, berikutnya daftar metode, yang saat ini memperlihatkan GET sebagai metode permintaan default, tempelkan panggilan balik URL yang sebelumnya Anda salin di kotak alamat, lalu pilih Kirim.
  
  Contoh alur kerja aplikasi logika mengirim email yang tampak mirip dengan contoh ini:

Di Visual Studio Code, kembali ke halaman ringkasan alur kerja Anda.

Jika Anda membuat alur kerja berstatus, setelah permintaan yang Anda kirim memicu alur kerja, halaman ringkasan memperlihatkan status dan riwayat jalankan alur kerja.

Tip

Jika status eksekusi tidak muncul, coba refresh halaman gambaran umum dengan memilih Refresh. Tidak ada eksekusi yang terjadi untuk pemicu yang dilompati karena kriteria yang tidak terpenuhi atau tidak menemukan data.

Cuplikan layar yang memperlihatkan halaman ringkasan alur kerja dengan menjalankan status dan riwayat

Tabel berikut ini memperlihatkan kemungkinan status akhir yang dapat dimiliki dan diperlihatkan setiap alur kerja dalam Visual Studio Code:

Status eksekusi	Deskripsi
Gagal	Eksekusi berhenti atau tidak selesai karena masalah eksternal, misalnya, pemadaman sistem atau langganan Azure berakhir.
Dibatalkan	Eksekusi dipicu dan dimulai, tetapi menerima permintaan pembatalan.
Gagal	Setidaknya satu tindakan dalam eksekusi gagal. Tidak ada tindakan berikutnya dalam alur kerja yang disiapkan untuk menangani kegagalan.
Sedang berjalan	Eksekusi dipicu dan sedang berlangsung, tetapi status ini juga dapat muncul untuk eksekusi yang dibatasi karena batas tindakan atau paket harga saat ini. Tip: Jika Anda menyiapkan pembuatan log diagnostik, Anda bisa mendapatkan informasi tentang kejadian pembatasan apa pun yang terjadi.
Berhasil	Eksekusi berhasil. Jika tindakan gagal, tindakan berikutnya dalam alur kerja menangani kegagalan tersebut.
Timed out	Waktu eksekusi habis karena durasi saat ini melebihi batas durasi eksekusi, yang dikontrol oleh pengaturan Jalankan retensi riwayat dalam pengaturanhari. Durasi eksekusi dihitung menggunakan waktu mulai eksekusi dan batas durasi eksekusi pada waktu mulai tersebut. Catatan: Jika durasi eksekusi juga melebihi batas retensi riwayat eksekusi saat ini, yang juga dikontrol oleh Jalankan retensi riwayat dalam pengaturan hari, eksekusi tersebut dihapus dari riwayat eksekusi oleh pekerjaan pembersihan harian. Baik waktu eksekusi habis maupun selesai, periode retensi selalu dihitung menggunakan waktu mulai dan batas retensi saat ini dari eksekusi. Jadi, jika Anda mengurangi batas durasi untuk eksekusi dalam penerbangan, waktu eksekusi habis. Namun, eksekusi tetap ada atau dibersihkan dari riwayat eksekusi berdasarkan apakah durasi eksekusi melebihi batas retensi.
Menunggu	Proses belum dimulai atau dijeda, misalnya, karena instans alur kerja sebelumnya yang masih berjalan.

Untuk meninjau status untuk setiap langkah dalam eksekusi tertentu dan input dan output langkah, pilih tombol elipsis (...) untuk eksekusi tersebut, dan pilih Perlihatkan eksekusi.

Cuplikan layar memperlihatkan baris riwayat eksekusi alur kerja dengan tombol elipsis yang dipilih dan Perlihatkan Jalankan.

Visual Studio Code membuka tampilan pemantauan dan memperlihatkan status untuk setiap langkah dalam proses.

Cuplikan layar memperlihatkan setiap langkah dalam eksekusi alur kerja dan statusnya.

Catatan

Jika eksekusi gagal dan langkah dalam tampilan pemantauan menunjukkan kesalahan 400 Permintaan Buruk, masalah ini mungkin disebabkan oleh nama pemicu atau nama tindakan yang lebih panjang yang menyebabkan Pengidentifikasi Sumber Daya Seragam (URI) yang mendasarinya melebihi batas karakter default. Untuk informasi selengkapnya, lihat 400 Unit Permintaan.

Tabel berikut ini memperlihatkan kemungkinan status yang dapat dimiliki dan diperlihatkan setiap tindakan alur kerja dalam Visual Studio Code:

Status tindakan	Deskripsi
Gagal	Eksekusi berhenti atau tidak selesai karena masalah eksternal, misalnya, pemadaman sistem atau langganan Azure berakhir.
Dibatalkan	Aksi ini sedang berjalan tetapi menerima permintaan untuk membatalkan.
Gagal	Tindakan gagal
Sedang berjalan	Aksi saat ini sedang berjalan.
Skipped	Aksi tersebut dilewati karena aksi mendahului langsung gagal. Tindakan memiliki `runAfter` kondisi yang mengharuskan tindakan sebelumnya berhasil diselesaikan sebelum tindakan saat ini dapat berjalan.
Berhasil	Tindakannya berhasil.
Berhasil dengan percobaan ulang	Aksi berhasil tetapi hanya setelah satu atau beberapa kali dicoba. Untuk meninjau riwayat percobaan ulang, dalam tampilan detail riwayat eksekusi, pilih tindakan tersebut sehingga Anda dapat melihat input dan output.
Timed out	Tindakan dihentikan karena batas waktu habis yang ditentukan oleh pengaturan tindakan tersebut.
Menunggu	Berlaku untuk tindakan webhook yang menunggu permintaan masuk dari pemanggil.

Untuk melihat input dan keluaran untuk setiap langkah, perluas langkah yang ingin Anda tinjau. Untuk meninjau lebih lanjut input dan keluaran baku untuk langkah tersebut, pilih Tampilkan input baku atau Tampilkan keluaran baku.
Untuk menghentikan sesi penelusuran kesalahan, pada menu Jalankan, pilih Stop Debugging (Shift + F5).

Mengembalikan respons

Saat Anda memiliki alur kerja yang dimulai dengan pemicu Permintaan, Anda dapat mengembalikan respons ke pemanggil yang mengirim permintaan ke alur kerja Anda dengan menggunakan tindakan bawaan Permintaan bernama Respons.

Di perancang alur kerja, di bawah tindakan Kirim email , pilih tanda plus (+) >Tambahkan tindakan.

Panel Tambahkan tindakan terbuka sehingga Anda bisa memilih tindakan berikutnya.
Di panel Tambahkan tindakan , dari daftar Runtime , pilih Dalam Aplikasi. Temukan dan tambahkan tindakan Respons .

Setelah tindakan Respons muncul pada perancang, panel detail tindakan akan terbuka secara otomatis.
Pada tab Parameter, berikan informasi yang diperlukan untuk fungsi yang ingin Anda panggil.

Contoh ini mengembalikan nilai parameter Isi , yang merupakan output dari tindakan Kirim email .
1. Untuk parameter Isi, pilih di dalam kotak edit, dan pilih ikon kilat, yang membuka daftar konten dinamis. Daftar ini memperlihatkan nilai output yang tersedia dari pemicu dan tindakan sebelumnya dalam alur kerja.
2. Di daftar konten dinamis, di bawah Kirim email, pilih Isi.
  
  Setelah selesai, properti Isi tindakan Respons sekarang diatur ke nilai keluaran Isi tindakan Kirim email.
Pada desainer, pilih Simpan.

Menguji ulang aplikasi logika Anda

Setelah melakukan pembaruan pada aplikasi logika, Anda dapat menjalankan pengujian lain dengan menjalankan kembali penelusur kesalahan di Visual Studio dan mengirim permintaan lain untuk memicu aplikasi logika yang diperbarui, mirip dengan langkah-langkah dalam Menjalankan, menguji, dan menelusur kesalahan secara lokal.

Pada Bilah Aktivitas Visual Studio Code, buka menu Jalankan, dan pilih Start Debugging (F5).
Di Postman atau alat Anda untuk membuat dan mengirim permintaan, kirim permintaan lain untuk memicu alur kerja Anda.
Jika Anda membuat alur kerja berstatus, pada halaman ringkasan alur kerja, periksa status untuk proses terbaru. Untuk melihat status, input, dan output untuk setiap langkah dalam eksekusi tersebut, pilih tombol elipsis (...) untuk eksekusi tersebut, dan pilih Perlihatkan eksekusi.

Misalnya, berikut ini status langkah demi langkah untuk dijalankan setelah alur kerja sampel diperbarui dengan tindakan Respons.
Untuk menghentikan sesi penelusuran kesalahan, pada menu Jalankan, pilih Stop Debugging (Shift + F5).

Menemukan nama domain untuk akses firewall

Sebelum Anda menyebarkan dan menjalankan alur kerja aplikasi logika di portal Microsoft Azure, jika lingkungan Anda memiliki persyaratan jaringan atau firewall yang ketat yang membatasi lalu lintas, Anda harus menyiapkan izin untuk setiap pemicu atau koneksi tindakan yang ada di alur kerja Anda.

Untuk menemukan nama domain (FQDN) yang sepenuhnya memenuhi syarat untuk koneksi ini, ikuti langkah-langkah berikut:

Di proyek aplikasi logika Anda, buka file connections.json, yang dibuat setelah Anda menambahkan pemicu atau tindakan berbasis koneksi pertama ke alur kerja Anda, dan temukan managedApiConnections objeknya.

Untuk setiap koneksi yang Anda buat, salin, dan simpan connectionRuntimeUrl nilai properti di tempat yang aman sehingga Anda dapat mengatur firewall Anda dengan informasi ini.

Contoh file connections.json berisi dua koneksi, koneksi AS2-Applicability Statement 2, dan koneksi Office 365 dengan nilai connectionRuntimeUrl ini:

AS2: "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/as2/11d3fec26c87435a80737460c85f42ba
Office 365: "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/office365/668073340efe481192096ac27e7d467f

{
   "managedApiConnections": {
      "as2": {
         "api": {
            "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{Azure-region}/managedApis/as2"
         },
         "connection": {
            "id": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{Azure-resource-group}/providers/Microsoft.Web/connections/{connection-resource-name}"
         },
         "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/as2/11d3fec26c87435a80737460c85f42ba,
         "authentication": {
            "type":"ManagedServiceIdentity"
         }
      },
      "office365": {
         "api": {
            "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{Azure-region}/managedApis/office365"
         },
         "connection": {
            "id": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{Azure-resource-group}/providers/Microsoft.Web/connections/{connection-resource-name}"
         },
         "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/office365/668073340efe481192096ac27e7d467f,
         "authentication": {
            "type":"ManagedServiceIdentity"
         }
      }
   }
}

Sebarkan ke Azure

Dari Visual Studio Code, Anda dapat langsung menerbitkan proyek ke Azure untuk menyebarkan sumber daya aplikasi logika Standar Anda. Anda dapat memublikasikan aplikasi logika sebagai resource baru, yang secara otomatis membuat sumber daya yang diperlukan, seperti akun Azure Storage, mirip dengan persyaratan aplikasi fungsi. Atau, Anda dapat menerbitkan aplikasi logika ke sumber daya aplikasi logika Standar yang disebarkan sebelumnya, yang menimpa aplikasi logika tersebut.

Penyebaran untuk sumber daya aplikasi logika Standar memerlukan paket hosting dan tingkat harga, yang Anda pilih selama penyebaran. Untuk informasi lebih lanjut, tinjau Paket hosting dan tingkat harga.

Menerbitkan ke sumber daya aplikasi logika Standar baru

Pada Bilah Aktivitas Visual Studio Code, pilih ikon Azure untuk membuka jendela Azure.
Di jendela Azure , pada toolbar bagian Ruang Kerja, dari menu Azure Logic Apps , pilih Sebarkan ke Aplikasi Logika.
Jika diminta, pilih langganan Azure yang akan digunakan untuk penyebaran aplikasi logika Anda.
Dari daftar yang dibuka Visual Studio Code, pilih dari opsi berikut:
- Membuat Aplikasi Logika baru (Standar) di Azure (cepat)
- Membuat Logic App (Standar) baru di Azure Advanced
- Sumber daya Logic App (Standard) yang sebelumnya digunakan, jika ada
Contoh ini berlanjut dengan Buat Aplikasi Logika baru (Standar) di Azure Lanjutan.

Untuk membuat sumber daya aplikasi logika Standar baru Anda, ikuti langkah-langkah berikut:

Berikan nama unik global untuk aplikasi logika baru Anda, yang merupakan nama yang digunakan untuk sumber daya Logic App (Standard). Contoh ini menggunakan Fabrikam-Workflows-App.
Pilih paket hosting untuk aplikasi logika baru Anda. Buat nama untuk paket Anda, atau pilih paket yang sudah ada (hanya paket App Service berbasis Windows). Contoh ini memilih Buat App Service Plan baru.
Berikan nama untuk paket hosting Anda, lalu pilih tingkat harga untuk paket yang Anda pilih.

Untuk informasi lebih lanjut, tinjau Paket hosting dan tingkat harga.
Untuk performa optimal, pilih grup sumber daya yang sama dengan proyek Anda untuk penyebaran.

Catatan

Meskipun Anda dapat membuat atau menggunakan grup sumber daya yang berbeda, melakukannya dapat memengaruhi performa. Jika Anda membuat atau memilih grup sumber daya yang berbeda, tetapi membatalkan setelah perintah konfirmasi muncul, penyebaran Anda juga dibatalkan.
Untuk alur kerja berstatus, pilih Buat akun penyimpanan baru atau akun penyimpanan lama.

Jika pengaturan penyebaran dan pembuatan aplikasi logika Anda menggunakan Application Insights, Anda dapat mengaktifkan pembuatan log diagnostik dan pelacakan untuk aplikasi logika secara opsional. Anda dapat melakukannya saat menyebarkan aplikasi logika dari Visual Studio Code atau setelah penyebaran. Anda harus memiliki instans Application Insights, tetapi Anda dapat membuat sumber daya ini terlebih dahulu,saat membuat aplikasi logika, atau setelah penyebaran.

Untuk mengaktifkan pembuatan log dan penelusuran sekarang, ikuti langkah-langkah berikut:

Pilih sumber daya Application Insights yang ada atau Buat sumber daya Application Insights baru.
Di Azure portal - Microsoft Azure, kunjungi sumber daya Application Insights Anda.
Di menu sumber daya, pilih Gambaran Umum. Temukan dan salin nilai Kunci Instrumentasi.
Di Visual Studio Code, di folder akar proyek Anda, buka file local.settings.json.
Di Values objek, tambahkan APPINSIGHTS_INSTRUMENTATIONKEY properti, dan atur nilai ke kunci instrumentasi, misalnya:
```
{
   "IsEncrypted": false,
   "Values": {
      "AzureWebJobsStorage": "UseDevelopmentStorage=true",
      "FUNCTIONS_WORKER_RUNTIME": "node",
      "APPINSIGHTS_INSTRUMENTATIONKEY": <instrumentation-key>
   }
}
```
Tip

Anda dapat memeriksa apakah pemicu dan nama tindakan muncul dengan benar di instans Application Insights Anda.
1. Di Azure portal - Microsoft Azure, kunjungi sumber daya Application Insights Anda.
2. Pada menu sumber daya, di bawah Selidiki, pilih Peta aplikasi.
3. Tinjau nama operasi yang muncul di peta.
Beberapa permintaan masuk dari pemicu bawaan mungkin muncul sebagai duplikat di Peta Aplikasi. Daripada menggunakan WorkflowName.ActionName format, duplikat ini menggunakan nama alur kerja sebagai nama operasi dan berasal dari host Azure Functions.

Selanjutnya, Anda dapat secara opsional menyesuaikan tingkat keparahan untuk data penelusuran yang dikumpulkan aplikasi logika Anda dan dikirim ke instans Application Insights Anda.

Setiap kali kejadian terkait alur kerja terjadi, seperti saat alur kerja dipicu atau saat tindakan berjalan, runtime memancarkan berbagai jejak. Jejak ini mencakup masa pakai dan disertakan alur kerja, tetapi tidak terbatas pada, jenis kejadian berikut ini:

Aktivitas layanan, seperti mulai, berhenti, dan kesalahan.
Pekerjaan dan aktivitas pengirim.
Aktivitas alur kerja, seperti pemicu, tindakan, dan jalankan.
Aktivitas permintaan penyimpanan, seperti keberhasilan atau kegagalan.
Aktivitas permintaan HTTP, seperti masuk, keluar, sukses, dan gagal.
Setiap jejak pengembangan, seperti pesan telusur kesalahan.

Setiap jenis kejadian ditetapkan ke tingkat keparahan. Misalnya, Trace level menangkap pesan paling rinci, sementara Information level menangkap aktivitas umum di alur kerja Anda, seperti saat aplikasi logika, alur kerja, pemicu, dan tindakan Anda dimulai dan dihentikan. Tabel ini menjelaskan tingkat keparahan dan jenis jejaknya:

Tingkat keparahan	Jenis pelacakan
Kritis	Log yang menjelaskan kegagalan yang tidak dapat dipulihkan di aplikasi logika Anda.
Debug	Log yang dapat Anda gunakan untuk investigasi selama pengembangan, misalnya, panggilan HTTP masuk dan keluar.
Kesalahan	Log yang menunjukkan kegagalan dalam eksekusi alur kerja, tetapi bukan kegagalan umum dalam aplikasi logika Anda.
Informasi	Log yang melacak aktivitas umum di aplikasi logika atau alur kerja Anda, misalnya: - Ketika pemicu, tindakan, atau eksekusi dimulai dan berakhir. - Ketika aplikasi logika Anda dimulai atau berakhir.
Trace	Log yang berisi pesan paling rinci, misalnya, permintaan penyimpanan atau aktivitas pengirim, ditambah semua pesan yang terkait dengan aktivitas eksekusi alur kerja.
Peringatan	Log yang menyoroti status abnormal di aplikasi logika Anda tetapi tidak mencegahnya berjalan.

Untuk mengatur tingkat keparahan, pada tingkat akar proyek Anda, buka file host.json, dan temukan logging objek. Objek ini mengontrol pemfilteran log untuk semua alur kerja di aplikasi logika Anda dan mengikuti ASP.NET inti untuk pemfilteran jenis log.

{
   "version": "2.0",
   "logging": {
      "applicationInsights": {
         "samplingExcludedTypes": "Request",
         "samplingSettings": {
            "isEnabled": true
         }
      }
   }
}

Jika logging objek tidak berisi objek yang logLevel menyertakan Host.Triggers.Workflow properti, tambahkan item tersebut. Atur properti ke tingkat keparahan untuk jenis jejak yang Anda inginkan, misalnya:

{
   "version": "2.0",
   "logging": {
      "applicationInsights": {
         "samplingExcludedTypes": "Request",
         "samplingSettings": {
            "isEnabled": true
         }
      },
      "logLevel": {
         "Host.Triggers.Workflow": "Information"
      }
   }
}

Setelah selesai dengan langkah-langkah penerapan, Visual Studio Code mulai membuat dan menyebarkan sumber daya yang diperlukan untuk memublikasikan aplikasi logika Anda.

Untuk meninjau dan memantau proses penyebaran, pada menu View, pilih Output. Dari daftar toolbar jendela Output, pilih Azure Logic Apps.

Saat Visual Studio Code selesai menyebarkan aplikasi logika Anda ke Azure, pesan berikut muncul:

Selamat, aplikasi logika Anda sekarang aktif di Azure dan diaktifkan secara default.

Selanjutnya, Anda bisa mempelajari cara melakukan tugas ini:

Tambahkan alur kerja kosong ke proyek Anda.
Kelola aplikasi logika yang diterapkan di Visual Studio Code atau menggunakan portal Microsoft Azure.
Aktifkan jalankan riwayat untuk alur kerja tanpa status.
Aktifkan tampilan pemantauan di portal Microsoft Azure untuk aplikasi logika yang disebarkan.

Menambahkan alur kerja kosong ke proyek

Anda dapat memiliki beberapa alur kerja dalam proyek aplikasi logika Anda. Untuk menambahkan alur kerja kosong ke proyek Anda, ikuti langkah-langkah berikut ini:

Di bilah aktivitas Visual Studio Code, pilih ikon Azure.
Di jendela Azure , pada toolbar bagian Ruang Kerja, dari menu Azure Logic Apps , pilih Buat alur kerja.
Pilih jenis alur kerja yang ingin Anda tambahkan: Stateful atau Stateless
Berikan nama untuk alur kerja Anda.

Bila sudah selesai, folder alur kerja baru muncul di proyek Anda bersama dengan file workflow.json untuk definisi alur kerja.

Mengelola aplikasi logika yang diterapkan di Visual Studio Code

Di Visual Studio Code, Anda dapat melihat semua aplikasi logika yang disebarkan di langganan Azure Anda, baik sumber daya aplikasi logika Konsumsi atau Standar, dan pilih tugas yang membantu Anda mengelola aplikasi logika tersebut. Namun, untuk mengakses kedua jenis sumber daya, Anda memerlukan ekstensi Azure Logic Apps (Konsumsi) dan Azure Logic Apps (Standar) untuk Visual Studio Code.

Di bilah aktivitas Visual Studio Code, pilih ikon Azure. Di Sumber Daya, perluas langganan Anda, lalu perluas Aplikasi Logika, yang menampilkan semua aplikasi logika yang disebarkan di Azure untuk langganan tersebut.
Buka aplikasi logika yang ingin Anda kelola. Dari menu pintasan aplikasi logika, pilih tugas yang ingin Anda jalankan.

Misalnya, Anda dapat memilih tugas seperti menghentikan, memulai, memulai ulang, atau menghapus aplikasi logika yang disebarkan. Anda dapat menonaktifkan atau mengaktifkan alur kerja menggunakan portal Microsoft Azure.

Catatan

Aplikasi logika berhenti dan operasi aplikasi logika yang menghapus memengaruhi instans alur kerja dengan cara yang berbeda. Untuk informasi selengkapnya, tinjau Pertimbangan untuk menghentikan aplikasi logika dan Pertimbangan untuk menghapus aplikasi logika.
Untuk menampilkan semua alur kerja di aplikasi logika, perluas aplikasi logika Anda, lalu perluas simpul Alur Kerja.
Untuk menampilkan alur kerja tertentu, buka menu pintasan alur kerja, dan pilih Buka di Perancang, yang membuka alur kerja dalam mode baca-saja.

Untuk mengedit alur kerja, Anda memiliki opsi ini:
- Di Visual Studio Code, buka file workflow.json proyek Anda di perancang alur kerja, buat pengeditan, dan sebarkan ulang aplikasi logika Anda ke Azure.
- Di portal Microsoft Azure, buka aplikasi logika Anda. Anda kemudian dapat membuka, mengedit, dan menyimpan alur kerja Anda.
Untuk membuka aplikasi logika yang diterapkan di portal Microsoft Azure, buka menu pintasan aplikasi logika, lalu pilih Buka di Portal.

Azure portal terbuka di browser Anda, masuk anda ke portal secara otomatis jika Anda masuk ke Visual Studio Code, dan menampilkan aplikasi logika Anda.

Anda juga dapat masuk secara terpisah ke Azure portal, menggunakan kotak pencarian portal untuk menemukan aplikasi logika Anda, lalu pilih aplikasi logika Anda dari daftar hasil.

Pertimbangan untuk menghentikan aplikasi logika

Menghapus aplikasi logika mempengaruhi instans alur kerja dengan cara berikut:

Azure Logic Apps membatalkan semua proses yang sedang berlangsung dan proses yang tertunda segera.
Azure Logic Apps tidak membuat atau menjalankan instans alur kerja baru.
Pemicu tidak akan aktif lain kali saat kondisi terpenuhi. Namun, status pemicu mengingat titik saat aplikasi logika dihentikan. Jadi, jika Anda menghidupkan ulang aplikasi logika, pemicu mengaktifkan semua item yang tidak diproses sejak eksekusi terakhir.

Untuk menghentikan pemicu yang diaktifkan pada item yang tidak diproses sejak eksekusi terakhir, hapus status pemicu sebelum Anda mengaktifkan kembali aplikasi logika:
1. Pada Bilah Aktivitas Visual Studio Code, pilih ikon Azure untuk membuka jendela Azure.
2. Di bagian Sumber Daya , perluas langganan Anda, yang memperlihatkan semua aplikasi logika yang disebarkan untuk langganan tersebut.
3. Perluas aplikasi logika Anda, lalu perluas simpul yang bernama Alur Kerja.
4. Buka alur kerja, dan edit bagian mana pun dari pemicu alur kerja tersebut.
5. Simpan perubahan. Langkah ini mengatur ulang status pemicu Anda saat ini.
6. Ulangi untuk setiap alur kerja.
7. Setelah selesai, mulai ulang aplikasi logika.

Pertimbangan untuk menghapus aplikasi logika

Menghapus aplikasi logika mempengaruhi instans alur kerja dengan cara berikut:

Azure Logic Apps segera membatalkan proses yang sedang berlangsung dan tertunda, tetapi tidak menjalankan tugas pembersihan pada penyimpanan yang digunakan oleh aplikasi.
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. Untuk menyegarkan metadata, Anda harus menyimpan kembali alur kerja yang disebut 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.

Mengelola aplikasi logika yang diterapkan di portal

Setelah menyebarkan aplikasi logika ke portal Azure dari Visual Studio Code, Anda dapat melihat semua aplikasi logika yang disebarkan yang ada di langganan Azure Anda, baik sumber daya aplikasi logika Konsumsi atau Standar. Saat ini, setiap jenis sumber daya diatur dan dikelola sebagai kategori terpisah di Azure. Untuk menemukan aplikasi logika Standar, ikuti langkah-langkah berikut:

Di kotak pencarian portal Azure, masukkan aplikasi logika. Saat daftar hasil muncul, pada Layanan, pilih Aplikasi logika.
Pada panel Aplikasi logika, pilih aplikasi logika yang Anda sebarkan dari Visual Studio Code.

Azure portal membuka halaman sumber individual untuk aplikasi logika yang dipilih.
Untuk melihat alur kerja di aplikasi logika ini, pada menu aplikasi logika, pilih Alur Kerja.

Panel Alur Kerja memperlihatkan semua alur kerja dalam aplikasi logika saat ini. Contoh ini memperlihatkan alur kerja yang Anda buat di Visual Studio Code.
Untuk menampilkan alur kerja, pada panel Alur Kerja, pilih alur kerja tersebut.

Panel alur kerja terbuka dan memperlihatkan informasi dan tugas lainnya yang bisa Anda lakukan pada alur kerja tersebut.

Misalnya, untuk menampilkan langkah-langkah dalam alur kerja, pilih Perancang.

Perancang alur kerja membuka dan memperlihatkan alur kerja yang Anda bangun di Visual Studio Code. Sekarang Anda dapat membuat perubahan alur kerja ini di Azure portal.

Menambahkan alur kerja lain di portal

Melalui portal Azure, Anda dapat menambahkan alur kerja kosong ke sumber daya aplikasi logika Standar yang Anda sebarkan dari Visual Studio Code dan membangun alur kerja tersebut di portal Azure.

Di portal Azure, pilih sumber daya aplikasi logika Standar yang Anda sebarkan.
Pada menu sumber daya aplikasi logika, pilih Alur Kerja. Pada panel Alur Kerja, pilih Tambahkan.
Di panel Alur Kerja baru, sediakan nama untuk alur kerja. Pilih Buat Stateful atau Stateless.>

Setelah Azure menyebarkan alur kerja baru Anda, yang muncul di panel Alur Kerja, pilih alur kerja tersebut sehingga Anda bisa mengelola dan melakukan tugas lain, seperti membuka tampilan perancang atau kode.

Misalnya, membuka perancang untuk alur kerja baru memperlihatkan kanvas kosong. Sekarang Anda dapat menyusun alur kerja di Azure portal.

Mengaktifkan riwayat eksekusi untuk alur kerja tanpa status

Untuk men-debug alur kerja tanpa status dengan lebih mudah, Anda dapat mengaktifkan riwayat eksekusi untuk alur kerja tersebut, lalu menonaktifkan riwayat eksekusi saat Anda selesai. Ikuti langkah-langkah ini untuk Visual Studio Code, atau jika Anda bekerja di Azure portal, lihat Membuat alur kerja berbasis single-tenant di Azure portal .

Di proyek Visual Studio Code Anda, di tingkat folder akar, buka file local.settings.json .

Workflows.{yourWorkflowName}.operationOptions Tambahkan properti , dan atur nilai ke WithStatelessRunHistory, misalnya:

Windows

{
   "IsEncrypted": false,
   "Values": {
      "AzureWebJobsStorage": "UseDevelopmentStorage=true",
      "FUNCTIONS_WORKER_RUNTIME": "node",
      "Workflows.{yourWorkflowName}.OperationOptions": "WithStatelessRunHistory"
   }
}

macOS atau Linux

{
   "IsEncrypted": false,
   "Values": {
      "AzureWebJobsStorage": "DefaultEndpointsProtocol=https;AccountName=fabrikamstorageacct; \
          AccountKey=<access-key>;EndpointSuffix=core.windows.net",
      "FUNCTIONS_WORKER_RUNTIME": "node",
      "Workflows.{yourWorkflowName}.OperationOptions": "WithStatelessRunHistory"
   }
}

Di folder proyek bernama workflow-designtime, buka file local.settings.json , dan buat perubahan yang sama.
Untuk menonaktifkan riwayat eksekusi jika Anda sudah selesai, atur Workflows.{yourWorkflowName}.OperationOptions properti menjadi None, atau hapus properti dan nilainya.

Mengaktifkan pemantauan dari portal Microsoft Azure

Setelah Anda menggunakan sumber daya Logic App (Standard) dari Visual Studio Code ke Azure, Anda dapat meninjau riwayat jalankan dan detail yang tersedia untuk alur kerja di sumber daya tersebut dengan menggunakan Azure portal dan Monitor pengalaman untuk alur kerja tersebut. Namun, Pertama-tama Anda harus mengaktifkan kemampuan tampilan Monitor pada sumber daya aplikasi logika tersebut.

Di portal Azure, buka sumber daya aplikasi logika Standar.
Pada menu sumber daya aplikasi logika, di bawah API, pilih CORS.
Pada panel CORS, di bawah Asal yang Diizinkan, tambahkan karakter kartubebas (*).
Setelah selesai, di toolbar CORS, pilih Simpan.

Mengaktifkan atau membuka Application Insights setelah penyebaran

Selama eksekusi alur kerja, aplikasi logika Anda memancarkan telemetri bersama dengan kejadian lain. Anda dapat menggunakan telemetri ini untuk mendapatkan visibilitas yang lebih baik ke seberapa baik alur kerja Anda berjalan dan cara kerja runtime Logic Apps dengan berbagai cara. Anda dapat memantau alur kerja Anda menggunakan Application Insights, yang menyediakan telemetri mendekati real-time (metrik langsung). Kemampuan ini dapat membantu Anda menyelidiki kegagalan dan masalah performa dengan lebih mudah saat Anda menggunakan data ini untuk mendiagnosis masalah, menyiapkan pemberitahuan, dan menyusun bagan.

Untuk mengaktifkan Application Insights pada aplikasi logika yang disebarkan atau untuk meninjau data Application Insights saat sudah diaktifkan, ikuti langkah-langkah berikut:

Di portal Microsoft Azure, temukan dan buka aplikasi logika yang Anda sebarkan.
Pada menu aplikasi logika, di bawah Pengaturan, pilih Application Insights.
Jika Application Insights tidak diaktifkan, di panel Application Insights, pilih Aktifkan Application Insights. Setelah panel diperbarui, di bagian bawah, pilih Terapkan.

Jika Application Insights diaktifkan, pada panel Application Insights, pilih Lihat data Application Insights.

Setelah Application Insights terbuka, Anda dapat meninjau berbagai metrik untuk aplikasi logika Anda. Untuk informasi selengkapnya, tinjau topik berikut ini:

Menghapus item dari desainer

Untuk menghapus item di alur kerja Anda dari perancang, ikuti langkah-langkah berikut:

Pilih item, buka menu pintasan item (Shift+F10), lalu pilih Hapus. Untuk mengonfirmasi, pilih OK.
Pilih item, lalu tekan tombol hapus. Untuk mengonfirmasi, pilih OK.
Pilih item sehingga panel detail terbuka untuk item tersebut. Di pojok kanan atas panel, buka menu elipsis (...), lalu pilih Hapus. Untuk mengonfirmasi, pilih OK.

Tip

Jika menu elipsis tidak terlihat, perluas jendela Visual Studio Code cukup lebar sehingga panel detail memperlihatkan tombol elipsis (...) di sudut kanan atas.

Memecahkan masalah dan masalah

Perancang gagal dibuka

Ketika Anda mencoba membuka perancang, Anda mendapatkan kesalahan ini, "Waktu desain alur kerja tidak dapat dimulai". Jika sebelumnya Anda mencoba membuka perancang, lalu menghentikan atau menghapus proyek Anda, bundel ekstensi mungkin tidak diunduh dengan benar. Untuk memeriksa apakah penyebab ini adalah masalahnya, ikuti langkah-langkah berikut:

Di Visual Studio Code, buka Output window. Dari menu View, pilih Output.
Dari daftar di bilah judul jendela Output window, pilih Azure Logic Apps (Standar) sehingga Anda dapat meninjau output dari ekstensi, misalnya:

Tinjau keluaran dan periksa apakah pesan kesalahan ini muncul:

A host error has occurred during startup operation '{operationID}'.
System.Private.CoreLib: The file 'C:\Users\{userName}\AppData\Local\Temp\Functions\
ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows\1.1.7\bin\
DurableTask.AzureStorage.dll' already exists.
Value cannot be null. (Parameter 'provider')
Application is shutting down...
Initialization cancellation requested by runtime.
Stopping host...
Host shutdown completed.

Untuk mengatasi kesalahan ini, hapus map ExtensionBundles di lokasi ini ...\Users{your-username}\AppData\Local\Temp\Functions\ExtensionBundles, dan coba lagi membuka workflow.json di perancang.

Pemicu dan tindakan baru hilang dari pemilih perancang untuk alur kerja yang dibuat sebelumnya

Azure Logic Apps penyewa tunggal mendukung tindakan bawaan untuk Azure Function Operations, Liquid Operations, dan Operasi XML, seperti Validasi XML dan Transformasi XML. Namun, untuk aplikasi logika yang dibuat sebelumnya, tindakan ini mungkin tidak muncul di pemilih perancang untuk Anda pilih jika Visual Studio Code menggunakan versi bundel ekstensi yang sudah ketinggalan zaman, Microsoft.Azure.Functions.ExtensionBundle.Workflows.

Selain itu, konektor dan tindakan Azure Function Operations tidak muncul di pemilih perancang kecuali Anda mengaktifkan atau memilih Gunakan konektor dari Azure saat Anda membuat aplikasi logika. Jika Anda tidak mengaktifkan konektor yang disebarkan Azure pada waktu pembuatan aplikasi, Anda dapat mengaktifkannya dari proyek Anda di Visual Studio Code. Buka menu pintasan workflow.json, lalu pilih Gunakan Konektor dari Azure.

Untuk memperbaiki bundel yang sudah ketinggalan zaman, ikuti langkah-langkah berikut untuk menghapus bundel yang sudah ketinggalan zaman, yang membuat Visual Studio Code secara otomatis memperbarui bundel ekstensi ke versi terbaru.

Catatan

Solusi ini hanya berlaku untuk logic-apps yang Anda buat dan terapkan menggunakan Visual Studio Code dengan ekstensi Azure Logic Apps (Standard), bukan logic-apps yang Anda buat menggunakan Azure portal. Lihat Pemicu dan tindakan yang didukung akan hilang dari perancang di Azure portal.

Simpan pekerjaan apa pun yang tidak ingin Anda hilangkan, dan tutup Visual Studio.
Di komputer Anda, telusuri ke folder berikut, yang berisi folder versi untuk bundel lama:

...\Users\{your-username}\.azure-functions-core-tools\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows
Hapus folder versi untuk bundel sebelumnya, misalnya, jika Anda memiliki folder untuk versi 1.1.3, hapus folder tersebut.
Sekarang, telusuri ke folder berikut, yang berisi folder versi untuk paket NuGet yang diperlukan:

...\Users\{your-username}\.nuget\packages\microsoft.azure.workflows.webjobs.extension
Hapus folder versi untuk paket sebelumnya.
Buka kembali Visual Studio Code, proyek Anda, workflow.json file pada desainer.

Pemicu dan tindakan yang hilang sekarang muncul di perancang.

"400 Permintaan Buruk" muncul pada pemicu atau tindakan

Ketika eksekusi gagal, dan Anda memeriksa jalankan dalam tampilan pemantauan, kesalahan ini mungkin muncul pada pemicu atau tindakan yang memiliki nama yang lebih panjang, yang menyebabkan Pengidentifikasi Sumber Daya Seragam (URI) yang mendasarinya melebihi batas karakter default.

Untuk mengatasi masalah ini dan menyesuaikan URI yang lebih lama, edit kunci UrlSegmentMaxCount dan UrlSegmentMaxLength kunci registri di komputer Anda dengan mengikuti langkah-langkah di bawah ini. Nilai default kunci ini dijelaskan dalam topik ini, pengaturan registri Http.sys untuk Windows.

Penting

Sebelum memulai, pastikan Anda menyimpan pekerjaan Anda. Solusi ini mengharuskan Anda memulai ulang komputer setelah selesai sehingga perubahan dapat diterapkan.

Di komputer Anda, buka jendela Jalankan, dan regedit jalankan perintah, yang membuka editor registri.
Dalam kotak Kontrol Akun Pengguna, pilih Ya untuk mengizinkan perubahan Anda pada komputer Anda.
Di panel kiri, di bahwa Komputer, perluas simpul di sepanjang jalur, HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP\Parameters, lalu pilih Parameter.
Di panel kanan, temukan UrlSegmentMaxCount dan UrlSegmentMaxLength kunci registri.
Tingkatkan nilai kunci ini cukup sehingga URI dapat mengakomodasi nama yang ingin Anda gunakan. Jika kunci ini tidak ada, tambahkan ke folder Parameter dengan mengikuti langkah-langkah berikut:
1. Dari menu pintasan Parameter, pilih Nilai>DWORD (32-bit) Baru.
2. Dalam kotak edit yang muncul, masukkan UrlSegmentMaxCount sebagai nama kunci baru.
3. Buka menu pintasan tombol baru, dan pilih Ubah.
4. Dalam kotak Edit String yang muncul, masukkan nilai kunci data nilai yang Anda inginkan dalam format heksadesimal atau desimal. Misalnya, 400 dalam heksadesimal setara dengan 1024 desimal.
5. Untuk menambahkan nilai UrlSegmentMaxLength kunci, ulangi langkah-langkah ini.
Setelah Anda menambah atau menambahkan nilai kunci ini, editor registri terlihat seperti contoh ini:
Bila sudah siap, mulai ulang komputer agar perubahan bisa berlaku.

Sesi penelusuran kesalahan gagal dimulai

Ketika Anda mencoba untuk memulai sesi penelusuran kesalahan, Anda mendapatkan kesalahan, "Kesalahan ada setelah menjalankan preLaunchTask 'generateDebugSymbols'". Untuk mengatasi masalah ini, edit file tasks.json di proyek Anda untuk melewati pembuatan simbol.

Di proyek Anda, perluas folder dengan nama .vscode, dan buka file tasks.json.

Dalam tugas berikut, hapus garis, "dependsOn: "generateDebugSymbols", bersama dengan koma yang mengakhiri baris sebelumnya, misalnya:

Sebelum:

 {
   "type": "func",
   "command": "host start",
   "problemMatcher": "$func-watch",
   "isBackground": true,
   "dependsOn": "generateDebugSymbols"
 }

Setelah:

 {
   "type": "func",
   "command": "host start",
   "problemMatcher": "$func-watch",
   "isBackground": true
 }

Langkah berikutnya

Selain itu, kami ingin mendengar dari Anda tentang pengalaman Anda dengan Pratinjau Azure Logic Apps!

Untuk bug atau masalah, buat masalah Anda di GitHub.
Jika ada pertanyaan, permintaan, komentar, dan umpan balik lainnya, gunakan formulir umpan balik ini.

Membuat alur kerja aplikasi logika Standar di Azure Logic Apps penyewa tunggal menggunakan Visual Studio Code

Prasyarat

Akses dan konektivitas

Alat

Menyiapkan Visual Studio Code

Menyambungkan ke akun Azure Anda

Membuat proyek lokal

Mengonversi proyek Anda ke berbasis paket NuGet (.NET)

Mengaktifkan penulisan konektor bawaan

Menambahkan artefak kustom ke proyek Anda

Menambahkan peta ke proyek Anda

Menambahkan skema ke proyek Anda

Menambahkan rakitan ke proyek Anda

Memigrasikan proyek berbasis NuGet untuk menggunakan rakitan "lib\*"

Membuka file definisi alur kerja di perancang

Menambahkan pemicu dan tindakan

Menambahkan pemicu Permintaan

Menambahkan tindakan Office 365 Outlook

Aktifkan webhook yang berjalan secara lokal

Menyiapkan pengalihan panggilan menggunakan ngrok

Menyiapkan URL penerusan di pengaturan aplikasi Anda

Mengatur titik henti untuk penelusuran kesalahan

Jalankan, uji, dan telusur kesalahan secara lokal

Mengembalikan respons

Menguji ulang aplikasi logika Anda

Menemukan nama domain untuk akses firewall

Sebarkan ke Azure

Menerbitkan ke sumber daya aplikasi logika Standar baru

Menambahkan alur kerja kosong ke proyek

Mengelola aplikasi logika yang diterapkan di Visual Studio Code

Pertimbangan untuk menghentikan aplikasi logika

Pertimbangan untuk menghapus aplikasi logika

Mengelola aplikasi logika yang diterapkan di portal

Menambahkan alur kerja lain di portal

Mengaktifkan riwayat eksekusi untuk alur kerja tanpa status

Mengaktifkan pemantauan dari portal Microsoft Azure

Mengaktifkan atau membuka Application Insights setelah penyebaran

Menghapus item dari desainer

Memecahkan masalah dan masalah

Perancang gagal dibuka

Pemicu dan tindakan baru hilang dari pemilih perancang untuk alur kerja yang dibuat sebelumnya

"400 Permintaan Buruk" muncul pada pemicu atau tindakan

Sesi penelusuran kesalahan gagal dimulai

Langkah berikutnya

Sumber Daya Tambahan: