<aside>
Sommaire
Dans cette page
<aside>
📋
Cette page explique comment créer et gérer les listes utilisées dans les processus et les réservoirs de données : valeurs statiques, données Visiativ Process, bases de données externes et listes du serveur.
</aside>
Avant de commencer
- Ouvrez dans le Studio le groupe de processus ou le réservoir de données à configurer.
- Accédez à la vue Listes.
- Vérifiez que vous disposez des droits nécessaires pour modifier la conception.
- Pour une liste externe ou une liste du serveur, vérifiez que la source a été configurée par une personne disposant des droits d’administration.
Comprendre les listes
Les listes permettent de proposer des valeurs prédéfinies dans les champs de vos processus ou dans les colonnes de vos réservoirs de données. Elles facilitent la saisie, homogénéisent les données et limitent les erreurs.
Où une liste peut-elle être utilisée ?
- Dans un groupe de processus : la liste est disponible pour tous les processus du groupe. Elle peut être associée à un champ de type Texte ou Réservoir de données.
- Dans un réservoir de données : la liste est disponible pour toutes les tables du réservoir. Elle peut être associée à une colonne de type Texte ou Réservoir de données.
Une même liste peut être réutilisée dans plusieurs champs ou colonnes.
Choisir la source des valeurs
| Source |
À utiliser lorsque… |
| Valeurs statiques |
Les choix sont connus, peu nombreux et rarement modifiés. |
| Réservoir de données |
Les choix proviennent d’une table gérée dans Visiativ Process. |
| Base de données externe |
Les choix doivent être récupérés par une requête SQL. |
| Liste du serveur |
Une liste commune a déjà été configurée sur le serveur. |
Gérer les listes de valeurs statiques
Créer une liste
Utilisez ce type de liste pour des valeurs stables, par exemple des types d’absence, des catégories ou des niveaux de priorité.
- Depuis la vue Listes, cliquez sur Créer.
- Renseignez le Libellé de la liste.
- Ajoutez une Description si nécessaire afin d’expliquer son usage.
- Dans Alimentation de la liste, sélectionnez Valeurs statiques.
- Renseignez éventuellement le Nom système.
- Cliquez sur Suivant.
Sélection de l’alimentation par valeurs statiques
- Saisissez les valeurs, à raison d’une valeur par ligne.
- Si vous souhaitez dissocier la valeur technique du libellé affiché, utilisez le format
clé=valeur.
paid=Congés payés
off=Journée d’absence
sick=Congé maladie
other=Congé autre
except=Absence exceptionnelle
<aside>
ℹ️
Si aucune clé n’est indiquée, la valeur saisie est utilisée comme clé.
</aside>
Saisie des valeurs de la liste
- Cliquez sur Suivant, puis sur Terminer lorsque le message de confirmation s’affiche.
Confirmation de la création de la liste
Modifier les informations d’une liste
- Depuis la vue Listes, ouvrez le menu de la liste concernée.
- Cliquez sur Propriétés.
- Modifiez le Libellé ou la Description.
- Cliquez sur Enregistrer et fermer.
Modification des propriétés d’une liste
Gérer les listes issues d’un réservoir de données
Créer une liste
Utilisez cette option lorsque les valeurs existent déjà dans une table de Visiativ Process.
- Depuis la vue Listes, cliquez sur Créer.
- Renseignez le Libellé et, si besoin, une Description.
- Dans Alimentation de la liste, sélectionnez Valeurs issues du réservoir de données.
- Renseignez éventuellement le Nom système, puis cliquez sur Suivant.
- Sélectionnez la Table qui contient les valeurs.
- Sélectionnez la colonne à afficher dans la liste. Sans sélection, la colonne Titre est utilisée par défaut.
- Ajoutez si nécessaire une ou plusieurs Conditions d’affichage.
<aside>
💡
Les conditions d’affichage permettent notamment de créer des listes en cascade : les choix proposés dans une liste dépendent alors d’une valeur sélectionnée précédemment.
</aside>
Gérer les listes issues d’une base de données externe
Prérequis
Une connexion à la base de données externe doit être configurée sur le serveur.
Procédure
- Depuis la vue Listes, cliquez sur Créer.
- Renseignez le Libellé et, si besoin, une Description.
- Dans Alimentation de la liste, sélectionnez Valeurs issues de base de données.
- Renseignez éventuellement le Nom système, puis cliquez sur Suivant.
- Sélectionnez la base dans le champ Connexion.
- Saisissez la Requête SQL qui récupère les valeurs.
- Ajoutez si nécessaire des Contraintes.
- Cliquez sur Suivant.
Utiliser des contraintes dans la requête SQL
Les contraintes permettent d’utiliser les valeurs déjà saisies dans d’autres champs afin de filtrer les résultats de la liste.
- Dans la clause
WHERE de la requête, ajoutez un point d’interrogation ? pour chaque valeur dynamique.
- Dans Contraintes, ajoutez les champs qui fourniront ces valeurs.
- Placez les champs dans le même ordre que les points d’interrogation de la requête.
Exemple :
SELECT VERS_NAME
FROM VERSION
WHERE PROD_NAME=? AND END_SUPPORT_DATE<=?
Lors de l’exécution, Visiativ Process remplace le premier ? par la valeur du premier champ de la liste des contraintes, puis le deuxième ? par la valeur du deuxième champ.
<aside>
⚠️
</aside>
Configuration d’une requête SQL et de ses contraintes
Gérer les listes issues du serveur
Créer une liste
Les listes serveur sont définies par l’administration et stockées dans le répertoire custom\webapp\WEB-INF\conf\list. Le fichier directory.list fournit des listes disponibles par défaut.
- Depuis la vue Listes, cliquez sur Créer.
- Renseignez le Libellé et, si besoin, une Description.