Micro-apps

Intégrer Citrix Podio

Notre nouveau modèle d’intégration Citrix Podio offre des actions rapides sur Citrix Workspace en utilisant la flexibilité et les cas d’utilisation diversifiés de Podio. Grâce à cette intégration, vous pouvez facilement connecter nos micro-apps prêtes à l’emploi sur Workspace aux applications Podio correspondantes disponibles sur Podio App Market.

  • Applications Podio : Citrix dispose de plus de 285 applications sur Podio App Market ; vous pouvez également créer vos propres applications en tant qu’utilisateur professionnel avec Podio. Le modèle d’application vous permet de créer l’application afin qu’elle réponde aux besoins spécifiques de votre entreprise et de la mettre en correspondance avec le processus unique de votre équipe sur Podio. Pour de plus amples informations, consultez la section Créer des applications.
  • Cette intégration vous permet également de créer vos propres applications et solutions personnalisées sur Podio, de créer des micro-apps et de les déployer sur Citrix Workspace. Ces micro-apps utilisent Podio, un service appartenant à Citrix, en tant que système d’enregistrement (SoR). Par conséquent, vos données traitées avec ces micro-apps résident dans le réseau Citrix, et suivent les directives et protocoles Citrix.

Plusieurs applications Podio peuvent utiliser la même intégration de micro-apps. Tenez compte des points suivants lors de la conception de vos intégrations Podio :

  • L’ID d’application et le jeton d’application sont uniques à l’espace de travail. Ces valeurs peuvent être utilisées pour toutes les applications d’un espace de travail Podio.
  • Le modèle d’intégration Podio est conçu pour les notifications push. Comme cette intégration utilise le jeton d’application plutôt que les autorisations utilisateur, les droits de contexte utilisateur et les écritures ne sont pas pris en charge.
  • Si les applications se trouvent dans le même espace de travail Podio, elles peuvent être utilisées avec une seule intégration de micro-apps. Si les applications se trouvent dans des espaces de travail Podio différents, utilisez différentes intégrations.
  • Tenez également compte de la séparation logique, des bases d’utilisateurs et de la facilité de gestion.

Vérifier les conditions préalables

Vérifiez les exigences suivantes. Celles-ci sont séparés en deux groupes : niveau d’intégration et niveau d’application Citrix Podio. Ces deux groupes d’exigences sont nécessaires pour ce modèle d’intégration. Cependant, vous ne pouvez implémenter que les micro-apps souhaitées au niveau de l’application.

Exigences d’intégration

Pour configurer cette intégration, vous devez disposer des autorisations d’administrateur pour l’espace de travail Podio cible et disposer de l’application Podio.

Vous devez entrer les valeurs suivantes dans l’écran de configuration de l’intégration pour configurer l’intégration :

  • URL de base : https://api.podio.com. Cette valeur est préremplie.
  • ID d’application Podio : chaque espace de travail Podio possède un ID d’application. Entrez cette valeur en tant que paramètres du jeton d’accès lorsque vous configurez l’intégration et remplacez la variable podio_app_id. Vous pouvez utiliser l’ID d’application depuis n’importe quelle application Podio dans l’espace de travail Podio. Consultez Obtenir l’ID d’application et le jeton d’application.
  • 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ètres du jeton d’accès lorsque vous configurez l’intégration et remplacez la variable podio_token_id. Obtenez cette valeur à l’aide de l’ID d’application.
  • URL du jeton : cette valeur est préremplie : https://api.podio.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. Consultez 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.

Exigences pour l’application Citrix Podio

Il s’agit des valeurs que vous devez entrer au niveau de l’application Podio pour configurer les points de terminaison et les actions de service pour chaque application Podio à laquelle vous souhaitez vous connecter via cette intégration. Les valeurs suivantes peuvent être requises pour chaque application :

  • ID de vue : certains modèles de point de terminaison et d’action de service Podio utilisent les vues Podio en tant que filtre pour télécharger une quantité sélectionnée d’enregistrements. Utilisez cette valeur pour remplacer la variable de modèle <podioapp>_view_id lorsque vous modifiez des configurations. Consultez Obtenir l’ID de vue.
  • ID d’application : chaque application dispose d’un ID unique. Utilisez cette valeur pour remplacer la variable de modèle <podioapp>_app_id lorsque vous modifiez des configurations.

Les valeurs uniques de l’application Podio sont les suivantes :

Application Podio Valeurs d’ID Obtenir l’application
Application Diffusion broadcast_app_id broadcast_view_id Application Diffusion Citrix Workspace
Application Questions fréquentes faq_app_id faq_view_id Application Questions fréquentes Citrix Workspace

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

