SDK de atividades do Studio

O pacote de SDK UiPath.Activities.API é hospedado no feed Oficial de atividades (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 do Studio.

  

• Criando Configurações de 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 pacote SDK UiPath.Activities.API 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 a IWorkflowDesignApi é fornecida de várias maneiras:

1. 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.
2. 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.
3. Obter uma referência ao objetoapi 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 obter mais informações, consulte as ChavesDeFeatureDeDesign.

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
           }

Interfaces

As seguintes interfaces estão disponíveis:

• IExtensionsInstallerService
• IOrganizationalSettingsService
• IRegisterAnalyzerConfiguration
• IRegisterWorkflowDesignApi
• IStudioDesignSettingsService
• IWorkflowDesignApi
• IWindowOperationsService