Melakukan operasi data di Microsoft Azure Logic Apps

Berlaku untuk: Azure Logic Apps (Konsumsi + Standar)

Panduan cara kerja ini memperlihatkan bagaimana Anda dapat bekerja dengan data di alur kerja aplikasi logika Anda dengan cara berikut:

  • Buat string atau objek JavaScript Object Notation (JSON) dari beberapa input yang memiliki jenis data yang berbeda. Anda kemudian dapat menggunakan string ini sebagai satu input, ketimbang berulang kali memasukkan input yang sama.
  • Buat token yang mudah digunakan dari properti objek JavaScript Object Notation (JSON) sehingga Anda dapat dengan mudah menggunakan properti tersebut di alur kerja Anda.
  • Buat tabel HTML atau CSV dari array.
  • Buat array dari array lain berdasarkan filter atau kondisi tertentu.
  • Buat array berdasarkan properti yang ditentukan untuk semua item di array lain.
  • Buat string dari semua item dalam array dan pisahkan item tersebut menggunakan karakter tertentu.

Untuk cara lain bekerja dengan data, tinjau fungsi manipulasi data yang disediakan Azure Logic Apps.

Prasyarat

  • Akun dan langganan Azure. Jika Anda tidak memiliki langganan, daftar untuk mendapatkan akun Azure secara gratis.

  • Alur kerja aplikasi logika tempat Anda ingin melakukan operasi data. Alur kerja ini harus sudah memiliki pemicu sebagai langkah pertama dalam alur kerja Anda. Alur kerja aplikasi logika Konsumsi dan Standar mendukung operasi data yang dijelaskan dalam panduan ini.

    Semua operasi data hanya tersedia sebagai tindakan. Jadi, sebelum Anda dapat menggunakan tindakan ini, alur kerja Anda harus sudah dimulai dengan pemicu dan menyertakan tindakan lain yang diperlukan untuk membuat output yang ingin Anda gunakan dalam operasi data.

Tindakan operasi data

Bagian berikut ini meringkas operasi data yang dapat Anda gunakan dan diatur berdasarkan jenis data sumber yang dikerjakan operasi, tetapi setiap deskripsi muncul menurut abjad.

Tindakan JSON

Tindakan berikut membantu Anda bekerja dengan data dalam format JavaScript Object Notation (JSON).

Tindakan Deskripsi
Tulis Membuat pesan, atau string, dari beberapa input yang dapat memiliki berbagai jenis data. Anda kemudian dapat menggunakan string ini sebagai satu input, ketimbang berulang kali memasukkan input yang sama. Misalnya, Anda dapat membuat satu pesan JSON dari berbagai input.
Menguraikan JSON Buat token data yang mudah digunakan untuk properti dalam konten JSON sehingga Anda dapat dengan lebih mudah menggunakan properti di aplikasi logika Anda.

Untuk membuat transformasi JSON yang lebih rumit, lihat Melakukan transformasi JSON lanjutan dengan templat Liquid.

Tindakan array

Tindakan berikut membantu Anda bekerja dengan data dalam array.

Tindakan Deskripsi
Buat tabel CSV Membuat tabel nilai yang dipisahkan koma (CSV) dari array.
Buat tabel HTML Membuat tabel HTML dari array.
Filter array Membuat subset array dari array berdasarkan filter atau ketentuan yang ditentukan.
Gabungkan Membuat string dari semua item dalam array dan memisahkan setiap item dengan karakter yang ditentukan.
Pilih Membuat array dari properti yang ditentukan untuk semua item dalam array yang berbeda.

Menulis tindakan

Untuk membuat output tunggal seperti objek JSON dari beberapa input, gunakan tindakan bernama Compose. Input Anda dapat memiliki berbagai jenis seperti integer, Boolean, array, objek JSON, dan jenis asli lainnya yang didukung Microsoft Azure Logic Apps, misalnya, biner dan XML. Anda kemudian dapat menggunakan output dalam tindakan berikutnya setelah tindakan Buat. Tindakan Buat juga membantu Anda menghindari berulang kali memasukkan input yang sama saat Anda membangun alur kerja aplikasi logika Anda.

Misalnya, Anda dapat membuat pesan JSON dari beberapa variabel, seperti variabel string yang menyimpan nama depan dan nama belakang orang, serta variabel integer yang menyimpan usia orang. Dalam contoh ini, tindakan Buat menerima input berikut:

{ "age": <ageVar>, "fullName": "<lastNameVar>, <firstNameVar>" }

dan membuat output berikut:

{"age":35,"fullName":"Owens,Sophia"}

Untuk mencoba tindakan Buat , ikuti langkah-langkah ini dengan menggunakan perancang alur kerja. Atau, jika Anda lebih suka bekerja di editor tampilan kode, Anda dapat menyalin contoh Buat dan Inisialisasi definisi tindakan variabel dari panduan ini ke dalam definisi alur kerja mendasar aplikasi logika Anda sendiri: Contoh kode operasi data - Buat. Untuk informasi selengkapnya tentang tindakan Buat dalam definisi alur kerja JSON yang mendasar, lihat tindakan Buat.

  1. Di portal Azure, Visual Studio, atau Visual Studio Code, buka alur kerja aplikasi logika Anda di perancang.

    Contoh ini menggunakan portal Azure dan alur kerja sampel dengan pemicu Pengulangan diikuti oleh beberapa tindakan Inisialisasi variabel. Tindakan ini disiapkan untuk membuat dua variabel string dan variabel bilangan bulat.

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the Compose action.

  2. Di alur kerja tempat Anda ingin membuat output, ikuti salah satu langkah berikut:

    • Untuk menambahkan tindakan di bawah langkah terakhir, pilih Langkah baru.

    • Untuk menambahkan tindakan di antara langkah, gerakkan mouse ke panah yang menyambungkan sehingga tanda plus (+) muncul. Pilih tanda plus, lalu pilih Tambahkan tindakan.

  3. Di bagian kotak pencarian Pilih operasi, pilih Bawaan. Dalam kotak pencarian, masukkan buat.

  4. Dari daftar tindakan, pilih tindakan bernama Buat.

    Screenshot showing the designer for a Consumption workflow, the

  5. Dalam kotak Input , masukkan input yang akan digunakan untuk membuat output.

    Untuk contoh ini, pilih di dalam kotak Input , yang membuka daftar konten dinamis. Dari daftar tersebut, pilih variabel yang dibuat sebelumnya:

    Screenshot showing the designer for a Consumption workflow, the

    Cuplikan layar berikut menunjukkan contoh tindakan Tulis yang sudah selesai:

    Screenshot showing the designer for a Consumption workflow and the finished example for the

  6. Simpan alur kerja Anda. Di bar alat perancang, pilih Simpan.

Menguji alur kerja

Untuk mengonfirmasi apakah tindakan Buat membuat hasil yang diharapkan, kirimi diri Anda pemberitahuan yang menyertakan output dari tindakan Buat.

  1. Di alur kerja Anda, tambahkan tindakan yang dapat mengirimi Anda hasil dari tindakan Buat .

    Contoh ini berlanjut dengan menggunakan tindakan Office 365 Outlook bernama Kirim email.

  2. Dalam tindakan ini, untuk setiap kotak tempat Anda ingin hasil muncul, pilih di dalam setiap kotak, yang membuka daftar konten dinamis. Dari daftar tersebut, di bawah tindakan Buat , pilih Output.

    Untuk contoh ini, hasilnya muncul di isi email, jadi tambahkan bidang Output ke kotak Isi .

    Screenshot showing the Azure portal, designer for an example Consumption workflow, and the

  3. Simpan alur kerja Anda, lalu jalankan alur kerja Anda secara manual. Pada toolbar perancang, pilih Jalankan Eksekusi Pemicu>.

Jika Anda menggunakan tindakan Office 365 Outlook, Anda mendapatkan hasil yang mirip dengan cuplikan layar berikut:

Screenshot showing an email with the

Membuat tindakan tabel CSV

Untuk membuat tabel nilai yang dipisahkan koma (CSV) yang memiliki properti dan nilai dari objek JavaScript Object Notation (JSON) dalam array, gunakan tindakan bernama Buat tabel CSV. Anda kemudian dapat menggunakan tabel yang dihasilkan dalam tindakan setelah tindakan Buat tabel CSV.

Untuk mencoba tindakan Buat tabel CSV, ikuti langkah-langkah ini dengan menggunakan perancang alur kerja. Atau, jika Anda lebih suka bekerja di editor tampilan kode, Anda dapat menyalin contoh Buat tabel CSV dan Menginisialisasi definisi tindakan variabel dari panduan ini ke dalam definisi alur kerja yang mendasar aplikasi logika Anda sendiri: Contoh kode operasi data - Buat tabel CSV. Untuk informasi selengkapnya tentang tindakan Buat tabel CSV dalam definisi alur kerja JSON yang mendasar, lihat tindakan Tabel.

  1. Di portal Azure, Visual Studio, atau Visual Studio Code, buka alur kerja aplikasi logika Anda di perancang.

    Contoh ini menggunakan portal Azure dan alur kerja sampel dengan pemicu Pengulangan diikuti dengan tindakan Inisialisasi variabel. Tindakan disiapkan untuk membuat variabel di mana nilai awal adalah array yang memiliki beberapa properti dan nilai dalam format JSON.

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

  2. Di alur kerja tempat Anda ingin membuat tabel CSV, ikuti salah satu langkah berikut:

    • Untuk menambahkan tindakan di bawah langkah terakhir, pilih Langkah baru.

    • Untuk menambahkan tindakan di antara langkah, gerakkan mouse ke panah yang menyambungkan sehingga tanda plus (+) muncul. Pilih tanda plus, lalu pilih Tambahkan tindakan.

  3. Di bagian kotak pencarian Pilih operasi, pilih Bawaan. Dalam kotak pencarian, masukkan buat tabel csv.

  4. Dari daftar tindakan, pilih tindakan bernama Buat tabel CSV.

    Screenshot showing the designer for a Consumption workflow, the

  5. Dalam kotak Dari , masukkan array atau ekspresi yang akan digunakan untuk membuat tabel.

    Untuk contoh ini, pilih di dalam kotak Dari , yang membuka daftar konten dinamis. Dari daftar tersebut, pilih variabel yang dibuat sebelumnya:

    Screenshot showing the designer for a Consumption workflow, the

    Catatan

    Untuk membuat token yang mudah digunakan untuk properti di objek JSON sehingga Anda dapat memilih properti tersebut sebagai input, gunakan tindakan bernama Parse JSON sebelum Anda menggunakan tindakan Buat tabel CSV.

    Cuplikan layar berikut menunjukkan contoh tindakan Buat tabel CSV yang sudah selesai:

    Screenshot showing the designer for a Consumption workflow and the finished example for the

  6. Simpan alur kerja Anda. Di bar alat perancang, pilih Simpan.

Mengkustomisasi format tabel

Secara default, properti Kolom diatur untuk membuat kolom tabel secara otomatis berdasarkan item array. Untuk menentukan header dan nilai kustom, ikuti langkah-langkah berikut ini:

  1. Jika properti Kolom tidak muncul di kotak informasi tindakan, dari daftar Tambahkan parameter baru, pilih Kolom.

  2. Buka daftar Kolom, dan pilih Kustom.

  3. Di properti Header, tentukan teks header kustom untuk digunakan sebagai gantinya.

  4. Di properti Nilai, tentukan nilai kustom untuk digunakan sebagai gantinya.

