Membuat alur kerja aplikasi logika Standar dengan Visual Studio Code

2025-04-07

Berlaku pada: Azure Logic Apps (Standar)

Panduan ini menunjukkan cara membuat contoh alur kerja aplikasi logika Standar secara lokal yang dapat Anda jalankan di Azure Logic Apps penyewa tunggal saat Anda menggunakan Visual Studio Code dengan ekstensi Azure Logic Apps (Standar).

Dalam panduan ini, Anda membuat ruang kerja dan proyek aplikasi logika Standar, membangun alur kerja Anda, dan menyebarkan proyek Anda sebagai sumber daya aplikasi logika Standar di Azure tempat alur kerja Anda dapat berjalan di Azure Logic Apps penyewa tunggal atau di App Service Environment v3 (hanya paket App Service berbasis Windows). Anda juga dapat mendeploy dan menjalankan alur kerja Anda di mana saja yang Kubernetes dapat dijalankan, seperti di Azure, Azure Kubernetes Service, di lokasi, atau bahkan di penyedia cloud lainnya, berkat runtime kontainer untuk Azure Logic Apps (Standar).

Berikut adalah beberapa manfaat yang diberikan aplikasi logika Standar:

Anda dapat membuat, men-debug, menjalankan, dan menguji alur kerja secara lokal di lingkungan pengembangan Visual Studio Code lokal. Baik portal Microsoft Azure maupun Visual Studio Code menyediakan kemampuan untuk membangun, menjalankan, dan menyebarkan sumber daya dan alur kerja aplikasi logika Standar. Namun, dengan Visual Studio Code, Anda dapat melakukan tugas-tugas ini secara lokal.
Proyek aplikasi logika Standar Anda dapat menyertakan alur kerja stateful dan stateless.
Alur kerja dalam sumber daya aplikasi logika Standar dan penyewa yang sama berjalan dalam proses yang sama dengan runtime Azure Logic Apps (Standar), sehingga mereka berbagi sumber daya yang sama dan memberikan performa yang lebih baik.

Contoh alur kerja panduan ini awalnya dimulai dengan pemicu Permintaan diikuti oleh tindakan Office 365 Outlook . Pemicu Permintaan membuat titik akhir yang dapat dipanggil untuk alur kerja dan menunggu permintaan HTTPS masuk dari pemanggil mana pun. Saat pemicu menerima permintaan dan diaktifkan, tindakan berikutnya berjalan dengan mengirim email ke penerima yang ditentukan bersama dengan output pemicu apa pun yang Anda pilih. Nantinya, Anda dapat menambahkan tindakan Respons yang mengembalikan data balasan dan yang diproses ke pemanggil.

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

Meskipun contoh panduan ini berbasis cloud dan hanya memiliki beberapa langkah, Anda dapat membuat alur kerja menggunakan operasi dari 1.400+ konektor yang membantu Anda mengintegrasikan berbagai layanan, sistem, aplikasi, dan data di seluruh cloud, lokal, dan lingkungan hibrid.

Saat Anda maju melalui panduan, Anda menyelesaikan tugas tingkat tinggi berikut:

Buat ruang kerja dan proyek aplikasi logika Standar dengan alur kerja stateful yang kosong.
Tambahkan pemicu dan tindakan ke alur kerja Anda.
Jalankan, debug, dan uji secara lokal.
Tinjau riwayat eksekusi alur kerja.
Temukan detail nama domain untuk akses firewall.
Aktifkan riwayat pengoperasian untuk alur kerja tanpa status.
Sebarkan ke Azure, yang mencakup opsi untuk mengaktifkan Application Insights.
Aktifkan atau buka Application Insights setelah penyebaran.
Kelola sumber daya aplikasi logika yang Anda sebarkan di Visual Studio Code dan portal Microsoft Azure.

Prasyarat

Persyaratan akses dan konektivitas

Jika Anda berencana untuk membuat dan menjalankan alur kerja secara lokal hanya menggunakan operasi bawaan, yang berjalan secara asli pada runtime Azure Logic Apps (Standar), Anda tidak memerlukan persyaratan akses dan konektivitas di bagian ini. Namun, untuk skenario berikut, Anda perlu memenuhi persyaratan ini:

Sebarkan aplikasi logika Anda ke Azure dari Visual Studio Code.
Bangun alur kerja yang menggunakan operasi konektor terkelola yang berjalan di Azure global.
Akses sumber daya dan alur kerja aplikasi logika Standar yang ada di Azure atau sumber daya Azure lainnya yang disebarkan.

Persyaratan ini mencakup item berikut:

Akun dan langganan Azure. Jika Anda tidak memiliki langganan, daftar untuk mendapatkan akun Azure secara gratis.
Akses ke internet sehingga Anda dapat mengunduh ekstensi yang diperlukan, menyambungkan dari Visual Studio Code ke akun Azure Anda, menguji alur kerja yang menyertakan operasi konektor terkelola, dan menyebarkan ke Azure dari Visual Studio Code.
Untuk membuat contoh alur kerja yang sama dalam panduan ini, Anda memerlukan akun email Office 365 Outlook yang menggunakan akun kerja atau sekolah Microsoft untuk masuk.

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. Jika Anda memilih konektor email lain, seperti Outlook.com, Anda masih bisa mengikuti contoh, dan langkah keseluruhan umumnya sama. Namun, pengalaman dan opsi Anda mungkin berbeda dalam beberapa hal. Misalnya, dengan konektor Outlook.com, gunakan akun Microsoft pribadi Anda untuk masuk.

Alat

Unduh dan instal Visual Studio Code, yang gratis.
Unduh dan instal ekstensi Azure Logic Apps (Standar) untuk Visual Studio Code dengan mengikuti langkah-langkah berikut:
1. Di Visual Studio Code, pada bilah Aktivitas, pilih Ekstensi. (Keyboard: Tekan Ctrl+Shift+X)
2. Dalam kotak pencarian ekstensi, masukkan azure logic apps standar. Dari daftar hasil, pilih Azure Logic Apps (Standard)>Pasang.
  
  Ekstensi mengunduh dan menginstal semua dependensi yang diperlukan dan versi yang benar untuk kerangka kerja berikut:
  - Azure Functions Core Tools (Alat Inti Fungsi Azure)
  - .NET SDK
  - Node.js
  Setelah penginstalan selesai, ekstensi muncul di daftar Ekstensi: Terpasang.
3. Muat ulang atau mulai ulang Visual Studio Code untuk memastikan ekstensi dan semua dependensi diinstal dengan benar.
4. Untuk mengonfirmasi bahwa ekstensi dan semua dependensi terinstal dengan benar, lihat Memeriksa penginstalan ekstensi.
Saat ini, Anda dapat menginstal ekstensi Konsumsi (multipenyewa) dan Standar (penyewa tunggal) secara bersamaan. Pengalaman pengembangan berbeda satu sama lain dalam beberapa cara, tetapi langganan Azure Anda dapat menyertakan jenis sumber daya aplikasi logika Standar dan Konsumsi. Di Visual Studio Code, panel Azure memperlihatkan semua aplikasi logika yang disebarkan dan dihosting Azure di langganan Azure Anda, tetapi menata aplikasi Anda dengan cara berikut:
- Bagian Sumber Daya : Semua aplikasi logika Standar di langganan Anda.
- Bagian Logic Apps (Konsumsi) : Semua aplikasi logika Konsumsi di langganan Anda.
Untuk menjalankan pemicu dan tindakan berbasis webhook secara lokal, seperti pemicu Http Webhook bawaan, Anda perlu menyiapkan penerusan untuk URL panggilan balik di Visual Studio Code.
Untuk mengaktifkan pengelogan dan pelacakan diagnostik dengan Application Insights untuk aplikasi logika Standar, Anda dapat menyelesaikan tugas ini baik selama penyebaran aplikasi logika atau setelah penyebaran. Anda harus memiliki sumber daya Application Insights, tetapi Anda dapat membuat sumber daya ini terlebih dahulu, selama penyebaran, atau setelah penyebaran.
Instal atau gunakan alat yang dapat mengirim permintaan HTTP untuk menguji alur kerja sampel, misalnya:
- Visual Studio Code dengan ekstensi dari Visual Studio Marketplace
- PowerShell Invoke-RestMethod
- Microsoft Edge - Alat Konsol Jaringan
- Bruno
- Curl
Perhatian

