Introduzione
A partire dal 28 settembre 2022, la funzionalità dei distintivi dell'app Gamification offre una nuova esperienza di gestione dei distintivi in piattaforma.
Questa funzionalità potenziata e migliorata introduce importanti cambiamenti nella piattaforma migliorando la flessibilità della gestione dei distintivi e consentendo scenari più complessi.
Grazie a questo rinnovamento, 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.
Questo articolo elenca le modifiche introdotte dal rinnovamento e le API modificate e sviluppate per questa nuova funzionalità.
L'obiettivo principale della riconfigurazione della funzionalità dei distintivi è offrire ai Superadmin una gestione più completa e intuitiva per i propri utenti. Maggiori informazioni su come creare e gestire i distintivi.
Raccolte di Distintivi
Le raccolte di distintivi sono gruppi di distintivi che consentono ai Superadmin di creare più campagne, attive anche contemporaneamente in piattaforma. Consentono di rendere disponibili i distintivi associati solo a una selezione personalizzata di rami o a un gruppo personalizzato di utenti.
Le raccolte possono essere utili in diversi scenari, ad esempio quando si desidera disporre di diversi set di distintivi per rami o gruppi di utenti diversi.
Ad esempio, potrebbe essere necessario assegnare dei distintivi a:
- i dipendenti che completano il corso "Linee guida aziendali"
- gli utenti che condividono un contributo, e
- gli utenti che completano il "Corso sulla sicurezza".
A tale scopo, è possibile creare tre set di distintivi e gestirne la disponibilità:
- una raccolta predefinita a disposizione di tutta l'azienda che è possibile associare alla regola di completamento del corso "Linee guida aziendali", in modo che chiunque in azienda possa ottenere il distintivo "Linee guida aziendali" al termine del corso.
- una raccolta “Ramo Europa” disponibile solo per il ramo europeo che è possibile associare alle regole “Corso sulla sicurezza” e “Condivisione”, in modo che i dipendenti della filiale europea possano ottenere i distintivi al completamento del “Corso sulla sicurezza” o alla condivisione di un contributo.
- una raccolta “Ramo USA” disponibile solo per il ramo USA che è possibile associare al “Corso sulla sicurezza”, in modo che i dipendenti del ramo americano possano ottenere il distintivo al completamento del “Corso sulla sicurezza”.
Disponibilità dei Distintivi Esistenti
Nell'esperienza precedente, i distintivi erano disponibili a tutta l'azienda. Al fine di mantenere la stessa regola dopo la transizione alla nuova gestione dei distintivi, i distintivi esistenti sono stati assegnati alla raccolta Predefinita, disponibile per tutti gli utenti.
Non è possibile eliminare la raccolta predefinita né cambiarne la disponibilità, ma è possibile modificarla, aggiornando il nome e la descrizione e aggiungendo o rimuovendo i distintivi associati.
Idoneità dei Distintivi
Quando si crea un distintivo, verrà chiesto di compilare il campo Idoneità al Distintivo.
Questa descrizione consente ai Superadmin di indicare agli utenti come ottenere il distintivo in base alle regole automatiche che il Superadmin può impostare durante la configurazione del distintivo.
Gli utenti potranno vedere questa descrizione nell'area Gamification anche prima di ottenere il distintivo e saranno quindi incoraggiati a "giocare".
Codice Distintivo
È possibile impostare codici identificativi per i distintivi.
Visibilità dei Distintivi
Le opzioni Visibilità agli Utenti consentono ai Superadmin di decidere se gli utenti saranno in grado di vedere sia il distintivo che i punti ad esso associati o solo i punti nell'area Gamification.
Distintivi Solo Punti
Con la nuova gestione dei distintivi è possibile creare dei distintivi “Solo Punti”. Questo tipo di distintivo non sarà visibile allo studente nell'area Gamification, ma aumenterà solo il numero totale di punti guadagnati (o lo diminuirà, se si imposta un valore negativo per il distintivo solo punti).
Disattivare i Distintivi
È possibile impostare lo stato di un distintivo come Non Pubblicato, disattivandolo. I distintivi non pubblicati non saranno più assegnati automaticamente agli utenti, ma potranno ancora essere assegnati manualmente. I distintivi già assegnati rimarranno visibili agli utenti nell'area Gamification. Si può sempre riattivare il distintivo riportando lo stato su Pubblicato.
Nuove Immagini per i Distintivi
A partire dal 24 maggio 2022, è possibile scegliere immagini per i distintivi da un catalogo più ampio. In alternativa, si può scegliere di caricare le proprie immagini.
Assegnare i Distintivi agli Utenti
Con la nuova gestione dei distintivi sarà possibile assegnare manualmente anche i distintivi per i quali è stata impostata l'assegnazione automatica.
API Modificate
Questa tabella elenca tutte le API che sono state modificate con il rinnovamento dei distintivi.
Descrizione API |
Verbo API |
URL API |
Ora l'API, quando è attivo l'interruttore dei nuovi distintivi, restituirà il testo del conseguimento invece di quello di idoneità |
GET |
/share/v1/gamification/assigned_badge/{uuid}/public? |
Ora l'API, quando è attivo l'interruttore dei nuovi distintivi, restituirà il testo del conseguimento invece di quello di idoneità nella descrizione OG |
GET |
/share/v1/gamification/assigned_badge/{UUID}/shared |
Ora l'API restituirà un errore se il distintivo da condividere è solo punti. I distintivi solo punti non erano disponibili in precedenza |
GET |
/share/v1/gamification/assigned_badge/{UUID}/shared |
Nuove API
Questa tabella elenca le API disponibili per la nuova funzionalità dei distintivi. Queste API sono pienamente operative dal 28 settembre 2022.
Descrizione API |
Verbo API |
URL API |
Recupera l'elenco delle raccolte di distintivi, con le opzioni di filtro |
GET |
/share/v1/gamification/collections |
Recupera le proprietà di una raccolta di distintivi |
GET |
/share/v1/gamification/collections/{id} |
Crea una nuova raccolta di distintivi |
POST |
/share/v1/gamification/collections |
Aggiorna una proprietà di una raccolta di distintivi (ad esempio: attiva o disattiva) |
PATCH |
/share/v1/gamification/collections/{id_collection} |
Associa distintivi e raccolte |
PUT |
/share/v1/gamification/collections/badges |
Elimina una o più raccolte |
DELETE |
/share/v1/gamification/collections/batch |
Aggiorna le proprietà di una raccolta |
PUT |
/share/v1/gamification/collections/{id_collection} |
Rimuovi associazioni tra distintivi e raccolte |
DELETE |
/share/v1/gamification/collections/{id_collection}/badges |
Crea un nuovo distintivo |
POST |
/share/v1/gamification/badges |
Aggiorna una proprietà di un distintivo (ad esempio: attiva o disattiva) |
PATCH |
/share/v1/gamification/badges/{id_badge} |
Elimina uno o più distintivi |
DELETE |
/share/v1/gamification/badges/batch |
Recupera le proprietà di una raccolta di distintivi |
GET |
/share/v1/gamification/badges/{id_badge} |
Recupera l'elenco degli utenti a cui è stato assegnato il distintivo {id_badge} |
GET |
/share/v1/gamification/{id_badge}/assigned_users |
Richiama l'elenco delle assegnazioni del distintivo {id_badge} all'utente {id_user} |
GET |
/share/v1/gamification/badges/{id_badge}/users/{id_user}/assigned |
Salva il distintivo e le sue proprietà |
PUT |
/share/v1/gamification/badges/{id_badge} |
Recupera le immagini standard e personalizzate disponibili per i distintivi |
GET |
/share/v1/gamification/badges/images |
Elimina una specifica immagine personalizzata del distintivo precedentemente caricata |
DELETE |
/share/v1/gamification/badges/images/{image_id} |
Associa il distintivo {id_badge} agli utenti specificati |
PUT |
/share/v1/gamification/badges/{id_badge}/assigned_users/batch |
Rimuovi tutte le assegnazioni del distintivo {id_badge} agli utenti specificati |
DELETE |
/share/v1/gamification/badges/{id_badge}/assigned_users/batch |
Rimuovi determinate assegnazioni del distintivo {id_badge } agli utenti |
DELETE |
/share/v1/gamification/badges/{id_badge}/users/{id_user}/assigned_achievement/batch |
Restituisci il materiale didattico di un corso {course_id}. L'elenco è specifico per essere utilizzato nei distintivi e non deve essere utilizzato per altri scopi |
GET |
/share/v1/gamification/courses/{id_course}/los |