Untuk menghasilkan nilai dari array, Anda dapat menggunakan fungsi item() dengan tindakan Buat tabel CSV. Dalam perulangan For_each, Anda dapat menggunakan fungsi items().

Misalnya, bayangkan Anda menginginkan kolom tabel yang hanya memiliki nilai properti dan bukan nama properti dari array. Untuk menghasilkan nilai ini saja, ikuti langkah-langkah berikut untuk bekerja dalam tampilan perancang atau dalam tampilan kode.

Contoh ini mengembalikan hasil berikut:

Apples,1
Oranges,2

Bekerja dalam tampilan perancang

Dalam tindakan Buat tabel CSV, biarkan kolom Header tetap kosong. Pada setiap baris di kolom Nilai, dereferensi setiap properti array yang diinginkan. Setiap baris dalam Nilai menghasilkan semua nilai untuk properti array yang ditentukan dan menjadi kolom dalam tabel Anda.

  1. Untuk setiap properti array yang Anda inginkan, di kolom Nilai , pilih di dalam kotak edit, yang membuka daftar konten dinamis.

  2. Dari daftar tersebut, pilih Ekspresi untuk membuka editor ekspresi sebagai gantinya.

  3. Di editor ekspresi, masukkan ekspresi berikut tetapi ganti <array-property-name> dengan nama properti array untuk nilai yang Anda inginkan.

    Sitnaksis: item()?['<array-property-name>']

    Contoh:

    • item()?['Description']
    • item()?['Product_ID']

    Screenshot showing the

  4. Ulangi langkah-langkah sebelumnya untuk setiap properti array. Setelah selesai, tindakan Anda terlihat mirip dengan contoh berikut:

    Screenshot showing the

  5. Untuk mengatasi ekspresi ke dalam versi yang lebih deskriptif, beralihlah ke tampilan kode dan kembali ke tampilan perancang, lalu buka kembali tindakan yang diciutkan:

    Tindakan Buat tabel CSV sekarang tampak mirip dengan contoh berikut:

    Screenshot showing the

Bekerja dalam tampilan kode

Dalam definisi JSON tindakan, di dalam array columns, atur properti header ke string kosong. Untuk setiap properti value, dereferensi setiap properti array yang diinginkan.

  1. Dari perancang, beralihlah ke tampilan kode.

    • Konsumsi: Pada toolbar perancang, pilih Tampilan kode.
    • Standar: Pada menu navigasi alur kerja, di bawah Pengembang, pilih Kode.
  2. Di editor kode, temukan array tindakan columns . Untuk setiap kolom nilai array yang Anda inginkan, tambahkan properti kosong header dan ekspresi berikut untuk value properti :

    Sintaks:

    {
       "header": "",
       "value": "@item()?['<array-property-name>']"
    }
    

    Contoh:

    "Create_CSV_table": {
       "inputs": {
          "columns": [
             { 
                "header": "",
                "value": "@item()?['Description']"
             },
             { 
                "header": "",
                "value": "@item()?['Product_ID']"
             }
          ],
          "format": "CSV",
          "from": "@variables('myJSONArray')"
       }
    }
    
  3. Beralih kembali ke tampilan desainer untuk meninjau hasilnya.

Menguji alur kerja

Untuk mengonfirmasi apakah tindakan Buat tabel CSV membuat hasil yang diharapkan, kirimi diri Anda pemberitahuan yang menyertakan output dari tindakan Buat tabel CSV.

  1. Di alur kerja Anda, tambahkan tindakan yang bisa mengirimi Anda hasil dari tindakan Buat tabel CSV.

    Contoh ini berlanjut dengan menggunakan tindakan Office 365 Outlook bernama Kirim email.

  2. Dalam tindakan ini, untuk setiap kotak tempat Anda ingin hasil muncul, pilih di dalam kotak, yang membuka daftar konten dinamis. Di bawah tindakan Buat tabel CSV, pilih Output.

    Screenshot showing a Consumption workflow with the

    Catatan

    Jika daftar konten dinamis memperlihatkan pesan bahwa Kami tidak dapat menemukan output apa pun untuk mencocokkan format input ini, pilih Lihat selengkapnya di samping label Buat tabel CSV dalam daftar.

    Screenshot showing a Consumption workflow and the dynamic content list with

  3. Simpan alur kerja Anda, lalu jalankan alur kerja Anda secara manual. Pada toolbar perancang, pilih Jalankan Eksekusi Pemicu>.

Jika Anda menggunakan tindakan Office 365 Outlook, Anda mendapatkan hasil yang mirip dengan cuplikan layar berikut:

Screenshot showing an email with the

Catatan

Jika tabel Anda dihasilkan dengan pemformatan yang salah, lihat cara memeriksa pemformatan data tabel.

Tindakan buat tabel HTML

Untuk membuat tabel HTML yang memiliki properti dan nilai dari objek JavaScript Object Notation (JSON) dalam array, gunakan tindakan Buat tabel HTML. Anda kemudian dapat menggunakan tabel yang dihasilkan dalam tindakan setelah tindakan Buat tabel HTML.

