Diseñador de actividades

Información general

El diseñador de actividades es una nueva característica del Creador de conectores. 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. Ahora, el diseñador de actividades recupera todos los campos de parámetros 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:

La siguiente imagen muestra la pestaña Diseñador de actividades del recurso. Los mismos parámetros se enumeran a la izquierda, pero solo el campo marcado como Obligatorio se muestra 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ú.

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 marcar cada campo de entrada como Obligatorio, Principal o Adicional. Cada opción dicta el comportamiento del parámetro y dónde se muestra en el lienzo de la actividad.

• Obligatorio: el parámetro se marca como obligatorio mediante el símbolo de asterisco (*). Esto significa que siempre está visible en el lienzo y se debe proporcionar un valor para él.

  
  

  

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

  

  
  
• Adicional: 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.
  
  

  

  
  

Ordenar parámetros de entrada

El orden de los parámetros de entrada dicta la ubicación de los parámetros en la ventana Vista previa de la actividad. Puedes cambiar el orden utilizando el botón Arrastrar situado junto a cada parámetro.

Por ejemplo, para mover el campo Cuando a la parte superior de la sección Entrada , arrastre el campo correspondiente icono arriba.

En la ventana Vista previa de la actividad, los campos se muestran en el orden indicado en la pestaña Entrada dependiendo del grupo al que estén asignados (Requerido, Principal y Adicional).

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). Si añades un campo de solicitud a una solicitud GET o DELETE (enumerar, obtener o eliminar actividades), se muestra un mensaje de error que te notifica que el campo no aparecerá para esa operación.

La siguiente imagen muestra el mensaje de error que se muestra al intentar añadir un campo de solicitud a un recurso DELETE :

Rellenar campos de solicitud y respuesta

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

Opción 1 (recomendada)

Utilice un JSON con el formato adecuado.

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. Haz clic en 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, asegúrate de realizar 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

Puedes 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 solicitud 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 Url, el campo seleccionado, se muestra directamente en la sección Salida de la actividad: