Personnalisation de la description de formulaire XML pour Web Editor

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.

Rubriques connexes

Tâches connexes

IBM copyright