Intégrer l’application d’enquêtes des employés

Déployez l’application d’enquêtes des employés pour envoyer un nouveau formulaire d’enquête et gérer les formulaires d’enquête existants à partir de Citrix Workspace. Les flux de travail suivants sont traités avec les micro-apps :   

• La micro-app Gérer les enquêtes permet aux administrateurs Citrix Podio de gérer les applications d’enquêtes existantes dans Citrix Workspace.
• La micro-app Formulaire d’enquête permet d’envoyer des notifications pour toutes les enquêtes planifiées dans Citrix Podio à tous les abonnés et de recevoir les commentaires des utilisateurs dans Citrix Workspace.

Quel que soit le moment où vous déployez votre solution technologique, il est important que vous compreniez l’expérience de vos utilisateurs afin de savoir si votre solution répond à leurs besoins tout en stimulant la productivité grâce à une expérience d’espace de travail numérique optimale. L’intégration de l’application d’enquêtes des employés vous permet de recevoir facilement les commentaires de vos utilisateurs à tout moment, selon vos préférences. Non seulement les enquêtes vous donnent la possibilité d’être à l’écoute de vos utilisateurs et de fournir l’assistance requise, mais les commentaires vous aident également à rester informé et à gérer l’expérience utilisateur en conséquence. Le modèle comprend des enquêtes prédéfinies et personnalisables basées sur les meilleures pratiques en matière d’expérience des employés et des utilisateurs. Vous pouvez facilement ajouter d’autres enquêtes pour recueillir des commentaires sur n’importe quel aspect de l’expérience des employés. Pour en savoir plus sur l’expérience utilisateur, consultez End User Experience Kit sur le site Citrix Success Center.

Votre avis nous intéresse ! Veuillez fournir vos commentaires pour ce modèle d’intégration au fur et à mesure que vous l’utilisez. Pour tout problème, notre équipe surveille également nos forums dédiés quotidiennement.

Pour plus de détails sur les micro-apps, consultez Utiliser les micro-apps d’enquêtes des employés.

Vérifier les conditions préalables

Une fois l’intégration avec l’application d’enquêtes des employés configurée, vous aurez besoin de ces artefacts pour ajouter l’intégration dans les micro-apps Citrix Workspace :

• URL de base : https://api.podio.com
• ID de l’application d’administration d’enquêtes : saisissez l’ID de l’application « Mes enquêtes ». Consultez Obtenir l’ID d’application et le jeton d’application.
• URL de rappel : https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext
• URL d’autorisation : https://podio.com/oauth/authorize
• URL du jeton : https://podio.com/oauth/token
• ID du client : l’ID du client est la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation.
• Clé secrète client : la clé secrète client représente la chaîne unique générée lors de la configuration de l’intégration de l’application cible.
• Paramètres du jeton d’accès : entrez le nom et les paramètres de valeur conformément aux instructions fournies ci-dessous :
  • app_id : entrez votre ID d’application Podio Workspace. Consultez Obtenir l’ID d’application et le jeton d’application.
  • app_token: entrez le jeton d’application Podio Workspace. Consultez Obtenir l’ID d’application et le jeton d’application.
  • grant_type : application

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.

Créer un compte de service

L’intégration nécessite l’accès régulier à votre instance d’enquêtes des employés. Nous vous recommandons de créer un compte utilisateur dédié. Ce compte doit disposer des autorisations d’administrateur complètes. Pour plus d’informations, consultez la page Podio API documentation.

Activer les API

Le nombre de requêtes d’API pouvant être exécutées sur des ressources spécifiques est limité. Nous vous recommandons de consulter la ressource suivante : documentation sur les limitations de l’API.

Configurer le client OAuth

Obtenez l’ID client et la clé secrète client dans Podio, puis saisissez ces informations dans l’écran de configuration de l’intégration des micro-apps pour l’authentification.

1. Connectez-vous au site Podio Developer en tant qu’administrateur de l’application Podio Workspace : Podio
2. Sélectionnez Generate Your API Key.
3. Sélectionnez Get an API key now.
4. Donnez un nom à votre application dans le champ Application name.
5. Entrez l’URL de votre instance de micro-apps dans le champ Full domain (without protocol) of your return URL. Cette section de l’URL {yourmicroappserverurl} est composée d’une partie locataire, d’une partie région et d’une partie environnement : https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.
6. Sélectionnez Generate API Key.

7. Sous Your API keys, copiez et enregistrez les valeurs Client ID et Client Secret pour l’application que vous venez d’ajouter. Vous entrez ces valeurs lorsque vous configurez l’intégration.

   

Pour plus d’informations, consultez la section Obtenir l’ID client et la clé secrète client.

Obtenir l’ID d’application et le jeton d’application

Obtenez l’ID d’application (App ID) et le jeton d’application (App Token) depuis Podio pour vous authentifier en tant qu’application plutôt qu’en tant qu’utilisateur. L’utilisation de l’ID d’application permet aux utilisateurs d’accéder uniquement aux données des applications dans l’espace de travail Podio associé. Vous obtenez cet ID à partir de l’application Podio pour l’espace de travail Podio. Si vous disposez de plusieurs applications dans un espace de travail, vous pouvez utiliser n’importe quel ID d’application affilié à l’espace de travail.

1. Connectez-vous à Podio et accédez à votre application Podio.

2. Sélectionnez l’icône Tools en regard du nom de l’application. Les étapes de l’application Diffusion sont affichées à titre d’exemple dans les captures d’écran.

   