Obtenez l’ID d’application et le jeton d’application 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 regard du nom de l’application. Les étapes de l’application Diffusion sont affichées à titre d’exemple dans les captures d’écran.

    Icône Podio Tools

  3. Sous APP, sélectionnez Developer.

    Collection de jetons de l'application Podio

  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.

    Collection de jetons de l'application Podio

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.

Obtenir l’ID de vue

Certains points de terminaison et actions de service Podio utilisent les vues Podio en tant que filtre pour télécharger une quantité sélectionnée d’enregistrements. Pour plus d’informations sur l’utilisation des vues et des filtres dans Podio, consultez la page Views, filters and reports.

Vous devez trouver votre ID de vue pour les champs spécifiés ci-dessous en fonction des micro-apps que vous souhaitez implémenter. Vous utilisez cette valeur pour remplacer la variable de modèle view_id lorsque vous remplacez les variables d’action de service comme décrit ci-dessous dans la section Remplacer les variables Chargement de données et Action de service.

  • Pour l’application Diffusion, le champ est Modifié aujourd’hui.
  • Pour l’application Questions fréquentes, le champ est Questions fréquentes publiées.
  1. Connectez-vous à Podio et accédez à votre application Podio.
  2. Passez la souris sur le champ spécifié ci-dessus pour afficher l’ID de vue en bas à gauche de votre page de navigateur. Le champ dans l’application Diffusion est affiché à titre d’exemple dans les captures d’écran.

    Afficher l'ID de vue

  3. Vous pouvez sélectionner le champ spécifié pour ouvrir la vue associée. Copiez la partie finale de l’URL et enregistrez-la pour une utilisation ultérieure lorsque vous remplacez des variables dans des actions de service.

    Obtenir l'ID de vue 2

Vous pouvez également obtenir l’ID de vue à partir du portail du développeur Podio. Procédez comme suit :

  1. Connectez-vous à Podio API Views.
  2. Sélectionnez Get views.
  3. Faites défiler la page jusqu’à la section Sandbox et connectez-vous si nécessaire.
  4. Entrez l’ID d’application (app_id) que vous avez collecté lors du processus Obtenir l’ID d’application et le jeton d’application.
  5. Laissez la valeur include_standard_views définie sur false, puis sélectionnez Submit.

    Obtenir le sandbox

  6. Vous pouvez effectuer une rechercher (Ctrl+F) dans la sortie en utilisant view_id. Cette valeur s’affiche vers la fin de la sortie. Copiez et enregistrez la valeur pour une utilisation ultérieure.

    Afficher l'ID de vue

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

Vous devez obtenir un ID client et une clé secrète client dans Podio pour entrer dans l’écran de configuration des micro-apps pour l’authentification.

  1. Connectez-vous à Clés API. Remplissez les champs sous API Key Generator.
  2. Donnez un nom à votre application dans le champ Application name.
  3. 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.
  4. Sélectionnez Generate API Key.
  5. 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.

    Collection de jetons de l'application Podio

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 :
    • Sélectionnez une icône pour l’intégration dans la bibliothèque d’icônes ou gardez l’icône par défaut.

    Écran de configuration

  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. Saisissez application dans le champ Valeur du type d’autorisation.
    3. Sélectionnez Corps de la requête dans le menu Autorisation de jeton.
    4. Sélectionnez URL du formulaire codée dans le menu Type de contenu du jeton.
    5. Confirmez le champ URL du jeton. Cette valeur est préremplie : https://api.podio.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 l’ID client et la clé secrète client lorsque vous avez généré une clé API.
    7. Entrez la Clé secrète client. La clé secrète client est une chaîne unique émise avec l’ID client lors de la génération d’une clé API.

    Authentification du service Podio

  6. Entrez les valeurs des paramètres du jeton d’accès. Pour de plus amples informations, consultez Obtenir l’ID d’application et le jeton d’application :
    • Entrez l’ID de l’application que vous avez collecté en regard de podio_app_id. Vous pouvez utiliser l’ID d’application depuis n’importe quelle application Podio dans l’espace de travail Podio.
    • Entrez le jeton d’application que vous avez collecté en regard de podio_app_token.

    Jeton Podio

  7. N’activez pas l’option Authentification des actions de service.
  8. N’activez pas l’option Limitation du taux de demandes.
  9. Entrez 120 dans le champ Délais d’expiration des demandes.
  10. (Facultatif) Activez la fonction Journalisation pour conserver 24 heures de journalisation à des fins de support.
  11. Sélectionnez Enregistrer pour continuer.

    Délai d'expiration Podio

La page Intégrations de micro-apps s’ouvre avec votre intégration ajoutée et ses micro-apps associées. Vous devez ensuite apporter quelques modifications aux variables de modèle pour les points de terminaison et les actions de service, comme décrit ci-dessous.

