Menambahkan peta untuk operasi transformasi dalam alur kerja dengan Azure Logic Apps

  • Artikel

Berlaku untuk: Azure Logic Apps (Konsumsi + Standar)

Tindakan alur kerja seperti Transform XML dan Liquid membutuhkan peta untuk melakukan tugasnya. Contohnya, tindakan Transform XML membutuhkan peta untuk mengonversi XML di antara format. Peta adalah dokumen XML yang menggunakan bahasa Extensible Stylesheet Language Transformation (XSLT) untuk menjelaskan cara mengonversi data dari XML menjadi format lain. Peta terdiri dari skema XML sumber sebagai input dan skema XML target sebagai output. Anda dapat menentukan transformasi dasar, seperti menyalin nama dan alamat dari satu dokumen ke dokumen lainnya. Atau, Anda dapat membuat transformasi yang lebih kompleks menggunakan operasi peta out-of-the-box. Anda dapat memanipulasi atau mengontrol data dengan menggunakan fungsi bawaan yang berbeda, seperti manipulasi string, penetapan bersyarat, ekspresi aritmatika, pemformat waktu tanggal, dan bahkan konstruksi perulangan.

Misalnya, Anda secara berkala menerima pesanan B2B atau faktur dari pelanggan yang menggunakan format tanggal YearMonthDay (YYYYMMDD). Namun, organisasi Anda menggunakan format tanggal MonthDayYear (MMDDYYYY). Anda dapat menentukan dan menggunakan peta yang mengubah format tanggal YYYMMDD ke format MMDDYYY sebelum menyimpan detail pesanan atau faktur dalam {i>database

Panduan ini memperlihatkan cara menambahkan peta untuk digunakan alur kerja Anda. Anda dapat menambahkan peta baik ke akun integrasi tertaut, atau jika Anda memiliki aplikasi logika Standar, Anda dapat menambahkan peta langsung ke sumber daya aplikasi logika Anda.

Prasyarat

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

  • Peta yang ingin ditambahkan. Untuk membuat peta, Anda bisa menggunakan salah satu alat berikut:

  • 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 bekerja dalam alur kerja aplikasi logika Konsumsi, Anda memerlukan akun integrasi yang tertaut ke sumber daya aplikasi logika Anda.

    • Apabila Anda bekerja pada alur kerja aplikasi logika Standar, Anda dapat menautkan akun integrasi ke sumber daya aplikasi logika, mengunggah peta secara langsung ke sumber daya aplikasi logika Anda, 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 demikian, Anda tidak perlu mengunggah peta ke setiap aplikasi logika individu. Untuk informasi selengkapnya, tinjau Menautkan sumber daya aplikasi logika Anda ke akun integrasi Anda.

      • Konektor bawaan Liquid membuat agar Anda dapat memilih peta yang sebelumnya Anda unggah ke sumber daya aplikasi logika atau ke akun integrasi tertaut, tetapi tidak keduanya.

      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.

  • Alur kerja Konsumsi dan Standar mendukung peta XSLT yang mereferensikan rakitan eksternal, yang memungkinkan panggilan langsung kode .NET kustom dari peta XSLT. Untuk mendukung kemampuan ini, alur kerja Konsumsi juga memiliki persyaratan berikut:

    • Anda membutuhkan {i>assembly

    • Anda harus mengunggah rakitan dan peta dalam urutan tertentu ke akun integrasi Anda. Pastikan Anda mengunggah assembly Anda terlebih dahulu, lalu mengunggah peta yang mereferensikan assembly.

    • Jika assembly Anda berukuran 2 MB atau lebih kecil, Anda bisa menambahkan assembly dan peta ke akun integrasi Anda langsung dari portal Microsoft Azure.

    • Jika skema Anda lebih dari 2 MB namun tidak melebihi batas ukuran untuk skema, Anda akan memerlukan akun penyimpanan Azure dan kontainer blob untuk dapat mengunggah skema Anda. Dengan demikian, Anda bisa menyediakan lokasi kontainer tersebut nanti saat menambahkan rakitan ke akun integrasi Anda. Untuk tugas ini, tabel berikut ini akan menjelaskan item yang Anda butuhkan:

      Item Deskripsi
      Akun penyimpanan Azure Dalam akun ini, buat kontainer blob Azure untuk assembly Anda. Pelajari cara membuat akun penyimpanan.
      Kontainer blob Dalam kontainer ini, Anda dapat mengunggah assembly Anda. Anda juga memerlukan lokasi konten kontainer URI ini saat menambahkan {i>assemblymembuat kontainer blob.
      Azure Storage Explorer Alat ini membantu Anda mengelola akun penyimpanan dan kontainer blob dengan lebih mudah. Untuk menggunakan Storage Explorer, unduh dan pasang Azure Storage Explorer. Kemudian, sambungkan Storage Explorer ke akun penyimpanan Anda dengan mengikuti langkah-langkah di Mulai menggunakan Storage Explorer. Untuk mempelajari selengkapnya, lihat Mulai cepat: Membuat blob di penyimpanan objek dengan Azure Storage Explorer.

      Atau, di portal Microsoft Azure, pilih akun penyimpanan Anda. Dari menu akun penyimpanan Anda, pilih Storage Explorer.

      Untuk menambahkan peta yang lebih besar, gunakan Azure Logic Apps REST API - Maps. Untuk alur kerja Standar, REST API Azure Logic Apps saat ini tidak tersedia.

Pembatasan

  • Batasan ini berlaku untuk jumlah artefak, seperti skema, per akun integrasi. Selengkapnya, tinjau Batasan dan konfigurasi untuk Azure Logic Apps.

  • Batasan berikut akan berlaku, tergantung apakah Anda bekerja dalam alur kerja aplikasi logika Konsumsi atau Standar:

    • Alur kerja yang standar

      • Mendukung XSLT 1.0, 2.0, dan 3.0.

      • Tidak terdapat batasan yang berlaku untuk memetakan ukuran file.

    • Alur kerja untuk konsumsi

      • Azure Logic Apps mengalokasikan memori terbatas untuk memproses perubahan XML. Jika Anda membuat alur kerja Konsumsi, dan transformasi peta atau payload Anda mengonsumsi terlalu banyak memori, hal ini mungkin akan mengalami kegagalan dan menyebabkan kehabisan memori. Untuk menghindari skenario ini, pertimbangkan opsi ini:

        • Edit peta atau payload Anda untuk mengurangi konsumsi memori.

        • Buat alur kerja aplikasi logika Standar, yang berjalan di Azure Logic Apps penyewa tunggal dan menawarkan opsi khusus dan fleksibel untuk sumber daya komputasi dan memori.

Membuat peta

Anda dapat membuat peta menggunakan Visual Studio Code dengan ekstensi Data Mapper atau Visual Studio dengan ekstensi Alat Integrasi Perusahaan Microsoft Azure Logic Apps.

Visual Studio Code

Saat membuat peta menggunakan Visual Studio Code dan ekstensi Data Mapper, Anda dapat memanggil peta ini dari alur kerja Anda, tetapi hanya dengan tindakan Operasi Pemeta Data bernama Transformasi menggunakan Data Mapper XSLT, bukan tindakan Operasi XML bernama TransformASI XML. Untuk informasi selengkapnya, lihat Membuat peta untuk transformasi data dengan Visual Studio Code.

Visual Studio

Saat membuat peta menggunakan Visual Studio, Anda harus membuat proyek integrasi dengan salah satu alat berikut:

Di dalam proyek ini, Anda dapat membuat file peta integrasi, yang memungkinkan Anda memetakan item secara visual di antara dua file skema XML. Alat-alat tersebut menawarkan kemampuan peta berikut ini:

  • Saat membuat peta, Anda akan melihat representasi grafis dari peta yang menunjukkan semua hubungan dan tautan yang Anda buat.

  • Anda bisa membuat salinan data langsung antara skema XML yang Anda gunakan untuk membuat peta. SDK Integrasi Enterprise for Visual Studio mencakup pemeta yang membuat tugas ini sesederhana menggambar garis yang menghubungkan elemen dalam skema XML sumber dengan rekan-rekan mereka dalam skema XML target.

  • Operasi atau fungsi untuk beberapa peta tersedia, termasuk fungsi {i>string

  • Untuk menambahkan sampel pesan XML, Anda dapat menggunakan kemampuan pengujian peta. Hanya dengan satu gerakan, Anda dapat menguji peta yang Anda buat, dan meninjau output yang dihasilkan.

  • Setelah membuat proyek ini, Anda akan mendapatkan dokumen XSLT.

Peta Anda harus memiliki atribut berikut dan CDATA bagian yang berisi panggilan ke kode rakitan:

  • name adalah nama rakitan kustom.

  • namespace adalah namespace layanan di rakitan Anda yang menyertakan kode kustom.

Contoh berikut menunjukkan peta yang mereferensikan rakitan bernama XslUtilitiesLib dan memanggil circumference metode dari rakitan.

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:user="urn:my-scripts">
<msxsl:script language="C#" implements-prefix="user">
    <msxsl:assembly name="XsltHelperLib"/>
    <msxsl:using namespace="XsltHelpers"/>
    <![CDATA[public double circumference(int radius){ XsltHelper helper = new XsltHelper(); return helper.circumference(radius); }]]>
</msxsl:script>
<xsl:template match="data">
<circles>
    <xsl:for-each select="circle">
        <circle>
            <xsl:copy-of select="node()"/>
                <circumference>
                    <xsl:value-of select="user:circumference(radius)"/>
                </circumference>
        </circle>
    </xsl:for-each>
</circles>
</xsl:template>
</xsl:stylesheet>

Menambahkan assembly yang direferensikan

Sumber daya aplikasi logika Konsumsi mendukung referensi rakitan eksternal dari peta, yang memungkinkan langsung memanggil kode .NET kustom dari peta XSLT.

  1. Dalam kotak pencarian portal Azure, masukkan akun integrasi, dan pilih Akun integrasi.

  2. Pilih akun integrasi tempat Anda ingin menambahkan {i>assembly

  3. Pada menu akun integrasi Anda, pilih Overview. Di bawah Setting, pilih Assemblies.

  4. Pada bar alat panel Assemblies, pilih Add.

Berdasarkan ukuran file assembly Anda, ikuti langkah-langkah untuk mengunggah assembly yang berukuran hingga 2 MB atau lebih dari 2 MB tetapi hanya hingga 8 MB. Untuk batasan jumlah assembly dalam akun integrasi, lihat Batasan dan konfigurasi untuk Azure Logic Apps.

Catatan

Jika mengubah assembly, Anda juga harus memperbarui peta apakah peta memiliki perubahan atau tidak.

Menambahkan assembly hingga 2 MB

  1. Di bagian Assembly, masukkan nama untuk assembly Anda. Biarkan File berukuran kecil tetap dipilih. Di samping kotak Assembly, pilih ikon folder. Temukan dan pilih assembly yang Anda unggah.

    Di properti Assembly Name, nama file assembly muncul secara otomatis setelah Anda memilih assembly.

  2. Setelah selesai, pilih OK.

    Setelah file assembly Anda selesai diunggah, assembly muncul di daftar Assembly. Pada menu akun integrasi panel Overview Anda, di bawah Artifacts, assembly Anda yang diunggah juga ditampilkan.

Menambahkan assembly lebih dari 2 MB

Untuk menambahkan assembly yang lebih besar, Anda dapat mengunggah assembly ke kontainer blob Azure di akun penyimpanan Azure Anda. Langkah Anda untuk menambahkan assembly berbeda berdasarkan apakah kontainer blol Anda memiliki akses baca publik. Jadi pertama-tama, periksa apakah kontainer blob Anda memiliki akses baca publik dengan mengikuti langkah-langkah berikut: Atur tingkat akses publik untuk kontainer blob

Periksa tingkat akses kontainer

  1. Buka Azure Storage Explorer. Di jendela Explorer, luaskan langganan Azure Anda jika belum diluaskan.

  2. Perluas Akun Penyimpanan> {your-storage-account} >Kontainer Blob. Pilih kontainer blob Anda.

  3. Dari menu pintasan kontainer blob Anda, pilih Atur Tingkat Akses Publik.

Mengunggah ke kontainer dengan akses publik

  1. Unggah assembly ke akun penyimpanan Anda. Di jendela sisi kanan, pilih Upload.

  2. Setelah selesai mengunggah, pilih assembly yang Anda unggah. Pada toolbar, pilih Copy URL sehingga Anda menyalin URL assembly.

  3. Kembali ke portal Microsoft Azure tempat panel Tambahkan Assembly terbuka. Masukkan nama untuk assembly Anda. Pilih File berukuran besar (lebih besar dari 2 MB).

    Kotak URI Konten sekarang muncul, bukan kotak Assembly.

  4. Dalam kotak URI Konten, tempelkan URL assembly Anda. Selesai menambahkan assembly Anda.

    Setelah assembly Anda selesai diunggah, assembly muncul di daftar Assembly. Pada menu akun integrasi panel Overview Anda, di bawah Artifacts, assembly Anda yang diunggah juga ditampilkan.

Mengunggah ke kontainer tanpa akses publik

  1. Unggah assembly ke akun penyimpanan Anda. Di jendela sisi kanan, pilih Upload.

  2. Setelah Anda selesai mengunggah, buat tanda tangan akses bersama (SAS) untuk assembly Anda. Dari menu pintasan assembly Anda, pilih Dapatkan Tanda Tangan Akses Bersama.

  3. Di panel Tanda Tangan Akses Bersama, pilih Hasilkan URI tanda tangan akses bersama tingkat kontainer>Buat. Setelah URL SAS dibuat, di samping kotak URL, pilih Copy.

  4. Kembali ke portal Microsoft Azure tempat panel Tambahkan Assembly terbuka. Masukkan nama untuk assembly Anda. Pilih File berukuran besar (lebih besar dari 2 MB).

    Kotak URI Konten sekarang muncul, bukan kotak Assembly.

  5. Dalam kotak URI Konten, tempelkan URI SAS yang sebelumnya Anda buat. Selesai menambahkan assembly Anda.

Setelah assembly Anda selesai diunggah, assembly muncul di daftar Assembly. Pada menu akun integrasi halaman Gambaran Umum Anda, di bawah Artefak, assembly Anda yang diunggah juga muncul.

Menambahkan peta

  • Jika Anda bekerja dengan alur kerja Konsumsi, Anda harus menambahkan skema Anda pada akun integrasi tertaut.

  • Jika Anda bekerja dengan alur kerja Standar, Anda memiliki opsi berikut:

    • Tambahkan peta Anda pada akun integrasi tertaut. Anda bisa berbagi skema dan akun integrasi di beberapa sumber daya aplikasi logika Standar dan alur kerja turunannya.

    • Tambahkan skema Anda langsung pada sumber daya aplikasi logika Anda. Namun, Anda hanya bisa berbagi skema tersebut di seluruh alur kerja turunan di sumber daya aplikasi logika yang sama.

Tambahkan peta pada akun integrasi

  1. Di portal Microsoft Azure masuk dengan kredensial akun Azure Anda.

  2. Di kotak pencarian portal Azure, masukkan akun integrasi, dan pilih Akun integrasi.

  3. Temukan dan pilih akun integrasi Anda.

  4. Pada menu navigasi akun integrasi, pada Pengaturan, pilih Peta.

  5. Di bar alat panel Maps, pilih Add.

Untuk alur kerja Konsumsi, berdasarkan ukuran file skema Anda, harap ikuti langkah yang ada untuk mengunggah skema yang berukuran hingga 2 MB atau lebih dari 2 MB.

Tambahkan peta hingga 2 MB

  1. Pada panel Tambahkan Peta, masukkan nama unik untuk peta Anda.

  2. Di bagian Jenis peta, pilih jenisnya, misalnya: Liquid, XSLT, XSLT 2.0, atau XSLT 3.0.

  3. Di samping kotak Map, pilih ikon folder. Pilih peta untuk diunggah.

    Jika Anda membiarkan properti Name tetap kosong, nama file peta secara otomatis muncul di properti itu setelah Anda memilih file peta.

  4. Setelah selesai, pilih OK.

    Setelah file peta Anda selesai diunggah, peta akan muncul di daftar Peta. Pada menu akun integrasi halaman Overview Anda, di bawah Artifacts, assembly Anda yang diunggah juga muncul.

Menambahkan peta lebih dari 2 MB

Untuk menambahkan peta yang lebih besar bagi alur kerja Konsumsi, gunakan Azure Logic Apps REST API - Maps.

Menambahkan peta pada sumber daya aplikasi logika Standar

Langkah berikutnya hanya berlaku jika Anda ingin menambahkan skema langsung ke sumber daya aplikasi logika Standar Anda. Jika tidak, tambahkan skema pada akun integrasi Anda.

Portal Azure

  1. Pada menu sumber daya aplikasi logika Anda, di bawah Artefak, pilih Peta.

  2. Di bar alat panel Maps, pilih Add.

  3. Pada panel Tambahkan Peta , masukkan nama unik untuk peta Anda dan sertakan nama ekstensi .xslt .

  4. Di samping kotak Map, pilih ikon folder. Pilih peta untuk diunggah.

  5. Setelah selesai, pilih OK.

    Setelah file peta Anda selesai diunggah, peta akan muncul di daftar Peta. Pada menu akun integrasi halaman Overview Anda, di bawah Artifacts, assembly Anda yang diunggah juga muncul.

Visual Studio Code

  1. Pada struktur aplikasi logika proyek, buka folder Artefak dan kemudian folder Peta.

  2. Di folder Peta, tambahkan peta Anda.

Mengedit peta

Untuk memperbarui peta yang sudah ada, Anda harus mengunggah file peta baru yang memiliki perubahan yang Anda inginkan. Namun, Anda dapat terlebih dahulu mengunduh peta yang ada untuk pengeditan.

  1. Di portal Microsoft Azure, buka akun integrasi Anda, jika belum dibuka.

  2. Pada menu akun integrasi Anda, di bawah Settings, pilih Maps.

  3. Setelah halaman Maps terbuka, pilih peta Anda. Untuk mengunduh dan mengedit peta terlebih dahulu, pada panel toolbar Maps, pilih Download, dan simpan peta.

  4. Saat Anda siap mengunggah peta yang diperbarui, pada panel Maps, pilih peta yang ingin Anda perbarui. Di bar alat panel Maps, pilih Update.

  5. Temukan dan pilih peta yang diperbarui yang ingin Anda unggah.

    Setelah file peta Anda selesai diunggah, peta akan muncul di daftar Peta.

Hapus peta

  1. Di portal Microsoft Azure, buka akun integrasi Anda, jika belum dibuka.

  2. Pada menu akun integrasi Anda, di bawah Settings, pilih Maps.

  3. Setelah panel Peta terbuka, pilih peta Anda, dan pilih Hapus.

  4. Untuk mengonfirmasi bahwa Anda ingin menghapus peta, pilih Yes.

Langkah berikutnya