Share via

Pesan Exchange B2B antar mitra menggunakan alur kerja di Azure Logic Apps

  • Artikel

Berlaku untuk: Azure Logic Apps (Konsumsi + Standar)

Ketika Anda memiliki akun integrasi yang menetapkan mitra dagang dan perjanjian, Anda dapat membuat alur kerja bisnis ke bisnis otomatis (B2B) yang bertukar pesan antara mitra dagang dengan menggunakan Azure Logic Apps dengan Paket Integrasi Perusahaan. Alur kerja Anda dapat menggunakan konektor yang mendukung protokol standar industri, seperti AS2, X12, EDIFACT, dan RosettaNet. Anda juga dapat menyertakan operasi yang disediakan oleh konektor lain dalam Azure Logic Apps, seperti Office 365 Outlook, SQL Server, dan Salesforce.

Artikel ini memperlihatkan cara membuat aplikasi logika yang menerima permintaan HTTP dengan menggunakan pemicu Permintaan, mendekode konten pesan dengan menggunakan tindakan Dekodekan AS2 dan Dekodekan X12, lalu kembalikan respons dengan menggunakan tindakan Respons. Contoh ini menggunakan Azure Logic App Designer di portal Microsoft Azure, tetapi Anda dapat mengikuti langkah serupa untuk Logic App Designer di Visual Studio.

Jika Anda baru mengenal aplikasi logika, ulas Apa itu Azure Logic Apps? Untuk informasi selengkapnya tentang integrasi enterprise B2B, tinjau alur kerja integrasi enterprise B2B dengan zure Logic Apps.

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:

    • Dikaitkan dengan langganan Azure yang sama dengan sumber daya aplikasi logika Anda.

    • Ada di lokasi atau wilayah Azure yang sama dengan sumber daya aplikasi logika Anda.

    • Jika Anda menggunakan jenis sumber daya Aplikasi Logika (Konsumsi), Anda harus menautkan akun integrasi ke sumber daya aplikasi logika sebelum Anda dapat menggunakan artefak dalam alur kerja Anda.

    • Jika Anda menggunakan jenis sumber daya Aplikasi Logika (Standar),akun integrasi Anda tidak memerlukan tautan ke sumber daya aplikasi logika Anda tetapi masih diperlukan untuk menyimpan artefak lain, seperti mitra, perjanjian, dan sertifikat, bersama dengan menggunakan operasi AS2, X12, atau EDIFACT. Akun integrasi Anda masih harus memenuhi persyaratan lain, seperti menggunakan langganan Azure yang sama dan ada di lokasi yang sama dengan sumber daya aplikasi logika Anda.

    Catatan

    Saat ini, hanya jenis sumber daya Aplikasi Logika (Konsumsi) yang mendukung operasi RosettaNet. Jenis sumber daya Aplikasi Logika (Standar) tidak menyertakan operasi RosettaNet.

  • Setidaknya ada dua mitra dagang yang ada di akun integrasi Anda. Definisi untuk kedua mitra tersebut harus menggunakan kualifikasi identitas bisnis yang sama, yaitu AS2, X12, EDIFACT, atau RosettaNet.

  • Perjanjian AS2 dan perjanjian X12 untuk mitra yang Anda gunakan dalam alur kerja ini. Perjanjian memerlukan mitra host dan mitra tamu.

  • Sumber daya aplikasi logika dengan alur kerja kosong tempat Anda dapat menambahkan pemicu Permintaan lalu tindakan berikut:

Menambahkan pemicu Permintaan

Untuk memulai alur kerja dalam contoh ini, tambahkan pemicu Permintaan.

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

  2. Di bawah kotak pencarian perancang, pilih Semua, jika tidak dipilih. Di kotak pencarian, masukkan when a http request. Pilih Permintaan Saat permintaan HTTP diterima sebagai pemicunya.

    Cuplikan layar memperlihatkan portal Microsoft Azure dan perancang multipenyewa dengan

  3. Di pemicu, biarkan kotak Request body JSON Schema kosong.

    Alasannya adalah bahwa pemicu akan menerima pesan X12 dalam format file datar.

    Cuplikan layar yang memperlihatkan perancang multipenyewa dan Properti pemicu Permintaan.

  4. Setelah selesai, pilih Simpan di toolbar alat perancang.

    Langkah ini menghasilkan URL HTTP POST yang kemudian Anda gunakan untuk mengirim permintaan yang memicu alur kerja aplikasi logika.

    Cuplikan layar yang memperlihatkan perancang multipenyewa dan URL yang dihasilkan untuk pemicu Permintaan.

  5. Salin dan simpan untuk digunakan nanti.

