Write to Variable Format File

Write to Variable Format File (Escritura en archivo de formato variable) escribe registros de diseño variable en un archivo.

Los archivos de formato variable poseen estas características:

  • Los registros del archivo pueden tener campos diferentes y distinta cantidad de campos.
  • Todos los registros deben contener una etiqueta (normalmente un número) que identifique el tipo de registro.
  • Se admiten las relaciones jerárquicas.

Ejemplo de archivo de formato variable

Este ejemplo muestra un archivo de formato variable que contiene información sobre la actividad de la cuenta corriente de dos clientes: Joe Smith y Anne Johnson. En este ejemplo, el archivo es un archivo delimitado que usa la coma como delimitador de campo.

001   Joe,Smith,M,100 Main St,555-234-1290
100   CHK12904567,12/2/2007,6/1/2012,CHK
200   1000567,1/5/2012,Fashion Shoes,323.12
001   Anne,Johnson,F,1202 Lake St,555-222-4932
100   CHK238193875,1/21/2001,4/12/2012,CHK
200   1000232,3/5/2012,Blue Goose Grocery,132.11
200   1000232,3/8/2012,Trailway Bikes,540.00

El primer campo de cada registro contiene la etiqueta que identifica el tipo de registro y, por lo tanto, el formato del registro:

  • 001: registro del cliente
  • 100: registro de la cuenta
  • 200: registro de la transacción de la cuenta

Para los archivos delimitados, es común que el valor de la etiqueta (001, 100, 200) sea un número fijo de bytes ubicado al principio del registro, como se muestra en el ejemplo anterior.

Cada registro tiene su propio formato:

  • 001: Nombre,Apellido,Sexo,Dirección,Número_de_teléfono
  • 100: ID_de_la_cuenta,Fecha_de_apertura,Fecha_de_vencimiento,Tipo_de_cuenta
  • 200: ID_de_la_transacción,Fecha_de_la_transacción,Proveedor,Monto

El formato de registro 100 (registro de cuenta) es un campo secundario del registro anterior 001, y el formato de registro 200 (registro de transacción de cuenta) es un campo secundario del registro anterior 100 (registro de cuenta). En el archivo de ejemplo, en la cuenta CHK12904567 de Joe Smith, se realizó una transacción el 5/1/12 por un importe de 323,12 en Fashion Shoes. A su vez, en la cuenta CHK238193875 de Anne Johnson, se realizaron dos transacciones, una el 5/3/12 en Blue Goose Grocery y la otra el 8/3/12 en Trailway Bikes.

Ficha Propiedades del archivo

Nombre de la opción Descripción

Server name (Nombre de servidor)

Indica si el archivo que seleccionó como entrada está ubicado en la computadora que está ejecutando Enterprise Designer o en el servidor de Spectrum™ Technology Platform. Si selecciona un archivo en la computadora local, el nombre del servidor será Mi computadora. Si selecciona un archivo que se encuentra en el servidor, el nombre del servidor será Spectrum™ Technology Platform.

Nombre de archivo

Especifica la ruta al archivo. Haga clic en el botón de los puntos suspensivos (...) para buscar el archivo que desea.

Nota: Si el servidor de Spectrum™ Technology Platform está ejecutándose en Unix o Linux, recuerde que estas plataformas distinguen las mayúsculas de las minúsculas en los nombres de los archivos y las rutas.

Nombre de etiqueta de raíz

La etiqueta que se usa para registros principales; es decir, de los que dependen otros tipos de registros. Por ejemplo, si usted tiene los tipos de registro 001, 100 y 200, y los tipos de registro 100 y 200 son elementos secundarios de 001, entonces 001 es la etiqueta de raíz.

Usar etiquetas de ancho fijo

Especifica si se asigna una cantidad fija de espacio al principio de cada registro para ubicar la etiqueta de registro. Por ejemplo, a continuación se muestra un archivo que posee las etiquetas 001, 100 y 200 en un campo de ancho fijo:

001   Joe,Smith,M,100 Main St,555-234-1290
100   CHK12904567,12/2/2007,6/1/2012,CHK
200   1000567,1/5/2012,Mike's Shoes,323.12

Ancho de etiqueta

Si usted marca la casilla Usar etiquetas de ancho fijo, esta opción especifica la cantidad de espacios designados para las etiquetas al principio de cada registro. Por ejemplo, si especifica 7, las primeras 7 posiciones de cada registro quedarán reservadas para la etiqueta. El valor que especifique tiene que ser superior o igual al tamaño en caracteres del nombre de etiqueta más largo. Para obtener información sobre los nombres de etiqueta, consulte Nombres de etiqueta en archivos de formato variable.

