Micro-apps

Intégrer SocialChorus

Déployez l’intégration Citrix pour SocialChorus pour communiquer des annonces importantes envoyées par l’équipe de direction et partager du contenu (articles, liens et notes, par exemple) avec les employés via différents canaux. Aucune image ou média n’est affiché(e).

Les utilisateurs peuvent afficher les sept derniers jours de contenu publié dans les canaux recommandés. À l’aide de sélections appropriées, les utilisateurs peuvent afficher tout le contenu recommandé publié sur différents canaux. Les utilisateurs peuvent également afficher tout le contenu publié sur les canaux suivis qui a été posté au cours des cinq derniers jours. Tous les détails relatifs au contenu (comme le titre, le résumé, le corps et la date de publication) sont affichés sur des pages individuelles. Le contenu publié peut être affiché dans une instance de test en cliquant sur un bouton.

Un utilisateur à qui le rôle Program Manager a été attribué dans SocialChorus peut marquer des canaux ou des articles comme étant recommandés à l’aide de l’interface utilisateur SocialChorus Manage Channel. Par exemple, ces canaux de communication peuvent être envoyés par l’équipe de direction ou contenir des articles recommandés pour un groupe d’utilisateurs ou pour tous les utilisateurs.

Remarque :

Ce modèle d’intégration se trouve en version préliminaire et est marqué comme Aperçu dans la liste des modèles disponibles affichés dans le produit lors de l’ajout d’une nouvelle intégration. Lorsqu’un modèle est en version préliminaire, nous ne nous engageons pas à fournir un service de support ; le support est fourni par le développeur de la manière la plus optimale possible. Les modèles d’intégration en version préliminaire sont partagés à des fins de test et de validation. Nous ne conseillons pas de les déployer dans des environnements de production. Pour de plus amples informations, consultez la section Déclaration de maintenance pour les modèles d’intégration de micro-apps.

Pour plus de détails sur nos micro-apps SocialChorus, consultez la section Utiliser les micro-apps SocialChorus.

Vérifier les conditions préalables

Vous avez besoin des artefacts suivants pour ajouter l’intégration dans les micro-apps Citrix Workspace :

  • URL de base : https://partner.socialchorus.com/
  • URL du jeton : https://auth.socialchorus.com/oauth/token
  • ID du client : l’ID du client permet de définir la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation. Contactez votre représentant de compte SocialChorus pour obtenir l’ID client et la clé secrète client.
  • Clé secrète client : la clé secrète client permet de définir la chaîne unique générée lors de la configuration de l’intégration de l’application cible.

L’intégration nécessite un accès régulier à votre instance SocialChorus. Nous vous recommandons donc de créer un compte utilisateur dédié. Ce compte de service doit disposer des privilèges et des autorisations d’administrateur complets.

Remarque :

Il est recommandé de toujours utiliser OAuth 2.0 comme méthode d’authentification de service lorsque cette méthode est disponible. OAuth 2.0 garantit que votre intégration respecte la conformité maximale en matière de sécurité avec votre micro-app configurée.

Activer les API

Les API SocialChorus sont activées par défaut via les services Web pour un compte payant. Cela peut nécessiter un accord distinct avec le vendeur. Le nombre de requêtes d’API pouvant être exécutées sur des ressources spécifiques est limité. Nous vous recommandons de consulter les conseils liés à l’utilisation de l’API SocialChorus : SocialChorus API Guidance.

Ajouter l’intégration aux micro-apps Citrix Workspace

Ajoutez l’intégration SocialChorus aux micro-apps Citrix Workspace pour vous connecter à votre application. Les options d’authentification sont présélectionnées. Assurez-vous que ces options sont sélectionnées lorsque vous effectuez le processus. Des micro-apps prêtes à l’emploi sont proposées, ainsi que des notifications et des actions préconfigurées qui sont prêtes à être utilisées dans votre espace de travail.

