Utilizar el Activity Creator

Las actividades son los bloques de construcción de la automatización de procesos. Cada uno contiene una acción atómica que, junto con otras actividades, compone un flujo de trabajo.

UiPath Studio incluye una serie de actividades prediseñadas que puedes instalar a través del Gestor de paquetes.

Además, puedes crear tus propias actividades personalizadas específicas para tus necesidades utilizando la extensión Activity Creator de UiPath para Visual Studio. Los siguientes pasos le proporcionarán la base para crear actividades personalizadas en tan solo 5 minutos. En esta sección, crearemos un paquete de actividades y, en la siguiente, lo rellenaremos con actividades funcionales.

Qué necesitará

• Visual Studio Community/Professional/Enterprise 2022 con el desarrollo de escritorio *.NET
• carga de trabajo instalada
• Fuente de UiPath Marketplace (https://gallery.uipath.com/api/v3/index.json) como fuente de paquete en Visual Studio. Consulta aquí las instrucciones sobre cómo añadir fuentes de paquetes.
• .NET 6
• UiPath Studio

Importante:

Ten en cuenta que la versión 4.0 del Creador de actividades solo funciona con Visual Studio 2022. Del mismo modo, las actividades producidas están destinadas a proyectos .NET 6 Windows. Para crear actividades compatibles con versiones anteriores de Visual Studio o .NET, use la versión 3 de la extensión.

Además, las actividades creadas por esta extensión dependen de las bibliotecas creadas por UiPath actualmente disponibles en la fuente de Marketplace (https://gallery.uipath.com/api/v3/index.json). Esta fuente debe estar disponible en Visual Studio durante el desarrollo o las actividades no se compilarán correctamente.

Paso 1: añadir la extensión de UiPath Activity Creator a Visual Studio

Abre Visual Studio y haz clic en Extensiones > Administrar extensiones.

En el asistente que aparece, haz clic en En línea y luego en Buscar (Ctrl+E) para UiPath. Descarga la extensión de UiPath Activity Creator .

Cierra Visual Studio y, una vez que aparezca el instalador de VSIX, completa la instalación.

Paso 2: crear un proyecto de UiPath

Vuelve a abrir Visual Studio y haz doble clic en Crear un nuevo proyecto en la pantalla de inicio.

En la pantalla Crear un nuevo proyecto , escribe "uipath" en la barra de búsqueda, selecciona Proyecto de actividad estándar de UiPath y haz clic en Siguiente.

Dale un nombre a tu proyecto. La convención de UiPath es <Your company's name>.<Your product's name> (por ejemplo UiPath Orchestrator). A continuación, haz clic en Crear.

Navega al Explorador de soluciones y observa que ahora se han añadido a la solución 3 proyectos, una carpeta compartida y muchos archivos. Esta es la base de cada paquete de actividades.La actividad simple para añadir tu primera actividad.

La actividad simple

Ahora que ha creado su paquete, vamos a añadirle una actividad. En este ejemplo, creará la actividad mostrada anteriormente: una simple que sume dos números.

Qué necesitará

• Visual Studio Community/Professional/Enterprise (se requiere 2019)
• UiPath Studio
• Uso del Activity Creator

Paso 1: abre el Creador de actividades

Comienza abriendo la solución de Visual Studio creada en la sección anterior y selecciona cualquiera de los proyectos principales (son los que están etiquetados como MyCompany.MyProduct...) en el Explorador de soluciones. A continuación, ve a Extensiones > UiPath > Añadir actividades en la barra de herramientas. Ten en cuenta que este menú estará deshabilitado hasta que se seleccione uno de los proyectos.

Paso 2: Crear una actividad

Esto abrirá una nueva ventana del Creador de actividades. La primera pantalla le ofrece dos opciones:

1. Crear: crea una o más actividades desde cero.
2. Importar: importa una lista de actividades predefinidas que se han guardado en un formato estándar.

Por ahora, selecciona Crear.

Paso 3: definir la actividad

Haz clic en el botón Añadir y rellena cada campo como se muestra a continuación. Esto preparará al creador para crear una actividad llamada Addition. Cuando estés listo, haz clic en el botón Editar para añadir propiedades a la actividad Adición.

Paso 4: añadir propiedades

Esto abrirá una nueva ventana Definir propiedades . Utiliza el botón Añadir para crear 3 propiedades como se muestra a continuación.

Asegúrese de que los dos primeros sean entradas y el último sea una salida. Estas propiedades representarán dos números y su suma.

Paso 5: Generar la actividad

Haz clic en Aceptar en la ventana Propiedades y en Finalizar en la ventana de actividades. A continuación, verás algunos archivos nuevos añadidos a tus proyectos.

Paso 6: Añadir funcionalidad

Abre el archivo Addition.cs que se acaba de crear y expande la región Protected Methods dentro de él para mostrar el método ExecuteAsync de la actividad. Este es el método que se llama cada vez que la actividad se ejecuta en UiPath Studio.

Observa que las dos entradas creadas en el paso 4 (Primer número y Segundo número) así como la única salida (Suma) ya se han agregado a este método. El último paso es cerrar la brecha entre ellas reemplazando el bloque de comentarios con código que agrega las dos entradas y luego establece el resultado en Suma. Ver a continuación:

Paso 7: Crear el paquete

En el Explorador de soluciones, haz clic con el botón derecho en tu proyecto de Diseño y selecciona Publicar. Esta opción crea tus proyectos, los empaqueta y envía el paquete donde quieras.

En la siguiente pantalla, introduce la carpeta en la que deseas guardar tu paquete de actividades. Es una buena idea elegir una de las fuentes de tu paquete de UiPath Studio (puedes encontrarlas en Configuración > Administrar fuentes en la página de inicio de Studio) para que puedas publicar directamente desde Visual Studio en UiPath Studio.

Haz clic en Crear perfil para continuar.

En la página siguiente, cambia el nombre del origen de tu paquete a Paquetes UiPath (o lo que prefieras) y cambia la configuración a Depurar. A continuación, haz clic en Publicar.

Para obtener más información sobre las configuraciones Depurar y Liberar, consulta Metadatos del paquete.

Su salida mostrará que los tres proyectos se han creado correctamente y el paquete resultante se ha publicado. ¡Ya tiene un paquete de actividades de trabajo!

Paso 8: utiliza tus actividades en UiPath Studio

Abre UiPath Studio, navega hasta el Administrador de paquetes y agrega tu conjunto de actividades al flujo de trabajo.

Observe que se ha agregado una nueva categoría al panel Actividades.

¡Eso es todo! Pruebe su nueva actividad.

Metadatos del paquete

Si observas el paquete de actividades creado en este tutorial, verás varios marcadores de posición donde debe ir información como el autor, la licencia, el icono, etc. Personalicemos el paquete reemplazando esos marcadores de posición con información real.

El enfoque de esta sección será el proyecto de Diseño, que contiene toda la información de tu paquete.

Qué necesitará

• Visual Studio Community/Professional/Enterprise (se requiere 2019)
• UiPath Studio
• Uso del Activity Creator

Paso 1: abrir el proyecto de diseño

Abre el proyecto MyCompany.MyProduct.Activities.Design haciendo doble clic en él y observa que hay tres secciones etiquetadas:

• Metadatos del paquete
• Versiones del paquete
• Icono de paquete

Metadatos del paquete

Campo	Descripción
PackageLicenseExpression	Un identificador SPDX para la licencia que desea utilizar. El valor predeterminado es Apache 2.0.
Description	Una breve descripción de sus actividades que aparecerá en el Administrador de paquetes de UiPath Studio.
Authors and Company	El autor y el propietario del paquete respectivamente.
Copyright	El aviso estándar de derechos de autor.
PackageTags	Una lista de términos que los usuarios pueden buscar para encontrar tu paquete.
PackageProjectUrl	Un enlace a la documentación de tus actividades o a la página de inicio de la empresa.
PackageIconUrl	Un enlace a un archivo de imagen utilizado como icono del paquete. Tenga en cuenta que la etiqueta PackageIcon actualmente no es compatible con UiPath Studio.

<PropertyGroup>
    <PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>
    <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
    <Description>A package used to perform simple arithmetic operations in UiPath Studio.</Description>
    <Authors>My Company</Authors>
    <Company>My Company</Company>
    <Copyright>@ 2020 My Company</Copyright>
    <PackageTags>UiPath Activity MyCompany MyProduct Math Addition Arithmetic</PackageTags>
    <PackageProjectUrl>https://docs.uipath.com/integrations/docs/how-to-create-activities</PackageProjectUrl>
    <PackageIconUrl>https://raw.githubusercontent.com/NuGet/Samples/master/PackageIconNuspecExample/icon.png</PackageIconUrl>
    ...
</PropertyGroup>

Versión del paquete

Observa que hay dos etiquetas PackageVersion , que corresponden a los dos modos en los que se puede crear un paquete: Depurar y Liberar.

• La depuración es útil durante el desarrollo. La versión aumenta con cada compilación para que se puedan realizar actualizaciones y luego probarse inmediatamente en UiPath Studio.
• La versión se utiliza para crear un paquete final listo para su publicación. Una vez finalizado el desarrollo, puede establecer aquí la versión deseada.

  <PropertyGroup Condition="'$(Configuration)' == 'Debug'">
      <PackageVersion>0.2.0.$([System.DateTime]::UtcNow.ToString(MMddHmmss)) Version</PackageVersion>
  </PropertyGroup>
    
  <PropertyGroup Condition="'$(Configuration)' == 'Release'">
      <PackageVersion>0.2.0</PackageVersion>
  </PropertyGroup>
  

Icono de paquete

Utiliza la etiqueta PackageIconUrl para añadir un icono a tu paquete de actividades. En este ejemplo, se utiliza un icono de muestra .

Paso 2: reconstruir el paquete

Reconstruye el paquete e impórtalo en UiPath Studio como en la sección anterior. Abre el Administrador de paquetes y observa cómo tu paquete ahora tiene un nuevo icono, descripción y metadatos actualizados.