Editeur JSONata

Avec l'éditeur JSONata, définissez les propriétés de service des flows. Si vous créez un service, celui-ci aura certainement besoin de données avec lesquelles il exécutera l'action correspondante.

Exemple

Un exemple est l'ID d'objet d'un objet ELO. Celui-ci est utilisé entre autre dans le service Ecrire un article du composant du fil d'actualité ELO :

Le service doit savoir pour quel objet une entrée du fil d'actualité doit être écrite. La communication avec l'objet se fait via l'ID d'objet que vous pouvez enregistrer ou déterminer de manière dynamique.

Pour un accès aux données dynamique avec transformation des données, ELO Flows utilise la langue JSONata.

Vous avez les possibilités de configuration suivantes :

1 Entrer une valeur : champ d'entrée pour des valeurs fixes en tant que string ou valeurs dynamiques en tant qu'expression JSONata

2 Sélectionner le mode de saisie : par défaut, le champ de saisie est au format texte. Le mode texte travaille avec des valeurs string que vous pouvez sélectionner dans des données enregistrées (4). Le mode expert (symbole J) permet d'entrer des commandes JSONata.

3 Ouvrez l'éditeur : ouvrez l'éditeur avec les symboles de la flèche en tant que dialogue distinct pour utiliser une section de saisie agrandie.

4 JUtiliser les contenus pré-configurés : effectuez une sélection entre Données, Données spécifiques au type, Propositions, Traductions et Fonctions.

Information

Vous trouverez d'autres informations au sujet de la structure et des différentes possibilités avec JSON sous jsonata.org (opens new window)

Affichage de détails 'Données'

Dans l'étape Données, vous sont affichées les informations des noeuds précédents. Les données sont sous-structurées selon les noeuds correspondants, par exemple trigger, step0, step1.

Affichage de détails 'Données relatives au type'

Dans l'étape Données relatives au type, vous pouvez accéder à une présélection de données qui correspondent au type de champ pour lequel vous créez l'expression JSONata. Par exemple, pour le champ d'entrée ID d'objet les données trigger.guid, trigger.name, trigger.user.name ou step0.owner.name sont à votre disposition.

Affichage de détails 'Propositions'

Sélectionnez les entrées dans la liste des propositions.

Information

Pour que la liste de propositions soit remplie, ses entrées doivent avoir été enregistrées comme lookups lors du développement des composants.

Comme la liste des propositions n'est pas obligatoire pour le développement de composants, il se peut que des propositions ne soient pas toujours enregistrées.

Affichage de détails 'Traductions'

Sélectionnez les variables déposées dans le package, pour les intégrer dans votre expression JSONata.

Affichage de détails 'Fonctions'

Dans l'onglet Fonctions, vous pouvez rechercher des fonctions JSONata préconfigurées, les sélectionner et les intégrer dans votre commande JSONata.

En plus des fonctions standards de JSONata, les fonctions suivantes sont disponibles pour ELO Flows :

Fonction	Signature	Exemple d'utilisation	Documentation du code
$translate()	$translate(key [, fallback])	La fonction $translate permet par exemple d'ajuster les titres des tableaux dans les listes de mots-clés dynamiques, selon la langue du client.	Translates the given key. If not specified otherwise the used language is determined at runtime and depends on the user context of the execution. If the given key does not exist and the fallback value is used. Alternatively to the fallback value an object can be declared to always translate into a specific language by adding a ISO 639 alpha-2 or alpha-3 language code to the lang property. If the key does not exist the value of the fallback property is used.
$actionResult()	$actionResult(stepkey)	la fonction $actionResult vous permet de mettre à disposition le résultat d'un noeud de service déjà parcouru et de le mettre à disposition dans un noeud suivant pour un traitement ultérieur. Cette fonction vous permet de vérifier un téléchargement précédent, par exemple dans un noeud de condition, et en cas d'erreur, de l'envoyer dans un mail via la condition Else avec le message d'erreur.	Returns execution details of an action corresponding to the used step key. If no result matching the step key was found, the return value will be null. The action result provides the fields: statusCode; message; success; info