Lihat konektor yang didukung untuk Integration Aplikasi.

Tugas Transformer Data

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Tugas Transformer Data 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 Skrip, Anda dapat menulis, mengedit, dan mengevaluasi template Jsonnet kustom untuk melakukan pemetaan data dalam integrasi Anda.

Untuk mengetahui informasi tentang pemetaan data di Integrasi Aplikasi, lihat Ringkasan pemetaan data.

Mengonfigurasi tugas Transformer Data

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

1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

   Buka Application Integration

2. Di menu navigasi, klik Integrations.

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

3. Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.

   Jika Anda membuat integrasi baru:

   1. Masukkan nama dan deskripsi di panel Buat Integrasi.
   2. Pilih region untuk integrasi.
      Catatan: Drop-down Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, klik Aktifkan Wilayah. Lihat Mengaktifkan region baru untuk informasi selengkapnya.
   3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Ringkasan integrasi di toolbar integrasi.
      Catatan: Opsi untuk memilih akun layanan hanya ditampilkan jika Anda telah mengaktifkan tata kelola integrasi untuk wilayah yang dipilih.
   4. Klik Create.

   Tindakan ini akan membuka integrasi di editor integrasi.

4. Di menu navigasi editor integrasi, klik Tugas 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 Buka editor Data Transformer. Di halaman Data Transformer (pratinjau) 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 dengan komentar default. Tulis kode Jsonnet Anda dan tutup editor setelah selesai. Setiap perubahan akan otomatis disimpan.

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

   

2. Untuk menambahkan variabel input untuk pemetaan, klik + Tambahkan input. Dialog Choose Input Variable or Value akan muncul. Tab Variabel dipilih secara default.
   Input: Sumber input transformasi data. Sumber dapat berupa nilai literal, fungsi dasar, atau variabel input, dengan fungsi pemetaan.

   

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

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

   

   Kemudian, lakukan hal berikut:

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

   

4. Konfigurasikan pemetaan:
   1. Tambahkan pemetaan dari variabel atau sub-kolomnya dari daftar Variables di bagian Input ke variabel atau sub-kolomnya dari daftar Variables di bagian Output.

      

   2. Untuk menambahkan fungsi transformasi, arahkan kursor ke baris pemetaan dan klik untuk menambahkan fungsi transformasi data. Tombol Transformasi 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 Transformasi akan muncul.

         

         Kemudian, lakukan hal berikut:

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

            

         2. Di kolom Operasi penelusuran, 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 Variabel dan tempelkan di editor ekspresi.

            

         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 Hasil Operasi Sebelumnya seperti yang ditunjukkan pada gambar berikut:

         

      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 > Hapus.
   5. Secara opsional, untuk menghapus baris pemetaan atau transformasi, pilih pemetaan, lalu tekan Hapus.
   6. Tutup Editor Pemetaan Data setelah pemetaan selesai. Setiap perubahan akan otomatis disimpan.

   Contoh: Memetakan sistem penjualan tiket bug lama ke sistem tiket baru

   Misalnya, Anda memiliki sistem penjualan 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:

   

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

   

   Untuk menambahkan transformasi untuk kolom yang tidak dapat dipetakan secara langsung, klik Transformasi dan tambahkan operasi transformasi dengan mengklik + Tambahkan operasi:

   

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

   Menggunakan mode Skrip

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

   • Penyorotan sintaksis/kode, indentasi, dan penomoran baris untuk memudahkan keterbacaan kode dan pengenalan struktur.
   • Peta mini yang menampilkan ringkasan umum kode skrip dan membantu navigasi cepat.
   • Opsi klik untuk menyalin 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 Pengubah Data secara default mengimpor functions, library kustom standar yang berisi kumpulan fungsi Jsonnet untuk pemetaan data di Integrasi Aplikasi. Untuk mengetahui detail fungsi kustom yang tersedia, lihat Fungsi Data Transformer.

   Gambar berikut menunjukkan contoh tata letak editor Skrip Pengubah Data:

   

   Mengakses variabel integrasi

   Untuk membaca variabel integrasi yang ada dari editor Skrip Pengubah Data, gunakan fungsi extVar dari library functions yang telah ditentukan.

   Perhatian: Jsonnet tidak mengizinkan penggunaan tanda hubung (-) sebagai bagian dari nama ID. Misalnya, nama variabel atau nama fungsi. Jika Anda ingin menggunakan tanda hubung (-) sebagai bagian dari nama variabel, variabel harus dideklarasikan dalam tanda kutip ganda seperti yang ditunjukkan dalam contoh berikut.

   Contoh: Baca dan perbarui variabel integrasi yang ada menggunakan editor Skrip Pengubah 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

   

   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 akan diambil jika tugas gagal karena error sementara. Untuk mengetahui informasi tentang cara menggunakan strategi penanganan error, dan 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 selanjutnya

   • Pelajari hal berikut:
     • Semua tugas dan pemicu.
     • Fungsi Data Transformer (Pratinjau)
     • Menguji dan memublikasikan integrasi.
     • Penanganan error.
     • Log eksekusi integrasi.