Halaman ini diterjemahkan oleh Cloud Translation API.

Lihat konektor yang didukung untuk Integration Aplikasi.

Variabel

Variabel adalah elemen integrasi yang menyimpan dan mentransmisikan 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.

Jenis variabel

Integrasi Aplikasi mendukung empat jenis variabel:

Variabel integrasi: Melacak data selama seluruh eksekusi integrasi.
Variabel tugas: Melacak data selama durasi satu tugas.
Variabel konfigurasi: Menyimpan data konfigurasi integrasi.
Variabel sistem: Menyimpan data konfigurasi integrasi.

Variabel integrasi

Variabel integrasi 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 untuk integrasi (variabel input).
Ditampilkan sebagai output integrasi (variabel output).
Digunakan untuk menyimpan status sementara selama eksekusi 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
Array Ganda dan Ganda
Boolean dan array Boolean
JSON

Variabel tugas

Variabel tugas adalah variabel yang dibuat otomatis dan telah ditetapkan sebelumnya dari tugas. Jika tugas memiliki output, semua output tersebut tersedia dalam variabel tugas. Anda tidak dapat menghapus atau mengedit variabel tugas. Misalnya, untuk tugas Call REST Endpoint, isi respons disimpan dalam variabel responseBody.

Variabel konfigurasi

Variabel konfigurasi memungkinkan Anda mengeksternalisasi konfigurasi untuk integrasi. Dengan variabel konfigurasi, Anda dapat mengonfigurasi aspek integrasi seperti detail konektor, detail autentikasi, atau endpoint URL yang didasarkan pada lingkungan pengembangan (QA, staging, atau produksi). Anda tidak perlu mengupdate integrasi secara manual sebelum mengupload integrasi ke lingkungan baru. Integrasi Aplikasi memungkinkan Anda memasukkan nilai untuk variabel konfigurasi saat memublikasikan integrasi.

Untuk mempelajari cara membuat variabel konfigurasi dan menggunakannya, lihat tutorial Mem-build 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 penanganan error. Integrasi ini berisi variabel yang dibuat sistem berikut:

ErrorInfo: Jika eksekusi gagal, Anda dapat mengakses detail error dengan variabel ErrorInfo:
```
{
  "ErrorInfo": {
  "message": String,
  "code": Number
  }
}
```
Saat ini, Anda dapat mengakses pesan error dengan membuat variabel integrasi bernama ErrorMessage. Namun, sebaiknya gunakan variabel ErrorInfo.message yang dibuat 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 Variabel untuk membuat, mengedit, melihat, menduplikasi, dan menghapus variabel dalam integrasi. Panel Variables juga menampilkan jumlah total referensi variabel dalam integrasi.

Untuk melihat panel Variabel, klik (Alihkan panel) di menu navigasi desainer.

Gambar berikut menunjukkan contoh tata letak panel Variabel:

Variabel desainer integrasi

Membuat variabel

Untuk membuat variabel, lakukan langkah-langkah berikut:

Di menu navigasi editor integrasi, klik (Panel tombol) untuk menampilkan panel Variabel.
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 dieksekusi, 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`
Ganda	`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 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 sampel 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: Menghasilkan skema JSON menggunakan nilai default yang disediakan.
- Tidak ada: Tidak ada skema JSON.
Catatan: Kolom ini hanya ditampilkan untuk variabel jenis data JSON.
Sembunyikan variabel dalam log (pratinjau): Pilih opsi ini untuk mengaktifkan penyembunyian variabel dalam log eksekusi integrasi. Untuk mengaktifkan masking untuk variabel, Anda harus mengaktifkan variabel masking untuk integrasi dan region. Untuk informasi tentang cara mengaktifkan masking untuk integrasi dan region, lihat Mengedit integrasi dan Mengedit region.
Untuk informasi tentang penyamaran, lihat Menyamarkan data sensitif di log.

Klik Create.

Menggunakan variabel dalam integrasi

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

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

Referensi variabel

Tugas, pemicu, dan edge dalam integrasi membaca dan menulis ke variabel menggunakan referensi variabel. Referensi variabel memiliki bentuk $paramKey$ dengan paramKey adalah nama variabel. Misalnya, kondisional edge dapat terlihat seperti ini:

NOT ($isNameUnique$ = false OR $numAccounts$ > 1)

Dalam contoh ini, isNameUnique adalah variabel jenis data boolean dan numAccounts adalah parameter jenis data bilangan bulat.

Kuota dan batas

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

Langkah selanjutnya

Pelajari cara mem-build CI/CD untuk integrasi Anda.
Pelajari cara menyamar data sensitif di log.
Menambahkan dan mengonfigurasi Tugas Pemetaan Data