Introduction
A partir du 2 février 2021, la fonctionnalité Contribuer et la modification des contributions associées ainsi que le processus de revue par les pairs sont améliorés afin de vous offrir une manière renouvelée de contribuer et gérer les contributions de votre plateforme. Le nom de la fonctionnalité passe de Contribuer à Partager Contenu et le même changement s’applique au nom de la page accessible depuis le menu utilisateur.
Cette fonctionnalité enrichie et améliorée introduit des changements importants dans votre plateforme et le nouveau processus de partage améliore la sécurité et la confidentialité des contenus partagés par les utilisateurs dans la plateforme. De plus l’interface utilisateurs des espaces où les utilisateurs partagent et modifient des contributions (contenu informel), où les experts les évaluent et les publient et où les Superadmins gèrent et suivent le processus a été repensé en accord avec le nouveau fonctionnement et le nouvel aspect de la plateforme.
Cet article liste les changements introduits par les améliorations apportées à cette fonctionnalité et liste les API qui ont été modifiées et développées pour cette nouvelle fonctionnalité.
Nouvelle Interface et Expérience Utilisateur
Le remaniement de l’interface utilisateur actuelle permet une manière plus simple et plus intuitive de partager, modifier, évaluer et gérer les contributions de la plateforme. Les espaces de la plateforme où ces actions sont effectuées ont été repensés en accord avec le nouvel aspect de la plateforme.
Avec la nouvelle expérience de partage de contenu, l’utilisateur peut maintenant choisir quel type de contenu partager, faire l’ensemble de la configuration (options de partage inclus), et compléter l’action depuis le panneau de droite.
L'expérience de modification de contribution pour les utilisateurs a été remaniée et divisée en deux onglets dédiés. Le premier affiche des informations générales en lien avec la contribution et le deuxième permet à l’utilisateur de voir en un clin d'œil toutes les personnes et les chaînes avec qui il/elle a partagé la contribution.
Le processus de revue par les pairs a été amélioré et est maintenant plus simple d’utilisation comme décrit plus en détails dans le chapitre plus bas dans cet article. Concernant la gestion des contributions par les Superadmins, un onglet dédié dans le menu Gestion des Chaînes a été ajouté où les administrateurs peuvent voir dans un seul espace toutes les informations sur les contributions partagées dans la plateforme.
De plus, sur la page Paramètres Discover, Coach & Share, la section Contribution Privée a été retirée ( le concept de contributions publiques ou privées n’existe plus) et a été remplacée par l’option Autorisations de Partage pour permettre aux Superadmins de configurer les autorisations de partage pour les utilisateurs.
Enfin, un nouveau widget nommé Partager Contenu a été ajouté, il affiche le contenu partagé par les utilisateurs et leur permet de télécharger et de partager du nouveau contenu.
Abandon du Statut Privé/Public pour la Visibilité des Contributions
Comment cela fonctionne-t-il maintenant ?
Avec la fonctionnalité actuelle Contribuer, lorsqu' un utilisateur publie une contribution, il/elle doit définir un statut de visibilité : privé ou public.
Une contribution publique peut être partagée avec (et publiée dans) des chaînes. Après la publication de la contribution par un utilisateur, il/elle peut inviter d’autres utilisateurs à voir la contribution. Veuillez noter qu’un utilisateur peut uniquement inviter d’autres utilisateurs qui possèdent déjà une autorisation de visibilité pour les chaînes dans lesquelles la contribution est publiée.
Une contribution privée est uniquement visible pour l’utilisateur qui l’a partagée et pour les utilisateurs qui ont été invités à voir la contribution. Si la visibilité de la contribution est réglée sur Privé, la contribution peut être partagée avec des personnes individuellement en utilisant la fonctionnalité Inviter à Regarder. Tout utilisateur de la plateforme peut être invité à regarder une contribution privée sans restriction de visibilité.
Comment cela fonctionne-t-il avec la nouvelle fonctionnalité ?
Avec la nouvelle fonctionnalité Partager Contenu, le concept de contributions publiques ou privées n’existe plus. Lorsqu’un utilisateur partage du contenu, il/elle peut choisir entre deux options :
- Partager le contenu avec des chaînes et/ou des personnes;
- Enregistrer le contenu pour soi-même. Le contenu est enregistré sur la page Ma Chaîne de l’utilisateur, est visible pour lui-même uniquement et ne s’affiche pas dans les résultats de recherche des autres utilisateurs.
Une contribution peut être partagée avec des chaînes et des personnes au même moment et depuis le même panneau.
Dans le menu admin Paramètres Discover, Coach & Share, le Superadmin peut configurer les options de partage suivantes qui sont disponibles pour l’utilisateur. Les nouveaux paramètres d’Autorisation de Partage permettent aux Superadmins de choisir entre quatre options :
- Partager du contenu avec des chaînes et avec des personnes
- Partager du contenu avec des chaînes uniquement
- Partager le contenu avec les chaînes et les personnes dans les mêmes branches
- Partager du contenu avec les chaînes et les personnes dans les mêmes branches et sous-branches.
Si Extended Enterprise est activée sur votre plateforme, seuls les deux options suivantes seux disponibles
- Partager du contenu avec des chaînes uniquement
- Partager du contenu avec des chaînes et des personnes dans le même sous-domaine
Pour les plateformes où l’option de permettre aux utilisateurs de télécharger des contributions privées est actuellement désactivée (Section Contributions Privées dans le menu Paramètres Discover, Coach & Share, retirée dans la nouvelle fonctionnalité comme expliquée dans la partie ci-dessus), le nouveau paramètre Autorisations de Partage est réglé sur Partager du contenu avec des chaînes uniquement, ce qui permet aux utilisateur de partager les contributions dans les chaînes uniquement. Pour les plateformes où l’option Contributions Privées est actuellement activée, le nouveau paramètre est réglé sur Partager du contenu avec des chaînes et avec des personnes (ou Partager du contenu avec des chaînes et des personnes dans le même sous-domaine si Extended Enterprise est activé dans la plateforme) permettant aux utilisateurs de partager les contributions à la fois avec des chaînes et des personnes.
Une autre amélioration apportée est celle du nouvel onglet Contributions dans le menu Gestion des Chaînes où le Superadmin peut facilement voir, pour chaque contribution, avec combien de chaînes et de personnes la contribution a été partagée.
De plus, pour les utilisateurs les nouvelles options de partage sont plus intuitives et plus simples à comprendre que le concept de contributions privées et publiques. Elles sont également plus faciles à gérer par les Superadmin grâce à l’ajout des paramètres d’Autorisations de Partage dans le menu Paramètres Discover, Coach & Share et du nouvel onglet Contributions dans le menu Gestion des Chaînes.
Revue par les Pairs
Comment cela fonctionne-t-il maintenant ?
Avec la fonctionnalité actuelle, lorsqu’un expert doit valider une contribution afin que celle-ci soit publiée sur une chaîne, il/elle doit ouvrir la page de la contribution, la modifier et utiliser la fonction Dépublier - Publier pour valider et ainsi publier la contribution révisée.
Quand un expert révise une contribution, la boîte de discussion Experts Associés, faite pour la communication entre l’utilisateur qui a produit la contribution et l’expert qui doit la réviser est à peine utilisée (ou pas utilisée du tout car les experts et les contributeurs préfèrent d’autres moyens de communication), elle ne sera donc plus disponible avec la nouvelle fonctionnalité.
La validation de l’expert permet la publication de la contribution dans toutes les chaînes demandées par l’utilisateur pas seulement dans la ou les chaînes où il/elle est un expert.
Comment cela fonctionne-t-il avec la nouvelle fonctionnalité ?
Avec la nouvelle fonctionnalité, lorsqu’un expert doit valider une contribution, il/elle accède à la page de la contribution et trouve le bouton Approuver la contribution et Rejeter la contribution en haut de la page.
Si l’expert valide la contribution, celle-ci est publiée dans les chaînes choisies par l’utilisateur et où il/elle est un expert.
Si l’expert rejette la contribution, celle-ci n’est pas publiée dans les chaînes choisies par l’utilisateur et où il/elle est un expert. Veuillez noter que la contribution peut être publiée dans une autre chaîne où un autre utilisateur est un expert si l’expert de cette chaîne valide la publication. La validation de l’expert permet la publication uniquement pour la chaîne où il/elle est un expert.
Le nouveau fonctionnement de la revue par les pairs est plus intuitif et permet à chaque expert de suivre de plus près la publication des contributions dans les chaînes qu’il/elle gère.
Partage de Contenu entre les Utilisateurs
Comment cela fonctionne-t-il maintenant ?
Avec la fonctionnalité actuelle, tout utilisateur qui a été invité à regarder une contribution privée peut envoyer une invitation à regarder la contribution (et par conséquent donner l’autorisation de la voir) à tous les autres utilisateurs de la plateforme. La seule exception est quand l’application Extended Enterprise est activée sur la plateforme.
Comment cela fonctionne-t-il avec la nouvelle fonctionnalité ?
Avec la nouvelle fonctionnalité, si un utilisateur a été invité à regarder une contribution, il/elle peut uniquement envoyer une invitation à regarder aux autres utilisateurs qui ont déjà les autorisations de voir cette contribution. Seul le Superadmin de la plateforme et l’utilisateur qui a téléchargé la contribution peuvent élargir les autorisations de visibilité en ajoutant de nouvelles chaînes ou de nouvelles personnes depuis la page d’édition de la contribution.
Le Superadmin et l’utilisateur qui a téléchargé la contribution sur la plateforme peuvent maintenant facilement contrôler et gérer les activités de partage des contributions sans risque de partage incontrôlé.
Adresse Email de l’Utilisateur Invité à Regarder
Comment cela fonctionne-t-il maintenant ?
Avec la fonctionnalité actuelle, lorsqu'un utilisateur invite un autre à regarder une contribution, l’adresse email des utilisateurs qui peuvent être invités est affichée ainsi que leurs noms d’utilisateur.
Comment cela fonctionne-t-il avec la nouvelle fonctionnalité ?
Pour des raisons de confidentialité, les adresses email des utilisateurs ne peuvent pas être affichées pendant l’invitation à regarder ou le partage de contenu avec d’autres utilisateurs ou chaînes. Seuls les noms d’utilisateur sont affichés.
Statistiques sur les Invitations à Regarder
Comment cela fonctionne-t-il maintenant ?
Avec la fonctionnalité actuelle, lorsqu’un utilisateur modifie une contribution, il/elle peut également sélectionner le boutons Analytique dans le coin supérieur droit de la page d’édition pour voir les données et les statistiques sur les invitations à regarder la contribution envoyées.
Comment cela fonctionne-t-il avec la nouvelle fonctionnalité ?
Avec la nouvelle expérience de modification des contributions, la page de statistiques relatives à la fonctionnalité Inviter à Regarder n’est plus disponible depuis la page d’édition de la contribution.
Les utilisateurs peuvent voir les données sur les vues de la contribution qu’ils ont partagée (nombre de vues et date) directement depuis l’onglet Partagé avec sur la page d’édition de la contribution alors que les Superadmins peuvent accéder aux statistiques depuis le rapport Résumé des Contributions accessible depuis le menu des rapports.
APIs modifiées
Le tableau APIs modifiées liste toutes les APIs qui ont été changées avec la nouvelle fonctionnalité Partager Contenu et les nouveaux processus associés pour la modification des contributions et la revue par les pairs. Trois des changements suivants sont des changements de rupture.
Description API |
Verbe API |
URL API |
Changements |
Obtient les paramètres ShareApp |
GET |
/share/v1/settings |
Ajout d'un paramètre facultatif "share_to_people" pour définir les autorisations de partage. |
Mise à jour des paramètres de ShareApp |
PUT |
/share/v1/settings |
Ajout d'un paramètre facultatif "share_to_people" pour définir les autorisations de partage |
Retourne les contributions disponibles dans la plateforme |
GET |
/share/v1/admin/assets |
Ajout de l'élément "people_assignment_count" dans la réponse. Ajout de l'élément "included_in_channels" dans la réponse. Cela représente la liste des chaînes attribuées à la contribution. Changement de rupture - Auparavant, si la visibilité de la contribution était définie comme privée et que la contribution n'était attribuée à aucune chaîne, l'élément "channels_assignment_count" n'était pas retourné. Avec la nouvelle fonctionnalité Partager Contenu, si la contribution n'est attribuée à aucune chaîne, l'élément "channels_assignment_count" renvoie la valeur "0". En général, le nombre de chaînes auxquelles la contribution est attribuée est retourné. |
Met à jour la contribution |
PUT |
/share/v1/assets/{id_asset} |
Ajout de deux paramètres d'entrée facultatifs : "file_name" et "original_file_name" |
Voir la contribution |
GET |
/share/v1/assets/{id_asset} |
Ajout du paramètre d'entrée facultatif "show_users" = true. S'il est transmis, la liste des utilisateurs invités à regarder la contribution est retournée. |
Récupère tous les utilisateurs pouvant être invités pour une contribution spécifique. |
GET |
/share/v1/assets/{id_asset}/invitations/users |
La liste des utilisateurs pouvant être invités est désormais calculée en fonction de la configuration du paramètre "Autorisations de partage". Changement de rupture - Le paramètre "search" est désormais obligatoire pour des raisons de sécurité. |
Récupère les informations initiales de l’invitation à regarder |
GET |
/share/v1/assets/{id_asset}/invitations/suggestions |
La liste des utilisateurs qui peuvent être suggérés pour une invitation sera désormais calculée en fonction de la configuration du paramètre "Autorisations de partage". |
Crée une nouvelle contribution de type image |
POST |
/share/v1/image |
Application d'une nouvelle logique de revue par les pairs |
Crée une nouvelle contribution de type lien |
POST |
/share/v1/link |
Application d'une nouvelle logique de revue par les pairs Ajout d'un nouveau paramètre "content_type" pour définir le type de lien. Le type peut être : liens, docs, feuilles ou diapositives. |
Créé une nouvelle contribution de type lien vidéo pour Vimeo, Youtube, Wistia |
POST |
/share/v1/videolink |
Application d'une nouvelle logique de revue par les pairs |
Mise à jour de la contribution |
PUT |
/share/v1/assets/{id_asset} |
Application d'une nouvelle logique de revue par les pairs |
Créé un nouveau cours |
POST |
/learn/v1/courses |
Application d'une nouvelle logique de revue par les pairs |
Mise à jour d’un cours spécifique |
PUT |
/learn/v1/courses/{id} |
Application d'une nouvelle logique de revue par les pairs |
Crée une nouvelle contribution de type vidéo |
POST |
/share/v1/video |
Application d'une nouvelle logique de revue par les pairs Changement de rupture - Auparavant, le paramètre "thumbnail_url" était ignoré. Avec la nouvelle fonctionnalité Partager le Contenu, si ce paramètre est transmis (facultatif), la vignette est définie par défaut pour la contribution. |
Voir la contribution |
GET |
/share/v1/assets/{id_asset} |
Ajout de l'élément "peer_review" dans la réponse. Il représente le statut de la contribution dans une chaîne spécifique où la révision d'un expert est nécessaire. |
Ajoute une vignette personnalisée à une contribution donnée |
POST |
/share/v1/assets/{id_asset}/thumbnails |
Ajout du paramètre optionnel "not_default" afin de décider si une vignette est utilisée par défaut |
Créé une nouvelle contribution |
POST |
/share/v1/assets |
Ajout du paramètre "tags" pour associer des balises à la contribution |
Envoie des invitations à regarder |
POST |
/share/v1/assets/{id_asset}/invitations |
Auparavant, si cette API était utilisée pour inviter à nouveau un utilisateur déjà invité à regarder une contribution, l'API renvoyait une erreur. Désormais, il est possible d'inviter le même utilisateur plusieurs fois, et aucune erreur n'est renvoyée. |
Voir les Chaînes Attribuées aux Contributions |
GET |
/share/v1/assets/{id_asset}/channels |
Ajout du nouveau paramètre "search_text" pour filtrer les résultats par nom |
Récupère les contributions de la chaîne |
GET |
/share/v1/admin/channels/{id_channel}/content |
Nouvelle logique de revue par les pairs appliquée au statut des contributions |
Nouvelles APIs
Le tableau Nouvelles APIs liste les API disponibles pour la nouvelle fonctionnalité Partager Contenu et les nouveaux processus associés pour la modification des contributions et la revue par les pairs. Ces API sont complètement opérationnelles à partir du 2 février 2021.
Description API |
Verbe API |
URL API |
Crée un lien entre les contributions et les chaînes |
POST |
/share/v1/admin/channels/assets |
Récupère les utilisateurs qui ont été invités à regarder la contribution |
GET |
/share/v1/assets/{id_asset}/users |
Supprime les liens entre un utilisateur et une contribution |
DELETE |
/share/v1/admin/user/{id_user}/asset/{id_asset} |
Obtient les métadonnées et les images d’un lien |
GET |
/share/v1/link/meta |
Vérifie si un enregistrement vidéo spécifique a été téléchargé en tant que contribution. |
GET |
/share/v1/screenrecorder/upload/status |
Valide une contribution dans les chaînes où vous êtes expert |
POST |
/share/v1/assets/{id_asset}/approve |
Rejette une contribution dans les chaînes où vous êtes expert |
POST |
/share/v1/assets/{id_asset}/reject |
Supprime une invitation utilisateur |
DELETE |
/share/v1/assets/{id_asset}/invitations/{id_user} |
Créé une nouvelle contribution de type document |
POST |
/share/v1/document |
Modifie une contribution de type vidéo |
PUT |
/share/v1/video/{id_asset} |
Modifie une contribution de type document |
PUT |
/share/v1/document/{id_asset} |
Créé une nouvelle contribution de type générique |
POST |
/share/v1/generic |
Pour chaque nouvelle API, la liste des paramètres est détaillée dans les paragraphes suivants.
Crée un lien entre les contributions et les chaînes
POST /share/v1/admin/channels/assets @parameter assets [array(integer), required] : Les contributions à associer aux chaînes @parameter channels [array(integer), required] : Les chaînes à associer aux contributions
Récupère les utilisateurs qui ont été invités à regarder la contribution
GET /share/v1/assets/{id_asset}/users @get id_asset [integer, required] : L’ID de la contribution @parameter sort_attr [enum(user_id, username, fullname), optional] @parameter sort_dir [enum(asc, desc), optional] : Le sens du tri : asc = ascendant, desc = descendant. Default: asc @parameter page [integer, optional] : La page à retourner. Default: 1 @parameter page_size [integer, optional] : Le nombre maximum de résultats par page. Défaut: en fonction de la plateforme
Supprime les liens entre un utilisateur et une contribution
DELETE /share/v1/admin/user/{id_user}/asset/{id_asset} @get id_user [integer, required] : L’ID de l’utilisateur @get id_asset [integer, required] : L’ID de la contribution
Obtient les métadonnées et les images d’un lien
GET /share/v1/link/meta @parameter url [string, required] : L'URL à partir de laquelle les informations sont extraites
Vérifie si un enregistrement vidéo spécifique a été téléchargé en tant que contribution.
GET /share/v1/screenrecorder/upload/status @parameter filename [string, required] : Le nom du fichier
Valide une contribution dans les chaînes où vous êtes expert
POST /share/v1/assets/{id_asset}/approve @get id_asset [integer, required] : L’ID de la contribution
Rejette une contribution dans les chaînes où vous êtes expert
POST /share/v1/assets/{id_asset}/reject @get id_asset [integer, required] : L’ID de la contribution
Supprime une invitation utilisateur
DELETE /share/v1/assets/{id_asset}/invitations/{id_user} @get id_asset [integer, required] : L’ID de la contribution @get id_user [integer, required] : L’ID de l’utilisateur
Créé une nouvelle contribution de type document
POST /share/v1/document @parameter url [string, required] : L’URL du document @parameter title [string, required] : The title of the document @parameter description [string, required] : La description du document @parameter original_filename [string, required] : Le nom de fichier original du document @parameter thumbnail_url [string, optional] : L’URL de la vignette @parameter channels [array(integer), optional] : La liste des ID des chaînes où le document est publié @parameter tags [array(string), optional] : La liste des balises attribuées au document
Modifie une contribution de type vidéo
PUT /share/v1/video/{id_asset} @get id_asset [integer, required] : L’ID de la contribution @parameter url [string, required] : L’URL de la vidéo @parameter title [string, required] : Le titre de la vidéo @parameter description [string, required] : La description de la vidéo @parameter original_filename [string, required] : Le nom de fichier original de la vidéo @parameter thumbnail_url [string, optional] : L’URL de la vignette @parameter channels [array(integer), optional] : La liste des ID des chaînes où la vidéo est publiée @parameter tags [array(string), optional] : La liste des balises attribuées à la vidéo
Modifie une contribution de type document
PUT /share/v1/document/{id_asset} @get id_asset [integer, required] : L’ID de la contribution @parameter url [string, required] : L’URL du document @parameter title [string, required] : Le titre du document @parameter description [string, required] : La description du document @parameter original_filename [string, optional] : Le nom de fichier original du document @parameter thumbnail_url [string, optional] : L’URL de la vignette @parameter channels [array(integer), optional] : La liste des ID des chaînes où le document est publié @parameter tags [array(string), optional] : La liste des balises attribuées au document
Créé une nouvelle contribution de type générique
POST /share/v1/generic @parameter url [string, required] : L’ID de la contribution @parameter title [string, required] : Le titre de la contribution @parameter content_type [integer, optional] : Le type de contenu de la contribution. Accepted values : 6, 10, 11, 12, 13 @parameter description [string, required] : LA description de la contribution @parameter original_filename [string, required] : Le nom de fichier original de la contribution @parameter thumbnail_url [string, optional] : L’uRL de la vignette @parameter channels [array(integer), optional] : La liste des ID des chaînes où la contribution est publiée @parameter tags [array(string), optional] : La liste des balises attribuées à la contribution