El valor en el campo Ancho de etiqueta aumenta automáticamente si agrega, en la ficha Campos, campos cuyos nombres sean más largos que el valor especificado.

El ancho de etiqueta máximo es 1024.

Eliminar prefijo de etiqueta numérica

Elimina el texto "NumericTag_" del nombre del campo antes de escribir la etiqueta en el archivo. La etapa Read from Variable Format File agrega el prefijo "NumericTag_" a todos los nombres de etiqueta que comienzan con un número. Esto se debe a que el nombre de etiqueta se usa como nombre de un campo de lista del flujo de datos que contiene los datos del registro, y los nombres de los campos de flujo de datos no pueden comenzar con un número. Por ejemplo, la etiqueta 100 pasará a ser el campo de lista "NumericTag_100". Si activa esta opción, el campo se escribirá en el archivo de salida como un registro con una etiqueta "100", en lugar de "NumericTag_100".

Character encoding (Codificación de caracteres)

Codificación del archivo de texto. Seleccione uno de estos:

UTF-8
Admite todos los caracteres Unicode y es compatible con las versiones anteriores de ASCII. Para obtener más información sobre UTF, consulte unicode.org/faq/utf_bom.html.
UTF-16
Admite todos los caracteres Unicode, pero no es compatible con las versiones anteriores de ASCII. Para obtener más información sobre UTF, consulte unicode.org/faq/utf_bom.html.
US-ASCII
Codificación de caracteres basada en el orden del alfabeto inglés.
UTF-16BE
Codificación UTF-16 con serialización de bytes big endian (byte más significativo al principio).
UTF-16LE
Codificación UTF-16 con serialización de bytes little endian (byte menos significativo al principio).
ISO-8859-1
Codificación de caracteres ASCII, que suele utilizarse para los idiomas de Europa occidental. También se la conoce como Latin-1.
ISO-8859-3
Codificación de caracteres ASCII, que suele utilizarse para los idiomas de Europa meridional. También se la conoce como Latin-3.
ISO-8859-9
Codificación de caracteres ASCII, que suele utilizarse para el idioma turco. También se la conoce como Latin-5.
CP850
Página de códigos ASCII que se utiliza para escribir idiomas de Europa occidental.
CP500
Página de códigos EBCDIC que se utiliza para escribir idiomas de Europa occidental.
Shift_JIS
Codificación de caracteres para el idioma japonés.
MS932
Una extensión de Microsoft de Shift_JIS para incluir caracteres especiales NEC, selección NEC de extensiones IBM y extensiones IBM.
CP1047
Una página de códigos EBCDIC con el conjunto de caracteres completo del alfabeto latino 1.

Separador de campo

Especifica el carácter que se utiliza para separar los campos en un archivo delimitado.

Por ejemplo, este registro utiliza una barra vertical (|) como separador de campo:

7200 13TH ST|MIAMI|FL|33144

Estos caracteres disponibles para definir como separadores de campo son:

  • Espacio de claves
  • Tab
  • Coma
  • Punto
  • Punto y coma
  • Barra vertical

Si el archivo utiliza un carácter distinto como separador de campo, haga clic en el botón de los puntos suspensivos para seleccionar otro carácter como delimitador.

Separador de etiqueta Especifica el carácter ubicado después del campo de etiqueta para demarcar el campo de identificación de cada registro en un archivo delimitado. El separador de etiqueta debe ser un solo carácter.

De forma predeterminada, estos caracteres están disponibles para ser elegidos como separadores de etiqueta:

  • Espacio de claves
  • Tab
  • Coma
  • Punto
  • Punto y coma
  • Barra vertical

Si el archivo utiliza un carácter distinto como separador de etiqueta, haga clic en el botón de los puntos suspensivos para agregar y seleccionar un separador de etiqueta personalizado.

Nota: De forma predeterminada, el carácter Separador de registro es el mismo que el carácter Separador de campo seleccionado. Para activar este campo y seleccionar un carácter diferente, desmarque la casilla Igual que separador de campo.
Igual que separador de campo Indica si el separador de etiqueta es el mismo que el separador de campo. Desmárquelo para seleccionar un carácter diferente como separador de etiqueta.
Nota: De manera predeterminada, esta casilla de verificación está marcada y el campo Separador de etiqueta está desactivado.

Text qualifier (Calificador de texto)

El carácter que se utiliza para demarcar los valores de texto en un archivo delimitado.

