Bertukar pesan EDIFACT menggunakan alur kerja di Azure Logic Apps

Untuk mengirim dan menerima pesan EDIFACT dalam alur kerja yang Anda buat menggunakan Azure Logic Apps, gunakan konektor EDIFACT , yang menyediakan operasi yang mendukung dan mengelola komunikasi EDIFACT.

Panduan ini menunjukkan cara menambahkan tindakan pengodean dan dekode EDIFACT ke alur kerja aplikasi logika yang ada. Ketika tidak ada pemicu EDIFACT yang tersedia, Anda dapat memicu apa pun untuk memulai alur kerja Anda. Contoh dalam panduan ini menggunakan pemicu Permintaan.

referensi teknis Koneksi or

Konektor EDIFACT memiliki versi yang berbeda, berdasarkan jenis aplikasi logika dan lingkungan host.

Aplikasi logika	Lingkungan	Versi konektor
Consumption	Azure Logic Apps multipenyewa	Konektor terkelola EDIFACT (kelas Standar). Konektor EDIFACT hanya menyediakan tindakan, tetapi Anda dapat menggunakan pemicu apa pun yang berfungsi untuk skenario Anda. Untuk informasi selengkapnya, lihat dokumentasi berikut ini: - Referensi konektor terkelola EDIFACT - Batas pesan EDIFACT
Consumption	Lingkungan layanan integrasi (ISE)	Konektor terkelola EDIFACT (kelas Standar) dan versi ISE EDIFACT , yang memiliki batas pesan yang berbeda dari kelas Standar. Konektor EDIFACT hanya menyediakan tindakan, tetapi Anda dapat menggunakan pemicu apa pun yang berfungsi untuk skenario Anda. Untuk informasi selengkapnya, lihat dokumentasi berikut ini: - Referensi konektor terkelola EDIFACT - Batas pesan EDIFACT
Standard	Azure Logic Apps penyewa tunggal dan Lingkungan App Service v3 (hanya paket Windows)	Konektor bawaan EDIFACT (pratinjau) dan konektor terkelola EDIFACT . Versi bawaan berbeda dengan cara berikut: - Versi bawaan hanya menyediakan tindakan, tetapi Anda dapat menggunakan pemicu apa pun yang berfungsi untuk skenario Anda. - Versi bawaan dapat langsung mengakses jaringan virtual Azure. Anda tidak memerlukan gateway data lokal. Untuk informasi selengkapnya, lihat dokumentasi berikut ini: - Referensi konektor terkelola EDIFACT - Operasi konektor bawaan EDIFACT - Batas pesan EDIFACT

Operasi bawaan EDIFACT (hanya alur kerja Standar - Pratinjau)

Konektor bawaan EDIFACT pratinjau memiliki tindakan berikut, yang mirip dengan tindakan konektor terkelola EDIFACT mitra mereka, kecuali jika dicatat dalam Batasan dan masalah yang diketahui.

• Tindakan Pengodean EDIFACT
• Tindakan Dekode EDIFACT

Batasan dan masalah yang diketahui

• Pratinjau konektor bawaan EDIFACT

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

  • Tindakan konektor ini saat ini mendukung payload hingga setidaknya 100 MB.

  • Tindakan EDIFACT Decode pratinjau saat ini tidak menyertakan kemampuan berikut:

    • Periksa nomor kontrol pertukaran duplikat, grup, dan set transaksi, jika dikonfigurasi.

    • Pertahankan seluruh pertukaran.

    Jika tidak, pratinjau EDIFACT Encode dan tindakan konektor bawaan dekode EDIFACT memiliki kemampuan yang mirip dengan tindakan konektor terkelola EDIFACT mitra mereka.

  • Tindakan konektor ini saat ini tidak mendukung pertukaran dengan beberapa transaksi atau pesan batch.

  • Tindakan konektor ini saat ini tidak memancarkan pelacakan khusus EDI.

Prasyarat

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

