Encode dan decode file datar di Azure Logic Apps

Berlaku untuk: Azure Logic Apps (Konsumsi + Standar)

Sebelum Anda mengirim konten XML ke mitra bisnis dalam skenario bisnis-dengan-bisnis (Business-to-Business; B2B), Anda mungkin ingin mengenkode konten tersebut terlebih dahulu. Jika Anda menerima konten XML yang didekodekan, Anda harus mendekode konten tersebut terlebih dahulu. Saat membangun alur kerja aplikasi logika di Azure Logic Apps, Anda dapat mengodekan dan mendekode file datar menggunakan tindakan konektor bawaan File Datar dan skema file datar untuk pengodean dan pendekodean. Anda dapat menggunakan tindakan File Datar di alur kerja aplikasi logika Konsumsi multipenyewa dan alur kerja aplikasi logika Standar penyewa tunggal.

Meskipun tidak ada pemicu Flat File yang tersedia, Anda dapat menggunakan pemicu atau tindakan apa pun untuk memasukkan konten XML sumber ke dalam alur kerja Anda. Misalnya, Anda dapat menggunakan pemicu konektor bawaan, pemicu konektor terkelola atau yang dihosting Azure yang tersedia untuk Azure Logic Apps, atau bahkan aplikasi lain.

Artikel ini menunjukkan cara menambahkan tindakan pengodean dan pendekodean File Datar ke alur kerja Anda.

• Tambahkan tindakan pengodean dan pendekodean File Datar ke alur kerja Anda.
• Pilih skema yang ingin Anda gunakan.

Untuk informasi selengkapnya, tinjau dokumentasi berikut ini:

• Konsumsi versus aplikasi logika Standar
• Konektor bawaan akun integrasi
• Gambaran umum konektor bawaan untuk Azure Logic Apps
• Konektor terkelola atau yang dihosting Azure di Azure Logic Apps

Prasyarat

• Akun dan langganan Azure. Jika Anda belum memiliki langganan, daftar untuk akun Azure gratis.

• Alur kerja aplikasi logika, kosong atau sudah ada, tempat Anda ingin menggunakan tindakan File Datar.

  Jika Anda memiliki alur kerja kosong, gunakan pemicu apa pun yang Anda inginkan untuk memulai alur kerja. Contoh ini menggunakan pemicu Permintaan.

• Sumber daya dan alur kerja aplikasi logika Anda. Operasi file datar tidak memiliki pemicu yang tersedia. Jadi, alur kerja Anda setidaknya harus menyertakan pemicu. Untuk informasi selengkapnya, lihat dokumentasi berikut:

  • Membuat contoh alur kerja aplikasi logika Konsumsi di Azure Logic Apps multipenyewa

  • Membuat contoh alur kerja aplikasi logika Standar di Azure Logic Apps penyewa tunggal

• Skema file datar untuk pengodean dan pendekodean konten XML. Untuk mengetahui informasi selengkapnya, Tambahkan skema yang akan digunakan dengan alur kerja di Azure Logic Apps.

• Berdasarkan apakah Anda bekerja pada alur kerja aplikasi logika Konsumsi atau Standar, Anda memerlukan sumber daya akun integrasi. Biasanya, Anda memerlukan sumber daya ini ketika Anda ingin menentukan dan menyimpan artefak untuk digunakan dalam integrasi perusahaan dan alur kerja B2B.

  Penting

  Untuk bekerja sama, akun integrasi dan sumber daya aplikasi logika Anda harus berada di langganan Azure dan wilayah Azure yang sama.

  • Jika Anda sedang mengerjakan alur kerja aplikasi logika Konsumsi, sumber daya aplikasi logika Anda memerlukan tautan ke akun integrasi Anda.

  • Jika Anda sedang mengerjakan alur kerja aplikasi logika Standar, Anda dapat menautkan sumber daya aplikasi logika ke akun integrasi, mengunggah skema langsung ke sumber daya aplikasi logika, atau keduanya, berdasarkan skenario berikut:

    • Jika sudah memiliki akun integrasi dengan artefak yang dibutuhkan atau ingin digunakan, Anda dapat menautkan akun integrasi ke beberapa sumber daya aplikasi logika Standar tempat Anda ingin menggunakan artefak tersebut. Dengan cara tersebut, Anda tidak perlu mengunggah skema ke setiap aplikasi logika individual. Untuk informasi selengkapnya, tinjau Menautkan sumber daya aplikasi logika Anda ke akun integrasi Anda.

    • Konektor bawaan File Datar memungkinkan Anda memilih skema yang sebelumnya diunggah ke sumber daya aplikasi logika atau ke akun integrasi tertaut, tetapi tidak keduanya. Kemudian, Anda dapat menggunakan artefak ini di seluruh alur kerja turunan di dalam sumber daya aplikasi logika yang sama.

    Jadi, apabila Anda tidak memiliki atau memerlukan akun integrasi, Anda dapat menggunakan opsi unggah. Jika tidak, Anda dapat menggunakan opsi penautan. Bagaimanapun, Anda dapat menggunakan artefak ini di seluruh alur kerja turunan di dalam sumber daya aplikasi logika yang sama.

