Bertukar pesan X12 menggunakan alur kerja di Azure Logic Apps

  • Artikel

Berlaku untuk: Azure Logic Apps (Konsumsi + Standar)

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

Panduan cara ini menunjukkan cara menambahkan tindakan pengodean dan dekode X12 ke alur kerja aplikasi logika yang ada. Konektor X12 tidak menyertakan pemicu apa pun, sehingga Anda dapat menggunakan pemicu apa pun untuk memulai alur kerja Anda. Contoh dalam panduan ini menggunakan pemicu Permintaan.

referensi teknis Koneksi or

Konektor X12 memiliki satu versi di seluruh alur kerja di Azure Logic Apps multi-penyewa, Azure Logic Apps penyewa tunggal, dan lingkungan layanan integrasi (ISE). Untuk informasi teknis tentang konektor X12 , lihat dokumentasi berikut:

Prasyarat

  • Akun dan langganan Azure. Jika Anda belum berlangganan Azure, daftarkan akun Azure secara 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 X12 yang digunakan dalam alur kerja Anda. Definisi untuk kedua mitra harus menggunakan kualifikasi identitas bisnis X12 yang sama.

    • Menentukan perjanjian X12 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 X12.

      Penting

      Jika Anda bekerja dengan skema Health Insurance Portability and Accountability Act (HIPAA), Anda perlu menambahkan bagian schemaReferences ke perjanjian Anda. Untuk informasi selengkapnya, lihat skema HIPAA dan jenis pesan.

    • Menentukan skema yang akan digunakan untuk validasi XML.

      Penting

      Jika Anda bekerja sama dengan skema Health Insurance Portability and Accountability Act (HIPAA), pastikan untuk meninjau skema dan jenis pesan HIPAA.

  • 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 X12 ke alur kerja Anda.
    Standard Koneksi ke akun integrasi yang diperlukan, tetapi tidak diperlukan tautan. Anda dapat membuat koneksi saat menambahkan operasi X12 ke alur kerja Anda.

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

    Untuk informasi selengkapnya, lihat dokumentasi berikut:

Enkode pesan X12

Operasi enkode ke pesan X12 melakukan tugas-tugas berikut:

  • Menyelesaikan perjanjian dengan mencocokkan properti konteks pengirim dan penerima.
  • Menserialisasikan pertukaran EDI dan mengonversi pesan yang dikodekan XML menjadi set transaksi EDI dalam 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.
    • Validasi skema elemen data set transaksi terhadap skema pesan.
    • Validasi EDI pada elemen data set transaksi.
    • Validasi yang diperpanjang pada elemen data set transaksi.
  • Meminta Pengakuan Teknis dan Fungsional, jika dikonfigurasi.
    • Menghasilkan Pengakuan Teknis sebagai hasil validasi header. Pengakuan teknis melaporkan status pemrosesan header dan trailer pertukaran oleh penerima alamat.
    • Menghasilkan Pengakuan Fungsional sebagai hasil validasi isi. Pengakuan fungsional melaporkan setiap kesalahan yang ditemui saat memproses dokumen yang diterima.

  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 X12 bernama Encode ke pesan X12 berdasarkan nama perjanjian ke alur kerja Anda.

    Catatan

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

  3. Saat diminta, 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.

    Contohnya:

    Screenshot showing Consumption workflow and connection information for action named Encode to X12 message by agreement name.

  4. Jika sudah selesai, pilih Buat.

  5. Dalam kotak informasi tindakan X12, berikan nilai properti berikut ini:

    Properti Wajib Deskripsi
    Nama perjanjian X12 Ya Perjanjian X12 yang akan digunakan.
    Pesan XML untuk dikodekan Ya Pesan XML untuk dikodekan
    Parameter lainnya Tidak Operasi ini mencakup parameter lain berikut:

    - Pemisah Elemen Data
    - Pemisah Komponen
    - Karakter pengganti
    - Terminator segmen
    - Akhiran terminator segmen
    - Nomor Versi Kontrol
    - Pengidentifikasi Pengirim Aplikasi/Kode GS02
    - Pengidentifikasi Penerima Aplikasi/Kode GS03

    Untuk informasi selengkapnya, tinjau pengaturan pesan X12.

    Misalnya, Anda dapat menggunakan output konten Isi dari pemicu Permintaan sebagai payload pesan XML:

    Screenshot showing Consumption workflow, action named Encode to X12 message by agreement name, and action properties.