Remplacer les variables Chargement de données et Action de service

Pour terminer cette configuration, vous devez remplacer les variables de modèle ID d’application et ID de vue dans la configuration d’intégration Podio par l’ID d’application et l’ID de vue que vous avez obtenus ci-dessus pour chacune des applications Podio auxquelles vous vous connectez. Vous remplacez ces variables pour le chargement des données et les actions de service.

Guide rapide pour remplacer les variables

Il s’agit des valeurs que vous devez entrer au niveau de l’application Podio pour configurer les points de terminaison et les actions de service pour chaque application Podio à laquelle vous souhaitez vous connecter via cette intégration :

  • broadcast_app_id Modifier les points de terminaison : Diffusion, Catégorie de diffusion, Criticité de diffusion, État de diffusion ; Actions de service : Créer diffusion, Mettre à jour la diffusion.
  • broadcast_view_id Modifier le point de terminaison : Diffusion ; Action de service : Créer diffusion.
  • faq_app_id Modifier les points de terminaison : Catégorie de question fréquente et Questions fréquentes.
  • faq_view_id Modifier le point de terminaison : Questions fréquentes.

Modifiez les variables suivantes dans les emplacements indiqués. Des conseils étape par étape sont fournis ci-dessous.

Remplacer les variables Chargement des données

Pour chaque point de terminaison de données, vous devez ajouter manuellement votre variable pour l’ID d’application et l’ID de vue. Effectuez cette opération pour les six points de terminaison.

  • broadcast_app_id Modifier les points de terminaison : Diffusion, Catégorie de diffusion, Criticité de diffusion, État de diffusion.
  • broadcast_view_id Modifier le point de terminaison : Diffusion.
  • faq_app_id Modifier les points de terminaison : Catégorie de question fréquente et Questions fréquentes.
  • faq_view_id Modifier le point de terminaison : Questions fréquentes.
  1. Sur la page Intégrations de micro-apps, sélectionnez le menu en regard de l’intégration Podio, puis Modifier. L’écran Chargement des données s’ouvre. Si vous êtes sur l’écran de configuration, sélectionnez Chargement des données dans la colonne de navigation gauche.
  2. Sélectionnez le menu en regard du premier point de terminaison, puis sélectionnez Modifier ou sélectionnez le nom du point de terminaison. Commençons par le point de terminaison Diffusion.

    Chargement des données Podio

  3. Sur l’écran Modifier le point de terminaison de données, sous Variables de modèle, remplacez les variables {broadcast_app_id} et {broadcast_view_id} par votre ID d’application.

    Modèle de point de terminaison Podio

  4. Sélectionnez Appliquer en bas de l’écran et confirmez vos sélections.
  5. Répétez maintenant cette procédure pour les cinq autres points de terminaison en remplaçant les valeurs selon les besoins. N’oubliez pas de sélectionner Appliquer en bas de l’écran pour confirmer l’enregistrement pour chaque point de terminaison.

Remplacer les variables Action de service

Pour chaque action de service, vous devez ajouter manuellement vos informations pour broadcast_app_id et broadcast_view_id. L’action de service Créer diffusion nécessite le remplacement des deux variables. L’action de service Mettre à jour la diffusion nécessite uniquement le remplacement de la variable broadcast_app_id.

  • broadcast_app_id Modifier les actions de service : Créer diffusion et Mettre à jour la diffusion.
  • broadcast_view_id Modifier l’action de service : Créer diffusion.
  1. Lors de la modification de la configuration de l’intégration, sélectionnez Actions de service dans la colonne de navigation gauche.
  2. Sélectionnez le menu situé en regard de l’une des actions de service, puis sélectionnez Modifier, ou sélectionnez le nom de l’action de service. Commençons par l’action de service Créer diffusion.

    Liste des actions de service Podio

  3. Sur l’écran Modifier l’action de service, sous Variables de modèle, remplacez les variables {broadcast_app_id} et {broadcast_view_id} par l’ID d’application et l’ID de vue que vous avez obtenus précédemment.

    Modèle d'action de service Podio

  4. Sélectionnez Enregistrer pour terminer le processus
  5. Répétez maintenant cette opération pour l’autre action de service Mettre à jour la diffusion, mais en remplaçant uniquement la variable broadcast_app_id.

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

Utiliser les micro-apps Podio

Ce modèle d’intégration Podio est fourni avec des micro-apps prêtes à l’emploi. Commencez avec ces micro-apps et personnalisez-les en fonction de vos besoins.

Micro-apps Podio

Micro-apps de diffusion Podio

