Esquema personalizado en Jitterbit Integration Studio

Introducción

Un esquema plano (o esquema plano) es una estructura de campos simple de un solo nivel con el mismo tipo de fila de datos en todo el documento de texto. Esta página explica cómo crear y editar un esquema plano personalizado dentro de una transformación.

Crear un esquema plano personalizado

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

La opción Definir esquema solo está visible cuando una transformación no hereda un esquema de una actividad adyacente. Si una actividad adyacente permite la configuración de esquemas definidos por el usuario está presente, no proporcione un esquema de solicitud o respuesta en la configuración de la actividad, ya que esto provocaría que la transformación heredara esos esquemas.

Si se cumple esta condición, el botón Definir esquema se muestra en modo de mapeo en cada lado de la transformación que no tenga un esquema definido en una actividad. Haga clic en Definir esquema en el lado de origen o destino de la transformación y seleccione Crear plano.

Editar un esquema plano

Para editar un esquema plano que se ha definido en una transformación, utilice el menú de acciones del esquema en una transformación para seleccionar Editar esquema:

Al abrir un esquema al que hacen referencia varios componentes, un cuadro de diálogo muestra una lista de todos 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 mediante el editor de esquema planos se describe a continuación:

• Nombre del esquema: En el cuadro de ingreso de texto en la parte superior de la pantalla, ingrese un nombre para usar para identificar el esquema plano.

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

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

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

• Opciones: Cuando se selecciona Caracteres delimitados, estas opciones estarán disponibles:

  

  • Delimitador: Introduzca los caracteres que se usarán como delimitadores de campo para especificar el límite entre los campos de datos. El valor predeterminado es una coma. También puede usar delimitadores de varios caracteres, como una barra vertical doble. ||Para utilizar una pestaña como delimitador, introduzca \t.

  • Saltos de línea al final de los registros: Seleccione esta casilla para usar saltos de línea para separar los registros. Esta opción está seleccionada por defecto. Al seleccionar esta opción, los finales de los registros se indican con saltos de línea, de modo que cada registro ocupa una sola línea (a menos que se use un calificador). Al deshabilitarla, se ignoran los saltos de línea y los nuevos registros comienzan una vez alcanzado el número total de campos.

    Nota

    Esta opción solo es relevante para los esquemas utilizados en el origen de una transformación. En el destino de una transformación, los saltos de línea siempre indican el final de los registros.

  • Calificador de cadena: Introduzca el carácter que se usará como contenedor, indicando una cadena de texto que se tratará como una sola unidad de datos. El valor predeterminado es una comilla doble. 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. Se recomienda el valor predeterminado, Cuando sea Necesario, de modo que si los caracteres especificados como Delimitador aparecen dentro de la cadena, esta se encierra con los caracteres del calificador de cadena especificado. Si el delimitador no aparece, la cadena no se encierra.

    Durante el procesamiento de los orígenes, se elimina el calificador de cadena. Durante el procesamiento de los destinos, se añade.

  • Convertir secuencias de escape: Seleccione esta casilla de verificación para convertir o ignorar las secuencias de escape como se indica con una barra invertida \ De forma predeterminada, las secuencias de escape se convierten siguiendo los estándares de Java. Cuando está deshabilitada, la conversión de texto se realiza sin interpretación de las secuencias de escape.

    Nota

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

• Añadir campo: Haga clic para añadir nuevas filas de campo a la tabla, una por una. Estas columnas están disponibles para cada fila:

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

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

    Consejo

    Para referencia, consulte NCNameChar para los caracteres permitidos según la definición del W3C.

  • Tipo: Utilice el menú desplegable para seleccionar un tipo de dato. Las opciones para nuevos esquemas personalizados son boolean, date, decimal, double, float, integer, long, y string El valor predeterminado es string Si se creó un esquema personalizado mediante duplicación de un esquema de una actividad basada en servidor, se pueden listar tipos de datos adicionales.

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

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

  • Longitud: Solo para esquemas de Ancho Fijo, introduzca el número de caracteres que se reservarán para este campo. Si ya se han introducido las posiciones inicial y final de los caracteres, este campo se calcula automáticamente.

    Los archivos de texto de longitud fija siempre especifican una cantidad determinada de caracteres reservados para cada campo. Por ejemplo, puede identificar un campo llamado LastName Siempre tiene 30 caracteres reservados. Si el valor real es "Smith", solo se utilizan 5 caracteres; los caracteres restantes no tienen nada.

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

    Nota

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

  • Valor predeterminado: Si desea que este campo tenga un valor predeterminado, introdúzcalo aquí.

  • Formato: Si desea que este campo tenga un formato específico, como fecha o moneda, introdúzcalo aquí.

  • Acciones: Para ver las acciones que puede realizar en una fila de un campo existente, pase el cursor sobre el campo en el extremo derecho, debajo del icono del menú de acciones. Luego haga clic en el Icono duplicado para duplicar la fila del campo o haga clic en el Eliminar icono para eliminar la fila del campo.

• Revisar esquema: Al definir manualmente cada campo del esquema, se muestra una vista previa del esquema a la derecha. El esquema se muestra utilizando los elementos de interfaz estándar descritos en Nodos y campos.

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

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

Menú de acciones del esquema

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

Estas incluyen Eliminar, Cambiar nombre, Ver dependencias, Desplegar, Despliegue configurable y Agregar al grupo, así como Editar esquema y Borrar esquema. Para obtener más información sobre estas acciones, consulte el menú de acciones del esquema.