Untuk skenario di mana Anda memiliki data sensitif, seperti kredensial, rahasia, token akses, kunci API, dan informasi serupa lainnya, pastikan untuk menggunakan alat yang melindungi data Anda dengan fitur keamanan yang diperlukan. Alat ini harus berfungsi secara offline atau lokal, dan tidak memerlukan masuk ke akun online atau menyinkronkan data ke cloud. Saat Anda menggunakan alat dengan karakteristik ini, Anda mengurangi risiko mengekspos data sensitif ke publik.

Periksa penginstalan ekstensi

Untuk memastikan bahwa ekstensi dan semua dependensi diinstal 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 Pengaturan>Preferensi.
2. Pada tab Pengguna, buka Ekstensi>Fitur.
3. Pastikan Pembaruan Pemeriksaan Otomatis dipilih, dan Pembaruan Otomatis diatur ke Semua Ekstensi.
Konfirmasikan bahwa pengaturan Azure Logic Apps Standard: Project Runtime diatur ke versi yang benar:
1. Pada tab Pengguna, buka >Ekstensi>Azure Logic Apps (Standard).
2. Pastikan Project Runtime diatur ke versi ~4, misalnya:
  
  Nota
  
  Versi ini diperlukan untuk menggunakan tindakan Operasi Kode Sebaris.

Menyambungkan ke akun Azure Anda

Jika Anda belum tersambung ke akun Azure Anda, ikuti langkah-langkah berikut untuk menyambungkan:

Di Visual Studio Code, pada Bilah Aktivitas, pilih ikon Azure untuk membuka panel Azure .
Di panel Azure, di bawah Sumber Daya, pilih Masuk ke Azure. Saat halaman autentikasi Visual Studio Code muncul, masuk dengan akun Azure Anda.

Setelah Anda masuk, panel 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 yang diperbarui muncul, pilih langganan yang Anda inginkan, dan pastikan Anda memilih OK.

Membuat ruang kerja lokal

Proyek aplikasi logika selalu memerlukan ruang kerja. Jadi, sebelum dapat membuat aplikasi logika, Anda harus membuat ruang kerja tempat Anda menyimpan proyek aplikasi logika. Anda kemudian menggunakan ruang kerja dan proyek ini untuk mengelola, menjalankan, dan menyebarkan aplikasi logika Anda dari Visual Studio Code ke lingkungan penyebaran Anda. Proyek yang mendasarinya mirip dengan proyek Azure Functions, juga dikenal sebagai proyek aplikasi fungsi.

Di komputer Anda, buat folder lokal kosong untuk digunakan nanti untuk ruang kerja dan proyek.

Contoh ini membuat folder bernama fabrikam-workflows.
Di Visual Studio Code, tutup semua folder yang terbuka.
Di jendela Azure , pada toolbar bagian Ruang Kerja , dari menu Azure Logic Apps , pilih Buat ruang kerja aplikasi logika baru.

Jika Windows Defender Firewall meminta Anda untuk memberikan akses jaringan untuk Code.exe, yaitu Visual Studio Code, dan untuk func.exe, yang merupakan Azure Functions Core Tools, pilih >.
Di jendela Pilih Folder , buka lokasi tempat Anda membuat folder, pilih folder, dan pilih Pilih (jangan pilih ganda folder).

Pada toolbar Visual Studio Code, perintah muncul bagi Anda untuk memberi nama ruang kerja Anda.
Untuk Berikan nama ruang kerja, masukkan nama ruang kerja yang akan digunakan.

Contoh ini menggunakan Fabrikam-Workflows.

Selanjutnya, buat proyek aplikasi logika Anda.

Membuat proyek aplikasi logika Anda

Setelah Anda membuat ruang kerja yang diperlukan, ikuti perintah untuk membuat proyek Anda.

Untuk templat proyek Anda, pilih Aplikasi logika. Masukkan nama proyek yang akan digunakan.

Contoh ini menggunakan Fabrikam-Workflows.
Untuk templat alur kerja Anda, pilih Alur Kerja Stateful atau Alur Kerja Tanpa Status, berdasarkan skenario Anda. Masukkan nama alur kerja yang akan digunakan.

Contoh ini memilih Alur Kerja Stateful, yang menyimpan riwayat alur kerja, input, dan output, dan menggunakan Stateful-Workflow sebagai nama.

Alur kerja tanpa status tidak menyimpan data ini dan saat ini hanya mendukung tindakan konektor terkelola, bukan pemicu. Meskipun Anda memiliki opsi untuk mengaktifkan konektor di Azure untuk alur kerja tanpa status Anda, perancang tidak menunjukkan pemicu konektor terkelola apa pun yang dapat Anda pilih.

Nota

Jika Anda mendapatkan kesalahan bernama azureLogicAppsStandard.createNewProject dengan pesan kesalahan, Tidak dapat menulis ke Pengaturan Ruang Kerja karena azureFunctions.suppressProject bukan konfigurasi terdaftar, coba instal ulang ekstensi Azure Functions untuk Visual Studio Code, baik langsung dari Visual Studio Marketplace atau dari dalam Visual Studio Code.
Sekarang, pilih apakah Anda ingin membuka proyek di jendela Visual Studio Code saat ini atau jendela baru. Pilih Buka di jendela saat ini atau Buka di jendela baru, berdasarkan preferensi Anda.

Panel Explorer terbuka untuk memperlihatkan ruang kerja, proyek, dan file workflow.json yang dibuka secara otomatis. File ini ada di folder bernama Stateful-Workflow dan menyimpan definisi JSON yang mendasar untuk alur kerja yang Anda buat di perancang. Untuk informasi tentang struktur proyek Anda, lihat Struktur proyek aplikasi logika standar.

Anda juga mendapatkan permintaan untuk mengaktifkan konektor "shared" multitenant yang dihosting di Azure, misalnya:
Untuk mengaktifkan semua konektor "bersama" terkelola yang berjalan di Azure multipenyewa sehingga Anda dapat melihat dan memilih untuk menggunakannya di alur kerja Anda, pilih Gunakan konektor dari Azure.

Nota

Jika Anda tidak memilih opsi ini, dan kemudian mencoba menambahkan operasi konektor terkelola saat membuat alur kerja, Anda tidak dapat melanjutkan karena panel informasi operasi memperlihatkan lingkaran berputar yang tidak berhenti.
Untuk grup sumber daya Azure, pilih Buat grup sumber daya baru. Masukkan nama grup sumber daya yang akan digunakan.

Contoh ini menggunakan Fabrikam-Workflows-RG.
Untuk langganan, pilih langganan Azure untuk digunakan dengan proyek aplikasi logika Anda.
Untuk lokasi tempat membuat grup dan sumber daya Anda, pilih wilayah Azure.

Contoh ini menggunakan AS Tengah Barat.

Jika proyek Anda memerlukan penyiapan lain untuk pengembangan atau memerlukan artefak pendukung untuk membangun alur kerja Anda, lihat skenario dan tugas terkait berikut:

