Regeneración de esquemas en Jitterbit Integration Studio

Introducción

Los esquemas se generan de dos maneras. Dependiendo del conector específico utilizado, sus esquemas son generados por el conector o definido por el usuario:

• Generado por el conector: Los esquemas generados por el conector se fijan en el conector o se generan directamente desde el extremo.

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

Esta página proporciona información sobre cómo regenerar esquemas para ambos tipos de esquema.

Esquemas generados por conectores

Un esquema generado por un conector (en contraste con un esquema definido por el usuario) está fijo en el conector o el conector interactúa con ese extremo según la configuración del usuario utilizando los metadatos proporcionados por la API del punto final correspondiente.

Una vez que se configura un esquema generado por conector, Integration Studio almacena los esquemas dentro del proyecto para facilitar una carga más rápida durante el diseño del proyecto.

Si se generan cambios externos en un esquema desde un extremo, debe esquema en Integration Studio para aplicar dichos cambios al proyecto. Esto puede ser necesario si, por ejemplo, ha añadido un campo personalizado o ha actualizado su instancia para usar una versión posterior de la API.

Dependiendo del extremo, hay dos formas de regenerar esquemas:

• Actualizar el esquema: Para todos los esquemas generados por el conector, excepto aquellos proporcionados en Base de datos, NetSuite, Salesforce, Salesforce Service Cloud, o actividades de ServiceMax, Integration Studio incluye la opción de actualizar los esquemas en estas pantallas de configuración de componentes:
  • Dentro de una configuración de actividad, en el paso Esquema de datos (vea Regeneración del esquema de actividad abajo).
  • Dentro de una transformación, como una opción en el esquema de solicitud o respuesta (vea Regeneración del esquema de Transformación a continuación).
• Reconfigurar la actividad: Para todos los esquemas generados por el conector, incluidos los proporcionados en Base de datos, NetSuite, Salesforce, Salesforce Service Cloud y actividades de ServiceMax, puede regenerar un esquema abriendo la configuración de la actividad de Integration Studio y avanzando por cada paso de configuración. Seleccionar objetos o realizar otros cambios fuerza la actualización del esquema en el paso Esquema de datos (consulte Regeneración del esquema de la actividad#schemaregeneration-activity) abajo).

Cuando se actualiza un esquema generado desde un extremo, Integration Studio utiliza la API proporcionada por el extremo para regenerar el esquema para esa actividad.

Cuando se actualiza un esquema fijo en un conector, se vuelve a cargar el esquema actual incluido con el conector, lo que actualiza efectivamente el esquema.

Al regenerar o actualizar un esquema desde una actividad o transformación, esquema se actualiza en todas las ubicaciones donde se referencia. Es decir, si ha referenciado varias copias de la misma actividad en diferentes ubicaciones del proyecto, al actualizar el esquema en la configuración de la actividad o al avanzar por los pasos de configuración de la actividad en un solo lugar, se actualiza para todos. De igual forma, si actualiza un esquema en una transformación, esta acción lo actualiza en la actividad y en todas las ubicaciones del proyecto donde se referencia la misma actividad.

Si un esquema presenta cambios en el sistema del endpoint, pero aún no se ha regenerado en la esquema ni en la transformación, la operación podría no ser exitosa. Esto depende de diversos factores, como el extremo, los campos asignados en la transformación y si dichos campos han cambiado dentro del esquema. Por ejemplo, si un campo obligatorio del esquema original se elimina posteriormente en el esquema actualizado, es probable que se informen errores del sistema del extremo en tiempo de ejecución. Sin embargo, si un campo se ha eliminado, pero es opcional en la asignación, es posible que no se informen errores.

Regeneración del esquema de actividad

Para regenerar un esquema generado por un conector desde una pantalla de configuración de actividad (excepto los esquemas proporcionados por Base de datos, NetSuite, Salesforce, Salesforce Service Cloud, o actividades de ServiceMax), en el paso Esquema de datos, haga clic en Actualizar:

Para regenerar un esquema generado por un conector desde una pantalla de configuración de actividad (incluidos los esquemas proporcionados por Base de datos, NetSuite, Salesforce, Salesforce Service Cloud y actividades de ServiceMax), abra la configuración de la actividad y avance por cada paso. Debe realizar al menos un cambio (como añadir o quitar un carácter al final del nombre de la actividad) en la configuración para forzar la actualización del esquema en el paso Esquema de datos.

Regeneración del esquema de Transformación

Para regenerar un esquema generado por un conector a partir de una transformación (excepto los esquemas proporcionados por Base de datos, Salesforce, Salesforce Service Cloud, o actividades de ServiceMax), haga clic en el esquema Icono de engranaje para abrir un menú. En el menú, seleccione Actualizar esquema:

Esquemas definidos por el usuario

Un esquema definido por el usuario (en contraste con un esquema generado por conector) se refiere a un extremo cuyos esquemas son proporcionados por el usuario, ya sea creando un esquema personalizado, cargando 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 referenciado por varios componentes, un cuadro de diálogo muestra una lista de los componentes que hacen referencia al esquema y que se verán afectados por los cambios:

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

Proyectos anteriores a 10.33.2

Los esquemas definidos por el usuario a los que hacen referencia 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:

<Original Schema Name>_<Transformation Name>_<Source or Target>

La convención de nomenclatura consta de estos componentes:

• Nombre del esquema original: El nombre original del esquema anterior a 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 de destino de la transformación.