> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Desain alur kerja kartu keren

> Pelajari cara menggunakan Integrasi & Otomatisasi YiDA untuk membangun skenario pengumpulan masukan team building — mulai dari pemicu peristiwa formulir, pemicu kartu manual, hingga konfigurasi node Kirim kartu dan Perbarui kartu.

## Tentang alur kerja kartu keren

Kartu dikirim dan diperbarui melalui **Integrasi & Otomatisasi**. Bagian berikut memandu skenario "pengumpulan masukan team building" untuk menunjukkan cara mengimplementasikannya dengan integrasi & otomatisasi.

## Skenario bisnis

1. Tersedia formulir "Pengumpulan masukan team building". Setelah karyawan mengirim formulir, konten yang dikirim akan diteruskan ke obrolan grup sebagai kartu.
2. Karyawan lain dapat melihat kartu tersebut di grup, memberikan Suka, atau mengirim masukan team building mereka sendiri.

**Contoh formulir:**

**Contoh kartu di grup:**

#### 1. Integrasi & Otomatisasi

**Integrasi & Otomatisasi**: sebuah **orkestrasi/alur kerja bisnis** yang dipicu oleh sebuah **peristiwa**.

Mengirim formulir "Masukan team building" dan mengirim kartu ke grup — dalam skenario ini, pengiriman formulir adalah "peristiwa", sedangkan pengiriman kartu ke grup adalah "alur kerja".

Untuk informasi selengkapnya tentang integrasi & otomatisasi, lihat [Integrasi & Otomatisasi](/id/yida/integration/gqmveiswrxkgxu9s). Artikel ini berfokus pada cara mengirim dan memperbarui kartu melalui integrasi & otomatisasi.

**Titik masuk Integrasi & Otomatisasi**

**Contoh alur kerja untuk "Kirim kartu team building"**

#### 2. Pemicu peristiwa formulir

**Fitur**: memicu alur kerja saat formulir dikirim, diperbarui, atau dihapus.

Contoh skenario: Tersedia formulir "Pengumpulan masukan team building". Setelah karyawan mengirim formulir, konten yang dikirim akan diteruskan ke obrolan grup sebagai kartu.

1. Buat integrasi & otomatisasi dengan "Pemicu peristiwa formulir": klik Buat > masukkan nama > pilih formulir "Pengiriman masukan team building".

2. Masuk ke perancang alur kerja dan pilih pemicu peristiwa formulir.

3. Tambahkan node "Kirim kartu".

4. Konfigurasikan node "Kirim kartu", meliputi "Pilih kartu" -> "Konfigurasi konten kartu" -> "Konfigurasi atribut". Untuk detail setiap item konfigurasi, lihat bagian 4, "[Konfigurasi node Kirim kartu](#4-send-card-node-configuration)".

#### 3. Pemicu kartu manual

**Fitur**: memicu alur kerja saat tombol pada kartu diklik.

Contoh skenario: Seorang karyawan melihat kartu masukan team building di grup dan mengklik tombol "Suka" untuk menambahkan Suka.

1. Buat integrasi & otomatisasi dengan "Pemicu kartu manual": klik Buat > masukkan nama > pilih formulir "Pengiriman masukan team building".

Aturan pemilihan formulir: karena kartu dikirim oleh alur kerja **pemicu peristiwa formulir**, formulir yang dipilih untuk **pemicu kartu manual** harus **sama dengan formulir yang dipilih untuk pemicu peristiwa formulir** agar konteks kartu tetap konsisten.

2. Masuk ke perancang alur kerja dan tambahkan node "Ambil satu rekam" untuk menyaring rekam masukan team building yang jumlah Suka-nya akan diperbarui.

3. Tambahkan node "Perbarui data" untuk memperbarui jumlah Suka pada masukan team building yang telah disaring pada node "Ambil satu rekam" sebelumnya.

4. Tambahkan node "Perbarui kartu" untuk memperbarui jumlah Suka pada kartu terkait di grup ke nilai terbaru.

#### 4. Konfigurasi node Kirim kartu

Bagian ini berfokus pada konfigurasi node kartu. Perlu diperhatikan bahwa ini adalah konfigurasi kartu, bukan desain kartu. Untuk desain kartu, lihat dokumen [Desain kartu keren](/id/yida/cool-app/pqnynb).

Kartu memiliki tiga elemen: **gaya**, **data**, dan **tombol/tautan**. Desain kartu terutama menangani **gaya**, sedangkan konfigurasi kartu berfokus pada dua elemen lainnya (**data, tombol/tautan**).

Langkah konfigurasi: 1) pilih kartu yang akan dikirim/diperbarui; 2) ikat data ke kartu; 3) konfigurasikan tindakan tombol/tautan kartu; 4) tetapkan cakupan dan aturan pengiriman.

**1) Pilih kartu yang akan dikirim/diperbarui**

Pilih templat kartu resmi atau templat kartu kustom. Setelah memilih, klik "Buka pratinjau kartu" untuk melihat pratinjau gaya kartu.

**2) Ikat data ke kartu**

Ikat data yang diperoleh dari setiap node dalam alur kerja ke variabel data terkait pada kartu. (Tiga elemen kartu: gaya, variabel data, tombol/tautan.)

**3) Konfigurasikan tindakan tombol/tautan kartu**

Tombol kartu dapat diikat ke alur kerja "[Pemicu kartu manual](#3-manual-card-trigger)" atau ke sebuah tautan.

Apakah tombol diikat ke tautan atau ke alur kerja ditentukan saat desain kartu.