Batasan

• Konten XML yang ingin Anda dekodekan harus dikodekan dalam format UTF-8.

• Dalam skema file datar Anda, pastikan grup XML yang dimuat tidak memiliki jumlah properti max count yang berlebihan yang diatur ke nilai lebih besar dari 1. Hindari menyarangkan grup XML dengan nilai properti max count lebih besar dari 1 di dalam grup XML lain dengan properti max count lebih besar dari 1.

• Saat Azure Logic Apps mengurai skema file datar, dan kapan pun skema mengizinkan pilihan fragmen berikutnya, Azure Logic Apps membuat simbol dan prediksi untuk fragmen tersebut. Jika skema memungkinkan terlalu banyak konstruksi seperti itu, misalnya, lebih dari 100.000, perluasan skema menjadi sangat besar, yang menghabiskan terlalu banyak sumber daya dan waktu.

Mengunggah skema

Setelah membuat skema, Anda sekarang harus mengunggah skema berdasarkan skenario berikut:

• Jika sedang mengerjakan alur kerja aplikasi logika Konsumsi, tambahkan skema Anda ke akun integrasi Anda.

• Jika Anda sedang mengerjakan alur kerja aplikasi logika Standar, Anda dapat menambahkan skema ke akun integrasi Anda, atau menambahkan skema ke sumber daya aplikasi logika Anda.

Menambahkan tindakan pengodean File Datar

Consumption

1. Di portal Azure, buka alur kerja aplikasi logika Anda di perancang, jika belum dibuka.

2. Apabila alur kerja Anda tidak memiliki pemicu atau tindakan lain yang dibutuhkan alur kerja Anda, tambahkan operasi tersebut terlebih dahulu. Operasi File Datar tidak memiliki pemicu yang tersedia.

   Contoh ini berlanjut dengan pemicu Permintaan bernama Saat permintaan HTTP diterima.

3. Pada perancang alur kerja, pada langkah saat Anda ingin menambahkan tindakan File Datar, pilih Langkah baru.

4. Di bagian kotak pencarian Pilih operasi, pilih Bawaan. Di kotak pencarian, masukkan file datar.

5. Dari daftar tindakan, pilih tindakan bernama Pengodean File Datar.

   

6. Di properti Konten tindakan, berikan output dari pemicu atau tindakan sebelumnya yang ingin Anda kodekan dengan mengikuti langkah-langkah berikut:

   1. Klik di dalam kotakKonten sehingga daftar konten dinamis muncul.

   2. Dari daftar konten dinamis, pilih konten file datar yang ingin Anda kodekan.

      Untuk contoh ini, dari daftar konten dinamis, pada Saat permintaan HTTP diterima, pilih token Isi, yang mewakili output konten isi dari pemicu.

   

   Catatan

   Jika properti Isi idak muncul dalam daftar konten dinamis, pilih Lihat selengkapnya di samping label bagian Saat permintaan HTTP diterima. Anda juga dapat langsung memasukkan konten yang akan dikodekan dalam kotak Konten.

7. Dari daftar Nama Skema, pilih skema Anda.

   

   Catatan

   Jika daftar skema kosong, sumber daya aplikasi logika Anda tidak ditautkan ke akun integrasi Anda atau akun integrasi Anda tidak berisi file skema apa pun.

   Setelah selesai, tindakan Anda akan terlihat seperti berikut:

   

