Elemento Field (Campo) en FSD
El elemento "field" define un solo campo en los datos de entrada o salida.
<field name output='yes|no' field-sep valid-value default-value leading-chars trailing-chars output-if-empty='no' max-length='128' min-length='0' truncate='no' quoted='auto' </field>
Atributos
name
Define el nombre de "field". Si el atributo "output" se define como yes, el nombre se utilizará como nombre de la etiqueta XML en la salida, y también para establecer la correspondencia entre la elección y la etiqueta XML en la fase de entrada.
output
Define si el campo se incluirá o no en la salida. Las valores válidos para este atributo son yes y no. El valor yes significa que el registro debe generar un etiqueta en la salida y no que "field" simplemente describe la estructura de datos y que puede utilizarse para ignorar datos. El valor por defecto es yes.
record-sep
Define una cadena de separador opcional para "field". El valor de la cadena puede ser cualquier valor. También se pueden utilizar los siguientes valores especiales:
- \r El carácter que indica salto de línea
- \n El carácter que indica avance de línea
- \t El carácter del tabulador.
Si no se especifica separador de campo, se utilizará el atributo de longitud máxima
"max-lenght"
para leer los datos (los datos tendrán longitud fija). El último campo de un registro puede omitir el separador de campo, en cuyo caso se utiliza el separador de registro si se ha especificado alguno.valid-value
Puede utilizar este atributo para definir un valor que debe tener "field". Se utiliza cuando se leen datos planos para validar datos y como parte del elemento "choice", con el fin de facilitar la correspondencia de modelos. Cuando se escriben datos planos y el atributo "output" se define en no, el valor fijo especificado como
valid-value
se registra en los datos planos.leading-chars
Es una cadena que contiene caracteres que deben omitirse al principio del valor cuando éste se lee desde el archivo plano. Cuando se escriben datos en el archivo plano y no se especifica el atributo
"trailing-chars"
se utiliza el primero de estos caracteres para ajustar hacia la izquierda el valor y crear la longitud correcta (tal como ha determinado el atributo "min-length").trailing-chars
Es una cadena que contiene caracteres a omitir al final del valor cuando éste se lee desde el archivo plano. Cuando se escriben datos en el archivo plano se utiliza el primero de estos caracteres para ajustar hacia la derecha el valor y crear la longitud correcta (tal como ha determinado el atributo
min-length)
.output-if-empty
Determina si el campo se va a eliminar cuando los contenidos estén vacíos. Los valores válidos para este atributo son yes y no. El valor por defecto es no.
max-length
Define la longitud máxima de los datos. Este valor se utiliza para determinar la cantidad de datos a leer. El valor por defecto es 128.
min-length
Define la longitud mínima de los datos. Se utiliza para validación, correspondencia de modelos mediante el elemento "choice" y también para ajustar distancias del borde-texto cuando no se especifican los atributos
leading-chars
otrailing-chars
. El valor por defecto es cero.truncate
Si esta opción de define en yes los datos que se vuelven a escribir en formato de archivo plano se truncan para mantener la longitud máxima especificada en
max-length
. El valor por defecto es no.quoted
Esta opción determina si es necesario encerrar los datos entre comillas. Se utiliza para permitir que el carácter separador de campos aparezca en los datos actuales (ya que el procesador FSD no busca separadores de campos en cadenas entrecomilladas). Este atributo puede tener los valores siguientes:
-
No
Los datos no deben tratarse como un cadena entrecomillada, es decir, los datos se escriben textualmente dentro y fuera del archivo plano.
-
Sí
Los datos se deben tratar como una cadena entrecomillada. Cuando se realiza una conversión de formato plano a XML, se eliminan las comillas que rodean los datos y las que se dejan se convierten en comillas sencillas.
Cuando se realiza una conversión desde formato XML a formato plano, los datos se encierran entre comillas y se aplican caracteres de escape a las comillas existentes (es decir, las comillas sencillas se convierten en pares de comillas, por lo tanto " se convierte en "", etc.).
-
Auto
Esta opción solo se aplica cuando se convierten datos delimitados de archivos planos en XML. Si los datos contienen un separador de campos, se tratan como si la opción de entrecomillado estuviera definida en yes. El valor por defecto para este valor es auto.
-
No