Micro-apps

Intégrer Smartsheet

Déployez l’intégration Smartsheet pour gérer les feuilles, les discussions, les demandes de mise à jour et les pièces jointes.

Pour plus de détails sur la micro-app prête à l’emploi pour Smartsheet, consultez la section Utiliser les micro-apps Smartsheet.

Remarque :

Ce modèle d’intégration Smartsheet est publié dans la catégorie Citrix Labs . Cela permet à la fonctionnalité d’être développée davantage à la suite des commentaires initiaux des clients. Lorsqu’un modèle fait partie de Citrix Labs, 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 Citrix Labs sont partagés à des fins de test et de validation. Nous ne conseillons pas de les déployer dans des environnements de production. Les modèles Citrix Labs sont répertoriés dans une section distincte. 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 notre forum dédié quotidiennement.

Vérifier les conditions préalables

Ces conditions préalables supposent que l’administrateur fait partie de la configuration d’intégration Smartsheet de l’organisation. Ce compte administrateur Smartsheet doit disposer de privilèges de lecture complets sur tous les utilisateurs et sur toutes les informations liées aux feuilles.

Une fois l’intégration avec Smartsheet configurée, vous aurez besoin de ces artefacts pour ajouter l’intégration dans les micro-apps Citrix Workspace :

  • URL de base : https://api.smartsheet.com/
  • URL d’autorisation : https://app.smartsheet.com/b/authorize
  • URL du jeton : https://api.smartsheet.com/2.0/token
  • ID du client : l’ID du client est la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation. Vous obtenez cet élément en tant que clé de l’application lorsque vous configurez le serveur OAuth.
  • 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. Vous obtenez cet élément en tant que clé de l’application lorsque vous configurez le serveur OAuth.

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.

Configurez Citrix Gateway pour prendre en charge l’authentification unique pour Blackboard : une fois que les utilisateurs se connectent, ils sont automatiquement reconnectés sans avoir à entrer leurs informations d’identification une seconde fois. Pour plus d’informations sur la configuration de l’authentification unique (SSO, Single Sign-On), consultez la section Citrix Gateway Service.

Créer un compte de service

L’intégration nécessite un accès régulier à votre instance Smartsheet. Nous vous recommandons donc de créer un compte utilisateur dédié. Ce compte doit disposer des autorisations suivantes pour le compte de service : Privilèges administrateur complet. Vous pouvez afficher les permission/privilèges en accédant à https://admin.smartsheet.com.

Pour créer un compte de service, inscrivez-vous ici : https://app.smartsheet.com/b/signup. Assurez-vous que le compte payant est disponible pour créer un compte de service.

En cas de problème lors de la configuration du nouveau compte de service, contactez l’équipe de support commercial ou l’équipe de support technique : https://www.smartsheet.com/contact/sales?fts=contact.

Accès aux API

Le nombre de requêtes d’API pouvant être exécutées sur des ressources spécifiques est limité. Nous recommandons donc ce qui suit :

Les API Smartsheet sont disponibles en code Open Source par défaut.

Configurer le serveur OAuth

Configurez le serveur OAuth pour lire les données via l’intégration Smartsheet.

  1. Accédez à https://developers.smartsheet.com/register/ et saisissez l’adresse e-mail d’administration de votre compte de service.
  2. Sélectionnez Register Developer Account.
  3. Vérifiez si vous avez reçu un e-mail de Smartsheet dans la boîte de réception de l’administrateur du compte de service.
  4. Sélectionnez le lien. Vous êtes dirigé vers https://app.smartsheet.com.
  5. Une boîte de dialogue vous invite à créer une application. Sélectionnez Create New App sous la section du profil du développeur.
  6. Remplissez les champs obligatoires, y compris App name, Description, URL et Contact/Support email.
  7. Entrez les URL de redirection autorisées suivantes pour cette application dans le champ Redirect URL : https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext.
  8. Activez la case à cocher Publish app et sélectionnez Save.
  9. Copiez et enregistrez les champs ClientId et Secret affichés à l’écran. Vous utilisez ces détails pour l’authentification du service lors de la configuration de l’intégration.

Configurer le client OAuth

Configurez le client OAuth pour écrire les données via l’intégration MS Teams.

  1. Comme à l’étape 5 ci-dessus, sélectionnez Create New App sous la section du profil du développeur.
  2. Remplissez les champs obligatoires, y compris App name, Description, URL et Contact/Support email.
  3. Entrez les URL de redirection autorisées suivantes pour cette application dans le champ Redirect URL : https://{yourmicroappserverurl}/admin/api/gwsc/auth/serviceAction/callback.
  4. Activez la case à cocher Publish app et sélectionnez Save.
  5. Copiez et enregistrez les champs ClientId et Secret affichés à l’écran. Vous utilisez ces détails pour l’authentification du service lors de la configuration de l’intégration.
  6. Sélectionnez Close.

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

