Esquema Jerárquico Personalizado¶

Introducción¶

Un esquema jerárquico (o esquema jerárquico) es una estructura de archivo compleja con varios tipos de filas de archivo, como filas de encabezado o de resumen. Esta página cubre la creación y edición de un esquema jerárquico personalizado dentro de una transformación.

Crear un Esquema Jerárquico¶

Los esquemas personalizados, incluidos los esquemas jerárquicos, se definen en las transformaciones. Para poder crear un esquema jerárquico, primero crear una transformación.

La opción Definir esquema solo está visible cuando una transformación no está heredando 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 aún 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 jerárquico:

Editar un Esquema Jerárquico¶

Para editar un esquema jerárquico 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 Jerárquico¶

La configuración de un esquema mediante el editor de esquema jerárquico se describe a continuación:

• Nombre del esquema: Ingrese un nombre para usar para identificar el esquema jerárquico.

• 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 con el esquema en sí, que se guarda mediante el botón **Guardar cambios ubicado en la parte inferior de la configuración.

• Tipo: Seleccione entre los tipos disponibles para un esquema jerárquico personalizado:

  • XML: El esquema se creará en formato XML.
  • 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.

  Nota

  No se admite la creación de un esquema jerárquico en formato JSON.

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

  

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

  • Saltos de línea para el final de los registros: Seleccione esta casilla de verificación para utilizar saltos de línea para separar los registros. Esta opción está seleccionada de forma predeterminada. Cuando se selecciona esta opción, el final de los registros se indica mediante saltos de línea de modo que cada registro exista en una línea (a menos que se utilice un calificador). Cuando está deshabilitada, se ignoran los saltos de línea y los nuevos registros comienzan después de que se alcanza la cantidad total de campos.

    Nota

    Esta opción solo es relevante para los esquemas utilizados en el lado de origen de una transformación. Para los esquemas utilizados en el lado de destino de una transformación, siempre se utilizan saltos de línea para indicar el final de los registros.

  • Calificador de cadena: Ingrese el carácter que se utilizará como contenedor, indicando una cadena de texto que se tratará como una sola 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.

    Cuando utilice un Calificador de cadena, seleccione Siempre o Cuando sea necesario para indicar cuándo se debe utilizar el calificador. 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 entre los caracteres del calificador de cadena especificado. Si el delimitador no aparece, la cadena no se encierra.

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

  • Convertir secuencias de escape: Seleccione esta casilla de verificación para convertir o ignorar las secuencias de escape indicadas por 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 produce sin interpretación de secuencias de escape.

    Nota

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

  • EDIFACT: Seleccione esta casilla de verificación si los datos siguen el estándar EDIFACT de reglas de sintaxis.

• Agregar nodo: Haga clic en el botón Agregar nodo para agregar nuevos nodos a la tabla, uno por uno. Estas columnas están disponibles para cada fila de nodo:

  • #: A cada fila de nodo se le asigna automáticamente un número en el orden en que aparece la fila. Una vez que tenga al menos dos filas con el mismo padre en el árbol, pase el cursor sobre el número y haga clic en el botón flecha hacia arriba o hacia abajo. El nodo que actúa como nodo raíz (sin un padre) no se puede reordenar, ni tampoco se pueden reordenar los nodos a un nivel diferente en la estructura de árbol (en cambio, esto se puede hacer cambiando el padre del nodo).

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

    Consejo

    Para obtener una referencia sobre todos los caracteres no permitidos, consulte NCName según lo definido por W3C.

  • Padre: Utiliza el menú desplegable para seleccionar el padre del nodo. Ten en cuenta que no es posible seleccionar un nodo padre que genere una referencia circular.

  • Ocurrencia: Utiliza el menú desplegable para seleccionar cómo debe aparecer el nodo en el documento complejo:

    • Cero o Más: Selecciona esta opción si este nodo puede aparecer o no, pero si aparece, puede aparecer cualquier cantidad de veces.
    • Cero o Uno: Selecciona esta opción si este nodo puede aparecer o no, pero si aparece, puede aparecer solo una vez.
    • Uno o más: Seleccione esta opción si este nodo debe aparecer al menos una vez, pero también puede repetirse.
    • Exactamente una vez: Seleccione esta opción si este nodo debe aparecer una vez y solo una vez en el documento.

  • Campos: Se muestra la cantidad de campos definidos para el nodo. Para definir los campos del nodo, haga clic en el botón icono de edición a la derecha del número de campos. Esto abre un editor de campos para el nodo específico, de la siguiente manera.

    

    Nota

    Los nodos deben contener al menos un campo para poder asignarlos al completar un mapeo de transformación.

    

    • Ciclo de nodo: Haga clic en las flechas izquierda o derecha para recorrer los nodos en el esquema jerárquico para mostrar la tabla de campos del nodo seleccionado.

      • Atrás: Haz clic en el icono de cierre para volver a la tabla de nodos.

        Navegador de nodos: En la parte superior de la tabla hay un botón gris expandido que le permite cambiar la visualización de la tabla navegando a otro nodo:

        

    • Agregar campo: Haga clic para agregar nuevas filas de campo una a la vez a la tabla. Según el Tipo de esquema seleccionado, estas columnas están disponibles para cada fila de campo:

      • #: A cada fila de campo se le asigna automáticamente un número en el orden en que aparece la fila. 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 botón flecha hacia arriba o hacia abajo.

      • Campo: Ingrese 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 guión (-).

        Consejo

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

      • Tipo: Use el menú desplegable para seleccionar un tipo de datos. 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 desde una actividad basada en servidor, se pueden incluir tipos de datos adicionales.

      • Inicio: Solo para esquemas de Ancho fijo, ingrese la posición del carácter inicial. Tenga 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, la posición inicial del siguiente campo será 51.

      • Longitud: Solo para esquemas de Ancho fijo, ingrese la cantidad de caracteres que se reservarán para este campo. Cuando ya se ingresaron la posición inicial y la posición final del carácter, este campo se calcula automáticamente.

        Los archivos de texto de longitud fija siempre especifican una cierta cantidad de caracteres que se reservan para cada campo. Por ejemplo, puede identificar un campo llamado LastName que 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, ingrese la posición del carácter final. Cuando ya se ingresaron la posición y la longitud del carácter inicial, este campo se calcula automáticamente.

        Nota

        De manera predeterminada, los segmentos de longitud fija terminan con un carácter de nueva línea.

      • Valor predeterminado: Para los esquemas Ancho fijo o Delimitado por caracteres, si desea que este campo tenga un valor predeterminado, ingrese el valor aquí.

      • Formato: Para los esquemas de Ancho fijo o Delimitado por caracteres, si desea que este campo tenga un formato específico, como fecha o moneda, ingrese el formato aquí.

      • Acciones: Para las acciones que puede realizar en una fila de 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: A medida que define 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: Haga clic para guardar y cerrar el esquema.

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

  • Acciones: Para las acciones que puede realizar en una fila de nodo 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 nodo, o haga clic en el eliminar icono para eliminar la fila del nodo.

• Revisar esquema: A medida que define manualmente cada nodo 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.

  Precaución

  Si ha creado nodos que no tienen ningún campo, entonces no podrá asignar ningún campo dentro de estos nodos al completar una asignación de transformación.

• 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 jerárquico personalizado, puede acceder a opciones de menú adicionales que están 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 detalles sobre estas acciones, consulte menú de acciones del esquema.