Les fonctions avancées

<aside>

Sommaire

Dans cette page

<aside> 🧩

Cette page présente les fonctions avancées de Visiativ Process : utiliser l’Éditeur de script, définir des comportements personnalisés et générer les classes Java d’une application.

</aside>

Avant de commencer

Réservez ces fonctions aux personnes qui maîtrisent la conception avancée et le développement.
Identifiez l’élément à personnaliser : vue, notification, version de processus, document, réservoir de données ou ressource.
Préparez le code XML, JavaScript ou Java adapté au contexte.
Pour les développements spécifiques et les détails d’implémentation, consultez la documentation SDK.

<aside> ⚠️

Testez toujours les abonnements, scripts et extensions dans un environnement maîtrisé avant de les utiliser en production. Un comportement personnalisé peut modifier l’exécution d’un processus ou le cycle de vie d’un document.

</aside>

Utiliser l’Éditeur de script

L’Éditeur de script permet de saisir du code XML ou JavaScript lors de la configuration de certains éléments, notamment les vues, les notifications et les versions de processus.

L’encart principal accueille le code. La colorisation syntaxique facilite sa lecture et permet de distinguer plus rapidement les différents éléments du script.

Interface de l’Éditeur de script et exemple de code JavaScript

Utiliser les commandes de l’éditeur

Commande	Utilisation
Rechercher	Rechercher du texte dans le code.
Remplacer	Remplacer un mot ou une expression par une autre valeur.
Afficher la ligne courante	Afficher le numéro de la ligne sur laquelle se trouve le curseur.
Aller à la ligne	Déplacer directement le curseur vers une ligne donnée.
Indenter	Ajouter des tabulations et des espaces pour structurer le code.

Repérage des commandes disponibles dans l’Éditeur de script

<aside> 💡

Utilisez l’indentation et la recherche pour relire plus facilement un script long. Avant d’enregistrer, vérifiez également que le format du code correspond au type attendu par l’élément configuré.

</aside>

Configurer des abonnements inter-champs

Les abonnements de modèles de ressources permettent de définir, au format XML, le comportement de certains champs de processus ou de réservoirs de données.

Ils sont utiles lorsqu’un champ doit réagir à une modification ou interagir avec un autre champ selon des règles spécifiques.

Bonnes pratiques

Identifiez les champs concernés et le comportement attendu.
Rédigez les instructions XML dans l’éditeur prévu à cet effet.
Vérifiez que les champs et ressources référencés existent.
Testez plusieurs valeurs d’entrée, y compris les valeurs vides ou inattendues.
Contrôlez le résultat dans tous les formulaires et processus qui utilisent la ressource.

<aside> 📘

La syntaxe détaillée des abonnements inter-champs est décrite dans la documentation SDK.

</aside>

Définir des scripts

Les scripts permettent d’ajouter des comportements à différents moments de l’exécution d’un processus ou du cycle de vie d’un document.

Type de script	Déclenchement et usage
Script de routage	Définit les comportements déclenchés par des événements liés au processus.
Script du document	Définit les comportements déclenchés par les événements du cycle de vie du document.
Script de table	Définit les comportements exécutés lors d’événements associés à une table d’un réservoir de données.

Préparer un script

Déterminez l’événement qui doit déclencher le comportement.
Choisissez le type de script correspondant au contexte.
Limitez le traitement au besoin fonctionnel attendu.
Prévoyez le comportement en cas de valeur absente ou d’erreur.
Testez le script avec plusieurs scénarios avant sa mise en production.

<aside> 💡

Évitez de placer le même traitement dans plusieurs scripts susceptibles de se déclencher au cours d’une seule action utilisateur.

</aside>

Utiliser des classes d’extensions

Les classes d’extensions Java permettent aux personnes chargées de l’intégration ou de la conception avancée de développer des comportements spécifiques.

Elles peuvent être appelées à partir d’événements déclenchés par des actions utilisateur sur :

le document, par exemple lors des actions Enregistrer ou Fermer ;
les vues ;
les abonnements ;
les notifications.

<aside> ⚠️

Le développement et le déploiement d’une classe d’extension nécessitent des compétences Java et une connaissance du SDK Visiativ Process.

</aside>

Générer les classes d’une application

Visiativ Process peut générer automatiquement, depuis le Studio, les interfaces et les classes qui décrivent les modèles de ressources de l’application.

Ressources prises en charge

Vous pouvez définir des alias pour :

les groupes de processus et les processus ;
les réservoirs de données et les tables de données ;
les champs ;
les colonnes de tableaux dynamiques et de tables de données ;
les attributs étendus.

Préparer la génération

Définissez un alias pour chaque ressource à exposer dans les classes générées.
Ouvrez les propriétés de l’application.
Dans l’onglet Développement, renseignez le nom du package Java.
Enregistrez la configuration de l’application.

<aside> ⚠️

</aside>

Télécharger les classes générées

Depuis la page d’accueil du Studio, cliquez sur l’icône de configuration située en haut à gauche.
Sélectionnez Génération de classes.
Dans Choix des classes à générer, sélectionnez les classes de base, les classes personnalisables ou les deux catégories.
Cliquez sur Télécharger.
Enregistrez le fichier ZIP généré sur votre machine.

Le fichier téléchargé peut ensuite être utilisé comme base du développement Java. Pour la structure des classes et leur mise en œuvre, reportez-vous à la documentation SDK.

Vérifier la configuration

Avant de terminer :

Vérifiez que le langage et le format du code correspondent à l’élément configuré.
Contrôlez les noms des ressources, champs, alias et packages.
Testez les événements qui déclenchent les scripts ou extensions.
Vérifiez le comportement avec des données valides, vides et incorrectes.
Contrôlez les journaux en cas d’erreur.
Documentez les personnalisations afin de faciliter leur maintenance.

<aside> ✅

</aside>