Untuk mencoba tindakan Buat tabel HTML, ikuti langkah-langkah ini dengan menggunakan perancang alur kerja. Atau, jika Anda lebih suka bekerja di editor tampilan kode, Anda dapat menyalin contoh Buat tabel HTML dan Menginisialisasi definisi tindakan variabel dari panduan ini ke dalam definisi alur kerja dasar aplikasi logika Anda sendiri: Contoh kode operasi data - Buat tabel HTML. Untuk informasi selengkapnya tentang tindakan Buat tabel HTML dalam definisi alur kerja JSON yang mendasar, lihat tindakan Tabel.

  1. Di portal Azure, Visual Studio, atau Visual Studio Code, buka alur kerja aplikasi logika Anda di perancang.

    Contoh ini menggunakan portal Azure dan alur kerja sampel dengan pemicu Pengulangan diikuti dengan tindakan Inisialisasi variabel. Tindakan disiapkan untuk membuat variabel di mana nilai awal adalah array yang memiliki beberapa properti dan nilai dalam format JSON.

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

  2. Di alur kerja tempat Anda ingin membuat tabel HTML, ikuti salah satu langkah berikut:

    • Untuk menambahkan tindakan di bawah langkah terakhir, pilih Langkah baru.

    • Untuk menambahkan tindakan di antara langkah, gerakkan mouse ke panah yang menyambungkan sehingga tanda plus (+) muncul. Pilih tanda plus, lalu pilih Tambahkan tindakan.

  3. Di bagian kotak pencarian Pilih operasi, pilih Bawaan. Dalam kotak pencarian, masukkan buat tabel html.

  4. Dari daftar tindakan, pilih tindakan bernama Buat tabel HTML.

    Screenshot showing the designer for a Consumption workflow, the

  5. Dalam kotak Dari , masukkan array atau ekspresi yang akan digunakan untuk membuat tabel.

    Untuk contoh ini, pilih di dalam kotak Dari , yang membuka daftar konten dinamis. Dari daftar tersebut, pilih variabel yang dibuat sebelumnya:

    Screenshot showing the designer for a Consumption workflow, the

    Catatan

    Untuk membuat token yang mudah digunakan untuk properti di objek JSON sehingga Anda dapat memilih properti tersebut sebagai input, gunakan tindakan bernama Urai JSON sebelum Anda menggunakan tindakan Buat tabel HTML.

    Cuplikan layar berikut menunjukkan contoh tindakan Buat tabel HTML yang sudah selesai:

    Screenshot showing the designer for a Consumption workflow and the finished example for the

  6. Simpan alur kerja Anda. Di bar alat perancang, pilih Simpan.

Mengkustomisasi format tabel

Secara default, properti Kolom diatur untuk membuat kolom tabel secara otomatis berdasarkan item array. Untuk menentukan header dan nilai kustom, ikuti langkah-langkah berikut ini:

  1. Buka daftar Kolom, dan pilih Kustom.

  2. Di properti Header, tentukan teks header kustom untuk digunakan sebagai gantinya.

  3. Di properti Nilai, tentukan nilai kustom untuk digunakan sebagai gantinya.

Untuk menghasilkan nilai dari array, Anda dapat menggunakan fungsi item() dengan tindakan Buat tabel HTML. Dalam perulangan For_each, Anda dapat menggunakan fungsi items().

Misalnya, bayangkan Anda menginginkan kolom tabel yang hanya memiliki nilai properti dan bukan nama properti dari array. Untuk menghasilkan nilai ini saja, ikuti langkah-langkah berikut untuk bekerja dalam tampilan perancang atau dalam tampilan kode.

Contoh ini mengembalikan hasil berikut:

Apples,1
Oranges,2

Bekerja dalam tampilan perancang

Dalam tindakan Buat tabel HTML, biarkan kolom Header kosong. Pada setiap baris di kolom Nilai, dereferensi setiap properti array yang diinginkan. Setiap baris dalam Nilai menghasilkan semua nilai untuk properti array yang ditentukan dan menjadi kolom dalam tabel Anda.

  1. Untuk setiap properti array yang Anda inginkan, di kolom Nilai , pilih di dalam kotak edit, yang membuka daftar konten dinamis.

  2. Dari daftar tersebut, pilih Ekspresi untuk membuka editor ekspresi sebagai gantinya.

  3. Di editor ekspresi, masukkan ekspresi berikut, tetapi ganti <array-property-name> dengan nama properti array untuk nilai yang Anda inginkan, lalu pilih OK. Untuk informasi selengkapnya, lihat fungsi item().

    Sitnaksis: item()?['<array-property-name>']

    Contoh:

    • item()?['Description']
    • item()?['Product_ID']

    Screenshot showing the

  4. Ulangi langkah-langkah sebelumnya untuk setiap properti array. Setelah selesai, tindakan Anda terlihat mirip dengan contoh berikut:

    Screenshot showing the

  5. Untuk mengatasi ekspresi ke dalam versi yang lebih deskriptif, beralihlah ke tampilan kode dan kembali ke tampilan perancang, lalu buka kembali tindakan yang diciutkan:

    Tindakan Buat tabel HTML sekarang tampak mirip dengan contoh berikut:

    Screenshot showing the

Bekerja dalam tampilan kode

Dalam definisi JSON tindakan, di dalam array columns, atur properti header ke string kosong. Untuk setiap properti value, dereferensi setiap properti array yang diinginkan.

  1. Dari perancang, beralihlah ke tampilan kode.

    • Konsumsi: Pada toolbar perancang, pilih Tampilan kode.
    • Standar: Pada menu navigasi alur kerja, di bawah Pengembang, pilih Kode.
  2. Di editor kode, temukan array tindakan columns . Untuk setiap kolom nilai array yang Anda inginkan, tambahkan properti kosong header dan ekspresi berikut untuk value properti :

    Sintaks:

    {
       "header": "",
       "value": "@item()?['<array-property-name>']"
    }
    

    Contoh:

    "Create_HTML_table": {
       "inputs": {
          "columns": [
             { 
                "header": "",
                "value": "@item()?['Description']"
             },
             { 
                "header": "",
                "value": "@item()?['Product_ID']"
             }
          ],
          "format": "HTML",
          "from": "@variables('myJSONArray')"
       }
    }
    
  3. Beralih kembali ke tampilan desainer untuk meninjau hasilnya.

Menguji alur kerja

