Guide PoC : Proof of Concept Guide - Utilisez App Builder pour déployer des modèles de micro-apps de diffusion et de FAQ soutenus par Citrix Podium sur Citrix Workspace

Vue d’ensemble

Citrix App Builder (optimisé par Podio) fournit un moyen simplifié de commencer à créer des micro-apps avec un système d’enregistrement géré par Citrix. Avec App Builder, Citrix Podio fournit le système d’enregistrement principal pour les micro-apps, ce qui signifie que vous n’avez pas à apporter ou à créer votre propre système d’enregistrement. L’utilisation d’App Builder permet aux administrateurs et aux développeurs de déployer et de créer des micro-apps plus rapidement et plus facilement, sans avoir à déployer et à gérer leur propre système d’enregistrement backend.

Scope

Ce guide Proof of Concept explique comment utiliser App Builder pour déployer les micro-apps Broadcast et FAQ (Foire aux questions) auprès des utilisateurs de Citrix Workspace. Toutefois, les concepts abordés sont applicables à d’autres packages d’applications Podio fournis par Citrix qui utilisent Citrix Podio comme système d’enregistrement.

Buts

À la fin de ce guide Proof of Concept, vous aurez :

  1. utilisé App Builder pour créer ou lier une instance Podio à Citrix Cloud
  2. ajout d’une application Podio fournie par Citrix pour servir de système d’enregistrement pour la micro-app Broadcast et la micro-application FAQ
  3. ajout et configuration de l’intégration de micro-app pour utiliser le système d’enregistrement soutenu par Podium
  4. a ajouté des abonnés aux micro-apps, afin que les personnes appropriées puissent publier des diffusions et que toutes les personnes utilisant Workspace puissent voir les diffusions et les FAQ
  5. Test des fonctionnalités de base des micro-apps Broadcast et FAQ dans Citrix Workspace

Conditions préalables

  • Citrix Workspace
  • Micro-apps Citrix

Remarque : Vous n’avez pas besoin d’une instance Podio : vous pouvez en créer une lors de la première utilisation d’App Builder.

Concepts et terminologie

Certains termes utilisés dans ce guide peuvent ne pas vous être familiers.

  • Système d’enregistrement - un endroit où les données sont lues et écrites. Semblable à une base de données Les intégrations de micro-apps les utilisent pour stocker les données associées à la micro-app. Ils peuvent être considérés comme une « source de vérité »
  • Micro-app : élément de l’interface utilisateur intégré à l’expérience Citrix Workspace
  • Podio Workspace - un concept de podio qui aide les administrateurs Podio à séparer logiquement des équipes ou des projets. Pas la même chose que Citrix Workspace
  • Applications Podio : applications qui se trouvent dans un espace de travail Citrix Podio. Dans ce cas d’utilisation, ces applications fournissent un système d’enregistrement backend prêt à l’emploi pour les intégrations de micro-apps Citrix Workspace.
  • Intégration : une intégration se connecte à un système d’enregistrement. Une intégration fournit également des micro-apps qui peuvent être rendues visibles par les personnes utilisant Citrix Workspace et lit les données du système d’enregistrement afin qu’elles puissent être affichées dans les micro-apps de Citrix Workspace.

Étapes de déploiement

Utilisez App Builder pour créer ou associer une instance Podio à Citrix Cloud

Cette étape est mieux expliquée dans la documentation produit d’App Builder, mais elle est résumée ci-dessous :

  1. Connectez-vous à Citrix Cloud à l’aide de vos informations d’identification Citrix
  2. À partir de la console Citrix Cloud, sous Services disponibles, sélectionnez Configurer sur la vignette App Builder
  3. Si votre organisation possède déjà un compte Podio, il peut être connecté au compte Citrix Cloud. Si votre organisation ne possède pas de compte Podio, vous pouvez en créer un gratuitement ici.

Une fois qu’un nouveau compte podio a été créé ou lié, l’étape suivante consiste à ajouter les exemples d’applications Podio fournies par Citrix à l’instance Podio

Ajoutez les applications Podio fournies par Citrix pour servir de système d’enregistrement pour les micro-apps de diffusion et de FAQ

Dans cette section, un nouvel espace de travail Podio sera créé, spécifiquement pour les intégrations de micro-apps Citrix. Dans le nouvel espace de travail, les applications Podio fournies par Citrix seront ajoutées.

Ajoutez l’application Broadcast Podio

