Bagikan melalui


Membuat peta untuk mengubah data di Azure Logic Apps dengan Visual Studio Code

Berlaku pada: Azure Logic Apps (Standar)

Untuk bertukar pesan yang memiliki format XML atau JSON yang berbeda dalam alur kerja Azure Logic Apps, Anda harus mengubah data dari satu format ke format lainnya, terutama jika Anda memiliki kesenjangan antara struktur skema sumber dan target. Transformasi data membantu Anda menjenjang kesenjangan tersebut. Untuk tugas ini, Anda perlu membuat peta yang menentukan transformasi antara elemen data dalam skema sumber dan target.

Untuk membuat dan mengedit peta secara visual, Anda dapat menggunakan Visual Studio Code dengan ekstensi Azure Logic Apps (Standar) dalam konteks proyek aplikasi logika Standar. Alat Pemetaan Data memberikan pengalaman terpadu untuk pemetaan dan transformasi XSLT menggunakan gerakan seret dan letakkan, pustaka fungsi bawaan untuk membuat ekspresi, dan cara untuk menguji peta yang Anda buat dan gunakan secara manual di alur kerja Anda.

Setelah membuat peta, Anda dapat langsung memanggil peta tersebut dari alur kerja di proyek aplikasi logika atau dari alur kerja di portal Azure. Untuk tugas ini, Anda dapat menggunakan tindakan Operasi Pemeta Data bernama Transformasi menggunakan Data Mapper XSLT di alur kerja Anda.

Panduan cara ini menunjukkan cara membuat peta data kosong, memilih skema sumber dan target Anda, memilih elemen skema untuk mulai memetakan, membuat berbagai pemetaan, menyimpan dan menguji peta Anda, lalu memanggil peta dari alur kerja di proyek aplikasi logika Anda.

Batasan dan masalah yang diketahui

  • Data Mapper saat ini hanya berfungsi di Visual Studio Code yang berjalan pada sistem operasi Windows.

  • Pemeta Data saat ini hanya tersedia di Visual Studio Code, bukan portal Azure, dan hanya dari dalam proyek aplikasi logika Standar, bukan proyek aplikasi logika Konsumsi.

  • Pemeta Data saat ini tidak mendukung file nilai yang dipisahkan koma (.csv).

  • Panel Tampilan Kode Pemeta Data saat ini hanya dibaca.

  • Tata letak peta dan posisi item saat ini otomatis dan baca saja.

  • Untuk memanggil peta yang dibuat dengan alat Pemeta Data, Anda hanya dapat menggunakan tindakan Operasi Pemeta Data bernama Transformasi menggunakan Data Mapper XSLT. Untuk peta yang dibuat oleh alat lain, gunakan tindakan Operasi XML bernama Transform XML.

  • Untuk menggunakan peta yang Anda buat dengan alat Pemeta Data tetapi di portal Azure, Anda harus menambahkannya langsung ke sumber daya aplikasi logika Standar Anda.

Prasyarat

  • Visual Studio Code dan ekstensi Azure Logic Apps (Standar) untuk membuat alur kerja aplikasi logika Standar.

    Catatan

    Ekstensi Pemeta Data yang sebelumnya terpisah sekarang digabungkan dengan ekstensi Azure Logic Apps (Standar). Untuk menghindari konflik, versi ekstensi Data Mapper yang ada akan dihapus saat Anda menginstal atau memperbarui ekstensi Azure Logic Apps (Standar). Setelah ekstensi diinstal atau diperbarui, mulai ulang Visual Studio Code.

  • File skema sumber dan target yang menjelaskan jenis data yang akan diubah. File-file ini dapat memiliki format berikut:

    • File definisi skema XML dengan ekstensi file .xsd
    • File Notasi Objek JavaScript dengan ekstensi file .json
  • Proyek aplikasi logika Standar yang menyertakan alur kerja stateful atau stateless dengan setidaknya pemicu. Jika Anda tidak memiliki proyek, ikuti langkah-langkah berikut di Visual Studio Code:

    1. Koneksi ke akun Azure Anda, jika Anda belum melakukannya.

    2. Buat folder lokal, proyek aplikasi logika Standar lokal, dan alur kerja stateful atau stateless. Selama pembuatan alur kerja, pilih Buka di jendela saat ini.

  • Contoh data input jika Anda ingin menguji peta dan memeriksa apakah transformasi berfungsi seperti yang Anda harapkan.

  • Untuk menggunakan fungsi Jalankan XSLT , cuplikan XSLT Anda harus ada dalam file yang menggunakan ekstensi nama file .xml atau .xslt . Anda harus meletakkan cuplikan XSLT Anda di folder InlineXslt di struktur folder proyek lokal Anda: Artifacts>DataMapper>Extensions>InlineXslt. Jika struktur folder ini tidak ada, buat folder yang hilang.

