Lihat konektor yang didukung untuk Integration Aplikasi.

Tugas JavaScript

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

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

JavaScript Editor mendukung fitur berikut:

• Peta mini yang menampilkan ringkasan umum kode skrip dan membantu navigasi cepat.
• Penyorotan sintaksis/kode, indentasi, dan penomoran baris untuk memudahkan keterbacaan kode dan pengenalan struktur.
• Penandaan error untuk menemukan dan melacak error dalam kode.
• Menciutkan untuk meluaskan dan menciutkan wilayah 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 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 JavaScript di editor integrasi.
6. Klik elemen JavaScript di desainer untuk melihat panel konfigurasi tugas JavaScript.
7. Klik Buka editor skrip untuk melihat dan mengedit Editor JavaScript. Anda juga dapat menggunakan Gemini untuk membuat kode JavaScript dengan mengklik Skrip dengan Gemini. Untuk informasi tentang cara menggunakan Gemini untuk membuat kode JavaScript, lihat Mengonfigurasi tugas JavaScript dengan bantuan Gemini.
8. Tulis kode JavaScript Anda di dalam fungsi executesScript(event) yang dibuat secara otomatis di JavaScript Editor. Tutup editor setelah selesai, semua perubahan akan disimpan secara otomatis.
   Peringatan: Jangan hapus fungsi executesScript(event). Fungsi ini dipanggil saat tugas JavaScript dijalankan.

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

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

Gambar berikut menunjukkan contoh tata letak JavaScript Editor:

Menggunakan Editor JavaScript

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

• executesScript(): fungsi yang dipanggil saat Application Integration mengeksekusi tugas JavaScript selama pengoperasian integrasi.
• event: objek dalam memori dari Integrasi Aplikasi.

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

Peringatan: Jangan hapus fungsi executesScript(event). Fungsi ini dipanggil saat tugas JavaScript dijalankan.

Mesin eksekusi JavaScript

Integrasi Aplikasi menggunakan mesin eksekusi JavaScript yang didasarkan pada Rhino 1.7.14, yang tidak mendukung semua sintaksis ES6–misalnya, deklarasi variabel dengan let tidak didukung. 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 Editor JavaScript:

Nama fungsi	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 diberikan. Jenis nilai yang ditampilkan: Jenis data variabel integrasi	Sintaksis: event.getParameter("variable_name") Parameter input: Nama variabel integrasi. Jika variable_name adalah variabel yang dibuat otomatis, sertakan variabel dalam tanda petik terbalik (``). Misalnya, `responseBody`. Contoh: function executeScript(event) { event.getParameter("var1"); }
getRegion	Menampilkan nama wilayah 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("variable_name", "variable_value") Parameter input: Fungsi ini menggunakan argumen berikut: Argumen pertama: Nama variabel. Jika variable_name adalah variabel yang dibuat otomatis, sertakan variabel dalam tanda petik terbalik (``). Misalnya, `responseBody`. Argumen kedua: Nilai. Contoh: function executeScript(event) { event.setParameter("`responseBody`", "NewStringValue"); }

Menetapkan parameter tugas

Jika integrasi Anda memiliki beberapa parameter berukuran besar yang tidak digunakan oleh tugas JavaScript, Anda dapat menetapkan kolom TaskParameter untuk tugas JavaScript guna meningkatkan performa.

Untuk menetapkan kolom TaskParameter untuk tugas JavaScript, pilih salah satu opsi berikut:

Konsol

1. Buka halaman Integrasi Aplikasi.

   Buka Integration Aplikasi

2. Pilih integrasi. Editor integrasi akan terbuka.
3. Klik Action > Download Integration > Integration Version. Versi integrasi didownload sebagai file JSON.
4. Buka file versi integrasi di editor, lalu lakukan hal berikut:
   1. Temukan kolom taskConfigs dengan tugas sebagai JavaScriptTask. Di kolom parameters, temukan parameter bernama script.

      "taskConfigs": [{
        "task": "JavaScriptTask",
        "taskId": 1,
        "parameters": {
          "script": {
            "key": "script",
            "value": {
              "stringValue": "function that is called during the JavaScriptTask execution"
            }
        }"
      }]
      

   2. Di kolom parameters ini, tambahkan parameter yang digunakan di kolom JavaScriptTask menggunakan template berikut:

      "ParamName": {
        "key": "ParamName",
        "value": {
          "stringValue": "$ParamName$"
        }
      }
      

5. Simpan perubahan yang Anda buat ke file versi integrasi.
6. Upload file versi integrasi ke integrasi.

API

1. Untuk mendownload versi integrasi, lakukan panggilan ke metode projects.locations.integrations.versions.download dengan filFormat ditetapkan ke JSON.
2. Buka file versi integrasi di editor, lalu lakukan hal berikut:
   1. Temukan kolom taskConfigs dengan tugas sebagai JavaScriptTask. Di kolom parameters, temukan parameter bernama script.

      "taskConfigs": [{
        "task": "JavaScriptTask",
        "taskId": 1,
        "parameters": {
          "script": {
            "key": "script",
            "value": {
              "stringValue": "function that is called during the JavaScriptTask execution"
            }
        }"
      }]
      

   2. Di kolom parameters ini, tambahkan parameter yang digunakan di kolom JavaScriptTask menggunakan template berikut:

      "ParamName": {
        "key": "ParamName",
        "value": {
          "stringValue": "$ParamName$"
        }
      }
      

3. Untuk mengupload versi integrasi, lakukan panggilan ke metode projects.locations.integrations.versions.upload dengan file versi integrasi yang diperbarui.

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 kuota dan batas, lihat Kuota dan batas.

Langkah selanjutnya

• Pelajari hal berikut:
  • Mengonfigurasi tugas JavaScript dengan bantuan Gemini
  Semua tugas dan pemicu
  • Menguji dan memublikasikan integrasi
  • Penanganan error
  • Log eksekusi integrasi