Como criar assistentes personalizados

Ao usar o pacote UiPath.Activities.API do feed oficial (https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json], você pode adicionar seu próprio assistente personalizado à faixa de opções do Studio. Para obter informações sobre como usar a API, consulte o SDK de atividades do Studio.

Observação:

O pacote UiPath.Activities.API deve ser usado como uma dependência de desenvolvimento no seu projeto personalizado. Leia mais sobre Dependências de desenvolvimento.

Criar Assistentes personalizados

O exemplo a seguir demonstra a definição de um assistente que cria uma sequência vazia quando clicado:

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;
        }
    }
}

Use a propriedade MinimizeBeforeRun para minimizar o Studio antes de chamar RunWizard, e restaure-o quando retornar RunWizard.

A propriedadeRunWizardAsync deve ser usada para que o assistente seja executado de forma assíncrona.

Adicionar o Projeto ao Studio

Para tornar o assistente visível na faixa de opções do Studio, é necessário publicar suas atividades personalizadas em um pacote NuGet e disponibilizá-lo em um feed definido no Studio, versão 2019.10.1 ou superior.

Etapa 1: criar o pacote NuGet

1. Inicie o Explorador de Pacotes NuGet.
2. Clique em Criar um novo pacote (Ctrl + N). Uma janela bipartida será exibida com os metadados do pacote e o conteúdo do pacote. Precisamos adicionar todas as dependências na seção final.
3. Clique com o botão direito do mouse na seção Conteúdo do Pacote. O menu de contexto é exibido.
4. Clique em Adicionar pasta lib. Observe que um novo item lib será criado na seção Conteúdo do Pacote.
5. Clique com o botão direito do mouse em lib e selecione Adicionar Arquivo Existente....
6. Carregue o assembly externo (.dll) do seu projeto.
7. Clique em Editar > Editar Metadados. A seção Metadados do Pacote será exibida.
8. Preencha os campos conforme prefira para melhor descrever seu projeto.
9. Preencha o campo Id e certifique-se de incluir a palavra-chave "Atividades" para que o pacote possa ser exibido na janela Gerenciar Pacotes no Studio.
10. Clique em Arquivo > Salvar. No nosso caso, o arquivo .nupkg será criado.
    Observação:

    Certifique-se de criar uma estrutura de pastas intuitiva para suas atividades. Todas as pastas vazias dentro da atividade personalizada serão removidas quando utilizando o Orchestrator.

Etapa 2: instalar o pacote NuGet no UiPath Studio

Após o arquivo .nupkg ser criado, adicione-o a um feed personalizado no Studio, conforme explicado aqui.

Abra a janela Gerenciar Pacotes e instale o pacote. Certifique-se de que o feed personalizado está habilitado no Studio.

Assistente de Exemplo

Basta seguir o link abaixo para baixar o exemplo, que também contém um exemplo de como criar configurações de atividades personalizadas.

Baixe o exemplo