3. Sous APP, sélectionnez Developer.

   

4. Copiez et enregistrez les champs App ID et Token. Vous entrez ces valeurs en tant que paramètres du jeton d’accès lorsque vous configurez l’intégration.

   

Vous pouvez également afficher les champs et les exemples de valeurs JSON sous App fields de cette page. Pour plus d’informations sur l’utilisation des entrées d’application dans Podio, consultez la page Working with items.

Envoyer de nouvelles notifications à l’application d’enquêtes des employés

Utilisez l’application d’enquêtes des employés pour planifier plusieurs formulaires web/formulaires de commentaires d’enquêtes.

Remarque

Nous vous recommandons d’ajouter des champs d’auto-identification dans le formulaire d’enquête, tels que Adresse e-mail ou Nom, comme champs obligatoires à des fins d’identification.

Suivez ces étapes pour planifier une enquête dans Citrix Workspace.

1. Connectez-vous à votre instance Citrix Podio, accédez à Podio App Market et obtenez le pack d’applications d’enquêtes des employés Citrix Workspace : Podio App Market - Citrix Workspace Employee Surveys
2. Sélectionnez My Survey App dans la section Apps in this pack.
3. Sélectionnez Add Survey et renseignez le champ Survey Name associé à l’enquête que vous souhaitez envoyer et pour laquelle vous souhaitez obtenir des commentaires. Sélectionnez une date sous Launch Date à laquelle la notification d’enquête doit être déclenchée.
4. Sélectionnez Enable_Survey sous Status pour générer une notification et Disable_Survey pour la désactiver instantanément depuis Citrix Workspace.
5. Saisissez le contenu du corps de la notification dans Survey Description. Ce contenu est affiché dans la fiche de flux destinée aux abonnés.
6. Saisissez l’ID de réponse du formulaire d’enquête sous Response App Id. Cette valeur correspond à l’ID que l’administrateur souhaite envoyer aux utilisateurs en tant que notification.
7. Sélectionnez la date Expire After pour désactiver automatiquement les notifications envoyées aux abonnés à la date sélectionnée.
8. Accédez aux applications de formulaires Web créées par Podio que l’administrateur souhaite planifier et pour lesquelles il souhaite obtenir des commentaires des utilisateurs, puis sélectionnez Settings et choisissez l’option Webforms.
9. Dans la section Allowed Domain, ajoutez le domaine de l’espace de travail WSI dans la configuration du formulaire Web des applications d’enquêtes. Par exemple, {yourmicroappserverurl}.cloud.com.
10. Sélectionnez Save, puis Share.

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

Ajoutez l’intégration Podio 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 Podio.
3. Donnez un nom d’intégration à l’intégration.
4. Renseignez la section Paramètres du connecteur.
   • Entrez l’URL de base de l’instance : https://api.podio.com.
   • Sélectionnez une icône pour l’intégration dans la bibliothèque d’icônes ou gardez l’icône par défaut.
5. Entrez l’ID de l’application d’administration d’enquêtes. Consultez Obtenir l’ID d’application et le jeton d’application.

6. Renseignez les sections Authentification de service et Paramètres du connecteur en utilisant les informations que vous avez obtenues dans les procédures précédentes.

7. 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 Code d’autorisation dans le menu Flux de type d’autorisation.
   2. Entrez authorization_code dans le champ Valeur du type d’autorisation.
   3. L’URL de rappel est pré-remplie : https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext.
   4. Sélectionnez Corps de la requête dans le menu Autorisation de jeton.
   5. Sélectionnez URL du formulaire codée dans le menu Type de contenu du jeton.
   6. L’URL d’autorisation est pré-remplie : https://podio.com/oauth/authorize.
   7. L’URL du jeton est pré-remplie : https://podio.com/oauth/token
   8. Saisissez votre ID client. L’ID du client est la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation. Vous avez obtenu cet ID et la clé secrète client dans la procédure Configurer le client OAuth.
   9. Entrez la Clé secrète client. La clé secrète client est une chaîne unique émise avec l’ID client comme indiqué dans la procédure Configurer le client OAuth.
8. Entrez les valeurs des paramètres du jeton d’accès. Pour de plus amples informations, consultez la section Obtenir l’ID d’application et le jeton d’application :
   • Entrez l’ID de l’application que vous avez collecté en regard de app_id.
   • Entrez le jeton d’application que vous avez collecté en regard de app_token.
   • Entrez l’application sous grant_type.
9. L’option Limitation du taux de demandes est activée et définie sur 1000 demandes par minute.
10. Entrez 120 dans le champ Délais d’expiration des demandes.
11. Sélectionnez Enregistrer pour continuer.

Vous êtes maintenant prêt à définir et exécuter votre première synchronisation de données. 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 de l’application d’enquêtes des employés.

Utiliser les micro-apps de l’application d’enquêtes des employés

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.

Formulaire d’enquête : fournit des notifications pour les nouvelles enquêtes et permet aux utilisateurs de consulter et d’envoyer les formulaires d’enquêtes.

Gérer les enquêtes : permet à l’administrateur de l’application d’enquêtes de gérer les formulaires d’enquêtes planifiés à partir de Citrix Workspace. Cette micro-app est réservée aux membres administrateurs de l’application d’enquêtes des employés.

Remarque

Nous vous recommandons de conserver un nombre limité d’enregistrements d’enquêtes dans l’application d’administration Podio Mes enquêtes.