Lihat konektor yang didukung untuk Integration Aplikasi.

Pemicu ServiceNow

Pemicu ServiceNow adalah Pemicu Peristiwa Konektor yang memungkinkan Anda memanggil integrasi berdasarkan peristiwa ServiceNow kustom yang telah Anda tentukan di aturan bisnis instance ServiceNow.

Penting: Konektor Integrasi adalah komponen Google Cloud yang dapat ditagih. Untuk mengetahui informasi tentang biaya dan tagihan penggunaan Integration Connectors, lihat Harga Integration Connectors.

Sebelum memulai

Jika Anda berencana membuat atau mengonfigurasi koneksi baru untuk pemicu ServiceNow, pastikan Anda memiliki peran IAM berikut di project:

• Connector Admin (roles/connectors.admin)

Untuk mengetahui informasi tentang cara memberikan peran, lihat Mengelola akses.

Berikan peran IAM berikut ke akun layanan yang ingin Anda gunakan untuk pemicu ServiceNow:

• Application Integration Invoker (roles/integrations.integrationInvoker)

Untuk informasi tentang cara memberikan peran ke akun layanan, lihat Mengelola akses ke akun layanan.

Menambahkan pemicu ServiceNow

Untuk menambahkan pemicu ServiceNow 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 Daftar 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 Pemicu untuk melihat daftar pemicu yang tersedia.
5. Klik dan tempatkan elemen pemicu ServiceNow di editor integrasi.

Untuk mengonfigurasi pemicu ServiceNow, Anda dapat menggunakan koneksi ServiceNow yang ada di Konektor Integrasi, atau membuat koneksi ServiceNow baru menggunakan opsi pembuatan koneksi inline.

Mengonfigurasi pemicu ServiceNow menggunakan koneksi yang ada

Anda dapat mengonfigurasi pemicu ServiceNow menggunakan koneksi ServiceNow yang ada di Konektor Integrasi. Perhatikan bahwa pemicu ServiceNow adalah pemicu Peristiwa Konektor, sehingga Anda hanya dapat menggunakan koneksi ServiceNow dengan langganan peristiwa yang diaktifkan untuk mengonfigurasi pemicu.

Untuk informasi tentang cara mengonfigurasi pemicu ServiceNow menggunakan koneksi ServiceNow baru, lihat Mengonfigurasi pemicu ServiceNow menggunakan koneksi baru

Untuk mengonfigurasi pemicu ServiceNow menggunakan koneksi ServiceNow yang ada, lakukan langkah-langkah berikut:

1. Klik elemen ServiceNow trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Konfigurasi pemicu.
3. Berikan detail konfigurasi berikut di halaman Editor Pemicu Peristiwa Konektor:
   1. Region: Pilih region koneksi ServiceNow Anda.
   2. Koneksi: Pilih koneksi ServiceNow yang ingin Anda gunakan.

      Integrasi Aplikasi hanya menampilkan koneksi ServiceNow yang aktif dan mengaktifkan langganan peristiwa.

   3. Jenis langganan peristiwa: Masukkan jenis peristiwa yang ingin Anda gunakan untuk memicu integrasi. Jenis peristiwa ini harus ditentukan di aturan bisnis instance ServiceNow Anda.
   4. Service Account: Pilih akun layanan dengan peran IAM yang diperlukan untuk pemicu ServiceNow.
4. Klik Selesai untuk menyelesaikan konfigurasi pemicu dan menutup halaman.

Mengonfigurasi pemicu ServiceNow menggunakan koneksi baru

Untuk mengonfigurasi pemicu ServiceNow menggunakan koneksi ServiceNow baru, lakukan langkah-langkah berikut:

