Bagikan melalui


Saling bertukar pesan EDI dalam bentuk batch atau grup dengan mitra dagang di Azure Logic Apps

Berlaku pada: Azure Logic Apps (Konsumsi)

Dalam skenario business ke business (B2B), mitra sering bertukar pesan dalam kelompok atau batch. Saat Anda membangun solusi batching dengan Azure Logic Apps, Anda dapat mengirim pesan ke mitra dagang dan memproses pesan tersebut bersama-sama dalam batch. Artikel ini memperlihatkan bagaimana Anda dapat memproses pesan EDI secara batch, menggunakan X12 sebagai contoh, dengan membuat aplikasi logika "pengirim batch" dan "penerima batch".

Batching pesan X12 berfungsi seperti membuat batch pesan lain. Anda menggunakan pemicu batch yang mengumpulkan pesan ke dalam batch dan tindakan batch yang mengirim pesan ke batch. Selain itu, batching X12 mencakup langkah pengodean X12 sebelum pesan masuk ke mitra dagang atau tujuan lainnya. Untuk mempelajari selengkapnya tentang pemicu dan tindakan batch, lihat Pesan proses batch.

Dalam artikel ini, Anda akan membuat solusi batching dengan membuat dua aplikasi logika dalam langganan Azure yang sama, wilayah Azure, dan mengikuti urutan ini:

  • Aplikasi logika "penerima batch", yang menerima dan mengumpulkan pesan ke dalam batch hingga kriteria yang Anda tentukan terpenuhi untuk merilis dan memproses pesan tersebut. Dalam skenario ini, penerima batch juga mengodekan pesan dalam batch dengan menggunakan perjanjian X12 yang ditentukan atau identitas mitra.

    Pastikan Anda terlebih dahulu membuat penerima batch sehingga nantinya Anda dapat memilih tujuan batch saat membuat pengirim batch.

  • Alur kerja aplikasi logika "pengirim batch", yang mengirim pesan ke penerima batch yang dibuat sebelumnya.

Pastikan alur kerja aplikasi logika penerima batch dan pengirim batch Anda menggunakan langganan Azure dan wilayah Azure yang sama. Jika tidak, Anda tidak dapat memilih penerima batch saat membuat pengirim batch karena tidak terlihat satu sama lain.

Prasyarat

  • Instal atau gunakan alat yang dapat mengirim permintaan HTTP untuk menguji solusi Anda, misalnya:

    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, berfungsi offline atau lokal, tidak menyinkronkan data Anda ke cloud, dan tidak mengharuskan Anda masuk ke akun online. Dengan cara ini, Anda mengurangi risiko sekeliling mengekspos data sensitif ke publik.

Buat penerima batch X12

Sebelum Anda dapat mengirim pesan ke batch, batch tersebut harus terlebih dahulu ada sebagai tujuan tempat Anda mengirim pesan tersebut. Jadi pertama-tama, Anda harus membuat aplikasi logika "penerima batch", yang dimulai dengan pemicu Batch. Dengan demikian, ketika Anda membuat aplikasi logika "pengirim batch", Anda dapat memilih aplikasi logika penerima batch. Penerima batch terus mengumpulkan pesan hingga kriteria yang Anda tentukan terpenuhi untuk merilis dan memproses pesan tersebut. Meskipun penerima batch tidak perlu tahu info apa pun tentang pengirim batch, pengirim batch harus mengetahui tujuan tempat mereka mengirim pesan.

Untuk penerima batch ini, Anda menentukan mode batch, nama, kriteria rilis, perjanjian X12, dan pengaturan lainnya.

  1. Di portal Azure, Visual Studio, atau Visual Studio Code, buat aplikasi logika dengan nama berikut: BatchX12Messages

  2. Tautkan aplikasi logika Anda ke akun integrasi Anda.

  3. Di perancang alur kerja, tambahkan pemicu Batch , yang memulai alur kerja aplikasi logika Anda.

  4. Ikuti langkah-langkah umum ini untuk menambahkan pemicu Batch bernama pesan Batch.

  5. Atur properti penerima batch:

    Properti Nilai Catatan
    Mode Batch Inline
    Nama Batch TestBatch Hanya tersedia dengan mode batch Sebaris
    Kriteria Rilis Berbasis jumlah pesan, Berbasis jadwal Hanya tersedia dengan mode batch Sebaris
    Jumlah Pesan 10 Hanya tersedia dengan kriteria rilis Berbasis jumlah pesan
    Interval 10 Hanya tersedia dengan kriteria rilis Berbasis jadwal
    Frekuensi menit Hanya tersedia dengan kriteria rilis Berbasis jadwal

    Berikan detail pemicu batch

    Catatan

    Contoh ini tidak mengatur partisi untuk batch, sehingga setiap batch menggunakan kunci partisi yang sama. Untuk mempelajari selengkapnya tentang partisi, lihat Pesan proses batch.

  6. Sekarang tambahkan tindakan yang mengodekan setiap batch:

    1. Ikuti langkah-langkah umum ini untuk menambahkan tindakan X12 bernama: Batch mengodekan <versi apa pun>

    2. Jika sebelumnya Anda tidak tersambung ke akun integrasi, buat koneksi sekarang. Berikan nama untuk koneksi Anda, pilih akun integrasi yang Anda inginkan, lalu pilih Buat.

      Membuat koneksi antara encoder batch dan akun integrasi

    3. Atur properti ini untuk tindakan encoder batch Anda:

      Properti Deskripsi
      Nama perjanjian X12 Buka daftar, dan pilih perjanjian Anda yang sudah ada.

      Jika daftar Anda kosong, pastikan Anda menautkan aplikasi logika ke akun integrasi yang memiliki perjanjian yang Anda inginkan.

      NamaBatch Klik di dalam kotak ini, dan setelah daftar konten dinamis muncul, pilih token Nama Batch.
      NamaPartisi Klik di dalam kotak ini, dan setelah daftar konten dinamis muncul, pilih token Nama Partisi.
      Item Tutup kotak detail item, lalu klik di dalam kotak ini. Setelah daftar konten dinamis muncul, pilih token Item Batched.

      Detail tindakan Enkode Batch

      Untuk kotak Item:

      Item tindakan Enkode Batch

  7. Menyimpan alur kerja aplikasi logika Anda.

  8. Jika Anda menggunakan Visual Studio, pastikan Anda menyebarkan aplikasi logika penerima batch ke Azure. Jika tidak, Anda tidak dapat memilih penerima batch saat membuat pengirim batch.