Untuk mengonfirmasi apakah tindakan Buat tabel HTML membuat hasil yang diharapkan, kirimi diri Anda pemberitahuan yang menyertakan output dari tindakan Buat tabel HTML.

  1. Di alur kerja Anda, tambahkan tindakan yang bisa mengirimi Anda hasil dari tindakan Buat tabel HTML.

    Contoh ini berlanjut dengan menggunakan tindakan Office 365 Outlook bernama Kirim email.

  2. Dalam tindakan ini, untuk setiap kotak tempat Anda ingin hasil muncul, pilih di dalam setiap kotak, yang membuka daftar konten dinamis. Dari daftar tersebut , di bawah tindakan Buat tabel HTML, pilih Output.

    Screenshot showing a Consumption workflow with the

    Catatan

    • Jika daftar konten dinamis memperlihatkan pesan bahwa Kami tidak dapat menemukan output apa pun untuk mencocokkan format input ini, pilih Lihat selengkapnya di samping label Buat tabel HTML dalam daftar.

      Screenshot showing a Consumption workflow and the dynamic content list with

    • Saat Anda menyertakan output tabel HTML dalam tindakan email, pastikan Anda mengatur properti Is HTML ke Ya dalam opsi tingkat lanjut tindakan email. Dengan demikian, tindakan email memformat tabel HTML dengan benar. Namun, jika tabel Anda dikembalikan dengan pemformatan yang salah, lihat cara memeriksa pemformatan data tabel Anda.

  3. Simpan alur kerja Anda, lalu jalankan alur kerja Anda secara manual. Pada toolbar perancang, pilih Jalankan Eksekusi Pemicu>.

Jika Anda menggunakan tindakan Office 365 Outlook, Anda mendapatkan hasil yang mirip dengan cuplikan layar berikut:

Screenshot showing an email with the

Memfilter tindakan array

Untuk membuat array subset dari array yang ada di mana item subset memenuhi kriteria tertentu, gunakan tindakan Filter array . Anda kemudian dapat menggunakan array yang difilter yang dihasilkan dalam tindakan yang mengikuti tindakan Filter array .

Untuk mencoba tindakan Filter array , ikuti langkah-langkah ini dengan menggunakan perancang alur kerja. Atau, jika Anda lebih suka bekerja di editor tampilan kode, Anda dapat menyalin contoh definisi tindakan Filter array dan Initialize variabel dari panduan ini ke dalam definisi alur kerja dasar aplikasi logika Anda sendiri: Contoh kode operasi data - Filter array. Untuk informasi selengkapnya tentang tindakan Filter array dalam definisi alur kerja JSON yang mendasar, lihat tindakan Kueri.

Catatan

Setiap teks filter yang digunakan dalam ketentuan Anda peka huruf besar dan kecil. Selain itu, tindakan ini tidak dapat mengubah format atau komponen item dalam array.

Agar tindakan menggunakan output array dari tindakan Filter array, tindakan tersebut harus menerima array sebagai input, atau Anda mungkin harus mengubah array output menjadi format lain yang kompatibel.

Jika Anda memanggil titik akhir HTTP dan menerima respons JSON, gunakan tindakan Urai JSON untuk memproses respons JSON. Jika tidak, tindakan Filter array hanya dapat membaca isi respons dan bukan struktur payload JSON.

  1. Di portal Azure, Visual Studio, atau Visual Studio Code, buka alur kerja aplikasi logika Anda di perancang.

    Contoh ini menggunakan portal Azure dan alur kerja sampel dengan pemicu Pengulangan diikuti dengan tindakan Inisialisasi variabel. Tindakan disiapkan untuk membuat di mana nilai awal adalah array yang memiliki beberapa nilai bilangan bulat sampel.

    Catatan

    Meskipun contoh ini menggunakan array integer sederhana, tindakan ini sangat bermanfaat untuk array objek JSON tempar Anda dapat memfilter berdasarkan properti dan nilai objek.

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

  2. Di alur kerja tempat Anda ingin membuat array yang difilter, ikuti salah satu langkah berikut:

    • Untuk menambahkan tindakan di bawah langkah terakhir, pilih Langkah baru.

    • Untuk menambahkan tindakan di antara langkah, gerakkan mouse ke panah yang menyambungkan sehingga tanda plus (+) muncul. Pilih tanda plus, lalu pilih Tambahkan tindakan.

  3. Di bagian kotak pencarian Pilih operasi, pilih Bawaan. Dalam kotak pencarian, masukkan array filter.

  4. Dari daftar tindakan, pilih tindakan bernama Filter array.

    Screenshot showing the designer for a Consumption workflow, the

  5. Dalam kotak Dari , masukkan array atau ekspresi untuk digunakan sebagai filter.

    Untuk contoh ini, pilih kotak Dari , yang membuka daftar konten dinamis. Dari daftar tersebut, pilih variabel yang dibuat sebelumnya:

    Screenshot showing the designer for a Consumption workflow, the

  6. Untuk ketentuan tersebut, tentukan item array untuk dibandingkan, pilih operator perbandingan, dan tentukan nilai perbandingan.

    Contoh ini menggunakan fungsi item() untuk mengakses setiap item dalam array, sementara tindakan Filter array mencari item array di mana nilainya lebih besar dari satu item. Cuplikan layar berikut menunjukkan contoh tindakan Filter array yang sudah selesai:

    Screenshot showing the designer for a Consumption workflow and the finished example for the

  7. Simpan alur kerja Anda. Di bar alat perancang, pilih Simpan.

Menguji alur kerja