Tambahkan tindakan dekodekan AS2

Sekarang tambahkan tindakan B2B untuk contoh ini, yang menggunakan tindakan AS2 dan X12.

  1. Di bawah pemicu, pilih Langkah baru.

    Tip

    Untuk menyembunyikan detail pemicu, klik bilah judul pemicu.

    Cuplikan layar memperlihatkan perancang multipenyewa dan pemicu dengan

  2. Di bawah kotak Pilih kotak pencarian operasi, pilih Semua, jika tidak dipilih. Di kotak pencarian, masukkan as2, lalu pilih Dekode AS2.

    Cuplikan layar yang memperlihatkan perancang multipenyewa dengan tindakan

  3. Agar properti Pesan mendekode, masukkan input yang Anda inginkan untuk mendekode tindakan Applicability Statement 2, yang merupakan body konten yang diterima oleh pemicu permintaan HTTP. Anda memiliki beberapa cara untuk menentukan konten ini sebagai input, baik dari daftar konten dinamis atau sebagai ekspresi:

    • Untuk memilih dari daftar yang memperlihatkan output pemicu yang tersedia, klik di dalam kotak Pesan untuk mendekode. Setelah daftar konten dinamis muncul, di bawah Saat permintaan HTTP diterima, pilih nilai properti isi, misalnya:

      Cuplikan layar memperlihatkan perancang multipenyewa dengan daftar konten dinamis dan properti

      Tip

      Jika tidak ada output pemicu yang muncul, dalam daftar properti dinamis, di bawah Saat permintaan HTTP diterima, pilih Lihat selengkapnya.

    • Untuk memasukkan ekspresi yang mereferensikan output pemicu body, klik di dalam kotak Pesan untuk mendekode. Setelah daftar konten dinamis muncul, pilih Ekspresi. Di editor ekspresi, masukkan ekspresi di sini, dan pilih OK:

      triggerOutputs()['body']

      Atau, dalam kotak Pesan untuk mendekode, langsung masukkan ekspresi ini:

      @triggerBody()

      Ekspresi muncul ke token Isi.

      Cuplikan layar yang memperlihatkan perancang multipenyewa dengan output properti

  4. Di properti header Pesan tindakan, masukkan header apa pun yang diperlukan untuk tindakan AS2, yang berada dalam output dari headers pemicu Permintaan.

    1. Untuk memasukkan ekspresi yang mereferensikan output pemicu headers, pilih Alihkan judul Pesan ke mode teks.

      Cuplikan layar memperlihatkan perancang multipenyewa dengan

    2. Klik di dalam kotak Judul Pesan. Setelah daftar konten dinamis muncul, pilih Ekspresi. Di editor ekspresi, masukkan ekspresi di sini, dan pilih OK:

      triggerOutputs()['Headers']

      Dalam tindakan Dekode AS2, ekspresi sekarang muncul sebagai token:

      Cuplikan layar yang menampilkan perancang multipenyewa dan kontak

    3. Untuk mendapatkan token ekspresi untuk diatasi ke token Header, beralih antara desainer dan tampilan kode. Setelah langkah ini, tindakan Dekode AS2 terlihat seperti contoh ini:

      Cuplikan layar yang memperlihatkan perancang multipenyewa dan output header yang diselesaikan dari pemicu.

Menambahkan tindakan Respons sebagai tanda terima pesan