Ajoutez l’intégration Smartsheet 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 Smartsheet.
  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.
  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 OAuth 2.0 dans le menu Méthode d’authentification et complétez les détails d’authentification.
    2. Sélectionnez En-tête d’autorisation dans le menu Autorisation de jeton.
    3. L’URL d’autorisation est pré-remplie : https://app.smartsheet.com/b/authorize
    4. L’URL du jeton est pré-remplie : https://api.smartsheet.com/2.0/token
    5. Assurez-vous que les éléments suivants sont saisis sous Étendue : ADMIN_SHEETS ADMIN_USERS READ_SHEETS READ_USERS
    6. 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 obtenez cet élément en tant que ClientId lorsque vous configurez le serveur OAuth.
    7. Entrez la 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. Vous obtenez cet élément en tant que clé secrète lorsque vous configurez le serveur OAuth.
  6. Sous Authentification des actions de service, activez Utiliser authentification utilisateur distincte dans Actions. L’authentification des actions de service s’authentifie au niveau de l’action de service. Les options d’authentification sont présélectionnées. Assurez-vous que ces options sont sélectionnées lorsque vous effectuez le processus.
    1. Sélectionnez OAuth 2.0 dans le menu Méthode d’authentification et complétez les détails d’authentification.
    2. Sélectionnez En-tête d’autorisation dans le menu Autorisation de jeton.
    3. L’URL d’autorisation est pré-remplie : https://app.smartsheet.com/b/authorize
    4. L’URL du jeton est pré-remplie : https://api.smartsheet.com/2.0/token
    5. Assurez-vous que les éléments suivants sont saisis sous Étendue : ADMIN_SHEETS ADMIN_USERS SHARE_SHEETS WRITE_SHEETS CREATE_SHEETS ADMIN_WORKSPACES
    6. 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 obtenez cet élément en tant que ClientId lorsque vous configurez le client OAuth.
    7. Entrez la 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. Vous obtenez cet élément en tant que clé secrète lorsque vous configurez le client OAuth.
  7. Activez l’option Activer la limitation du taux de demandes. Entrez 300 pour Nombre de demandes et 1 minute pour Intervalle de temps.
  8. Le champ Délai d’expiration de la demande est défini sur 120 par défaut.
  9. (Facultatif) Activez la fonction Journalisation pour conserver 24 heures de journalisation à des fins de support.
  10. Sélectionnez Enregistrer pour continuer.

Vous êtes maintenant prêt à définir et exécuter votre première synchronisation de données.

Synchronisation

En raison de la limite des appels d’API, la synchronisation incrémentielle est configurée pour conserver uniquement les requêtes « List org sheets », « List org discussions » et « Get all org sentupdaterequests ». Les points de terminaison restants seront déclenchés dans le cadre de la synchronisation complète.

Nous vous recommandons de définir l’intervalle de synchronisation complète sur Quotidien et l’intervalle de synchronisation incrémentielle sur Toutes les 5 minutes pour actualiser régulièrement les données de Smartsheet vers la plate-forme de micro-apps et recevoir des notifications en temps opportun. 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.

Remarque

La limite de pagination est définie sur 100. Les administrateurs peuvent étendre cette limite en fonction des API.

La valeur par défaut de la variable Nombre maximal de pages à charger est définie comme suit :

Nom du point de terminaison Valeur
List Org Sheets 50
List Groups 10
List Org Discussions 10
Get all org sentupdaterequests 10
List Sheets 50
Get Sheets 10
List Sheet Shares 10
List Groups 50

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

Utiliser les micro-apps Smartsheet

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.

Accéder aux feuilles : permet d’afficher les feuilles, de partager une feuille avec un utilisateur ou un groupe détenant une licence ou non, d’ajouter une feuille comme favori et d’autoriser les utilisateurs à afficher leur feuille individuelle.

Notification ou Page Workflows de cas d’utilisation
Page Afficher toutes les feuilles Permet aux utilisateurs de rechercher des feuilles partageables et non partageables.
Page Détails de la feuille partageable Fournit une vue exploitable permettant d’ajouter la feuille comme favori, d’afficher la feuille, de partager la feuille avec des utilisateurs ou des groupes détenant une licence ou non.
Page Détails de la feuille non partageable Fournit une vue exploitable permettant d’ajouter la feuille comme favori et d’afficher la feuille.
Page Détails de la feuille de groupe partageable Fournit une vue exploitable permettant d’ajouter la feuille comme favori, d’afficher la feuille, de partager la feuille avec des utilisateurs ou des groupes détenant une licence ou non.
Page Détails de la feuille de groupe non-partageable Fournit une vue exploitable permettant d’ajouter la feuille de groupe comme favori et d’afficher la feuille de groupe.