• Sumber daya akun integrasi tempat Anda mendefinisikan dan menyimpan artefak, seperti mitra dagang, perjanjian, sertifikat, dan sebagainya, untuk digunakan dalam integrasi perusahaan dan alur kerja B2B Anda. Sumber daya ini harus memenuhi persyaratan berikut:

  • Akun integrasi dan sumber daya aplikasi logika Anda harus ada di langganan Azure dan wilayah Azure yang sama.

  • Menentukan setidaknya dua mitra dagang yang berpartisipasi dalam operasi EDIFACT yang digunakan dalam alur kerja Anda. Definisi untuk kedua mitra harus menggunakan pengkualifikasi identitas bisnis yang sama, yaitu ZZZ - Ditentukan Bersama untuk skenario ini.

  • Menentukan perjanjian EDIFACT antara mitra dagang yang berpartisipasi dalam alur kerja Anda. Setiap perjanjian membutuhkan mitra host dan mitra tamu. Konten dalam pesan antara Anda dan mitra lain harus sesuai dengan jenis perjanjian. Untuk informasi tentang pengaturan perjanjian yang akan digunakan saat menerima dan mengirim pesan, lihat Pengaturan pesan EDIFACT.

    Penting

    Konektor EDIFACT hanya mendukung karakter UTF-8. Jika output Anda berisi karakter yang tidak terduga, periksa apakah pesan EDIFACT Anda menggunakan tataan karakter UTF-8.

• Berdasarkan apakah Anda mengerjakan alur kerja aplikasi logika Konsumsi atau Standar, sumber daya aplikasi logika Anda mungkin memerlukan tautan ke akun integrasi Anda:

  Alur kerja aplikasi logika	Tautan diperlukan?
  Consumption	Koneksi dan tautan ke akun integrasi diperlukan. Anda dapat membuat koneksi saat menambahkan operasi EDIFACT ke alur kerja Anda.
  Standard	Koneksi ke akun integrasi yang diperlukan, tetapi tidak diperlukan tautan. Anda dapat membuat koneksi saat menambahkan operasi EDIFACT ke alur kerja Anda.

• Sumber daya aplikasi logika dan alur kerja tempat Anda ingin menggunakan operasi EDIFACT.

  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

Enkode pesan EDIFACT

Tindakan konektor terkelola EDIFACT bernama Encode ke tindakan pesan EDIFACT dan tindakan konektor bawaan EDIFACT bernama EDIFACT Encode melakukan tugas-tugas berikut, kecuali jika dicatat dalam Batasan dan masalah yang diketahui:

• Menyelesaikan perjanjian dengan mencocokkan pengualifikasi & pengidentifikasi pengirim serta pengualifikasi dan pengidentifikasi penerima.

• Menserialisasi Electronic Data Interchange (EDI), yang mengubah pesan yang dikodekan XML menjadi set transaksi EDI di pertukaran.

• Menerapkan header set transaksi dan segmen trailer.

• Menghasilkan nomor kontrol pertukaran, nomor kontrol grup, dan nomor kontrol set transaksi untuk setiap pertukaran keluar.

• Mengganti pemisah dalam data payload.

• Memvalidasi EDI dan properti khusus mitra, seperti skema untuk elemen data set transaksi terhadap skema pesan, elemen data set transaksi, dan validasi yang diperluas pada elemen data set transaksi.

• Menghasilkan dokumen XML untuk setiap set transaksi.

• Meminta pengakuan teknis, pengakuan fungsional, atau keduanya, jika dikonfigurasi.

  • Sebagai pengakuan teknis, pesan CONTRL menunjukkan penerimaan pertukaran.

  • Sebagai pengakuan fungsional, pesan CONTRL menunjukkan penerimaan atau penolakan terhadap pertukaran, grup, atau pesan yang diterima, dengan daftar kesalahan atau fungsionalitas yang tidak didukung.

Consumption

1. Di portal Microsoft Azure, buka sumber daya dan alur kerja aplikasi logika Anda di perancang.

2. Di perancang, ikuti langkah-langkah umum ini untuk menambahkan tindakan EDIFACT bernama Encode ke pesan EDIFACT berdasarkan nama perjanjian ke alur kerja Anda.

   Catatan

   Jika Anda ingin menggunakan tindakan Encode ke pesan EDIFACT berdasarkan identitas , Anda kemudian harus memberikan nilai yang berbeda, seperti pengidentifikasi Pengirim dan Pengidentifikasi Penerima yang ditentukan oleh perjanjian EDIFACT Anda. Anda juga harus menentukan pesan XML untuk dikodekan, yang dapat menjadi output dari pemicu atau tindakan sebelumnya.