Ajoutez l’ application Citrix Workspace Broadcast depuis Podio App Market :

  1. Accédez à l’ application Citrix Workspace Broadcast sur Podio Market
  2. Cliquez sur « Obtenir l’application »
  3. Créez un nouvel espace pour l’application Citrix Workspace Broadcast, appelé « Intégrations de micro-apps Citrix ». Cela permet de séparer les applications et les données Podio de tous les autres espaces de travail Podio autres que des micro-apps que vous pourriez avoir ou que vous souhaitez utiliser à l’avenir. Au fur et à mesure que d’autres applications Podio fournies par Citrix sont ajoutées, elles peuvent également être placées dans cet espace de travail.
  4. Définissez les paramètres d’accès sur Privé. Cet espace de travail est utilisé comme une base de données, il est donc conseillé de le garder privé
  5. Cliquez sur « Essayer l’application maintenant »

Ajouter l’application FAQ Podio

Ensuite, ajoutez l’ application FAQ Citrix Workspace depuis Podio App Market :

  1. Accédez à l’ application FAQ Citrix Workspace sur Podio Market
  2. Cliquez sur « Obtenir l’application »
  3. Utilisez l’espace de travail Podio existant créé à l’étape précédente : Intégrations de micro-apps Citrix. Cela signifie que les applications Broadcast et FAQ Podio se trouvent dans le même espace de travail Podio.
  4. Définissez les paramètres d’accès sur Privé. Cet espace de travail est utilisé comme une base de données, il est donc conseillé de le garder privé.
  5. Cliquez sur « Essayer l’application maintenant »

[Remarque] Si vous concevez cela à une date ultérieure pour la production, il vaut la peine de répéter que Podio Workspaces peut héberger plusieurs applications Podio. Cela signifie qu’un Podio Workspace au nom générique, dédié aux micro-apps Citrix, peut être plus judicieux que de créer un nouvel espace de travail Podio pour chaque intégration de micro-app afin de faciliter la gestion et la maintenance. Dans ce guide Proof of Concept, nous gardons les choses cloisonnées, car il ne s’agit pas de production.

À ce stade, le système d’enregistrement soutenu par Podio et son schéma de base de données associé pour chaque application Podio sont en place.

Ensuite, collectez auprès de Podio les données nécessaires pour configurer les intégrations de micro-apps à une étape ultérieure.

Collectez les valeurs de configuration de l’intégration des micro-apps auprès

Dans cette section, les données suivantes seront collectées :

  • ID d’application pour la diffusion Citrix Workspace
  • Jeton pour diffusion Citrix Workspace
  • ID de vue pour la diffusion de Citrix Workspace
  • FAQ sur l’ID d’application pour Citrix Workspace
  • FAQ sur les jetons pour Citrix Workspace
  • FAQ Afficher l’ID pour Citrix Workspace
  • ID client
  • Clé secrète client

Ces données sont nécessaires pour configurer l’intégration Podio pour les micro-apps une fois qu’elle est ajoutée dans Citrix Cloud.

Collectez l’identifiant et le jeton de l’application Podio pour chaque application (diffusion et FAQ)

L’identifiant de l’application et le jeton sont récupérés auprès de Podio. La documentation complète se trouve ici, mais un résumé est fourni ci-dessous

  1. Connectez-vous à podio.com
  2. Dans la barre de navigation, choisissez l’espace de travail associé à l’application Podio ajoutée précédemment. Dans cet exemple : Intégrations de microapps Citrix
  3. Cela vous permet d’accéder à l’espace de travail. Accédez maintenant à l’application Podio elle-même, en cliquant sur l’icône Loudhailer, à côté de Activity.
  4. Cliquez ensuite sur l’icône en forme de clé, puis choisissez Developer, dans la catégorie App.
  5. L’ID de l’application et le jeton s’affichent. Prenez note de ces éléments.
  6. Passez à la prochaine application Podio

Obtenir l’ID de vue

Collectez l’ID de vue pour chaque application (diffusion et FAQ).

La documentation de référence principale pour cette étape se trouve sur Citrix Docs : Collect View ID

  1. Pour l’application Diffusion, le champ est Modifié aujourd’hui.
  2. Pour l’application Questions fréquentes, le champ est Questions fréquentes publiées.

Obtenir l’ID client et la clé secrète client

Pour que l’intégration de micro-apps podio puisse communiquer avec le backend Podio, un ID client et un secret client doivent être créés et entrés dans la configuration de l’intégration Podio. Ce n’est pas la même chose qu’un ID client et un code secret Citrix Cloud, et doit être généré à partir de Podio.

La documentation complète se trouve ici, mais un résumé est fourni ci-dessous :

1.Log dans les clés API. Renseignez les champs sous API Key Generator :

  1. Entrez un nom pour Nom de l’application. Pour cette preuve de concept, nommez-la Integrations de micro-apps Citrix
  2. 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 tenant, d’une partie région et d’une partie environnement : https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com. Un exemple pourrait être : mycloudworkspace.us.iws.cloud.com
  3. Sélectionnez Generate API Key.
  4. 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.

Confirmer que toutes les données sont collectées

Assurez-vous que les valeurs suivantes ont été collectées. Ces éléments seront nécessaires à l’étape suivante.

  • ID d’application pour la diffusion Citrix Workspace
  • Jeton pour diffusion Citrix Workspace
  • ID de vue pour la diffusion de Citrix Workspace
  • FAQ sur l’ID d’application pour Citrix Workspace
  • FAQ sur les jetons pour Citrix Workspace
  • FAQ Afficher l’ID pour Citrix Workspace
  • ID client
  • Clé secrète client

Ensuite, configurez le service de micro-apps pour utiliser ce nouveau système d’enregistrement

Ajouter une intégration Podio au service de micro-apps

Le modèle d’intégration Podio dans les micro-apps Citrix est une intégration prédéfinie qui propose deux cas d’utilisation prêts à l’emploi : Broadcast et FAQs. Le système d’enregistrement back-end a été créé dans Podio, et maintenant l’intégration des micro-apps et ses modèles de micro-apps vont être ajoutés.

  1. Depuis citrix.cloud.com, connectez-vous à votre client Citrix Cloud
  2. Cliquez sur la vignette Micro-apps
  3. Ajoutez une nouvelle intégration en cliquant sur « Ajouter une intégration »
  4. Comme il s’agit d’une solution fournie par Citrix, choisissez « Ajouter une nouvelle intégration à partir des modèles fournis par Citrix »
  5. Choisissez Citrix Podio
  6. Choisissez Add

À ce stade, l’intégration Citrix Podio, qui inclut quelques modèles de micro-apps, a été ajoutée au service de micro-apps. Ensuite, configurez l’intégration pour communiquer avec les applications Citrix Podio qui ont été ajoutées précédemment.

Configurer l’intégration pour communiquer avec les applications Citrix Podio

Après avoir ajouté l’intégration Citrix Podio, elle doit être configurée. La page Configuration devrait apparaître après l’ajout de l’intégration, mais si ce n’est pas le cas : Accédez à la vignette Micro-apps, recherchez l’intégration Citrix Podio et cliquez sur le lien « Mettre à jour la configuration ».

La documentation de référence principale pour cette étape se trouve sur Citrix Docs : Integrate Podio

Remarque : Lors de l’ajout de l’intégration, peu importe l’ID d’application et le jeton que vous fournissez. Vous pouvez fournir soit l’ID et le jeton de l’application de diffusion, soit l’ID et le jeton de la FAQ. Cela est dû au fonctionnement des espaces de travail Podio. Par la suite, lors de la configuration des actions de chargement et de service des données, ces ID d’application et ces identifiants de vue doivent correspondre aux applications Podio correspondantes.

Lors de la configuration, vous devez modifier les champs suivants dans le formulaire Configuration :

  1. ID d’application Podio : chaque espace de travail Podio possède un ID d’application. Entrez cette valeur en tant que paramètre de jeton d’accès lorsque vous configurez l’intégration en remplaçant la variable podio_app_id. Vous pouvez utiliser l’ID d’application depuis n’importe quelle application Podio dans l’espace de travail Podio.
  2. Jeton d’application : utilisez ce jeton pour vous authentifier en tant qu’application plutôt qu’en tant qu’utilisateur. Entrez cette valeur en tant que paramètre de jeton d’accès lorsque vous configurez l’intégration en remplaçant la variable podio_token_id.
  3. ID du client : l’ID du client est la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation.
  4. 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.

Configuration du chargement des données et des actions de maintenance

Dans cette section, prenez les ID d’application et les ID de vue de chacune des applications Podio Broadcast et FAQ et remplacez les variables et les champs mentionnés dans la documentation complète de cette étape ici.

En savoir plus sur les fonctionnalités de la micro-app Broadcast et FAQ

Un résumé des fonctionnalités de la micro-app Broadcast et FAQ est disponible ici : Utiliser les micro-apps Podio

Octroi de l’accès aux micro-apps dans Workspace

Enfin, configurez les abonnés aux micro-apps, afin que les personnes appropriées aient accès à partir de Citrix Workspace :

Conceptuellement :

  1. Les personnes qui ont besoin de publier une diffusion peuvent avoir accès à (Abonné) à la micro-app Create Broadcast .
  2. Les personnes qui devraient être en mesure de voir les diffusions et de recevoir des notifications dans Workspace depuis l’application Broadcase doivent être abonnées à la micro-application Broadcast
  3. Les personnes qui doivent être en mesure de gérer les diffusions, y compris de les supprimer, doivent être abonnées à la micro-app Gérer les diffusions
  4. Les personnes qui ont besoin de consulter les FAQ dans Workspace doivent être abonnées à la micro-app FAQ

La référence principale pour l’abonnement de personnes à des micro-apps est ici

Remarque : Comme il s’agit d’une preuve de concept, il peut être souhaitable de limiter le nombre d’utilisateurs autorisés à voir les micro-apps (en modifiant Abonnés).

Tester les micro-apps

Dans cette section, les fonctionnalités de base des micro-apps seront testées pour la preuve de concept.

Microapps de diffusion

Dans cet exemple, une personne autorisée à créer une diffusion créera une nouvelle diffusion. Cette diffusion sera ensuite visualisée dans Workspace, à la fois dans le flux d’activité et dans la micro-app Broadcast.

  1. Connectez-vous à votre Citrix Workspace
  2. Accédez à Actions, puis cliquez sur Créer une diffusion
  3. Rédiger un test Broadcast
  4. Cliquez sur Créer
  5. Lorsque Podio apparaît pour demander l’autorisation, choisissez Grant Access

À ce stade, une nouvelle diffusion a été publiée sur Citrix Workspace

Vérifiez que la diffusion a été publiée dans le système d’enregistrement (qui dans ce cas est Podio) :

  1. Dans Citrix Workspace, accédez à Actions, puis cliquez sur Diffuser
  2. La publication de diffusion est visible et vous pouvez cliquer dessus pour afficher tous les détails

Vérifiez que la diffusion est publiée dans le flux d’activité

Par défaut, les notifications au flux d’activité Citrix Workspace ne sont publiées que lorsque les données sont synchronisées de manière incrémentielle depuis le système d’enregistrement soutenu par Podium vers le service d’intégration des micro-apps. Par défaut, cette synchronisation a lieu toutes les heures.

Pour modifier cela ou pour forcer une synchronisation, voir Synchroniser les données.

Une fois la synchronisation des données effectuée, la notification s’affiche dans le flux d’activité de l’espace de travail :

Flux d'activités

Notez que, comme la personne connectée à Workspace a accès à la fois aux micro-apps Créer une diffusion et Diffuser, elle voit à la fois Notifications : pour la confirmation de la création et pour la diffusion elle-même.

Si les notifications ne figurent pas dans le flux d’activité, essayez de modifier le tri du fil de Recommandé à Plus récent.

Micro-app FAQ

Le test de la micro-app FAQ est un peu différent. Il n’existe actuellement aucune micro-app permettant de créer ou de modifier des FAQ, donc cela se fait via Podio. Heureusement, cela permet de montrer comment le backend Podio interagit avec les micro-apps.

  1. Connectez-vous à Podio et accédez à l’application FAQ
  2. Choisissez : Ajouter une question
  3. Renseignez le titre et la réponse (ils sont obligatoires), ainsi que tout autre champ approprié
  4. Pour publier la question, définissez le statut sur Publié
  5. Cliquez sur Enregistrer la question

Cela enregistre la question dans le backend de l’application Podio. Ensuite, consultez Workspace pour la nouvelle entrée de la FAQ :

  1. Connectez-vous à votre Citrix Workspace
  2. Accédez à Actions, puis cliquez sur FAQ
  3. Si une synchronisation des données a eu lieu, la FAQ s’affiche. Pour forcer une synchronisation incrémentielle, voir Synchroniser les données
  4. Cliquez sur la nouvelle entrée de la FAQ pour lire son contenu complet

Remarque : Par défaut, les notifications pour les nouvelles entrées de FAQ ne sont pas publiées automatiquement à intervalles réguliers dans le flux d’activité. Cela permet d’éviter le surpeuplement du flux d’activités. Pour modifier cela, en savoir plus sur les notifications de micro-apps

Ceci termine le test de la fonctionnalité de base de la micro-app

Résumé final

C’est la fin du guide de preuve de concept. En suivant ce guide, vous pouvez :

  1. utilisé App Builder pour créer ou lier une instance Podio à Citrix Cloud
  2. ajout d’une application Podio fournie par Citrix pour servir de système d’enregistrement pour la micro-app Broadcast et la micro-application FAQ
  3. ajout et configuration de l’intégration de micro-app pour utiliser le système d’enregistrement soutenu par Podium
  4. a ajouté des abonnés aux micro-apps, afin que les personnes appropriées puissent publier des diffusions et que toutes les personnes utilisant Workspace puissent voir les diffusions et les FAQ
  5. Test des fonctionnalités de base des micro-apps Broadcast et FAQ dans Citrix Workspace

Lectures supplémentaires

  • Plus de détails sur l’intégration de l’application Citrix Podio aux micro-apps Citrix Workspace : Intégrer Podio