Manajemen anggota Knowledge Base

​

Kasus penggunaan

• Skenario 1: Ketika karyawan baru onboarding, kolaborator eksternal bergabung, atau sebuah departemen/grup perlu mengakses Knowledge Base, admin dapat menggunakan alur ini untuk menambahkan anggota secara massal dan menetapkan peran.
• Skenario 2: Ketika seorang anggota dipromosikan menjadi admin, atau Anda perlu membatasi operasi anggota, gunakan alur ini untuk mengubah perannya.
• Skenario 3: Ketika seorang anggota keluar, sebuah proyek berakhir, atau Anda perlu mencabut akses untuk pengguna atau departemen tertentu, gunakan alur ini untuk menghapusnya dari Knowledge Base.
• Skenario 4: Ketika organisasi ingin membuat sebuah Knowledge Base (seperti kebijakan perusahaan atau manual produk) dapat diakses oleh semua karyawan tanpa menambahkan anggota satu per satu.
• Skenario 5: Digunakan ketika Anda perlu mengaudit izin Knowledge Base, memecahkan masalah izin, atau memastikan peran anggota saat ini sebelum melakukan operasi massal.

​

Ikhtisar izin

​

Peran izin (roleId)

Catatan: Peran OWNER tidak dapat ditambahkan atau dihapus melalui API. Pembuat Knowledge Base secara default menjadi pemiliknya.

​

Tipe anggota (members.type)

​

Skenario 1: Memberikan akses Knowledge Base kepada anggota baru

1. Panggil API Dapatkan daftar Knowledge Base dan baca bidang rootNodeId dari respons. Ini adalah dentryUuid dari node root Knowledge Base.
2. Dapatkan ID anggota:
   • Untuk menambahkan pengguna: Panggil API Kueri detail pengguna untuk mendapatkan userId, atau gunakan Dapatkan daftar userId departemen untuk mengambilnya secara massal.
   • Untuk menambahkan departemen: Panggil API Dapatkan daftar departemen untuk mendapatkan deptId.
   • Untuk menambahkan obrolan grup: Gunakan chatId grup.
3. Panggil API Tambahkan izin dan pilih peran yang sesuai berdasarkan kebutuhan bisnis Anda (misalnya, EDITOR untuk pengeditan kolaboratif, READER untuk akses hanya baca) untuk menambahkan anggota ke Knowledge Base.

   Tips: Satu permintaan mendukung hingga 30 anggota. Bagi menjadi beberapa panggilan jika melebihi batas ini.

   POST /v2.0/storage/spaces/dentries/{dentryUuid}/permissions?unionId={operator unionId} HTTP/1.1
   Host: api.dingtalk.io
   x-acs-dingtalk-access-token: {ACCESS_TOKEN}
   Content-Type: application/json
   
   {
     "roleId": "EDITOR",
     "members": [
       { "type": "USER", "id": "employee userId" },
       { "type": "DEPT", "id": "department deptId", "corpId": "organization corpId" }
     ]
   }
   

​

Skenario 2: Menyesuaikan peran anggota di Knowledge Base

1. Untuk memastikan peran anggota saat ini, panggil terlebih dahulu API Dapatkan daftar izin.
2. Panggil API Ubah izin dan tentukan anggota serta peran target untuk mengubah peran.

   Catatan: Seorang anggota hanya dapat memegang satu peran di Knowledge Base yang sama. Setelah perubahan, peran lama secara otomatis digantikan.

   PUT /v2.0/storage/spaces/dentries/{dentryUuid}/permissions?unionId={operator unionId} HTTP/1.1
   Host: api.dingtalk.io
   x-acs-dingtalk-access-token: {ACCESS_TOKEN}
   Content-Type: application/json
   
   {
     "roleId": "MANAGER",
     "members": [
       { "type": "USER", "id": "employee userId" }
     ]
   }
   

​

Skenario 3: Mencabut akses Knowledge Base seorang anggota

1. Pastikan peran yang saat ini dipegang oleh anggota. Panggil API Dapatkan daftar izin untuk mengambil peran anggota saat ini (roleId). Peran yang ditentukan untuk penghapusan harus cocok dengan peran yang sebenarnya dipegang.
2. Panggil API Hapus izin.

   Catatan: roleId harus cocok dengan peran yang sebenarnya dipegang oleh anggota; jika tidak, operasi menjadi tidak valid. Peran OWNER tidak dapat dihapus.

   POST /v2.0/storage/spaces/dentries/{dentryUuid}/permissions/remove?unionId={operator unionId} HTTP/1.1
   Host: api.dingtalk.io
   x-acs-dingtalk-access-token: {ACCESS_TOKEN}
   Content-Type: application/json
   
   {
     "roleId": "EDITOR",
     "members": [
       { "type": "USER", "id": "employee userId" }
     ]
   }
   

​

Skenario 4: Membuat Knowledge Base dapat diakses oleh semua karyawan

Catatan: Setelah otorisasi ORG, semua karyawan di organisasi dapat mengakses Knowledge Base dengan peran yang ditentukan. Anggota bertipe ORG tidak muncul dalam hasil kueri daftar anggota. Untuk mencabut akses bagi semua karyawan, panggil API penghapusan dengan cara yang sama dan berikan ORG sebagai type.

POST /v2.0/storage/spaces/dentries/{dentryUuid}/permissions?unionId={operator unionId} HTTP/1.1
Host: api.dingtalk.io
x-acs-dingtalk-access-token: {ACCESS_TOKEN}
Content-Type: application/json

{
  "roleId": "READER",
  "members": [
    { "type": "ORG" }
  ]
}

​

Skenario 5: Mengueri daftar anggota Knowledge Base saat ini

POST /v2.0/storage/spaces/dentries/{dentryUuid}/permissions/query?unionId={operator unionId} HTTP/1.1
Host: api.dingtalk.io
x-acs-dingtalk-access-token: {ACCESS_TOKEN}
Content-Type: application/json

{
  "option": {
    "maxResults": 30,
    "filterRoleIds": ["MANAGER", "EDITOR"]
  }
}

​

Catatan

• Operator harus memiliki izin OWNER atau MANAGER pada Knowledge Base; jika tidak, API mengembalikan error izin tidak memadai.
• Peran OWNER tidak dapat ditambahkan atau dihapus melalui API. Pembuat Knowledge Base secara default menjadi pemiliknya.
• Saat menghapus anggota, roleId harus cocok dengan peran yang sebenarnya dipegang oleh anggota; jika tidak, operasi menjadi tidak valid.
• Satu permintaan mendukung hingga 30 anggota dalam daftar members. Bagi menjadi beberapa panggilan jika melebihi batas ini.