Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Variabel

Variabel adalah elemen integrasi yang menyimpan dan memindahkan data di antara tugas, pemicu, dan edge integrasi.

Variabel dapat ditentukan secara statis pada waktu desain atau diteruskan secara dinamis ke integrasi saat runtime.
Variabel dapat mereferensikan variabel lain dalam integrasi.
Variabel dapat diakses secara global oleh semua tugas, atau diakses secara lokal oleh tugas tertentu.

Variabel

Di Application Integration, variabel ditetapkan atau diinisialisasi di berbagai tempat:

Variabel konfigurasi: Ditetapkan pada waktu desain untuk menyimpan data konfigurasi integrasi. Misalnya, Anda dapat menggunakannya untuk menetapkan alamat email target untuk notifikasi, daripada melakukan hard code pada alamat email tersebut dalam integrasi.
Variabel sistem: Dibuat secara otomatis oleh sistem untuk menyimpan data konfigurasi integrasi. Misalnya, variabel ExecutionId menyimpan ID eksekusi integrasi.
Variabel integrasi: Ditetapkan secara eksplisit dalam integrasi Anda untuk melacak data selama seluruh eksekusi integrasi. Misalnya, Anda dapat menetapkan variabel untuk menyimpan hasil tugas dan menggunakannya dalam tugas berikutnya.
Variabel tugas: Ditetapkan secara implisit dengan menjalankan tugas tertentu untuk menyimpan output tugas. Misalnya, tugas Call REST Endpoint menetapkan variabel responseBody untuk menyimpan isi respons endpoint REST. Variabel tugas juga dikenal sebagai variabel yang dibuat otomatis. Variabel yang dibuat otomatis memiliki konvensi penamaan khusus yang menggunakan tanda kutip terbalik di sekitar nama variabel.

Variabel integrasi

Variabel integrasi, yang mencakup variabel input dan output, mirip dengan variabel yang digunakan dalam bahasa pemrograman. Data dalam variabel dapat dibaca dan ditulis selama eksekusi integrasi.

Variabel integrasi dapat digunakan dengan cara berikut:

Diambil sebagai input ke integrasi, yang juga dikenal sebagai variabel input.
Ditampilkan sebagai output integrasi, yang juga dikenal sebagai variabel output.
Digunakan untuk menyimpan status sementara selama eksekusi integrasi.

Saat Anda menandai variabel sebagai variabel input, Anda menunjukkan bahwa nilai variabel diharapkan akan diberikan saat integrasi dipicu. Nilai variabel input dapat diubah selama eksekusi integrasi.

Saat Anda menandai variabel sebagai variabel output, Anda menunjukkan bahwa nilai akhir variabel harus ditampilkan sebagai bagian dari respons integrasi.

Nilai variabel tidak harus ditentukan secara statis dalam integrasi. Nilai variabel dapat diteruskan ke integrasi melalui penggunaan pemicu. Namun, jika variabel ditentukan secara statis dalam integrasi, dan variabel yang sama disediakan secara dinamis dengan pemicu, penetapan nilai dinamis akan menimpa penetapan statis.

Jenis data yang didukung

Jenis data berikut didukung untuk variabel integrasi:

String dan Array string
Bilangan bulat dan Array bilangan bulat
Double dan Double array
Boolean dan array Boolean
JSON

Variabel tugas

Variabel tugas adalah variabel yang telah ditetapkan dan dibuat otomatis dari sebuah tugas. Jika tugas memiliki output, semua output tersebut tersedia dalam variabel tugas. Anda tidak dapat menghapus atau mengedit variabel tugas. Variabel tugas juga dikenal sebagai variabel yang dibuat otomatis.

Nama unik variabel tugas mengikuti konvensi penamaan khusus: menggunakan tanda kutip terbalik di sekitar nama variabel dan menyertakan ID Tugas. Formatnya adalah `<Task ID>_<Variable Name>`.

Misalnya, tugas Call REST Endpoint memiliki output untuk isi respons. Jika tugas ini memiliki ID Task_5, nama variabel tugas unik untuk isi respons adalah `Task_5_responseBody`.

Di panel Variables, variabel tugas mungkin dicantumkan berdasarkan nama output umum, misalnya, responseBody, tanpa ID Tugas atau tanda kutip terbalik. Untuk melihat nama variabel unik dan lengkap yang diperlukan untuk referensi, klik variabel di panel dan lihat detailnya di panel sebelah kanan.

Variabel konfigurasi

