Saltar al contenido

Regeneración de esquemas en Jitterbit Integration Studio

Introducción

Los esquemas se generan de dos maneras. Dependiendo del conector específico que se esté utilizando, sus esquemas son generados por el conector o definidos por el usuario:

  • Generados por el conector: Los esquemas generados por el conector están fijos en el conector o se generan directamente desde el endpoint.

  • Definidos por el usuario: Los esquemas definidos por el usuario son proporcionados por el usuario, ya sea creando un esquema personalizado, subiendo un archivo o URL, o ingresando manualmente el esquema.

Esta página proporciona información sobre la regeneración de esquemas para ambos tipos de esquemas.

Esquemas generados por el conector

Un esquema generado por el conector está fijo en el conector o utiliza metadatos de la API del endpoint correspondiente. Esto difiere de un esquema definido por el usuario.

Cuando se configura un esquema generado por el conector, Integration Studio almacena los esquemas dentro del proyecto. Este almacenamiento permite una carga más rápida durante el diseño del proyecto.

Si ocurren cambios externos en un esquema que se genera desde un endpoint, es necesario regenerar el esquema dentro de Integration Studio para utilizar esos cambios en el proyecto. Puede ser necesario regenerar esquemas en las siguientes situaciones:

  • Se agregó un campo personalizado al endpoint.
  • Se actualizó la instancia para usar una versión más reciente de la API.

Se pueden regenerar esquemas de dos maneras, dependiendo del endpoint:

Cuando Integration Studio actualiza un esquema que está fijo en un conector, se vuelve a cargar el esquema actual incluido con el conector. Este proceso efectivamente actualiza el esquema.

Cuando regeneras o actualizas un esquema desde una actividad o transformación, Integration Studio actualiza el esquema en todas las ubicaciones donde se hace referencia. Por ejemplo, si has referenciado múltiples copias de la misma actividad en diferentes lugares a lo largo del proyecto, actualizar el esquema en la configuración de la actividad o seguir los pasos de configuración de la actividad en un lugar lo actualiza para todas las ubicaciones. De manera similar, si actualizas un esquema en una transformación, esta acción lo actualiza en la actividad y en todos los lugares dentro del proyecto donde se hace referencia a la misma actividad.

Si un esquema tiene cambios en el sistema del endpoint pero aún no has regenerado el esquema ni en la actividad ni en la transformación, la operación puede tener éxito o fallar. El éxito depende de varios factores, incluyendo el endpoint individual, los campos individuales que están mapeados en la transformación y si esos campos han cambiado dentro del esquema. Por ejemplo, si un campo requerido en el esquema original se elimina más tarde en el esquema actualizado, es probable que el sistema del endpoint informe errores en tiempo de ejecución. Sin embargo, si un campo ha sido eliminado pero es opcional en el mapeo, el sistema puede no informar errores.

Regeneración del esquema de actividad

El método para regenerar esquemas depende de qué conector estés utilizando:

Actualización directa (la mayoría de los conectores)

Para actualizar directamente un esquema, complete estos pasos:

Nota

No puede utilizar esta opción para esquemas proporcionados por Database, NetSuite, Salesforce, Salesforce Service Cloud o ServiceMax activities. En su lugar, reconfigure la actividad.

  1. Abra la configuración de la actividad.
  2. Vaya al paso Esquema de Datos (el último paso).
  3. Haga clic en Actualizar:

    ServiceNow create step 2 data schema refresh

Reconfigurar actividad (todos los conectores)

Para reconfigurar una actividad, complete estos pasos:

  1. Abra la configuración de la actividad.
  2. Pase por cada paso de configuración.
  3. Realice al menos un cambio para forzar una actualización del esquema. Por ejemplo, puede agregar o eliminar un carácter del nombre de la actividad.
  4. El esquema se actualizará automáticamente en el paso Esquema de Datos.

    database insert step 1 select table next

    database insert step 2 data schema finished

Regeneración de esquema de transformación

Para regenerar un esquema generado por un conector a partir de una transformación (excepto para esquemas proporcionados por Database, Salesforce, Salesforce Service Cloud o ServiceMax activities), haga clic en Actualizar Esquema:

menú de acciones del esquema de destino actualizar esquema

Esquemas definidos por el usuario

Un esquema definido por el usuario (en contraste con un esquema generado por un conector) se refiere a un punto final cuyos esquemas son proporcionados por el usuario, ya sea creando un esquema personalizado, subiendo un archivo o URL, o ingresando manualmente el esquema.

Los cambios en los esquemas definidos por el usuario se propagan automáticamente a todas las referencias de 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:

Texto del diálogo

Esquema utilizado por múltiples componentes
Este esquema es utilizado por múltiples componentes. Cualquier cambio realizado en él podría afectar la validez de estos componentes:

  • Componente 1

  • Componente 2

Si no desea que los cambios se propaguen a todos los lugares donde se hace referencia al esquema, primero debe editar la configuración de esos componentes para eliminar o reemplazar la referencia al esquema.

Proyectos anteriores a 10.33.2

Los esquemas definidos por el usuario referenciados por múltiples transformaciones en proyectos creados antes de la versión 10.33.2 de Harmony se renombran automáticamente utilizando esta convención de nomenclatura:

<Nombre del Esquema Original>_<Nombre de la Transformación>_<Origen o Destino>

La convención de nomenclatura consiste en estos componentes:

  • Nombre del Esquema Original: El nombre original del esquema antes de 10.33.2.
  • Nombre de la Transformación: El nombre de la transformación en la que se hace referencia al esquema.
  • Origen o Destino: Si el esquema se utiliza en el lado de origen o destino de la transformación.