Skenario	Tugas
Jalankan pemicu atau tindakan berbasis webhook secara lokal.	Siapkan penerusan untuk URL panggilan balik webhook.
Siapkan riwayat menjalankan workflow tanpa status.	Aktifkan riwayat eksekusi untuk alur kerja tanpa status.
Tambahkan artefak dan dependensi, seperti peta, skema, dan rakitan.	Tambahkan artefak dan dependensi.
Bekerja dengan proyek berbasis NuGet (.NET)	Konversikan proyek bundel berbasis ekstensi (Node.js) ke proyek berbasis paket NuGet (.NET). Catatan: Untuk mengonversi proyek berbasis bundel ekstensi (Node.js) yang Anda buat sebelum dukungan rakitan ada, lihat juga Memigrasikan proyek berbasis paket NuGet untuk menggunakan rakitan di folder lib.
Buat konektor bawaan Anda sendiri.	1. Konversikan proyek berbasis bundel ekstensi (Node.js) ke proyek berbasis paket NuGet (.NET ). 2. Mengaktifkan penulisan konektor bawaan.

Sekarang, buka perancang alur kerja.

Buka perancang alur kerja

Setelah proyek Anda terbuka di panel Explorer, buka perancang sehingga Anda bisa membangun alur kerja Anda.

Dari menu pintasan file workflow.json, pilih Buka Desainer.

Cuplikan layar memperlihatkan panel Explorer, menu pintasan file workflow.json, dan Open Designer dipilih.

Nota

Setelah Anda memilih opsi ini, Anda mungkin mendapatkan pesan bahwa startup mungkin memakan waktu beberapa detik karena "memulai API waktu desain alur kerja". Anda bisa mengabaikan pesan ini atau memilih OK.

Visual Studio Code membuka perancang alur kerja dan menampilkan perintah Tambahkan pemicu , misalnya:

Cuplikan layar memperlihatkan perancang dengan alur kerja kosong.

Nota

Jika perancang tidak terbuka, lihat bagian pemecahan masalah, Perancang gagal terbuka.

Selanjutnya, tambahkan pemicu dan tindakan untuk membuat alur kerja Anda.

Menambahkan pemicu dan tindakan

Untuk membuat alur kerja Anda, mulai alur kerja Anda dengan pemicu, lalu awalnya tambahkan satu tindakan. Dengan demikian, Anda dapat menguji alur kerja sebelum menambahkan tindakan berikutnya. Contoh alur kerja menggunakan pemicu dan tindakan berikut, yang secara kolektif dikenal sebagai operasi:

Konektor atau grup operasi	Nama operasi	Jenis operasi	Deskripsi
Permintaan	Ketika permintaan HTTP diterima	Pemicu (bawaan)	Membuat URL titik akhir pada alur kerja untuk menerima panggilan masuk atau permintaan dari layanan lain atau alur kerja aplikasi logika. Untuk informasi selengkapnya, lihat Menerima dan merespons panggilan HTTP masuk ke alur kerja.
Office 365 Outlook	Kirim email	Tindakan (terkelola)	Kirim email menggunakan akun Outlook Office 365. Untuk mengikuti langkah-langkah dalam panduan ini, Anda memerlukan akun email Outlook Office 365. Untuk informasi selengkapnya, lihat Menyambungkan ke Office 365 Outlook dari Azure Logic Apps. Catatan: Jika Anda memiliki akun email yang didukung oleh konektor lain, Anda dapat menggunakan konektor tersebut, tetapi pengalaman pengguna konektor tersebut berbeda dari langkah-langkah dalam contoh ini.
Permintaan	Respons	Tindakan (bawaan)	Kirim balasan dan kembalikan data ke pemanggil. Untuk informasi selengkapnya, lihat Menambahkan tindakan Respons.

Tambahkan pemicu permintaan

Pada perancang alur kerja, pilih Tambahkan pemicu, jika belum dipilih.

Panel Tambahkan pemicu terbuka dan memperlihatkan galeri tempat Anda bisa memilih dari konektor dan grup operasi yang tersedia, misalnya:
Di panel Tambahkan pemicu , ikuti langkah-langkah umum ini untuk menambahkan pemicu Permintaan bernama Saat permintaan HTTP diterima.

Contoh berikut memilih opsi Bawaan sehingga hanya pemicu bawaan yang muncul:

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

Nota

Jika panel informasi pemicu tidak muncul, pastikan bahwa pemicu dipilih pada perancang.
Simpan alur kerja Anda. Pada toolbar desainer, pilih Simpan .

Menambahkan tindakan Office 365 Outlook

Pada perancang, di bawah pemicu Permintaan , ikuti langkah-langkah umum ini untuk menambahkan tindakan Office 365 Outlook bernama Kirim email (V2).

Jika tindakan tidak muncul di hasil awal, di samping nama konektor, pilih Lihat selengkapnya, misalnya:
Saat panel autentikasi tindakan muncul, pilih Masuk untuk membuat koneksi ke akun email Anda.
Ikuti perintah berikutnya untuk mengautentikasi kredensial Anda, mengizinkan akses, dan mengizinkan kembali ke Visual Studio Code.

Nota

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 autentikasi Microsoft muncul, pilih akun pengguna Anda untuk Office 365 Outlook. Pada halaman konfirmasi yang diperlukan yang terbuka, pilih Izinkan akses.
2. Saat Azure Logic Apps meminta untuk membuka tautan Visual Studio Code, pilih Buka.
3. Saat Visual Studio Code meminta Anda untuk membuka ekstensi Microsoft Azure Tools, pilih Buka.
Setelah Visual Studio Code membuat koneksi Anda, beberapa konektor menunjukkan pesan bahwa Koneksi hanya akan berlaku selama <n> hari. 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 selama runtime dengan menggunakan identitas dikelola sistem yang diaktifkan secara otomatis. Identitas terkelola ini berbeda dari kredensial autentikasi atau string koneksi yang Anda gunakan ketika membuat koneksi. Jika Anda menonaktifkan identitas terkelola yang ditetapkan sistem ini, koneksi tidak akan berfungsi pada waktu proses.

Di panel Kirim informasi email yang terbuka, pada tab Parameter , berikan informasi yang diperlukan untuk tindakan tersebut.

Nota

Jika panel informasi tindakan tidak terbuka secara otomatis, pilih tindakan Kirim email pada perancang.

Harta benda	Diperlukan	Nilai	Deskripsi
Ke	Ya	< alamat email Anda>	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!	Isi konten email

Contohnya:

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

Simpan alur kerja Anda. Pada desainer, pilih Simpan.

Struktur proyek aplikasi logika standar

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 mungkin menyertakan folder atau file yang sedikit berbeda. Misalnya, proyek berbasis paket Nuget memiliki folder .bin yang berisi paket dan file pustaka lainnya. Proyek berbasis bundel ekstensi tidak menyertakan folder .bin ini.

Beberapa skenario memerlukan proyek berbasis paket NuGet agar aplikasi Anda berjalan, 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.

Proyek berbasis bundel ekstensi default memiliki folder dan struktur file yang mirip dengan contoh berikut:

MyWorkspaceName
| MyBundleBasedLogicAppProjectName
  || .vscode
  || Artifacts
     ||| Maps 
         |||| MapName1
         |||| ...
     ||| Rules
     ||| Schemas
         |||| SchemaName1
         |||| ...
  || lib
     ||| builtinOperationSdks
         |||| JAR
         |||| net472
     ||| custom
  || WorkflowName1
     ||| workflow.json
     ||| ...
  || WorkflowName2
     ||| workflow.json
     ||| ...
  || workflow-designtime
     ||| host.json
     ||| local.settings.json
  || .funcignore
  || connections.json
  || host.json
  || local.settings.json

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

