Expression
Les fonctions Expression sont des widgets non visuels que vous pouvez utiliser pour évaluer une expression JavaScript. Vous pouvez écrire des expressions JavaScript pour valider, calculer, convertir et comparer des données dans votre application composite.
Utilisez l'option de paramètre pour créer de nouveaux paramètres pour la fonction. Vous pouvez définir le type de données et la valeur par défaut de chaque paramètre. Les paramètres sont utilisés par la fonction pour stocker les valeurs des données. Vous pouvez créer des paramètres pour lier les données de sources telles que les champs de propriétés et les services de données dans l'application composite. Tous les paramètres sont répertoriés en tant que propriétés pouvant être liées dans la section Paramètres de la fonction.
Vous pouvez sélectionner le type de données de sortie pour les paramètres à l'aide de l'option Type de base de sortie. Les expressions de comparaison de données renvoient une sortie de type BOOLEAN. Les calculs ou les manipulations de chaînes renvoient un type de données NUMBER ou STRING. Assurez-vous que le widget cible de la propriété Output prend en charge le type de base de sortie.
Le champ Expression vous permet de définir le code JavaScript. Vous pouvez définir des expressions arithmétiques, de comparaison et régulières.
Expressions arithmétiques
• Expressions simples : utilisation d'opérateurs simples pour effectuer des additions, soustractions, multiplications et divisions. Par exemple :
(Parameter1 + Parameter2) / Parameter3 renvoie la somme de Paramètre1 et de Paramètre2, divisée par Paramètre3.
• Expressions complexes : utilisation de fonctions pour effectuer des calculs, notamment des exposants, des racines carrées et des logarithmes naturels.
Math.pow(Parameter1, Parameter2) renvoie Paramètre1 élevé à la puissance de Paramètre2.
Expressions de comparaison
Vous pouvez utiliser tous les opérateurs de comparaison JavaScript pour comparer des données de paramètres d'entrée.
Expressions régulières
La fonction Expression prend en charge la notation JavaScript pour les expressions régulières. Vous pouvez utiliser des expressions régulières pour valider et filtrer les données d'entrée à l'aide de la syntaxe suivante.
• /<expression>/.test(<parameter>)
◦ <expression> : expression régulière à évaluer.
◦ test() : méthode qui compare le paramètre de données spécifié à l'expression.
◦ <parameter> : nom du paramètre avec les données à évaluer.
• /^(?:\d{3}\-){2}\d{4}$/.test(phoneNumber)
◦ ^ : début de la chaîne.
◦ (?:\d{3}\-){2} : correspond à trois chiffres suivis d'un tiret et se répète deux fois (###-###-).
◦ \d{4} : correspond à un chiffre unique et se répète quatre fois (####).
◦ $ : fin de la chaîne.
Journalisation des exceptions JavaScript
Les exceptions se produisent lorsque votre expression JavaScript renvoie une erreur. Vous pouvez consigner des exceptions à l'aide de la méthode TW.log.error. Dans l'exemple suivant, une exception se produit, car la fonction n'est pas définie :
try {
undefinedFunction();
}
catch (e){
TW.log.error("The function does not exist: " + e);
}
undefinedFunction();
}
catch (e){
TW.log.error("The function does not exist: " + e);
}
 |
Les erreurs sont consignées au moment de l'exécution. Cliquez sur Afficher/masquer le journal dans la barre d'outils supérieure pour afficher ou masquer les journaux du Mashup Builder.
|
Options de la fonction Expression
Vous pouvez définir les options de configuration suivantes :
• Description : définit une description de la fonction.
• Paramètres : spécifie les paramètres personnalisés de la fonction.
• Expression : expression JavaScript à évaluer.
• Evaluation automatique : évalue automatiquement les expressions lorsque les données des paramètres d'entrée sont modifiées.
• Déclencher à première valeur : évalue l'expression JavaScript lorsque la première valeur est transmise. L'expression n'est pas évaluée lors de la transmission d'une deuxième valeur.
• Type de modification des données : contrôle le déclenchement de l'événement de modification.
• Type de base de sortie : type de données de la sortie de l'expression.
• Désactiver la sortie initiale : empêche la fonction d'affecter une valeur initiale non définie à la propriété Output avant que l'expression n'ait été évaluée.
Création d'une fonction Expression
1. Dans le panneau Fonctions, cliquez sur 
. La boîte de dialogue Nouvelle fonction s'ouvre.
. La boîte de dialogue Nouvelle fonction s'ouvre.2. Sélectionnez Expression dans la liste déroulante.
3. Donnez un nom à votre fonction, puis cliquez sur Suivant.
4. Sous Expression, spécifiez une expression JavaScript à évaluer.
5. Ajoutez des paramètres d'entrée de données :
a. Cliquez sur Ajouter un paramètre.
b. Spécifiez un nom de paramètre.
c. Spécifiez une valeur par défaut et une info-bulle, puis sélectionnez un type de base pour le paramètre.
6. Sélectionnez un type de données dans la liste déroulante Type de base de sortie.
7. Cliquez sur Terminé.
La fonction est ajoutée au panneau Fonctions sous la catégorie Expressions.
Propriétés
La fonction Expression contient les propriétés suivantes :
Propriété | Description | Type de base | Valeur par défaut | Liaison possible ? (O/N) | Localisable ? (O/N) |
|---|---|---|---|---|---|
Evaluate | Service pouvant être lié qui évalue l'expression. | n/a | n/a | O | N |
Changed | Propriété pouvant être liée qui déclenche un événement lorsque les données sont modifiées. | n/a | n/a | O | N |
Output | Sortie de l'expression évaluée. Vous pouvez définir la liaison de cette propriété directement dans le champ Expression. Pour définir une liaison, saisissez output=<> . Pour empêcher cette propriété d'envoyer une valeur initiale non définie, cochez la case Désactiver la sortie initiale. | n/a | n/a | O | N |