3. Berikan informasi koneksi berikut untuk akun integrasi Anda:

   Properti	Wajib	Deskripsi
   Nama koneksi	Ya	Nama untuk koneksi
   Akun integrasi	Ya	Dari daftar akun integrasi yang tersedia, pilih akun yang akan digunakan.

   Misalnya:

   

4. Jika sudah selesai, pilih Buat.

5. Dalam tindakan EDIFACT, berikan nilai properti berikut:

   Properti	Wajib	Deskripsi
   Nama perjanjian EDIFACT	Ya	Perjanjian EDIFACT yang digunakan.
   Pesan XML untuk dikodekan	Ya	Pengidentifikasi bisnis untuk pengirim pesan sebagaimana yang telah ditentukan oleh perjanjian EDIFACT Anda
   Parameter lainnya	No	Operasi ini mencakup parameter lain berikut: - Pemisah Elemen Data - Indikator rilis - Pemisah Komponen - Pemisah pengulangan - Terminator segmen - Akhiran terminator segmen - Indikator desimal Untuk informasi selengkapnya, lihat Pengaturan pesan EDIFACT.

   Misalnya, payload pesan XML untuk dikodekan dapat menjadi output konten Isi dari pemicu Permintaan:

   

6. Simpan alur kerja Anda.

Standard

Konektor bawaan EDIFACT (pratinjau)

1. Di portal Microsoft Azure, buka sumber daya dan alur kerja aplikasi logika Anda di perancang.

2. Di perancang, ikuti langkah-langkah umum ini untuk menambahkan tindakan EDIFACT bernama EDIFACT Encode ke alur kerja Anda.

3. Di panel tindakan EDIFACT, berikan nilai properti yang diperlukan:

   Properti	Wajib	Deskripsi
   Pesan untuk Dikodekan	Ya	Konten pesan XML yang ingin Anda kodekan. Secara khusus, pengidentifikasi bisnis untuk pengirim pesan sebagaimana ditentukan oleh perjanjian EDIFACT Anda.
   Parameter tingkat lanjut	No	Dari daftar, tambahkan properti lain yang ingin Anda gunakan. Operasi ini mencakup parameter lain berikut: - Kualifikasi Penerima Identitas Pengirim - Pengidentifikasi Penerima Identitas Pengirim - Kualifikasi Penerima Identitas Penerima Penerima - Pengidentifikasi Penerima Identitas Penerima - Nama perjanjian EDIFACT

   Misalnya, payload pesan XML untuk dikodekan dapat menjadi output konten Isi dari pemicu Permintaan:

   

4. Simpan alur kerja Anda.

Konektor terkelola EDIFACT

1. Di portal Microsoft Azure, buka sumber daya dan alur kerja aplikasi logika Anda di perancang.

2. Di perancang, ikuti langkah-langkah umum ini untuk menambahkan tindakan EDIFACT bernama Encode ke pesan EDIFACT berdasarkan nama perjanjian ke alur kerja Anda.

   Catatan

   Jika Anda ingin menggunakan tindakan Encode ke pesan EDIFACT berdasarkan identitas , Anda kemudian harus memberikan nilai yang berbeda, seperti pengidentifikasi Pengirim dan Pengidentifikasi Penerima yang ditentukan oleh perjanjian EDIFACT Anda. Anda juga harus menentukan pesan XML untuk dikodekan, yang dapat menjadi output dari pemicu atau tindakan sebelumnya.

