Tugas Data Transformer

Tugas Data Transformer menyediakan dua mode–Diagram dan Skrip–untuk mentransformasi data Anda. Dalam mode Diagram, Anda menggunakan kanvas pemetaan visual, yang disebut editor Data Transformer, untuk melakukan penetapan dan pemetaan data dalam integrasi Anda. Selain itu, Anda juga dapat menggunakan transformasi yang didukung untuk mengubah data menjadi variabel dan format yang bermakna agar dapat diakses oleh tugas atau pemicu lain dalam integrasi Anda. Dalam mode Script, Anda dapat menulis, mengedit, dan mengevaluasi template Jsonnet kustom untuk melakukan pemetaan data dalam integrasi Anda.

Untuk mengetahui informasi tentang pemetaan data di Application Integration, lihat Ringkasan pemetaan data.

Mengonfigurasi tugas Data Transformer

Untuk menambahkan tugas Data Transformer ke integrasi Anda, lakukan langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman Application Integration.

    Buka Application Integration

  2. Di menu navigasi, klik Integrations.

    Halaman Integrations akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.

  3. Pilih integrasi yang ada atau klik Create integration untuk membuat integrasi baru.

    Jika Anda membuat integrasi baru:

    1. Masukkan nama dan deskripsi di panel Create Integration.
    2. Pilih region untuk integrasi.
    3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Integration summary di toolbar integrasi.
    4. Klik Create. Integrasi yang baru dibuat akan terbuka di editor integrasi.

  4. Di menu navigasi editor integrasi, klik Tasks untuk melihat daftar tugas dan konektor yang tersedia.
  5. Klik dan tempatkan elemen Data Transformer di editor integrasi.
  6. Klik elemen Data Transformer untuk melihat panel konfigurasi tugas.
  7. Klik Open Data Transformer editor. Di halaman Data Transformer Task Editor, pilih salah satu opsi berikut:
    • Secara default, mode Diagram akan terbuka. Mode Diagram memberikan pengalaman berbasis konsol untuk memilih variabel input dan output serta melakukan transformasi di editor transformasi data.

      Dalam mode Diagram, Anda dapat melakukan pemetaan data secara visual antara variabel input dan output.

    • Untuk melakukan transformasi data dalam integrasi Anda dengan menulis, mengedit, dan mengevaluasi template Jsonnet kustom, buka mode skrip dengan mengklik Skrip. Anda dapat menggunakan mode Skrip jika memiliki persyaratan transformasi data yang kompleks dan jika ingin memanfaatkan fungsi Jsonnet.

      Editor Data Transformer akan muncul dan menampilkan contoh template Jsonnet default yang diberi komentar. Tulis kode Jsonnet Anda dan tutup editor setelah selesai. Setiap perubahan akan disimpan otomatis.

    Untuk mengetahui langkah-langkah mendetail tentang cara menambahkan pemetaan, lihat Menambahkan pemetaan.

Menambahkan pemetaan

Untuk menambahkan pemetaan, Anda dapat menggunakan mode Diagram atau mode Skrip.

Menggunakan mode Diagram