Pesan Decode X12

Operasi pesan Dekode X12 melakukan tugas-tugas berikut:

  • Memvalidasi amplop terhadap perjanjian mitra dagang.

  • Memvalidasi EDI dan properti khusus mitra.

    • Validasi struktural EDI dan validasi skema yang diperpanjang
    • Validasi struktural amplop pertukaran
    • Validasi skema amplop terhadap skema kontrol
    • Validasi skema elemen data kumpulan transaksi terhadap skema pesan
    • Validasi EDI pada elemen data set transaksi

  • Memverifikasi bahwa nomor kontrol pertukaran, grup, dan set transaksi bukan duplikat.

    • 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 itu.

  • Membagi pertukaran menjadi set transaksi, atau mempertahankan seluruh pertukaran:

    • Pisahkan pertukaran menjadi set transaksi atau tangguhkan set transaksi pada kesalahan: Uraikan setiap set transaksi. Tindakan dekode X12 hanya menghasilkan set transaksi yang gagal validasi ke badMessages, dan menghasilkan sisa transaksi yang diatur ke goodMessages.

    • Pisahkan pertukaran menjadi set transaksi atau tangguhkan pertukaran pada kesalahan: Uraikan setiap set transaksi. Jika satu atau beberapa set transaksi dalam validasi kegagalan pertukaran, tindakan dekode X12 menghasilkan semua set transaksi dalam pertukaran tersebut ke badMessages.

    • Pertahankan pertukaran atau tangguhkan set transaksi pada kesalahan: Pertahankan pertukaran dan proses seluruh pertukaran batch. Tindakan dekode X12 hanya menghasilkan set transaksi yang gagal validasi ke badMessages, dan menghasilkan sisa transaksi yang diatur ke goodMessages.

    • Pertahankan pertukaran atau tangguhkan pertukaran pada kesalahan: Pertahankan pertukaran dan proses seluruh pertukaran batch. Jika satu atau beberapa set transaksi dalam validasi kegagalan pertukaran, tindakan dekode X12 menghasilkan semua set transaksi dalam pertukaran tersebut ke badMessages.

  • Menghasilkan Pengakuan Teknis dan Fungsional, jika dikonfigurasi.

    • Menghasilkan Pengakuan Teknis sebagai hasil validasi header. Pengakuan teknis melaporkan status pemrosesan header dan trailer pertukaran oleh penerima alamat.
    • Menghasilkan Pengakuan Fungsional sebagai hasil validasi isi. Pengakuan fungsional melaporkan setiap kesalahan yang ditemui saat memproses dokumen yang diterima.

  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 X12 bernama dekode pesan X12 ke alur kerja Anda.

  3. Saat diminta, 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.

    Contohnya:

    Screenshot showing Consumption workflow and connection information for action named Decode X12 message.

  4. Jika sudah selesai, pilih Buat.

  5. Dalam kotak informasi tindakan X12, berikan nilai properti berikut ini:

    Properti Wajib Deskripsi
    Pesan file datar X12 untuk didekode Ya Pesan X12 dalam format file datar untuk didekodekan

    Catatan: Payload pesan XML atau konten untuk array pesan, baik atau buruk, dikodekan base64. Jadi, Anda harus menggunakan ekspresi yang memproses konten ini. Misalnya, ekspresi berikut memproses konten pesan sebagai XML:

    xml(base64ToBinary(item()?['Body']))
    Parameter lainnya Tidak Operasi ini mencakup parameter lain berikut:

    - Mempertahankan Pertukaran
    - Menangguhkan Pertukaran saat Kesalahan

    Untuk informasi selengkapnya, tinjau pengaturan pesan X12.

    Misalnya, Anda dapat menggunakan output konten Isi dari pemicu Permintaan sebagai payload pesan XML, tetapi Anda harus terlebih dahulu memproses konten ini menggunakan ekspresi:

    Screenshot showing Consumption workflow, action named Decode X12 message, and action properties.

Langkah berikutnya