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

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.

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.

Os símbolos menor que (<) ou menor ou igual a (<=) não são compatíveis. Portanto, entradas como UiPath.Excel.Activities<2.5.3 ou UiPath.Excel.Activities<=2.5.3 são consideradas inválidas.

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:

To check which package an activity belongs to, use the Group by Packages option in the Activities panel, as explained here. Another easy way to check is to hover over an activity in the panel and read the tooltip.

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.