Uso de esquemas en Jitterbit Integration Studio

Introducción

Los esquemas se utilizan para representar las estructuras de solicitud y respuesta en una transformación. Esos esquemas se pueden heredar de actividades que inicialmente son adyacentes a la transformación o se pueden definir directamente en una transformación. En esta página se describe cuándo se utilizan los esquemas y cómo se definen.

Cuando se utiliza un esquema

El uso de un esquema depende de la actividad y de si se utiliza como fuente o como destino de una transformación.

Fuentes

Una actividad de origen es cualquier actividad que proporciona datos dentro de una operación, que luego puede transferirse a un destino sin cambios o modificados mediante una transformación antes de alcanzar un objetivo.

Las actividades de origen requieren un esquema de datos solo si se utilizarán como entrada en una transformación:

Si la actividad de origen proporciona datos que se transformarán, debe tener un esquema de datos de respuesta, que se proporciona automáticamente o se puede definir al configurar la actividad o la transformación.
Si la actividad de origen proporciona datos que no se transformarán, no es necesario definir un esquema de respuesta, ya que esquema no se utiliza en la operación.

Las actividades que normalmente (pero no necesariamente) se utilizan como fuentes incluyen aquellas que tienen una de estas palabras en el nombre de la actividad:

Descargar
Conseguir
Leer
Pedido
Consulta

Objetivos

Una actividad objetivo es cualquier actividad que recibe datos dentro de una operación. Estos datos pueden provenir de una actividad fuente, de una transformación, o de otra entrada como variables o secuencias de comandos.

Las actividades de destino requieren un esquema de datos solo si reciben datos que se han transformado o si proporcionan una respuesta que desea escribir en otro destino:

Si la actividad de destino recibe datos que se han transformado, debe tener un esquema de datos de solicitud, que se proporciona automáticamente o se puede definir al configurar la actividad o la transformación.
Si la actividad de destino recibe datos que no se han transformado, no es necesario definir un esquema de solicitud, ya que esquema no se utiliza en la operación.
Si un tipo específico de actividad de destino proporciona una respuesta, también puede tener un esquema de datos de respuesta. Si desea escribir la respuesta en otro destino, el esquema de datos de respuesta se proporciona automáticamente o se puede definir al configurar la actividad o transformación. Si el tipo de destino proporciona una respuesta, no se requiere una operación para escribir la respuesta en otro destino; es decir, se puede proporcionar un esquema de respuesta, pero se puede ignorar dentro de la operación si no es necesario.

Las actividades que normalmente (pero no necesariamente) se utilizan como objetivos incluyen aquellas que tienen una de estas palabras en el nombre de la actividad:

Agregar
Crear
Borrar
Insertar
Correo
Poner
Respuesta
Subir
Actualizar
Inserción posterior
Escribir

Cómo se definen los esquemas

Los esquemas se definen en una actividad o en una transformación. En una operación, un esquema proporcionado en una actividad adyacente (o una actividad inicialmente adyacente que luego se eliminó) tiene prioridad sobre un esquema definido en una transformación.

Los esquemas definidos en una actividad pueden ser generados por el conector o definidos por el usuario:

Generado por el conector: Los esquemas generados por el conector están fijados en el conector o se generan directamente desde el extremo. Según la actividad específica, se puede proporcionar un esquema de solicitud o de respuesta, o ambos. Los esquemas generados por el conector tienen un nombre generado automáticamente que depende de si el esquema es una solicitud o una respuesta:
```
User-defined Endpoint Name→User-defined Activity Name→Request
```
```
User-defined Endpoint Name→User-defined Activity Name→Response
```
Esta transformación muestra los nombres de los esquemas generados por el conector que se heredan de las actividades tanto en su lado de origen como de destino:

Dependiendo del conector, la estructura de algunos esquemas generados por el conector puede ser editada por el usuario, o la estructura puede cambiar dinámicamente según la entrada del usuario proporcionada durante la configuración de la actividad o según los cambios en el extremo en sí.

Los nombres de los esquemas generados por el conector no pueden ser editados por un usuario.
Definido por el usuario: Los esquemas definidos por el usuario son proporcionados por el usuario, ya sea mediante la creación de un esquema personalizado, la carga de un archivo o URL o la introducción manual del esquema. Según la actividad específica, se puede definir un esquema de solicitud o de respuesta, tanto un esquema de solicitud como de respuesta, o ningún esquema.

Los nombres de los esquemas definidos por el usuario se basan en el nombre del archivo proporcionado o son definidos por el usuario.

Cuando se utilizan en una operación, las actividades que tienen un esquema de solicitud no necesariamente deben ir precedidas de una transformación. De manera similar, las actividades que tienen un esquema de respuesta no necesariamente deben ir seguidas de una transformación. En algunos casos, como una operación diseñada para archivar archivos desde una fuente de datos a un destino sin una transformación, no se requieren esquemas; si se especifican, simplemente se ignoran.

En una operación, si una transformación requiere un esquema de origen, debe estar precedida por una actividad que proporcione un esquema de respuesta. Otras reglas y patrones para construir una operación válida se tratan en Validez de la operación.

Los esquemas de solicitud y respuesta proporcionados por la actividad siempre anulan los esquemas de origen y destino proporcionados por la transformación, si están presentes:

esquema de respuesta proporcionado por la actividad: Cuando una actividad de conector con un esquema de respuesta se coloca antes de una transformación, la transformación hereda el esquema de respuesta de la actividad como esquema de origen y anula cualquier esquema proporcionado por la transformación.
esquema de solicitud proporcionado por la actividad: Cuando una actividad de conector con un esquema de solicitud se coloca después de una transformación, el esquema de solicitud de actividad es heredado por la transformación anterior como el esquema de destino y anula cualquier esquema proporcionado por la transformación.

Todas las transformaciones son reutilizables independientemente de dónde provengan sus esquemas. Sin embargo, existen consideraciones especiales al hacer referencia en otra operación a una transformación que tiene un esquema proporcionado por una actividad, como se describe en Reutilización de Transformación.

Si un esquema proporcionado por la transformación estaba presente antes de la configuración de una actividad adyacente, ese esquema no se puede borrar directamente. Aunque la transformación sigue haciendo referencia a un esquema proporcionado por la transformación, no se utiliza en el procesamiento. Para borrar un esquema proporcionado por la transformación en estas circunstancias, puede eliminar temporalmente primero la actividad adyacente. Una vez que se elimina la actividad adyacente, se puede borrar un esquema proporcionado por la transformación mediante el menú de acciones del esquema para seleccionar Borrar esquema. Una vez que haya borrado el esquema proporcionado por la transformación, puede reemplazar la actividad en la operación.