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

# Departemen

> Pelajari cara mengonfigurasi komponen Departemen di YiDA — mode Pilih Banyak, Pilih semua, tampilan jalur penuh, hingga fitur kueri Premium berbasis Struktur Organisasi untuk formulir dan alur kerja.

## 1. Komponen Departemen

### 1.1 Apa itu Komponen Departemen

Komponen yang memungkinkan Anda memilih Departemen tempat Pengguna berada.

Tambah Komponen Departemen

### 1.2 Contoh Penggunaan

Mengambil Departemen tempat Pengguna berada. Secara Default, komponen ini menampilkan Departemen Pengguna yang sedang masuk.

### 1.3 Fitur Kueri Premium

* Saat menggunakan Komponen Departemen YiDA di klien desktop DingTalk atau di peramban web, tersedia fitur kueri Premium baru yang mendukung Pilih berdasarkan struktur pohon Kontak serta kemampuan drill-down Organisasi.
* Entri pemilih pengguna Premium Aktif secara Default pada klien desktop. Mengekliknya akan membuka modal yang menyediakan Halaman Pilih Departemen lengkap.

#### 1.3.1 Contoh Penggunaan

* Berdasarkan struktur Tingkat Kontak Organisasi, telusuri melalui struktur pohon untuk mengkueri dan memilih Departemen target.

## 2. Atribut

### 2.1 Pilih Banyak

Mode Pilih Banyak nonaktif secara Default. Ketika Aktif, beberapa Departemen dapat Dipilih, seperti ditunjukkan di bawah ini:

Mode Pilih Banyak

### 2.2 Pilih semua

Ketika mode Pilih semua Aktif, tombol Pilih semua ditambahkan ke Halaman Kirim, sehingga Anda dapat memilih semua Departemen dalam Daftar Dropdown saat ini, seperti ditunjukkan di bawah ini:

Aktifkan Pilih semua

### 2.3 Tombol Hapus

Izinkan menghapus Konten yang telah dimasukkan dengan satu klik melalui `x`, seperti ditunjukkan di bawah ini:

Izinkan Tombol Hapus satu klik

### 2.4 Tampilkan Jalur Penuh Departemen

Ketika Tampilkan Jalur Penuh Departemen Aktif, nilai Komponen Departemen menampilkan jalur penuh Departemen dari induk ke anak, dari kiri ke kanan. Contoh, jika Product Department adalah induk dari Product Department 1, memilih Product Department 1 akan menampilkan: Product Department - Product Department 1.

**Catatan: Departemen tingkat teratas ditampilkan secara Default.**

Tampilkan Jalur Penuh Departemen

### 2.5 Cari Sumber Data

Jika Organisasi Anda memiliki Sumber Data Struktur Organisasi sendiri, Anda dapat mengganti URL HTTP Permintaan di sini dengan URL HTTP Sumber Data Anda. Seperti ditunjukkan di bawah ini:

Anda juga dapat menulis Fungsi penangan Permintaan yang disesuaikan dengan kebutuhan URL HTTP Anda.

Parameter input Fungsi `data` adalah nilai input Cari Pengguna, dan nilai kembaliannya digunakan sebagai Parameter kueri untuk Permintaan. Seperti ditunjukkan di bawah ini:

Fungsi penangan Permintaan

Jika struktur Data yang dikembalikan URL HTTP Anda berbeda dari struktur URL HTTP kueri Departemen YiDA, Anda perlu memodifikasi Fungsi penangan Data.

Pastikan nilai kembalian Fungsi mengikuti format di bawah ini — sebuah array objek, seperti ditunjukkan:

```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
[{
    "text": {
      en_US: "Document",
      pureEn_US: "Document",
      type: "i18n",
      zh_CN: "文档"
    },
    "value": "622760468"
  }]
```

Fungsi penangan Data

## 3. Premium

### 3.1 Pengaturan action

Ketika Anda perlu mengonfigurasi kode JS untuk action Komponen ini, seperti ditunjukkan di bawah ini:

Pengaturan action - Perubahan nilai

## 4. FAQ

### 4.1 Cara Mengambil Departemen Pengguna yang Sedang Masuk

Ini memerlukan penggunaan Formula. Pendekatan yang direkomendasikan adalah menggunakan Teks satu baris dan komponen anggota, dengan mengalihkan Default ke pengeditan Formula. Atur Formula komponen anggota ke `USER()`, dan atur Formula Teks satu baris ke `DEPTNAME(komponen anggota)`.

### 4.2 Tidak Dapat Mencari Departemen Lain di Organisasi dalam Komponen Departemen

Secara Default, Komponen Departemen hanya menampilkan Departemen tempat Pengguna yang sedang masuk berada.

Untuk mengisi informasi Departemen lain, masukkan nama Departemen untuk Cari, seperti ditunjukkan di bawah ini:

### 4.3 Cara Mengambil Manajer Departemen Saat Ini melalui Komponen Departemen?

Pengambilan langsung belum didukung saat ini. Namun, Anda dapat mengonfigurasi Tabel Asosiasi Departemen & Manajer di YiDA, kemudian meminta formulir alur kerja secara otomatis mengaitkan informasi Manajer Departemen yang sesuai setelah Departemen Dipilih, dan mengikat variabel informasi Manajer tersebut pada node Persetujuan.