Uso del Esquema¶

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 son inicialmente adyacentes a la transformación, o se pueden definir directamente en una transformación. Esta página describe cuándo se utilizan los esquemas y cómo se definen los esquemas.

Cuando Se Utiliza un Esquema¶

La utilización de un esquema depende de la actividad y de si se utiliza como origen o como destino de una transformación.

Fuentes¶

Una actividad fuente es cualquier actividad que proporciona datos dentro de una operación, que luego se puede transferir a un destino sin cambios o modificado por 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 el esquema de respuesta no se utiliza en la operación.

Las actividades que normalmente (pero no necesariamente) se usan como fuentes incluyen aquellas con 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 el esquema de solicitud 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 la 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 usan como objetivos incluyen aquellas con una de estas palabras en el nombre de la actividad:

• Agregar
• Crear
• Borrar
• Insertar
• Correo
• Poner
• Respuesta
• Subir
• Actualizar
• Upsert
• Escribir

Cómo Se Definen los Esquemas¶

Los esquemas se definen ya sea 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 se eliminó desde entonces) tiene prioridad sobre un esquema definido en una transformación.

Este diagrama muestra una operación cuya transformación hereda su esquema de origen de una actividad adyacente anterior y tiene un esquema de destino definido por la transformación:

Los esquemas definidos en una actividad pueden ser generados por un conector o definidos 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. Dependiendo de la actividad específica, se puede proporcionar un esquema de solicitud o de respuesta, o un esquema de solicitud y de respuesta. 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 el lado de origen como en el de destino:

  

  Según el conector, el usuario puede editar la estructura de algunos esquemas generados por el conector, 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 propio extremo.

  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 creando un esquema personalizado, cargando un archivo o URL, o ingresando manualmente el esquema. Dependiendo de 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 están definidos por el usuario.

Cuando se usan en una operación, las actividades que tienen un esquema de solicitud no necesariamente tienen que estar precedidas por una transformación. Del mismo modo, 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 de un origen de datos a un destino sin 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 ir precedida de 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 respuesta y solicitud 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 se coloca una actividad de conector con un esquema de respuesta antes de una transformación, la transformación hereda el esquema de respuesta de la actividad como el esquema de origen y anula cualquier esquema proporcionado por la transformación.
• esquema de solicitud proporcionado por la actividad: Cuando se coloca una actividad de conector con un esquema de solicitud después de una transformación, la transformación anterior hereda el esquema de solicitud de actividad 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 cuando se hace 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 un esquema proporcionado por la transformación permanece referenciado por la transformación, no se usa en el procesamiento. Para borrar un esquema proporcionado por la transformación en estas circunstancias, primero puede eliminar temporalmente la actividad adyacente. Una vez que se elimina la actividad adyacente, se puede borrar un esquema proporcionado por la transformación usando el menú de acciones de 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.