Lihat konektor yang didukung untuk Application Integration.

Pemicu Cloud Jira

Pemicu Jira Cloud adalah Pemicu Peristiwa Konektor yang memungkinkan Anda memanggil integrasi berdasarkan peristiwa Jira Cloud yang telah Anda ikuti di koneksi Jira Cloud.

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

Sebelum memulai

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

• Admin Konektor (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 Jira Cloud:

• Invoker Integrasi Aplikasi (roles/integrations.integrationInvoker)

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

Menambahkan pemicu Cloud Jira

Untuk menambahkan pemicu Jira Cloud ke integrasi Anda, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Application Integration.

   Buka Application Integration

2. Di menu navigasi, klik Integrasi

   Halaman Integrations List akan muncul dan 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 Create Integration.
   2. Pilih region untuk integrasi.
      Catatan: Dropdown Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, klik Aktifkan Wilayah. Lihat Mengaktifkan wilayah baru untuk informasi selengkapnya.
   3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Integration summary 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 Jira Cloud trigger di editor integrasi.

Untuk mengonfigurasi pemicu Jira Cloud, Anda dapat menggunakan koneksi Jira Cloud yang ada di Integration Connectors, atau membuat koneksi Jira Cloud baru menggunakan opsi pembuatan koneksi inline.

Mengonfigurasi pemicu Jira Cloud menggunakan koneksi yang ada

Anda dapat mengonfigurasi pemicu Jira Cloud menggunakan koneksi Jira Cloud yang ada di Integration Connectors. Perhatikan bahwa pemicu Jira Cloud adalah pemicu Peristiwa Konektor, sehingga Anda hanya dapat menggunakan koneksi Jira Cloud dengan langganan peristiwa yang diaktifkan untuk mengonfigurasi pemicu.

Untuk mengetahui informasi tentang cara mengonfigurasi pemicu Jira Cloud menggunakan koneksi Jira Cloud baru, lihat Mengonfigurasi pemicu Jira Cloud menggunakan koneksi baru

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

1. Klik elemen Jira Cloud 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 Cloud Jira Anda.
   2. Connection: Pilih koneksi Jira Cloud yang ingin Anda gunakan.

      Application Integration hanya menampilkan koneksi Jira Cloud yang aktif dan memiliki langganan peristiwa aktif.

   3. Jenis langganan acara: Pilih jenis langganan acara yang memicu integrasi. Untuk mengetahui informasi tentang jenis langganan peristiwa yang didukung untuk pemicu ini, lihat Jenis langganan peristiwa yang didukung.
   4. Akun Layanan: Pilih akun layanan dengan peran IAM yang diperlukan untuk pemicu Jira Cloud.
4. Klik Selesai untuk menyelesaikan konfigurasi pemicu dan menutup halaman.

Mengonfigurasi pemicu Jira Cloud menggunakan koneksi baru

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

1. Klik elemen Jira Cloud 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 di menu drop-down.
5. Selesaikan langkah-langkah berikut di panel Create Connection:
   1. Pada langkah Location, pilih lokasi untuk koneksi Jira Cloud baru:
      1. Region: Pilih wilayah dari menu drop-down.
      2. Klik Next.
   2. Pada langkah Connection Details, berikan detail tentang koneksi Jira Cloud baru:
      1. Versi konektor: Pilih versi konektor Jira Cloud yang tersedia dari menu drop-down.
      2. Connection Name: Masukkan nama untuk koneksi Jira Cloud.
         Catatan: Nama koneksi harus memenuhi kriteria berikut:

         • Nama koneksi dapat menggunakan huruf, angka, atau tanda hubung.
         • Huruf harus kecil.
         • Nama koneksi harus dimulai dengan huruf dan diakhiri dengan huruf atau angka.
         • Nama koneksi tidak boleh lebih dari 63 karakter.
      3. (Opsional) Deskripsi: Masukkan deskripsi untuk koneksi.
      4. (Opsional) Aktifkan Cloud Logging: Centang kotak ini untuk menyimpan semua data log koneksi.
      5. Akun Layanan: Pilih akun layanan dengan peran IAM yang diperlukan untuk koneksi Jira Cloud.
      6. Enable event subscription: Pilih untuk membuat dan mengaktifkan langganan peristiwa baru untuk koneksi Jira Cloud. Anda hanya dapat mengaktifkan langganan acara 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. (Opsional) Luaskan Setelan lanjutan untuk mengonfigurasi setelan node koneksi.

         Untuk mengetahui informasi selengkapnya tentang setelan node koneksi untuk Jira Cloud, lihat dokumentasi Koneksi Cloud Jira.

      8. (Opsional) Klik + Tambahkan label untuk menambahkan label ke koneksi dalam bentuk pasangan nilai kunci.
      9. Klik Next.
   3. Di langkah Tujuan, berikan detail akun Jira Cloud:
      1. Jenis Tujuan: Pilih Alamat host.
      2. Host: Masukkan nama host atau alamat IP akun Jira Cloud Anda.
      3. Klik Next.
   4. Pada langkah Authentication, berikan detail autentikasi untuk akun Jira Cloud:
      1. Nama pengguna: Masukkan nama pengguna untuk mengakses alamat tujuan yang diberikan.
      2. Token API: Pilih rahasia Secret Manager yang berisi Token API yang terkait dengan nama pengguna Jira Cloud.
      3. Secret version: Pilih versi rahasia.

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

      4. Klik Next.
   5. Pada langkah Detail langganan acara, berikan detail akun Jira Cloud tempat langganan peristiwa akan dibuat.
      1. Jenis Tujuan: Pilih Alamat host.
      2. Host: Masukkan URL pendaftaran akun Jira Cloud Anda. Langganan acara akan dibuat untuk URL ini.
      3. Nama pengguna: Masukkan nama pengguna untuk mengakses URL pendaftaran yang diberikan.
      4. Token API: Pilih rahasia Secret Manager yang berisi token API yang terkait dengan nama pengguna.
      5. Secret version: Pilih versi rahasia.
      6. Klik Next.
   6. Peninjauan: Tinjau detail koneksi Jira Cloud yang diberikan.
   7. Klik Create untuk menyelesaikan pembuatan koneksi Jira Cloud baru.
6. Jenis langganan acara: Pilih jenis langganan acara yang memicu integrasi. Untuk mengetahui informasi tentang jenis langganan peristiwa yang didukung untuk pemicu ini, lihat Jenis langganan peristiwa yang didukung.
7. Klik Selesai dan tutup halaman.

Output pemicu

Pemicu Jira Cloud memerlukan waktu beberapa menit untuk menyelesaikan konfigurasi langganan peristiwa. Anda dapat melihat status langganan peristiwa di panel konfigurasi pemicu di bagian Detail Langganan Acara.

Pemicu Jira Cloud menunjukkan status langganan peristiwa menggunakan status berikut:

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

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

Gambar berikut menunjukkan contoh tata letak panel konfigurasi pemicu Cloud Jira:

Variabel output pemicu

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

Lihat langganan acara

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

1. Buka halaman Integration Connectors > Connections.

   Buka halaman Connections

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

   Ini akan menampilkan semua langganan peristiwa untuk koneksi tersebut.

Edit pemicu Jira Cloud

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

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

Untuk mengedit pemicu Cloud Jira, lakukan langkah-langkah berikut:

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

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

Jenis langganan acara yang didukung

Anda dapat menggunakan pemicu Jira Cloud untuk memanggil integrasi untuk jenis langganan peristiwa berikut:

Jenis langganan acara	Deskripsi
attachment_created	Lampiran dibuat untuk tiket Jira.
attachment_deleted	Lampiran yang terkait dengan tiket Jira akan dihapus.
board_created	Papan Jira baru akan dibuat.
board_deleted	Board Jira akan dihapus.
comment_created	Komentar akan ditambahkan ke tiket Jira.
comment_deleted	Komentar di tiket Jira akan dihapus.
comment_updated	Komentar yang ada di tiket Jira akan diperbarui.
filter_created	Filter Jira baru akan dibuat.
filter_deleted	Filter Jira akan dihapus.
filter_updated	Filter Jira yang ada telah diperbarui.
issue_created	Masalah Jira baru dibuat.
issue_deleted	Masalah Jira telah dihapus.
issue_updated	Masalah Jira yang ada telah diperbarui.
issuelink_created	Link masalah baru akan dibuat untuk instance Jira.
issuelink_deleted	Link masalah untuk instance Jira dihapus.
option_issuelinks_changed	Link masalah yang ada untuk instance Jira telah diubah atau diperbarui.
option_subtasks_changed	Subtugas untuk masalah diperbarui atau diubah.
option_voting_changed	Jumlah suara untuk masalah Jira telah diubah.
option_watching_changed	Watcher atau daftar pengguna yang ditambahkan untuk menonton masalah Jira telah berubah.
project_created	Project baru dibuat.
project_deleted	Project dihapus.
project_restored_deleted	Project yang dihapus akan dipulihkan.
project_soft_deleted	Project dihapus sedemikian rupa sehingga tidak terlihat oleh pengguna mana pun, termasuk admin yang menggunakan antarmuka produk atau API.
project_updated	Detail project diperbarui.
sprint_closed	{i>Sprint <i}telah ditutup.
sprint_created	{i>Sprint<i} telah dibuat.
sprint_deleted	{i>Sprint<i} dihapus.
sprint_updated	Detail {i>sprint<i} diubah atau diperbarui.
user_created	Pengguna dibuat.
user_updated	Detail pengguna diubah atau diperbarui.
worklog_created	Entri {i>worklog<i} ditambahkan.
worklog_deleted	Entri {i>worklog<i} dihapus.
worklog_updated	Entri {i>worklog<i} diubah atau diperbarui.