Utilisez ces micro-apps pour composer et partager des annonces importantes avec votre équipe. Ces annonces peuvent porter sur des mises à jour générales, des mises à jour sur des infrastructures, des mises à jour informatiques, des changements dans les processus, des communications critiques en cas de crise, ou tout simplement être utilisées pour partager avec votre équipe des actualités en matière de divertissement et de bien-être.

L’application Diffusion Citrix Workspace constitue une condition préalable pour les micro-apps Diffusion. Vous devez installer cette application depuis Podio App Market. Ce modèle d’application Podio est fourni avec un ensemble prédéfini de valeurs pour les champs Catégorie et Criticité. Utilisez la fonctionnalité Modifier le modèle de l’application pour ajouter ou modifier des options pour ces champs en fonction des besoins de votre entreprise. Cette modification ne nécessite aucune modification des micro-apps correspondantes. Vous pouvez également modifier l’application Podio en ajoutant ou en modifiant d’autres champs. Cependant, cela vous oblige également à refléter les modifications correspondantes dans la micro-app. Obtenez l’application Podio : Application Diffusion Citrix Workspace.

Prenez en compte les considérations suivantes :

  • Les micro-apps Créer diffusion et Gérer la diffusion décrites ci-dessous sont des micro-apps d’administration.
  • L’état Actif dans ces micro-apps correspond à la publication du message. Lorsqu’un message est publié, il est disponible dans la micro-app Diffusion pour les utilisateurs standard ou non-administrateurs.
  • Si un champ d’état de l’application Podio est modifié et que des valeurs différentes sont utilisées, les valeurs correctes doivent également être mises à jour dans la micro-app. Par exemple, si vous souhaitez utiliser Publié comme état au lieu d’Actif, la micro-app doit être personnalisée avec le même état.

Diffusion : permet d’afficher toutes les diffusions publiées (État : Actif) dont la date de fin est dans le futur.

Notification ou Page Workflows de cas d’utilisation
Notification Diffusion modifiée Lorsqu’une diffusion est modifiée et active, les abonnés reçoivent une notification.
Notification Nouvelle diffusion Lorsqu’une nouvelle diffusion est active, les abonnés reçoivent une notification.
Page Diffusion Fournit une page en lecture seule contenant les détails de la diffusion.
Page Diffusions Fournit une liste de vos diffusions, y compris un lien vers les détails correspondants.

Créer diffusion : permet de créer et de publier de nouvelles diffusions.

Notification ou Page Workflows de cas d’utilisation
Page Créer diffusion Fournit une page permettant de créer et de publier des diffusions.

Gérer la diffusion : permet aux administrateurs d’afficher et de mettre à jour toutes les diffusions créées. Cette vue ne se limite pas aux diffusions publiées (État : Actif).

Notification ou Page Workflows de cas d’utilisation
Notification Diffusion modifiée Lorsqu’une diffusion est mise à jour, les abonnés reçoivent une notification.
Notification Nouvelle diffusion Lorsqu’une nouvelle diffusion est active, les abonnés reçoivent une notification.
Page Diffusions Fournit une liste consultable des diffusions créées, y compris un lien vers les détails où vous pouvez mettre à jour les diffusions.
Page Diffusion Fournit une page en lecture seule similaire à la page utilisée dans la micro-app Diffusion qui permet d’afficher la diffusion telle qu’elle sera présentée au public. Le bouton Mettre à jour permet d’accéder à la page Mettre à jour la diffusion où les administrateurs peuvent modifier cette diffusion.
Mettre à jour la diffusion Fournit une page permettant de mettre à jour une diffusion existante.

Arrêter d’afficher les diffusions expirées

Activez ce workflow pour automatiser l’identification des diffusions dont la date de fin a expiré. La diffusion est marquée comme terminée et n’est plus affichée aux abonnés.

Ce workflow est disponible avec le forfait Podio Premium. Consultez Workflow Automation pour de plus amples informations. L’administrateur qui a configuré cette intégration active le flux en se connectant à https://workflow-automation.podio.com et en actualisant l’espace de travail Podio associé.

Micro-app Questions fréquentes Podio

Compilez une liste de questions fréquentes et rendez-les disponibles dans Citrix Workspace. L’application Questions fréquentes Citrix Workspace constitue une condition préalable pour la micro-app Questions Fréquentes. Vous devez installer cette application depuis Podio App Market. Obtenez l’application Podio : Application Questions fréquentes Citrix Workspace.

Questions fréquentes : liste des questions et réponses les plus fréquentes.

Notification ou Page Workflows de cas d’utilisation
Page Questions fréquentes Fournit une liste consultable de questions fréquentes qui peut être filtrée par catégorie, ainsi qu’un lien vers la page Questions et réponses.
Page Questions et réponses Fournit une vue détaillée d’une question fréquente, ainsi qu’un lien vers le matériel source.