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

# Matrix izin

> Pelajari cara membuat, memelihara, dan menghapus matrix izin di YiDA untuk manajemen data yang efisien serta kontrol akses yang fleksibel di proses persetujuan dan alur kerja.

| **Hak paket**   | **Paket Luang** | **Edisi Basic** | **Edisi Professional** | **Edisi Dedicated** | **Dedicated - Paket peningkatan OA** |
| --------------- | --------------- | --------------- | ---------------------- | ------------------- | ------------------------------------ |
| **Matrix izin** | Tidak didukung  | Tidak didukung  | Tidak didukung         | Tidak didukung      | Didukung                             |

## 1. Pengantar

### 1.1 Gambaran fitur

Matrix izin menyediakan manajemen data untuk pengaturan izin, mendukung operasi massal dan penggunaan ulang untuk meningkatkan efisiensi pengelolaan. Fitur ini memberi organisasi platform manajemen data dan kontrol akses yang lebih aman, efisien, dan fleksibel.

Sebagai contoh, sebuah perusahaan internet besar memiliki pusat keuangan korporat, dan beberapa staf keuangan di pusat tersebut ditugaskan untuk mendukung lini bisnis yang berbeda. Dalam kasus ini, proses persetujuan terkait keuangan harus mempertimbangkan cakupan tanggung jawab sekaligus hubungan pelaporan fungsional.

Sebelumnya, menangani skenario kompleks semacam ini menuntut penambahan cabang bersyarat pada alur kerja.

Dengan matrix izin, Anda cukup memelihara aturan sekali dan mereferensikannya berkali-kali di banyak tempat, tanpa perlu menambahkan cabang serupa ke alur kerja. Satu node ditambah aturan pencocokan menghasilkan hasil yang sama.

### 1.2 Skenario penggunaan

* Penetapan peran yang fleksibel: Buat peran berdasarkan kebutuhan bisnis tertentu dan tetapkan izin yang sesuai untuk setiap peran. Anggota tim kemudian dapat berkolaborasi secara bebas dalam Cakupan izin mereka tanpa khawatir akan kebocoran atau penyalahgunaan data.

### 1.3 Gambaran konsep

#### 1.3.1 Tentang matrix izin

Matrix izin terdiri dari tiga bagian: informasi dasar, header matrix, dan detail matrix.

#### 1.3.2 Informasi dasar matrix izin

Informasi dasar mencakup **nama matrix** dan **deskripsi matrix**.

#### 1.3.3 Konsep header matrix

Header matrix terdiri dari Kolom kondisi dan Kolom peran:

* Kolom kondisi: Menentukan kondisi di mana matrix izin berlaku (misalnya, proyek x Departemen membentuk kombinasi kondisi untuk penetapan peran). Minimal 1, maksimal 10.
* Kolom peran: Menentukan penanggung jawab berdasarkan kondisi yang diberikan. Anda dapat memilih Pengguna dari Organisasi Anda. Minimal 1, maksimal 50.

## 2. Langkah operasi

Matrix izin mengonsolidasikan penetapan peran yang umum digunakan di seluruh Organisasi Anda, sehingga Anda dapat mereferensikannya dengan sekali klik pada skenario seperti alur kerja dan Izin, mengurangi biaya pengelolaan dan konfigurasi. Artikel ini menjelaskan konsep dasar dan penggunaan matrix izin.

<Note>
  Hanya Admin platform yang dapat melakukan operasi ini.
</Note>

### 2.1 Buat matrix izin

