Lihat konektor yang didukung untuk Application Integration.

Tugas JavaScript

Tugas JavaScript memungkinkan Anda menulis cuplikan kode JavaScript kustom untuk integrasi Anda.

Dengan menggunakan JavaScript Editor, Anda dapat membuat kode logika pemetaan data yang kompleks untuk integrasi, melakukan penetapan variabel, dan menambahkan atau mengubah variabel integrasi.

JavaScript Editor mendukung fitur berikut:

  • Peta mini yang menampilkan gambaran umum kode skrip dan membantu navigasi cepat.
  • Penyorotan sintaks/kode, indentasi, dan penomoran baris agar kode lebih mudah dibaca dan pengenalan struktur.
  • Kesalahan saat menandai untuk menemukan dan melacak kesalahan dalam kode.
  • Perangkat foldable untuk meluaskan dan menciutkan area kode skrip.
  • Opsi klik untuk menyalin untuk menyalin kode skrip ke papan klip.

Mengonfigurasi tugas JavaScript

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

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

    Buka Application Integration

  2. Di menu navigasi, klik Integrasi.

    Halaman Integrations akan muncul dan 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 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.

    Tindakan ini akan membuka integrasi di editor integrasi.

  4. Di menu navigasi editor integrasi, klik Tasks untuk melihat daftar tugas yang tersedia.
  5. Klik dan tempatkan elemen JavaScript di editor integrasi.
  6. Klik elemen JavaScript pada desainer untuk melihat panel konfigurasi tugas JavaScript.
  7. Klik Buka editor skrip untuk melihat dan mengedit Editor JavaScript.
  8. Tulis kode JavaScript Anda di dalam fungsi executesScript(event) yang dibuat otomatis di JavaScript Editor. Tutup editor setelah selesai, perubahan akan disimpan otomatis.

    Untuk informasi tentang cara mengakses variabel integrasi dan fungsi yang didukung, lihat Menggunakan JavaScript Editor.

    Untuk mengetahui informasi tentang cara melihat log eksekusi yang dihasilkan, lihat Log eksekusi.

Gambar berikut menunjukkan contoh tata letak JavaScript Editor: gambar yang menampilkan editor javascript gambar yang menampilkan editor javascript

Menggunakan JavaScript Editor

Untuk melihat dan mengedit JavaScript Editor, buka panel konfigurasi tugas JavaScript, lalu klik Open script editor. JavaScript Editor secara default berisi fungsi bernama executesScript(event).

Dengan keterangan:

  • executesScript() adalah fungsi yang dipanggil saat Integrasi Aplikasi menjalankan tugas JavaScript selama integrasi berjalan.
  • event adalah objek dalam memori dari Application Integration.

    Untuk informasi tentang metode objek peristiwa yang didukung, lihat Akses variabel integrasi.

Mesin eksekusi JavaScript yang digunakan Application Integration didasarkan pada Rhino 1.7.14 yang tidak mendukung semua sintaks ES6. Hanya pelengkapan otomatis sintaksis ES5 yang didukung. Untuk melihat semua sintaksis ES6 yang didukung, lihat Dukungan Rhino ES2015.

Mengakses variabel integrasi

Variabel yang ditentukan dalam integrasi Anda dapat diakses dari Editor JavaScript menggunakan objek peristiwa dalam memori Integrasi Aplikasi.

Metode berikut didukung untuk mengakses variabel integrasi dari JavaScript Editor Anda:

  1. getEventExecutionInfoId
  2. getGoogleCloudProjectId
  3. getIntegrationName
  4. getParameter
  5. getRegion
  6. log
  7. setParameter
Function name Deskripsi Penggunaan

getEventExecutionInfoId

 Menampilkan ID eksekusi run integrasi.

Jenis nilai yang ditampilkan: String

Sintaksis: event.getEventExecutionInfoId()

Contoh: 

function executeScript(event) {
  event.getEventExecutionInfoId();
  }

getGoogleCloudProjectId

 Menampilkan ID project Google Cloud.

Jenis nilai yang ditampilkan: String

Sintaksis: event.getGoogleCloudProjectId()

Contoh: 

function executeScript(event) {
  event.getGcpProjectId();
  }

getIntegrationName

 Menampilkan nama integrasi saat ini.

Jenis nilai yang ditampilkan: String

Sintaksis: event.getIntegrationName

Contoh: 

function executeScript(event) {
  event.getIntegrationName();
  }

getParameter

 Menampilkan nilai variabel integrasi yang disediakan.

Jenis nilai yang ditampilkan: Jenis data variabel integrasi

Sintaksis: event.getParameter("value")

Parameter input: Nama variabel integrasi.

Contoh:

function executeScript(event) {
  event.getParameter("var1");
  }

getRegion

 Menampilkan nama region integrasi.

Jenis nilai yang ditampilkan: String

Sintaksis: event.getRegion()

Contoh: 

function executeScript(event) {
  event.getRegion();
  }

log

 Menulis nilai yang ditentukan ke log eksekusi.

Untuk mengetahui informasi tentang cara melihat log eksekusi yang dihasilkan, lihat Log eksekusi.

Sintaksis: event.log(value)

Parameter input: Variabel atau fungsi apa pun yang digunakan dalam skrip.

Contoh 1: 

function executeScript(event) {
  event.log(event.getParameter("var1"));
  }

Contoh 2: 

function executeScript(event) {
  event.log("Lorem ipsum");
  }

setParameter

 Menetapkan atau memperbarui nilai variabel integrasi.

Sintaksis: event.setParameter(value, value)

Parameter input: Fungsi ini menggunakan argumen berikut:

  • Argumen pertama: Nama variabel.
  • Argumen kedua: Value.

Contoh: 

function executeScript(event) {
  event.setParameter("var1", "NewStringValue");
  }

Strategi penanganan error

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