Nama	Folder atau file	Deskripsi
.vscode	Map	Berisi pengaturan terkait Visual Studio Code, seperti file extensions.json, launch.json, settings.json, dan tasks.json files.
Artefak	Map	Berisi artefak akun integrasi yang Anda tentukan dan gunakan dalam alur kerja yang mendukung skenario business-to-business (B2B). Misalnya, struktur sampel menyertakan folder berikut: - Peta: Berisi peta yang akan digunakan untuk operasi transformasi XML. - Skema: Berisi skema yang akan digunakan untuk operasi validasi XML. - Aturan: Artefak untuk aturan bisnis dalam proyek mesin berbasis aturan.
Lib	Map	Berisi rakitan yang didukung yang dapat digunakan atau dirujuk oleh aplikasi logika Anda. Anda dapat mengunggah rakitan ini ke proyek Anda di Visual Studio Code, tetapi Anda harus menambahkannya ke folder tertentu dalam proyek Anda. Misalnya, folder ini menyertakan folder berikut: - builtinOperationSdks: Berisi folder JAR dan net472 untuk rakitan Java dan .NET Framework. - kustom: Berisi komponen kustom .NET Framework. Untuk informasi selengkapnya tentang jenis rakitan yang didukung dan tempat meletakkannya di proyek Anda, lihat Menambahkan rakitan ke proyek Anda.
*< WorkflowName>*	Map	Untuk setiap alur kerja, folder <WorkflowName> menyertakan file workflow.json, yang berisi definisi JSON yang mendasari alur kerja tersebut.
alur kerja-waktu desain	Map	Berisi file pengaturan terkait lingkungan pengembangan.
.funcignore	Arsip	Berisi informasi yang terkait dengan Alat Inti Azure Functions yang Anda pasang.
connections.json	Arsip	Berisi metadata, kunci, dan titik akhir untuk sambungan terkelola serta fungsi Azure yang digunakan oleh 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	Arsip	Berisi pengaturan dan nilai konfigurasi spesifik runtime, misalnya, batas default untuk platform penyewa tunggal Azure Logic Apps, 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. Untuk informasi referensi, lihat Mengedit pengaturan aplikasi dan pengaturan host. 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	Arsip	Berisi pengaturan aplikasi, string sambungan, dan pengaturan lain yang digunakan alur kerja Anda saat berjalan secara lokal. Pengaturan dan nilai ini hanya berlaku saat Anda menjalankan proyek di lingkungan pengembangan lokal Anda. 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 alat pengembangan lokal Anda untuk `appSettings` nilai. 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. File ini juga berisi pengaturan aplikasi yang perlu berfungsi dengan benar oleh aplikasi logika Anda. Untuk informasi referensi, lihat Mengedit pengaturan aplikasi dan pengaturan host.

Tugas penyiapan pengembangan lainnya

Setelah membuat proyek, Anda mungkin masih memiliki tugas penyiapan lain untuk mendukung skenario pengembangan lokal tertentu sekeliling membangun, menjalankan, dan menyebarkan aplikasi logika Standar menggunakan Visual Studio Code. Bagian berikut ini menjelaskan tugas untuk skenario ini.

Aktifkan webhook yang berjalan secara lokal

Operasi webhook adalah pemicu atau tindakan alur kerja yang menunggu peristiwa terjadi sebelum operasi dapat dijalankan. Secara khusus, operasi webhook menunggu permintaan HTTPS tiba dari layanan pemanggil atau alur kerja sebelum operasi dapat dilanjutkan. Misalnya, webhook menyertakan operasi seperti pemicu Permintaan dan pemicu HTTP + Webhook .

Di portal Microsoft Azure, runtime Azure Logic Apps secara otomatis berlangganan webhook ke layanan pemanggil atau alur kerja. Runtime mendaftarkan URL panggilan balik untuk webhook ke layanan atau alur kerja pemanggil. Webhook kemudian menunggu penelepon mengirim permintaan menggunakan URL panggilan balik.

Namun, di Visual Studio Code, Anda harus menyelesaikan beberapa tugas penyiapan agar operasi webhook berfungsi dengan benar. Dalam skenario ini, URL panggilan balik menggunakan server localhost Anda (http://localhost:7071/...), yang bersifat privat, sehingga pemanggil tidak dapat langsung mengirim permintaan melalui internet ke URL ini.

Untuk operasi webhook dalam alur kerja yang berjalan secara lokal, Anda perlu menyiapkan URL publik yang mengekspos server localhost Anda dan meneruskan panggilan dengan aman dari penelepon ke URL panggilan balik. Anda dapat menggunakan layanan penerusan dan alat seperti ngrok, yang membuka terowongan HTTP ke port localhost Anda, atau gunakan alat yang serupa milik Anda.

Mengatur penerusan panggilan dengan menggunakan ngrok

Pergi ke situs web ngrok. Daftar untuk akun baru atau masuk ke akun Anda, jika Anda sudah memilikinya.
Dapatkan token autentikasi pribadi Anda, yang diperlukan oleh klien ngrok Anda untuk 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 Anda, buka Command Prompt. Telusuri ke lokasi tempat Anda memiliki file filengrok.exe.
Sambungkan klien ngrok ke akun ngrok Anda dengan menjalankan perintah berikut:

ngrok authtoken <your-authentication-token>

Untuk informasi selengkapnya, lihat Langkah 2: Menyambungkan akun Anda.
Buka terowongan HTTP ke port localhost 7071 dengan menjalankan perintah berikut:

ngrok http 7071

Untuk informasi selengkapnya, lihat Langkah 3: Nyalakan.
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 operasi webhook yang ingin Anda gunakan di alur kerja Anda.

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

Nota

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 operasi webhook berikutnya yang mungkin Anda tambahkan.

Untuk membuat jendela prompt muncul, di direktori akar proyek Anda, buka menu pintasan file local.settings.json dan pilih Konfigurasikan Endpoint 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. Values Di objek, properti bernama Workflows.WebhookRedirectHostUri sekarang muncul dan diatur ke URL penerusan, misalnya:
```
{
   "IsEncrypted": false,
   "Values": {
      "AzureWebJobsStorage": "UseDevelopmentStorage=true",
      "FUNCTIONS_WORKER_RUNTIME": "dotnet",
      "FUNCTIONS_V2_COMPATIBILITY_MODE": "true",
      <...>
      "Workflows.WebhookRedirectHostUri": "http://xxxXXXXxxxXXX.ngrok.io",
      <...>
   }
}
```
Untuk informasi selengkapnya tentang pengaturan aplikasi ini, lihat Mengedit pengaturan aplikasi dan pengaturan host untuk aplikasi logika Standar.

Pada pertama kali Anda memulai sesi penelusuran kesalahan lokal atau menjalankan alur kerja tanpa penelusuran kesalahan, runtime Azure Logic Apps akan mendaftarkan alur kerja ke pemanggil dan berlangganan pada endpoint pemanggil yang 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 debugging untuk alur kerja yang menggunakan operasi webhook yang dijalankan secara lokal, pendaftaran langganan yang sudah ada tidak dihapus. Untuk membatalkan pendaftaran, Anda harus menghapus atau menghapus pendaftaran langganan secara manual.

Nota

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"

Mengaktifkan riwayat jalankan 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.<workflow-name>.operationOptions Tambahkan properti , dan atur nilai ke WithStatelessRunHistory, misalnya:

Windows

{
   "IsEncrypted": false,
   "Values": {
      "AzureWebJobsStorage": "UseDevelopmentStorage=true",
      "FUNCTIONS_WORKER_RUNTIME": "dotnet",
      "Workflows.<workflow-name>.OperationOptions": "WithStatelessRunHistory"
   }
}

macOS atau Linux

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

Di folder proyek bernama workflow-designtime, buka file local.settings.json , dan buat perubahan yang sama.
Untuk menonaktifkan riwayat eksekusi saat Anda selesai, atur Workflows.<workflow-name>.OperationOptions properti ke None, atau hapus properti dan nilainya.

Menambahkan artefak dan dependensi ke proyek Anda

Dalam skenario tertentu, alur kerja Anda mungkin menyertakan operasi yang memerlukan dependensi seperti rakitan, atau artefak seperti peta, skema, atau aturan. Di Visual Studio Code, Anda dapat menambahkan item ini ke folder terkait di proyek Anda, misalnya:

Barang	Jenis file	Deskripsi
Peta	.xslt	Untuk informasi selengkapnya, lihat Menambahkan peta untuk transformasi dalam alur kerja.
Skema	.xsd	Untuk informasi selengkapnya, lihat Menambahkan skema untuk validasi.
Aturan	.xml	Untuk informasi selengkapnya, lihat Membuat proyek Mesin Aturan Azure Logic Apps.
Perakitan	- .dll (.NET Framework atau .NET 8) - .jar (Java)	Sumber daya 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 proyek tertentu. Untuk informasi selengkapnya, lihat Menambahkan rakitan yang dirujuk. Catatan: Jika Anda memiliki proyek aplikasi logika berbasis paket NuGet (.NET) sebelum dukungan rakitan tersedia, lihat Memigrasikan proyek berbasis paket NuGet untuk menggunakan rakitan di folder lib.

Mengonversi proyek Anda ke berbasis paket NuGet (.NET)

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

Penting

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

Di panel Explorer, gerakkan penunjuk mouse Anda ke area kosong apa pun di bawah folder dan file proyek Anda, buka menu pintasan, dan pilih Konversi ke proyek aplikasi logika berbasis NuGet.
Saat prompt muncul, konfirmasikan konversi proyek.

Migrasikan proyek berbasis paket NuGet untuk menggunakan rakitan di folder "lib"

Penting

Tugas ini hanya diperlukan untuk proyek aplikasi logika berbasis paket NuGet (.NET) yang dibuat sebelum dukungan rakitan tersedia.

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>:

Cuplikan layar menampilkan rakitan yang telah dimigrasikan dan kode yang ditambahkan dalam file CSPROJ.

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 berbasis bundel ekstensi (Node.js) Anda ke proyek berbasis paket NuGet (.NET).
Tinjau dan ikuti langkah-langkah dalam artikel, Azure Logic Apps Berjalan di Mana Saja - Ekstensibilitas konektor bawaan.

Menjalankan, men-debug, dan menguji alur kerja secara lokal

Bagian berikut menunjukkan bagaimana Anda dapat mengatur titik henti dan memulai sesi penelusuran kesalahan sehingga Anda dapat menjalankan dan menguji alur kerja Anda secara lokal.

Mengatur breakpoint untuk debugging

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

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

Atur titik jeda awal pada baris yang memperlihatkan nama tindakan. Saat titik henti ini muncul saat sesi debugging, Anda dapat meninjau input tindakan sebelum dievaluasi.
Atur titik jeda akhir pada baris yang memperlihatkan kurung kurawal penutup tindakan (}). Ketika titik henti ini tercapai selama sesi penelusuran kesalahan, Anda dapat meninjau hasil tindakan sebelum tindakan selesai beroperasi.