1. Klik elemen ServiceNow trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Konfigurasi pemicu.
3. Lewati kolom Region.
4. Klik Connection, lalu pilih opsi Create Connection dari menu drop-down.
5. Selesaikan langkah-langkah berikut di panel Buat Koneksi:
   1. Pada langkah Location, pilih lokasi untuk koneksi ServiceNow baru:
      1. Region: Pilih region dari menu drop-down.
      2. Klik Berikutnya.
   2. Pada langkah Detail Koneksi, berikan detail tentang koneksi ServiceNow baru:
      1. Versi konektor: Pilih versi konektor ServiceNow yang tersedia dari menu drop-down.
      2. Nama Koneksi: Masukkan nama untuk koneksi ServiceNow.
         Catatan: Nama koneksi harus memenuhi kriteria berikut:

         • Nama koneksi dapat menggunakan huruf, angka, atau tanda hubung.
         • Huruf harus berupa huruf kecil.
         • Nama koneksi harus diawali dengan huruf dan diakhiri dengan huruf atau angka.
         • Nama koneksi tidak boleh melebihi 63 karakter.
      3. (Opsional) Deskripsi: Masukkan deskripsi untuk koneksi.
      4. (Opsional) Aktifkan Cloud Logging: Centang kotak ini untuk menyimpan semua data log koneksi.
      5. Service Account: Pilih akun layanan dengan peran IAM yang diperlukan untuk koneksi ServiceNow.
      6. Aktifkan langganan peristiwa: Pilih untuk membuat dan mengaktifkan langganan peristiwa baru untuk koneksi ServiceNow. Anda dapat hanya mengaktifkan langganan peristiwa atau juga menyertakan entity, operasi, dan tindakan koneksi.
         Catatan: Langkah-langkah konfigurasi koneksi tambahan berikut diperlukan jika Anda memilih untuk mengaktifkan entity, operasi, dan tindakan untuk koneksi:

         • Tujuan
         • Authentication
      7. Sertakan tabel sistem: Pilih untuk melaporkan atau menyertakan tabel sistem dalam koneksi.
      8. (Opsional) Filter tabel: Masukkan daftar tabel sistem (dimulai dengan "sys_", dipisahkan koma), yang ingin Anda sertakan.
      9. (Opsional) Luaskan Setelan lanjutan untuk mengonfigurasi setelan node koneksi.

         Untuk informasi selengkapnya tentang setelan node koneksi untuk ServiceNow, lihat dokumentasi Koneksi ServiceNow.

      10. (Opsional) Klik + Tambahkan label untuk menambahkan label ke koneksi dalam bentuk pasangan nilai kunci.
      11. Klik Berikutnya.
   3. Pada langkah Destinations, berikan detail instance ServiceNow:
      1. Jenis Tujuan: Pilih Alamat host.
      2. Host: Masukkan nama host atau alamat IP instance ServiceNow Anda.
      3. Klik Berikutnya.
   4. Pada langkah Autentikasi, berikan detail autentikasi untuk instance ServiceNow:
      1. Nama pengguna: Masukkan nama pengguna untuk mengakses alamat tujuan yang diberikan.
      2. Sandi: Pilih secret Secret Manager yang berisi sandi yang terkait dengan nama pengguna ServiceNow.
      3. Versi secret: Pilih versi secret.

      Untuk mengetahui lebih lanjut cara mengonfigurasi autentikasi, lihat Mengonfigurasi autentikasi.

      4. Klik Berikutnya.
   5. Pada langkah Detail langganan peristiwa, berikan detail autentikasi yang akan digunakan untuk memvalidasi payload token ServiceNow:
      1. Authentication Token: (Opsional) Pilih secret Secret Manager dari token autentikasi Anda, dan versi secret yang sesuai dari menu drop-down Secret Version.
      2. Algoritme HMAC: (Opsional) Pilih algoritma HMAC untuk mengenkripsi payload respons.
      3. Kunci Rahasia HMAC: Jika Anda telah memilih Algoritma HMAC, pilih secret Pengelola Secret dari kunci HMAC, dan versi secret yang sesuai dari drop-down Versi Secret.
      4. Klik Berikutnya.
   6. Tinjau: Tinjau detail koneksi ServiceNow yang diberikan.
   7. Klik Create untuk menyelesaikan pembuatan koneksi ServiceNow baru.
6. Setelah koneksi ServiceNow dibuat, Anda harus membuka instance ServiceNow dan membuat aturan bisnis secara manual.
   Catatan: ServiceNow tidak membuat aturan bisnis secara otomatis. Oleh karena itu, Anda harus membuat aturan bisnis secara manual di instance ServiceNow untuk mengaktifkan langganan peristiwa. Untuk mengetahui informasi tentang cara membuat aturan bisnis, lihat Membuat aturan bisnis.
7. Jenis langganan peristiwa: Masukkan jenis peristiwa yang ingin Anda gunakan untuk memicu integrasi. Jenis peristiwa ini harus ditentukan di aturan bisnis instance ServiceNow Anda.
8. Klik Selesai dan tutup halaman.

