SR-US-014 - Restrições de pacotes

ST-USG-014 Regra do Analisador de Fluxo de Trabalho, que restringe o uso de pacotes de atividades específicos em um projeto, definindo listas de pacotes permitidos ou proibidos.

ID de regra: ST-USG-014

Escopo: Projeto

Description

A regra permite restringir o uso de pacotes de atividades em um determinado projeto, definindo pacotes permitidos ou proibidos. Após as restrições serem definidas, a regra verifica o projeto para determinar se qualquer pacote proibido foi adicionado como dependências. Por padrão, se algum pacote proibido tiver sido instalado no projeto, a regra registra um erro no painel Lista de Erros.

Observação:

As atividades padrão integradas ao Studio não podem ser excluídas por meio desta regra, pois não pertencem a um pacote específico.

Recomendação

Certifique-se de que apenas pacotes aprovados por sua organização sejam instalados em seu projeto.

Modificando a regra

Na janela Configurações do Projeto, selecione a guia Analisador de Fluxo de Trabalho. Encontre a regra e selecione-a, conforme a imagem abaixo:

Por padrão, essa regra não restringe o uso de nenhum pacote de atividades. Para definir pacotes permitidos ou proibidos, adicione-os à caixa correspondente.

Se o mesmo pacote for adicionado como permitido e proibido, o pacote será proibido. Se qualquer pacote permitido for definido, todos os outros pacotes serão proibidos.

Formato do nome do pacote

Adicione um pacote, gravando seu nome completo com a respectiva versão, separados por um sinal de igual (=), por exemplo, UiPath.Excel.Activities=2.5.3.

Adicione o símbolo de maior ou igual que (>=) para permitir ou proibir versões superiores. Por exemplo, adicionar UiPath.Excel.Activities>=2.5.3 à caixa de pacotes proibidos proíbe todos os pacotes "UiPath.Excel.Activities" com uma versão de 2.5.3 ou superior. O símbolo maior que (>) somente pode ser usado com sinais de igual (=). Entradas como UiPath.Excel.Activities>2.5.3 são inválidas.

Correspondência de curinga

Você pode usar um caractere curinga * para combinar qualquer número de caracteres. Por exemplo:

• A adição de UiPath.Excel.Activities=2.7.2-beta* à caixa de pacotes proibidos proíbe todas as versões beta. 2.7.2-beta do pacote UiPath.Excel.Activities=2.7.2, enquanto permite o uso de outras versões do mesmo pacote, incluindo UiPath.Excel.Activities=2.7.2, quaisquer outras versões pré-lançamento do pacote UiPath.Excel.Activities=2.7.2 (como versões alfa) ou quaisquer outras versões estáveis ou pré-lançamento do pacote UiPath.Excel.Activities.
• A adição de UiPath.* à caixa de pacotes permitidos permite apenas pacotes publicados pelo UiPath.

Ao usar o símbolo de maior ou igual que (>=) em conjunto com um caractere curinga *, o símbolo de maior que (>) é interpretado como o sinal de igual (=); por exemplo, UiPath.Excel.Activities>=2.7.2-beta* é uma entrada válida, mas é interpretado como UiPath.Excel.Activities=2.7.2-beta*.

Exemplos:

• UiPath.Excel.Activities=2.8.4-*
• UiPath.Excel.Activities >=2.7.2
• UiPath.Excel.Activities=2.7.2

Para adicionar vários pacotes, separe-os por uma vírgula. Por exemplo, a adição de UiPath.Excel.Activities, UiPath.UIAutomation.Activities à caixa de pacotes proibidos proíbe todas as versões desses dois pacotes.

Observação:

Para verificar a qual pacote uma atividade pertence, utilize a opção Agrupar por Pacotes, no painel Atividades, conforme explicado aqui. Outra maneira fácil de verificar é focalizar uma atividade no painel e ler a dica de ferramenta.

Após adicionar os pacotes à regra, utilize o botão Analisar Projeto para testar a regra.

Redefinir para o padrão

Por padrão, a regra não proíbe nenhum pacote. Entretanto, se deseja remover os pacotes adicionados rapidamente, clique com o botão direito na regra, na janela Configurações do Projeto e, depois, clique em Restaurar padrão. A ação Padrão também é redefinida para seu valor padrão Error.