Por ejemplo, este registro utiliza comillas dobles (") como calificador de texto.

"7200 13TH ST"|"MIAMI"|"FL"|"33144"

Los caracteres disponibles para definir como calificadores de texto son:

  • Comilla simple (')
  • Comilla doble (")

Si el archivo utiliza un calificador de texto distinto, haga clic en el botón de los puntos suspensivos para seleccionar otro carácter como calificador de texto.

Record separator (Separador de registro)

Especifica el carácter que se utiliza para separar registros en archivos secuenciales o delimitados. Este campo no está disponible si selecciona la casilla Utilizar final de línea predeterminado .

Los parámetros de separador de registro disponibles son:

Unix (U+000A)
Un carácter de salto de línea separa los registros. Este es el separador de registros estándar para los sistemas Unix.
Macintosh (U+000D)
Un carácter de retorno de carro separa los registros. Este es el separador de registros estándar para los sistemas Macintosh.
Windows (U+000D U+000A)
Un carácter de retorno de carro seguido por un salto de línea separa los registros. Este el separador de registros estándar para los sistemas Windows.

Si su archivo utiliza un separador de registro distinto, haga clic en el botón de los puntos suspensivos para seleccionar otro carácter como separador de registro.

Use default EOL (Utilizar final de línea predeterminado)

Especifica que el separador de registro del archivo es el carácter de final de línea (EOL) predeterminado que utiliza el sistema operativo en el que se ejecuta el servidor Spectrum™ Technology Platform.

No seleccione esta opción si el archivo utiliza un carácter de final de línea distinto del que utiliza de forma predeterminada el sistema operativo del servidor. Por ejemplo, si el archivo utiliza un final de línea de Windows pero el servidor está ejecutándose en Linux, no seleccione esta opción. En su lugar, seleccione la opción Windows en el campo Separador de registro.

Ficha Campos

La ficha Campos controla qué campos del flujo de datos se incluyen en el archivo de salida.

Nombre de la opción

Descripción

Agregar

Haga clic para agregar un campo a la salida.

Para obtener información sobre la construcción de campos de flujo de datos para utilizar con Write to Variable Format File, consulte Escritura de datos planos en un archivo de formato variable.

Modificar

Haga clic para modificar el nombre de la etiqueta. Este botón se activa solamente cuando hay una etiqueta seleccionada. Cuando la opción Usar etiquetas de ancho fijo está habilitada en la ficha Propiedades del archivo,el ancho de etiqueta se ajustará automáticamente si usted ingresa un nombre de etiqueta más largo.

Nota: El uso de este botón para modificar el nombre de etiqueta de raíz equivale a modificar el valor del campo Nombre de etiqueta de raíz en la ficha Propiedades del archivo.

Quitar

Elimina el campo seleccionado de la salida. Si elimina un campo de lista, también elimina todos sus campos secundarios. Si elimina un campo secundario, únicamente se elimina el campo secundario seleccionado del campo de lista.

xx

Eliminar todos

Elimina todos los campos de la salida.

Subir/Bajar

Reordena el campo seleccionado.

Ficha Tiempo de ejecución

Nombre de la opción

Descripción

Nombre de archivo

Muestra el archivo definido en la ficha Propiedades del archivo.

Generar varios archivos Seleccione esta opción para escribir registros en diferentes archivos en lugar de escribir todos los registros de un único archivo. El archivo en el cual se escribe cada registro está especificado en el propio registro. Cada registro debe contener un campo que especifica ya sea un nombre de archivo o la ruta completa del archivo en el cual desea que se escriba el registro. Por ejemplo, si desea enviar el precio de las acciones de diferentes empresas (de diversos grupos) a todos los clientes por separado, esta función escribe el precio de las acciones de las diferentes empresas en archivos independientes que se pueden enviar a cada uno de los clientes, si así lo desea. Si se activa la opción Generar múltiples archivos debe especificar un archivo de salida en el servidor Spectrum™ Technology Platform o en un servidor FTP. Si desea escribir datos desde archivos en un servidor FTP, debe definir una conexión con el servidor de archivos mediante Management Console.
Nota: Los registros en la columna que seleccione en Campo de ruta de archivo deben estar ordenados. Utilice esta función cuando el registro contiene ya sea un nombre de archivo o la ruta de acceso del archivo completa.
Campo de ruta de archivo Selecciona el campo que contiene la ruta (ya sea un nombre de archivo o la ruta completa del archivo) del archivo en el cual desea que se escriba el registro. Tenga en cuenta que en el campo Campo de ruta de archivo sólo se enumeran los elementos sencillos de tipo asignado directamente a una etiqueta raíz. Este campo está habilitado solamente si selecciona Generar múltiples archivos.

Modo de escritura

Especifica si se agrega la salida del flujo de datos al final del archivo o si se eliminan los datos ya existentes en el archivo antes de escribir la salida. Una de las siguientes:

Sobrescribir
Reemplaza los datos ya existentes en el archivo de salida cada vez que se ejecuta el flujo de datos.
Adjuntar
Agrega la salida del flujo de datos al final del archivo sin eliminar los datos ya existentes del archivo.