Untuk menambahkan titik henti, ikuti langkah ini:

Buka file workflow.json untuk alur kerja yang ingin Anda perbaiki 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.

Nota

Jika tampilan Jalankan tidak muncul secara otomatis, tekan Ctrl+Shift+D.
Untuk meninjau informasi yang tersedia saat titik henti tercapai, di 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.

Men-debug dan menguji alur kerja Anda

Untuk menguji alur kerja Anda, ikuti langkah-langkah ini untuk menjalankan sesi debugging dan menemukan URL untuk titik akhir yang dibuat oleh pemicu Permintaan. Anda memerlukan URL ini sehingga Anda nantinya dapat mengirim permintaan ke titik akhir tersebut.

Jika Anda memiliki alur kerja tanpa status, aktifkan riwayat eksekusi untuk alur kerja agar penelusuran kesalahan lebih mudah.
Dari menu Jalankan , pilih Mulai Debugging (F5).

Jendela Terminal terbuka sehingga Anda dapat meninjau sesi penelusuran kesalahan.

Nota

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 yang dibuat oleh pemicu Permintaan .
1. Buka kembali panel Explorer untuk menampilkan proyek Anda.
2. Dari menu pintasan file workflow.json , pilih Gambaran Umum.
3. Salin dan simpan URL Panggilan Balik, yang terlihat mirip dengan URL berikut untuk pemicu Saat permintaan HTTP diterima dalam contoh ini:
  
  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 dan memicu alur kerja, kirim permintaan HTTP ke URL, termasuk metode yang diharapkan pemicu, dengan menggunakan alat permintaan HTTP Anda dan instruksinya.

Contoh ini menggunakan metode GET dengan URL yang disalin, yang terlihat seperti sampel berikut:

GET http://localhost:7071/api/Stateful-Workflow/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<shared-access-signature>

Saat pemicu diaktifkan, contoh alur kerja berjalan dan mengirim email yang tampak mirip dengan contoh ini:

Di Visual Studio Code, kembali ke halaman ringkasan alur kerja Anda. Di bagian Riwayat Jalankan, periksa status eksekusi alur kerja.

Petunjuk / Saran

Jika status eksekusi tidak muncul, coba refresh halaman gambaran umum dengan memilih Refresh. Eksekusi tidak terjadi untuk pemicu yang dilewati karena kriteria yang tidak terukur atau tidak menemukan data.

Cuplikan layar yang memperlihatkan halaman gambaran umum alur kerja dengan status dan riwayat eksekusi.

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

Status pelaksanaan	Deskripsi
Dibatalkan	Eksekusi berhenti atau tidak selesai karena masalah eksternal, misalnya, pemadaman sistem atau langganan Azure berakhir.
dibatalkan	Proses dipicu dan dimulai, tetapi menerima permintaan pembatalan.
Gagal	Setidaknya satu tindakan dalam proses gagal. Tidak ada tindakan berikutnya dalam alur kerja yang disiapkan untuk menangani kegagalan.
Berjalan	Pelaksanaan dipicu dan sedang berjalan, tetapi status ini juga dapat muncul untuk pelaksanaan yang terhambat karena batas tindakan atau rencana harga saat ini. Tip: Jika Anda menyiapkan pembuatan log diagnostik, Anda bisa mendapatkan informasi tentang kejadian pembatasan apa pun yang terjadi.
Berhasil	Pelaksanaan berhasil. Jika tindakan gagal, tindakan berikutnya dalam alur kerja menangani kegagalan tersebut.
Waktu habis	Waktu eksekusi habis karena durasi saat ini melebihi batas durasi eksekusi, yang diatur oleh pengaturan dengan nama Retensi riwayat eksekusi dalam hitungan hari. Durasi eksekusi dihitung menggunakan waktu mulai eksekusi dan batas durasi eksekusi pada waktu mulai tersebut. Catatan: Jika durasi pelaksanaan juga melebihi batas retensi riwayat pelaksanaan saat ini, yang juga dikontrol oleh pengaturan 'Retensi Riwayat Pelaksanaan dalam Hari', pelaksanaan dibersihkan dari riwayat pelaksanaan oleh tugas pembersihan harian. Baik ketika proses berjalan hingga habis maupun selesai, periode retensi selalu dihitung dari waktu mulai proses dan batas retensi saat ini. Jadi, jika Anda mengurangi batas durasi untuk eksekusi dalam penerbangan, waktu habis 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 instance alur kerja sebelumnya masih berjalan.

Untuk melihat status, input, dan output setiap langkah untuk eksekusi alur kerja tertentu, pilih salah satu langkah:

Di kolom Pengidentifikasi , pilih ID eksekusi alur kerja.
Di samping kolom Durasi , buka menu elipsis (...) untuk eksekusi alur kerja, dan pilih Perlihatkan eksekusi, misalnya:

Visual Studio Code membuka tampilan detail eksekusi dan menampilkan status untuk setiap langkah dalam eksekusi alur kerja.

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

Nota

Jika eksekusi gagal dan langkah dalam tampilan detail eksekusi 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 Permintaan Buruk.

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

