Definir un formato de archivo en Jitterbit Design Studio

Jitterbit permite utilizar tipos de archivos simples o complejos como fuentes o destinos durante el proceso de transformación de datos. Los archivos simples tienen el mismo tipo de fila de datos a lo largo del documento de texto, mientras que los archivos complejos contienen múltiples tipos de filas de archivo, como filas de encabezado o de resumen.

Como parte del proceso de transformación, es necesario definir el Formato de Archivo para que Jitterbit sepa cómo procesar los datos. Típicamente, los Formatos de Archivo se generan como parte del recorrido del Asistente al crear tu integración. Después de crear un Formato de Archivo, puedes modificarlo en la sección de Formatos de Archivo en el árbol del lado izquierdo de Studio. Si necesitas definir un formato de archivo personalizado, puedes crear un nuevo Formato de Archivo desde la misma sección.

Esta página cubre cómo definir el Formato de Archivo de un documento de texto que se utilizará como fuente o destino.

Crear un nuevo formato de archivo

Típicamente, los Formatos de Archivo se generan como parte del recorrido del Asistente al crear tu integración. También puedes generar un nuevo Formato de Archivo por separado a través de uno de los siguientes métodos:

• Ve a Archivo > Nuevo > Nuevo Formato de Archivo.
• Haz clic en el icono en la barra de herramientas.
• Haz clic derecho en Formatos de Archivo en el panel izquierdo de Studio, luego elige Nuevo Formato de Archivo en el menú.

Tu nuevo Formato de Archivo se listará en la sección de Formatos de Archivo en el panel izquierdo de Studio. Además, se abrirá una pantalla para configurar tu nuevo Formato de Archivo en el panel derecho de Studio. Aquí eliges si especificar la estructura manualmente o a partir de un archivo de muestra:

• Crear Manualmente: Escribe manualmente los nombres y tipos de los campos mientras configuras tu Formato de Archivo.

• Desde Archivo de Muestra: Utiliza un archivo de muestra si está disponible, como se describe en Creando una definición de documento de texto a partir de un archivo de muestra.

  Nota

  Esta opción está disponible solo para la creación de un formato de archivo simple (plano).

Para los formatos de archivo que se crean manualmente, también será necesario seleccionar el tipo de documento, así como el formato.

• Documento de Texto Simple: Los archivos simples tienen el mismo tipo de fila de datos en todo el documento de texto.
• Documento de Texto Complejo: Los archivos complejos contienen múltiples tipos de filas de archivo, como filas de encabezado o de resumen.

Tanto los tipos de documentos simples como complejos permiten formatos delimitados por caracteres y de ancho de campo fijo.

Haga clic en el botón para continuar a la siguiente pantalla de configuración.

También puede volver a la configuración existente en cualquier momento desde el panel izquierdo de Studio bajo Formatos de Archivo.

Configurar campos manualmente

Después de elegir crear su Formato de Archivo manualmente, se utilizará otra pantalla de configuración para definir cada campo en su documento. Este siguiente paso depende del tipo de estructura de texto que seleccionó: simple o complejo, así como del formato que seleccionó: delimitado por caracteres o de ancho de campo fijo.

Documento de texto simple – delimitado por caracteres

Si ha seleccionado un documento de texto simple que está delimitado por caracteres, su pantalla configurada debería verse similar a la de abajo. A continuación se presenta una explicación de cada sección configurable.

Delimitador y calificador

• Delimitador de Campo: Ingrese el(los) carácter(es) que se utilizarán como delimitador(es) de campo que especifican el límite entre los campos de datos. El valor predeterminado es una coma. También puede usar delimitadores de múltiples caracteres, como un doble pipe ||. Para usar una tabulación como delimitador, ingrese \t.

• Calificador de Cadena y Usar calificador: Ingrese el carácter que se utilizará como envoltura, indicando una cadena de texto que debe tratarse como una única unidad de datos. El valor predeterminado es un carácter de comillas dobles. Si se deja vacío, no se utiliza ningún calificador de cadena.

  Al utilizar un Calificador de Cadena, seleccione una regla de negocio correspondiente, ya sea Siempre o Solo cuando sea necesario, para indicar cuándo debe utilizarse el calificador. Se recomienda la opción predeterminada, Solo cuando sea necesario, de modo que si el(los) carácter(es) especificado(s) como Delimitador de Campo ocurre dentro de la cadena, entonces la cadena se envuelve con el carácter del calificador de cadena especificado. Si el delimitador no ocurre, entonces la cadena no se envuelve.

  Durante el procesamiento de fuentes, el calificador de cadena se elimina. Durante el procesamiento de destinos, se agrega el calificador de cadena.