<Steps>
  <Step title="Langkah 1">
    Masuk ke [YiDA workbench](https://www.yidaapps.com/workPlatform).
  </Step>

  <Step title="Langkah 2">
    Klik tombol (manajemen platform) di pojok kanan atas untuk membuka halaman **Manajemen platform**.
  </Step>

  <Step title="Langkah 3">
    Buka **Manajemen organisasi** > **Matrix izin**, lalu klik **Buat matrix izin**.
  </Step>
</Steps>

<Steps>
  <Step title="Pada dialog Buat info matrix, masukkan Nama matrix dan Deskripsi matrix, lalu konfirmasi" />

  <Step title="Konfigurasikan header matrix, lalu klik Simpan jika sudah selesai" />
</Steps>

Setelah header dibuat, tabel matrix izin akan dihasilkan.

Klik **Edit data halaman saat ini** di sebelah kanan untuk mengedit detail izin pada halaman saat ini. Jika terdapat beberapa halaman, buka dulu halaman target, lalu masuk ke mode edit.

<Steps>
  <Step title="Klik Tambah baris, masukkan kondisi dan peran yang sesuai pada tabel di bawah, lalu klik Simpan di pojok kanan atas jika sudah selesai" />

  <Step title="Klik Duplikasi baris untuk menyalin rekaman saat ini dan menambahkannya langsung ke baris pertama tabel" />
</Steps>

### 2.2 Pelihara matrix izin

Setelah matrix izin dibuat, ikuti langkah berikut jika Anda perlu mengedit datanya.

1. Masuk ke YiDA workbench, buka halaman manajemen platform, lalu klik Matrix izin.
2. Pilih matrix izin yang ingin diubah, lalu klik ··· > Edit di pojok kanan atas.

<Steps>
  <Step title="Klik Edit untuk mengubah nama dan deskripsi matrix, lalu klik Konfirmasi jika sudah selesai" />

  <Step title="Klik Atur header, ubah Kolom kondisi dan Kolom peran pada dialog, lalu klik Simpan jika sudah selesai" />

  <Step title="Klik Edit data halaman saat ini di pojok kanan atas, edit kondisi dan peran yang sesuai, lalu klik Simpan di pojok kanan atas jika sudah selesai" />
</Steps>

### 2.3 Hapus matrix izin

Ikuti langkah ini untuk menghapus matrix izin yang tidak lagi Anda butuhkan.

1. Pada halaman detail matrix izin, temukan matrix yang ingin dihapus.
2. Klik ··· > Hapus.

<Note>
  * Anda tidak dapat menghapus matrix izin yang sedang digunakan.

  * Untuk melihat **detail penggunaan** matrix izin, klik Lainnya pada matrix tersebut.

  * Pada desain alur kerja, pemeriksaan penggunaan matrix izin hanya berlaku untuk versi alur kerja yang sedang aktif, tidak untuk versi historis atau draf.

  * Jika matrix izin yang digunakan pada versi historis dihapus sementara instance alur kerja yang berjalan untuk versi historis tersebut masih ada, node terkait pada instance alur kerja tersebut tidak akan memiliki operator yang ditetapkan.
</Note>

### 2.4 Operasi massal untuk detail matrix izin

Anda dapat mengimpor dan menghapus data secara massal pada matrix izin. Lihat bagian berikut untuk melakukan operasi massal.

#### 2.4.1 Hapus massal

1. Masuk ke YiDA workbench, buka halaman manajemen platform, lalu klik Matrix izin.
2. Pilih matrix izin yang ingin diubah, lalu klik ··· > Edit di pojok kanan atas.
3. Pilih data yang ingin dihapus, lalu klik Hapus massal.

#### 2.4.2 Impor massal

1. Masuk ke YiDA workbench, buka halaman manajemen platform, lalu klik Matrix izin.
2. Pilih matrix izin yang ingin diubah, lalu klik ··· > Edit di pojok kanan atas.
3. Klik Impor massal.
4. Atur metode Impor pada dialog.

Dua metode impor didukung:

<Steps>
  <Step title="Klik atau tarik file ke dalam kotak putus-putus pada dialog untuk mengunggahnya">
    <Note>
      Untuk memastikan proses impor berjalan lancar, unduh templat impor pada halaman dan masukkan data sesuai format contoh.
    </Note>
  </Step>

  <Step title="Pratinjau data yang diimpor, lalu klik Impor setelah memastikan data sudah benar" />
</Steps>

#### 2.4.3 Aturan impor massal

File Excel yang diunggah harus memenuhi persyaratan berikut:

* Jika metode impor adalah "Hanya tambah data baru", templat impor hanya berisi bidang header dari matrix, tanpa data matrix apa pun.
* Jika metode impor adalah "Hanya perbarui data", templat impor berisi header dan seluruh data dari matrix saat ini, ditambah kolom Row ID tambahan.

<Note>
  **Catatan: Row ID** adalah Kunci utama unik yang digunakan untuk memperbarui data. Jangan mengubahnya. Perubahan apa pun akan menyebabkan pembaruan gagal.
</Note>

* Pastikan header file impor sesuai dengan header matrix saat ini. Jika tidak, impor akan gagal.

* Ukuran file impor tidak boleh melebihi 10 MB.

* Hanya file \*.xls dan \*.xlsx yang didukung.

* Pastikan file Excel Anda memenuhi persyaratan berikut:

* Hanya satu tugas impor yang dapat berjalan bersamaan untuk satu matrix.

* Jika data yang diimpor berisi Departemen atau Pengguna, input harus mengikuti format berikut, dan datanya harus valid.

|                | **Deskripsi**                                                                                                                                                                                                                                                                                                                                                                                                                                                                | **Contoh**                 |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| **Departemen** | Informasi Departemen dapat diimpor dalam salah satu format berikut.<br />• Nama Departemen saat ini<br />• Jalur Departemen lengkap<br />**Catatan**: Jika hanya nama Departemen yang digunakan dan terdapat Departemen dengan nama yang sama pada pohon Departemen, impor akan gagal.                                                                                                                                                                                       | DingTalk-YiDA-YiDA Product |
| **Pengguna**   | Informasi Pengguna dapat diimpor dalam salah satu dari tiga format berikut.<br />• **Nama Karyawan + ID pengguna**<br />• **Nama Karyawan**<br />• **ID pengguna**<br />**Catatan**: Jika hanya nama Karyawan yang digunakan dan terdapat Pengguna dengan nama yang sama pada Kontak, impor akan gagal. Anda dapat menemukan ID pengguna pada [DingTalk admin console](https://oa.dingtalk.io) > **Kontak** > **Manajemen pengguna** > halaman **Informasi dasar** Karyawan. | Budi\[yida777]             |

### 2.5 Gunakan matrix izin

Matrix izin dapat digunakan pada node manual (penyetuju, penerima CC, dan pelaksana) dari proses persetujuan. Pilih matrix izin secara langsung pada pengaturan atribut node penyetuju, penerima CC, atau pelaksana.

<Steps>
  <Step title="Langkah 1">
    Pada konfigurasi penyetuju di panel atribut, pilih **Dapatkan dari matrix izin**.
  </Step>

  <Step title="Langkah 2">
    Konfigurasikan pengaturan matrix izin:
  </Step>
</Steps>

Catatan aturan penerapan matrix:

* Jika terdapat beberapa aturan penerapan, Pengguna dicocokkan pada matrix yang dipilih menggunakan logika AND untuk menentukan operator node saat ini.
* Jika beberapa Pengguna cocok dengan aturan penerapan matrix, semua Pengguna yang cocok menjadi operator untuk node saat ini, dan konfigurasi "mode multi-penyetuju" menentukan cara node berlaku.
* Jika tidak ada Pengguna yang cocok dengan aturan penerapan matrix, node saat ini ditangani sesuai konfigurasi "penyetuju kosong".

<Note>
  - Jika Sumber bidang dari kondisi matrix adalah Departemen, dropdown bidang formulir hanya menampilkan komponen Departemen dari formulir saat ini.
  - Anda dapat menambahkan hingga 20 aturan penerapan matrix.
</Note>