Lihat konektor yang didukung untuk Integration Aplikasi.

Tugas JavaScript

Tidak digunakan lagi: Mulai 24 Januari 2025, Integrasi Aplikasi tidak akan lagi mendukung Rhino sebagai mesin eksekusi JavaScript. Semua tugas JavaScript yang sudah dipublikasikan akan terus menggunakan Rhino dan dapat dimigrasikan ke V8 secara manual. Tugas JavaScript yang baru dibuat akan menggunakan V8 secara eksklusif. Lihat Mesin eksekusi JavaScript untuk informasi selengkapnya.

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 Integration Aplikasi

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

Tidak digunakan lagi: Mulai 24 Januari 2025, Integrasi Aplikasi tidak akan lagi mendukung Rhino sebagai mesin eksekusi JavaScript. Semua tugas JavaScript yang sudah dipublikasikan akan terus menggunakan Rhino dan dapat dimigrasikan ke V8 secara manual. Tugas JavaScript yang baru dibuat akan menggunakan V8 secara eksklusif.

Application Integration sebelumnya mendukung Rhino sebagai mesin eksekusi JavaScript untuk menjalankan tugas JavaScript. Untuk memanfaatkan manfaat performa dan keamanan mesin JavaScript performa tinggi open source Google, Rhino tidak akan digunakan lagi dan semua eksekusi JavaScript kini akan menggunakan V8, mesin JavaScript performa tinggi open source Google.

Manfaat V8

Mesin JavaScript V8 menawarkan manfaat berikut:

• Performa: V8 jauh lebih cepat daripada Rhino, sehingga meningkatkan kecepatan eksekusi untuk tugas JavaScript Anda. Skrip dengan variabel berukuran besar dan komputasi yang kompleks dapat dieksekusi lebih cepat.
• Kepatuhan terhadap Standar: V8 mendukung ECMAScript 2024, sehingga memastikan kompatibilitas dan pemeliharaan yang lebih baik.
• Keamanan: V8 mendapatkan manfaat dari update dan peningkatan keamanan yang berkelanjutan, sehingga memberikan lingkungan yang lebih aman untuk integrasi Anda.
• Fitur Modern: V8 mendukung fitur JavaScript terbaru, sehingga Anda dapat memanfaatkan konstruksi dan library bahasa modern.

Memigrasikan tugas JavaScript yang ada ke V8

Untuk memigrasikan tugas JavaScript yang ada dan berjalan di Rhino ke V8, lakukan hal berikut:

1. Identifikasi integrasi yang dipublikasikan yang berisi tugas JavaScript dan batalkan publikasinya.
2. Untuk setiap JavaScript, klik Buka editor skrip dari panel konfigurasi tugas.

   Integrasi Aplikasi akan otomatis mengupdate skrip yang ada untuk menggunakan V8.

3. Tinjau dan uji kode JavaScript.
4. Publikasikan integrasi.

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:

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 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 Application Integration

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