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 : 

1. Partager le contenu avec des chaînes et/ou des personnes;
2. 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 : 

1. Partager du contenu avec des chaînes et avec des personnes
2. Partager du contenu avec des chaînes uniquement
3. Partager le contenu avec les chaînes et les personnes dans les mêmes branches
4. 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 

1. Partager du contenu avec des chaînes uniquement
2. 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