> ## 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.

# Asosiasi Organisasi

> Pelajari cara menggunakan fitur Asosiasi Organisasi di DingTalk Interconnection Platform untuk menghubungkan Kontak lintas organisasi, mengintegrasikan Aplikasi, serta memperlancar komunikasi antara organisasi induk dan cabang di YiDA.

## 1. Kasus penggunaan

Sebagai salah satu komponen produk "DingTalk Interconnection Platform", fitur "Asosiasi Organisasi" menyediakan kemampuan manajemen Struktur Organisasi yang kuat untuk organisasi menengah dan besar. Fitur ini membantu Pengguna **menghubungkan Kontak lintas organisasi, mengintegrasikan Aplikasi, serta menjalin komunikasi dan kolaborasi tanpa hambatan antara organisasi induk dan cabang**.

* Komunikasi lintas organisasi, Persetujuan bisnis, dan pelaporan pekerjaan.
* Manajemen izin multi-organisasi dengan sinkronisasi struktur Pengguna secara real-time untuk meningkatkan efisiensi manajemen.

## 2. Langkah implementasi

### 2.1 Langkah pertama: Desain Formulir dasar

#### 2.1.1 Buat dan konfigurasikan Formulir kueri

**Langkah-langkah:**

1. Buat formulir biasa dan beri nama "Dapatkan Info Organisasi".
2. Tambahkan Komponen Pilih dropdown, beri nama "Target", lalu tambahkan dua opsi: "Kueri Organisasi Induk" dan "Kueri Organisasi Cabang". Atur sebagai Wajib. (Lihat Gambar 2.1-1)

Gambar 2.1-1 Menambah dan mengonfigurasi Komponen Pilih dropdown

3. Klik tombol "Simpan" di sudut kanan atas Halaman.

#### 2.1.2 Buat dan konfigurasikan Tabel Rekam Hasil Kueri

**Langkah-langkah:**

1. Buat formulir biasa dan beri nama "Rekam Hasil Kueri Organisasi Induk".
2. Tambahkan Komponen Teks multi-baris, beri nama "Hasil Pengembalian Konektor", lalu atur statusnya ke "Tersembunyi". (Lihat Gambar 2.1-2)

Gambar 2.1-2 Menambah dan mengonfigurasi Komponen Teks multi-baris

3. Tambahkan Komponen subformulir, beri nama "Hasil Kueri Organisasi Induk", lalu atur statusnya ke "Hanya Baca". (Lihat Gambar 2.1-3)

Gambar 2.1-3 Menambah dan mengonfigurasi Komponen subformulir

4. Di dalam subformulir, tambahkan dua field Teks satu baris dengan nama "Nama Organisasi Induk" dan "CorpID Organisasi Induk", lalu atur statusnya ke "Hanya Baca". (Lihat Gambar 2.1-4)

Gambar 2.1-4 Menambah dan mengonfigurasi Komponen Teks satu baris

5. Buka "panel aksi JS" di sisi kiri Halaman dan tambahkan kode berikut ke Fungsi didMount. (Lihat Gambar 2.1-5)

Gambar 2.1-5 Mengonfigurasi konten panel JS

```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
// Kode yang ditunjukkan pada Gambar 2.1-5
// Ambil data Komponen Teks multi-baris dan tetapkan ke variabel res
// "textareaField_kwlgqhti" perlu diganti dengan pengenal unik dari Teks multi-baris yang Anda buat
const res = this.$("textareaField_kwlgqhti").getValue();
// Konversi format data dari string ke object
  let obj = JSON.parse(res);
// Buat array kosong bernama arr untuk menyimpan data yang telah diproses.
  let arr = [];
// Iterasi object untuk mendapatkan field yang perlu ditampilkan
  const list = obj.map(item => {
    let object = {};
// "textField_kwlgqhtk" dan "textField_kwlgqhtl" adalah pengenal unik dari dua Komponen Teks satu baris di dalam subformulir
// Keduanya perlu diganti dengan pengenal unik dari Teks satu baris yang Anda buat
    object.textField_kwlgqhtk = item.union_org_name;
    object.textField_kwlgqhtl = item.union_corpid;
    arr.push(object);
  })
// Tulis kembali data arr yang telah diproses ke dalam Komponen subformulir
// "tableField_kwlgqhtj" adalah pengenal unik dari Komponen subformulir
// Ganti dengan pengenal unik dari Komponen subformulir yang Anda buat
  this.$("tableField_kwlgqhtj").setValue(arr);
```

