Écrire des scripts de rapport

Écrivez un script de rapport. Les utilisateurs autorisés sur ce locataire peuvent exécuter tous les scripts.

Si vous souhaitez adapter un script par défaut d'ARIS, vous devez en principe procéder à vos modifications sur des copies. Les scripts par défaut et les fichiers JS sont écrasés à chaque mise à jour des programmes. Les modifications effectuées sur des fichiers originaux sont alors perdues.

Condition préalable

Procédure

  1. Dans ARIS Architect, cliquez sur ARIS > Afficher l'administration Administration.

  2. Dans l'affichage des barres, cliquez sur Navigation Navigation si la barre Navigation n'est pas encore activée.

  3. Dans l'arborescence de l'Explorateur, double-cliquez sur le dossier Évaluations Évaluations.

  4. Double-cliquez sur le dossier Rapports. Les catégories de rapport sont affichées.

  5. Cliquez avec le bouton droit de la souris sur la catégorie à laquelle vous souhaitez affecter le script de rapport ou créez une nouvelle catégorie.

  6. Cliquez sur Nouveau > RapportRapport. L'assistant de script s'affiche.

  7. Saisissez les informations dans les langues souhaitées. Les entrées pour lesquelles une table de chaînes est gérée dans le script doivent impérativement être gérées dans toutes les langues. Les entrées les plus importantes sont : Nom et Description. Vous pouvez déterminer les paramètres de sécurité pour éviter les modifications non autorisées du script ou restreindre l'exécution.

  8. Désactivez, si nécessaire, la case Disponible pour les utilisateurs si vous avez p. ex. créé un rapport sans toutefois avoir programmé complètement le script. Les scripts peuvent continuer à être traités avec l'assistant de script. Cliquez sur Suivant.

  9. Définissez les éléments de base de données pour lesquels le script peut être lancé et cliquez sur Suivant.

  10. Le cas échéant, sélectionnez un filtre d'évaluation. Seuls sont pris en compte les contenus de méthodes qui sont activés aussi bien dans le filtre de méthode avec lequel vous vous êtes connecté à la base de données, que dans le filtre d'évaluation sélectionné.

  11. Activez la case Générer fichier de sortie, l'option Entrer texte source (mode code) et activez, dans le champ Formats de sortie pris en charge, les formats de fichier que les utilisateurs peuvent sélectionner pour la sortie lors de l'exécution du rapport.

  12. Configurez si nécessaire les autres paramètres puis cliquez sur Terminer. L'éditeur de script s'affiche.

  13. Écrivez le script dans l'éditeur de script. Pour la modification, veuillez utiliser les commandes des barres de fonctions Départ et Débogage.

    Utilisez exclusivement les méthodes du modèle d'objets pour les rapports et contrôles sémantiques. Vous pouvez à tout moment ajuster le code de script et offrir, par exemple, des pages d'aide personnalisées. Si vous ne souhaitez pas créer entièrement un script, il vous suffit d'adapter la copie d'un script existant en fonction de vos besoins. Vous pouvez obtenir des informations sur les commandes Script ARIS en plaçant le pointeur de la souris sur une commande, dans le code de script, et en appuyant sur la touche F1.

    ARIS est fourni avec de nombreux scripts standard. Nous recommandons généralement de documenter de façon externe tous les changements aux scripts afin que la documentation puisse être utilisée pour s'assurer que les changements sont incorporés correctement pendant le processus de mise à jour.

    Rapports/Macros/Modèles de rapport et fichiers

    Ne faites pas de changements aux scripts standard que nous fournissons. Adaptez toujours des copies de rapport, de macro et de fichiers JS, ainsi que de tout autre fichier. Il y a des exceptions, par exemple le fichier atsall<code de langue>.js.

    Lors de la mise à jour de ARIS, tous les scripts ARIS standard et les fichiers sont écrasés et les modifications personnalisées apportées à ces fichiers sont rejetées. Les scripts et fichiers copiés et ceux que vous avez créés vous-même ne sont pas écrasés.

    Si vous avez changé des fichiers fournis par nous sans faire de copie, ils doivent être exportés avant la mise à jour (updatesystemdb) puis importés après la mise à jour. Cela vous permet de conserver vos scripts standard adaptés d'une version précédente. Toutefois, dans ce cas, vous ne recevez pas de corrections ou de mises à jour aux fichiers que nous avons fournis.

    Contrôles sémantiques

    Nous recommandons de créer des types de règles et des profils personnalisés pour les contrôles sémantiques, dans lesquels les règles et les types de règles standard ARIS sont référencés.

    Ça n'est pas possible pour les types de règles configurables (règles d'attributs de relations, règles d'attributs de modèles, règles d'attribut d'objet, règles d'existence et règles d'affectation). Si vous avez ajouté des règles à ces types de règles, vous devez exporter les types de règles avant la mise à jour et les importer après la mise à jour.

  14. Dans la barre de menus, cliquez sur Débogage > Vérifier syntaxe. Si des erreurs de syntaxe ont été trouvées dans le script, vous pouvez les corriger simplement à l'aide de la liste affichée.

  15. Contrôlez le script préalablement à son autorisation. Activez la barre de fonctions Débogage puis cliquez sur le bouton de commande Exécuter Exécuter (F9).