Membuat peta data

  1. Pada menu kiri Visual Studio Code, pilih ikon Azure .

  2. Di panel Azure , di bawah bagian Pemeta Data, pilih Buat peta data baru.

    Screenshot showing Visual Studio Code with Data Mapper tool, Azure window open, and selected button for Create new data map.

  3. Berikan nama untuk peta data Anda.

  4. Tentukan skema sumber dan target Anda dengan mengikuti langkah-langkah berikut:

    1. Pada permukaan peta, pilih Tambahkan skema sumber.

      Screenshot showing Visual Studio Code with Data Mapper open, new data map, and selected option for Add a source schema.

    2. Pada panel Konfigurasikan yang terbuka, pilih Tambahkan Telusuri baru>.

    3. Temukan dan pilih file skema sumber Anda, lalu pilih Tambahkan.

      Jika skema sumber Anda tidak muncul di jendela Buka , dari daftar jenis file, ubah File XSD (*.xsd) ke Semua File (*.*).

      Permukaan peta sekarang menunjukkan jenis data dari skema sumber. Untuk contoh dalam panduan ini,

    4. Pada permukaan peta, pilih Tambahkan skema target.

    5. Pada panel Konfigurasikan yang terbuka, pilih Tambahkan Telusuri baru>.

    6. Temukan dan pilih file skema target Anda, lalu pilih Tambahkan.

      Jika skema target Anda tidak muncul di jendela Buka , dari daftar jenis file, ubah File XSD (*.xsd) ke Semua File (*.*).

      Permukaan peta sekarang menunjukkan jenis data dari skema target.

    Atau, Anda juga dapat menambahkan file skema sumber dan target secara lokal ke proyek aplikasi logika Anda di folder Skema Artefak/, sehingga file tersebut muncul di Visual Studio Code. Dalam hal ini, Anda dapat menentukan skema sumber dan target Anda di alat Pemeta Data pada panel Konfigurasikan dengan memilih Pilih yang sudah ada, bukan Tambahkan baru.

    Setelah selesai, peta Anda terlihat mirip dengan contoh berikut:

    Screenshot showing the Data Mapper open and data map with sample source and target schemas.

Tabel berikut ini menjelaskan kemungkinan jenis data yang mungkin muncul dalam skema:

Simbol Jenis Info selengkapnya
Icon representing an Array data type. Array Berisi item atau node item berulang
Icon representing a Binary data type. Biner
Icon representing a Bool data type. Bool Benar atau salah saja
Icon representing a Complex data type. Kompleks Objek XML dengan properti turunan, mirip dengan jenis JSON Objek
Icon representing a DateTime data type. WaktuTanggal
Icon representing a Decimal data type. Desimal
Icon representing an Integer data type. Bilangan bulat Siapa angka saja
Icon representing the NULL symbol. Null Bukan tipe data, tetapi muncul saat ada kesalahan atau tipe yang tidak valid
Icon representing a Number data type. Angka Bilangan bulat atau desimal JSON
Icon representing an Object data type. Objek Objek JSON dengan properti turunan, mirip dengan jenis XML Kompleks
Icon representing a String data type. String

Untuk berpindah-pindah peta, Anda memiliki opsi berikut:

  • Untuk menggeser, seret pointer Anda di sekitar permukaan peta. Atau, tekan dan tahan roda mouse, saat Anda menggerakkan mouse atau trackball.

  • Setelah Anda memindahkan satu tingkat ke bawah ke peta, di sudut kiri bawah peta, bilah navigasi muncul di mana Anda dapat memilih dari opsi berikut:

    Screenshot showing map navigation bar.

    Opsi Gerakan alternatif
    Perkecil Pada permukaan peta, tekan SHIFT + pilih ganda.
    -Atau-
    Gulir ke bawah dengan roda mouse.
    Perbesar tampilan Pada permukaan peta, pilih dua kali.
    -Atau-
    Gulir ke atas dengan roda mouse.
    Perbesar agar pas Tidak ada
    Tampilkan peta mini (Sembunyikan) Tidak ada
  • Untuk naik satu tingkat di peta, pada jalur breadcrumb di bagian atas peta, pilih tingkat sebelumnya.

