Création de conditions pour des éléments de canevas

Utilisez l'éditeur de condition pour définir une expression JavaScript avec les attributs de données et les variables accessibles dans le contexte actuel.

Procédure

  1. Cliquez sur un élément à l'aide du bouton droit de la souris et sélectionnez Données > Editer une condition.
  2. Dans la fenêtre Définition de la condition pour l'élément en cours, développez Variables et Attributs.
  3. Entrez le code JavaScript à l'aide de l'une des options suivantes :
    • Ecrivez un script manuellement dans cette fenêtre
    • Copiez et collez un script à partir d'un éditeur externe dans cette fenêtre
    • Cliquez sur Inclure un script et sélectionnez un fichier sur votre ordinateur, sur un serveur distant ou dans le composant Gestion centralisée
    • A partir de l'éditeur de conditions :
      1. Sélectionnez un attribut ou une variable pour l'opérande de gauche.
        Remarque : Si vous utilisez les outils de la fenêtre Définition de la condition pour l'élément en cours, tous les attributs ou variables utilisés sont automatiquement sélectionnés dans l'arborescence. Si vous entrez la condition manuellement, vous devez sélectionner manuellement l'attribut de données ou la variable.
      2. Sélectionnez un Opérateur.
      3. Sélectionnez un attribut ou une variable pour l'opérande de droite dans les menus déroulants.
        Remarque : Si l'opérande de gauche et l'opérande de droite d'une condition proviennent du même nom d'attribut, mais appartiennent à deux requêtes différentes, la condition ne fonctionne pas. Vous devez définir des alias différents pour les deux attributs pour que la condition fonctionne.
      4. Cliquez sur Ajouter. La condition sélectionnée est ajoutée dans la zone de texte.
  4. Facultatif : Sélectionnez l'option Entrée XHTML pour permettre l'édition des balises XHTML contenues dans le script.
    Si vous copiez du texte enrichi ou que vous en utilisez dans des conditions, vous devez sélectionner l'option Entrée XHTML.
    Important : Echec des générations de documents en raison d'un XHTML non valide. Vérifiez que votre XHTML est valide avant de sauvegarder vos modifications.
  5. Facultatif : Cliquez sur Tester et Exécuter pour tester la condition avant de l'appliquer à l'élément en cours. Si le script est correctement exécuté, la valeurtrue est affichée. Si le script n'est pas correctement exécuté, la valeurfalse est affichée.
  6. Cliquez sur OK.

Résultats

Lorsque vous appliquez une condition à un élément, cet élément affiche une icône icône Condition dans l'éditeur de contenu de canevas :

icône Condition sur un élément Paragraphe

Exemples : Construction de conditions à l'aide de l'éditeur de conditions

Examinez ces exemples pour vous aider à construire vos propres conditions à l'aide de l'éditeur de conditions.

Objets ayant des en-têtes d'objet dans un schéma Rational DOORS :
  • Développez Attributs > requête.
  • Sélectionnez [En-tête d'objet] Object_Heading.
  • Pour l'opérande de gauche, sélectionnez [En-tête d'objet] Object_Heading.
  • Pour l'opérateur, sélectionnez Différent de.
  • Pour l'opérande de droite, n'entrez pas de valeur.
  • Cliquez sur Ajouter. Le JavaScript s'affiche comme suit : Object_Heading != "".
Exigences à priorité élevée dans un schéma REST :
  1. Développez Attributs > requête.
  2. Sélectionnez Priorité.
  3. Pour l'opérande de gauche, sélectionnez Priorité.
  4. Pour l'opérateur, sélectionnez Est égal à.
  5. Pour l'opérande de droite, entrez High.
  6. Cliquez sur Ajouter. Le JavaScript s'affiche comme suit : Priorité == "High".

Que faire ensuite

Si le résultat d'une variable n'est pas correct, regardez si la variable est une chaîne littérale true ou false, par exemple variable == "true".

Dans certains cas, la valeur d'une variable a pour résultat une valeur booléenne plutôt qu'une valeur de chaîne littérale. Exemple : variable == "true" prend la valeur incorrecte false si la variable correspond à la valeur booléenne true et non à la chaîne "true". Le mot true est introuvable dans les données en tant que valeur. Ce problème se produit lorsqu'une variable provient d'un calcul et non d'une spécification de document (variable définie lors de la configuration du rapport) ou d'un canevas (valeur par défaut de la variable).

Pour vous assurer que le résultat de la variable est correct, examinez vos conditions à l'aide de l'une de ces options :
  • Option 1 : Activez vos conditions pour gérer la chaîne littérale et la valeur booléenne.

    (variable == true_ou_false_booléen) || ( variable == "chaîne")

    Exemple : (variable == true) || ( variable == "true")

  • Option 2 : Si vous connaissez à l'avance le résultat de la variable (valeur littérale ou valeur de chaîne), vous pouvez anticiper la conception de la condition en fonction du type de valeur.
    • Valeur booléenne : variable == true_ou_false_booléen

      Exemple : variable == true

    • Valeur de chaîne : variable == "chaîne"

      Exemple : variable == "true"

Utilisation de la fonction Alias pour les attributs de même nom

Avant de commencer

Editez les préférences de Document Studio :
  1. Dans Rational Publishing Engine Document Studio, cliquez sur Fenêtre > Préférences.
  2. Développez RPE et cliquez sur Conception du document.
  3. Dans la zone Utiliser les annotations de schéma pour affichage, sélectionnez Non et cliquez sur OK.

Procédure

Pour distinguer les attributs portant le même nom, vous pouvez utiliser la fonction Alias afin d'éliminer les ambiguïtés. Lorsque vous ajoutez la condition qui vérifie que la description du module correspond à celle de DOORSObject, cliquez avec le bouton droit de la souris sur l'attribut pour définir l'alias.

Résultats

L'attribut Module/Object/Object Text est maintenant connu sous le nom $1_Object Text et la condition peut être traitée correctement.

Que faire ensuite

Conseil : Pour examiner la manière dont la condition est appliquée aux données, cliquez sur Tester. Dans la fenêtre Tester, cliquez sur Exécuter.

Commentaires