Le script a été créé. Si vous l'avez mis à la disposition des utilisateurs, tous les utilisateurs peuvent le sélectionner dans l'assistant de rapport sur ce locataire.

Si vous avez besoin de scripts d'évaluation supplémentaires, vous pouvez créer une sortie du rapport en mode brouillon. Si vous maîtrisez les langages de programmation JavaScript et Script ARIS vous pouvez écrire vos propres scripts de rapport ou adapter des copies de scripts existants.

ARIS est fourni avec de nombreux scripts standard. Nous recommandons généralement de documenter de façon externe tous les changements aux scripts afin que la documentation puisse être utilisée pour s'assurer que les changements sont incorporés correctement pendant le processus de mise à jour.

Rapports/Macros/Modèles de rapport et fichiers

Ne faites pas de changements aux scripts standard que nous fournissons. Adaptez toujours des copies de rapport, de macro et de fichiers JS, ainsi que de tout autre fichier. Il y a des exceptions, par exemple le fichier atsall<code de langue>.js.

Lors de la mise à jour de ARIS, tous les scripts ARIS standard et les fichiers sont écrasés et les modifications personnalisées apportées à ces fichiers sont rejetées. Les scripts et fichiers copiés et ceux que vous avez créés vous-même ne sont pas écrasés.

Si vous avez changé des fichiers fournis par nous sans faire de copie, ils doivent être exportés avant la mise à jour (updatesystemdb) puis importés après la mise à jour. Cela vous permet de conserver vos scripts standard adaptés d'une version précédente. Toutefois, dans ce cas, vous ne recevez pas de corrections ou de mises à jour aux fichiers que nous avons fournis.

Contrôles sémantiques

Nous recommandons de créer des types de règles et des profils personnalisés pour les contrôles sémantiques, dans lesquels les règles et les types de règles standard ARIS sont référencés.

Ça n'est pas possible pour les types de règles configurables (règles d'attributs de relations, règles d'attributs de modèles, règles d'attribut d'objet, règles d'existence et règles d'affectation). Si vous avez ajouté des règles à ces types de règles, vous devez exporter les types de règles avant la mise à jour et les importer après la mise à jour.

Si vous mettez à disposition des scripts de rapport pour ARIS Publisher, tenez compte du fait que les rapports évaluent exclusivement les contextes Base de données, Groupe, Modèle ou Objet, n'appellent aucun dialogue, n'accèdent aux éléments qu'en mode lecture et qu'ils ne sont utilisés que pour les méthodes autorisées par ARIS Publisher.

Voir aussi

Définition d'un rapport ARIS

Créer macro