8. Untuk menambahkan parameter opsional lainnya ke tindakan, pilih parameter tersebut dari daftar Tambahkan parameter baru.

   Parameter	Nilai	Deskripsi
   Mode pembuatan node kosong	ForcedDisabled atau HonorSchemaNodeProperty atau ForcedEnabled	Mode yang digunakan untuk pembuatan simpul kosong dengan pengodean file datar. Untuk BizTalk, skema file datar memiliki properti yang mengontrol pembuatan simpul kosong. Anda dapat mengikuti perilaku properti pembuatan simpul kosong untuk skema file datar Anda, atau Anda dapat menggunakan pengaturan ini agar Azure Logic Apps menghasilkan atau menghilangkan simpul kosong. Untuk informasi selengkapnya, lihat Tag untuk elemen kosong.
   Normalisasi XML	Ya atau Tidak	Pengaturan untuk mengaktifkan atau menonaktifkan normalisasi XML dalam pengodean file datar. Untuk informasi selengkapnya, lihat XmlTextReader.Normalization.

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

Standard

1. Di portal Azure, buka alur kerja aplikasi logika Anda di perancang, jika belum dibuka.

2. Apabila alur kerja Anda tidak memiliki pemicu atau tindakan lain yang dibutuhkan alur kerja Anda, tambahkan operasi tersebut terlebih dahulu. Operasi File Datar tidak memiliki pemicu yang tersedia.

   Contoh ini berlanjut dengan pemicu Permintaan bernama Saat permintaan HTTP diterima.

3. Pada perancang, pada langkah saat Anda ingin menambahkan tindakan File Datar, pilih tanda plus (+), lalu pilih Tambahkan tindakan.

4. Pada panel Tambahkan tindakan yang muncul, pada kotak pencarian, pilih Bawaan.

5. Di kotak pencarian, masukkan file datar. Dari daftar tindakan, pilih tindakan bernama Pengodean File Datar.

   

6. Di properti Konten tindakan, berikan output dari pemicu atau tindakan sebelumnya yang ingin Anda kodekan dengan mengikuti langkah-langkah berikut:

   1. Klik di dalam kotakKonten sehingga daftar konten dinamis muncul.

   2. Dari daftar konten dinamis, pilih konten file datar yang ingin Anda kodekan.

      Untuk contoh ini, dari daftar konten dinamis, pada Saat permintaan HTTP diterima, pilih token Isi, yang mewakili output konten isi dari pemicu.

   

7. Dari daftar Sumber, pilih LogicApp atau IntegrationAccount sebagai sumber skema Anda.

   Contoh ini berlanjut dengan memilih IntegrationAccount.

   

8. Dari daftar Nama, pilih skema yang sebelumnya Anda unggah ke sumber daya aplikasi logika untuk pengodean, misalnya:

   

   Catatan

   Jika daftar skema kosong, sumber daya aplikasi logika Anda tidak ditautkan ke akun integrasi Anda, akun integrasi Anda tidak berisi file skema apa pun, atau sumber daya aplikasi logika Anda tidak berisi file skema apa pun.

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

Menambahkan tindakan pendekodean File Datar

Consumption

1. Di portal Azure, buka alur kerja aplikasi logika Anda di perancang, jika belum dibuka.

2. Apabila alur kerja Anda tidak memiliki pemicu atau tindakan lain yang dibutuhkan alur kerja Anda, tambahkan operasi tersebut terlebih dahulu. Operasi File Datar tidak memiliki pemicu yang tersedia.

   Contoh ini berlanjut dengan pemicu Permintaan bernama Saat permintaan HTTP diterima.

3. Pada perancang alur kerja, pada langkah saat Anda ingin menambahkan tindakan File Datar, pilih Langkah baru.

4. Di bagian kotak pencarian Pilih operasi, pilih Bawaan. Di kotak pencarian, masukkan file datar.

5. Dari daftar tindakan, pilih tindakan bernama Pendekodean File Datar.

   

