Micro-apps

Script d’intégration HTTP

Le script d’intégration HTTP vous permet d’exécuter des scripts automatiques sur certaines de vos fonctionnalités d’intégration HTTP :

  • Chargement des données : votre script peut définir une ou plusieurs fonctions de synchronisation qui récupère des données à partir d’un système d’enregistrement (SoR), les transformer et les stocker dans le cache.

  • Actions de service : votre script peut définir une ou plusieurs fonctions qui écrit des données dans le système d’enregistrement (SoR), récupère des informations sur l’enregistrement créé ou mis à jour et les stocke dans le cache.

Chaque script définit plusieurs synchronisations et fonctions d’action. L’intégration HTTP appelle ensuite ces fonctions lors de l’exécution de la synchronisation ou lorsque votre utilisateur de micro-app appelle une action.

Des ressources détaillées supplémentaires destinées au développeur concernant le script de micro-app sont disponibles sur le Portail Citrix Developer.

Avant de commencer

L’utilisation de la fonctionnalité de script part du principe que vous connaissez bien le système d’enregistrement (SoR) de votre application cible. Utilisez le script lorsque toutes les autres méthodes d’intégration ont été utilisées dans la configuration de votre intégration.

Lorsque vous utilisez des scripts pour les intégrations HTTP, vous devez suivre ce processus général :

  • Préparez le script que vous souhaitez importer via l’interface d’administration de micro-apps.
  • Les scripts doivent être écrits en langage javascript modifié dans l’éditeur de texte/l’outil de développement de votre choix.
  • Lorsque vous êtes prêt, importez le script via l’onglet Intégrations de l’interface d’administration de micro-apps ou, éventuellement, vous pouvez entrer votre script directement dans l’éditeur de texte fourni dans la fonction de script.
  • Lors de l’importation, testez le script.

Importer un script

Pour importer votre script préparé via l’onglet Intégrations de l’interface d’administration de micro-apps Procédez comme suit :

  1. Sélectionnez Script.

    Script

  2. Sélectionnez Télécharger le script. Vous pouvez également saisir votre script directement dans la zone de texte en sélectionnant Modifier.

    Importer un script

    Un panneau s’ouvre.

  3. Faites glisser votre script dans la fenêtre contextuelle d’importation.
  4. Le script est analysé et validé.

    Réussite du script d'importation

  5. Sélectionnez Importer.
  6. Votre script est importé.

Remarque :

Vous pouvez maintenant modifier le script directement dans l’éditeur de texte de script ou mettre à jour le script en important à nouveau le fichier de script.

  • Vous pouvez afficher la synchronisation par script en tant que points de terminaison de données sur les écrans Chargement des données et Actions de service.
  • Vous pouvez afficher le tableau défini par le script sur la page Tableaux.

    Tableau de script

  • Vous pouvez afficher la sortie du script dans le journal.
  • Vous pouvez afficher les requêtes exécutées par le script dans le journal de synchronisation.

Pour afficher et surveiller votre script lors de son exécution, accédez à l’écran Journaux.

Questions fréquentes

Authentification : la création de scripts utilise le même client que celui configuré pour l’intégration de votre système d’enregistrement (SoR), et par conséquent, correspond à toutes les mêmes authentifications définies dans votre intégration HTTP.

Tous les paramètres de configuration spécifiés dans Chargement des données et Actions de service pour votre système d’enregistrement (SoR) cible sont propagés dans les scripts.

Les scripts, une fois chargés, sont inclus dans l’importation/l’exportation des micro-apps (ils peuvent donc être exportés vers le référentiel groupé).

Paramètres d’intégration personnalisés

Les scripts prennent également en charge les paramètres d’intégration personnalisés lors de la configuration de vos intégrations HTTP. Par exemple, votre intégration utilise des ID d’application spécifiques pour référencer une application spécifique dans un espace de travail utilisateur. Cet ID est spécifique à l’utilisateur et doit être défini pour chaque intégration.

Les paramètres personnalisés ou les clés secrètes sont définis par la définition du paramètre de configuration qui se compose des éléments suivants :

  • nom (chaîne, pas d’espaces, pas de caractères spéciaux)
  • intitulé (chaîne)
  • description (chaîne)
  • type (chaîne, identique au type de colonne)
  • valeur par défaut (renseignée lors de l’importation)
  • requis (booléen)
  • clé secrète (booléen) (les clés secrètes ne sont jamais enregistrées dans le cache ou les journaux de micro-apps).

Autres ressources

Pour en savoir plus sur le développement de scripts, consultez le Portail Citrix Developer.

Commencez à développer vos propres scripts en accédant à Getting started with Microapps scripting.

Consultez des exemples de scripts de micro-apps en accédant à Microapps script SDK.

Obtenez la dernière version du SDK en accédant à Microapps script SDK releases.

Script d’intégration HTTP