Membuat aturan bisnis

Aturan bisnis ServiceNow adalah logika sisi server yang dijalankan saat kumpulan data database dikueri, diperbarui, disisipkan, atau dihapus di instance ServiceNow Anda. Integrasi Aplikasi menggunakan aturan bisnis ini untuk mengidentifikasi dan memproses peristiwa yang memicu integrasi.

Untuk informasi tentang cara membuat aturan bisnis, lihat dokumentasi ServiceNow.

Poin Utama:

• Gunakan nilai Endpoint pemroses peristiwa dari koneksi ServiceNow di Konektor Integrasi untuk menentukan URL request.setEndpoint dalam aturan bisnis Anda.
• Gunakan eventType sebagai kunci untuk menentukan nilai jenis peristiwa kustom di request.setRequestBody.

Gambar berikut menunjukkan contoh aturan bisnis ServiceNow dengan jenis peristiwa update_ticket:

Output pemicu

Pemicu ServiceNow memerlukan waktu beberapa menit untuk menyelesaikan konfigurasi langganan peristiwa. Anda dapat melihat status langganan peristiwa di panel konfigurasi pemicu pada bagian Detail Langganan Peristiwa.

Pemicu ServiceNow menunjukkan status langganan peristiwa menggunakan status berikut:

• Creating: Menunjukkan bahwa pemicu berlangganan langganan peristiwa.
• Active: Menunjukkan bahwa pemicu berhasil berlangganan langganan peristiwa.
• Error: Menunjukkan bahwa ada masalah dengan langganan peristiwa yang dikonfigurasi.

Selain status langganan peristiwa, bagian Detail Langganan Peristiwa juga menampilkan detail lainnya seperti wilayah koneksi, nama koneksi, nama langganan peristiwa, dan lainnya.

Gambar berikut menunjukkan contoh tata letak panel konfigurasi pemicu ServiceNow:

Memicu variabel output

Untuk setiap peristiwa, pemicu ServiceNow menghasilkan variabel output ConnectorEventPayload yang dapat Anda gunakan dalam tugas downstream. Variabel output dalam format JSON yang berisi skema payload ServiceNow output.

Melihat langganan peristiwa

Untuk melihat dan mengelola semua langganan peristiwa yang terkait dengan koneksi di Konektor Integrasi, lakukan hal berikut:

1. Buka halaman Integration Connectors > Connections.

   Buka halaman Koneksi

2. Klik koneksi yang langganannya ingin Anda lihat.
3. Klik tab Langganan peristiwa.

   Tindakan ini akan menampilkan semua langganan peristiwa untuk koneksi.

Mengedit pemicu ServiceNow

Anda dapat mengedit pemicu ServiceNow untuk mengubah atau memperbarui konfigurasi koneksi dan detail langganan peristiwa.

Penting: Saat mengedit atau mengubah pemicu ServiceNow, Anda dapat mempertahankan langganan peristiwa yang dikonfigurasi sebelumnya dan dilampirkan ke pemicu, atau Anda dapat menghapusnya. Menghapus langganan peristiwa akan memengaruhi semua integrasi yang dipublikasikan menggunakan langganan peristiwa tersebut.

Untuk mengedit pemicu ServiceNow, lakukan langkah-langkah berikut:

1. Klik elemen ServiceNow trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Konfigurasi pemicu ServiceNow.
3. Lakukan tindakan berikut di halaman Editor Pemicu Peristiwa Konektor:
   1. Untuk mempertahankan langganan peristiwa yang dikonfigurasi sebelumnya, klik Pertahankan, atau klik Hapus.
      Peringatan: Menghapus langganan peristiwa akan memengaruhi semua integrasi yang dipublikasikan menggunakan langganan peristiwa tersebut. Tugas ini tidak dapat diurungkan.
   2. Perbarui konfigurasi koneksi dan detail langganan peristiwa sesuai keinginan.
   3. Klik Done.

Anda dapat melihat detail koneksi dan langganan peristiwa yang diperbarui di panel konfigurasi pemicu di bagian Detail Langganan Peristiwa.

Kuota dan batas

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

Langkah selanjutnya

• Pelajari semua tugas dan pemicu.
• Pelajari cara menguji dan memublikasikan integrasi.
• Pelajari penanganan error.
• Pelajari log eksekusi integrasi.