Introduzione
A partire dal 2 febbraio 2021, la funzionalità Contribuisci e i processi di modifica dei contributi di revisione dell'esperto saranno migliorati per offrire un modo completamente rinnovato per contribuire e gestire i contributi in piattaforma. Il nome della funzionalità cambia da Contribuisci a Condividi Contenuti e la stessa modifica si applica al nome della pagina raggiungibile dal menu utente.
Questa funzionalità avanzata e migliorata introduce importanti cambiamenti in piattaforma e il nuovo processo di condivisione migliora la sicurezza e la privacy dei contenuti condivisi dagli utenti nella piattaforma. Inoltre, è stata ridisegnata l'interfaccia utente delle aree in cui gli utenti condividono e modificano i contributi (contenuti informali), gli esperti li rivedono e li pubblicano, e i Superadmin gestiscono e monitorano il processo in linea con il nuovo comportamento delle funzionalità e il nuovo layout della piattaforma.
Questo articolo elenca le modifiche introdotte da questo miglioramento della funzionalità ed elenca le API che sono state modificate e sviluppate per questa nuova funzionalità.
Nuova interfaccia utente ed esperienza
L'attuale restyling dell'interfaccia utente offre un modo più semplice e intuitivo per condividere, modificare, rivedere e gestire i contributi in piattaforma e le aree della piattaforma in cui vengono eseguite queste azioni sono state ridisegnate in linea con il suo nuovo layout.
Con la nuova esperienza Condividi contenuti, l'utente è ora in grado di scegliere quale tipo di contenuto condividere, completare l'intera configurazione (opzioni di condivisione incluse) e quindi completare l'azione direttamente dal pannello di destra.
L'esperienza di modifica dei contributi per gli utenti è stata ridisegnata e suddivisa in due schede dedicate. Il primo mostra le informazioni generali sul contributo e il secondo consente all'utente di vedere a colpo d'occhio tutte le persone e i canali con cui ha condiviso il contributo.
Il processo di revisione dell'esperto è stato migliorato ed è ora più facile da usare, come completamente descritto nel capitolo dedicato di seguito in questo documento. Per quanto riguarda la gestione dei contributi da parte dei Superadmin, è stata aggiunta una scheda dedicata nel menu Gestione Canali, dove gli amministratori possono vedere in un unico posto tutte le informazioni sui contributi condivisi nelle loro piattaforme.
Inoltre, nella pagina Impostazioni Discover, Coach & Share è stata rimossa la sezione Contributi Privati (il concetto di contributi pubblici o privati non esiste più) ed è stata invece aggiunta la nuova opzione Permessi di Condivisione per consentire ai Superadmin di configurare i permessi di condivisione dei contributi per i propri utenti.
Infine, è stato aggiunto un nuovo widget denominato Condividi Contenuti, che mostra il contenuto condiviso dagli utenti nella piattaforma e consente agli utenti di caricare e condividere nuovi contenuti.
Deprecazione dello stato privato/pubblico per la visibilità di contributi
Come funziona adesso?
Nella funzionalità di Contribuisci corrente, quando un utente pubblica un contributo, deve definire uno stato per la visibilità del contributo: pubblica o privata. Un contributo pubblico può essere condiviso con (e pubblicato in) canali. Dopo che un utente ha pubblicato il contributo, può invitare altri utenti o canali a guardarlo. Ricordare che un utente può invitare solo altri utenti che hanno già visibilità sui canali in cui il contributo è pubblicato. Un contributo privato è visibile solo all'utente che condivide il contributo e agli utenti che invita a guardare il contributo. Se la visibilità del contributo è impostata su Privato, il contributo può essere condiviso con singole persone specifiche utilizzando la funzionalità Invita a guardare. Qualsiasi utente dell'intera piattaforma può essere invitato a guardare un contributo privato, senza alcuna regola di visibilità.
Come funzionerà con la nuova funzionalità?
Con la nuova funzionalità Condividi Contenuti, il concetto di contributi pubblici o privati non esiste più. Durante la condivisione dei contenuti, l'utente può scegliere tra due opzioni:
- Condivisione del contenuto con canali e/o persone;
- Salvare il contenuto solo per se stesso. Il contenuto viene salvato nella pagina Il mio Canale dell'utente e sarà visibile solo a se stesso e non verrà visualizzato nei risultati di ricerca di altri utenti.
Un contributo può essere condiviso con canali e persone contemporaneamente e nello stesso pannello.
Nel menu di amministrazione delle Impostazioni Discover, Coach & Share, il Superadmin può configurare le opzioni di condivisione disponibili per l'utente. La nuova impostazione Permessi di Condivisione consente ai Superadmin di scegliere tra quattro opzioni:
- L'utente può condividere contenuti con entrambi i canali e altre persone;
- L'utente può condividere i contenuti solo con i canali;
- L'utente può condividere contenuti con canali e persone appartenenti agli stessi rami;
- L'utente può condividere contenuti con canali e persone appartenenti agli stessi rami e sotto-rami.
Se l'Extended Enterprise è abilitato nella piattaforma, sono disponibili solo le due seguenti opzioni:
- L'utente può condividere i contenuti solo con i canali;
- L'utente può condividere contenuti con canali e persone appartenenti allo stesso sottodominio.
Per le piattaforme in cui l'opzione per consentire agli utenti di caricare contributi privati è attualmente disabilitata (sezione Contributi privati nel menu Impostazioni Discover, Coach & Share, rimossa nella nuova funzionalità come spiegato nella sezione precedente), la nuova impostazione Permessi di Condivisione è impostata su Condividi contenuti solo con i canali, consentendo agli utenti di condividerei contributi solo con i canali. Per le piattaforme in cui l'opzione Contributi privati è attualmente abilitata, la nuova impostazione è impostata su Condividi contenuti con canali e persone (o Condividi contenuti con canali e persone nello stesso sottodominio se l'app Extended Enterprise è attiva nella piattaforma), consentendo agli utenti di condividere contributi sia con canali che con persone.
Un altro miglioramento è che dalla nuova scheda Contributi nel menu Gestione canali, il Superadmin può facilmente visualizzare, per ciascun contributo, con quanti canali e persone è stato condiviso il contributo.
Inoltre, per gli utenti, le nuove opzioni di condivisione sono più intuitive e più facili da capire rispetto al concetto di contributi privati e pubblici. Sono anche più facili da gestire dai Superadmin, grazie all'aggiunta della nuova impostazione Permessi di condivisione nel menu Impostazioni Discover, Coach & Share e alla nuova scheda Contributi nel menu Gestione Canali.
Revisione dell'esperto
Come funziona adesso?
Nella funzionalità corrente, quando un esperto deve approvare un contributo in modo che possa essere pubblicato in un canale, apre la pagina del contributo, la modifica e utilizza l'interruttore Annulla pubblicazione - Pubblica per approvare e quindi pubblicare il contributo appena rivisto. Quando l'esperto rivede un contributo, la casella di chat Esperto Relativo progettata per la comunicazione tra l'utente che ha fornito il contributo e l'esperto che ha bisogno di esaminarlo è scarsamente utilizzata (o non utilizzata affatto, poiché esperti e collaboratori preferiscono comunicare), quindi non sarà più disponibile nella nuova funzionalità.
Come funzionerà con la nuova funzionalità?
Con la nuova funzionalità, quando un esperto deve approvare un contributo, una volta nella pagina del contributo, troverà i pulsanti Approva contributo e Rifiuta contributo nella parte superiore della pagina. Se l'esperto approva il contributo, verrà pubblicato nei canali in cui l'utente ha scelto di condividerlo e di cui è esperto. Se l'esperto rifiuta il contributo, non verrà pubblicato nei canali in cui l'utente ha scelto di condividerlo e di cui è un esperto. Tenere presente che questo contributo può essere pubblicato in un canale in cui un altro utente è un esperto se l'esperto di quel canale ha approvato la pubblicazione nel canale che gestisce come esperto. L'approvazione dell'esperto può consentire solo la pubblicazione del contributo nel canale di cui è esperto. Il nuovo comportamento per la revisione dell'esperto è più intuitivo e consente a ciascun esperto di monitorare da vicino la pubblicazione dei contributi nei canali da lui gestiti.
Ricondivisione dei contenuti da parte degli utenti
Come funziona adesso?
Con la funzionalità corrente, qualsiasi utente che è stato invitato a guardare una contributo privato può quindi inviare un invito a guardare il contributo (e di conseguenza concedere i permessi per visualizzarlo) a tutti gli altri utenti dell'intera azienda. L'unica eccezione è quando l'app Extended Enterprise è attiva in piattaforma.
Come funzionerà con la nuova funzionalità?
Con la nuova funzionalità, se un utente è stato invitato a guardare un contributo, può inviare un invito a guardarlo solo agli utenti che hanno già i permessi per visualizzare il contributo. Solo il Superadmin della piattaforma e l'utente che ha caricato il contributo possono estendere i permessi di visibilità del contributo, aggiungendo nuovi canali o persone dalla pagina di modifica del contributo. l Superadmin e l'utente che ha caricato il contributo nella piattaforma possono ora controllare e gestire facilmente le attività di condivisione dei contributi, senza il rischio di una condivisione incontrollata.
Indirizzo e-mail dell'utente invitato a guardare
Come funziona adesso?
Nella funzionalità corrente, quando un utente invita altri utenti a guardare un contributo, l'indirizzo e-mail degli utenti che possono essere invitati viene mostrato insieme ai loro nomi utente.
Come funzionerà con la nuova funzionalità?
Per motivi di privacy, le email degli utenti non possono più essere visualizzate né quando si invitano a guardare né quando si condividono contenuti con altri utenti o canali. Vengono visualizzati solo i nomi utente.
Visualizzazione delle statistiche di invito a guardare
Come funziona adesso?
Al momento, quando un utente modifica un contributo, può anche selezionare il pulsante Analitica nell'angolo in alto a destra della pagina di modifica del contributo per visualizzare i dati e le statistiche sugli inviti inviati a guardare il contributo.
Come funzionerà con la nuova funzionalità?
Con la nuova esperienza di modifica del contributo, la pagina delle statistiche nella funzione Invita a guardare non sarà più disponibile dalla pagina di modifica del contributo. Gli utenti potranno visualizzare i dati sulle visualizzazioni del contributo che hanno condiviso (numero di visualizzazioni e data) direttamente dalla scheda Condiviso con nella pagina di modifica del contributo, mentre i Superadmin possono accedere alle statistiche dal rapporto Riepilogo contributi raggiungibile dal menu dei rapporti.
API modificate
La tabella delle API modificate elenca tutte le API che sono state modificate con la nuova funzionalità Condividi contenuto e i nuovi processi associati per la modifica dei contributi e la revisione dell'esperto. Tre dei seguenti sono modifiche sostanziali.
| Descrizione API | Verbo API | URL API | Modifiche |
|---|---|---|---|
| Ottieni le impostazioni di ShareApp | GET | /share/v1/settings | Aggiunto il parametro opzionale "share_to_people" per definire i permessi di condivisione |
| Aggiorna le impostazioni di ShareApp | PUT | /share/v1/settings | Aggiunto il parametro opzionale "share_to_people" per definire i permessi di condivisione |
| Restituisce i contributi disponibili nella piattaforma | GET | /share/v1/admin/assets | Aggiunto l'elemento "people_assignment_count" nella risposta. Aggiunto l'elemento "included_in_channels" nella risposta. Rappresenta l'elenco dei canali assegnati al contributo. Modifica decisiva - In precedenza, se la visibilità del contributo era impostata come privata e il contributo non era assegnato ad alcun canale, l'elemento "channels_assignment_count" non veniva restituito. Con la nuova funzionalità Condividi contenuto, se il contributo non è assegnato a nessun canale, l'elemento "channels_assignment_count" restituirà il valore "0". In generale, viene restituito il numero di canali a cui è assegnato il contributo. |
| Aggiorna contributo | PUT | /share/v1/assets/{id_asset} | Aggiunti 2 parametri di input opzionali: "nome_file" e "nome_file_originale" |
| Visualizzazione contributo | GET | /share/v1/assets/{id_asset} | Aggiunto il parametro di input opzionale "show_users" = true. Se superato, viene restituito l'elenco degli utenti invitati a guardare il contributo. |
| Recupera tutti gli utenti invitabili per un contributo specifico | GET | /share/v1/assets/{id_asset}/invitations/users | L'elenco degli utenti che possono essere invitati viene ora calcolato in base alla configurazione dell'impostazione dei Permessi di Condivisione. Modifica decisiva - Il parametro "ricerca" è ora obbligatorio per i requisiti di sicurezza. |
| Recupera l'invito a guardare le informazioni iniziali | GET | /share/v1/assets/{id_asset}/invitations/suggestions | L'elenco degli utenti che possono essere suggeriti per l'invito verrà ora calcolato in base alla configurazione dell'impostazione dei Permessi di Condivisione |
| Crea un nuovo caricamento di tipo immagine | POST | /share/v1/image | Applicata nuova logica di revisione |
| Crea un nuovo caricamento di tipo link | POST | /share/v1/link | Applicata nuova logica di revisione. Aggiunto il nuovo parametro "content_type" per impostare il tipo di collegamento. Il tipo può essere: link, documenti, fogli o diapositive. |
| Crea un nuovo caricamento di tipo link video per Vimeo, Youtube, Wistia | POST | /share/v1/videolink | Applicata nuova logica di revisione |
| Aggiorna contributo | PUT | /share/v1/assets/{id_asset} | Applicata nuova logica di revisione |
| Crea un nuovo corso | POST | /learn/v1/courses | Applicata nuova logica di revisione |
| Aggiorna corso specifico | PUT | /learn/v1/courses/{id} | Applicata nuova logica di revisione |
| Crea un nuovo caricamento di tipo video | POST | /share/v1/video | Applicata nuova logica di revisione. Modifica decisiva - In precedenza, il parametro "thumbnail_url" veniva ignorato. Con la nuova funzionalità Condividi contenuto, se questo parametro viene passato (opzionale), la thumbnail viene impostata come predefinita per il contributo. |
| Visualizzazione contributo | GET | /share/v1/assets/{id_asset} | Aggiunto l'elemento "peer_review" nella risposta. Rappresenta lo stato del contributo in un canale specifico in cui è necessaria la revisione di un esperto. |
| Aggiungi una thumbnail personalizzata per un determinato contributo | POST | /share/v1/assets/{id_asset}/thumbnails | Aggiunto il parametro opzionale "not_default" per decidere se utilizzare una thumbnail per impostazione predefinita |
| Crea un nuovo contributo | POST | /share/v1/assets | Aggiunto il parametro "tag" per associare i tag al contributo |
| Invia invito a guardare gli inviti | POST | /share/v1/assets/{id_asset}/invitations | In precedenza, se questa API veniva utilizzata per invitare di nuovo un utente già invitato a guardare un contributo, l'API restituiva un errore. Ora è possibile invitare lo stesso utente più di una volta e non viene restituito alcun errore. |
| Visualizza i canali assegnati ai contributi | GET | /share/v1/assets/{id_asset}/channels | Aggiunto il nuovo parametro "search_text" per filtrare i risultati per nome |
| Recupera i contributi del canale | GET | /share/v1/admin/channels/{id_channel}/content | Nuova logica di revisione applicata allo stato del contributo |
Nuove API
La tabella Nuove API elenca le API disponibili per la nuova funzionalità Condividi contenuto e i nuovi processi associati per la modifica dei contributi e la revisione dell'esperto. Queste API saranno pienamente operative a partire dal 2 febbraio 2021.
| Descrizione API | Verbo API | URL API |
|---|---|---|
| Crea un'associazione tra i contributi e i canali | POST | /share/v1/admin/channels/assets |
| Recupera gli utenti che sono stati invitati a guardare un contributo | GET | /share/v1/assets/{id_asset}/users |
| Rimuove le associazioni tra un utente e un contributo | DELETE | /share/v1/admin/user/{id_user}/asset/{id_asset} |
| Ottieni metadati e immagini dei link | GET | /share/v1/link/meta |
| Controlla se esiste un video di registrazione video specifico caricato come contributi. | GET | /share/v1/screenrecorder/upload/status |
| Approva un contributo nei canali per cui sei un esperto | POST | /share/v1/assets/{id_asset}/approve |
| Rifiuta un contributo nei canali per cui sei un esperto | POST | /share/v1/assets/{id_asset}/reject |
| Elimina un invito utente | DELETE | /share/v1/assets/{id_asset}/invitations/{id_user} |
| Crea un nuovo caricamento di tipo documento | POST | /share/v1/document |
| Modifica un caricamento di tipo video | PUT | /share/v1/video/{id_asset} |
| Modifica un caricamento di tipo documento | PUT | /share/v1/document/{id_asset} |
| Crea un nuovo caricamento di tipo generico | POST | /share/v1/generic |
Per ogni nuova API, l'elenco dei parametri è dettagliato nelle sezioni seguenti.
Crea un'associazione tra contributi e canali
POST /share/v1/admin/channels/assets @parameter assets [array(integer), required] : I contributi da associare ai canali @parameter channels [array(integer), required] : I canali da associare ai contributi
Recupera gli utenti che sono stati invitati a guardare un contributo
GET /share/v1/assets/{id_asset}/users @get id_asset [integer, required] : L'ID del contributo @parameter sort_attr [enum(user_id, username, fullname), optional] @parameter sort_dir [enum(asc, desc), optional] : La direzione di ordinamento: asc = ascendente, desc = discendente. Default: asc @parameter page [integer, optional] : PAgina su cui tornare. Default: 1 @parameter page_size [integer, optional] : Il numero massimo di risultati per pagina. Predefinito: dipendente dalla piattaforma
Rimuove le associazioni tra un utente e un contributo
DELETE /share/v1/admin/user/{id_user}/asset/{id_asset} @get id_user [integer, required] : The ID of the user @get id_asset [integer, required] : L'ID del contributo
Ottiene metadati e immagini dei link
GET /share/v1/link/meta @parameter url [string, required] : L'URL da cui vengono estratte le informazioni
Controlla se esiste uno specifico video di registrazione video caricato come contributo
GET /share/v1/screenrecorder/upload/status @parameter filename [string, required] : Il nome del file
Approva un contributo nei canali in cui sei un esperto
POST /share/v1/assets/{id_asset}/approve @get id_asset [integer, required] : L'ID del contributo
Rifiuta un contributo nei canali in cui si è esperti
POST /share/v1/assets/{id_asset}/reject @get id_asset [integer, required] : L'ID del contributo
Elimina un invito utente
DELETE /share/v1/assets/{id_asset}/invitations/{id_user} @get id_asset [integer, required] : The ID of the asset @get id_user [integer, required] : L'ID dell'utente
Crea un nuovo caricamento di tipo documento
POST /share/v1/document @parameter url [string, required] : L'URL del documento @parameter title [string, required] : Il titolo del documento @parameter description [string, required] : La descrizione del documento @parameter original_filename [string, required] : Il nome file originale del documento @parameter thumbnail_url [string, optional] : The URL of the thumbnail @parameter channels [array(integer), optional] : L'elenco degli ID dei canali in cui è pubblicato il documento @parameter tags [array(string), optional] : L'elenco dei tag assegnati al documento
Modifica di un caricamento di tipo Video
PUT /share/v1/video/{id_asset} @get id_asset [integer, required] : L'ID del contributo @parameter url [string, required] : L'URL del video @parameter title [string, required] : Il titolo del video @parameter description [string, required] : La descrizione del video @parameter original_filename [string, required] : Il nome del file originale del video @parameter thumbnail_url [string, optional] : L'URL della thumbnail @parameter channels [array(integer), optional] : L'elenco degli ID dei canali in cui è pubblicato il video @parameter tags [array(string), optional] : L'elenco dei tag assegnati al video
Modifica un caricamento di tipo video
PUT /share/v1/document/{id_asset} @get id_asset [integer, required] : The ID of the asset @parameter url [string, required] : The URL of the document @parameter title [string, required] : The title of the document @parameter description [string, required] : The description of the document @parameter original_filename [string, optional] : The original filename of the document @parameter thumbnail_url [string, optional] : The URL of the thumbnail @parameter channels [array(integer), optional] : The list of IDs of the channels where the document is published @parameter tags [array(string), optional] : The list of tags assigned to the document
Crea un tipo di caricamento generico
POST /share/v1/generic @parameter url [string, required] : L'URL del contributo @parameter title [string, required] : Il titolo del contributo @parameter content_type [integer, optional] :Il tipo di contenuto del contributo. Valori accettati : 6, 10, 11, 12, 13 @parameter description [string, required] : La descrizione del contributo @parameter original_filename [string, required] : The original filename of the asset @parameter thumbnail_url [string, optional] : The URL of the thumbnail @parameter channels [array(integer), optional] : L'elenco degli ID dei canali in cui il contributo è pubblicato @parameter tags [array(string), optional] : L'elenco dei tag assegnati al contributo