Status tindakan	Deskripsi
Dibatalkan	Eksekusi berhenti atau tidak selesai karena masalah eksternal, misalnya, pemadaman sistem atau langganan Azure berakhir.
dibatalkan	Aksi ini sedang berjalan tetapi menerima permintaan pembatalan.
Gagal	Tindakan gagal
Berjalan	Aksi saat ini sedang berjalan.
Melewatkan	Aksi tersebut dilewati karena aksi sebelumnya gagal. Tindakan memiliki `runAfter` kondisi yang mengharuskan tindakan sebelumnya berhasil diselesaikan sebelum tindakan saat ini dapat berjalan.
Berhasil	Tindakannya berhasil.
Berhasil setelah usaha ulang	Aksi berhasil tetapi hanya setelah satu atau beberapa kali dicoba ulang. Untuk meninjau riwayat percobaan ulang, dalam tampilan detail riwayat eksekusi, pilih tindakan tersebut sehingga Anda dapat melihat input dan output.
Waktu habis	Tindakan berhenti 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 output untuk setiap langkah, pilih langkah yang Anda inginkan, misalnya:

Untuk melihat input dan output mentah, pilih Tampilkan input mentah atau Tampilkan output mentah.
Untuk menghentikan sesi penelusuran kesalahan, pada menu Jalankan, pilih Hentikan Debugging (Shift + F5).

Mengembalikan respons

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

Di perancang alur kerja, di bawah tindakan Kirim email , ikuti langkah-langkah umum ini untuk menambahkan tindakan Permintaan bernama Respons.
Di panel Informasi tindakan respons , pada tab Parameter , berikan informasi yang diperlukan untuk respons terhadap pemanggil.

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 Anda selesai, properti Isi dari tindakan Respons sekarang diatur ke nilai Output dari Isi tindakan Kirim email, misalnya:
Simpan alur kerja Anda.

Coba lagi alur kerja Anda

Untuk menguji pembaruan, Anda dapat menjalankan ulang debugger dan mengirim permintaan lain yang memicu alur kerja Anda, mirip dengan langkah-langkah dalam Menjalankan, men-debug, dan menguji alur kerja secara lokal.

Pada toolbar Visual Studio Code, dari menu Jalankan , dan pilih Mulai Debugging (F5).
Di alat Anda untuk membuat dan mengirim permintaan, kirim permintaan lain untuk memicu alur kerja Anda.
Pada halaman gambaran umum alur kerja, di bawah Jalankan riwayat, periksa status untuk eksekusi terbaru, dan buka tampilan detail eksekusi.

Misalnya, berikut adalah status langkah demi langkah untuk eksekusi setelah contoh alur kerja diperbarui dengan tindakan Respons .
Untuk menghentikan sesi penelusuran kesalahan, pada menu Jalankan, pilih Hentikan Debugging (Shift + F5).

Persiapkan untuk peluncuran

Sebelum Anda menyebarkan aplikasi logika Standar ke portal Microsoft Azure, tinjau bagian ini untuk persiapan apa pun yang mungkin perlu Anda lakukan.

Menyiapkan akses firewall

Jika lingkungan Anda memiliki persyaratan jaringan atau firewall ketat yang membatasi lalu lintas, Anda harus menyiapkan izin untuk koneksi apa pun yang dibuat oleh konektor terkelola, dihosting, dan dibagikan Azure dan digunakan dalam 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 local.settings.json .

Untuk setiap koneksi yang Anda buat, temukan properti bernama <connection-name>-ConnectionRuntimeUrl, yang menggunakan sintaks berikut:

"<connection-name>-ConnectionRuntimeUrl": <connection-runtime-URL>

Misalnya, Anda memiliki sampel file local.settings.json yang berisi koneksi ini: koneksi Office 365 dan koneksi AS2. Koneksi ini menggunakan nilai sampel masing-masing berikut untuk <connection-name>-ConnectionRuntimeUrl properti:

Office 365: "office365-ConnectionRuntimeUrl": https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/office365/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1"
AS2: "as2-ConnectionRuntimeUrl": https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/as2/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2

Contoh file local.settings.json terlihat mirip dengan versi berikut:

{
   "IsEncrypted": false,
   "Values": {
      "AzureWebJobsStorage": "UseDevelopmentStorage=true",
      "FUNCTIONS_WORKER_RUNTIME": "node",
      "APP_KIND": "workflowapp",
      "ProjectDirectoryPath": "c:\\Users\\<local-username>\\Desktop\\Visual Studio Code projects\\Azure Logic Apps\fabrikam-workflows\\Fabrikam-Workflows\\Fabrikam-Workflows",
      "WORKFLOWS_TENANT_ID": "<Microsoft-Entra-tenant-ID>",
      "WORKFLOWS_SUBSCRIPTION_ID": "<Azure-subscription-ID>",
      "WORKFLOWS_RESOURCE_GROUP_NAME": "Fabrikam-Workflows-RG",
      "WORKFLOWS_LOCATION_NAME": "westcentralus",
      "WORKFLOWS_MANAGEMENT_BASE_URI": "https://management.azure.com/",
      "as2-connectionKey": "<connection-key>",
      "as2-ConnectionRuntimeUrl": "https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/as2/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2",
      "office365-connectionKey": "<connection-key>",
      "office365-ConnectionRuntimeUrl": "https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/office365/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
   }
}

Salin dan simpan URL runtime koneksi ini di tempat yang aman sehingga Anda dapat menyiapkan firewall Anda dengan informasi ini.
Setelah siap, siapkan firewall Anda menggunakan URL yang disimpan. Untuk informasi selengkapnya, lihat dokumentasi berikut:
- Gambaran umum Kebijakan Azure Firewall Manager
- Menyebarkan dan mengonfigurasi Azure Firewall menggunakan portal Microsoft Azure - klasik.

Sebarkan ke Azure

Untuk menyebarkan aplikasi logika Standar dari Visual Studio Code, Anda dapat langsung menerbitkan proyek anda ke Azure. Anda dapat menerbitkan aplikasi logika sebagai sumber daya baru, yang secara otomatis membuat sumber daya yang diperlukan, seperti akun penyimpanan Azure, mirip dengan persyaratan aplikasi fungsi. Atau, Anda dapat menerbitkan aplikasi logika ke sumber daya aplikasi logika standar yang disebarkan sebelumnya, yang menggantikan versi yang disebarkan.

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

Menerbitkan ke sumber daya aplikasi logika Standar baru

Di panel Explorer, gerakkan penunjuk mouse Anda ke area kosong apa pun di bawah folder dan file proyek Anda, buka menu pintasan, dan pilih Sebarkan ke aplikasi logika.

Meskipun Anda tidak perlu membuka file apa pun untuk disebarkan, pastikan Anda menyimpan semua yang Anda rencanakan untuk disebarkan.

Anda diminta dengan opsi berikut untuk sumber daya aplikasi logika Standar tujuan. Anda dapat membuat aplikasi logika Standar baru atau memilih aplikasi logika Standar yang sudah disebarkan di Azure:
- Membuat Aplikasi Logika baru (Standar) di Azure (cepat)
- Membuat Logic App (Standar) baru di Azure Advanced
- Pilih dari sumber daya aplikasi logika Standar yang disebarkan sebelumnya, jika ada.
Untuk opsi penyebaran, pilih apakah akan membuat atau menggunakan sumber daya aplikasi logika tujuan yang ada.

Contoh ini berlanjut dengan Buat Aplikasi Logika baru (Standar) di Azure Lanjutan.

Ikuti langkah-langkah ini untuk membuat sumber daya aplikasi logika tujuan baru:

Masukkan nama unik global untuk aplikasi logika tujuan.

Contoh ini menggunakan Fabrikam-Workflows-App.
Untuk lokasi penerapan, pilih wilayah Azure.

Contoh ini menggunakan AS Tengah Barat.

Untuk paket hosting, pilih dari opsi berikut:

