Per: Amministratori
Leggi i ruoli con un tasto di gestione
Elenca i ruoli del tuo hub e leggi le autorizzazioni di ciascun ruolo, in modo che il software possa assegnare ai casi gli utenti con il ruolo corretto.
In questo articolo5 sezioni
Prima di iniziare
Questa pagina descrive come leggere i “ruoliRuolo Un insieme di autorizzazioni che determina cosa una persona può vedere e fare su un caso, ad esempio il personale o i clienti.” del proprio hub. Gli ID di questi ruoli vengono inviati quando si assegnano dei membri a un caso. I percorsi utilizzati per accedere ai ruoli sono indicati sotto https://prd-api-manage.caseactive.com/v1/<hub id>. Un utente può leggere i ruoli, ma non può crearli, modificarli o eliminarli.
Chiamate
| Chiamata | Cosa fa |
|---|---|
GET /roles | Elenca i ruoli del proprio hub. |
GET /roles/<role_id> | Leggo un ruolo, insieme alle relative autorizzazioni. |
GET /roles prende limit (valore predefinito: 20), start_key e startKey, che proviene dalla pagina precedente. Un hub può avere al massimo 20 ruoli; quindi, un singolo invio di limit=20 è sufficiente per assegnare tutti i ruoli necessari.
ID ruolo
L’ID di una funzione è role::, mentre il suo nome è role::senior-paralegal. Ogni hub dispone di tre funzioni predefinite.
| ID ruolo | A chi è destinato |
|---|---|
role::clients | Clienti |
role::staff | Il vostro team |
role::bots | Il tuo “hub”… Assistente virtualAssistente virtuale Un membro automatizzato del team che pubblica messaggi di benvenuto, check-in e post di aggiornamento per l'azienda; i suoi post sono contrassegnati da un badge di Assistente Virtuale., Ogni chiave API svolge lo stesso ruolo. Non da essa a nessuno. |
Che ruolo comporta
GET /roles risponde a ciascun ruolo, ovvero a role_id, name, role_type (system per i tre ruoli predefiniti; custom per il proprio ruolo). Inoltre, x0/> risponde anche a description, color e users_ct: in altre parole, x0/> indica il numero di posizioni che può occupare in ciascun caso.
{
"data": {
"items": [
{"role_id": "role::clients", "name": "clients", "role_type": "system", "color": "#10B981", "users_ct": 214},
{"role_id": "role::senior-paralegal", "name": "senior-paralegal", "role_type": "custom", "description": "Paralegals who run intake", "color": "#6366F1", "users_ct": 9}
],
"currentItemCount": 2,
"selfLink": "https://prd-api-manage.caseactive.com/v1/ca-7e6d5c4b3a2f10/roles"
}
}
GET /roles/<role_id> aggiunge:
| Campo | Cosa contiene |
|---|---|
permissions | Il ruolo che può svolgere in un caso è determinato da ciascuna sezione: case, convos, events, posts, forms, signs, invoices, notes, tasks e team. Ogni sezione elenca dei nomi, come list_posts (vedere questi nomi), put_post (aggiungere o modificare i propri dati), delete_post, put_comment e moderator (per gestire i dati di tutti). |
case_read_fields, case_write_fields | Il caso descrive chiaramente il ruolo che svolge, e quali possano essere le modifiche che potrebbero avvenire in futuro. |
user_read_fields, user_write_fields | I dettagli del profilo degli altri coinvolti nel caso possono cambiare, a seconda del ruolo che ricoprono. |
file_size | Il file più grande che il ruolo può caricare, in MB, per tipo: audios, docs, files, images, schemas e videos |
La lista indica i ruoli che non sono stati inclusi nella risposta.
Per impostazione predefinita: role::staff E… role::bots È possibile gestire tutto in un singolo caso. role::clients È possibile visualizzare il caso e ogni sezione del sito. Tuttavia, è possibile aggiungere i propri eventi, formulari, firme elettroniche e compiti. Inoltre, è possibile pagare le fatture. Il layout del sito potrebbe essere cambiato. Per sapere quali sono le autorizzazioni disponibili per ciascun utente, si veda l’elenco delle autorizzazioni. Verificare ogni permesso relativo a ogni ruolo..
Se una chiamata viene rifiutata
| Stato | message | Perché |
|---|---|---|
| 404 | ItemNotFoundException | Il tuo hub non ha alcun ruolo in relazione a quell’ID. |
| 403 | BotNotAllowedException | Avete cercato di creare, modificare o eliminare un ruolo. |