Créer une feuille : permet de créer une feuille et d’utiliser les options pour entrer le nom de la feuille et le titre de la colonne, ainsi que sélectionner le type de colonne et la colonne principale.

Notification ou Page Workflows de cas d’utilisation
Page Créer une feuille Fournit un formulaire permettant de créer une feuille.

Discussion : permet de générer une notification pour le créateur de discussion chaque fois qu’une réponse est ajoutée à son fil de discussion.

Notification ou Page Workflows de cas d’utilisation
Notification Nouveau commentaire ajouté à votre discussion Lorsqu’une réponse ou un commentaire est ajouté à une discussion existante, le créateur de discussion reçoit une notification.
Page Détails de la discussion Fournit un formulaire permettant de répondre au fil de discussion et d’afficher les commentaires précédents.

Mes demandes de mise à jour : permet d’afficher des demandes de mise à jour envoyées et reçues, y compris des détails tels que Envoyé à, Envoyé par, Objet et État. En outre, lorsqu’un utilisateur envoie une demande de mise à jour aux destinataires, les destinataires reçoivent une notification. Une fois la demande de mise à jour terminée, l’expéditeur reçoit la notification Terminé.

Notification ou Page Workflows de cas d’utilisation
Notification Demande de mise à jour Smartsheet reçue Lorsqu’un demandeur envoie une demande de mise à jour, le destinataire reçoit une notification.
Notification Demande de mise à jour Smartsheet terminée Lorsqu’un destinataire termine une demande de mise à jour, le demandeur reçoit une notification.
Page Toutes les demandes de mise à jour Permet aux utilisateurs de rechercher les demandes de mise à jour envoyées et reçues.
Page Détails de la demande de mise à jour envoyée Fournit une vue exploitable de la demande de mise à jour envoyée avec les fonctionnalités Supprimer la demande de mise à jour et Afficher la feuille.
Page Détails de la demande de mise à jour reçue Fournit une vue en lecture seule d’une demande de mise à jour reçue avec la fonctionnalité Afficher la feuille.
Page Détails de la demande de mise à jour terminée Fournit une vue en lecture seule d’une demande de mise à jour terminée avec la fonctionnalité Afficher la feuille.

Envoyer une feuille Smartsheet en tant que pièce jointe : permet d’envoyer une feuille Smartsheet en tant que pièce jointe (PDF ou Excel) et inclut des détails tels qu’Adresse e-mail, Objet et Message.

Notification ou Page Workflows de cas d’utilisation
Page Afficher toutes les feuilles Permet aux utilisateurs de rechercher les feuilles qui leur appartiennent.
Page Détails Envoyer en tant qu’e-mail Fournit une vue exploitable permettant d’envoyer une feuille Smartsheet sous forme de pièce jointe (PDF ou Excel) avec des détails tels qu’Objet et/ou Message.

Partager avec l’administrateur : permet aux utilisateurs non-administrateurs de partager leurs feuilles en mode de lecture seule avec leurs administrateurs, de déverrouiller d’autres fonctionnalités telles que Accéder aux feuilles, Ma demande de mise à jour et Discussion, ainsi que de recevoir la notification respective. Partagez vos feuilles avec les administrateurs pour déverrouiller d’autres actions et notifications Smartsheet dans Workspace, notamment : actions/notifications de demande de mise à jour, notifications de discussion et affichage de vos feuilles.

Remarque :

Dans cette micro-app, la page nommée Partager la feuille avec l’administrateur contient un composant sélectionnable appelé E-mail de l’administrateur (ce composant n’est pas visible pour l’utilisateur final). Ce composant est utilisé pour partager des feuilles d’utilisateur avec le compte d’administrateur de votre organisation. Ce compte d’administrateur est le même compte de service que vous avez configuré à l’étape précédente. Si votre organisation dispose de plusieurs comptes de service ou de comptes administrateur, assurez-vous de pointer le composant sélectionnable E-mail de l’administrateur sur le compte approprié pour vous assurer que cette micro-app fonctionne correctement.

Notification ou Page Workflows de cas d’utilisation
Page Afficher toutes les feuilles Permet aux utilisateurs d’effectuer des recherches dans leurs feuilles et de les partager avec l’administrateur au besoin.
Page Détails Partager la feuille avec l’administrateur Fournit une vue exploitable permettant de partager une feuille avec l’administrateur avec un accès en lecture seule et d’inclure un commentaire à la feuille déjà partagée.
Page Feuille partagée avec l’administrateur Fournit un message de confirmation à l’utilisateur lorsque la feuille est partagée avec l’administrateur.

Démarrer une discussion : permet de lancer une discussion au niveau de la feuille.

Notification ou Page Workflows de cas d’utilisation
Page Démarrer une discussion Fournit une vue exploitable permettant de lancer une discussion au niveau d’une feuille.