Vous pouvez ajouter vos propres contrôles aux formulaires de CARL Source, y compris de nouveaux onglets.
Le fonctionnement des différents contrôles est décrit dans cette rubrique : Libellé, Champ, Case à cocher, Groupe, Bouton, Image, Colonne, Lien, Onglet.
Procédure
- Entrez dans le mode personnalisation pour afficher les boîtes d'outils dédiées.
- Dans la palette "Contrôle", cliquez sur celui à ajouter et faites-le glisser jusqu'à l'endroit où vous souhaitez le positionner. Un nouvel onglet doit être positionné à côté des onglets déjà présents.
- Une fois le contrôle positionné, sélectionnez-le, changez son format et affectez-lui des propriétés, voir Propriétés des contrôles.
Spécificités et fonctionnement des contrôles
Les propriétés communes des contrôles sont décrites dans Propriétés des contrôles.
Libellé
Simple label explicatif à positionner généralement à gauche d'un champ.
Propriétés spécifiques :
Si le libellé que vous ajoutez dans le formulaire doit être traduit, ou décliné dans plusieurs domaines métiers, indiquez dans la valeur la référence au libellé créé à cette fin.
Le format est #{nom fichier.code libellé}, où "nom fichier" correspond au fichier de libellés de l'écran que vous personnalisez.
Par exemple : #{material.la_ChampPerso} correspond au libellé que vous avez créé, de code "la_ChampPerso", pour le fichier des écrans de gestion des Matériels.
Champ
Zone de texte, éventuellement une infozone, pour saisir ou visualiser une valeur d'attribut de l'objet du formulaire.
Propriétés spécifiques :
- Valeur : Indique l'attribut qui sera affiché et saisi dans ce champ. Voir valeur des contrôles.
- Par défaut : Valeur par défaut du champ. Vous pouvez utiliser une expression dynamique, par exemple {actor} désigne l'acteur connecté. Cette valeur sera prioritaire par rapport à celle définie dans le dictionnaire ou dans le groupe d'accès aux données.
Pour une date, le format doit être dd/mm/yyyy hh:mm ou yyyy-mm-dd. Par exemple : 21/12/2012 08:00 ou 2012-12-21.
- Infozone : Code de l'infozone à laquelle il correspond.
- Liste : Si le champ est une liste déroulante, renseigner le code de la liste de valeurs. Le contrôle devient automatiquement une liste déroulante.
- Longueur : Nombre de caractères maximum saisissable dans le champ.
- Mode : Présent uniquement pour un champ commentaire, si le nombre de lignes est renseigné. Indiquer "visual" pour disposer de la barre de mise en forme, "source" pour masquer cette barre.
- NbrLignes : A renseigner pour un champ de type commentaire, défini comme étant sur plusieurs lignes (voir le masque de saisie de l'attribut dans le dictionnaire). Sa valeur définit le nombre de lignes affichées, donc la hauteur du champ.
- Lecture seule : Condition dans laquelle le champ est en lecture seule.
Exemple : #{formAnimator.bean.category !="ENERGY"}. Le champ sera en lecture seule si la catégorie n'est pas 'ENERGY'.
- Taille maximum : Uniquement pour les champs destinés au téléchargement d'un fichier. Il s'agit de la taille maximale autorisée pour le fichier à télécharger (exemple : Rapport à charger).
Le mode visuel ("visual") s'applique uniquement si le nombre de lignes (cf. "NbrLignes") est renseigné et que sa valeur est supérieure ou égale à 4.
Case à cocher
Pour créer une case à cocher, ajouter un champ de saisie simple. Si l'attribut affecté à un contrôle est de type "Booléen", le contrôle affiché sera une case à cocher.
Pour que la case à cocher n'ait que deux états (coché / non coché), l'attribut doit être coché "obligatoire" dans le dictionnaire.
Groupe
Panneau permettant de regrouper plusieurs contrôles de même thématique.
Indiquer pour le groupe une valeur de couche inférieure à celle des contrôles qui seront situés dessus, afin qu'il se trouve en arrière-plan.
Bouton
Élément déclencheur d'une action.
Propriétés spécifiques :
-
Action : Indiquer la valeur de la colonne "Id" de la table CSSY_ACTION, pour la ligne correspondant au comportement souhaité.
Exemples :
- EXCHANGERATEACTION ouvre le formulaire permettant de configurer les taux de change.
- OPENDOCACTION ouvre le document lié, dont le code est à saisir dans la propriété "Paramètre 1" qui apparaît alors, voir Valeur des contrôles.
- OPENURLACTION ouvre une URL.
- PRINTDEFACTION ouvre le rapport par défaut, ou le rapport dont le code est à saisir dans la propriété "Paramètre 1".
- SENDMAILMSGTMPLACTION ouvre le formulaire permettant de sélectionner un modèle de message et d'envoyer un mail.
- Valeur : Permet d'affecter le libellé.
- Label : Même principe que la valeur du libellé.
- URL : Chemin de l'image affichée dans le bouton, voir Images. Si l'image est renseignée, le label du bouton ne sera pas visible.
Image
Élément déclencheur d'une action.
Propriétés spécifiques :
- Image : Chemin de l'image sur le serveur de CARL Source, si l'image est toujours la même, voir Images.
-
Valeur : A utiliser si :
- le chemin de l'image est la valeur d'un autre champ,
- l'image est stockée dans la bibliothèque ou dans un document lié de l'entité, voir Valeur des contrôles.
Colonne
Pour ajout d'information dans une liste.
Propriétés spécifiques :
- Valeur : Contenu de la colonne, voir Valeur des contrôles.
- Par défaut : Valeur par défaut du champ. Vous pouvez utiliser une expression dynamique, par exemple {actor} désigne l'acteur connecté. Cette valeur sera prioritaire par rapport à celle définie dans le dictionnaire ou dans le groupe d'accès aux données.
- Infozone : Code de l'infozone si la colonne comporte un code d'objet.
- Valeur du pied de colonne : Contenu de la valeur du pied de colonne. Elle doit correspondre à un attribut de l'animateur de la liste, par exemple : #{tableAnimator.totalLatenessCumul} pour une colonne qui contiendrait le cumul des retards dans les statistiques fournisseur.
- Ordre : Position relative par rapport aux autres colonnes, de gauche à droite.
- Rang : Rang du tri à l'entrée sur la page. Pour l'instant, une seule colonne peut être colonne de tri.
-
Tri : Mode de tri "normal", "inverse" ou "aucun" est à saisir. A utiliser pour la colonne de tri, voir aussi Formulaire de résultat.
- "normal" s'il s'agit de l'ordre alphabétique (ordre chronologique pour une date),
- "inverse" s'il s'agit de l'inverse de l'ordre alphabétique (inverse de l'ordre chronologique pour une date),
- "aucun" si vous souhaitez désactiver le tri de la colonne ajoutée (afin que cette nouvelle colonne ne permette pas de trier).
- Style pied : Style CSS de la cellule en pied de colonne.
Lien
Lien hypertexte vers un document lié ou toute autre URL, ou vers une action (fonctionnement similaire au bouton dans ce cas).
Voir Création d'un alerteur : Exemple.
Propriétés spécifiques :
Onglet
Nouvel onglet pour placer des contrôles personnalisés. Si les contrôles sont nombreux, utilisez les groupes pour les organiser.
Propriétés spécifiques :
- Ordre : Position relative par rapport aux autres onglets, de gauche à droite.
- Onglet : Indiquer l'identifiant de l'onglet si celui-ci est affiché par défaut. Exemple : pa_Technician_DET_Calendar pour afficher directement l'onglet [Calendrier] lors de l'ouverture d'une fiche intervenant.