Pilih elemen target dan sumber untuk dipetakan

  1. Pada permukaan peta, mulai dari sisi kanan, di area skema target, pilih elemen target yang ingin Anda petakan. Jika elemen yang Anda inginkan adalah anak dari elemen induk, temukan dan perluas induk terlebih dahulu.

  2. Sekarang, di sisi kiri, dari area skema sumber, pilih Pilih elemen.

  3. Di jendela Skema sumber yang muncul, pilih satu atau beberapa elemen sumber untuk ditampilkan di peta.

    • Untuk menyertakan induk dan anak langsung, buka menu pintasan induk, dan pilih Tambahkan anak.

    • Untuk menyertakan induk dan semua anak untuk induk tersebut, termasuk sub-induk apa pun, buka menu pintasan induk tingkat atas, dan pilih Tambahkan anak (rekursif).

  4. Setelah selesai, Anda dapat menutup jendela skema sumber. Anda selalu dapat menambahkan lebih banyak elemen sumber nanti. Pada peta, di sudut kiri atas, pilih Tampilkan skema sumber (Icon for Show source schema.).

Membuat pemetaan langsung antar elemen

Untuk transformasi langsung antara elemen dengan jenis yang sama dalam skema sumber dan target, ikuti langkah-langkah berikut:

  1. Untuk meninjau apa yang terjadi dalam kode saat Anda membuat pemetaan, di sudut kanan atas peta, pilih Tampilkan kode.

  2. Jika Anda belum melakukannya, di peta, pilih elemen target lalu elemen sumber yang ingin Anda petakan.

  3. Pindahkan pointer Anda ke elemen sumber sehingga lingkaran dan tanda plus (+) muncul.

    Screenshot showing the data map and starting a mapping between EmployeeID and ID in the source and target schema, respectively.

  4. Seret garis ke elemen target sehingga garis tersambung ke lingkaran yang muncul.

    Screenshot showing the data map and ending a mapping between EmployeeID and ID in the source and target schema, respectively.

    Anda sekarang telah membuat pemetaan langsung di antara kedua elemen.

    Screenshot showing the data map and a finished mapping between EmployeeID and ID in the source and target schema, respectively.

    Jendela tampilan kode mencerminkan hubungan pemetaan yang Anda buat:

    Screenshot showing code view with direct mapping between EmployeeID and ID in the source and target schema, respectively.

Catatan

Jika Anda membuat pemetaan antara elemen di mana jenis datanya tidak cocok, peringatan muncul pada elemen target, misalnya:

Screenshot showing direct mapping between mismatching data types.

Membuat pemetaan kompleks antar elemen

Untuk transformasi yang lebih kompleks antara elemen dalam skema sumber dan target, seperti elemen yang ingin Anda gabungkan atau yang memiliki jenis data yang berbeda, Anda dapat menggunakan satu atau beberapa fungsi untuk melakukan tugas untuk transformasi tersebut.

Tabel berikut mencantumkan grup fungsi dan contoh fungsi yang tersedia yang bisa Anda gunakan:

Grupkan Contoh fungsi
Koleksi Rata-rata, Hitungan, Akses Langsung, Nilai berbeda, Filter, Indeks, Gabung, Maksimum, Minimum, Terbalik, Urutkan, Berikutnya, Jumlah
Konversi Hingga saat ini, Ke bilangan bulat, Ke angka, Ke string
Tanggal dan waktu Tambahkan hari
Perbandingan logis Sama, Ada, Lebih Besar, Lebih Besar atau sama dengan, Jika, Jika lain, Nihil, Apakah null, Adalah angka, Adalah string, Kurang, Kurang atau sama, Logis DAN, LOGIS TIDAK, Logis ATAU, Tidak sama
Matematika Absolut, Add, Arctangent, Ceiling, Cosine, Divide, Exponential, Exponential (base 10), Floor, Integer divide, Log, Log (base 10), Module, Multiply, Power, Round, Sine, Square root, Subtract, Tangent
String Kode menunjuk ke string, Concat, Contains, Ends with, Length, Lowercase, Name, Regular expression matches, Regular expression replace, Replace, Starts with, String to code-points, Substring, Substring after, Substring before, Trim, Trim left, Trim right, Uppercase
Utilitas Salin, Kesalahan, Jalankan XPath, Format tanggal-waktu, Format angka, Jalankan XSLT

