La gestion des champs

<aside>

Sommaire

Dans cette page

Cette documentation explique comment consulter, créer et modifier les champs utilisés dans les processus, les tableaux dynamiques et les tables de données de Visiativ Process.

<aside> 👤

Public concerné

Cette page s’adresse aux administrateurs fonctionnels et aux concepteurs disposant des droits de configuration des champs.

</aside>

Comprendre les catégories de champs

Visiativ Process distingue trois catégories de champs :

Catégorie	Origine	Utilisation
Champs standard	Créés par une personne chargée de la conception	Processus, groupes de processus, tableaux dynamiques et tables de données
Champs système	Créés automatiquement par Visiativ Process	Informations techniques et de suivi disponibles selon le type d’élément
Champs avancés	Générés automatiquement à partir des rôles ou des tableaux dynamiques	Conception avancée, connecteurs et développements SDK

<aside> 💡

Les champs appartiennent à une application. Définissez des libellés compréhensibles pour les utilisateurs et des noms système stables pour les usages techniques.

</aside>

Gérer les champs standard

Utilisation des champs standard

Les champs standard peuvent être utilisés dans :

les groupes de processus et les processus ;
les colonnes de tableaux dynamiques ;
les colonnes des tables de données.

Pour les afficher, ouvrez la vue des champs puis cliquez sur Champs standard.

Créer un champ standard

Prérequis

Identifier la donnée à stocker et son usage dans les formulaires, vues ou traitements.
Choisir le type de champ approprié.
Préparer un libellé utilisateur et, si nécessaire, un nom système.

Procédure

Depuis la vue des champs, cliquez sur Créer.
Renseignez le Libellé du champ.
Ajoutez éventuellement une Description.
Renseignez, si nécessaire, le Nom système.
Indiquez si le champ peut contenir une donnée sensible.
Sélectionnez le Type de champ.
Cliquez sur Suivant.
Renseignez les propriétés propres au type sélectionné, puis validez.

Assistant de création d’un champ standard

<aside> ℹ️

La description est affichée dans l’aide du champ au sein des formulaires. Utilisez-la pour préciser le format attendu ou donner un exemple de valeur.

</aside>

Choisir un type de champ

Les principaux types proposés lors de la création sont :

Texte : texte libre ou valeur issue d’une liste ;
Date : date utilisée pour la saisie, les délais ou les filtres ;
Nombre : nombre entier ou décimal ;
Booléen : valeur de type oui/non présentée sous forme de case à cocher ;
Période : intervalle composé d’une date de début et d’une date de fin.

<aside> ⚠️

Le type et le nom système ne sont plus modifiables après la création. Vérifiez ces informations avant de valider l’assistant.

</aside>

Modifier un champ standard

Depuis la vue des champs, ouvrez le menu situé à côté du champ.
Cliquez sur Propriétés.
Modifiez le Libellé ou la Description.
Cliquez sur Enregistrer et fermer.

Propriétés modifiables d’un champ

<aside> ℹ️

Pour préserver la cohérence des formulaires, traitements et développements, seuls le libellé et la description d’un champ existant peuvent être modifiés.

</aside>

Définir un alias SDK

L’alias permet de personnaliser le nom de la méthode générée pour un champ.

Ouvrez les propriétés du champ.
Développez la section Développement SDK.
Dans Alias de la méthode, renseignez l’alias souhaité.
Enregistrez vos modifications.

<aside> 💡

Réservez la modification des alias aux profils techniques et appliquez une convention de nommage homogène dans toute l’application.

</aside>

Consulter les champs système

Les champs système sont ajoutés automatiquement lors de la création de l’application. Ils permettent notamment d’identifier la création, la modification, la référence et les personnes intervenant dans un processus ou une donnée.

Pour les afficher, ouvrez la vue des champs puis cliquez sur Champs système.

Vous pouvez consulter leurs propriétés de base, définir des alias et leur associer des services de connecteurs.

Disponibilité des principaux champs système

Champ système	Processus	Tableau dynamique	Table de données
Chrono de la référence formatée	Oui	Non	Non
Créateur	Oui	Oui	Oui
Créateur représenté	Oui	Non	Oui
Date de création	Oui	Oui	Oui
Date de modification	Oui	Oui	Oui
Étapes en cours	Oui	Non	Non
Intervenants en cours	Oui	Non	Non
Modifié par	Oui	Oui	Oui
Opérateurs précédents	Oui	Non	Non
Période	Oui	Non	Non
Racine du chrono de la référence formatée	Oui	Non	Non
Référence	Oui	Non	Oui
Titre	Oui	Non	Oui
Tous les intervenants passés	Oui	Non	Non

Consulter les champs avancés

Les champs avancés sont créés automatiquement lors de la conception d’un processus à partir :

des rôles ;
des tableaux dynamiques.

Pour les afficher, ouvrez la vue des champs puis cliquez sur Champs avancés.

La liste présente les champs de rôle et de tableau disponibles pour le processus. Selon vos droits, vous pouvez consulter ou modifier leurs propriétés de base, définir des alias et associer des connecteurs.

<aside> ⚠️

</aside>

Bonnes pratiques

Choisissez le bon type de champ dès la création.
Utilisez un libellé orienté utilisateur et une description explicite.
Stabilisez les noms système et les alias avant les développements ou les intégrations.
Ne créez pas plusieurs champs pour stocker la même information métier.
Vérifiez la disponibilité d’un champ système avant de créer un champ standard équivalent.
Testez l’affichage du champ dans les formulaires et les vues avant la mise en production.
Réservez les champs avancés et les alias SDK aux personnes disposant des compétences techniques nécessaires.