Untuk mengonfirmasi apakah tindakan Filter array membuat hasil yang diharapkan, kirimi diri Anda pemberitahuan yang menyertakan output dari tindakan Filter array.

  1. Di alur kerja Anda, tambahkan tindakan yang bisa mengirimi Anda hasil dari tindakan Filter array .

    Contoh ini berlanjut dengan menggunakan tindakan Office 365 Outlook bernama Kirim email.

  2. Dalam tindakan ini, selesaikan langkah-langkah berikut:

    1. Untuk setiap kotak tempat Anda ingin hasil muncul, pilih di dalam setiap kotak, yang membuka daftar konten dinamis.

    2. Dari daftar tersebut, pilih Ekspresi untuk membuka editor ekspresi sebagai gantinya.

    3. Untuk mendapatkan output array dari tindakan Filter array, masukkan ekspresi berikut, yang menggunakan fungsi actionBody() dengan nama tindakan Filter array, lalu pilih OK.

      actionBody('Filter_array')

      Screenshot showing a Consumption workflow with the

      Ekspresi yang diselesaikan menentukan untuk menampilkan output dari tindakan Filter_array dalam isi email saat dikirim:

      Screenshot showing a Consumption workflow with the finished

  3. Simpan alur kerja Anda, lalu jalankan alur kerja Anda secara manual. Pada toolbar perancang, pilih Jalankan Eksekusi Pemicu>.

Jika Anda menggunakan tindakan Office 365 Outlook, Anda mendapatkan hasil yang mirip dengan cuplikan layar berikut:

Screenshot showing an email with the

Gabung dalam tindakan

Untuk membuat string yang memiliki semua item dari array dan memisahkan item tersebut dengan karakter pemisah tertentu, gunakan tindakan Gabungkan. Anda kemudian dapat menggunakan string dalam tindakan yang mengikuti tindakan Gabungkan .

Untuk mencoba tindakan Gabungkan , ikuti langkah-langkah ini dengan menggunakan perancang alur kerja. Atau, jika Anda lebih suka bekerja di editor tampilan kode, Anda dapat menyalin contoh Definisi tindakan gabungkan dan Inisialisasi variabel dari panduan ini ke definisi alur kerja dasar aplikasi logika Anda sendiri: Contoh kode operasi data - Bergabung. Untuk informasi selengkapnya tentang tindakan Gabungkan dalam definisi alur kerja yang mendasar Anda, lihat tindakan Gabungkan.

  1. Di portal Azure, Visual Studio, atau Visual Studio Code, buka alur kerja aplikasi logika Anda di perancang.

    Contoh ini menggunakan portal Azure dan alur kerja sampel dengan pemicu Pengulangan diikuti dengan tindakan Inisialisasi variabel. Tindakan ini disiapkan untuk membuat variabel di mana nilai awal adalah array yang memiliki beberapa nilai bilangan bulat sampel.

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

  2. Di alur kerja tempat Anda ingin membuat string dari array, ikuti salah satu langkah berikut:

    • Untuk menambahkan tindakan di bawah langkah terakhir, pilih Langkah baru.

    • Untuk menambahkan tindakan di antara langkah, gerakkan mouse ke panah yang menyambungkan sehingga tanda plus (+) muncul. Pilih tanda plus, lalu pilih Tambahkan tindakan.

  3. Di bagian kotak pencarian Pilih operasi, pilih Bawaan. Dalam kotak pencarian, masukkan gabung.

  4. Dari daftar tindakan, pilih tindakan bernama Gabung.

    Screenshot showing the designer for a Consumption workflow, the

  5. Dalam kotak Dari , masukkan array yang memiliki item yang ingin Anda gabungkan sebagai string.

    Untuk contoh ini, pilih di dalam kotak Dari , yang membuka daftar konten dinamis. Dari daftar tersebut, pilih variabel yang dibuat sebelumnya:

    Screenshot showing the designer for a Consumption workflow, the

  6. Dalam kotak Gabung dengan , masukkan karakter yang akan digunakan untuk memisahkan setiap item array.

    Contoh ini menggunakan titik dua (:) sebagai pemisah.

    Screenshot showing where to provide the separator character.

  7. Simpan alur kerja Anda. Di bar alat perancang, pilih Simpan.

Menguji alur kerja

Untuk mengonfirmasi apakah tindakan Gabungkan membuat hasil yang diharapkan, kirimi diri Anda pemberitahuan yang menyertakan output dari tindakan Gabungkan.

  1. Di alur kerja Anda, tambahkan tindakan yang bisa mengirimi Anda hasil dari tindakan Gabungkan .

    Contoh ini berlanjut dengan menggunakan tindakan Office 365 Outlook bernama Kirim email.

  2. Dalam tindakan ini, untuk setiap kotak tempat Anda ingin hasil muncul, pilih di dalam setiap kotak, yang membuka daftar konten dinamis. Dari daftar tersebut , di bawah tindakan Gabungkan , pilih Output.

    Screenshot showing a Consumption workflow with the finished

    Catatan

    Jika daftar konten dinamis memperlihatkan pesan bahwa Kami tidak dapat menemukan output apa pun untuk mencocokkan format input ini, pilih Lihat selengkapnya di samping label Gabung dalam daftar.

    Screenshot showing a Consumption workflow and the dynamic content list with

  3. Simpan alur kerja Anda, lalu jalankan alur kerja Anda secara manual. Pada toolbar perancang, pilih Jalankan Eksekusi Pemicu>.

Jika Anda menggunakan tindakan Office 365 Outlook, Anda mendapatkan hasil yang mirip dengan cuplikan layar berikut:

Screenshot showing an email with the

Mengurai tindakan JSON

Untuk mereferensikan atau mengakses properti dalam konten JavaScript Object Notation (JSON), Anda dapat membuat bidang atau token yang mudah digunakan untuk properti tersebut dengan menggunakan tindakan Uraikan JSON. Dengan demikian, Anda dapat memilih properti tersebut dari daftar konten dinamis saat menentukan input untuk tindakan berikutnya dalam alur kerja Anda. Untuk tindakan ini, Anda dapat memberikan skema JSON atau membuat skema JSON dari contoh konten atau payload JSON Anda.