Menguji alur kerja

Untuk memastikan penerima batch berfungsi seperti yang diharapkan, Anda dapat menambahkan tindakan HTTP untuk tujuan pengujian, dan mengirim pesan batch ke layanan Request Bin.

  1. Ikuti langkah-langkah umum ini untuk menambahkan tindakan HTTP bernama HTTP.

  2. Atur properti untuk tindakan HTTP:

    Properti Deskripsi
    Metode Dari daftar ini, pilih POST.
    Uri Buat URI untuk bin permintaan Anda, lalu masukkan URI tersebut dalam kotak ini.
    Isi Klik di dalam kotak ini, dan setelah daftar konten dinamis terbuka, pilih token Isi, yang muncul di bagian, Pengkodean batch berdasarkan nama perjanjian.

    Jika Anda tidak melihat token Isi, di samping Pengkodean batch berdasarkan nama perjanjian, pilih Lihat selengkapnya.

    Memberikan detail tindakan HTTP

  3. Simpan alur kerja Anda.

    Aplikasi logika penerima batch Anda terlihat seperti contoh berikut:

    Simpan aplikasi logika penerima batch Anda

Membuat pengirim batch X12

Sekarang buat satu atau lebih aplikasi logika yang mengirim pesan ke aplikasi logika penerima batch. Di setiap pengirim batch, Anda menentukan aplikasi logika penerima batch dan nama batch, konten pesan, dan pengaturan lainnya. Anda dapat secara opsional menyediakan kunci partisi unik untuk membagi batch menjadi subset untuk mengumpulkan pesan dengan kunci tersebut.

  • Pastikan Anda sudah membuat penerima batch Anda. Dengan begitu, saat membuat pengirim batch, Anda dapat memilih penerima batch yang ada sebagai batch tujuan. Meskipun penerima batch tidak perlu mengetahui info apa pun tentang pengirim batch, pengirim batch mengetahui alamat pesan dikirim.

  • Pastikan alur kerja aplikasi logika penerima batch dan pengirim batch Anda menggunakan langganan Azure dan wilayah Azure yang sama. Jika tidak, Anda tidak dapat memilih penerima batch saat membuat pengirim batch karena tidak terlihat satu sama lain.

  1. Buat aplikasi logika lain dengan nama berikut: SendX12MessagesToBatch

  2. Ikuti langkah-langkah umum ini untuk menambahkan pemicu Permintaan bernama Saat permintaan HTTP diterima.

  3. Untuk menambahkan tindakan mengirim pesan ke batch, ikuti langkah-langkah umum ini untuk menambahkan tindakan Kirim pesan ke batch bernama Pilih alur kerja Logic Apps dengan pemicu batch.

    1. Pilih aplikasi logika BatchX12Messages yang sebelumnya Anda buat.

    2. Pilih tindakan BatchX12Messages bernama Batch_messages - <your-batch-receiver>.

  4. Atur properti pengirim batch.

    Properti Deskripsi
    Nama Batch Nama batch yang ditentukan oleh aplikasi logika penerima, yaitu "TestBatch" dalam contoh ini

    Penting: Nama batch akan divalidasi pada runtime dan harus sesuai dengan nama yang ditentukan oleh aplikasi logika penerima. Mengubah nama batch menyebabkan pengirim batch gagal.

    Konten Pesan Konten untuk pesan yang ingin Anda kirim, yang merupakan token Isi dalam contoh ini

    Atur properti batch

  5. Simpan alur kerja Anda.

    Aplikasi logika pengirim batch Anda terlihat seperti contoh ini:

    Simpan aplikasi logika pengirim batch Anda

Menguji alur kerja Anda

Untuk menguji solusi batching Anda, posting pesan X12 ke alur kerja aplikasi logika pengirim batch Anda menggunakan alat permintaan HTTP Anda dan instruksinya. Segera, Anda mulai mendapatkan pesan X12 di bin permintaan, baik setiap 10 menit atau dalam batch 10, semuanya dengan kunci partisi yang sama.

Langkah berikutnya