Personalizar la descripción de formularios XML para Web Editor

La descripción de formularios XML de Web Editor puede personalizarse y ampliarse estableciendo atributos y valores en el archivo mismo de descripción de formulario XML o en un archivo de propiedades aparte.

Nota: El nombre del archivo de propiedades debe especificarse como el valor del atributo resourcePackage en el identificador formList. Si el nombre de archivo aparece en un subdirectorio de un directorio en la vía de acceso de clases, debe utilizar la especificación paquete(punto).

La siguiente tabla lista los atributos de campo de formulario de Web Editor que un administrador puede modificar.

Atributo de campo Descripción
Moneda Hace que los valores se muestren con separadores numéricos específicos del entorno nacional (por ejemplo, la coma como separador decimal para España)
DbColumn Se utiliza para correlacionar el nombre de campo con la clave del archivo de propiedades

Si se utilizan archivos de propiedades específicos del entorno nacional, el valor de esta entrada debe coincidir con el que se ha entrado en el archivo de propiedades. DTD Generator añade un esquema a esta entrada.

DefaultValue Especifica un valor que se muestra en el formulario de entrada de datos cuando un usuario rellena un nuevo formulario

DTD Generator puede establecer este atributo en el valor por omisión de la base de datos. Puede ser una serie estática, pero también puede incluir una consulta escalar SQL a una tabla de una sola línea. Para recuperar datos externos, en la consulta puede utilizarse una función definida por el usuario. Por ejemplo:

DefaultValue="SELECT CURRENT TIMETAMP FROM EXEC"

donde EXEC está definido y se insertan datos de la forma siguiente:

CREATE TABLE EXEC (A CHAR(1));
INSERT INTO A VALUES('A');
dynamicSqlSelectionList Hace que se vuelva a crear un menú desplegable para cada formulario
FieldDescription Proporciona una descripción que se muestra al lado del campo de entrada en el formulario

DTD Generator utiliza los comentarios en la columna, si los hay, al crear este atributo. Si no hay comentarios en la columna, el valor por omisión es el nombre de la columna.

Este atributo puede establecerse en el archivo de propiedades específico del entorno nacional o en el archivo de descripción de formulario XML. Tendrá preferencia el valor especificado en el archivo de propiedades.

FieldHelp Proporciona una breve descripción de ayuda del campo, que se visualiza en la barra de mensajes inferior del navegador cuando el campo está activo en el formulario.

Por omisión, contiene un mensaje solicitando que se entren datos en el campo específico junto con el tipo de datos de la columna.

Este atributo puede establecerse en el archivo de propiedades específico del entorno nacional o en el archivo de descripción de formulario XML. Tendrá preferencia el valor especificado en el archivo de propiedades.

formatNumber Se utiliza para indicar a Web Editor que no procese un número de ninguna manera

Establezca el atributo formatNumber en "false" para tratar el valor entrado como una serie, excepto durante las consultas de extracción (en las que el valor no se encierra entre comillas como se haría con una serie). El valor por omisión de este atributo es "true."

Hidden Indica que el valor no se muestra en el formulario pero sigue disponible como campo HTML oculto
HideOnCreate Indica que el campo está disponible cuando se crea un nuevo formulario

Es parecido a showInCreateMode="false"; pero añade el nombre de campo como tipo oculto.

Maxlength Especifica la longitud de la columna de base de datos

Se utiliza para asegurar que el usuario no entre un valor de una longitud superior a la que se puede almacenar en la base de datos.

MinOccurs Indica si el campo es obligatorio

El valor "1" significa que es obligatorio, el valor "0" significa que es opcional.

Nombre Especifica el nombre de la columna de base de datos
readOnly
readOnlyForCreate
readOnlyForEdit
Controla cuándo un campo está disponible para ser modificado y cuándo los usuarios sólo pueden leerlo

readOnly="true" significa que un campo siempre está en modalidad de sólo lectura. readOnlyForCreate="true" significa que un campo está en modalidad de sólo lectura cuando se está creando un nuevo formulario. readOnlyForEdit="true" significa que un campo está en modalidad de sólo lectura cuando se está editando un formulario ya existente.

ShowColumnInList Especifica que el campo es una de las columnas que constituyen la vista de múltiples registros de datos cuando se establece en "true"

DTD Generator establece las seis primeras columnas en "true."

showInCreateMode Se utiliza para ocultar un campo del formulario creado

Establezca el atributo showInCreateMode en "false" para ocultar el campo al visualizar el formulario creado. El valor por omisión de este atributo es "true."

ShowInSearchMode Se utiliza para ocultar ciertas columnas de la página de criterios de búsqueda

Si este atributo está establecido en "false", el campo no se muestra en el formulario de búsqueda.

SqlSelectionList Crea un menú desplegable para que el usuario efectúe su selección cuando se crea un nuevo formulario

La consulta debe devolver un conjunto de resultados de una o dos columnas. La primera columna es la lista de etiquetas que el usuario puede seleccionar; la segunda columna es la lista de los valores reales a almacenar en la tabla de base de datos. Si sólo se utiliza una columna, el valor que se muestra se almacena en la tabla. Esta función es muy útil para forzar las relaciones de clave externa.

Type Indica el tipo de columna de base de datos y el tipo de comprobaciones de validación que deben realizarse en los datos

Por ejemplo, si el tipo es "integer", la aplicación comprueba que en este campo sólo se entre un entero válido.

UniqueKey Indica que el campo es una clave primaria para una tabla

Si este atributo se establece en "true", la aplicación impone una restricción de unicidad en los datos que se entran en esta columna. Esta comprobación sólo se efectúa en los registros cargados en la aplicación. No se extiende a los registros en la base de datos.

ValidateInput Se utiliza para desactivar la comprobación de validación

Este atributo le permite al usuario entrar texto en un campo numérico que gestionará ID Resolver o XML Transformer.

Conceptos relacionados

Tareas relacionadas

Copyright de IBM