Untuk memberi tahu mitra dagang bahwa pesan diterima, Anda dapat mengembalikan respons yang berisi Message Disposition Notification/Pemberitahuan Disposisi Pesan (MDN) Applicability Statement 2 dengan menggunakan tindakan Respons. Dengan menambahkan tindakan ini segera setelah tindakan AS2, alur kerja aplikasi logika dapat melanjutkan pemrosesan jika tindakan AS2 berhasil. Atau, jika tindakan AS2 gagal, alur kerja aplikasi logika berhenti diproses.

  1. Di bawah tindakan Dekode Applicability Statement 2 pilih Langkah baru.

  2. Di bawah kotak pencarian Pilih operasi, pilih Bawaan, jika belum dipilih. Di kotak pencarian, masukkan condition. Pilih tindakan Kondisi.

    Cuplikan layar menampilkan perancang multipenyewa dan tindakan

    Sekarang bentuk kondisi muncul, termasuk jalur untuk apakah kondisi terpenuhi atau tidak.

    Cuplikan layar menampilkan perancang multipenyewa dan tindakan

  3. Sekarang tentukan kondisi yang akan dievaluasi. Dalam kotak Pilih nilai, masukkan ekspresi ini:

    @body('AS2_Decode')?['AS2Message']?['MdnExpected']

    Di kotak tengah, pastikan operasi perbandingan diatur ke is equal to. Di kotak sisi kanan, masukkan nilai Expected.

  4. Menyimpan alur kerja aplikasi logika Anda. Untuk mendapatkan ekspresi untuk munculkan sebagai token ini, beralihlah antara tampilan desainer dan kode.

    Cuplikan layar menampilkan perancang multipenyewa dan bentuk

  5. Sekarang tentukan respons untuk mengembalikan apakah tindakan Dekode Applicability Statement 2 berhasil atau tidak.

    1. Untuk kasus saat tindakan Dekode Applicability Statement 2 berhasil, di bentuk Jika benar, pilih Tambahkan tindakan. Di bawah Pilih tindakan, di kotak pencarian, masukkan response, dan pilih Respons.

      Cuplikan layar menampilkan perancang multipenyewa dan tindakan

    2. Untuk mengakses MDN Applicability Statement 2 dari output tindakan Dekode Applicability Statement 2 tentukan ekspresi ini:

      • Di properti tindakan ResponsHeader masukkan ekspresi ini:

        @body('AS2_Decode')?['OutgoingMdn']?['OutboundHeaders']

      • Di properti tindakan ResponsIsi, masukkan ekspresi ini:

        @body('AS2_Decode')?['OutgoingMdn']?['Content']

    3. Untuk mendapatkan ekspresi untuk muncul sebagai token, beralihlah antara tampilan perancang dan kode:

      Cuplikan layar memperlihatkan perancang multipenyewa dan ekspresi yang terselesaikan untuk mengakses MDN AS2.

    4. Untuk kasus ketika tindakan Dekode Applicability Statement 2 gagal, di bentuk Jika salah, pilih Tambahkan tindakan. Di bawah Pilih tindakan, di kotak pencarian, masukkan response, dan pilih Respons. Siapkan tindakan Respons untuk mengembalikan status dan kesalahan yang Anda inginkan.

  6. Menyimpan alur kerja aplikasi logika Anda.

Sekarang tambahkan tindakan pesan dekodekan X12.

Sekarang tambahkan tindakan pesan Decode X12.

  1. Di bawah tindakan Respons, pilih Tambahkan tindakan.

  2. Di bawah Pilih tindakan, di kotak pencarian, masukkan x12 decode, lalu pilih Dekodekan pesan X12.

    Cuplikan layar yang menunjukkan tindakan multipenyewa dan tindakan

  3. Jika tindakan X12 meminta informasi koneksi kepada Anda, berikan nama untuk koneksi, pilih akun integrasi yang ingin Anda gunakan, lalu pilih Buat.

    Cuplikan layar memperlihatkan tindakan multipenyewa dan koneksi ke akun integrasi.

  4. Sekarang tentukan input untuk tindakan X12. Contoh ini menggunakan output dari tindakan Applicability Statement 2, yang merupakan konten pesan tetapi perhatikan bahwa konten ini dalam format objek JSON dan dikodekan dengan basis64. Jadi, Anda harus mengonversi konten ini menjadi untai (karakter).

    Dalam kotak Pesan file X12 Flat untuk mendekode masukkan ekspresi ini untuk mengonversi output Applicability Statement 2:

    @base64ToString(body('AS2_Decode')?['AS2Message']?['Content'])

  5. Menyimpan alur kerja aplikasi logika Anda. Untuk mendapatkan ekspresi untuk munculkan sebagai token ini, beralihlah antara tampilan desainer dan kode.

    Cuplikan layar yang memperlihatkan tindakan multipenyewa dan konversi dari konten yang dikodekan base64 ke string.

  6. Menyimpan alur kerja aplikasi logika Anda.

    Jika Anda memerlukan langkah tambahan untuk aplikasi logika ini, misalnya, untuk mendekode konten pesan dan output konten tersebut dalam format objek JSON, lanjutkan membangun aplikasi logika Anda.

Anda sekarang sudah selesai menyiapkan aplikasi logika B2B Anda. Dalam aplikasi dunia nyata, Anda mungkin ingin menyimpan data X12 yang diterjemahkan dalam aplikasi lini bisnis (LOB) atau penyimpanan data. Pastikan untuk meninjau dokumentasi berikut:

Untuk menghubungkan aplikasi LOB Anda sendiri dan menggunakan API ini di aplikasi logika, Anda dapat menambahkan lebih banyak tindakan atau menulis API khusus.

Langkah berikutnya