Untuk mencoba tindakan Urai JSON , ikuti langkah-langkah ini dengan menggunakan perancang alur kerja. Atau, jika Anda lebih suka bekerja di editor tampilan kode, Anda dapat menyalin contoh Mengurai JSON dan Menginisialisasi definisi tindakan variabel dari panduan ini ke dalam definisi alur kerja dasar aplikasi logika Anda sendiri: Contoh kode operasi data - Mengurai JSON. Untuk informasi selengkapnya tentang tindakan ini dalam definisi alur kerja yang mendasari, lihat tindakan Uraikan JSON.

  1. Di portal Azure, Visual Studio, atau Visual Studio Code, buka alur kerja aplikasi logika Anda di perancang.

    Contoh ini menggunakan portal Azure dan alur kerja sampel dengan pemicu Pengulangan diikuti dengan tindakan Inisialisasi variabel. Tindakan ini disiapkan untuk membuat variabel yang nilai awalnya adalah objek JSON berikut dengan properti dan nilai:

    {
        "Member": {
            "Email": "Sophia.Owen@fabrikam.com",
            "FirstName": "Sophia",
            "LastName": "Owen"
        }
    }
    

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

  2. Di alur kerja tempat Anda ingin mengurai objek JSON, ikuti salah satu langkah berikut:

    • Untuk menambahkan tindakan di bawah langkah terakhir, pilih Langkah baru.

    • Untuk menambahkan tindakan di antara langkah, gerakkan mouse ke panah yang menyambungkan sehingga tanda plus (+) muncul. Pilih tanda plus, lalu pilih Tambahkan tindakan.

  3. Di bagian kotak pencarian Pilih operasi, pilih Bawaan. Di kotak pencarian, masukkan penguraian json.

  4. Dari daftar tindakan, pilih tindakan bernama Urai JSON.

    Screenshot showing the designer for a Consumption workflow, the

  5. Dalam kotak Konten , masukkan objek JSON yang ingin Anda uraikan.

    Untuk contoh ini, pilih di dalam kotak Konten , yang membuka daftar konten dinamis. Dari daftar tersebut, pilih variabel yang dibuat sebelumnya:

    Screenshot showing the designer for a Consumption workflow, the

  6. Dalam kotak Skema , masukkan skema JSON yang menjelaskan objek JSON, atau payload, yang ingin Anda uraikan.

    Untuk contoh ini, gunakan skema berikut untuk contoh objek JSON:

    {
        "type": "object",
        "properties": {
            "Member": {
                "type": "object",
                "properties": {
                    "Email": {
                        "type": "string"
                    },
                    "FirstName": {
                        "type": "string"
                    },
                    "LastName": {
                        "type": "string"
                    }
                }
            }
        }
    }
    

    Screenshot showing the designer for a Consumption workflow, the

    Jika Anda tidak memiliki skema, Anda dapat menghasilkan skema dari objek JSON:

    1. Dalam tindakan Uraikan JSON, di bawah kotak Skema, pilih Gunakan payload sampel untuk menghasilkan skema.

    2. Dalam kotak Masukkan atau tempel contoh payload JSON, masukkan konten atau objek JSON, lalu pilih Selesai, misalnya:

      {
          "Member": {
             "Email": "Sophia.Owen@fabrikam.com",
             "FirstName": "Sophia",
             "LastName": "Owen"
          }
      }
      

      Screenshot showing the designer for a Consumption workflow, the

  7. Simpan alur kerja Anda. Di bar alat perancang, pilih Simpan.

Menguji alur kerja

Untuk mengonfirmasi apakah tindakan Uraikan JSON membuat hasil yang diharapkan, kirimi diri Anda pemberitahuan yang menyertakan output dari tindakan Uraikan JSON.

  1. Di alur kerja Anda, tambahkan tindakan yang dapat mengirimi Anda hasil dari tindakan Urai JSON .

    Contoh ini berlanjut dengan menggunakan tindakan Office 365 Outlook bernama Kirim email.

  2. Dalam tindakan ini, untuk setiap kotak edit tempat Anda ingin hasil muncul, pilih di dalam setiap kotak, yang membuka daftar konten dinamis. Dari daftar itu , di bawah tindakan Uraikan JSON , Anda sekarang dapat memilih properti dari objek JSON yang diurai.

    Contoh ini memilih properti berikut: FirstName, LastName, dan Email

    Screenshot showing a Consumption workflow with JSON properties in the

    Catatan

    Jika daftar konten dinamis memperlihatkan pesan bahwa Kami tidak dapat menemukan output apa pun untuk mencocokkan format input ini, pilih Lihat selengkapnya di samping label Urai JSON dalam daftar.

    Screenshot showing a Standard workflow and the dynamic content list with

    Setelah selesai, tindakan Kirim email terlihat mirip dengan contoh berikut:

    Screenshot showing a Consumption workflow with the finished

  3. Simpan alur kerja Anda, lalu jalankan alur kerja Anda secara manual. Pada toolbar perancang, pilih Jalankan Eksekusi Pemicu>.

Jika Anda menggunakan tindakan Office 365 Outlook, Anda mendapatkan hasil yang mirip dengan cuplikan layar berikut:

Screenshot showing an email with the

Pilih tindakan

Secara default, tindakan Pilih membuat array yang berisi objek JSON yang dibangun dari nilai dalam array yang ada. Misalnya, Anda dapat membuat objek JSON untuk setiap nilai dalam array bilangan bulat dengan menentukan properti yang harus dimiliki setiap objek JSON dan memetakan nilai dari array sumber ke properti tersebut. Meskipun Anda dapat mengubah objek JSON komponen, array output selalu memiliki jumlah item yang sama dengan array sumber. Untuk menggunakan array output dari tindakan Pilih , tindakan berikutnya harus menerima array sebagai input, atau Anda mungkin harus mengubah array output menjadi format lain yang kompatibel.