• Usar saltos de línea para el final de registros: A partir de la versión 8.19, esta casilla se utiliza para activar o desactivar el uso de saltos de línea como separación entre registros. Por defecto, el final de los registros se denota por saltos de línea, de modo que cada registro existe en una línea (a menos que se utilice un calificador). Cuando está desactivado, se ignoran los saltos de línea y los nuevos registros comienzan después de que se alcanza el número total de campos.

  Nota

  Esta bandera es relevante solo para formatos de archivos de origen. Para archivos de destino, los saltos de línea siempre se utilizan para denotar el final de los registros.

• Convertir secuencias de escape: A partir de la versión 8.23, esta casilla se utiliza para convertir o ignorar secuencias de escape, como se indica con una barra invertida (\). Por defecto, las secuencias de escape se convierten de acuerdo con los estándares de Java. Cuando está desactivado, la conversión de texto ocurre sin interpretación de las secuencias de escape.

  Nota

  Esta bandera es relevante solo para formatos de archivos de origen.

Validación (opcional)

• La fila debe contener al menos 'X' columnas: Si desea utilizar la validación de texto (opcional), puede ingresar un número de columnas aquí que cada fila debe contener, para que la acción especificada a continuación ocurra.

  Nota

  Debe tener al menos una fila de datos definida primero para habilitar las opciones de validación.

• Si no: Después de ingresar un número de columnas, se habilitará un menú desplegable, donde puede seleccionar "Omitir Fila" o "Generar Error". Más información sobre la validación está disponible en Validación de campos de archivos planos.

Definir propiedades del segmento

Haz clic en el botón Nuevo para definir el primer campo del documento. Debes ingresar lo siguiente (requerido):

• Nombre del campo: Ingresa un nombre para este campo.

• Tipo: Selecciona un tipo del menú desplegable. Las opciones incluyen Cadena, Entero, Fecha, Largo, Flotante, Doble, Booleano.

  Nota

  Si tienes dudas sobre el tipo de campo, se recomienda elegir Cadena, ya que este tipo permite incluir cualquier tipo de dato como una cadena.

Los siguientes son opcionales:

• Predeterminado: Si deseas que este campo tenga un valor predeterminado, ingresa el valor aquí.

• Formato: Si deseas que este campo tenga un formato específico, como para fecha o moneda, ingresa el formato aquí.

• Validación: Haz doble clic en esta columna o utiliza el botón en la parte derecha para abrir opciones adicionales para la validación del campo. Más información sobre la validación está disponible en Validación de campos de archivos planos.

Repite los pasos anteriores para cada campo de datos adicional que necesites definir.

Documento de texto simple – anchos de campo fijos

Si has seleccionado un documento de texto simple que tiene anchos de campo fijos, tu pantalla configurada debería verse similar a la de abajo. A continuación se presenta una explicación para cada sección configurable.

Validación (opcional)

• La fila debe contener al menos 'X' columnas: Si deseas utilizar la validación de texto (opcional), puedes ingresar un número de columnas aquí que cada fila debe contener, para que la acción especificada a continuación ocurra.

  Nota

  Debes tener al menos una fila de datos definida primero para poder habilitar las opciones de validación.

• Si no: Después de ingresar un número de columnas, se habilitará un menú desplegable, donde puedes seleccionar "Saltar fila" o "Generar error." Más información sobre la validación está disponible en Validación de campos de archivos planos.

Definir propiedades del segmento

Haz clic en el botón Nuevo para definir el primer campo del documento. Debes ingresar lo siguiente (requerido):

• Nombre del campo: Ingresa un nombre para este campo.

• Tipo: Selecciona un tipo del menú desplegable. Las opciones incluyen Cadena, Entero, Fecha, Largo, Flotante, Doble, Booleano.

  Nota

  Si tienes dudas sobre el tipo de campo, se recomienda elegir Cadena, ya que este tipo permite incluir cualquier tipo de dato como una cadena.

• Inicio: Ingresa la posición del carácter inicial (1 se considera la posición para el inicio del archivo). Ten en cuenta que el valor predeterminado para las filas subsiguientes siempre será el siguiente carácter después de la posición final del campo anterior.

• Longitud: Ingresa el número de caracteres que están reservados para este campo.

  Nota

  Los archivos de texto de longitud fija siempre especifican un cierto número de caracteres que están reservados para cada campo. Por ejemplo, puedes identificar un campo llamado Apellido que siempre tiene 30 caracteres reservados para él. (Si el valor real es Smith, solo se utilizan 5 caracteres; los caracteres restantes no tienen nada en ellos.)

  Si has cambiado el valor de longitud de carácter de algún campo, utiliza el botón para recalcular todas las posiciones iniciales de los campos.

  Advertencia

  El botón Calcular restablece todos los valores de los campos Inicio y Fin, basándose en los valores de Longitud que especificaste. No utilices este botón si las posiciones de los campos de tu archivo tienen huecos o superposiciones, ya que se eliminarán.

