Diseñador de actividades

Información general

El diseñador de actividades te permite previsualizar el diseño de tus actividades personalizadas de Integration Service tal y como aparecerán en UiPath® Studio.

Sus características clave incluyen:

• Vista previa del diseño: previsualiza el diseño de tus actividades personalizadas y observa cómo aparecerán en Studio. Puedes visualizar la configuración y realizar los ajustes necesarios antes de implementar tu conector.
• Configuración de parámetros: crea y gestiona campos de parámetros, para una mayor flexibilidad a la hora de personalizar tu actividad. Esto incluye argumentos de entrada, salida, entrada/salida y propiedades que se utilizan en tu flujo de trabajo.
• Campos de solicitud y respuesta: añade campos de solicitud y respuesta. Esto te ayuda a definir la información requerida por la actividad (solicitud) y la información que devolverá la actividad (respuesta).

Campos de entrada

Para configurar los recursos de un conector personalizado, utiliza la pestaña Parámetros para añadir campos específicos a tu tipo de solicitud. El diseñador de actividades recupera todos los parámetros y campos de las pestañas Parámetros o Campos de solicitud y los muestra en la sección Entrada .

La siguiente imagen muestra la pestaña Parámetros del recurso. Solo un campo está marcado como obligatorio:

Figura 1. Parámetros con un campo obligatorio

Figura 2. Campos de solicitud con un campo obligatorio

La siguiente imagen muestra la pestaña Campos de solicitud del recurso. Solo un campo está marcado como obligatorio:

La siguiente imagen muestra la pestaña Diseñador de actividades del recurso. El parámetro requerido y los campos de solicitud se muestran en la ventana Vista previa:

Parámetros de edición

Edita o elimina parámetros de la pestaña Diseñador de actividades haciendo clic en Más opciones menú.

Configura la ubicación de los parámetros y los campos de solicitud eligiendo una opción de Posición : Principal, Secundaria o Ninguna. Cuando estableces un campo como Obligatorio, su Posición se establece automáticamente como Principal y el campo se muestra en la sección principal del lienzo de la actividad.

Cambia la forma en que se muestra el parámetro en la ventana Vista previa (su nombre para mostrar y su descripción) haciendo clic en el botón Editar junto al nombre del parámetro.

Valores de los parámetros de entrada

En la pestaña Diseñador de actividades , puedes especificar la posición de un parámetro o campo en el lienzo de la actividad como Principal, Secundario o Ninguno. Cada opción dicta el comportamiento del parámetro y dónde se muestra en el lienzo de la actividad. Como alternativa, puedes marcar un campo como Obligatorio para establecer automáticamente su posición como Principal.

• Requerido: el parámetro o campo requiere un valor para ejecutar correctamente la actividad. El parámetro se marca como obligatorio mediante el símbolo de asterisco (*). Esto significa que siempre está visible en el lienzo y debes proporcionarle un valor.

  
  

  

  
  
• Principal: el parámetro se muestra en la sección principal de la actividad. Puede dejarse en blanco al utilizar la actividad en una automatización.
  
  

  

  
  
• Secundario: el parámetro está oculto en el lienzo principal. Se muestra en la sección Mostrar opciones adicionales . Estos campos son opcionales y pueden dejarse en blanco.
  
  

  

  
  
• Ninguno: el parámetro está oculto de la actividad. Debes utilizar el asistente Administrar propiedades para añadirlo al lienzo.

Ordenar parámetros de entrada

El orden de los parámetros de entrada dicta su ubicación en la ventana Vista previa de la actividad. Puedes cambiar el orden de visualización utilizando el icono situado en el extremo izquierdo de cada parámetro para arrastrar el elemento de la lista hacia arriba o hacia abajo.

Campos de solicitud

Los campos de solicitud te permiten rellenar el cuerpo de una solicitud HTTP.

Los campos de solicitud suelen estar asociados a solicitudes POST, PUT o PATCH (actividades de inserción, upsert o actualización de registros).

Rellenar campos de solicitud y respuesta

Hay dos formas de rellenar los campos de solicitud y respuesta.

Opción 1 (recomendada): usar un JSON con el formato correcto.

1. Haz clic en el botón Enviar solicitud de un recurso.
2. Añade el JSON.
3. Asegúrate de que la opción Sobrescribir campos al enviar solicitud está habilitada.
4. Selecciona Ejecutar.

Si la respuesta es correcta, los campos de entrada se rellenan con las propiedades JSON utilizadas para la solicitud y los campos de salida se rellenan en función de la respuesta.

Nota: Si utilizas este método, realiza una solicitud que sea exhaustiva de todos los campos que deseas utilizar en tu actividad.

La siguiente imagen muestra un ejemplo de carga útil para una solicitud POST . Ten en cuenta que el campo Sobrescribir campos en la solicitud de envío está habilitado:

Opción 2: añadir manualmente cada campo de solicitud y respuesta desde la pestaña Diseñador de actividades .

1. Ve a la pestaña Diseñador de actividades .
2. En la pestaña Entrada , haz clic en Más opciones menú.
3. Selecciona Añadir campo de solicitud.
4. Añade los detalles del campo de solicitud de forma similar a añadir un parámetro.
   
   

   

   
   
5. Para añadir campos de respuesta, ve a la pestaña Salida y selecciona la opción Añadir campo de respuesta .
   
   

   

   
   

Campos de salida

Los campos de Salida en el Diseñador de actividades se extraen de los campos de Respuesta. Los valores pueden rellenarse realizando correctamente una llamada al recurso.

Campos seleccionados

Puedes marcar los campos de salida como Seleccionados. El valor del campo se extrae específicamente del objeto de respuesta y se puede asignar a una variable, lo que facilita el acceso y el uso en otras actividades cuando se utiliza en una automatización.

La siguiente imagen muestra cómo Estado, el campo seleccionado, se muestra directamente en la sección Salida de la actividad: