Utilisation d'expressions avec des variables

Les utilisateurs avancés qui connaissent le langage JavaScript peuvent utiliser des expressions pour effectuer des opérations de type chaîne de caractères, mathématiques ou autres opérations avancées sur des variables.

Syntaxe

La syntaxe valide à utiliser est la suivante :

<%Expression%>

L'expression entourée de <% et %> est évaluée par le moteur JavaScript. Il ne doit pas y avoir d'espace juste après le début <% ou juste avant la fin %>.

Voici des exemples de syntaxe valide :

Exemples

Vous pouvez utiliser des expressions dans les cas où une référence de variable est utilisée pour lire la valeur d'une variable. Les procédures suivantes donnent des exemples d'emplacements où vous pouvez les implémenter dans BarTender.

FerméDéfinir la valeur d'une variable globale personnalisée

  1. Cliquez sur l’onglet Administration .

  2. Cliquez sur Options.

  3. Sous Variables globales personnalisées, cliquez sur Ajouter une variable.

  4. Dans le champ Nom, saisissez un nom pour la variable personnalisée.

  5. Dans le champ Valeur, saisissez l'expression JavaScript souhaitée. Par exemple, saisissez l'expression suivante :

    <%UserName.substr(0, UserName.lastIndexOf('\\'))%>

FerméSpécifier le chemin d'accès d'un document à imprimer dans une action Imprimer un document

  1. Cliquez sur l’onglet Créer.

  2. Dans le volet Événements de la vue Créer, cliquez pour développer l'événement qui contient l'action Imprimer le document que vous souhaitez.

  3. Cliquez sur l'action Imprimer le document.

  4. Dans l'onglet Document, cliquez dans le champ Document.

  5. Saisissez l'expression JavaScript souhaitée. Par exemple, saisissez l'expression suivante : 

    <%DetectedFilePath.substr(0, DetectedFilePath.lastIndexOf('.')) + ".btw"%>

FerméDéfinir la valeur d'une variable dans une action Définir une variable

  1. Cliquez sur l’onglet Créer.

  2. Dans le volet Événements de la vue Créer, cliquez sur l'événement souhaité, puis ajoutez-y une action Définir variable.

  3. Dans l'onglet Définir une variable, sous Variable, cliquez dans le champ Valeur.

  4. Saisissez l'expression JavaScript souhaitée. Par exemple, saisissez l'expression suivante : 

    <%DetectedFilePath.substr(0, DetectedFilePath.lastIndexOf('.')) + ".btw"%>

FerméÉcrire un message qui contient une expression de variable dans une action Écrire le message dans le journal

  1. Cliquez sur l’onglet Créer.

  2. Dans le volet Événements de la vue Créer, cliquez sur l'événement souhaité, puis ajoutez-y une action Écrire le message dans le journal.

  3. Dans l'onglet Écrire le message, sous Message, cliquez dans le champ Variable.

  4. Saisissez l'expression JavaScript souhaitée. Par exemple, saisissez l'expression et le texte suivants : 

    Fichier '<%DetectedFilePath.substr(0, DetectedFilePath.lastIndexOf('.')) + ".btw"%>' dans %DetectedFileFolder% est en cours d'impression.

FerméDéfinir la propriété Action d'une action pour exécuter l'action de manière conditionnelle

  1. Cliquez sur l’onglet Créer.

  2. Dans le volet Événements de la vue Créer, cliquez sur l'événement souhaité.

  3. Ajoutez l'action que vous voulez.

  4. Dans l'onglet Action, cliquez sur Sous conditions, en fonction de la variable ou Sous conditions, en fonction de l'expression.

  5. Cliquez dans le champ variable auquel vous voulez ajouter l'expression JavaScript.

  6. Saisissez l'expression JavaScript souhaitée. Par exemple, saisissez l'expression suivante :

    <%new Date().getMonth() + 1)%>

FerméSpécifier l'action de cas à exécuter en fonction du résultat de l'évaluation d'une expression dans une action Sélectionner un cas

  1. Cliquez sur l’onglet Créer.

  2. Dans le volet Événements de la vue Créer, cliquez sur l'événement souhaité, puis ajoutez-y une action Sélectionner un cas.

  3. Dans l'onglet Sélectionner un cas, sous Cas, cliquez dans le champ Sélectionner un cas avec une variable.

  4. Saisissez l'expression JavaScript souhaitée. Par exemple, saisissez l'expression suivante :

    <%Number(Variable1) + 0,1 + 0,2 + 55 %>

FerméPour itérer sur les valeurs de début, de fin ou d'incrément qui sont spécifiées par des expressions dans une action Pour boucle

  1. Cliquez sur l’onglet Créer.

  2. Dans le volet Événements de la vue Créer, cliquez sur l'événement souhaité, puis ajoutez-y une action Pour boucle.

  3. Dans l'onglet Pour boucle, sous Options, cliquez dans le champ Nom de variable d'itération.

  4. Saisissez l'expression JavaScript souhaitée. Par exemple, saisissez l'expression suivante :

    <%RD_Documents.length - 1%>

Objets pouvant être utilisés dans des expressions

Types de résultats d'évaluation valables

Tous les objets JavaScript intégrés peuvent être utilisés dans l'expression, mais tous ne sont pas des résultats d'évaluation d'expression valides. Les types JavaScript suivants sont acceptés comme valides :