Ajout d'un codet JavaScript

Utilisez un codet JavaScript pour chaque bloc de code que vous utilisez dans un canevas.
Restriction : icône Nouvelle fonction L'élément Code JavaScript n'est disponible que dans les canevas version 2.

Pourquoi et quand exécuter cette tâche

JavaScript peut être composé d'arguments simples ou de scripts complexes.
  • Pour les arguments simples, vous pouvez appliquer le script au contenu d'un élément, tel qu'un élément Texte. Cliquez deux fois sur l'élément de texte, sélectionnez l'onglet Expression de script et entrez un script.
  • Pour les scripts complexes, vous pouvez utiliser cette tâche pour appliquer votre script à l'aide du codet JavaScript.
Il est intéressant d'utiliser le codet JavaScript au lieu de l'onglet Expression de script d'un élément :
  • Vous pouvez réutiliser les scripts des autres utilisateurs.
  • Vous pouvez regrouper les calculs sans vous soucier de leur ordre d'exécution.
  • Vous pouvez créer des structures de données normales et complexes, telles que des collections, et les alimenter en permanence.
    Remarque : Vous ne pouvez pas appeler la fonction définie dans un codet JavaScript dans un autre codet ou élément de texte JavaScript.

Le fichier JavaScript utils.js est inclus dans vos fichiers d'installation et dans les fichiers prédéfinis du composant Gestion centralisée pour que vous puissiez l'utiliser pour du JavaScript simple, par exemple, pour inclure la date du jour dans une sortie de rapport.

Pour afficher une liste des codes JavaScript existants dans votre canevas, cliquez sur Canevas > Réviser les scripts Java. La vue Recherche s'ouvre et une liste des éléments qui utilisent JavaScript s'affiche. Les filtres natifs ne sont pas considérés comme du JavaScript dans ce contexte. Ils ne sont pas répertoriés dans les résultats de la recherche.

Procédure

  1. Sauvegardez votre canevas avant de commencer à utiliser JavaScript.
  2. Dans la vue Palette, sélectionnez l'élément Code JavaScript icône Code JavaScript et faites-le glisser dans l'éditeur de contenu de canevas.
  3. Cliquez deux fois sur le codet JavaScript.
  4. Dans l'onglet Expression de script, sélectionnez une variable dans l'arborescence pour lui appliquer le code JavaScript.
  5. 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
  6. Facultatif : Si vous avez copié le script à partir de XHTML, vous pouvez :
    • Sélectionnez l'option Entrée XHTML pour permettre l'édition des balises XHTML contenues dans le script.
    • Désélectionnez l'option Entrée XHTML pour supprimer toutes les balises XHTML du 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.
  7. Facultatif : Si vous générez le canevas dans une sortie XHTML, vous pouvez :
    • Sélectionner l'option Sortie XHTML pour analyser le script et l'afficher comme texte enrichi.
    • Désélectionner l'option Sortie XHTML pour traiter le script comme du texte en clair.
    Cette sélection s'applique à tous les attributs de source de données de l'expression. Vous ne pouvez pas combiner du texte en clair et du XHTML dans votre script.

    Si vous copiez du texte enrichi ou que vous en créez sur une base ad hoc, vous devez sélectionner l'option Sortie XHTML.

  8. Une fois que vous avez entré le script, cliquez sur Tester le script pour valider le code. Si votre code JavaScript contient des erreurs, la génération de documents risque de ne pas se terminer correctement.
  9. Cliquez sur OK pour sauvegarder les modifications. Le bloc de code est réduit dans l'élément. Vous pouvez le développer pour l'afficher dans l'éditeur de contenu de canevas.

Utilisation de l'éditeur JavaScript

Utilisez l'éditeur JavaScript pour travailler sur votre script avec un formatage en couleurs et la numérotation des lignes.

Procédure

  1. Cliquez deux fois sur le codet JavaScript. La fenêtre Code d'entrée pour l'élément de code JavaScript s'ouvre.
  2. Facultatif : Si vous souhaitez inclure un nouveau script à partir d'un autre fichier, cliquez sur Inclure un script et sélectionnez un fichier sur votre ordinateur, sur un serveur distant ou dans le composant Gestion centralisée. Cliquez sur OK pour fermer la fenêtre et cliquez deux fois sur l'élément pour ouvrir à nouveau la fenêtre Code d'entrée pour l'élément de code JavaScript.
  3. Cliquez sur Ouvrir dans l'éditeur pour entrer le script dans un éditeur Eclipse JavaScript. Le script s'ouvre dans un nouvel onglet de l'éditeur sous la forme d'un fichier .js temporaire et vous pouvez éditer le JavaScript.
  4. Gérez le script via les options de la vue Structure.
  5. Sauvegardez les modifications.
  6. Fermez l'onglet de l'éditeur JavaScript temporaire. Vous retournez à la fenêtre Code d'entrée pour l'élément de code JavaScript.
  7. Cliquez sur Tester le script pour valider le code.
  8. Cliquez sur OK pour sauvegarder les modifications et fermer la fenêtre.

Commentaires