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 debe utilizarse como dependencia de desarrollo en tu proyecto personalizado. Más información sobre 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. Click File > Save. In our case, the .nupkg file is created.
    Note: Be sure to create an intuitive folder structure for your activities. All empty folders inside the custom activity get removed when used with Orchestrator.

Paso 2: instalar el paquete NuGet en UiPath Studio

Una vez creado el archivo .nupkg , añádelo a una fuente personalizada en Studio, como se explica aquí.

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

Muestra de Asistentes

Solo tiene que seguir el siguiente enlace para descargar la muestra, que también contiene un ejemplo de cómo crear ajustes de actividades personalizadas.

Descargar ejemplo