SDK de atividades do Studio

O pacote de SDK da APIUiPath Activities é hospedado no feed de atividades Oficial (https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json).

Entre outras coisas, o pacote é usado para:

Criando as regras do Analisador de Fluxo de Trabalho adicionando descrições, parâmetros e integrando-as na janela do Analisador de Fluxo de Trabalho.
Criando Configurações do Projeto de Atividades adicionando categorias, seções, campos de entrada numéricos, caixas combo e integrando-as na janela Configurações de Projeto de Atividade no Studio, como nas atividades dos pacotes da UiPath.
Criar assistentes personalizados e integrá-los na faixa de opções do Studio.

Importante: o UiPath Activities.API SDK deve ser usado como uma dependência de desenvolvimento no seu projeto personalizado. Leia mais sobre Dependências de desenvolvimento.

Como utilizar a API

Quando as atividades são carregadas no Studio, uma referência ao IWorkflowDesignApi é fornecida de várias maneiras:

Dentro da IRegisterMetadataimplementação adicione um public void Initialize(object api)método. Este método é chamado durante o processo de carregamento de atividades e a atividade poderá armazenar o parâmetroapi para uso posterior.
Defina uma classe que implemente IRegisterWorkflowDesignApi. O método IRegisterWorkflowDesignApi.Initialize(IWorkflowDesignApi api) é chamado durante o processo de carregamento da atividade e a atividade poderá armazenar o parâmetro api para uso posterior. Ao usar este método apenas as versões do Studio a partir da 2019.6 estarão habilitadas a carregar seu pacote.
Obter uma referência ao objeto api chamando context.Services.GetService<IWorkflowDesignApi>() onde context é um System.Activities.Presentation.EditingContext, geralmente acessível para designers de atividades.

Chaves de Funcionalidades de Design

É importante realizar uma verificação prévia contra o DesignFeatureKeys para saber se as chaves de funcionalidades necessárias são suportadas. Para mais informações, consulte as ChavesDeRecursoDeDesign.

Para verificar uma funcionalidade, é necessário chamar o método HasFeature na referência IWorkflowDesignApi , caso contrário, chamadas aos métodos relevantes da API podem falhar com MissingMemberException ou MissingMethodException em versões mais antigas do Studio.

IWorkflowDesignApi studioActivitiesApi;
            // How to check for a feature.
            if (studioActivitiesApi.HasFeature(UiPath.Studio.Activities.Api.DesignFeatureKeys.Settings))
            {
                // Call Method or lambda that is using specific feature
                // This ensures that the code is JIT compiled only after the feature check
           }IWorkflowDesignApi studioActivitiesApi;
            // How to check for a feature.
            if (studioActivitiesApi.HasFeature(UiPath.Studio.Activities.Api.DesignFeatureKeys.Settings))
            {
                // Call Method or lambda that is using specific feature
                // This ensures that the code is JIT compiled only after the feature check
           }