Mode Diagram memberikan pengalaman berbasis konsol untuk memilih variabel input dan output serta melakukan transformasi di editor transformasi data. Untuk menambahkan pemetaan menggunakan mode Diagram, ikuti langkah-langkah berikut:

  1. Di panel konfigurasi tugas Data Transformer, klik Open Data Transformer Editor.

    Secara default, mode Diagram akan terbuka.

    gambar yang menampilkan mode diagram gambar yang menampilkan mode diagram

  2. Untuk menambahkan variabel input untuk pemetaan, klik + Tambahkan input. Dialog Choose Input Variable or Value akan muncul. Tab Variabel dipilih secara default.

    gambar yang menampilkan dialog tambahkan input gambar yang menampilkan dialog tambahkan input

    Kemudian, lakukan hal berikut:

    1. Dari daftar Select Variable(s), pilih variabel input. Jika Anda ingin membuat variabel baru, klik + Tambahkan Variabel Baru.
    2. Klik Kirim.

    Secara opsional, jika Anda ingin menambahkan konstanta, klik tab Constant.

    Tidak seperti variabel, konstanta tidak dapat diakses oleh tugas atau pemicu lain dalam integrasi Anda dan hanya dibatasi untuk digunakan dalam tugas Data Transformation tempat konstanta tersebut dibuat. Misalnya, Anda dapat menggunakan konstanta untuk menambahkan pembatas atau memetakan nilai konstanta ke variabel.

    gambar yang menampilkan dialog add constant gambar yang menampilkan dialog add constant

    Kemudian, lakukan hal berikut:

    1. Di kolom ID konstanta, masukkan nama konstanta.
    2. Dari daftar Jenis Data, pilih salah satu jenis data berikut:
      • String
      • Boolean
      • Nomor
    3. Di kolom Masukkan nilai konstanta, masukkan nilai.
    4. Klik Kirim.
  3. Untuk menambahkan variabel output untuk pemetaan, klik + Tambahkan Output dan pilih variabel output atau buat variabel baru.

    gambar yang menampilkan dialog add output gambar yang menampilkan dialog add output

  4. Konfigurasi pemetaan:
    1. Tambahkan pemetaan dari variabel atau subkolomnya dari daftar Variables di bagian Input ke variabel atau subkolomnya dari daftar Variables di bagian Output.

      gambar yang menunjukkan mode diagram data-transformer gambar yang menunjukkan mode diagram data-transformer

    2. Untuk menambahkan fungsi transformasi, arahkan kursor ke garis pemetaan dan klik untuk menambahkan fungsi transformasi data. Tombol Transformation akan muncul di kanvas.

      Atau, Anda dapat mengklik Tambahkan transformasi untuk menambahkan fungsi transformasi.

      Kemudian, lakukan hal berikut:

      1. Untuk menambahkan transformasi, klik tombol Transformation. Panel Transformation akan muncul.

        gambar yang menunjukkan transformasi data gambar yang menunjukkan transformasi data

        Kemudian, lakukan hal berikut:

        1. Klik + Add Operation. Dialog Add Operation akan muncul.

          gambar yang menunjukkan operasi transformasi data gambar yang menunjukkan operasi transformasi data

        2. Di kolom Search operations, masukkan operasi yang ingin Anda tambahkan. Atau, Anda dapat memilih operasi dari daftar operasi.

          Jika Anda ingin menambahkan operasi kustom, pilih Ekspresi fungsi dan masukkan ekspresi fungsi. Untuk menyalin variabel, klik dari daftar Variables dan tempelkan di editor ekspresi.

          gambar yang menunjukkan ekspresi fungsi gambar yang menunjukkan ekspresi fungsi

        3. Klik Done.
      2. Berdasarkan operasi, isi detail yang diperlukan. Secara opsional, Anda dapat menambahkan beberapa operasi dalam transformasi. Jika Anda ingin memilih hasil operasi sebelumnya dalam operasi berikutnya, pilih variabel Previous Operation Result seperti yang ditunjukkan pada gambar berikut:

        gambar yang menunjukkan beberapa operasi transformasi gambar yang menunjukkan beberapa operasi transformasi

      3. Untuk menghapus operasi, klik Hapus di samping operasi.
    3. Secara opsional, Anda dapat menambahkan pemetaan dari beberapa variabel input ke fungsi transformasi. Namun, hanya satu pemetaan yang dapat ditambahkan untuk setiap variabel output dari fungsi transformasi.
    4. Untuk menghapus variabel input dan output, klik > Delete.
    5. Secara opsional, untuk menghapus baris pemetaan atau transformasi, pilih pemetaan, lalu tekan Delete.
    6. Tutup Data Mapping Editor setelah pemetaan data selesai. Setiap perubahan akan disimpan otomatis.

    Contoh: Memetakan sistem tiket bug lama ke sistem tiket baru

    Misalnya, Anda memiliki sistem tiket bug lama yang ingin dimigrasikan ke sistem tiket baru. Anda dapat menggunakan opsi Diagram untuk memetakan kolom dari sistem lama ke sistem baru seperti yang ditunjukkan pada gambar berikut:

    gambar yang menunjukkan mode diagram data-transformer gambar yang menunjukkan mode diagram data-transformer

    Untuk menambahkan nilai konstanta untuk salah satu kolom, klik Add input dan tambahkan konstanta baru. Anda dapat memetakan konstanta yang baru ditambahkan dari bagian Input ke kolom di bagian Output.

    gambar yang menampilkan data-transformer menambahkan konstanta gambar yang menampilkan data-transformer menambahkan konstanta

    Untuk menambahkan transformasi bagi kolom yang tidak dapat dipetakan secara langsung, klik Transformation dan tambahkan operasi transformasi dengan mengklik + Add operation:

    gambar yang menampilkan penambahan transformasi oleh data-transformer gambar yang menampilkan penambahan transformasi oleh data-transformer

    Setelah transformasi selesai, Anda dapat menjalankan integrasi untuk memetakan sistem tiket lama ke sistem baru.

    Menggunakan Mode skrip

    Anda dapat menggunakan editor Skrip Transformator Data untuk mengakses variabel integrasi, melakukan penetapan variabel, dan menambahkan atau mengubah variabel dalam integrasi Anda. Editor Skrip Transformer Data menyediakan fitur berikut untuk memperkaya pengalaman pembuatan skrip Anda:

    • Penandaan sintaksis/kode, indentasi, dan penomoran baris untuk memudahkan keterbacaan kode dan pengenalan struktur.
    • Minimap yang menampilkan ringkasan tingkat tinggi kode skrip dan membantu navigasi cepat.
    • Opsi klik untuk menyalin kode skrip ke papan klip.

    Untuk membuka editor, buka panel konfigurasi tugas Data Transformer Script, lalu klik Open Data Transformer Script Editor.

    Editor Skrip Data Transformer secara default mengimpor functions, library kustom yang telah ditetapkan dan berisi kumpulan fungsi Jsonnet untuk pemetaan data di Application Integration. Untuk mengetahui detail fungsi kustom yang tersedia, lihat Fungsi Data Transformer.

    Gambar berikut menunjukkan contoh tata letak Data Transformer Script editor:

    gambar yang menampilkan editor skrip data-transformer gambar yang menampilkan editor skrip data-transformer

    Mengakses variabel integrasi

    Untuk membaca variabel integrasi yang ada dari Data Transformer Script editor, gunakan fungsi extVar dari library functions yang telah ditetapkan.

    Contoh: Membaca dan memperbarui variabel integrasi yang ada menggunakan editor Skrip Transformator Data.

    Skrip Jsonnet

    local f = import "functions"; // Import predefined Data Transformer function library

