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:
- Actualizar el esquema: Para todos los esquemas generados por el conector, excepto aquellos proporcionados en Database, NetSuite, Salesforce, Salesforce Service Cloud o ServiceMax activities, 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 Data Schema (ver Regeneración de esquemas de actividad a continuación).
- Dentro de una transformación, como una opción en el esquema de solicitud o respuesta (ver Regeneración de esquemas de transformación a continuación).
- Reconfigurar la actividad: Para todos los esquemas generados por el conector, incluidos aquellos proporcionados en Database, NetSuite, Salesforce, Salesforce Service Cloud y ServiceMax activities, se puede regenerar un esquema abriendo la configuración de actividad existente en Integration Studio y avanzando a través de cada paso de configuración de actividad. Seleccionar objetos o realizar otros cambios obliga a una actualización del esquema en el paso Data Schema (ver Regeneración de esquemas de actividad a continuación).
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: Puedes usar este método para todos los esquemas generados por conectores excepto para los esquemas proporcionados por Base de datos, NetSuite, Salesforce, Salesforce Service Cloud o actividades de ServiceMax.
-
Reconfigurar actividad: Puede utilizar este método para todos los esquemas generados por conectores.
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.
- Abra la configuración de la actividad.
- Vaya al paso Esquema de Datos (el último paso).
-
Haga clic en Actualizar:
Reconfigurar actividad (todos los conectores)
Para reconfigurar una actividad, complete estos pasos:
- Abra la configuración de la actividad.
- Pase por cada paso de configuración.
- 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.
-
El esquema se actualizará automáticamente en el paso Esquema de Datos.
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:
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.