Using The Activity Creator

Las actividades son los componentes básicos de la automatización de procesos. Cada una 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 te 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 la carga de trabajo de desarrollo de escritorio .NET instalada
• Fuente de UiPath Marketplace (https://gallery.uipath.com/api/v3/index.json) como origen del 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 se basan en las bibliotecas creadas en UiPath que están disponibles actualmente 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 crearán correctamente.

Paso 1: Agregar la extensión del Creador de UiPath Activities 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. Descargue la extensión Activity Creator de UiPath .

Close Visual Studio and, once the VSIX Installer appears, complete the installation.

Paso 2: Cree 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.

Asigne un nombre a su proyecto. La convención de UiPath es <Your company's name>.<Your product's name> (p. Ej. UiPath.Orchestrator). Luego haz clic en Crear.

Vaya al Explorador de soluciones y observe que ahora se han agregado a la solución 3 proyectos, una carpeta compartida y muchos archivos. Esta es la base de todo paquete de actividades.La actividad simple para agregar su primera actividad.

The Simple Activity

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
• Using The Activity Creator

Paso 1: abre el Creador de actividades

Comience abriendo la solución de Visual Studio creada en la sección anterior y seleccione cualquiera de los proyectos principales (estos son los etiquetados MiEmpresa.MiProducto ...) en el Explorador de soluciones. Luego ve a Extensiones> UiPath> Agregar actividades en la barra de herramientas. Tenga 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 denominada Adición. Cuando esté listo, haga clic en el botón Editar para añadir propiedades a la actividad de Suma.

Paso 4: añadir propiedades

Esto abrirá una nueva ventana Definir propiedades . Utilice 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á algunos archivos nuevos añadidos a sus 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

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

En la siguiente pantalla, introduce la carpeta en la que quieres guardar tu paquete de actividades. Es una buena idea elegir uno de los orígenes de sus paquetes de UiPath Studio (puede encontrarlos en Configuración> Administrar orígenes en la página de inicio de Studio) para poder publicar directamente desde Visual Studio en UiPath Studio.

Haga clic en Crear perfil para continuar.

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

Para obtener más información sobre las configuraciones de depuración frente a versión, consulta Metadatos de paquetes.

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: Utilice sus 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.

Package Metadata

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
• Using The Activity Creator

Paso 1: abrir el proyecto de diseño

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

• Package Metadata
• Versiones del paquete
• Icono de paquete

Package Metadata

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>

Package Version

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 probar inmediatamente en UiPath Studio.

• Versión se utiliza para crear un paquete final listo para su publicación. Una vez finalizado el desarrollo, puedes establecer la versión deseada aquí.

  <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 que tu paquete tiene ahora un icono, una descripción y metadatos nuevos.