6. Di properti Konten tindakan, berikan output dari pemicu atau tindakan sebelumnya yang ingin Anda dekodekan dengan mengikuti langkah-langkah berikut:

   1. Klik di dalam kotakKonten sehingga daftar konten dinamis muncul.

   2. Dari daftar konten dinamis, pilih konten file datar yang ingin Anda kodekan.

      Untuk contoh ini, dari daftar konten dinamis, pada Saat permintaan HTTP diterima, pilih token Isi, yang mewakili output konten isi dari pemicu.

   

   Catatan

   Jika properti Isi idak muncul dalam daftar konten dinamis, pilih Lihat selengkapnya di samping label bagian Saat permintaan HTTP diterima. Anda juga dapat langsung memasukkan konten yang akan dikodekan dalam kotak Konten.

7. Dari daftar Nama Skema, pilih skema Anda.

   

   Catatan

   Jika daftar skema kosong, sumber daya aplikasi logika Anda tidak ditautkan ke akun integrasi Anda atau akun integrasi Anda tidak berisi file skema apa pun.

   Setelah selesai, tindakan Anda akan terlihat seperti berikut:

   

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

Standard

1. Di portal Azure, buka alur kerja aplikasi logika Anda di perancang, jika belum dibuka.

2. Apabila alur kerja Anda tidak memiliki pemicu atau tindakan lain yang dibutuhkan alur kerja Anda, tambahkan operasi tersebut terlebih dahulu. Operasi File Datar tidak memiliki pemicu yang tersedia.

   Contoh ini berlanjut dengan pemicu Permintaan bernama Saat permintaan HTTP diterima.

3. Pada perancang, pada langkah saat Anda ingin menambahkan tindakan File Datar, pilih tanda plus (+), lalu pilih Tambahkan tindakan.

4. Pada panel Tambahkan tindakan yang muncul, pada kotak pencarian, pilih Bawaan.

5. Di kotak pencarian, masukkan file datar. Dari daftar tindakan, pilih tindakan bernama Pendekodean File Datar.

   

6. Di properti Konten tindakan, berikan output dari pemicu atau tindakan sebelumnya yang ingin Anda dekodekan dengan mengikuti langkah-langkah berikut:

   1. Klik di dalam kotakKonten sehingga daftar konten dinamis muncul.

   2. Dari daftar konten dinamis, pilih konten file datar yang ingin Anda kodekan.

      Untuk contoh ini, dari daftar konten dinamis, pada Saat permintaan HTTP diterima, pilih token Isi, yang mewakili output konten isi dari pemicu.

   

7. Dari daftar Sumber, pilih LogicApp atau IntegrationAccount sebagai sumber skema Anda.

   Contoh ini berlanjut dengan memilih IntegrationAccount.

   

8. Dari daftar Nama, pilih skema yang sebelumnya Anda unggah ke sumber daya aplikasi logika untuk pendekodean, misalnya:

   

   Catatan

   Jika daftar skema kosong, sumber daya aplikasi logika Anda tidak ditautkan ke akun integrasi Anda, akun integrasi Anda tidak berisi file skema apa pun, atau sumber daya aplikasi logika Anda tidak berisi file skema apa pun.

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

Anda sekarang sudah selesai menyiapkan tindakan mengenkode file flat Anda. Dalam aplikasi dunia nyata, Anda mungkin ingin menyimpan data yang dienkode dalam aplikasi lini bisnis (Line-Of Business; LOB), seperti Salesforce. Atau, Anda dapat mengirim data yang dienkode ke mitra dagang. Untuk mengirim output dari tindakan pendekodean ke Salesforce atau ke mitra dagang Anda, gunakan konektor lain yang tersedia di Azure Logic Apps:

• Konektor terkelola untuk Azure Logic Apps
• Konektor bawaan untuk Azure Logic Apps

Menguji alur kerja

1. Dengan menggunakan Postman atau alat serupa dan metode POST, kirim panggilan ke URL pemicu Permintaan, yang muncul di properti HTTP POST URL pemicu Permintaan, dan sertakan konten XML yang ingin Anda kodekan atau dekode dalam isi permintaan.

2. Setelah operasi alur kerja selesai, buka riwayat alur kerja, lalu periksa input dan output tindakan File Datar.

Langkah berikutnya

• Pelajari selengkapnya tentang Paket Integrasi Enterprise