3. Berikan informasi koneksi berikut untuk akun integrasi Anda:

   Properti	Wajib	Deskripsi
   Nama koneksi	Ya	Nama untuk koneksi
   ID Akun Integrasi	Ya	ID sumber daya untuk akun integrasi Anda, yang memiliki format berikut: /subscriptions/<Azure-subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Logic/integrationAccounts/<integration-account-name> Misalnya: /subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/resourceGroups/integrationAccount-RG/providers/Microsoft.Logic/integrationAccounts/myIntegrationAccount Untuk menemukan ID sumber daya ini, ikuti langkah-langkah berikut: 1. Di portal Azure, buka akun integrasi Anda. 2. Pada menu akun integrasi, pilih Gambaran Umum. 3. Pada halaman Gambaran Umum , pilih Tampilan JSON. 4. Dari properti ID Sumber Daya, salin nilainya.
   URL SAS Akun Integrasi	Ya	URL titik akhir permintaan yang menggunakan autentikasi tanda tangan akses bersama (SAS) untuk menyediakan akses ke akun integrasi Anda. URL panggilan balik ini memiliki format berikut: https://<request-endpoint-URI>sp=<permissions>sv=<SAS-version>sig=<signature> Misalnya: https://prod-04.west-us.logic-azure.com:443/integrationAccounts/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX?api-version=2015-08-1-preview&sp=XXXXXXXXX&sv=1.0&sig=ZZZZZZZZZZZZZZZZZZZZZZZZZZZ Untuk menemukan URL ini, ikuti langkah-langkah berikut: 1. Di portal Azure, buka akun integrasi Anda. 2. Pada menu akun integrasi, di bawah Pengaturan, pilih URL Panggilan Balik. 3. Dari properti URL Panggilan Balik yang Dihasilkan, salin nilainya.
   Ukuran Blok Nomor Kontrol	No	Ukuran blok nomor kontrol untuk dicadangkan dari perjanjian untuk skenario throughput tinggi

   Misalnya:

   

4. Jika sudah selesai, pilih Buat.

5. Di panel tindakan EDIFACT, berikan nilai properti berikut ini:

   Properti	Wajib	Deskripsi
   Nama perjanjian EDIFACT	Ya	Perjanjian EDIFACT yang digunakan.
   Pesan XML untuk dikodekan	Ya	Pengidentifikasi bisnis untuk pengirim pesan sebagaimana yang telah ditentukan oleh perjanjian EDIFACT Anda
   Parameter lainnya	No	Operasi ini mencakup parameter lain berikut: - Pemisah Elemen Data - Indikator rilis - Pemisah Komponen - Pemisah pengulangan - Terminator segmen - Akhiran terminator segmen - Indikator desimal Untuk informasi selengkapnya, lihat Pengaturan pesan EDIFACT.

   Misalnya, payload pesan XML untuk dikodekan dapat menjadi output konten Isi dari pemicu Permintaan:

   

6. Simpan alur kerja Anda.

Pesan Dekode EDIFACT

Tindakan konektor terkelola EDIFACT bernama tindakan dekode pesan EDIFACT dan tindakan konektor bawaan EDIFACT bernama Dekode EDIFACT melakukan tugas berikut, kecuali jika dicatat dalam Batasan dan masalah yang diketahui:

• Memvalidasi amplop terhadap perjanjian mitra dagang.

• Menyelesaikan perjanjian dengan mencocokkan pengualifikasi & pengidentifikasi pengirim beserta pengualifikasi dan pengidentifikasi penerima.

• Membagi pertukaran menjadi beberapa set transaksi ketika pertukaran memiliki lebih dari satu transaksi, berdasarkan Pengaturan Penerima perjanjian.

• Membongkar pertukaran.

• Memvalidasi Electronic Data Interchange (EDI) dan properti khusus mitra, seperti struktur amplop pertukaran, skema amplop terhadap skema kontrol, skema untuk elemen data set transaksi terhadap skema pesan, dan validasi diperpanjang pada elemen data set transaksi.

• Verifikasi bahwa nomor kontrol pertukaran, grup, dan set transaksi bukan duplikat (hanya konektor terkelola), jika dikonfigurasi, misalnya:

  • Memeriksa nomor kontrol pertukaran terhadap pertukaran yang diterima sebelumnya.

  • Memeriksa nomor kontrol grup terhadap nomor kontrol grup lain di pertukaran.

  • Memeriksa nomor kontrol set transaksi terhadap nomor kontrol set transaksi lain dalam grup tersebut.

