Altova StyleVision 2023 Enterprise Edition

La sintaxis para definir un formato de valor es:

([carácter/caracteres prefijo]campo[carácter/caracteres sufijo][{campo-opción1,campo-opción2,...}])+

Explicación sobre la sintaxis de definición

Así se construye la definición de formato de valor:

•La definición está compuesta por un campo o varios. Por ejemplo, la definición DD Month YYYY tiene tres campos.

•Los campos pueden ir juntos o pueden estar separados por estos caracteres: espacio, guión, coma, dos puntos, punto o por una cadena de texto entre comillas simples o dobles. Por ejemplo, en la definición DD-Month' en el año 'YYYY, los campos DD y Month están separados por un guión y los campos Month y YYYY están separados por una cadena de texto entre comillas simples.

•Un campo puede tener caracteres prefijo / sufijo. Por ejemplo: <+###,##0.00.

•Un campo puede tener una opción de campo o varias. Las opciones de campo de cada campo deben tener un conjunto de llaves y deben seguir al campo sin estar separados por espacios. Si usa varias opciones para un campo, entonces sepárelas con una coma ",". Por ejemplo, en la definición DD Month{uc,ro} YYYY, las opciones de campo uc y ro que aparecen entre llaves son las opciones del campo Month.

Ejemplos

Ejemplo de formato de valor para un tipo de datos xs:decimal:

"\$"(##0.00)

Ejemplos de resultados:

\$ 25.00

\$ 25.42

\$267.56

Ejemplo de formato de valor para un tipo de datos xs:date:

DD Month{uc,ro} YYYY

Ejemplo de resultado:

24 SEPTEMBER 2003

Tipos de campo

Un tipo de campo equivale a un componente de los datos y la forma en que se debe dar formato al componente. El formato inherente al tipo de campo se puede modificar con prefijos y sufijos modificadores así como con opciones de campo. Las tablas que aparecen a continuación enumeran todos los tipos de campo disponibles. No olvide que puede modificar las opciones del menú desplegable del cuadro de diálogo "Editar campo" con ayuda de los prefijos y sufijos modificadores y de las opciones de campo.

Notas sobre la longitud del campo y de la entrada

Debe tener en cuenta estos aspectos sobre la longitud de los componentes de datos:

Longitud de los campos de fecha: cuando utilice campos como MM, DD, HH, hh, mm y ss, compruebe que tienen una longitud de 2. Cuando utilice los campos y o Y, el número de caracteres y o Y de la definición determina la longitud del resultado. Por ejemplo, si especifica YYY, el resultado del valor 2006 sería 006; pero si la definición fuera YYYYYY, el valor sería 002006.

Aumentar la longitud del campo: el símbolo * se usa para aumentar la longitud de un campo numérico no semántico (enteros, decimales, etc.). En el caso de los decimales, puede usar el asterisco a ambos lados del punto decimal. Por ejemplo, el valor de formato *0.00* hace que en la posición de cada asterisco aparezca un cero.

Longitud de las entradas en la vista Authentic: la vista Authentic del contenido de un nodo se vasa en la definición de formato de valor del nodo. Por tanto, el usuario de la vista Authentic no podrá insertar más caracteres de los permitidos por la definición de formato de valor. Esto es ideal para restringir la entrada de datos en la vista Authentic. Sin embargo, recuerde que si la longitud de un valor ya existente del documento XML supera la longitud especificada por la definición de formato, entonces aparecerá todo el valor.

Prefijos y sufijos modificadores

Los prefijos y sufijos modificadores se usan para modificar la alineación del texto y la representación positiva/negativa de los campos. Esta tabla muestra los prefijos y sufijos disponibles.

Opciones de campo

Las opciones de campo sirven para realizar algunos cambios en los campos del valor de formato. Estas son las opciones disponibles:

Debería usar las opciones de campo para generar formatos numéricos en idiomas europeos, que usan las comas y los puntos de forma diferente: p. ej 123.456,75.

El formato de valor necesario para obtener el formato de este ejemplo sería: ###,###.##{dec=,,sep=.}

Observe que el campo retiene el formato inglés, mientras que las opciones de campo dec y sep especifican el símbolo decimal y el separador de dígitos. Si el símbolo decimal y separador de dígitos no se especifican, se usará el símbolo decimal y el separador de dígitos predeterminado de la configuración regional del sistema operativo Windows.

Nota sobre el año base

Cuando use formatos de año cortos (como yy y YY), el año base especifica el corte/límite para un siglo. Por ejemplo, la opción de campo de año base podría usarse en la definición DD-MM-YY{base=1940}. Si el usuario introduce un valor igual o mayor que los dos últimos dígitos del año base (que se consideran un entero positivo de dos cifras), el siglo será el mismo que el del año base. Si el valor introducido por el usuario es menor al valor entero de los dos últimos dígitos, entonces el siglo será el siglo del año base más uno. Por ejemplo, si la definición dice base=1940 y el usuario  introduce 50, el valor que se introduce en el documento XML será 1950; pero si el usuario introduce 23, el valor que se introduce en el documento XML será 2023.

Recuerde que:

•Aunque lo más común es usar dos dígitos como formato de año corto, también se pueden usar formatos de año con uno y tres dígitos y con un año base.

•Los tipos de datos que se pueden usar para los formatos de año corto son: xs:date, xs:dateTime, xs:gYear y xs:gYearMonth.

•Si el formato de valor se define para un cálculo automático, asegúrese de seleccionar el tipo de datos correcto en el cuadro de diálogo "Formato de valor". El tipo de datos seleccionado debería ser el del resultado que obtiene el cálculo automático.

•Si usa el tipo de campo yy, el año base predeterminado es 1930. Si establece un año base se invalida el año base predeterminado.

•Si usa el tipo de campo YY sin especificar un año base, el usuario de la vista Authentic solamente podrá modificar los dos últimos dígitos del valor de año de cuatro dígitos. Los dos primeros dígitos se quedan tal y como están en el documento XML.