La description d'un formulaire XML Web Editor peut être personnalisée et améliorée par la définition d'attributs et de valeurs dans le fichier de description de formulaire XML proprement dit ou dans un fichier de propriétés distinct.
Remarque : Le nom de ce fichier de propriétés doit être indiqué comme valeur de l'attribut resourcePackage dans la balise formList. Si le nom du fichier apparaît dans un sous-répertoire inclus dans un répertoire du chemin de classe, il doit utiliser la spécification des paquets (point).
Le tableau suivant répertorie les attributs de zone de formulaire de Web Editor pouvant être modifiés par un administrateur.
Attributs de zone | Description |
---|---|
Devise | Permet d'afficher les valeurs avec un séparateur numérique spécifique de l'environnement local (tel qu'une virgule comme séparateur des milliers aux Etats-Unis). |
DbColumn | Permet de mapper le nom de zone
sur la clé de fichier de propriétés. Si vous utilisez des fichiers de propriétés spécifiques de l'environnement local, la valeur entrée ici doit correspondre à celle entrée dans le fichier de propriétés. DTD Generator ajoute un schéma à la fin de cette entrée. |
DefaultValue | Indique une valeur qui est affichée
dans le formulaire de saisie de données lorsqu'un utilisateur remplit un
nouveau formulaire. La valeur par défaut de la base de données peut être affectée à cet attribut par DTD Generator. Il peut s'agir d'une chaîne statique, mais cette valeur peut également inclure une requête scalaire SQL s'appliquant à une table comportant une seule ligne. Pour extraire des données externes, une fonction définie par l'utilisateur peut être utilisée dans la requête. Exemple : DefaultValue="SELECT CURRENT TIMETAMP FROM EXEC" EXEC étant un élément défini et alimenté comme suit : CREATE TABLE EXEC (A CHAR(1)); INSERT INTO A VALUES('A'); |
dynamicSqlSelectionList | Permet de reconstituer un menu déroulant pour chaque formulaire. |
FieldDescription | Fournit une description qui est
affichée en regard de la zone d'entrée dans le formulaire. DTD Generator utilise les commentaires sur la colonne, s'il y en a, lors de la création de cet attribut. S'il n'y a pas de commentaire sur la colonne, la valeur par défaut est le nom de la colonne. Cet attribut peut être défini dans le fichier de propriétés spécifique de l'environnement local ou dans le fichier de description de formulaire XML. Si une valeur est spécifiée dans le fichier de propriétés, elle a la priorité. |
FieldHelp | Fournit une brève description
d'aide de la zone à afficher dans la barre de messages inférieure du navigateur
lorsque la zone est mise en évidence dans le formulaire. Par défaut, cette zone contient un simple message vous demandant de saisir des données pour la zone en question, ainsi que le type de colonne de données. Cet attribut peut être défini dans le fichier de propriétés spécifique de l'environnement local ou dans le fichier de description de formulaire XML. Si une valeur est spécifiée dans le fichier de propriétés, elle a la priorité. |
formatNumber | Permet d'indiquer à Web Editor de ne pas traiter un nombre en aucune façon. Affectez la valeur "false" à l'attribut formatNumber pour traiter la valeur saisie comme une chaîne, sauf lors des demandes d'extraction (où la valeur n'est pas placée entre guillemets comme le serait une chaîne). La valeur par défaut de cet attribut est "true". |
Hidden | Indique que la valeur n'est pas affichée sur le formulaire, mais qu'elle est toujours disponible en tant que zone HTML masquée. |
HideOnCreate | Indique que la zone est disponible
lorsqu'un nouveau formulaire est composé. Cet attribut est similaire à showInCreateMode="false" mais ajoute le nom de zone comme type masqué. |
Maxlength | Indique la longueur de la colonne
de base de données. Cet attribut est utilisé pour faire en sorte que l'utilisateur n'entre pas une valeur dont la longueur serait trop grande pour pouvoir être stockée dans la base de données. |
MinOccurs | Indique si la zone est obligatoire. La valeur "1" signifie que la zone est obligatoire et la valeur "0", qu'elle est facultative. |
Name | Indique le nom de la colonne de base de données. |
readOnly readOnlyForCreate readOnlyForEdit |
Ces attributs contrôlent les
moments où une zone est disponible pour modification et ceux où elle ne peut
être consultée par l'utilisateur qu'en lecture seule. readOnly="true" signifie qu'une zone est toujours en mode lecture seule. readOnlyForCreate="true" signifie qu'une zone est en mode lecture seule lors de la création d'un nouveau formulaire. readOnlyForEdit="true" signifie qu'une zone est en mode lecture seule lors de la modification d'un formulaire existant. |
ShowColumnInList | Indique que la zone correspond à
l'une des colonnes constituant la vue de plusieurs enregistrements de données,
lorsque la valeur "true" est définie.
DTD Generator affecte la valeur "true" aux six premières colonnes. |
showInCreateMode | Permet de masquer une zone dans le
formulaire créé. Affectez la valeur "false" à l'attribut showInCreateMode pour masquer la zone dans le formulaire créé affiché. La valeur par défaut de cet attribut est "true". |
ShowInSearchMode | Permet de masquer certaines colonnes
dans la page des critères de recherche. Si la valeur "false" est affectée à cet attribut, la zone concernée n'est pas affichée dans le formulaire de recherche. |
SqlSelectionList | Crée un menu déroulant dans lequel
un utilisateur peut faire une sélection lorsqu'il crée un nouveau formulaire. La requête doit renvoyer un ensemble de résultats dans une ou deux colonnes. La première colonne correspond à la liste des intitulés dans laquelle l'utilisateur peut faire son choix et la seconde colonne correspond à la liste des valeurs réelles à stocker dans la table de la base de données. Si une seule colonne est utilisée, la valeur affichée est celle qui est stockée dans la table. Cette fonction est très utile pour établir les relations entre clés associées. |
Type | Indique le type de colonne de
base de données et le type de contrôle de validation devant être effectué sur les données.
Par exemple, si le type est "integer" (entier), l'application s'assure que seules des valeurs entières valides sont entrées dans cette zone. |
UniqueKey | Indique que la zone est la clé
primaire d'une table. Si la valeur "true" est affectée à cet attribut, l'application établit une contrainte d'unicité sur les données saisies pour cette colonne. Ce contrôle n'est effectué que sur les enregistrements chargés dans l'application. Il ne s'applique pas aux enregistrements existants de la base de données. |
ValidateInput | Permet de désactiver le contrôle
de validation.
Cet attribut permet à l'utilisateur de saisir du texte dans une zone numérique qui sera traitée par les utilitaires ID Resolver ou XML Transformer. |
![]() |