Untuk mencoba tindakan Pilih , ikuti langkah-langkah ini dengan menggunakan perancang alur kerja. Atau, jika Anda lebih suka bekerja di editor tampilan kode, Anda dapat menyalin contoh Definisi tindakan Pilih dan Inisialisasi variabel dari panduan ini ke definisi alur kerja dasar aplikasi logika Anda sendiri: Contoh kode operasi data - Pilih. Untuk informasi selengkapnya tentang tindakan ini dalam definisi alur kerja yang mendasari, lihat tindakan Pilih.

Tip

Untuk contoh yang membuat membuat array dengan string atau bilangan bulat yang dibangun dari nilai dalam array objek JSON, lihat definisi tindakan variabel Pilih dan Initliaze dalam Contoh kode operasi data - Pilih.

  1. Di portal Azure, Visual Studio, atau Visual Studio Code, buka alur kerja aplikasi logika Anda di perancang.

    Contoh ini menggunakan portal Azure dan alur kerja sampel dengan pemicu Pengulangan diikuti dengan tindakan Inisialisasi variabel. Tindakan disiapkan untuk membuat variabel di mana nilai awal adalah array yang memiliki beberapa bilangan bulat sampel.

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

  2. Di alur kerja tempat Anda ingin membuat array objek JSON, ikuti salah satu langkah berikut:

    • Untuk menambahkan tindakan di bawah langkah terakhir, pilih Langkah baru.

    • Untuk menambahkan tindakan di antara langkah, gerakkan mouse ke panah yang menyambungkan sehingga tanda plus (+) muncul. Pilih tanda plus, lalu pilih Tambahkan tindakan.

  3. Di bagian kotak pencarian Pilih operasi, pilih Bawaan. Dalam kotak pencarian, masukkan pilih.

  4. Dari daftar tindakan, pilih tindakan bernama Pilih.

    Screenshot showing the designer for a Consumption workflow, the

  5. Dalam kotak Dari , masukkan array sumber yang ingin Anda gunakan.

    Untuk contoh ini, pilih di dalam kotak Dari , yang membuka daftar konten dinamis. Dari daftar tersebut, pilih variabel yang dibuat sebelumnya:

    Screenshot showing the designer for a Consumption workflow, the

  6. Untuk properti Peta, di kolom kiri, masukkan nama properti untuk menjelaskan semua nilai dalam array sumber.

    Contoh ini menggunakan Product_ID sebagai nama properti untuk nilai bilangan bulat dalam array sumber. Jadi, setiap nilai, misalnya, 1, 2, 3, dan 4, adalah ID produk.

  7. Di kolom kanan, masukkan ekspresi yang menentukan nilai dalam array sumber untuk nama properti di kolom kiri.

    Contoh ini menggunakan fungsi item() untuk melakukan iterasi dan mengakses setiap item dalam array.

    1. Pilih di dalam kolom kanan, yang membuka daftar konten dinamis.

    2. Dari daftar tersebut, pilih Ekspresi untuk membuka editor ekspresi sebagai gantinya.

    3. Di editor ekspresi, masukkan fungsi bernama item(), lalu pilih OK.

    Screenshot showing the designer for a Consumption workflow, the

    Tindakan Pilih sekarang muncul mirip dengan contoh berikut:

    Screenshot showing the

  8. Simpan alur kerja Anda. Di bar alat perancang, pilih Simpan.

Menguji alur kerja

Untuk mengonfirmasi apakah tindakan Pilih membuat hasil yang diharapkan, kirimi diri Anda pemberitahuan yang menyertakan output dari tindakan Pilih.

  1. Di alur kerja Anda, tambahkan tindakan yang bisa mengirimi Anda hasil dari tindakan Pilih .

    Contoh ini berlanjut dengan menggunakan tindakan Office 365 Outlook bernama Kirim email.

  2. Dalam tindakan ini, selesaikan langkah-langkah berikut:

    1. Untuk setiap kotak tempat Anda ingin hasil muncul, pilih di dalam setiap kotak, yang membuka daftar konten dinamis.

    2. Dari daftar tersebut, pilih Ekspresi untuk membuka editor ekspresi sebagai gantinya.

    3. Untuk mendapatkan output array dari tindakan Pilih, masukkan ekspresi berikut, yang menggunakan fungsi actionBody() denganpilih nama tindakan, dan pilih OK:

      actionBody('Select')

      Screenshot showing a Consumption workflow with the

      Ekspresi yang diselesaikan menentukan untuk menampilkan output dari tindakan Pilih di isi email saat dikirim:

      Screenshot showing a Consumption workflow with the finished

    Setelah selesai, tindakan Kirim email terlihat mirip dengan contoh berikut:

  3. Simpan alur kerja Anda, lalu jalankan alur kerja Anda secara manual. Pada toolbar perancang, pilih Jalankan Eksekusi Pemicu>.

Jika Anda menggunakan tindakan Office 365 Outlook, Anda mendapatkan hasil yang mirip dengan cuplikan layar berikut:

Screenshot showing an email with the

Pemecahan Masalah

Memformat data tabel

Jika tabel CSV atau tabel HTML Anda dihasilkan dengan pemformatan yang salah, pastikan data input memiliki spasi di antara baris.

Pemformatan yang salah:

Fruit,Number Apples,1 Oranges,2

Pemformatan yang benar:

Fruit,Number
Apples,1
Oranges,2

Untuk menambahkan spasi antara baris, tambahkan salah satu ekspresi berikut ini ke tabel Anda:

replace(body('Create_CSV_table'),'','<br/>')
replace(body('Create_HTML_table'),'','<br/>')

Misalnya:

{
	"Send_an_email_": {
		"inputs": {
			"body": {
				"Body": "<p>Results from Create CSV table action:<br/>\n<br/>\n<br/>\n@{replace(body('Create_CSV_table'),'\r\n','<br/>')}</p>",
				"Subject": "Create CSV table results",
				"To": "sophia.owen@fabrikam.com"
			}
		}
	}
}

Langkah berikutnya