Informations de référence pour le module JavaScript

Utilitaires Bridge : JavaScript

L'utilitaire JavaScript dans Bridge comprend uniquement un module : Run Script. Utilisez ce module pour écrire des fonctions JavaScript et les activer.

Configurer l’utilitaire JavaScript

1. Connectez-vous à Bridge.
2. Accédez à la page Integrations.
3. Recherchez et sélectionnez JavaScript.

Module Exécuter le script

Le module contient les champs suivants, vous pouvez utiliser des références de données dans tous :

• Nom du script : Le nom du script à exécuter.
• Paramètres du script : Les paramètres que le script attend lors de l'exécution, représentés sous la forme d'une correspondance d'objet clé : valeur.
  • Clé : Le nom du paramètre qui apparaît dans le script.
  • Valeur : La valeur assignée à la clé que le script utilise lors de l'exécution du script.

Le nombre de paramètres de script autorisés est illimité et s'ajoute de manière dynamique.

Pour configurer le script que vous souhaitez exécuter :

1. Sélectionnez l'icône d'engrenage en haut du module.
2. Développez la section Scripts.
3. Sélectionnez Ajouter aux scripts.
4. Remplissez les champs Nom du script et Corps du script.
5. Sélectionnez Enregistrer.

Brandfolder Image

Une fois que Bridge a exécuté le module Run Script, les informations suivantes sont disponibles dans le volet Run Log :

• Data
  • résultat : La sortie JavaScript
• État : Section indiquant si le module a fonctionné ou non
  • Code : Le code de réussite/d'erreur que le module extrait de Smartsheet
  • Message : message système extrait de Smartsheet par le module. Par exemple, si le module ne trouve pas de valeur, le message qui s’affiche est Introuvable.
  • Status (Statut) : statut extrait de Smartsheet par le module. Les étiquettes de statut que vous pourriez rencontrer sont Réussi et Échoué.

Exemples

Exemple 1 : Hello world

1. Créez un script dans lequel le Corps du script est : return “Hello” + a.

Vous devez saisir return (Renvoyer) dans chaque script pour générer une réponse.

2. Dans le module, ajoutez le paramètre a avec la valeur monde.
3. Exécuter le flux de travail :

Assurez-vous que l’élément Clé dans l’outil de création de modules correspond au paramètre du champ Corps du script. 

Valeur (Valeur) constitue l’entrée interchangeable. Elle peut provenir par exemple du résultat d’une réponse de module antérieure.

Le Nom du script ne nécessite pas de guillemets pour les entrées de chaîne, mais le Corps du script le nécessite. Sinon, vous obtiendrez un message d'erreur.

Exemple 2 : Opérations de base

Pour concaténer deux chaînes :

1. Créez un script avec le Corps du script : return a + b.
2. Dans le module, ajoutez les paramètres a et b avec les valeurs 3 et 2, respectivement. 
3. Exécuter le flux de travail :

Brandfolder Image

Cette méthode concatène les deux valeurs mais ne les additionne pas. 

Brandfolder Image

Les variables définies via Bridge sont traitées comme des chaînes.

Pour additionner des nombres :

1. Créez un script avec le champ Corps du script : return Number(a) + Number(b).
2. Exécuter le flux de travail :

Avec les mêmes paramètres que dans l'exemple ci-dessous, le résultat cette fois est 5.

Brandfolder Image

Exemple 3 : itérer sur un tableau

Pour cet exemple, nous avons un flux de travail avec le module Liste des feuilles. Lorsque le flux de travail s'exécute, le journal d'exécution fournit les sorties ci-dessous, où data est marqué comme Tableau [100]. Cela signifie que le champ est un tableau.

Brandfolder Image

Vous devez exécuter le flux de travail pour obtenir les informations du journal d'exécution.

1. Sélectionnez les trois points à côté de data, puis sélectionnez Copier la référence de données.

Brandfolder Image

2. Ajoutez un nouveau module Exécuter le script au flux de travail.
3. Créez un nouveau script JavaScript. Pour cet exemple, nous l'appelons getFirstElementOfListSheets, et le Corps du script est returnlistSheets[0]. Cela renvoie le premier élément du tableau de données.

Le nombre dans les crochets carrés définit quel élément du tableau est renvoyé. 0 renvoie le premier, 1 renvoie le deuxième, et ainsi de suite.

Dans le module JavaScript :

4. Définissez getFirstElementOfListSheets comme le Nom du script.
5. Ajoutez un paramètre de script avec Clé #1 appelé listSheets.
6. Collez la référence de données copiée à l'étape 1 dans Valeur #1

Brandfolder Image

Si nous exécutons le flux de travail, le journal d'exécution fournit les sorties ci-dessous. 

Brandfolder Image

Les éléments ci-dessous result font partie du premier élément du tableau.

Limites du produit/de la fonctionnalité

• Vous ne pouvez traiter que 6 Mo de charge utile de demandes et de réponses.

  Cette limite est susceptible de changer avec les futures mises à niveau.

• Il n’y a pas de validation de script au moment de sa création. Si un script est défectueux, il est de la responsabilité du développeur de déboguer/corriger les problèmes et erreurs renvoyés lors de l’exécution du script.
• L’équipe Smartsheet ne suit ni ne gère les versions et l’historique des scripts.
• La solution Bridge convient pour des flux de travail basés sur une planification fixe ou un événement. Elle ne remplace pas la fonctionnalité de synchronisation miroir unidirectionnelle ou bidirectionnelle fournie par les connecteurs. Bridge ne garantit pas intentionnellement l’ordre et ne tient aucunement compte des modifications apportées à l’un ou l’autre des systèmes. Ainsi, les configurations de type connecteur ne sont pas fiables et sont fortement déconseillées.