Scripts de génération

La génération de script permet d’exécuter un script manuellement. Elle sert aussi à lancer un script à partir d’autres scripts ou de processus externes. Vous pouvez également l’utiliser pour tester un script. Dans ce cas, elle peut être associée aux traces de script.

Pour tester les scripts, vous pouvez lancer des scripts à partir de Studio en utilisant l'option de traçage trace option.

Pour lancer des scripts à partir d’autres scripts ou de processus :

Utilisez l’ SPAWN actiondans le script d’appel.
Utilisez l’API POST /scripts/start . Il s’agit de la solution recommandée pour générer un script à partir d’un processus externe.

Les Unités d’exploitation peuvent exécuter un maximum de 15 000 scripts, sauf configuration contraire. Lorsque cette limite est atteinte, les scripts supplémentaires ne peuvent pas être démarrés ou générés à l'aide d'aucune des méthodes décrites sur cette page jusqu'à ce qu'un ou plusieurs scripts cessent de s'exécuter.

Paramètres de script

Les paramètres de script permettent de transmettre des données aux scripts. Ces données peuvent provenir d’autres scripts, dont les scripts système, ou de sources externes comme un CRM Systèmes tiers qui gèrent des éléments tels que les contacts, les informations sur les ventes, les détails de l'assistance et les historiques de cas. ou une API. Elles sont transmises aux scripts dans des variables pX, p1 à pN, où N correspond au nombre maximal de paramètres pris en charge par la méthode de génération. Vous pouvez spécifier les données à transmettre lorsque vous générez un script suivant l’une des possibilités répertoriées à la section précédente.

Si vous voulez modifier les noms des variables de paramètres, vous pouvez configurer l’action Begin avec les nouveaux noms dans le script généré. Lorsque le script traite l’action BEGIN, les variables pX sont converties avec les nouveaux noms. Si vous ne spécifiez pas de nouveaux noms, les variables conservent les noms pX.

Lorsque les données sont transmises dans un script, vous pouvez les afficher dans une trace. Sélectionnez l’action BEGIN pour afficher les variables de paramètres dans la liste des variables de sortie de la trace. Si vous avez configuré l’action BEGIN avec de nouveaux noms de variables, sélectionnez l’action qui vient après BEGIN dans la trace de script pour les afficher. Les variables de paramètre ne sont présentes que si elles ont une valeur.

Les paramètres personnalisés :

prennent en charge au maximum :
- 32 Ko par valeur lorsque la génération s’effectue avec l’action SPAWN ;
- 32 Ko au total pour l’ensemble des paramètres, barres verticales comprises, si la génération s’effectue par une API ;
prennent en charge la substitution de variables. Saisissez le nom de la variable entre accolades ( { } ).
Prise en charge de 1 à 20 paramètres lors de la génération par l'action SPAWN ou l'API.
ne prennent pas en charge les objets de données dynamiques. Les objets doivent être convertis en chaîne JSON au préalable.

Comparaison des actions Studio

Trois actions Studio lancent un nouveau script à partir du script actif. Elles présentent toutefois des différences :

Runscript: lorsque déclenche un autre script, il ne revient pas au premier script à partir du second.
Runsub : lorsque déclenche un sous-script, le script peut revenir au premier script, tant que le sous-script comporte une action . L'action fournit une valeur à l'action lorsque le sous-script est terminé.
SPAWN : lance un second script qui s’exécute en parallèle du premier script. Les scripts générés ne peuvent pas retransmettre de données au premier script, sauf si vous incluez une action dans le script généré.

Génération à partir d’un autre script avec l’action SPAWN

Si vous n’avez pas besoin de transmettre des valeurs de paramètres au script enfant, il vous suffit d’ajouter et de configurer l’action SPAWN au script parent. Si vous devez transmettre des paramètres, vous devez effectuer les configurations suivantes :

Effectuez les modifications suivantes dans le script parent :
- Placez l’action SPAWN à l’endroit où vous voulez générer le script enfant. Configurez la propriété Paramètres dans l’action SPAWN avec les valeurs que vous devez transmettre au script enfant. Les valeurs sont transmises dans des variables p1 à p9.
- Configurez les other properties de l’action SPAWN.
Effectuez les modifications suivantes dans le script enfant :
- Configurez la propriété Paramètres dans l’action afin de changer le nom des variables de paramètres personnalisés. Si vous ne faites rien, les valeurs de paramètres personnalisés restent dans les variables .
- Si vous devez retransmettre des valeurs au script parent ou à l’application appelante, ajoutez et configurez une actionaction.

Génération d’un script par API

Utilisez l’API POST /scripts/start Une icône représentant un carré avec une flèche pointant du centre vers le coin supérieur droit. pour générer un script.

Si vous utilisez cette API, il est important de noter les points suivants :

Les paramètres suivants sont requis :
- skillId : la valeur doit être un entier si l’envoi s’effectue en JSON, mais pas si vous utilisez des paramètres de requête. Les compétences doivent :
- scriptId ou scriptPath : il est recommandé d’utiliser scriptPath. L’ID du script change à chaque fois que vous enregistrez des modifications du script ; il doit donc être mis à jour dans le paramètre.
Vous pouvez inclure jusqu’à 20 paramètres.
Les paramètres doivent être envoyés sous forme de liste séparée par des barres verticales.
L’API prend en charge un maximum de 32 Ko pour tous les paramètres, barres verticales comprises.
Les paramètres ne peuvent pas inclure de barres verticales hormis comme séparateurs.
Si vous envoyez la demande au format JSON, les caractères réservés doivent être assortis de caractères d’échappement appropriés.
Si vous envoyez la demande par URL, les paramètres de la requête doivent être codés dans l’URL.