Les scripts

Utilisation des scripts sur Iterop

Introduction, JUEL, JavaScript

Introduction

Scripts simples

Les tâches de script sont des tâches automatiques qui permettent la réalisation de calculs internes à Iterop (par opposition aux tâches de services qui sont des tâches automatiques pour aller se connecter à des systèmes d’informations tiers). L’écriture des scripts dans Iterop se fait dans dans la configuration des tâches de scripts dans Iterop Design en cliquant sur “Editer le script”.

Introduction

Scripts simples

Certaines méthodes (JUEL, "Java Unified Expression Language") sont directement accessibles par clic droit sur la fenêtre d'écriture du script.

Toutes les méthodes sont décrites dans l'aide en ligne : Si vous ne disposez pas de compte, vous pouvez vous y inscrire en utilisant votre adresse danone

Introduction

Scripts simples

Il est possible d'avoir accès à l'aide du clic droit aux éléments suivants :

• Aux ID des variables du processus
• Aux méthodes JUEL (comme indiqué précédemment)
• Aux ID des tâches, listes et tables de dépendances.
• A des opérateurs (arithmétiques et logiques) ainsi qu'à des constantes.

Les méthodes JUEL permettent de :

Ecriture des scripts

Spécificités d'Iterop

• Iterop utilise un moteur JavaScript pour l’exécution des scripts. Ce moteur n’embarque que les bibliothèques natives JavaScript auxquelles ont été ajoutées des fonctions JUEL.
• Un commentaire s'écrit entre // ou /* */, tout le reste est exécuté
• Une ligne d'exécution se termine par ;
• Il permet de faire des boucles complexes (for, while, ...)

Bonnes pratiques - Manipulation d'une variable

Créer son premier script

Créer un nouveau processus pour tester un script

Dans Iterop design, le plus pratique pour tester un script est d'utiliser la structure suivante :

Cas d'utilisation très simple d'un script

Exemples utiles

Voici un processus très simple où l’on rentre le nombre d’articles que nous avons en stock ainsi que son prix unitaire. Le script aura pour but de calculer et enregistrer automatiquement la valeur marchande totale du stock afin de pouvoir, plus tard, l’afficher ou la traiter.

Cas d'utilisation très simple d'un script

Exemples utiles

Cas d'utilisation très simple d'un script

Exemples utiles

Cas d'utilisation très simple d'un script

Exemples utiles

On souhaite ici modifier l'identificateur du processus à partir de données renseignées dans le formulaire de démarrage. Le format demandé est de la forme : date - type de la commande - nom du fournissseur.

Le utils.formatDate est très utile : il permet en une seule ligne de code de récupérer la date actuelle au fomat voulu (ici yyyy MM dd mais on aurait pu en choisir un autre).

En lançant le processus avec NomDuFournisseur = Apple et TypeCommande = Matériel Informatique, on a maintenant l'identificateur suivant dans l'onglet suivi :

Eléments de syntaxe en JavaScript

If - Else

La syntaxe if/else s'écrit sous la forme suivante en JavaScript : if (condition) { // bloc de code qui sera éxecuté si la condition est réalisée } else { // bloc de code qui sera exécuté si la condition est fausse }

Exemple : if (heure < 18) { message = "Bonne journée"; } else { message = "Bonne soirée"; }

Eléments de syntaxe en JavaScript

Boucles for

Pour les boucles for, on trouve 3 éléments distincts : L'initialisation, la condition et le modificateur. for (initialisation; condition; modificateur) { // contenu réalisé à chaque passage dans la boucle }

Exemple : Calculons la somme des entiers de 1 à 4 (= 10 car 1+2+3+4 = 10) var i; var somme; for (i = 0; i < 5; i++) { somme += i ; } io.set("somme_des_entiers", somme);

Erreurs des scripts

Erreurs fréquentes

Dans le cas des boucles, attention à ne pas créer de boucles infinies ! Si c'est le cas une erreur est alors générée et pourra être consultée dans l'onglet "Erreurs" d'Iterop Play. On retrouve par exemple les messages d'erreur suivants :

• Timeout exeption : script execution exceeded time limit. Cause could be an infinite loop
• Memory exeption : Script execution exceed memory limit. Variables will not be recorded. Cause could be an infinite loop

Liens utiles

Documentation supplémentaire

Vous pouvez trouver des informations additionnelles sur l'utilisation des scripts grâce au lien suivant : https://doc.iterop.com/knowledge-base/generalites-sur-les-scripts-juel-et-javascript/#cas-dutilisation-tres-simple-dun-script Pour les fonctions JUEL : https://doc.iterop.com/knowledge-base/les-fonctions-iterop/#methodes-utilitaires-utils Pour l'utilisation de JavaScript : https://developer.mozilla.org/fr/docs/Web/JavaScript Formats de dates : https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/Date Manipulation de JSON : https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/JSON