• Pisahkan pertukaran menjadi set transaksi, atau pertahankan seluruh pertukaran (hanya konektor terkelola), misalnya:

  • Membagi Pertukaran sebagai set transaksi - menangguhkan set transaksi saat terjadi kesalahan.

    Tindakan pendekodean membagi pertukaran menjadi set transaksi dan mengurai setiap set transaksi. Tindakan hanya menghasilkan set transaksi yang gagal memvalidasi ke badMessages, dan menghasilkan set transaksi yang tersisa ke goodMessages.

  • Membagi Pertukaran sebagai set transaksi - menangguhkan set transaksi saat terjadi kesalahan.

    Tindakan pendekodean membagi pertukaran menjadi set transaksi dan mengurai setiap set transaksi. Jika satu atau lebih set transaksi dalam pertukaran gagal memvalidasi, tindakan menghasilkan semua set transaksi dalam pertukaran tersebut ke badMessages.

  • Mempertahankan Pertukaran - menangguhkan set transaksi saat terjadi kesalahan.

    Tindakan pendekodean mempertahankan pertukaran dan memproses seluruh pertukaran batch. Tindakan hanya menghasilkan set transaksi yang gagal memvalidasi ke badMessages, dan menghasilkan set transaksi yang tersisa ke goodMessages.

  • Mempertahankan Pertukaran - menangguhkan pertukaran saat terjadi kesalahan.

    Tindakan pendekodean mempertahankan pertukaran dan memproses seluruh pertukaran batch. Jika satu atau lebih set transaksi dalam pertukaran gagal memvalidasi, tindakan menghasilkan semua set transaksi dalam pertukaran tersebut ke badMessages.

• Menghasilkan pengakuan teknis, pengakuan fungsional, atau keduanya, jika dikonfigurasi.

  • Pengakuan Teknis atau CONTRL ACK yang melaporkan hasil pemeriksaan sintaks dari pertukaran yang diterima lengkap.

  • Pengakuan fungsional yang mengakui penerimaan atau penolakan untuk pertukaran atau grup yang diterima.

Consumption

1. Di portal Microsoft Azure, buka sumber daya dan alur kerja aplikasi logika Anda di perancang.

2. Di perancang, ikuti langkah-langkah umum ini untuk menambahkan tindakan EDIFACT bernama dekode pesan EDIFACT ke alur kerja Anda.

3. Berikan informasi koneksi berikut untuk akun integrasi Anda:

   Properti	Wajib	Deskripsi
   Nama koneksi	Ya	Nama untuk koneksi
   Akun integrasi	Ya	Dari daftar akun integrasi yang tersedia, pilih akun yang akan digunakan.

   Misalnya:

   

4. Jika sudah selesai, pilih Buat.

5. Dalam tindakan EDIFACT, berikan nilai properti berikut:

   Properti	Wajib	Deskripsi
   Pesan file flat EDIFACT untuk didekodekan	Ya	Pesan file flat XML untuk didekodekan.
   Parameter lainnya	No	Operasi ini mencakup parameter lain berikut: - Pemisah Komponen - Pemisah Elemen Data - Indikator rilis - Pemisah pengulangan - Terminator segmen - Akhiran terminator segmen - Indikator desimal - Kumpulan karakter payload - Akhiran terminator segmen - Mempertahankan Pertukaran - Menangguhkan Pertukaran Saat Terjadi Kesalahan Untuk informasi selengkapnya, lihat Pengaturan pesan EDIFACT.

   Misalnya, payload pesan XML untuk didekodekan dapat berupa output konten Isi dari pemicu Permintaan:

   

Standard

Konektor bawaan EDIFACT (pratinjau)

1. Di portal Microsoft Azure, buka sumber daya dan alur kerja aplikasi logika Anda di perancang.

2. Di perancang, ikuti langkah-langkah umum ini untuk menambahkan tindakan EDIFACT bernama Dekode EDIFACT ke alur kerja Anda.

