Saltar al contenido

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 inicialmente son 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.

Cuando Se Utiliza un Esquema

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

Fuentes

Una actividad fuente es cualquier actividad que proporciona datos dentro de una operación, que luego puede transferirse a un objetivo sin cambios o cambiarse 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 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 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 transformación.
  • Si la actividad objetivo 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 objetivo 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 mientras se configura 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
  • Insertar
  • 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 desde entonces se ha eliminado) 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:

diagrama de definición de esquema anotado pp

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 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 tanto un esquema de solicitud como de respuesta. Los esquemas generados por conectores 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:

    nombres de esquema anotados

    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 propio extremo.

    Un usuario no puede editar los nombres de los esquemas generados por el conector.

  • Definido por el usuario: Los esquemas definidos por el usuario los proporciona 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, un esquema de solicitud y 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 utilizan en una operación, las actividades que tienen un esquema de solicitud no necesariamente deben estar precedidas por 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 un origen 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 de 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, la transformación anterior hereda el esquema de solicitud de actividad como 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 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.