Composants du formulaire

Les composants d’un formulaire sont généralement associés à un attribut ou à un champ de la source de données, à l’exception des composants de type Étiquette et Pièces jointes qui ne sont pas liés directement aux données.

Les sections suivantes décrivent :

• les différents types de composants disponibles;

• les paramètres de chaque type de composant;

• les fonctionnalités de gestion des composants dans un formulaire.

Types de composants

JMap Cloud Portal propose plusieurs types de composants permettant d’adapter les formulaires à divers besoins fonctionnels et visuels.

Étiquette	Texte statique qui s'affiche tel quel dans le formulaire.
Texte	Champ de saisie d’une valeur alphanumérique. L’attribut/champ associé doit être de type Texte.
Nombre	Champ de saisie d’une valeur numérique. L’attribut/champ associé doit être de type Nombre.
Booléen	Permet de renseigner l’attribut/champ associé pour lequel il existe seulement 2 valeurs possibles, qui correspondent aux états coché et non coché du composant. L’attribut/champ associé peut être de type Texte ou Nombre.
Date	Permet de sélectionner une date. L’attribut/champ associé doit être de type Date ou DateTime.
Liste	Liste de valeurs dont, selon le paramètre configuré, seulement une valeur (choix unique) ou plusieurs valeurs (choix multiple) peuvent être sélectionnées. L’attribut/champ associé doit être de type Texte ou Nombre et avoir obligatoirement un domaine de valeurs qui détermine les valeurs possibles que peut prendre l’attribut/champ.
Pièce jointe	Ce composant permet à l'utilisateur d'une application JMap NG de joindre un ou plusieurs fichiers à une entité ou à un enregistrement de la source de données. Voir la section Pièces jointes des sources de données pour plus de détails. Un seul composant Pièce jointe peut être ajouté à un formulaire. La source de données doit avoir un attribut/champ de liaison sélectionné et celui-ci doit être unique et non nul. Note : Si l’attribut/champ de liaison est modifié après l’ajout de pièces jointes, ces dernières sont détachées des entités/enregistrements mais ne sont pas effacées.
Table	Ce composant permet à l'utilisateur d'une application JMap NG de créer et d'éditer des données d'une table associée à une entité ou à un enregistrement de la source de données. Une relation doit être configurée entre la source de données et la table. Si les données de la table sont éditables, vous devez configurer un formulaire pour la table. Exemple Une couche de points représente des stations de mesure de la qualité de l’air. Une table contient les mesures qui ont été prises à la station des polluants à des dates différentes. Pour chaque station de mesure, il peut y avoir 0, 1 ou plusieurs mesures réalisées. Dans le formulaire des attributs de la couche des stations de mesure, le composant table permet d’afficher une table contenant les données de concentration de polluants à différentes dates. Chaque rangée correspond à la mesure d'un polluant à une date donnée.

Paramètres des composants

Chaque type de composant dispose de paramètres spécifiques qui permettent de contrôler son comportement et son apparence (ex. : texte par défaut, format, style, contraintes, etc.).

Attribut	Sélectionnez l’attribut de la couche ou le champ de la table auquel le composant est associé. C’est cet attribut ou ce champ que le composant du formulaire va renseigner.
Titre	Donnez un titre au composant.
Texte	Composants Pièce jointe et Étiquette. Texte de l’étiquette ou de la section du formulaire qui contient les pièces jointes.
Définir l'attribut de liaison	Composant Pièce jointe. Si ce n'est pas fait, appuyez sur le bouton pour ouvrir l'interface de configuration de la source de données et définir l'attribut de liaison. Si l’attribut de liaison est défini, ce paramètre ne s’affiche pas. Cet attribut permet d'associer les pièces jointes aux entités ou enregistrements de la source de données. Il doit être unique et non nul. Note : Si l’attribut de liaison est modifié après l’ajout de pièces jointes, ces dernières sont détachées des entités/enregistrements mais ne sont pas effacées.
Valeur par défaut	Entrez ou sélectionnez une valeur par défaut pour initialiser le champ de saisie.
Choix	Composant Liste. Sélectionnez le type de liste : choix unique ou choix multiple.
Afficher	Sélectionnez le type d'affichage du composant dans le formulaire. Texte : Ligne unique ou Lignes multiples. Liste : Bouton radio ou Sélection. Booléen : Case à cocher ou Interrupteur. Nombre : Champ de saisie ou Glissière.
Domaine de valeurs	Composant Liste. Cette section vous permet d’afficher le domaine de valeurs de l’attribut. Si vous souhaitez modifier les valeurs, cliquez sur Afficher le domaine de valeurs pour ouvrir l’interface de l’onglet Attributs de la source de données. Vous pouvez alors modifier les valeurs. Si l’attribut n’a pas de domaine de valeurs, le bouton Créer un domaine de valeurs s’affiche et lorsque vous cliquez dessus l'interface de l'onglet Attributs de la source de données s'affiche et vous pouvez créer le domaine de valeurs.
Minimum	Composant Nombre. Entrez la valeur minimale de l'attribut.
Maximum	Composant Nombre. Entrez la valeur maximale de l'attribut.
Valeur cochée	Composant Booléen. Indiquez la valeur à enregistrer lorsque la case est cochée ou l'interrupteur est activé.
Valeur décochée	Composant Booléen. Indiquez la valeur à enregistrer lorsque la case est décochée ou l'interrupteur est désctivé.
Statut - Requis	Détermine si le champ est requis. L’utilisateur ne pourra pas soumettre le formulaire tant que tous les champs requis ne seront pas renseignés. Les champs requis sont identifiés par une étoile (*) dans le designer de formulaires.
Statut - Lecture seule	Activez cette option pour que le composant soit en mode lecture seule. L’utilisateur ne pourra pas modifier le contenu. Cette option devrait être utilisée pour un composant ayant une valeur par défaut.
Relation	Composant Table. Sélectionnez la relation qui est utilisée pour établir la relation entre la table et la source de données. La relation doit être définie au préalable.
Attributs visibles	Composant Table. Sélectionnez les attributs de la table qui seront visibles dans le formulaire. Si la table est éditable vous devez configurer un formulaire la table, pour éditer ces attributs.
Trier par	Composant Table. Sélectionnez l'attribut qui sert à faire le tri des enregistrements de la table dans le formulaire.

Travailler avec les composants

Ajouter un composant

Pour ajouter un composant à un formulaire, faites-le glisser depuis la palette et déposez-le dans l’interface de l’onglet Design. Les composants peuvent être insérés dans des contenants pour la mise en page.

Par défaut, les composants sont empilés verticalement dans le formulaire.

Configurer un composant

Pour configurer un composant déjà placé dans le formulaire, cliquez dessus dans l’onglet Design. Les paramètres modifiables s’affichent dans la section Propriétés.

La disposition spatiale des composants peut être ajustée à l’aide des outils de mise en page, décrits dans la section suivante.

Supprimer un composant

Pour supprimer un composant, cliquez dessus dans l’onglet Design, puis cliquez sur l’icône de suppression .