• Fin: Ingresa la posición del carácter final.

  Nota

  Por defecto, los segmentos de longitud fija se terminan con un carácter de nueva línea.

Los siguientes son opcionales:

• Predeterminado: Si deseas que este campo tenga un valor predeterminado, ingresa el valor aquí.

• Formato: Si deseas que este campo tenga un formato específico, como para fecha o moneda, ingresa el formato aquí.

• Validación: Haz doble clic en esta columna o utiliza el botón en la parte derecha para abrir opciones adicionales para la validación del campo. Más información sobre la validación está disponible en Validación de campos de archivo plano.

Repite los pasos anteriores para cada campo de datos adicional que necesites definir.

Documento de texto complejo – delimitado por caracteres

Si has seleccionado un documento de texto complejo que está delimitado por caracteres, tu pantalla configurada debería verse similar a la de abajo. A continuación se presenta una explicación de cada sección configurable.

Delimitador y calificador

• Delimitador de campo: Ingresa el(los) carácter(es) que se utilizarán como delimitador(es) de campo que especifican el límite entre los campos de datos. El valor predeterminado es una coma. También puedes usar delimitadores de múltiples caracteres, como un doble pipe ||. Para usar una tabulación como delimitador, ingresa /t.

• Calificador de cadena y Usar calificador: Ingresa el carácter que se utilizará como envoltura, indicando una cadena de texto que debe tratarse como una única unidad de datos. El valor predeterminado es un carácter de comillas dobles. Si se deja vacío, no se utiliza ningún calificador de cadena.

  Al usar un Calificador de Cadena, selecciona una regla de negocio correspondiente, ya sea Siempre o Solo cuando sea necesario, para indicar cuándo debe usarse el calificador. Se recomienda el valor predeterminado, Solo cuando sea necesario, de modo que si el(los) carácter(es) especificados como el Delimitador de Campo ocurren dentro de la cadena, entonces la cadena se envuelve con el carácter calificador de cadena especificado. Si el delimitador no ocurre, entonces la cadena no se envuelve.

  Durante el procesamiento de fuentes, el calificador de cadena se elimina. Durante el procesamiento de destinos, se agrega el calificador de cadena.

• EDIFACT: Marca esta casilla si estás utilizando reglas de sintaxis EDIFACT dentro de tu archivo. Si no sabes qué es esta opción, déjala sin marcar.

• Usar saltos de línea para el final de registros: A partir de la versión 8.19, esta casilla se utiliza para activar o desactivar el uso de saltos de línea como separación entre registros. Por defecto, el final de los registros se denota por saltos de línea, de modo que cada registro existe en una línea (a menos que se use un calificador). Cuando está desactivado, se ignoran los saltos de línea y los nuevos registros comienzan después de que se alcanza el número total de campos.

  Nota

  Esta bandera es relevante solo para formatos de archivos de origen. Para archivos de destino, los saltos de línea siempre se utilizan para denotar el final de los registros.

• Convertir secuencias de escape: A partir de la versión 8.23, esta casilla se utiliza para convertir o ignorar secuencias de escape, como lo indica una barra invertida (\). Por defecto, las secuencias de escape se convierten de acuerdo con los estándares de Java. Cuando está desactivada, la conversión de texto ocurre sin interpretación de secuencias de escape.

  Nota

  Esta bandera es relevante solo para formatos de archivos de origen.

Definir segmentos

Haga clic en el botón Nuevo para definir el primer segmento del documento. Debe ingresar lo siguiente (requerido):

• Nombre del Segmento: Ingrese un nombre para el segmento.
• Padre del Segmento: Identifique el padre de este segmento desde el menú desplegable.

• Ocurrencia: Especifique cómo ocurrirá el segmento en su documento complejo eligiendo una de las opciones del menú desplegable:

  • Elija Solo Una Vez si este segmento debe ocurrir una vez pero solo una vez en el documento.
  • Elija Una o Más si este segmento debe ocurrir al menos una vez, pero también puede repetirse.
  • Elija Cero o Uno si este segmento puede no ocurrir, pero si lo hace, solo puede ocurrir una vez.
  • Elija Cero o Más si este segmento puede no ocurrir, pero si lo hace, puede ocurrir una o más veces.

Repita los pasos anteriores para cada segmento adicional que necesite definir.

Definir propiedades del segmento

Ahora que se han creado todos los segmentos, deberá definir los campos de cada segmento.

