Introduzione
A partire dal 27 Ottobre 2020, la app Power User offre una nuova esperienza di gestione dei Power User e dei profili Power User in piattaforma.
L’interfaccia utente dell’area è stata ridisegnata in linea con il nuovo layout della piattaforma, e sono state apportate alcune modifiche rispetto alla gestione attuale dell’app.
Questo articolo elenca le modifiche introdotte dal rinnovamento di questa funzionalità e le API che sono state dismesse e sviluppate per la nuova gestione dei Power User.
Nuova Esperienza Utente
Lo scopo principale del rinnovamento della app Power User è il restlyling dell'interfaccia, per rendere più intuitiva la gestione dei Power User e dei relativi profili.
Grazie a questo restyling, i dati necessari alla gestione dei Power User e dei profili sono tutti disponibili in una sola pagina. Da questa pagina è possibile visualizzare tutte le risorse e tutti i profili assegnati ai Power User, permettendo di identificare velocemente eventuali problemi di configurazione.
Infine, la nuova gestione dei Power User introduce un modo più intuitivo di assegnare i permessi ai profili Power User grazie ad una tab dedicata, che funge anche da sommario dei permessi e dei Power User assegnati ad ogni profilo definito in piattaforma.
Assegnazione dei Piani Formativi ai Profili
Con la precedente gestione dei Power User, era possibile assegnare tutti i corsi e i piani formativi definiti in piattaforma ad un profilo Power User.
Poiché la nuova gestione dei Power User permette di assegnare più profili allo stesso Power User, al fine di evitare inconsistenze fra le risorse direttamente assegnate ai Power User e quelle ereditate dai profili assegnati, questa opzione non è più disponibile.
Invece di assegnare tutti i corsi e piani formativi ai profili Power User, sarà possibile assegnarli ai singoli Power User, mantenendo l'assegnazione delle risorse sotto controllo.
Assegnazione di Più Profili
Grazie alla nuova gestione dei Power User, sarà possibile assegnare più profili ad ogni Power User. Il Power User erediterà tutti i permessi dei profili a cui è assegnato/a.
Grazie alla nuova esperienza utente, è possibile assegnare un Profilo Power User a più Power user con pochi click, grazie ad un’azione multipla.
Porting
Al rilascio della nuova gestione dei Power User, il 27 Ottobre 2020, tutti i Power User e i profili Power User, le configurazioni e le risorse assegnate e definite in piattaforma sono state automaticamente migrate alla nuova esperienza utente.
API Dismesse
La tabella API Dismesse elenca tutte le API che saranno dismesse per via della nuova gestione dei Power User. Queste API rimarranno operative fino alla fine del 2021, in modo da offrire abbastanza tempo per migrare alle nuove API. Al termine di questo periodo, Docebo continuerà a garantire la gestione delle vecchie API, ma non saranno più mantenute allineate a sviluppi e migliorie future.
| Descrizione API | Verbo API | URL API |
|---|---|---|
| Assegnazione di cataloghi ad un Power User | POST | /learn/v1/pu/assign_catalogs |
| Assegnazione delle categorie corsi ad un Power User | POST | /learn/v1/pu/assign_categories |
| Assegnazione di corsi ad un Power User | POST | /learn/v1/pu/assign_courses |
| Assegnazione di sedi ad un Power User | POST | /learn/v1/pu/assign_locations |
| Assegnazione di rami ad un Power User | POST | /learn/v1/pu/assign_orgcharts |
| Assegnazione di utenti ad un Power User | POST | /learn/v1/pu/assign_users |
| Promozione di un utente al ruolo di Power User | POST | /learn/v1/pu |
| Assegnazione del ruolo di utente ad un Power User | POST | /learn/v1/pu/{id} |
| Riepilogo dei permessi assegnati ad un profilo Power User | GET | /manage/v1/powerusers/permissions |
| Rimozione dell’assegnazione di un permesso ad un profilo Power User | DELETE | /manage/v1/powerusers/profiles/{id}/permissions |
| Assegnazione di un permesso ad un profilo Power User | POST | /manage/v1/powerusers/profiles/{id}/permissions/learn/v1/pu/{id} |
| Cancellazione di un profilo Power User | DELETE | /manage/v1/powerusers/profiles/{id} |
| Richiesta di un elenco di profili Power User | GET | /manage/v1/powerusers/profiles |
| Creazione di un profilo Power User | POST | /manage/v1/powerusers/profiles |
| Aggiornamento di un profilo Power User | PUT | /manage/v1/powerusers/profiles/{id} |
| Rimozione di corsi, piani formativi e categorie assegnate ad un Power User | DELETE | /manage/v1/powerusers/{user_id}/courses |
| Rimozione di utenti, gruppi e rami assegnati ad un Power User | DELETE | /manage/v1/powerusers/{user_id}/users |
| Aggiornamento della configurazione Power User. | PUT | /manage/v1/powerusers/{user_id} |
| Operazione batch per la gestione della configurazione Power User. | POST | /manage/v1/pu/batch_pu_mapping |
Nuove API
La tabella Nuove API elenca le API disponibili per la nuova gestione dei Power User. Questa API saranno operative a partire dal 27 Ottobre 2020.
| Descrizione API | Verbo API | URL API |
|---|---|---|
| Rimozione dell’assegnazione Power User | DELETE | /poweruser/v1/powerusers |
| Richiesta dell’elenco dei Power User | GET | /poweruser/v1/powerusers |
| Creazione Power User | POST | /poweruser/v1/powerusers |
| Rimozione batch dell’assegnazione Power User | DELETE | /poweruser/v1/powerusers/batch |
| Richiesta dei dettagli di un Power User | GET | /poweruser/v1/powerusers/{user_id} |
| Aggiornamento Power User | PUT | /poweruser/v1/powerusers/{user_id} |
| Richiesta dell’elenco dei profili associati ad un Power User | GET | /poweruser/v1/powerusers/{user_id}/profiles |
| Rimozione dell’assegnazione dei profili | DELETE | /poweruser/v1/powerusers/profiles |
| Assegnazione dei profili Power User | PUT | /poweruser/v1/powerusers/profiles |
| Rimozione batch dei profli | DELETE | /poweruser/v1/powerusers/profiles/batch |
| Assegnazione batch dei profili | PUT | /poweruser/v1/powerusers/profiles/batch |
| Rimozione degli utenti assegnati ad un Power User | DELETE | /poweruser/v1/powerusers/{user_id}/users |
| Richiesta dell’elenco degli utenti associati ad un Power User | GET | /poweruser/v1/powerusers/{user_id}/users |
| Assegnazione di utenti ad un Power User | PUT | /poweruser/v1/powerusers/{user_id}/users |
| Rimozione dei gruppi assegnati ad un Power User | DELETE | /poweruser/v1/powerusers/{user_id}/groups |
| Richiesta dell’elenco dei gruppi associati ad un Power User | GET | /poweruser/v1/powerusers/{user_id}/groups |
| Assegnazione di gruppi ad un Power User | PUT | /poweruser/v1/powerusers/{user_id}/groups |
| Rimozione dei rami assegnati ad un Power User | DELETE | /poweruser/v1/powerusers/{user_id}/branches |
| Richiesta dell’elenco dei rami associati ad un Power User | GET | /poweruser/v1/powerusers/{user_id}/branches |
| Assegnazione di rami ad un Power User | PUT | /poweruser/v1/powerusers/{user_id}/branches |
| Richiesta dell’elenco delle categorie associate ad un Power User | GET | /poweruser/v1/powerusers/{user_id}/categories |
| Richiesta dell’elenco dei corsi associati ad un Power User | GET | /poweruser/v1/powerusers/{user_id}/courses |
| Richiesta dell’elenco dei piani formativi associati ad un Power User | GET | /poweruser/v1/powerusers/{user_id}/lps |
| Rimozione dei cataloghi assegnati ad un Power User | DELETE | /poweruser/v1/powerusers/{user_id}/catalogs |
| Richiesta dell’elenco dei cataloghi associati ad un Power User | GET | /poweruser/v1/powerusers/{user_id}/catalogs |
| Assegnazione di cataloghi ad un Power User | PUT | /poweruser/v1/powerusers/{user_id}/catalogs |
| Rimozione delle sedi assegnati ad un Power User | DELETE | /poweruser/v1/powerusers/{user_id}/locations |
| Richiesta dell’elenco delle sedi associate ad un Power User | GET | /poweruser/v1/powerusers/{user_id}/locations |
| Assegnazione di sedi ad un Power User | PUT | /poweruser/v1/powerusers/{user_id}/locations |
| Rimozione di corsi, piani formativi e categorie assegnati ad un Power User | DELETE | /poweruser/v1/powerusers/{user_id}/learning-content |
| Richiesta dell’elenco di corsi, piani formativi e categorie associate ad un Power User | GET | /poweruser/v1/powerusers/{user_id}/learning-content |
| Assegnazione di corsi, piani formativi e categorie ad un Power User | PUT | /poweruser/v1/powerusers/{user_id}/learning-content |
| Rimozione batch dell’associazione di utenti ai Power User | DELETE | /poweruser/v1/powerusers/{user_id}/users/batch |
| Rimozione batch dell’associazione di gruppi ai Power User | DELETE | /poweruser/v1/powerusers/{user_id}/groups/batch |
| Rimozione batch dell’associazione di rami ai Power User | DELETE | /poweruser/v1/powerusers/{user_id}/branches/batch |
| Rimozione batch dell’associazione di cataloghi ai Power User | DELETE | /poweruser/v1/powerusers/{user_id}/catalogs/batch |
| Rimozione batch dell’associazione di sedi ai Power User | DELETE | /poweruser/v1/powerusers/{user_id}/locations/batch |
| Rimozione batch dell’associazione di corsi, piani formativi e categorie ai Power User | DELETE | /poweruser/v1/powerusers/{user_id}/learning-content/batch |
Per ogni API, l’elenco dei parametri è dettagliato nelle sezioni che seguono.
Rimozione dell’Assegnazione di Power Users
DELETE /poweruser/v1/powerusers @parameter user_ids [array(integer), required] Array degli ID Power User per cui rimuovere l’assegnazione, lasciare vuoto per utilizzare l’opzine all. @parameter user_all [boolean, required] True per prendere in considerazione tutti i Power Users, false in caso contrario @parameter user_filters [object, optional] Filtrare l’elenco Power User in base alle opzioni indicate @item search [string, optional] Cercare i PowerUser in base a username, firstname, lastname, email. @item profile_id [integer, optional] Filtrare in base all’ID del profilo indicato @item without_profiles [boolean, optional] Filtrare i Power User senza profilo. Default: false @item without_users [boolean, optional] Filtrare i Power User senza utenti assegnati. Default: false @item without_groups [boolean, optional] Filtrare i Power User senza gruppi assegnati.. Default: false @item without_branches [boolean, optional] Filtrare i Power User senza rami assegnati. Default: false @item without_courses [boolean, optional] Filtrare i Power User senza corsi assegnati. Default: false @item without_lps [boolean, optional] Filtrare i Power User senza piani formativi assegnati. Default: false @item without_categories [boolean, optional] Filtrare i Power User senza categorie assegnate. Default: false @item without_catalogs [boolean, optional] Filtrare i Power User senza cataloghi assegnati. Default: false @item without_locations [boolean, optional] Filtrare i Power User senza sedi assegnate. Default: false
Recupero dell’Elenco di Power Users
GET /poweruser/v1/powerusers @parameter profile_id [integer, optional] Filtrare in base all’ID del profilo indicato @parameter without_profiles [boolean, optional] Filtrare i Power User senza profilo. Default: false @parameter without_users [boolean, optional] Filtrare i Power User senza utenti assegnati. Default: false @parameter without_groups [boolean, optional] Filtrare i Power User senza gruppi assegnati. Default: false @parameter without_branches [boolean, optional] Filtrare i Power User senza rami assegnati. Default: false @parameter without_courses [boolean, optional] Filtrare i Power User senza corsi assegnati. Default: false @parameter without_lps [boolean, optional] Filtrare i Power User senza piani formativi assegnati. Default: false @parameter without_categories [boolean, optional] Filtrare i Power User senza categorie assegnate. Default: false @parameter without_catalogs [boolean, optional] Filtrare i Power User senza cataloghi assegnati. Default: false @parameter without_locations [boolean, optional] Filtrare i Power User senza sedi assegnate. Default: false @parameter page [integer, optional] Numero della pagina da leggere. Default: 1 @parameter page_size [integer, optional] Numero di elementi da leggere. Default: 10 @parameter sort_type [enum(username, firstname, lastname, email), optional] Attributo di ordinamento. Default: username @parameter sort_dir [enum(asc, desc), optional] Ordinamento. Default: asc @parameter search [string, optional] Ricerca Power User in base a username, firstname, lastname, email.
Creazione di Power User
POST /poweruser/v1/powerusers @parameter user_ids [array(integer), required] Array di utenti che saranno promossi al ruolo di Power User.
Rimozione Batch dell’Associazione Power User
DELETE /poweruser/v1/powerusers/batch @parameter items [array, required] Array di ID di Power User per cui rimuovere l’associazione @item user_id [integer, required] ID Power User
Recupero dei Dettagli di un Power User
GET /poweruser/v1/powerusers/{user_id} @get user_id [integer, required] ID Power User
Aggiornamento Power User
PUT /poweruser/v1/powerusers/{user_id} @get user_id [integer, required] ID del Power User da aggiornare @parameter profile_ids [array(integer), required] Elenco degli ID profilo da associare. Lasciare vuoto per rimuovere tutti i profili associati.
Elenco dei Profili Associati ad un Power User
GET /poweruser/v1/powerusers/{user_id}/profiles @get user_id [integer, required] ID dei Power User per cui recuperare i profili @parameter page [integer, optional] Numero della pagina da leggere. Default: 1 @parameter page_size [integer, optional] Numero di elementi da leggere. Default: 10 @parameter sort_type [enum(name, description, created_at), optional] Attributo di ordinamento. Default: created_at @parameter sort_dir [enum(asc, desc), optional] Ordinamento. Default: desc @parameter search [string, optional] Ricerca profili in base a name, description @parameter show_assignable_profiles [boolean, optional] Se true, recupera tutti i profili assegnabili e non quelli assegnati. Default: false
Rimozione Assegnazione Profili
DELETE /poweruser/v1/powerusers/profiles @parameter user_ids [array(integer), required] Array di ID Power User da cui rimuovere l’associazione ai profili, lasciare un array vuoto per utilizzare l’opzione all @parameter user_all [boolean, required] Se True, considerare tutti i Power Use, se False il contrario @parameter user_filters [object, optional] Filtrare l’elenco dei Power User in base alle opzioni indicate @item search [string, optional] Ricercare i Power User in base a: username, firstname, lastname, email. @item profile_id [integer, optional] Filtrare in base all’ID del profilo indicato @item without_profiles [boolean, optional] Filtrare i Power User senza profilo. Default: false @item without_users [boolean, optional] Filtrare i Power User senza utenti assegnati. Default: false @item without_groups [boolean, optional] Filtrare i Power User senza gruppi assegnati. Default: false @item without_branches [boolean, optional] Filtrare i Power User senza rami assegnati. Default: false @item without_courses [boolean, optional] Filtrare i Power User senza corsi assegnati. Default: false @item without_lps [boolean, optional] Filtrare i Power User senza piani formativi assegnati. Default: false @item without_catalogs [boolean, optional] Filtrare i Power User senza cataloghi assegnati. Default: false @item without_locations [boolean, optional] Filtrare i Power User senza sedi assegnate. Default: false @parameter profile_ids [array(integer), required] Array degli ID dei profili per cui rimuovere l’associazione. Lasciare vuoto per utilizzare l’opzione all. @parameter profile_all [boolean, required] True per considerare tutti i profili, false in caso contrario @parameter profile_filters [object, optional] Filtrare l’elenco dei profili in base alle opzioni indicate. @item search [string, optional] Cercare i profili in base a name, description @item with_permissions [boolean, optional] Filtrare i profili con almeno un permesso assegnato. Default: false @item without_permissions [boolean, optional] Filtrare i profili senza permessi assegnati. Default: false @item with_power_users [boolean, optional] Filtrare i profili con almeno un Power User. Default: false @item without_power_users [boolean, optional] Filtrare i profili senza Power User. Default: false
Assegna Profili ai Power Users
PUT /poweruser/v1/powerusers/profiles @parameter user_ids [array(integer), required] Array degli ID Power User da cui assegnare i profili, lasciare vuoto per utilizzare l’opzione all. @parameter user_all [boolean, required] True per considerare tutti i Power User, false per il contrario @parameter user_filters [object, optional] Filtrare l’elenco dei Power User in base alle opzioni indicate @item search [string, optional] Cercare i Power User in base a username, firstname, lastname, email. @item profile_id [integer, optional] Filtrare in base all’ID del profilo indicato. @item without_profiles [boolean, optional] Filtrare i Power User senza profilo. Default: false @item without_users [boolean, optional] Filtrare i Power User senza utenti assegnati. Default: false @item without_groups [boolean, optional] Filtrare i Power User senza gruppi assegnati. Default: false @item without_branches [boolean, optional] Filtrare i Power User senza rami assegnati. Default: false @item without_courses [boolean, optional] Filtrare i Power User senza corsi assegnati. Default: false @item without_lps [boolean, optional] Filtrare i Power User senza piani formativi assegnati. Default: false @item without_categories [boolean, optional] Filtrare i Power User senza categorie assegnate. Default: false @item without_catalogs [boolean, optional] Filtrare i Power User senza cataloghi assegnati. Default: false @item without_locations [boolean, optional] Filtrare i Power User senza sedi assegnate. Default: false @parameter profile_ids [array(integer), required] Array di ID profili da assegnare, lasciare vuoto per utilizzare l’opzione all. @parameter profile_all [boolean, required] True per considerare tutti i profili, false per il contrario @parameter profile_filters [object, optional] Filtrare l’elenco dei profili in base alle opzioni indicate @item search [string, optional] Ricercare profili in base a: name, description @item with_permissions [boolean, optional] Filtrare i profili con almeno un permesso assegnato. Default: false @item without_permissions [boolean, optional] Filtrare i profili senza permessi assegnati. Default: false @item with_power_users [boolean, optional] Filtrare i profili con almeno un Power User. Default: false @item without_power_users [boolean, optional] Filtrare i profili senza Power User. Default: false
Rimozione Batch dell’Assegnazione dei Profili
DELETE /poweruser/v1/powerusers/profiles/batch @parameter items [array, required] Associative array containing key/value pairs to remove profiles from Power Users @item user_id [integer, required] ID Power User @item profile_id [integer, required] ID profilo
Assegnazione Batch dei Profili
PUT /poweruser/v1/powerusers/profiles/batch @parameter items [array, required] Array associativo che include le associazioni key/value di profili e Power User da assegnare. @item user_id [integer, required] ID Power User @item profile_id [integer, required] ID Profilo
Rimuovere l’Associazione degli Utenti ai Power User
DELETE /poweruser/v1/powerusers/{user_id}/users @get user_id [integer, required] ID Power User @parameter id_list [array(integer), required] Elenco degli ID utente per cui l’associazione sarà rimossa dal Power User. Può essere omesso se all è definito come true. @parameter all [boolean, optional] Se definito come true e l’id_list è vuoto, tutti gli utenti non assegnabili saranno rimossi dal Power User in base al filtro. Default: false @parameter filter [object, optional] Oggetto filtro @item search [string, optional] Ricarcare utenti in base a: username, firstname, lastname, email
Elenco degli Utenti Assegnati ad un Power User
GET /poweruser/v1/powerusers/{user_id}/users @get user_id [integer, required] ID del Power User utilizzato per recuperare gli utenti assegnati. @parameter page [integer, optional] Numero della pagina da leggere. Default: 1 @parameter page_size [integer, optional] Numero di elementi da leggere. Default: 10 @parameter sort_type [enum(username, firstname, lastname, email, creation), optional] Sort type. Default: username @parameter sort_dir [enum(asc, desc), optional] Ordinamento. Default: desc @parameter search [string, optional] Ricerca utenti in base a: username, firstname, lastname, email @parameter show_assignable[boolean, optional] Se definito a true, mostra solo gli utenti assegnabili al Power User. Default: false
Assegnazioni Utenti ad un Power User
PUT /poweruser/v1/powerusers/{user_id}/users @get user_id [integer, required] ID Power User @parameter id_list [array(integer), required] Elenco degli ID utente che saranno assegnati al Power User. Può essere omesso se all è passato come true. @parameter all [boolean, optional] Se true e l’id_list è vuoto, tutti gli utenti assegnabili saranno assegnati al Power User in base al filtro. Default: false. @parameter filter [object, optional] Oggetto filtro @item search [string, optional] Ricercare utenti in base a username, firstname, lastname, email
Rimuovere l’Assegnazione di Gruppi dai Power User
DELETE /poweruser/v1/powerusers/{user_id}/groups @get user_id [integer, required] ID Power User @parameter id_list [array(integer), required] L’elenco di ID gruppi la cui assegnazione sarà rimossa dai Power User. Può essere omesso se all è passato come true. @parameter all [boolean, optional] Se definito a true e l’id_list è vuoto, tutti i gruppi non assegnabili saranno rimossi dal Power User in base al filtro. Default: falso. @parameter filter [object, optional] Oggetto filtro @item search [string, optional] Ricerca gruppi in base a nome e descrizione
Recupera l’Elenco dei Gruppi Assegnati ad un Power User
GET /poweruser/v1/powerusers/{user_id}/groups @get user_id [integer, required] ID Power User utilizzato per recuperare i gruppi assegnati @parameter page [integer, optional] Numero della pagina da leggere. Default: 1 @parameter page_size [integer, optional] Numero di elementi da leggere. Default: 10 @parameter sort_type [enum(name, description, members), optional] Tipo di ordinamento. Default: name @parameter sort_dir [enum(asc, desc), optional] Ordinamento. Default: desc @parameter search [string, optional] Ricerca gruppi in base a nome e descrizione. @parameter show_assignable[boolean, optional] Se a true, mostra solo i gruppi assegnabili al Power User. Default: false
Assegnazione Gruppi al Power User
PUT /poweruser/v1/powerusers/{user_id}/groups @get user_id [integer, required] ID Power User @parameter id_list [array(integer), required] L’elenco di ID gruppi che saranno assegnati al Power User. Può essere omesso se all è definito come true. @parameter all [boolean, optional] Se definito a true e l’id_list è vuoto, tutti i gruppi assegnabili saranno assegnati al Power User in base al filtro. Default: false @parameter filter [object, optional] Oggetto filtro @item search [string, optional] Cerca gruppi in base a nome e descrizione
Rimuovere l’Assegnazione dei Rami a un Power User
DELETE /poweruser/v1/powerusers/{user_id}/branches @get user_id [integer, required] ID Power User @parameter id_list [array(integer), required] Elenco degli ID dei rami la cui assegnazione sarà rimossa dal Power User. Può essere omesso se all è passato com true. @parameter all [boolean, optional] Se definito a true e l’id_list è vuoto, tutti i rami non assegnabili saranno rimossi dal Power User in base al filtro. Default: false @parameter filter [object, optional] Oggetto filtro @item search [string, optional] Ricerca i rami in base al nome
Elenco dei Rami Assegnati al Power User
GET /poweruser/v1/powerusers/{user_id}/branches @get user_id [integer, required] ID del Power user utilizzato per ottenere l’elenco dei rami assegnati @parameter page [integer, optional] Numero della pagina da leggere. Default: 1 @parameter page_size [integer, optional] Numero degli elementi da leggere. Default: 10 @parameter sort_type [enum(name, route, descendant), optional] Tipo di ordinamento. Default: name @parameter sort_dir [enum(asc, desc), optional] Ordinamento. Default: asc @parameter search [string, optional] Ricerca i rami in base al nome
Assegnare Rami ad un Power User
PUT /poweruser/v1/powerusers/{user_id}/branches @get user_id [integer, required] ID Power User @parameter node_list [array, required] Elenco dei rami che saranno assegnati al Power User. Può essere un array vuoto. @item [object, optional] @item id [integer, required] ID del ramo @item with_descendants [boolean, required] Se true, i discendenti del ramo sono inclusi nell’assocaizione. Se false, il contrario.
Elenco delle Categorie Associate ad un Power User
GET /poweruser/v1/powerusers/{user_id}/categories @get user_id [integer, required] ID del Power user utilizzato per ottenere l’elenco delle categorie assegnate @parameter page [integer, optional] Numero della pagina da leggere. Default: 1 @parameter page_size [integer, optional] Numero di elementi da leggere. Default: 10 @parameter sort_type [enum(name, route, descendant, courses), optional] Tipo di ordinamento. Default: name @parameter sort_dir [enum(asc, desc), optional] Ordinamento. Default: asc @parameter search [string, optional] Ricerca le categorie in base al nome
Elenco dei Corsi Associati al Power User
GET /poweruser/v1/powerusers/{user_id}/courses @get user_id [integer, required] ID del Power user utilizzato per ottenere l’elenco dei corsi assegnati @parameter page [integer, optional] Numero della pagina da leggere. Default: 1 @parameter page_size [integer, optional] Numero degli elementi da leggere. Default: 10 @parameter sort_type [enum(code, name, type), optional] Tipo di ordinamento. Default: name @parameter sort_dir [enum(asc, desc), optional] Ordinamento. Default: asc @parameter search [string, optional] Ricerca corsi in base al codice e al nome @parameter show_assignable[boolean, optional] Se a true, mostra solo i corsi assegnabili al Power User. Default: false.
Elenco dei Piani Formativi associati ad un Power User
GET /poweruser/v1/powerusers/{user_id}/lps @get user_id [integer, required] ID del Power user utilizzato per ottenere l’elenco dei piani formativi assegnati @parameter page [integer, optional] Numero della pagina da leggere. Default: 1 @parameter page_size [integer, optional] Numero degli elementi da leggere. Default: 10 @parameter sort_type [enum(code, name), optional] Tipo di ordinamento. Default: name @parameter sort_dir [enum(asc, desc), optional] Ordinamento. Default: asc @parameter search [string, optional] Ricerca dei piani formativi in base a codice e nome @parameter show_assignable[boolean, optional] Se definito a true, mostra solo i piani formativi assegnabili al Power User. Default: false
Rimuovere l’Associazione dei Cataloghi dal Power User
DELETE /poweruser/v1/powerusers/{user_id}/catalogs @get user_id [integer, required] ID Power User ID @parameter id_list [array(integer), required] Elenco degli ID dei cataloghi la cui associazione sarà rimossa dal Power User. Può essere omesso se all è passato come true. @parameter all [boolean, optional] Se definito a true e l’id_list è vuoto, tutti i cataloghi non assegnabili saranno rimossi dal Power User in base al filtro. Default: false @parameter filter [object, optional] Filtro @item search [string, optional] Ricerca cataloghi in base al codice e al nome
Elenco dei Cataloghi Associati ad un Power User
GET /poweruser/v1/powerusers/{user_id}/catalogs @get user_id [integer, required] ID del Power user utilizzato per ottenere l’elenco dei cataloghi assegnati @parameter page [integer, optional] Numero della pagina da leggere. Default: 1 @parameter page_size [integer, optional] Numero degli elementi da leggere. Default: 10 @parameter sort_type [enum(code, name), optional] Tipo di ordinamento. Default: name @parameter sort_dir [enum(asc, desc), optional] Ordinamento. Default: asc @parameter search [string, optional] Ricerca dei cataloghi in base al nome e al codice @parameter show_assignable[boolean, optional] Se a true, mostra solo i cataloghi assegnabili a questo Power User. Default: false
Assegnare Cataloghi ai Power User
PUT /poweruser/v1/powerusers/{user_id}/catalogs @get user_id [integer, required] ID Power User @parameter id_list [array(integer), required] Elenco dei cataloghi che saranno assegnati al Power User. Può essere un array vuoto. @parameter all [boolean, optional] Se definito a true e l’id_list è vuoto, tutti i cataloghi non assegnabili saranno rimossi dal Power User in base al filtro. Default: false @parameter filter [object, optional] Filtro @item search [string, optional] Ricerca dei cataloghi in base al codice e al nome
Rimuovere l’Associazione delle Sedi dal Power User
DELETE /poweruser/v1/powerusers/{user_id}/locations @get user_id [integer, required] ID Power User @parameter id_list [array(integer), required] Elenco degli ID delle sedi la cui associazione sarà rimossa dal Power User. Può essere omesso se all è passato come true. @parameter all [boolean, optional] Se definito a true e l’id_list è vuoto, tutti le sedi non assegnabili saranno rimosse dal Power User in base al filtro. Default: false @parameter filter [object, optional] Filtro @item search [string, optional] Cerca le sedi in base al nome e all’indirizzo
Elenco delle Sedi Associate ad un Power User
GET /poweruser/v1/powerusers/{user_id}/locations @get user_id [integer, required] ID del Power user utilizzato per ottenere l’elenco delle sedi assegnate @parameter page [integer, optional] Numero della pagina da leggere. Default: 1 @parameter page_size [integer, optional] Numero degli elementi da leggere . Default: 10 @parameter sort_type [enum(name, address, country, classrooms), optional] Tipo di ordinamento. Default: name @parameter sort_dir [enum(asc, desc), optional] Ordinamento. Default: asc @parameter search [string, optional] Cerca le sedi in base al nome e all’indirizzo @parameter show_assignable[boolean, optional] Se a true, mostra solo le sedi assegnabili a questo Power User. Default: false
Assegnare le Sedi ai Power User
PUT /poweruser/v1/powerusers/{user_id}/locations @get user_id [integer, required] ID Power User @parameter id_list [array(integer), required] Elenco delle sedi che saranno assegnate al Power User. Può essere un array vuoto. @parameter all [boolean, optional]Se definito a true e l’id_list è vuoto, tutti le sedi non assegnabili saranno rimosse dal Power User in base al filtro. Default: false @parameter filter [object, optional] Filtro @item search [string, optional] Ricerca le sedi in base al codice e all’indirizzo
Rimuovere l’Associazione di Corsi, Piani Formativi e Categorie dal Power User
DELETE /poweruser/v1/powerusers/{user_id}/learning-content @get user_id [integer, required] ID Power User @parameter content_list [array, required] Array degli ID e dei tipi di associazione di contenuti formativi. @item id [integer, required] Corsi, Piani Formativi, ID Categorie @item type [enum(course, coursepath, category, category_desc), required] Tipo di contenuto formativo. @parameter all [boolean, optional] Se definito a true e l’id_list è vuoto, tutti i contenuti formativi non assegnabili saranno rimossi dal Power User in base al filtro. Default: false @parameter filter [object, optional] Filtro @item search [string, optional] Ricerca corsi, piani formativi e categorie basate su codice e nome @item types [array(string), optional] Tipi di contenuti formativi da elimnare. Valori possibili: 'course', 'coursepath', 'category', 'category_desc'
Elenco dei Corsi, Piani Formativi e Categorie Associati ad un Power User
GET /poweruser/v1/powerusers/{user_id}/learning-content @get user_id [integer, required] ID Power User @parameter page [integer, optional] Numero della pagina da leggere. Default: 1 @parameter page_size [integer, optional] Numero dell’elenco da leggere. Default: 10 @parameter sort_type [enum(code, name, type), optional] Tipo di ordinamento. Default: name @parameter sort_dir [enum(asc, desc), optional] Ordinamento. Default: asc @parameter search [string, optional] Ricerca di contenuti formativi in base al codice e al nome @parameter types [array(string), optional] Tipi di contenuti formativi da elencare. I possibili valori sono: 'course', 'coursepath', 'category', 'category_desc'
Assegnare Corsi, Piani Formativi e Categorie ai Power User
PUT /poweruser/v1/powerusers/{user_id}/learning-content @get user_id [integer, required] ID Power User @parameter course [object, optional] Parametro dell’oggetto corso utilizzato per assegnare i corsi ai Power User @item id_list [array(integer), optional] Elenco degli ID dei corsi che saranno assegnati al Power User. Può essere un array vuoto. @item all [boolean, optional] Se definito a true e l’id_list è vuoto, tutti i contenuti informativi non assegnabili saranno rimossi dal Power User in base al filtro. Default: false @item filter [object, optional] Filtro @item search [string, optional] Ricerca corsi in base a codice e nome @parameter lp [object, optional] Parametro per l’assegnazione di piani formativi ai Power User @item id_list [array(integer), optional] Elenco degli ID dei piani formativi che saranno assegnati al Power User. Può essere un array vuoto. @item all [boolean, optional] Se definito a true e l’id_list è vuoto, tutti i piani formativi non assegnabili saranno rimossi dal Power User in base al filtro. Default: false @item filter [object, optional] Filtro @item search [string, optional] Cerca i piani formativi in base a codice e nome @parameter category_list [array, optional] Array degli ID di categoria con l’associazione ai discendenti @item id [integer, required] ID categoria @item with_descendants [boolean, required] Se a true, i discendendi della categoria sono inclusi nell’associazione. False: il contrario @parameter reason_code [enum(ALL_COURSE, ALL_LP, ALL_COURSE_LP, ALL_COURSE_LP_IN_CATALOG), optional] Il codice wildcard da assegnare. ALL_COURSE assegna tutti i corsi esistenti e futuri, ALL_LP assegna tutti i piani formativi esistenti e futuri, ALL_COURSE_LP assegna tutti i corsi e i piani formativi esistenti e futuri, ALL_COURSE_LP_IN_CATALOG assegna tutti i piani formativi esistenti e futuri presenti nei cataloghi visibili al Power User. @response data [object, required] Dati risposta @item success [boolean, required] True se l’operazione ha esito positivo, false al contrario
Rimozione Batch dell’Assegnazione di Utenti ai Power User
DELETE /poweruser/v1/powerusers/{user_id}/users/batch @get user_id [integer, required] ID Power User @parameter items [array, required] Array che include gli ID utente per cui rimuovere l’associazione dal Power User @item user_id [integer, required] ID utente
Rimozione Batch dell’Assegnazione di Gruppi ai Power User
DELETE /poweruser/v1/powerusers/{user_id}/groups/batch @get user_id [integer, required] ID Power User @parameter items [array, required] Array che include gli ID dei gruppi per cui rimuovere l’associazione dal Power User @item group_id [integer, required] ID Gruppo
Rimozione Batch dell’Assegnazione di Rami ai Power User
DELETE /poweruser/v1/powerusers/{user_id}/branches/batch @get user_id [integer, required] ID Power User @parameter items [array, required] Array che include gli ID dei rami per cui rimuovere l’associazione dal Power User @item branch_id [integer, required] ID Ramo
Rimozione Batch dell’Assegnazione di Cataloghi ai Power User
DELETE /poweruser/v1/powerusers/{user_id}/catalogs/batch @get user_id [integer, required] ID Power User @parameter items [array, required] Array che include gli ID dei cataloghi per cui rimuovere l’associazione dal Power User @item catalog_id [integer, required] ID Catalogo
Rimozione Batch dell’Assegnazione di Sedi ai Power User
DELETE /poweruser/v1/powerusers/{user_id}/locations/batch @get user_id [integer, required] ID Power User @parameter items [array, required] Array che include le sedi dei gruppi per cui rimuovere l’associazione dal Power User @item location_id [integer, required] ID Sede
Rimozione Batch dell’Assegnazione di Contenuti Formativi ai Power User
DELETE /poweruser/v1/powerusers/{user_id}/learning-content/batch @get user_id [integer, required] ID Power User @parameter items [array, required] Array che include gli ID delle associazioni dei contenuti formativi per cui rimuovere l’associazione dal Power User @item id [integer, required] ID corso, piano formativo o categoria @item type [enum(course, coursepath, category, category_desc), required] Tipo di contenuto formativo