Variabel konfigurasi memungkinkan Anda mengeksternalkan konfigurasi untuk integrasi. Dengan variabel konfigurasi, Anda dapat mengonfigurasi aspek integrasi seperti nama koneksi, URL endpoint, atau nilai khusus lingkungan lainnya yang didasarkan pada lingkungan pengembangan, seperti QA, staging, atau produksi. Anda tidak perlu mengupdate integrasi secara manual sebelum mengupload integrasi ke lingkungan baru. Application Integration memungkinkan Anda memasukkan nilai untuk variabel konfigurasi saat memublikasikan integrasi.

Untuk melihat dan mengedit variabel konfigurasi yang ditentukan dalam integrasi Anda, klik variable_add Integration config variable di panel Variables. Untuk mempelajari cara membuat variabel konfigurasi dan menggunakannya, lihat tutorial Membangun CICD untuk integrasi Anda.

Variabel sistem

Variabel sistem dibuat secara otomatis saat Anda membuat integrasi. Anda dapat menggunakan variabel ini dalam tugas integrasi dan untuk menangani error. Integrasi ini berisi variabel yang dihasilkan sistem berikut:

ErrorInfo: Jika eksekusi gagal, Anda dapat mengakses detail error dengan variabel ErrorInfo:
```
{
  "ErrorInfo": {
  "message": String,
  "code": Number
  }
}
```
Anda dapat mengakses pesan error dengan membuat variabel integrasi bernama ErrorMessage. Namun, sebaiknya gunakan variabel ErrorInfo.message yang dihasilkan sistem untuk mengakses pesan error.
ExecutionMode: Mode eksekusi berdasarkan pemicu. Nilai yang valid adalah SYNC dan ASYNC.
ExecutionId: ID eksekusi integrasi.
IntegrationName: Nama integrasi.
Region: Region integrasi.
ProjectId: Project ID yang berisi integrasi.

Melihat variabel

Anda dapat menggunakan panel Variables untuk membuat, mengedit, melihat, menduplikasi, dan menghapus variabel dalam integrasi Anda. Panel Variables juga menampilkan jumlah total referensi variabel dalam integrasi.

Untuk melihat panel Variables, klik , panel Toggle, di menu navigasi desainer.

Gambar berikut menunjukkan contoh tata letak panel Variables:

Variabel desainer integrasi

Melihat dan mengedit variabel konfigurasi

Untuk melihat variabel konfigurasi yang ditentukan dalam integrasi Anda, klik variable_add Integration config variable di panel Variables. Tindakan ini akan memunculkan panel Config variables yang menampilkan semua variabel konfigurasi yang ditentukan dalam integrasi Anda. Anda cukup mengklik kolom Value untuk mengedit nilai variabel konfigurasi.

Gambar berikut menunjukkan contoh tata letak panel Config variables:

Variabel konfigurasi integrasi

Membuat variabel

Untuk membuat variabel, lakukan langkah-langkah berikut:

Di menu navigasi editor integrasi, klik , Panel tombol, untuk menampilkan panel Variables.
Klik +Create.

Lakukan hal berikut di panel Create Variable:

Nama: Masukkan nama variabel.
Jenis Variabel: Pilih jenis variabel.

Jenis data	Deskripsi
Tidak ada	Variabel lokal dalam integrasi.
Variabel konfigurasi untuk Integrasi	Variabel konfigurasi dalam integrasi.
Input ke Integrasi	Selama eksekusi, variabel akan diberikan sebagai input ke pemicu yang dieksekusi.
Output dari Integrasi	Nilai akhir variabel di akhir eksekusi harus menjadi output ke pemanggil integrasi.
Input dan Output Integrasi	Saat eksekusi, variabel akan diberikan sebagai input ke pemicu yang dieksekusi dan nilai akhirnya akan menjadi output ke pemanggil integrasi.

Jenis Data: Pilih jenis data variabel. Anda dapat mengidentifikasi jenis data variabel menggunakan ikon di samping nama variabel.

Jenis data	Contoh
String	`Alex`
Bilangan bulat	`30`
Double	`30.5`
Boolean	`true`
JSON	`{ "employee":{"name":"Alex", "age":30, "city":"Mountain View"} }`
Array string	`Alex, Kai, Raha`
Array bilangan bulat	`30, 25, 22`
Array ganda	`30.5, 25.34, 22.134`
Array Boolean	`true, false, false`

Untuk mengetahui informasi tentang jenis data yang didukung, lihat Jenis data yang didukung.

Nilai Default: Masukkan nilai default untuk variabel. Kolom ini bersifat opsional.
Skema: Pilih skema JSON untuk variabel.
- Infer from a sample JSON payload: Membuat skema JSON dari contoh payload JSON. Payload contoh akan dihapus setelah skema dibuat. Hanya skema yang dihasilkan yang akan disimpan.
- Masukkan skema JSON: Masukkan seluruh skema JSON secara manual.
- Infer from the default value: Membuat skema JSON menggunakan nilai default yang diberikan.
- None: Tidak ada skema JSON.
Catatan: Kolom ini hanya ditampilkan untuk variabel jenis data JSON.
Mask the variable in logs: Pilih opsi ini untuk mengaktifkan penyamaran variabel di log eksekusi integrasi. Untuk mengaktifkan penyamaran variabel, Anda harus mengaktifkan penyamaran variabel untuk integrasi dan region Anda. Untuk mengetahui informasi tentang cara mengaktifkan penyamaran untuk integrasi dan region, lihat Mengedit integrasi dan Mengedit region.
Opsi ini tidak didukung untuk variabel konfigurasi; nilai variabel konfigurasi tidak disamarkan dalam log eksekusi. Penyamaran hanya berlaku untuk log eksekusi; penyamaran tidak menyamarkan nilai saat Anda mendownload atau mengekspor integrasi. Lihat Menyamarkan data sensitif di log.

Klik Create.

Cara kerja variabel dalam integrasi

Selama eksekusi integrasi, data run-time diteruskan sebagai variabel yang dideklarasikan untuk integrasi atau tugas. Setelah eksekusi dimulai, data input akan dikonversi menjadi objek dalam memori yang disebut Peristiwa.

Setelah objek Event dibuat, grafik tugas dalam memori akan dibuat menggunakan definisi integrasi. Nilai variabel yang masuk diteruskan ke tugas berdasarkan konfigurasi Anda. Saat integrasi dijalankan, tugas akan membaca dan menulis data kembali ke objek Peristiwa,untuk digunakan oleh tugas berikutnya atau untuk membentuk data output integrasi.

Tabel berikut merangkum berbagai jenis variabel dan perilakunya:

Jenis variabel	Deskripsi	Perilaku	Contoh
Variabel konfigurasi	Menyimpan data konfigurasi integrasi.	Ditetapkan pada waktu desain dan dapat diedit saat Anda memublikasikan integrasi.	Alamat email target untuk notifikasi.
Variabel sistem	Dibuat secara otomatis oleh sistem.	Hanya baca dan tidak dapat diedit.	Variabel `ExecutionId`.
Variabel integrasi	Melacak data selama seluruh eksekusi integrasi.	Ditetapkan secara eksplisit dalam integrasi Anda dan dapat diedit selama eksekusi integrasi.	Variabel untuk menyimpan hasil tugas.
Variabel tugas	Menyimpan output tugas tertentu.	Ditetapkan secara implisit dengan menjalankan tugas dan tidak dapat diedit.	Variabel `responseBody` dari tugas Call REST Endpoint.

Referensi variabel

Tugas, pemicu, dan edge dalam integrasi membaca dan menulis ke variabel menggunakan referensi variabel. Referensi variabel menggunakan bentuk $paramKey$ dengan paramKey adalah nama variabel.

$isNameUnique$ = true AND $numAccounts$ >= 1

Contoh:

Kondisional edge dapat terlihat seperti ini:
```
$isNameUnique$ = true AND $numAccounts$ >= 1
```
Dalam contoh ini, isNameUnique adalah variabel jenis data boolean dan numAccounts adalah parameter jenis data integer.
Anda dapat membuat notifikasi email untuk pendaftaran pengguna baru dalam alur kerja Application Integration. Misalnya, Anda memiliki dua variabel:
- $userName$ : Menyimpan nama pengguna baru (misalnya, "Alex").
- $orderID$ : Berisi ID pesanan unik (misalnya, "ORD-12345").
Template untuk isi email dapat berupa:
```
Hello $userName$, thank you for your order! Your order ID is $orderID$.
```
Saat pesan ini dikirim, sistem akan mengganti referensi variabel dengan nilai yang sesuai. Pesan terakhirnya adalah:
```
Hello Alex, thank you for your order! Your order ID is ORD-12345.
```

Anda dapat menggunakan referensi variabel di tempat berikut:

Saat merujuk ke variabel yang dibuat otomatis atau variabel tugas, Anda harus menggunakan nama lengkap dan uniknya, yang menyertakan tanda kutip terbalik dan ID Tugas, dalam pembatas tanda dolar. Misalnya, untuk merujuk ke output responseBody dari tugas Call REST Endpoint dengan ID Task_5, Anda harus menggunakan $`Task_5_responseBody`$.

Kuota dan batas

Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.

Langkah berikutnya

Pelajari cara membangun CI/CD untuk integrasi Anda.
Pelajari cara menyamarkan data sensitif di log.
Tambahkan dan konfigurasikan tugas Pemetaan Data