Esquema plano personalizado en Jitterbit Integration Studio

Introducción

Un esquema plano (o esquema plano) es una estructura de campo simple, de un solo nivel, con el mismo tipo de fila de datos en todo el documento de texto. Esta página cubre la creación y edición de un esquema plano personalizado dentro de una transformación.

Crear un esquema plano personalizado

Los esquemas personalizados, incluidos los esquemas planos, se definen en las transformaciones. Para crear un esquema plano, primero crea una transformación.

La opción Constructor de esquemas planos está habilitada solo cuando una transformación no está heredando ya un esquema de una actividad adyacente. Si hay una actividad adyacente que permite la configuración de esquemas definidos por el usuario, no proporciones un esquema de solicitud o respuesta en la configuración de la actividad, ya que esto causaría que esos esquemas sean heredados por la transformación.

Siempre que se cumpla esta condición, el botón Constructor de esquemas planos se muestra en modo de mapeo en cada lado de la transformación que no tenga ya un esquema definido en una actividad. Haz clic en Constructor de esquemas planos en el lado de origen o destino de la transformación:

Editar un esquema plano

Para editar un esquema plano que ha sido definido en una transformación, utiliza las acciones de esquema en una transformación para seleccionar Editar esquema:

Al abrir un esquema que es referenciado por múltiples componentes, se muestra un diálogo con una lista de los componentes que hacen referencia al esquema y que se verán afectados por cualquier cambio:

Configurar un esquema plano

La configuración de un esquema utilizando el editor de esquema plano se cubre de la siguiente manera:

• Nombre del Esquema: En el cuadro de entrada de texto en la parte superior de la pantalla, ingresa un nombre para identificar el esquema plano.

• Estado de Guardado: A la derecha del nombre del esquema se encuentran la fecha y la hora en que se guardó por última vez la transformación asociada al esquema. Esta información no está asociada al esquema en sí, que se guarda utilizando el botón Guardar Cambios ubicado en la parte inferior de la configuración.

• Tipo: Selecciona entre dos tipos para un esquema plano personalizado:

  • Ancho Fijo: El esquema se creará en formato CSV utilizando la longitud para delimitar campos.
  • Delimitado por Caracteres: El esquema se creará en formato CSV utilizando caracteres para delimitar campos.

• Opciones: Cuando se selecciona Delimitado por Caracteres, estas opciones se vuelven disponibles:

  

  • Delimitador: Ingresa los caracteres que se usarán como delimitadores 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.

  • Saltos de Línea para el Fin de Registros: Selecciona esta casilla para usar saltos de línea para separar registros. Esta opción está seleccionada por defecto. Cuando esta opción está seleccionada, el fin 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á deshabilitada, 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 opción es relevante solo para esquemas utilizados en el lado de origen de una transformación. Para esquemas utilizados en el lado de destino de una transformación, los saltos de línea siempre se utilizan para denotar el fin de los registros.

  • Calificador de Cadena: Ingrese el carácter que se utilizará como envoltura, indicando una cadena de texto que debe ser tratada 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, seleccione Siempre o Cuando Sea Necesario para indicar cuándo debe usarse el calificador. Se recomienda el valor predeterminado, Cuando Sea Necesario, de modo que si los caracteres especificados como el Delimitador ocurren dentro de la cadena, entonces la cadena se envuelve con los caracteres 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.

  • Convertir Secuencias de Escape: Seleccione esta casilla para convertir o ignorar las secuencias de escape según lo indicado por una barra invertida \. Por defecto, las secuencias de escape se convierten siguiendo los estándares de Java. Cuando está deshabilitado, la conversión de texto ocurre sin interpretación de secuencias de escape.

    Nota

    Esta opción es relevante solo para esquemas utilizados en el lado de origen de una transformación.

• Agregar Campo: Haga clic para agregar nuevas filas de campo una a la vez a la tabla. Estas columnas están disponibles para cada fila:

  • #: A cada fila de campo se le asigna automáticamente un número en el orden en que aparece la fila. Para reordenar filas, arrastre y suelte en otra posición dentro de la tabla, o pase el cursor sobre el número y haga clic en la flecha hacia arriba o hacia abajo.

  • Campo: Ingrese un nombre para el campo. El nombre del campo no puede contener caracteres en blanco o símbolos como estos: @ $ % & / + ( ) : ; ,. Además, el nombre del campo no puede comenzar con un número, un punto (.) o un guion (-).

    Consejo

    Para referencia, consulte NCNameChar para los caracteres permitidos según lo definido por el W3C.

  • Tipo: Utiliza el menú desplegable para seleccionar un tipo de dato. Las opciones para nuevos esquemas personalizados son booleano, fecha, decimal, doble, flotante, entero, largo y cadena. El valor predeterminado es cadena. Si se creó un esquema personalizado mediante la replicación de un esquema de una actividad basada en servidor, pueden aparecer tipos de datos adicionales.

  • Inicio: Solo para esquemas de Ancho Fijo, ingresa la posición del carácter inicial. Ten en cuenta que 1 se considera la posición para el comienzo del archivo.

    El valor predeterminado para las filas subsiguientes es el siguiente carácter después de la posición final del campo anterior. Por ejemplo, si la posición final del campo anterior es 50, entonces la posición inicial del siguiente campo será 51.

  • Longitud: Solo para esquemas de Ancho Fijo, ingresa el número de caracteres que se reservarán para este campo. Cuando ya se han ingresado la posición del carácter inicial y la posición final, este campo se calcula automáticamente.

    Los archivos de texto de longitud fija siempre especifican un cierto número de caracteres que se reservan 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 contienen nada.

  • Fin: Solo para esquemas de Ancho Fijo, ingresa la posición del carácter final. Cuando ya se han ingresado la posición del carácter inicial y la longitud, este campo se calcula automáticamente.

    Nota

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

  • Valor 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í.

  • Acciones: Para las acciones que puedes realizar en una fila de campo existente, pasa el cursor sobre el campo en la parte derecha bajo el ícono del menú de acciones . Luego haz clic en el ícono de duplicar para duplicar la fila de campo, o haz clic en el ícono de eliminar para eliminar la fila de campo.

• Revisar esquema: A medida que defines manualmente cada campo dentro del esquema, se muestra una vista previa del esquema en el lado derecho. El esquema se muestra utilizando los elementos de interfaz estándar descritos en Nodos y campos.

• Guardar cambios: Haz clic para guardar y cerrar el esquema.

• Descartar cambios: Haz clic para cerrar el esquema sin guardar cambios.

Menú de acciones del esquema

Después de crear un esquema plano personalizado, puedes acceder a opciones de menú adicionales disponibles para todos los esquemas.

Estas incluyen Eliminar, Renombrar, Ver dependencias, Desplegar, Despliegue configurable, y Agregar a grupo, así como Editar esquema y Limpiar esquema. Para obtener detalles sobre estas acciones, consulta Menú de acciones del esquema.