Paket hosting	Deskripsi
Standar Alur Kerja	Sebarkan sebagai sumber daya aplikasi logika standar yang baru dihosting dalam Azure Logic Apps dengan penyewa tunggal.
Hibrida	Sebarkan sebagai aplikasi logika Standar yang dihosting di infrastruktur Anda sendiri. Catatan: Sebelum Anda memilih opsi ini, pastikan Anda telah menyiapkan infrastruktur yang diperlukan. Untuk informasi selengkapnya, lihat Menyiapkan infrastruktur Anda sendiri untuk aplikasi logika Standar menggunakan penyebaran hibrid.

Untuk paket Windows App Service, pilih salah satu opsi berikut:
- Membuat paket App Service baru
- Pilih dari paket App Service yang sudah ada di wilayah Azure yang dipilih (hanya paket berbasis Windows), jika ada.
Contoh ini memilih Buat paket App Service baru.
Untuk paket baru, berikan nama unik global, dan pilih tingkat harga.

Contoh ini menggunakan Fabrikam-Workflows-App-Service-Plan, dan memilih tingkat Standar Alur Kerja WS1 .

Untuk informasi selengkapnya, lihat Paket hosting dan tingkat harga.
Untuk grup sumber daya Azure tujuan, pilih grup sumber daya yang sama dengan proyek Anda untuk performa optimal.

Contoh ini menggunakan grup yang dibuat sebelumnya yang sama bernama Fabrikam-Workflows-RG.

Nota

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.
Agar akun penyimpanan Azure dapat digunakan dengan alur kerja yang memungkinkan menyimpan informasi riwayat eksekusi, pilih dari opsi berikut:
- Membuat akun penyimpanan baru
- Pilih dari akun penyimpanan Azure yang sudah ada, jika ada.
Contoh ini memilih Buat akun penyimpanan baru.
Masukkan nama unik global untuk akun penyimpanan. Anda hanya dapat menggunakan huruf kecil dan angka.

Contoh ini menggunakan fabrikamstorageaccount<nomor>.
Untuk opsi menggunakan penyimpanan SQL dalam contoh ini, pilih Tidak.

Jika Anda sudah menyiapkan database SQL untuk digunakan untuk penyimpanan dengan mengikuti Menyiapkan penyimpanan database SQL untuk alur kerja aplikasi logika Standar, Anda dapat memilih Ya.
Untuk sumber daya Application Insights, yang memungkinkan pengelogan dan pelacakan diagnostik untuk aplikasi logika Anda, pilih dari opsi berikut:
- Membuat sumber daya Application Insights baru
- Lewati untuk saat ini. Anda dapat menyiapkan Application Insights setelah penyebaran.
- Pilih sumber daya Application Insights yang ada, jika ada.
Contoh ini memilih Lewati untuk saat ini.
Nota
- Jika Anda memiliki sumber daya Application Insights yang ingin Anda gunakan, Anda dapat memilih sumber daya tersebut.
- Untuk membuat sumber daya Application Insights baru saat ini sehingga Anda dapat mengaktifkan pembuatan log dan pelacakan diagnostik, lihat Mengaktifkan Application Insights selama penyebaran.
Untuk informasi selengkapnya tentang Application Insights, lihat dokumentasi berikut:
- gambaran umum Application Insights
- Membuat dan mengonfigurasi sumber daya Application Insights
Setelah Anda memilih Lewati untuk saat ini atau sumber daya Application Insights yang sudah ada, Visual Studio Code menampilkan pesan konfirmasi untuk memulai penyebaran. Pesan ini juga merekomendasikan bahwa untuk performa terbaik, letakkan sumber daya koneksi untuk operasi terkelola dalam grup sumber daya yang sama dengan sumber daya dan alur kerja aplikasi logika Anda. Di Azure Logic Apps, koneksi operasi terkelola ada sebagai sumber daya Azure individual.

Saat Anda siap untuk menyebarkan, dalam pesan konfirmasi, pilih Sebarkan.

Visual Studio Code mulai membuat dan menyebarkan sumber daya yang diperlukan untuk menerbitkan aplikasi logika Anda ke Azure.
Untuk melihat dan memantau proses penyebaran, pada menu Tampilan , pilih Output.
Di toolbar jendela Output , dari daftar cakupan, pilih Azure Logic Apps (Standar).

Saat Visual Studio Code selesai menyebarkan aplikasi logika Anda ke Azure, muncul pesan bahwa pembuatan aplikasi logika berhasil diselesaikan, misalnya:

Sumber daya dan alur kerja aplikasi logika Anda sekarang aktif, diaktifkan, dan berjalan di Azure.

Aktifkan Application Insights saat penyebaran

Untuk mengaktifkan pengelogan dan pelacakan diagnostik dengan Application Insights selama penyebaran untuk aplikasi logika Anda, ikuti langkah-langkah berikut:

Pilih sumber daya Application Insights yang ada atau Buat sumber daya Application Insights baru.
Di Azure portal, 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": "dotnet",
      "APPINSIGHTS_INSTRUMENTATIONKEY": <instrumentation-key>
   }
}

Periksa apakah pemicu alur kerja dan nama tindakan muncul dengan benar di instans Application Insights Anda.
1. Di portal 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.

Secara opsional sesuaikan tingkat keparahan untuk data pelacakan yang dikumpulkan dan dikirim aplikasi logika Anda 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 alur kerja ini mencakup seluruh masa pakai alur kerja dan termasuk, tetapi tidak terbatas pada, jenis kejadian berikut ini:

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

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 berikut ini menjelaskan tingkat keparahan dan jenis jejaknya:

Tingkat keseriusan	Jenis pelacakan
Kritis	Log yang menjelaskan kegagalan yang tidak dapat dipulihkan dalam alur kerja aplikasi logika Anda.
Awakutu	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 proses dimulai dan berakhir. - Ketika aplikasi logika Anda dimulai atau berakhir.
Jejak	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 tata letak ASP.NET Core untuk pemfilteran tipe log.

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

Jika objek logging tidak berisi objek logLevel yang mencakup properti Host.Triggers.Workflow, tambahkan item-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"
      }
   }
}

Tugas pasca penyebaran

Bagian berikut menjelaskan tugas yang harus dilakukan setelah aplikasi logika Anda menyelesaikan penyebaran.

Mengonfirmasi penyebaran di portal Microsoft Azure

Setelah Anda menyebarkan aplikasi logika dari Visual Studio Code ke portal Microsoft Azure, konfirmasikan bahwa aplikasi logika Anda muncul di portal. Sumber daya Azure diatur dan dikelompokkan di portal berdasarkan jenis sumber dayanya. Untuk menemukan aplikasi logika Standar, ikuti langkah-langkah berikut:

Masuk ke portal Azure dengan akun Azure Anda.
Di kotak pencarian judul Azure, masukkan nama aplikasi logika Anda, yang akan muncul sebagai hasilnya di bagian Sumber Daya . Pilih aplikasi logika Anda untuk membuka sumber daya.
Di menu aplikasi logika, di Alur Kerja, pilih Alur Kerja.
Pada halaman Alur Kerja , pilih alur kerja Anda.
Pada menu alur kerja, di bawah Alat, pilih Perancang. Pastikan bahwa alur kerja muncul seperti yang diharapkan.

Sekarang Anda dapat membuat perubahan alur kerja ini di Azure portal.
Pastikan untuk mengaktifkan pengalaman pemantauan untuk aplikasi logika yang disebarkan sehingga Anda dapat melihat riwayat eksekusi alur kerja, input, output, dan informasi terkait lainnya.

Mengaktifkan pengalaman pemantauan untuk aplikasi logika yang disebarkan