6. Klik tombol "Simpan" di sudut kanan atas Halaman.
7. Ulangi langkah 1-6 untuk membuat "Rekam Hasil Kueri Organisasi Cabang". (Lihat Gambar 2.1-6)

Gambar 2.1-6 Membuat Formulir "Rekam Hasil Kueri Organisasi Cabang"

### 2.2 Langkah kedua: Buat dan konfigurasikan Konektor

<Note>
  Untuk pengantar fitur Konektor YiDA, lihat: [Integrasi & Otomatisasi - Konektor](/id/yida/integration/gqmveiswrxkgxu9s)
</Note>

Buat Konektor untuk Formulir "Dapatkan Info Organisasi" guna mengambil informasi Organisasi yang terkait.

**Langkah-langkah:**

1. Halaman manajemen backend >> "Dapatkan Info Organisasi" >> "Integrasi & Otomatisasi" >> "Buat Integrasi & Otomatisasi". (Lihat Gambar 2.2-1)

Gambar 2.2-1 Entri Konektor

2. Beri nama Konektor "Kueri Info Asosiasi Organisasi", pilih "Pemicu Peristiwa Formulir" sebagai Jenis pemicu, lalu klik "Konfirmasi".

(Lihat Gambar 2.1-2)

Gambar 2.2-2 Membuat Konektor

3. Beri nama Konektor "Kueri Info Asosiasi Organisasi" >> Pilih "Buat Berhasil" di bawah "Pemicu Peristiwa Formulir" >> Pilih "Semua Data" di bawah "Filter data" >> Klik "Konfirmasi". (Lihat Gambar 2.2-3)

Gambar 2.2-3 Mengonfigurasi pemicu Peristiwa Formulir Konektor

4. Tambahkan node "Cabang Kondisional": ketika aturan Kondisi Target sama dengan "Kueri Organisasi Induk", tambahkan Konektor "Dapatkan Organisasi Induk" dan node data "Buat Data"; jika tidak, tambahkan Konektor "Dapatkan Organisasi Cabang" dan node data "Buat Organisasi". (Lihat Gambar 2.2-4)

Gambar 2.2-4 Menambah dan mengonfigurasi kondisi cabang

5. Konfigurasikan Konektor di bawah "Cabang 1".

Gambar 2.2-5 Memilih Aplikasi Konektor di bawah "Cabang 1"

Gambar 2.2-6 Memilih tindakan eksekusi Konektor untuk "Cabang 1"

Gambar 2.2-7 Mengonfigurasi tindakan eksekusi Konektor di bawah "Cabang 1"

6. Konfigurasikan node "Buat Data" untuk "Cabang 1". (Lihat Gambar 2.2-8)

Gambar 2.2-8 Menambah dan mengonfigurasi node "Buat Data" di bawah "Cabang 1"

7. Konfigurasikan Konektor di bawah "Cabang 2".

Gambar 2.2-9 Memilih Aplikasi Konektor di bawah "Cabang 2"

Gambar 2.2-10 Memilih tindakan eksekusi Konektor di bawah "Cabang 2"

Gambar 2.2-11 Mengonfigurasi tindakan eksekusi Konektor di bawah "Cabang 2"

8. Konfigurasikan node "Buat Data" di bawah "Cabang 2". (Lihat Gambar 2.2-12)

Gambar 2.2-12 Mengonfigurasi node "Buat Data" di bawah "Cabang 2"

9. Klik tombol "Simpan" di sudut kanan atas Halaman, lalu klik "Publikasikan".

### 2.3 Langkah ketiga: Kirim Data Formulir

Picu Konektor, terima data yang dikembalikan oleh Konektor, dan tampilkan setelah diproses.

**Langkah-langkah:**

Isi Data Formulir dan kirim. (Lihat Gambar 2.3-1)

Gambar 2.3-1 Mengirim Data Formulir

## 3. Pratinjau hasil

Gambar 3-1 Pratinjau hasil Konektor