Exportar e importar mapeos de transformación en Jitterbit Integration Studio

Introducción

Un mapeo consiste en todos los campos o nodos de destino y sus scripts correspondientes. Estos scripts pueden contener referencias a campos o nodos de origen o a componentes del proyecto, utilizar funciones o contener otra lógica de script válida. Un mapeo no incluye campos de destino que no están mapeados.

Después de completar un mapeo de transformación, se puede exportar el mapeo para referencia, para compartir fuera del proyecto o para reutilizar en otro lugar. Los mapeos que han sido exportados pueden ser importados en una transformación, con la capacidad de seleccionar si se sobrescriben los mapeos existentes.

Limitaciones

Dependiendo de la estructura del esquema, ciertas exportaciones e importaciones de mapeos de transformación no son compatibles, como se describe a continuación.

Esquemas con valores y atributos

No se admite la exportación e importación de un mapeo de transformación con esquemas que contengan valores que tengan al menos un atributo, como se indica visualmente con los símbolos # y @, respectivamente. Por ejemplo:

Esquemas con caracteres especiales

Al importar un mapeo exportado que incluye campos o nodos de destino cuyos nombres contienen caracteres especiales, se omiten los mapeos para esos campos y nodos de destino. Los mapeos para campos y nodos de destino que no contienen caracteres especiales se importan con éxito.

Se omiten los campos y nodos de destino cuyos nombres contienen cualquiera de estos caracteres especiales:

- . $ & #

Exportar un mapeo de transformación

Para iniciar el proceso de descarga, en cualquiera de los modos, haga clic en Exportar en la parte superior derecha de la estructura de destino:

El archivo exportado está en formato JSON y contiene cada nodo de destino y el contenido de cualquier script, si se incluye. Tenga en cuenta que las nuevas líneas se indican con \n. A continuación se incluye un ejemplo de exportación:

{
  "mappings": [
    {
      "targetNode": "json$",
      "script": ""
    },
    {
      "targetNode": "json$item.",
      "script": ""
    },
    {
      "targetNode": "json$item.userId$",
      "script": "<trans>\njson$item.userId$\n</trans>"
    },
    {
      "targetNode": "json$item.id$",
      "script": ""
    },
    {
      "targetNode": "json$item.title$",
      "script": ""
    },
    {
      "targetNode": "json$item.body$",
      "script": "<trans>\njson$item.title$\n</trans>"
    }
  ]
}

Importar un mapeo de transformación

Para comenzar el proceso de importación, haga clic en Importar en la parte superior derecha de la estructura de destino:

Esto abre un diálogo donde puede proporcionar el mapeo que se va a importar:

• Archivo: Haga clic en el botón Examinar a la derecha para seleccionar un archivo que contenga el mapeo. El archivo debe estar en formato JSON.
• Subir: Después de seleccionar un archivo, haga clic para subir el mapeo y proceder a la siguiente pantalla.
• Cancelar: Haga clic para cerrar el diálogo de importación sin subir un mapeo.

Después de subir un archivo, la siguiente pantalla proporciona una lista de conflictos de mapeo, si los hay, y presenta una interfaz para seleccionar qué mapeos utilizar:

• El campo de destino tiene un mapeo existente: Los campos de destino que ya tienen un mapeo existente que entra en conflicto con el que se está importando se enumeran a la izquierda. Seleccione las casillas de verificación de cualquier campo de destino cuyos mapeos desea reemplazar con los del archivo que se está importando. También puede hacer clic en Seleccionar Todo para seleccionar todos los campos, o Seleccionar Ninguno para desmarcar todos los campos.
• El campo de destino no existe: Los campos de destino que no existen en el mapeo actual pero que están incluidos en el archivo que se está importando no se pueden mapear. Estos campos se enumeran a la derecha.
• Continuar: Haga clic para proceder a utilizar las selecciones en esta pantalla para fusionar el mapeo importado con el mapeo existente y regresar a la pantalla de mapeo de transformación.
• Cancelar: Haga clic para cerrar la pantalla de conflictos de mapeo sin guardar. El mapeo existente permanece sin cambios.