Procédez comme suit :

  1. Sur la page Intégrations de micro-apps, sélectionnez Ajouter nouvelle intégration et Ajouter une nouvelle intégration à partir des modèles fournis par Citrix.
  2. Choisissez la vignette SocialChorus.
  3. Donnez un nom d’intégration à l’intégration.
  4. Renseignez la section Paramètres du connecteur.

    • Entrez l’URL de base https://partner.socialchorus.com/ de l’instance.
    • Sélectionnez une icône pour l’intégration dans la bibliothèque d’icônes ou gardez l’icône par défaut.

    Configuration SocialChorus 1

  5. Sous Authentification du service, sélectionnez OAuth 2.0 dans le menu Méthode d’authentification et complétez les détails d’authentification. Les options d’authentification sont présélectionnées. Assurez-vous que ces options sont sélectionnées lorsque vous effectuez le processus. Utilisez le protocole de sécurité OAuth 2.0 pour générer des jetons de demande/autorisation pour l’accès délégué. Il est recommandé de toujours utiliser OAuth 2.0 comme méthode d’authentification de service lorsque cette méthode est disponible. OAuth 2.0 garantit que votre intégration respecte la conformité maximale en matière de sécurité avec votre micro-app configurée.

    1. Sélectionnez Informations d’identification du client dans le menu Flux de type d’autorisation.
    2. Entrez client_credentials dans le champ Valeur du type d’autorisation.
    3. Sélectionnez En-tête d’autorisation dans le menu Autorisation de jeton.
    4. Sélectionnez URL du formulaire codée dans le menu Type de contenu du jeton.
    5. Saisissez l’URL du jeton : https://auth.socialchorus.com/oauth/token
    6. Saisissez votre ID client. L’ID du client permet de définir la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation. Vous obtenez cet élément, ainsi que la clé secrète client lorsque vous avez configuré le serveur OAuth.
    7. Entrez la Clé secrète client. La clé secrète client permet de définir la chaîne unique générée lors de la configuration de l’intégration de l’application cible.

    Configuration SocialChorus 2

  6. Activez l’option Activer la limitation du taux de demandes. Entrez 1000 pour Nombre de demandes et 1 minute pour Intervalle de temps.
  7. Dans le champ Limitation du taux de demandes, entrez 120.
  8. (Facultatif) Activez la fonction Journalisation pour conserver 24 heures de journalisation à des fins de support.
  9. Sélectionnez Enregistrer pour continuer.

    Configuration SocialChorus 3

  10. Sous Autorisation OAuth, sélectionnez Autoriser pour vous connecter avec votre compte de service. Une fenêtre contextuelle apparaît avec un écran de connexion Microsoft.
    1. Entrez le nom d’utilisateur et le mot de passe de votre compte de service et sélectionnez Connexion.

La page Intégrations de micro-apps s’ouvre avec votre intégration ajoutée et ses micro-apps associées. À partir de là, vous pouvez ajouter une autre intégration, continuer à configurer vos micro-apps prêtes à l’emploi ou créer une micro-app pour cette intégration.

Vous êtes maintenant prêt à définir et exécuter votre première synchronisation de données. Vous pouvez extraire une grande quantité de données de vos applications intégrées vers la plate-forme de micro-apps. Par conséquent, nous vous recommandons d’utiliser la page Tableau pour filtrer les entités de votre première synchronisation de données afin d’accélérer la synchronisation. Pour de plus amples informations, consultez la section Vérifier les entités requises. Pour plus d’informations sur les règles de synchronisation, ainsi que sur la synchronisation qui ne respecte pas ses règles de planification et de veto, consultez la section Synchroniser les données.

Pour plus d’informations sur les points de terminaison d’API et les entités de table, consultez la section Spécifications du connecteur SocialChorus.

Utiliser les micro-apps SocialChorus

Les intégrations d’application existantes sont fournies avec des micro-apps prêtes à l’emploi. Commencez avec ces micro-apps et personnalisez-les en fonction de vos besoins. L’intégration SocialChorus est fournie avec les deux micro-apps prêtes à l’emploi préconfigurées suivantes : Ces deux micro-apps permettent de récupérer le contenu des 7 derniers jours :

Communications importantes : permet de rechercher et d’afficher les communications importantes provenant des canaux recommandés qui sont affichées au cours des 7 derniers jours.

Notification ou Page Workflows de cas d’utilisation
Page Afficher le contenu Fournit une liste complète des articles publiés dans les canaux recommandés au cours des 7 derniers jours.
Page Détails du contenu Fournit un formulaire permettant d’afficher les articles en détail, y compris l’option Consulter le blog pour ouvrir l’article dans SocialChorus.

Derniers articles : permet de rechercher et d’afficher le contenu qui a été publié sur les canaux abonnés au cours des 7 derniers jours.

Notification ou Page Workflows de cas d’utilisation
Page Afficher le contenu Fournit une liste complète des articles publiés sur les canaux abonnés au cours des 7 derniers jours.
Page Détails du contenu Fournit un formulaire permettant d’afficher les articles en détail, y compris l’option Consulter le blog pour ouvrir l’article dans SocialChorus.
Intégrer SocialChorus