3. Dalam tindakan EDIFACT, berikan nilai properti berikut:

   Properti	Wajib	Deskripsi
   Pesan untuk Didekodekan	Ya	Pesan file flat XML untuk didekodekan.
   Parameter lainnya	No	Operasi ini mencakup parameter lain berikut: - Pemisah Komponen - Pemisah Elemen Data - Indikator Rilis - Pemisah Pengulangan - Terminator Segment - Akhiran Terminator Segmen - Indikator Desimal - Set Karakter Payload - Akhiran Terminator Segmen - Mempertahankan Pertukaran - Menangguhkan Pertukaran Saat Terjadi Kesalahan Untuk informasi selengkapnya, lihat Pengaturan pesan EDIFACT.

   Misalnya, payload pesan XML untuk didekodekan dapat berupa output konten Isi dari pemicu Permintaan:

   

4. Simpan alur kerja Anda.

Konektor terkelola EDIFACT

1. Di portal Microsoft Azure, buka sumber daya dan alur kerja aplikasi logika Anda di perancang.

2. Di perancang, ikuti langkah-langkah umum ini untuk menambahkan tindakan EDIFACT bernama dekode pesan EDIFACT ke alur kerja Anda.

3. Berikan informasi koneksi berikut untuk akun integrasi Anda:

   Properti	Wajib	Deskripsi
   Nama koneksi	Ya	Nama untuk koneksi
   Akun integrasi	Ya	Dari daftar akun integrasi yang tersedia, pilih akun yang akan digunakan.

   Misalnya:

   

4. Jika sudah selesai, pilih Buat.

5. Di panel tindakan EDIFACT, berikan nilai properti berikut ini:

   Properti	Wajib	Deskripsi
   Nama perjanjian EDIFACT	Ya	Perjanjian EDIFACT yang digunakan.
   Pesan XML untuk dikodekan	Ya	Pengidentifikasi bisnis untuk pengirim pesan sebagaimana yang telah ditentukan oleh perjanjian EDIFACT Anda
   Parameter lainnya	No	Operasi ini mencakup parameter lain berikut: - Pemisah Elemen Data - Indikator rilis - Pemisah Komponen - Pemisah pengulangan - Terminator segmen - Akhiran terminator segmen - Indikator desimal Untuk informasi selengkapnya, lihat Pengaturan pesan EDIFACT.

   Misalnya, payload pesan XML untuk didekodekan dapat berupa output konten Isi dari pemicu Permintaan:

   

Menangani segmen UNH2.5 dalam dokumen EDIFACT

Dalam dokumen EDIFACT, segmen UNH2.5 digunakan untuk pencarian skema. Misalnya, dalam contoh pesan EDIFACT ini, bidang UNH adalah EAN008:

UNH+SSDD1+ORDERS:D:03B:UN:EAN008

Untuk menangani dokumen EDIFACT atau memproses pesan EDIFACT yang memiliki segmen UN2.5, ikuti langkah berikut:

1. Perbarui atau sebarkan skema yang memiliki nama node akar UNH2.5.

   Misalnya, nama akar skema untuk sampel bidang UNH adalah EFACT_D03B_ORDERS_EAN008. Untuk setiap D03B_ORDERS yang memiliki segmen UNH2.5 berbeda, Anda harus menyebarkan skema individual.

2. Di portal Azure, tambahkan skema ke sumber daya akun integrasi atau sumber daya aplikasi logika Anda, berdasarkan apakah Anda masing-masing memiliki alur kerja aplikasi logika Konsumsi atau Standar.

3. Baik Anda menggunakan tindakan pendekodean atau pengodean EDIFACT, unggah skema Anda dan siapkan pengaturan skema di bagian Pengaturan Penerimaan atau Pengaturan Pengiriman perjanjian EDIFACT Anda masing-masing.

4. Untuk mengedit perjanjian EDIFACT, pada panel Perjanjian, pilih perjanjian Anda. Pada toolbar panel Perjanjian, pilih Edit sebagai JSON.

   • Di bagian receiveAgreement perjanjian, temukan bagian schemaReferences, dan tambahkan nilai UNH2.5.

     

   • Di bagian sendAgreement perjanjian, temukan bagian schemaReferences, dan tambahkan nilai UNH2.5.

     

Langkah berikutnya

• Pengaturan pesan EDIFACT