Saat merancang kartu, klik tombol dapat dipetakan ke berbagai jenis peristiwa. Umumnya, pilih **Tindakan kustom** atau **Pengalihan tautan**.

**Tindakan kustom**: mengikat alur kerja "Pemicu kartu manual". Mengklik tombol akan menjalankan alur kerja terkait.

**Pengalihan tautan**: mengklik tombol akan membuka tautan terkait. Nilai tautan dapat berupa nilai tetap (dimasukkan saat desain kartu) atau variabel (dikonfigurasi pada node kartu di integrasi & otomatisasi).

**4) Tetapkan cakupan dan aturan pengiriman**

Cakupan pengiriman kartu: kirim ke pengguna individu atau ke grup.

Grup dapat diatur ke "Grup saat ini".

"Grup saat ini": setelah Cool App diinstal di sebuah grup, ketika data formulir dikirim melalui tautan formulir di grup tersebut, mengatur target ke "Grup saat ini" akan mengirim kartu ke grup tempat formulir dikirim.

Aturan pengiriman kartu:

Skenario 1: kirim satu kartu untuk setiap rekam formulir yang dikirim — pilih bidang "ID instans formulir".

Skenario 2: kirim hanya satu kartu per hari untuk semua rekam formulir yang dikirim pada hari itu — pilih bidang yang merepresentasikan tanggal saat ini.

#### 5. Konfigurasi node Perbarui kartu

Kartu memiliki satu fitur khas: kontennya dapat diperbarui. Inilah yang membedakannya dari obrolan biasa dan mencegah grup terbanjiri pesan.

Langkah konfigurasi Perbarui kartu: 1) pilih kartu yang akan diperbarui; 2) tetapkan aturan pembaruan kartu; 3) konfigurasikan data yang akan diperbarui.

Dua poin penting:

1. Sebuah kartu harus dikirim terlebih dahulu sebelum dapat diperbarui.

2. Bidang yang dikonfigurasi pada **aturan pembaruan kartu** harus cocok dengan bidang yang dikonfigurasi pada **aturan pengiriman kartu** di **node Kirim kartu** agar kartu yang benar dapat diperbarui.

## Praktik terbaik lainnya (contoh konfigurasi aktivitas pemesanan makan)

Pada "Cool App pemesanan makan", baik "Memulai aktivitas pemesanan makanan sehat" maupun "Bergabung dengan aktivitas pemesanan makanan sehat" memerlukan pengenal Unik (nomor seri) untuk menautkan dan menandai aktivitas. Lalu, bagaimana cara mengonfigurasi nomor seri ini?

**1. Memulai aktivitas pemesanan makanan sehat**

Pertama, aktifkan fitur nomor seri pada formulir "Memulai aktivitas pemesanan makanan sehat" dan tetapkan aturan nomor seri. Klik Pengaturan halaman -> Pengaturan dasar -> Pengaturan Premium -> Buat nomor seri otomatis setelah pengguna mengirim formulir/alur kerja, lalu simpan.

Selanjutnya, tambahkan Komponen "Kotak Teks satu baris" ke formulir "Memulai aktivitas pemesanan makanan sehat" sebagai "Nomor seri aktivitas", atur ke "Tersembunyi", dan atur pengiriman data ke "Selalu kirim".

Terakhir, tambahkan peristiwa formulir global yang menggunakan fungsi `SETSERIALNO(Nomor seri aktivitas)` untuk membuat nomor seri secara otomatis. Setelah instans formulir baru dikirim, sistem otomatis membuat nomor seri dan mengisi nilainya ke dalam kotak teks. Semua pengaturan selanjutnya akan mencocokkan dan mengasosiasikan rekam berdasarkan nomor seri ini.

**2. Bergabung dengan aktivitas pemesanan makanan sehat**

Pertama, pada formulir "Bergabung dengan aktivitas pemesanan makanan sehat", tambahkan juga Komponen "Kotak Teks satu baris" sebagai "Nomor seri aktivitas", atur ke "Tersembunyi", dan atur pengiriman data ke "Selalu kirim".

Kemudian, pada fungsi `didMount`, ambil parameter `serialNumber` dari `url` dan tetapkan nilainya ke Komponen "Nomor seri aktivitas". Di sini, `textField_l3wp3mge` adalah `fieldId` dari Komponen "Nomor seri aktivitas".

```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
export function didMount() {
  if (this.$('textField_l3wp3mge')) {
    this.$('textField_l3wp3mge').setValue((this.state.urlParams || {}).serialNumber);
  }
}
```

**3. Pengaturan Integrasi & Otomatisasi**

Pertama, pada konfigurasi integrasi & otomatisasi "Memulai aktivitas", tambahkan parameter "Nomor seri sistem" (nomor seri yang dibuat di atas) ke tombol pada kartu agar nomor seri diteruskan ke formulir.

Kemudian, pada konfigurasi integrasi & otomatisasi "Pengguna mengirim pesanan", saring "Aktivitas pemesanan makan yang sedang berjalan" berdasarkan "Nomor seri aktivitas".

Pada node "Ambil daftar pengguna pemesanan makan", cocokkan daftar pengguna pemesanan makan terkait berdasarkan "Nomor seri aktivitas" yang dikirim dari formulir saat ini.

Pada "Kartu Kanban ringkasan data pesanan", tambahkan juga parameter nomor seri ke tombol "Lihat pesanan" dan "Analisis mendalam" agar formulir dapat mengambilnya untuk penyaringan dan analisis data.