Sebelum Anda dapat meninjau riwayat eksekusi alur kerja, input, output, dan informasi terkait untuk sumber daya aplikasi logika Standar yang disebarkan dengan pengalaman pemantauan di portal Microsoft Azure, Anda harus terlebih dahulu mengaktifkan pengalaman tersebut pada sumber daya aplikasi logika.

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

Mengaktifkan atau membuka Application Insights setelah penyebaran

Selama eksekusi alur kerja, alur kerja aplikasi logika Anda memancarkan telemetri bersama dengan peristiwa lain. Anda dapat menggunakan telemetri ini untuk mendapatkan visibilitas yang lebih baik tentang seberapa baik alur kerja Anda berjalan dan cara kerja runtime Azure Logic Apps. Application Insights menyediakan kemampuan bagi Anda untuk mengaktifkan pengelogan, pelacakan, dan pemantauan diagnostik untuk aplikasi logika Anda menggunakan telemetri hampir real-time (metrik langsung). Kemampuan ini membantu Anda menyelidiki kegagalan dan masalah performa dengan lebih mudah saat Anda menggunakan data telemetri untuk mendiagnosis masalah, menyiapkan pemberitahuan, dan membuat bagan.

Jika sebelumnya Anda tidak menyiapkan Application Insights, Anda dapat mengaktifkan kemampuan ini di portal Microsoft Azure setelah penyebaran aplikasi logika dari Visual Studio Code. Anda harus memiliki sumber daya Application Insights di Azure, tetapi Anda dapat membuat sumber daya ini secara terpisah terlebih dahulu atau saat Mengaktifkan kemampuan ini setelah penyebaran.
Jika sebelumnya Anda menyiapkan Application Insights selama penyebaran dari Visual Studio Code, Anda dapat membuka sumber daya Application Insights dari aplikasi logika Anda di portal Microsoft Azure.

Mengaktifkan Application Insights untuk aplikasi logika yang telah disebarkan

Di portal Microsoft Azure, temukan dan buka aplikasi logika yang Anda sebarkan.
Pada menu aplikasi logika, di bawah Pemantauan, pilih Application Insights.
Pada halaman Application Insights , pilih Aktifkan Application Insights.

Setelah halaman Application Insights diperbarui, di bagian Ubah sumber daya Anda , pilih dari opsi berikut:

Membuat sumber daya baru

Azure membuat sumber daya untuk Application Insights dan ruang kerja Analitik Log menggunakan langganan dan grup sumber daya saat ini. Jika Anda ingin menggunakan grup langganan dan sumber daya yang berbeda, lihat Membuat sumber daya Application Insights baru, lalu kembali ke halaman ini.

Harta benda	Deskripsi
Nama sumber daya baru	Terima nama yang dihasilkan atau berikan nama lain.
Tempat	Pilih wilayah Azure.
Ruang kerja Log Analytics	Pilih ruang kerja yang sudah ada, jika ada. Jika tidak, ruang kerja default dibuat untuk Anda. Untuk informasi selengkapnya, lihat Gambaran umum ruang kerja Analitik Log.

Pilih sumber daya yang ada:
1. Pilih langganan Azure untuk sumber daya Application Insights Anda.
2. Pilih sumber daya Application Insights Anda.

Setelah selesai, di bagian bawah halaman, pilih Terapkan.

Buka Application Insights dari aplikasi logika Anda

Di portal Microsoft Azure, temukan dan buka aplikasi logika yang Anda sebarkan.
Pada menu aplikasi logika, di bawah Pemantauan, pilih Application Insights.
Pada halaman Application Insights , pilih tautan untuk sumber daya Application Insights Anda.

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

Mengatasi kesalahan dan masalah

Perancang gagal membuka

Ketika Anda mencoba membuka perancang, Anda mendapatkan kesalahan ini, "Waktu desain alur kerja tidak dapat dimulai". Jika sebelumnya Anda mencoba membuka perancang, tetapi Anda menghentikan atau menghapus proyek Anda, bundel ekstensi mungkin tidak diunduh dengan benar. Untuk memeriksa apakah alasan ini adalah penyebabnya, 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 '<operation-ID>'.
System.Private.CoreLib: The file 'C:\Users\<user-name>\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 folder ExtensionBundles di lokasi ini ...\Users\<user-name>\AppData\Local\Temp\Functions\ExtensionBundles, dan coba lagi membuka file 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 akan muncul di pilihan desainer, 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.

Nota

Solusi ini hanya berlaku untuk aplikasi logika yang Anda buat dan sebarkan menggunakan Visual Studio Code dengan ekstensi Azure Logic Apps (Standar), bukan aplikasi logika yang Anda buat menggunakan portal Microsoft Azure. Lihat Pemicu dan tindakan yang didukung hilang dari perancang antarmuka di portal Azure.

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

...\Users\<user-name>\.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\<user-name>\.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 desain.

"400 Permintaan Buruk" muncul pada pemicu atau tindakan

Ketika suatu eksekusi gagal, dan Anda memeriksa eksekusi tersebut pada tampilan pemantauan, kesalahan ini mungkin terjadi 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 untuk URI yang lebih panjang, edit kunci registri UrlSegmentMaxCount dan UrlSegmentMaxLength di komputer Anda dengan mengikuti langkah-langkah ini. Nilai default kunci ini dijelaskan dalam artikel ini, Http.sys pengaturan registri 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 Run, dan jalankan perintah regedit, yang membuka editor registri.
Dalam kotak Kontrol Akun Pengguna, pilih Ya untuk mengizinkan perubahan Anda pada komputer Anda.
Di panel kiri, di bawah 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 Parameters, pilih Baru>Nilai DWORD (32-bit).
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 debugging gagal dimulai

Ketika Anda mencoba untuk memulai sesi debugging, Anda mendapatkan error, "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.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"
 }

Sesudah:

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

Bagikan melalui

Membuat alur kerja aplikasi logika Standar dengan Visual Studio Code

Prasyarat

Persyaratan akses dan konektivitas

Alat

Periksa penginstalan ekstensi

Menyambungkan ke akun Azure Anda

Membuat ruang kerja lokal

Membuat proyek aplikasi logika Anda

Buka perancang alur kerja

Menambahkan pemicu dan tindakan

Tambahkan pemicu permintaan

Menambahkan tindakan Office 365 Outlook

Struktur proyek aplikasi logika standar

Tugas penyiapan pengembangan lainnya

Aktifkan webhook yang berjalan secara lokal

Mengatur penerusan panggilan dengan menggunakan ngrok

Menyiapkan URL penerusan di pengaturan aplikasi Anda

Mengaktifkan riwayat jalankan untuk alur kerja tanpa status

Menambahkan artefak dan dependensi ke proyek Anda

Mengonversi proyek Anda ke berbasis paket NuGet (.NET)

Migrasikan proyek berbasis paket NuGet untuk menggunakan rakitan di folder "lib"

Mengaktifkan penulisan konektor bawaan

Menjalankan, men-debug, dan menguji alur kerja secara lokal

Mengatur breakpoint untuk debugging

Men-debug dan menguji alur kerja Anda

Mengembalikan respons

Coba lagi alur kerja Anda

Persiapkan untuk peluncuran

Menyiapkan akses firewall

Sebarkan ke Azure

Menerbitkan ke sumber daya aplikasi logika Standar baru

Aktifkan Application Insights saat penyebaran

Tugas pasca penyebaran

Mengonfirmasi penyebaran di portal Microsoft Azure

Mengaktifkan pengalaman pemantauan untuk aplikasi logika yang disebarkan

Mengaktifkan atau membuka Application Insights setelah penyebaran

Mengaktifkan Application Insights untuk aplikasi logika yang telah disebarkan

Buka Application Insights dari aplikasi logika Anda

Mengatasi kesalahan dan masalah

Perancang gagal membuka

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

"400 Permintaan Buruk" muncul pada pemicu atau tindakan

Sesi debugging gagal dimulai

Konten terkait

Saran dan Komentar

Sumber Daya Tambahan: