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. Sambungkan 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.

    Cuplikan layar memperlihatkan Visual Studio Code dengan alat Pemeta Data, jendela Azure terbuka, dan tombol yang dipilih untuk Membuat peta data baru.

  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.

      Cuplikan layar memperlihatkan Visual Studio Code dengan pemeta data terbuka, peta data baru, dan opsi yang dipilih untuk Menambahkan skema sumber.

    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:

    Cuplikan layar memperlihatkan peta data dan buka Pemeta Data dengan contoh skema sumber dan target.

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

Simbol Jenis Info selengkapnya
Ikon yang mewakili jenis data Array. Array Berisi item atau node item berulang
Ikon yang mewakili jenis data Biner. Biner
Ikon yang mewakili jenis data Bool. Bool Benar atau salah saja
Ikon yang mewakili jenis data Kompleks. Kompleks Objek XML dengan properti turunan, mirip dengan jenis JSON Objek
Ikon yang mewakili jenis data DateTime. DateTime
Ikon yang mewakili jenis data Desimal. Decimal
Ikon yang mewakili jenis data Bilangan Bulat. Bilangan bulat Bilangan buletik saja
Ikon yang mewakili simbol NULL. Null Bukan tipe data, tetapi muncul saat ada kesalahan atau tipe yang tidak valid
Ikon yang mewakili jenis data Angka. Number Bilangan bulat atau desimal JSON
Ikon yang mewakili jenis data Objek. Objek Objek JSON dengan properti turunan, mirip dengan jenis XML Kompleks
Ikon yang mewakili jenis data String. 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:

    Cuplikan layar memperlihatkan bilah navigasi peta.

    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
    Tampilkan peta mini (Sembunyikan) Tidak
  • 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 (Ikon untuk Tampilkan skema sumber.).

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.

    Cuplikan layar memperlihatkan peta data dan memulai pemetaan antara EmployeeID dan ID dalam skema sumber dan target.

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

    Cuplikan layar memperlihatkan peta data dan mengakhiri pemetaan antara EmployeeID dan ID dalam skema sumber dan target.

    Anda sekarang telah membuat pemetaan langsung di antara kedua elemen.

    Cuplikan layar memperlihatkan peta data dan pemetaan yang sudah selesai antara EmployeeID dan ID dalam skema sumber dan target.

    Jendela tampilan kode mencerminkan hubungan pemetaan yang Anda buat:

    Cuplikan layar memperlihatkan tampilan kode dengan pemetaan langsung antara EmployeeID dan ID dalam skema sumber dan target.

Catatan

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

Cuplikan layar memperlihatkan pemetaan langsung antara jenis data yang tidak cocok.

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.

Cuplikan layar memperlihatkan contoh label fungsi.

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 (Ikon untuk Tampilkan fungsi.).

    Cuplikan layar memperlihatkan elemen skema sumber dan target ditambah fungsi yang dipilih, Tampilkan fungsi.

  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.

    Cuplikan layar memperlihatkan fungsi yang dipilih bernama Hingga saat ini.

    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:

    Cuplikan layar memperlihatkan fungsi terputus, Hingga saat ini.

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

  6. Sambungkan 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.

      Cuplikan layar memperlihatkan mulai pemetaan antara elemen sumber dan fungsi.

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

      Cuplikan layar memperlihatkan pemetaan selesai antara fungsi dan elemen target.

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

    Cuplikan layar memperlihatkan tab Properti untuk fungsi, Hingga saat ini.

    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:

    Cuplikan layar memperlihatkan tampilan kode dengan hubungan pemetaan langsung antara elemen sumber dan target.

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:

    Cuplikan layar memperlihatkan Visual Studio Code dengan elemen dari skema sumber dan target dengan hubungan pemetaan dan opsi untuk Menyisipkan fungsi.

  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 (Ikon untuk Tampilkan fungsi.).

    Cuplikan layar memperlihatkan elemen skema sumber dan target dan fungsi yang dipilih bernama Tampilkan fungsi.

  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 :

    Cuplikan layar memperlihatkan fungsi yang dipilih bernama 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:

    Cuplikan layar memperlihatkan fungsi terputus, 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.

    Cuplikan layar memperlihatkan beberapa elemen data sumber yang dipilih sebagai input fungsi.

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

    Cuplikan layar memperlihatkan pemetaan selesai dari fungsi dengan beberapa input ke elemen target.

    Jendela tampilan kode mencerminkan hubungan pemetaan yang Anda buat:

    Cuplikan layar memperlihatkan tampilan kode dengan hubungan pemetaan kompleks antara elemen sumber dan target.

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.

    Cuplikan layar memperlihatkan peta data dan menggambar koneksi antara item array Nama di array sumber dan target, Masing-masing Karyawan dan Orang.

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

    Cuplikan layar memperlihatkan pemetaan perulangan antara item array Nama ditambah array sumber dan target, Karyawan dan Orang, masing-masing.

    Jendela tampilan kode mencerminkan hubungan pemetaan yang Anda buat:

    Cuplikan layar memperlihatkan tampilan kode dengan hubungan perulangan antara array sumber dan target, Karyawan dan Orang, masing-masing.

  6. Lanjutkan pemetaan elemen array lainnya.

    Cuplikan layar memperlihatkan lanjutkan pemetaan perulangan antara item array lain di array sumber dan target.

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:

    Cuplikan layar memperlihatkan peta data dan elemen yang akan dipetakan.

  3. Di sudut kiri atas peta, pilih Perlihatkan fungsi (Ikon untuk Tampilkan fungsi.).

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

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

  6. Sambungkan 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:

    Fungsi 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
    Kalau - Kondisi: is-greater-than(ItemQuantity,20)
    - Nilai: kalikan(ItemPrice, .10)

    Peta berikut menunjukkan contoh yang sudah selesai:

    Cuplikan layar memperlihatkan contoh kondisi selesai.

    Jendela tampilan kode mencerminkan hubungan pemetaan yang Anda buat:

    Cuplikan layar memperlihatkan tampilan kode dengan pemetaan bersyarah antara elemen sumber dan target menggunakan fungsi, Lebih Besar, Jika, dan Kalikan.

Simpan peta Anda

Setelah selesai, pada toolbar peta, pilih Simpan.

Visual Studio Code menyimpan peta Anda sebagai artefak berikut:

  • File <nama> peta.yml Anda di folder proyek Artefak>MapDefinitions
  • File <your-map-name.xslt> di folder proyek Artifacts>Maps

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.

    Cuplikan layar memperlihatkan Visual Studio Code, perancang alur kerja Standar, dengan tindakan yang dipilih bernama Transformasi menggunakan Data Mapper XSLT dan properti tindakan.

    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