local str1 = f.extVar("inputVar1"); // Access integration input variable "Inputstr1" with value "Hello"
local str2 = f.extVar("inputVar2"); // Access integration input variable "Inputstr2" with value "World"
{
  OutputVar: str1 + " " + str2 + "!", // Write to Jsonnet output variable "OutputVar"
  "output-str-var": str1 + " Integration " + str2 + "!", // Write to Jsonnet output variable "output-str-var"
}

    Output

    gambar yang menampilkan contoh skrip data-transformer gambar yang menampilkan contoh skrip data-transformer

    Referensi penggunaan Jsonnet

    Jsonnet adalah bahasa yang murni fungsional dan programnya terdiri dari ekspresi. Untuk mengetahui informasi tentang cara membentuk ekspresi ini, lihat Ekspresi Jsonnet.

    Strategi penanganan error

    Strategi penanganan error untuk tugas menentukan tindakan yang harus diambil jika tugas gagal karena error sementara. Untuk mengetahui informasi tentang cara menggunakan strategi penanganan error, dan untuk mengetahui berbagai jenis strategi penanganan error, lihat Strategi penanganan error.

    Kuota dan batas

    Untuk mengetahui informasi tentang batas penggunaan yang berlaku untuk tugas Data Transformer, lihat Batas penggunaan.

    Langkah berikutnya