Crear Asistentes personalizados

Utilizando el paquete UiPath.Activities.API de la fuente oficial (https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json], puedes añadir tu propio asistente personalizado a la cinta de Studio. Para obtener información sobre cómo utilizar la API, consulta SDK de actividades de Studio.

Nota:

El paquete UiPath.Activities.API deberá usarse como dependencia de desarrollo en tu proyecto personalizado. Consulta más detalles sobre las Dependencias de desarrollo.

Crear asistentes personalizados

La siguiente muestra es la definición de un asistente que crea una secuencia vacía al hacer clic:

using System.Activities;
using System.Windows;
using System.Windows.Input;
using UiPath.Studio.Activities.Api;
using UiPath.Studio.Activities.Api.Wizards;
namespace MyCustomActivityPack
{
    public static class WizardCreator
    {
        public static void CreateWizards(IWorkflowDesignApi workflowDesignApi)
        {
            CreateDemoWizard(workflowDesignApi);
        }
        private static void CreateDemoWizard(IWorkflowDesignApi workflowDesignApi)
        {
            var wizardApi = workflowDesignApi.Wizards;
            var wizardDefinition = new WizardDefinition()
            {
                // You can add other definitions here to create a dropdown.
                //ChildrenDefinitions.Add()
                Wizard = new WizardBase()
                {
                    RunWizard = RunWizard
                },
                DisplayName = "DemoWizardDisplayName",
                Shortcut = new KeyGesture(Key.F9, ModifierKeys.Control | ModifierKeys.Shift),
                IconUri = "Icons/RecordIcon",
                Tooltip = "DemoWizardTooltip"
            };
            var collection = new WizardCollection(); //Use a collection to group all of your wizards.
            collection.WizardDefinitions.Add(wizardDefinition);
            wizardApi.Register(collection);
        }
        private static Activity RunWizard()
        {
            if(MessageBox.Show("Do you want a sequence?", "This is a wizard window", MessageBoxButton.YesNo, MessageBoxImage.Question) == MessageBoxResult.Yes)
            {
                return new System.Activities.Statements.Sequence()
                {
                    DisplayName = "The wizard generated this sequence"
                };
            }
            return null;
        }
    }
}

Usa la propiedad MinimizeBeforeRun para minimizar Studio antes de llamar RunWizard, y restaurar RunWizard cuando regrese.

La propiedad RunWizardAsync debe usarse para que el asistente se ejecute de forma asíncrona.

Agregar el proyecto a Studio

Para que el asistente sea visible en la cinta de Studio, es necesario publicar las actividades personalizadas en un paquete NuGet y ponerlas a disposición de una fuente definida en Studio, versión 2019.10.1 o posterior.

Paso 1: crear el paquete NuGet

1. Inicia el Explorador de paquetes NuGet.
2. Haz clic en Crear un nuevo paquete (Ctrl + N). Aparecerá una ventana dividida que muestra Metadatos del paquete y Contenido del paquete. Debemos agregar todas las dependencias en esta última sección.
3. Haz clic con el botón derecho en la sección Contenido del paquete. Se mostrará un menú contextual.
4. Haz clic en Agregar carpeta lib. Ten cuenta que se creará un nuevo elemento lib en la sección de Contenidos del paquete.
5. Haz clic en lib y selecciona Agregar un archivo existente....
6. Carga el ensamblado externo (.dll) de tu proyecto.
7. Haz clic en Editar > Editar metadatos. Se mostrará la sección Metadatos del paquete.
8. Rellena los campos como creas conveniente para describir mejor tu proyecto.
9. Rellena el campo Id y asegúrate de que se incluye la palabra clave "Actividades" para que el paquete pueda ser mostrado en la ventana de Gestión de paquetes, en Studio.
10. Haz clic en Archivo > Guardar. En nuestro caso, se crea el archivo .nupkg.
    Nota:

    Asegúrate de crear una estructura de carpetas intuitiva para las actividades. Todas las carpetas vacías dentro de la actividad personalizada se eliminan cuando se usan con Orchestrator.

Paso 2: instala el paquete NuGet en UiPath Studio

Una vez creado el archivo .nupkg, agrégalo en una fuente personalizada en Studio, como se explica aquí.

Abre la ventana Gestionar paquetes e instala el paquete. Asegúrese de que la fuente personalizada esté habilitada en Studio.

Muestra de Asistentes

Simplemente sigue el siguiente enlace para descargar la muestra que también contiene un ejemplo de creación de configuraciones de actividades personalizadas.

Descargar ejemplo