Pada peta, label fungsi terlihat seperti contoh berikut dan dikodekan warna berdasarkan grup fungsi. Di sisi kiri nama fungsi, simbol untuk fungsi muncul. Di sisi kanan nama fungsi, simbol untuk jenis data output fungsi muncul.

Screenshot showing example function label.

Menambahkan fungsi tanpa hubungan pemetaan

Contoh di bagian ini mengubah jenis elemen sumber dari jenis String ke jenis DateTime, yang cocok dengan jenis elemen target. Contoh menggunakan fungsi To date , yang mengambil satu input.

  1. Untuk meninjau apa yang terjadi dalam kode saat Anda membuat pemetaan, di sudut kanan atas peta, pilih Tampilkan kode.

  2. Jika Anda belum melakukannya, di peta, pilih elemen target lalu elemen sumber yang ingin Anda petakan.

  3. Di sudut kiri atas peta, pilih Perlihatkan fungsi (Icon for Show functions.).

    Screenshot showing source and target schema elements plus the selected function, Show functions.

  4. Dari daftar fungsi yang terbuka, temukan dan pilih fungsi yang ingin Anda gunakan, yang menambahkan fungsi ke peta. Jika fungsi tidak terlihat di peta, coba perkecil pada permukaan peta.

    Contoh ini memilih fungsi To date . Anda juga dapat menemukan dan memilih fungsi kustom apa pun dengan cara yang sama. Untuk informasi selengkapnya, lihat Membuat fungsi kustom.

    Screenshot showing the selected function named To date.

    Catatan

    Jika tidak ada garis pemetaan yang ada atau dipilih saat Anda menambahkan fungsi ke peta, fungsi muncul di peta, tetapi terputus dari elemen atau fungsi lain, misalnya:

    Screenshot showing the disconnected function, To date.

  5. Perluas bentuk fungsi untuk menampilkan detail fungsi dan titik koneksi. Untuk memperluas bentuk fungsi, pilih di dalam bentuk.

  6. Koneksi fungsi ke elemen sumber dan target.

    1. Seret dan gambar garis antara elemen sumber dan tepi kiri fungsi. Anda dapat memulai dari elemen sumber atau dari fungsi.

      Screenshot showing start mapping between source element and function.

    2. Seret dan gambar garis antara tepi kanan fungsi dan elemen target. Anda dapat memulai dari elemen target atau dari fungsi .

      Screenshot showing finish mapping between function and target element.

  7. Pada tab Properti fungsi, konfirmasi atau edit input yang akan digunakan.

    Screenshot showing Properties tab for the function, To date.

    Untuk beberapa jenis data, seperti array, cakupan untuk transformasi mungkin juga muncul tersedia. Cakupan ini biasanya merupakan elemen langsung, seperti array, tetapi dalam beberapa skenario, cakupan mungkin ada di luar elemen langsung.

    Jendela tampilan kode mencerminkan hubungan pemetaan yang Anda buat:

    Screenshot showing code view with direct mapping relationship between source and target elements.

Misalnya, untuk melakukan iterasi melalui item array, lihat Membuat perulangan di antara array. Untuk melakukan tugas saat nilai elemen memenuhi kondisi, lihat Menambahkan kondisi antar elemen.

Menambahkan fungsi ke hubungan pemetaan yang sudah ada

Saat hubungan pemetaan sudah ada antara elemen sumber dan target, Anda dapat menambahkan fungsi dengan mengikuti langkah-langkah berikut:

  1. Pada peta, pilih baris untuk pemetaan yang Anda buat.

  2. Pindahkan penunjuk Anda ke garis yang dipilih, dan pilih tanda Sisipkan fungsi plus (+) yang muncul, misalnya:

    Screenshot shows Visual Studio Code with elements from source and target schemas with mapping relationship and option to Insert function.

  3. Dari daftar fungsi yang terbuka, temukan dan pilih fungsi yang ingin Anda gunakan.

    Fungsi muncul di peta dan secara otomatis terhubung antara elemen sumber dan target.

Menambahkan fungsi dengan beberapa input

Contoh di bagian ini menggabungkan beberapa jenis elemen sumber sehingga Anda dapat memetakan hasilnya ke jenis elemen target. Contohnya menggunakan fungsi Concat , yang mengambil beberapa input.

  1. Untuk meninjau apa yang terjadi dalam kode saat Anda membuat pemetaan, di sudut kanan atas peta, pilih Tampilkan kode.

  2. Jika Anda belum melakukannya, di peta, pilih elemen target lalu elemen sumber yang ingin Anda petakan.

  3. Di sudut kiri atas peta, pilih Perlihatkan fungsi (Icon for Show functions.).

    Screenshot showing source and target schema elements and the selected function named Show functions.

  4. Dari daftar fungsi yang terbuka, temukan dan pilih fungsi yang ingin Anda gunakan, yang menambahkan fungsi ke peta. Jika fungsi tidak terlihat di peta, coba perkecil pada permukaan peta.

    Contoh ini memilih fungsi Concat :

    Screenshot showing the selected function named Concat.

    Catatan

    Jika tidak ada baris pemetaan yang ada atau dipilih saat Anda menambahkan fungsi ke peta, fungsi muncul di peta, tetapi terputus dari elemen atau fungsi lainnya. Jika fungsi memerlukan konfigurasi, titik merah muncul di sudut kanan atas fungsi, misalnya:

    Screenshot showing the disconnected function, Concat.

  5. Perluas bentuk fungsi untuk menampilkan detail fungsi dan titik koneksi. Untuk memperluas bentuk fungsi, pilih di dalam bentuk.

  6. Di panel informasi fungsi, pada tab Properti , di bawah Input, pilih elemen data sumber untuk digunakan sebagai input.

    Contoh ini memilih elemen sumber FirstName dan LastName sebagai input fungsi, yang secara otomatis menambahkan koneksi masing-masing di peta.

    Screenshot showing multiple source data elements selected as function inputs.

  7. Untuk menyelesaikan pemetaan seret dan gambar garis antara tepi kanan fungsi dan elemen target. Anda dapat memulai dari elemen target atau dari fungsi .

    Screenshot showing finished mapping from function with multiple inputs to target element.

    Jendela tampilan kode mencerminkan hubungan pemetaan yang Anda buat:

    Screenshot showing code view with complex mapping relationship between source and target elements.

Membuat perulangan di antara array

Jika skema sumber dan target Anda menyertakan array, Anda dapat membuat hubungan pemetaan perulangan yang berulang melalui item dalam array tersebut. Contoh di bagian ini mengulang melalui array sumber Karyawan dan array target Orang.

  1. Untuk meninjau apa yang terjadi dalam kode saat Anda membuat pemetaan, di sudut kanan atas peta, pilih Tampilkan kode.

  2. Pada peta, di area skema target, pilih elemen array target dan elemen item array target yang ingin Anda petakan.

  3. Pada peta, di area skema target, perluas elemen array target dan item array.

  4. Di area skema sumber, tambahkan elemen array sumber dan elemen item array ke peta.

  5. Buat pemetaan langsung antara elemen sumber dan target.

    Screenshot showing the data map and drawing a connection between Name array items in the source and target arrays, Employee and Person, respectively.

    Saat Anda pertama kali membuat hubungan pemetaan antara sepasang item array yang cocok, hubungan pemetaan secara otomatis dibuat di tingkat array induk.

    Screenshot showing loop mapping between the Name array items plus the source and target arrays, Employee and Person, respectively.

    Jendela tampilan kode mencerminkan hubungan pemetaan yang Anda buat:

    Screenshot showing code view with looping relationship between source and target arrays, Employee and Person, respectively.

  6. Lanjutkan pemetaan elemen array lainnya.

    Screenshot showing continue looping mapping between other array items in source and target arrays.

Menyiapkan kondisi dan tugas untuk dilakukan di antara elemen

Untuk menambahkan hubungan pemetaan yang mengevaluasi kondisi dan melakukan tugas saat kondisi terpenuhi, Anda dapat menggunakan beberapa fungsi, seperti fungsi If , fungsi perbandingan seperti Lebih Besar, dan tugas yang harus dilakukan seperti Mengalikan.

Contoh di bagian ini menghitung diskon untuk diterapkan ketika jumlah pembelian melebihi 20 item dengan menggunakan fungsi berikut:

  • Lebih besar: Periksa apakah jumlah item lebih besar dari 20.
  • Jika: Periksa apakah fungsi Lebih Besar mengembalikan true.
  • Kalikan: Hitung diskon dengan mengalikan harga item sebesar 10% dan jumlah item.
  1. Untuk meninjau apa yang terjadi dalam kode saat Anda membuat pemetaan, di sudut kanan atas peta, pilih Tampilkan kode.

  2. Jika Anda belum melakukannya, di peta, pilih elemen target lalu elemen sumber yang ingin Anda petakan.

    Contoh ini memilih elemen berikut:

    Screenshot showing the data map and elements to map.

  3. Di sudut kiri atas peta, pilih Perlihatkan fungsi (Icon for Show functions.).

  4. Tambahkan fungsi berikut ke peta: Lebih Besar, Jika, dan Kalikan

  5. Perluas semua bentuk fungsi untuk memperlihatkan detail fungsi dan titik koneksi.

  6. Koneksi elemen sumber, fungsi, dan elemen target sebagai berikut:

    • Elemen ItemPrice skema sumber ke elemen ItemPrice skema target
    • Elemen ItemQuantity skema sumber ke bidang Nilai fungsi yang lebih besar
    • Output fungsi Lebih Besar ke bidang Kondisi fungsi If
    • Elemen ItemPrice skema sumber ke bidang Multiplicand 0* fungsi Multiplicand*
    • Output fungsi Perkalian ke bidang Nilai fungsi If
    • Output fungsi If ke elemen ItemDiscount skema target

    Catatan

    Dalam fungsi If, kata ANY muncul di sebelah kanan nama fungsi, menunjukkan bahwa Anda dapat menetapkan nilai output ke apa pun.

  7. Dalam fungsi berikut, pada tab Properti , tentukan nilai berikut:

    Function Parameter input dan nilai
    Lebih besar - Nilai #1: Elemen sumber bernama ItemQuantity
    - Nilai #2: 20
    Perkalian - Multiplicand #1: Elemen sumber bernama ItemPrice
    - Multiplicand #2: .10
    Jika - Kondisi: is-greater-than(ItemQuantity,20)
    - Nilai: kalikan(ItemPrice, .10)

    Peta berikut menunjukkan contoh yang sudah selesai:

    Screenshot showing finished condition example.

    Jendela tampilan kode mencerminkan hubungan pemetaan yang Anda buat:

    Screenshot showing code view with conditional mapping between source and target elements using the functions, Greater, If, and Multiply.

Simpan peta Anda

Setelah selesai, pada toolbar peta, pilih Simpan.

Visual Studio Code menyimpan peta Anda sebagai artefak berikut:

  • File <your-map-name.yml> di folder proyek Artifacts>MapDefinitions
  • File <your-map-name.xslt> di folder proyek Artefak Peta>

Membuat file XSLT kapan saja

Untuk menghasilkan <file your-map-name.xslt> kapan saja, pada toolbar peta, pilih Hasilkan XSLT.

Menguji peta Anda

Untuk mengonfirmasi bahwa transformasi berfungsi seperti yang Anda harapkan, Anda memerlukan data input sampel.

  1. Sebelum menguji peta, pastikan untuk membuat file your-map-name.xslt> terbaru<.

  2. Pada toolbar peta Anda, pilih Uji.

  3. Pada panel Uji peta , di jendela Input , tempelkan data input sampel Anda, lalu pilih Uji.

    Panel pengujian beralih ke tab Output dan memperlihatkan kode status pengujian dan isi respons.