Haga doble clic en la columna # del segmento deseado, o con el segmento resaltado haga clic en el botón . Aparecerá el popup Segmento: Detalle.

Para cada segmento, haga clic en el botón Nuevo para definir los campos del segmento. Debe ingresar lo siguiente (requerido):

• Nombre del Campo: Ingrese un nombre para este campo.

• Tipo: Seleccione un tipo del menú desplegable. Las opciones incluyen Cadena, Entero, Fecha, Largo, Flotante, Doble, Booleano.

  Nota

  Si tiene dudas sobre el tipo de campo, se recomienda elegir String, ya que este tipo permite incluir cualquier tipo de dato como una cadena.

Los siguientes son opcionales:

• Predeterminado: Si desea que este campo tenga un valor predeterminado, ingrese el valor aquí.
• Formato: Si desea que este campo tenga un formato específico, como para fecha o moneda, ingrese el formato aquí.

Repita los pasos anteriores para cada campo de datos adicional que necesite definir.

Documento de texto complejo – anchos de campo fijos

Si ha seleccionado un documento de texto complejo que tiene anchos de campo fijos, su pantalla configurada debería verse similar a la de abajo. A continuación se presenta una explicación para cada sección configurable.

Definir segmentos

Haga clic en el botón Nuevo para definir el primer segmento del documento. Debe ingresar lo siguiente (requerido):

• Nombre del Segmento: Ingrese un nombre para el segmento.
• Padre del Segmento: Identifique el padre de este segmento desde el menú desplegable.

• Ocurrencia: Especifique cómo ocurrirá el segmento en su documento complejo eligiendo una de las opciones del menú desplegable:

  • Elija Solo Una Vez si este segmento debe ocurrir una vez pero solo una vez en el documento.
  • Elija Uno o Más si este segmento debe ocurrir al menos una vez, pero también puede repetirse.
  • Elija Cero o Uno si este segmento puede no ocurrir, pero si lo hace, solo puede ocurrir una vez.
  • Elija Cero o Más si este segmento puede no ocurrir, pero si lo hace, puede ocurrir una o más veces.

Repita los pasos anteriores para cada segmento adicional que necesite definir.

Definir propiedades del segmento

Ahora que se han creado todos los segmentos, necesitará definir los campos de cada segmento.

Ya sea haga doble clic en la columna # del segmento deseado, o con el segmento resaltado haga clic en el botón . Aparecerá la ventana emergente Segmento: Detalle.

Para cada segmento, haz clic en el botón Nuevo para definir los campos del segmento. Debes ingresar lo siguiente (requerido):

• Nombre del Campo: Ingresa un nombre para este campo.

• Tipo: Selecciona un tipo del menú desplegable. Las opciones incluyen Cadena, Entero, Fecha, Largo, Flotante, Doble, Booleano.

  Nota

  Si tienes dudas sobre el tipo de campo, se recomienda elegir Cadena, ya que este tipo permite incluir cualquier tipo de dato como una cadena.

• Inicio: Ingresa la posición del carácter inicial (1 se considera la posición para el inicio del archivo). Ten en cuenta que el valor predeterminado para las filas subsiguientes siempre será el siguiente carácter después de la posición final del campo anterior.

• Longitud: Ingresa el número de caracteres que están reservados para este campo.

  Nota

  Los archivos de texto de longitud fija siempre especifican un cierto número de caracteres que están reservados para cada campo. Por ejemplo, puedes identificar un campo llamado Apellido que siempre tiene 30 caracteres reservados para él. (Si el valor real es Smith, solo se utilizan 5 caracteres; los caracteres restantes no tienen nada en ellos.)

  Si has cambiado el valor de longitud de caracteres de algún campo, utiliza el botón para recalcular todas las posiciones iniciales de los campos.

  Advertencia

  El botón Calcular restablece todos los valores de los campos Inicio y Fin, basándose en los valores de Longitud que especificaste. No utilices este botón si las posiciones de los campos de tu archivo tienen huecos o superposiciones, ya que se eliminarán.

• Fin: Ingresa la posición del carácter final.

  Nota

  Por defecto, los segmentos de longitud fija se terminan con un carácter de nueva línea.

Los siguientes son opcionales:

• Predeterminado: Si deseas que este campo tenga un valor predeterminado, ingresa el valor aquí.

• Formato: Si deseas que este campo tenga un formato específico, como para fecha o moneda, ingresa el formato aquí.

Repite los pasos anteriores para cada campo de datos adicional que necesites definir.

Configurar campos desde un archivo de muestra

Para crear campos a partir de un archivo de muestra, en lugar de hacerlo manualmente, consulta Crear una definición de documento de texto a partir de un archivo de muestra.