Transizione alla Nuova Gestione dei Power User

Scopri la nuova gestione dei Power User

Ultimo Aggiornamento

16 Ottobre 2020

Modulo Docebo

App

Tempo di Lettura

20 min

Livello Utente

,

Introduzione

A partire dal 27 Ottobre 2020, la app Power User offrirà 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 dellattuale 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 l’attuale gestione dei Power User, è possibile assegnare tutti i corsi e i piani formativi definiti in piattaforma ad un profilo Power User.

Poiché la nuova gestione dei Power User permetterà 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 sarà 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 saranno automaticamente migrati alla nuova esperienza utente.

Questa modifica non richiede alcuna attività da parte dei Superadmin.

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 per sei mesi dopo il rilascio della funzionalità, fino alla fine di Aprile 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 APIVerbo APIURL API
Assegnazione di cataloghi ad un Power UserPOST/learn/v1/pu/assign_catalogs
Assegnazione delle categorie corsi ad un Power UserPOST/learn/v1/pu/assign_categories
Assegnazione di corsi ad un Power UserPOST/learn/v1/pu/assign_courses
Assegnazione di sedi ad un Power UserPOST/learn/v1/pu/assign_locations
Assegnazione di rami ad un Power UserPOST/learn/v1/pu/assign_orgcharts
Assegnazione di utenti ad un Power UserPOST/learn/v1/pu/assign_users
Promozione di un utente al ruolo di Power UserPOST/learn/v1/pu
Assegnazione del ruolo di utente ad un Power UserPOST/learn/v1/pu/{id}
Riepilogo dei permessi assegnati ad un profilo Power UserGET/manage/v1/powerusers/permissions
Rimozione dell’assegnazione di un permesso ad un profilo Power UserDELETE/manage/v1/powerusers/profiles/{id}/permissions
Assegnazione di un permesso ad un profilo Power UserPOST/manage/v1/powerusers/profiles/{id}/permissions/learn/v1/pu/{id}
Cancellazione di un profilo Power UserDELETE/manage/v1/powerusers/profiles/{id}
Richiesta di un elenco di profili Power UserGET/manage/v1/powerusers/profiles
Creazione di un profilo Power UserPOST/manage/v1/powerusers/profiles
Aggiornamento di un profilo Power UserPUT/manage/v1/powerusers/profiles/{id}
Rimozione di corsi, piani formativi e categorie assegnate ad un Power UserDELETE/manage/v1/powerusers/{user_id}/courses
Rimozione di utenti, gruppi e rami assegnati ad un Power UserDELETE/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 APIVerbo APIURL API
Rimozione dell’assegnazione Power UserDELETE/poweruser/v1/powerusers
Richiesta dell’elenco dei Power UserGET/poweruser/v1/powerusers
Creazione Power UserPOST/poweruser/v1/powerusers
Rimozione batch dell’assegnazione Power UserDELETE/poweruser/v1/powerusers/batch
Richiesta dei dettagli di un Power UserGET/poweruser/v1/powerusers/{user_id}
Aggiornamento Power UserPUT/poweruser/v1/powerusers/{user_id}
Richiesta dell’elenco dei profili associati ad un Power UserGET/poweruser/v1/powerusers/{user_id}/profiles
Rimozione dell’assegnazione dei profiliDELETE/poweruser/v1/powerusers/profiles
Assegnazione dei profili Power UserPUT/poweruser/v1/powerusers/profiles
Rimozione batch dei profliDELETE/poweruser/v1/powerusers/profiles/batch
Assegnazione batch dei profiliPUT/poweruser/v1/powerusers/profiles/batch
Rimozione degli utenti assegnati ad un Power UserDELETE/poweruser/v1/powerusers/{user_id}/users
Richiesta dell’elenco degli utenti associati ad un Power UserGET/poweruser/v1/powerusers/{user_id}/users
Assegnazione di utenti ad un Power UserPUT/poweruser/v1/powerusers/{user_id}/users
Rimozione dei gruppi assegnati ad un Power UserDELETE/poweruser/v1/powerusers/{user_id}/groups
Richiesta dell’elenco dei gruppi associati ad un Power UserGET/poweruser/v1/powerusers/{user_id}/groups
Assegnazione di gruppi ad un Power UserPUT/poweruser/v1/powerusers/{user_id}/groups
Rimozione dei rami assegnati ad un Power UserDELETE/poweruser/v1/powerusers/{user_id}/branches
Richiesta dell’elenco dei rami associati ad un Power UserGET/poweruser/v1/powerusers/{user_id}/branches
Assegnazione di rami ad un Power UserPUT/poweruser/v1/powerusers/{user_id}/branches
Richiesta dell’elenco delle categorie associate ad un Power UserGET/poweruser/v1/powerusers/{user_id}/categories
Richiesta dell’elenco dei corsi associati ad un Power UserGET/poweruser/v1/powerusers/{user_id}/courses
Richiesta dell’elenco dei piani formativi associati ad un Power UserGET/poweruser/v1/powerusers/{user_id}/lps
Rimozione dei cataloghi assegnati ad un Power UserDELETE/poweruser/v1/powerusers/{user_id}/catalogs
Richiesta dell’elenco dei cataloghi associati ad un Power UserGET/poweruser/v1/powerusers/{user_id}/catalogs
Assegnazione di cataloghi ad un Power UserPUT/poweruser/v1/powerusers/{user_id}/catalogs
Rimozione delle sedi assegnati ad un Power UserDELETE/poweruser/v1/powerusers/{user_id}/locations
Richiesta dell’elenco delle sedi associate ad un Power UserGET/poweruser/v1/powerusers/{user_id}/locations
Assegnazione di sedi ad un Power UserPUT/poweruser/v1/powerusers/{user_id}/locations
Rimozione di corsi, piani formativi e categorie assegnati ad un Power UserDELETE/poweruser/v1/powerusers/{user_id}/learning-content
Richiesta dell’elenco di corsi, piani formativi e categorie associate ad un Power UserGET/poweruser/v1/powerusers/{user_id}/learning-content
Assegnazione di corsi, piani formativi e categorie ad un Power UserPUT/poweruser/v1/powerusers/{user_id}/learning-content
Rimozione batch dell’associazione di utenti ai Power UserDELETE/poweruser/v1/powerusers/{user_id}/users/batch
Rimozione batch dell’associazione di gruppi ai Power UserDELETE/poweruser/v1/powerusers/{user_id}/groups/batch
Rimozione batch dell’associazione di rami ai Power UserDELETE/poweruser/v1/powerusers/{user_id}/branches/batch
Rimozione batch dell’associazione di cataloghi ai Power UserDELETE/poweruser/v1/powerusers/{user_id}/catalogs/batch
Rimozione batch dell’associazione di sedi ai Power UserDELETE/poweruser/v1/powerusers/{user_id}/locations/batch
Rimozione batch dell’associazione di corsi, piani formativi e categorie ai Power UserDELETE/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