Memanggil peta Anda dari alur kerja di proyek Anda

  1. Pada menu kiri Visual Studio Code, pilih Explorer (ikon file) untuk melihat struktur proyek aplikasi logika Anda.

  2. Perluas folder yang memiliki nama alur kerja Anda. Dari menu pintasan file workflow.json , pilih Buka Perancang.

  3. Pada perancang alur kerja, ikuti langkah-langkah umum ini untuk menambahkan tindakan bawaan Operasi Pemeta Data bernama Transformasi menggunakan Data Mapper XSLT.

  4. Pada perancang, pilih tindakan Transformasi menggunakan Data Mapper XSLT .

  5. Pada panel informasi tindakan yang muncul, tentukan nilai Konten , dan biarkan Sumber Peta diatur ke Aplikasi Logika. Dari daftar Nama Peta, pilih file peta (.xslt) yang ingin Anda gunakan.

    Screenshot shows Visual Studio Code, Standard workflow designer, with selected action named Transform using Data Mapper XSLT and action properties.

    Untuk menggunakan tindakan Transformasi yang sama menggunakan Data Mapper XSLT di portal Azure, Anda harus menambahkan peta ke sumber daya aplikasi logika Standar.

Membuat fungsi kustom

Untuk membuat fungsi Anda sendiri yang dapat Anda gunakan dengan alat Pemeta Data, ikuti langkah-langkah berikut:

  1. Buat file XML (.xml) yang memiliki nama yang bermakna yang menjelaskan tujuan fungsi Anda.

    Jika Anda memiliki beberapa fungsi terkait, Anda dapat menggunakan satu file untuk fungsi-fungsi ini. Meskipun Anda dapat menggunakan nama file apa pun, nama atau kategori file yang bermakna membuat fungsi Anda lebih mudah diidentifikasi, ditemukan, dan ditemukan.

  2. Dalam file XML, Anda harus menggunakan skema berikut untuk definisi fungsi:

    <?xml version="1.0" encoding="utf-8"?>
    <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
       <xs:element name="customfunctions">
          <xs:complexType>
             <xs:sequence>
                <xs:element maxOccurs="unbounded" name="function">
                   <xs:complexType>
                      <xs:sequence>
                         <xs:element maxOccurs="unbounded" name="param">
                            <xs:complexType>
                                <xs:attribute name="name" type="xs:string" use="required" />
                                <xs:attribute name="as" type="xs:string" use="required" />
                            </xs:complexType>
                         </xs:element>
                         <xs:any minOccurs="0" />
                      </xs:sequence>
                      <xs:attribute name="name" type="xs:string" use="required" />
                      <xs:attribute name="as" type="xs:string" use="required" />
                      <xs:attribute name="description" type="xs:string" use="required" />
                   </xs:complexType>
                </xs:element>
             </xs:sequence>
          </xs:complexType>
       </xs:element>
    </xs:schema>
    

    Setiap elemen XML bernama "function" mengimplementasikan fungsi gaya XSLT3.0 dengan beberapa atribut lagi. Daftar fungsi Pemeta Data mencakup nama fungsi, deskripsi, nama parameter, dan jenis parameter.

    Contoh berikut menunjukkan implementasi untuk file SampleFunctions.xml :

    <?xml version="1.0" encoding="utf-8" ?>
    <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <customfunctions>
       <function name="age" as="xs:float" description="Returns the current age.">
          <param name="inputDate" as="xs:date"/> 
          <value-of select="round(days-from-duration(current-date() - xs:date($inputDate)) div 365.25, 1)"/>
       </function> 
       <function name="custom-if-then-else" as="xs:string" description="Evaluates the condition and returns corresponding value.">
          <param name="condition" as="xs:boolean"/>
          <param name="thenResult" as="xs:anyAtomicType"/>
          <param name="elseResult" as="xs:anyAtomicType"/>
          <choose>
             <when test="$condition">
                <value-of select="$thenResult"></value-of>
             </when>
             <otherwise>
                <value-of select="$elseResult"></value-of>
             </otherwise>
          </choose>
       </function>
    </customfunctions>
    
  3. Di komputer lokal Anda, buka folder untuk proyek aplikasi logika Standar Anda.

  4. Buka folder Artefak, dan buat struktur folder berikut, jika tidak ada: Fungsi Ekstensi>DataMapper.>

  5. Di folder Functions, simpan file XML fungsi Anda.

  6. Untuk menemukan fungsi kustom Anda di daftar fungsi alat Pemeta Data, cari fungsi, atau perluas koleksi Fungsi kustom.

Langkah berikutnya