Organização de recursos com tags

As tags ajudam a categorizar recursos. Elas melhoram a governança e fornecem visibilidade da associação entre os vários recursos, de tal forma que todos em sua empresa possam reconhecer facilmente as dependências entre eles.

À medida que sua frota de robôs cresce, o número de recursos para consumir e gerenciar expande, e isso pode gerar alguns desafios significativos para o seu negócio. Alguns desses desafios incluem:

• dificuldades para descobrir como os vários objetos funcionam um com o outro;
• aumento da carga de trabalho manual: você precisa de soluções tediosas para categorizar e rastrear as dependências entre objetos, como planilhas do Excel;
• nenhuma visibilidade sobre como suas ações poderiam afetar outros recursos, como os processos em execução;
• nenhuma visibilidade sobre o potencial tempo de inatividade após atualizar um aplicativo que é destino de suas automações, pois não há uma maneira fácil de ver quais processos estão empregando esse aplicativo.

As tags podem ajudar você em diversas áreas:

• Aumento de produtividade do desenvolvedor: ajuda os desenvolvedores a identificar quais recursos são relevantes para eles. Eles se tornam capazes de se concentrar em adicionar valor em vez de gastar uma infinidade de tempo procurando aquela pequena parte do processo que podem estar afetando.
• Aumento de produtividade do administrador: com uma estrutura consistente de tags em toda a sua organização, você pode começar a criar uma taxonomia unificada que ajudará todos a encontrar recursos mais rápido.

Como as tags funcionam

As tags são armazenadas pelo serviço Catálogo de recursos e consistem de rótulos e/ou propriedades do valor-chave aplicados a seus objetos. Por exemplo, você pode aplicar o rótulo SAP e o par de chave-valor Department: Finance a todos os objetos envolvidos na automação SAP no departamento de finanças da sua empresa.

Como preencher esses campos é uma decisão sua; no entanto, recomendamos definir e usar uma convenção de tags consistente, para que todos possam encontrar os recursos certos de maneira rápida e fácil. Sem consistência, sua biblioteca de tags pode acabar ficando caótica e contraprodutiva.

Ainda não disponibilizamos um local central de onde criar, editar ou excluir tags. Em vez disso, essas operações devem ser realizadas no nível do objeto. Preste atenção na grafia e nas letras maiúsculas/minúsculas de uma tag, pois não é possível editá-la após sua criação — seria necessário removê-la completamente, criar a correta e adicioná-la novamente a todos os objetos.

Objetos marcáveis com tags

A marcação com tags está disponível para diversos objetos do Orchestrator, pacotes do Studio e ações do Action Center. Uma tag adicionada a um objeto fica disponível para todos os objetos que são compatíveis com tags em todos os produtos. Por exemplo, adicionar o rótulo SAP a um ativo no Orchestrator torna-o disponível também para ações.

Produto	Objetos marcáveis com tags
Orchestrator	Ativos Processos Filas Armazenar buckets Máquinas
Studio	Pacotes
Action Center	Ações

Gerenciamento de tags

Criação de novas tags

Para criar uma tag, você precisa criá-la e aplicá-la a um objeto no nível de objeto. Isso disponibiliza a tag para todos os outros recursos que são compatíveis com tags.

Importante:

• As tags não são sensíveis a letras maiúsculas e minúsculas.
• Cada objeto pode ter no máximo um milhão de pares de chave-valor.
• Os rótulos e propriedades de chave-valor são limitados a 256 caracteres.
• Nomes de tags não podem conter estes caracteres: <, >, %, &, \)\), ?, /, :.
• As tags a seguir são tags proprietárias do UiPath Studio e você não pode defini-las nem usá-las em seus objetos: UiPathStudioProcess, UiPathStudioTest, UiPathStudioTask, UiPathStudioLibrary, UiPathObjects, UiPathActivities, UiPathStudioX, UiPathTestCases, UiPathEntities, UiPathWebServices, UiPathStudioTemplate, UiPathStudioLocalizedTemplate, C#, CSharp, VB, VisualBasic e GettingStartedTemplate.

Vamos analisar o exemplo da criação de novas tags adicionando-as a um ativo no Orchestrator:

1. Acesse uma pasta > Ativos. A janela Ativos será exibida com uma lista de todos os ativos criados nessa pasta.
2. Edite um ativo existente acessando Mais ações > Editar. A janela Editar ativo será exibida.
3. No campo Rótulos, comece a digitar o nome do novo rótulo. Quando finalizar, clique na entrada com o sinal de mais e no nome do rótulo para adicioná-lo.
   
   

   

   
   
4. No campo Propriedades (pares de chave-valor), clique em Adicionar novo.
5. Adicione novas chaves e valores. Quando finalizar, clique nas entradas com o sinal de mais e nas chaves/valores para adicioná-los.
   
   

   

   
   
6. Quando finalizar, clique em Atualizar. Seu ativo será atualizado e as tags recém-criadas ficarão disponíveis para outros objetos.

Criação de tags em massa

O script a seguir lê um arquivo CSV contendo suas tags e cria um ativo fictício com as respectivas tags no Orchestrator. Isso disponibiliza as tags para todos os objetos que são compatíveis com elas em todos os produtos.

Baixe o script.

Descrição de Parâmetros

Parâmetro	Description
-TagsFilePath	Caminho para o arquivo CSV.

Exemplo

O exemplo a seguir permite chamar o script Add-DummyAsset-WithTags.ps1 e ler o arquivo CSV fornecido no local <pathToFile.

Observação: antes de executar o script, importe o módulo UiPath.PowerShell e se autentique usando Get-UiPathAuthToken.

.\Add-DummyAsset-WithTags.ps1 -TagsFilePath '<pathToFile>'

Exclusão de tags existentes

Excluir uma tag só é possível através de sua remoção manual de cada objeto associado. Digamos que você tenha três modelos de máquina com o par de chave-valor Department: Finance e três com o par de chave-valor Department: Accounting. Você deve remover todos os seis pares de chave-valor dos objetos de máquina para que os pares de chave-valor Department: Finance e Department: Accounting sejam removidos completamente.

Consulte a seção Como remover tags de objetos abaixo para obter mais detalhes sobre como remover tags de objetos.

Como visualizar objetos com uma tag específica

Para visualizar todos os objetos do Orchestrator com uma tag:

1. No cabeçalho do Orchestrator, clique no ícone Pesquisar no tenant. A janela Pesquisa no tenant será exibida listando todos os objetos nesse tenant.
   
   

   

   
   
2. No menu suspenso Rótulos, selecione o rótulo para visualizar os objetos associados. A lista de objetos é filtrada com base no valor selecionado. Todos os objetos com esse rótulo são exibidos.
   
   

   

   
   
3. Na exibição detalhada de Propriedades, selecione o par de chave-valor para visualizar os objetos associados. A lista de objetos é filtrada com base nos valores selecionados. Todos os objetos com esse par de chave-valor são exibidos.
   
   

   

   
   
4. Para limitar ainda mais os resultados, você pode filtrar pelo tipo de objeto na lista suspensa Tipo ou pela pasta que contém o objeto no menu suspenso Local.
   
   

   

   
   

Saiba mais sobre como a funcionalidade de pesquisa no tenant funciona no seguinte artigo: Pesquisa de recursos em um tenant.

Como visualizar tags para um objeto

Para visualizar as tags para um objeto do Orchestrator, procure as colunas Rótulos e Propriedades na página específica do objeto. Por exemplo, para ver as tags aplicadas a objetos de máquina, acesse Tenant > Máquinas.

De maneira similar, navegue até a página Pesquisa no tenant clicando no ícone Pesquisa no tenant no canto superior direito de qualquer página, e filtre por máquina usando o menu suspenso Tipo.

Marcação de objetos com tags

A experiência do gerenciamento de tags é consistente para todos os objetos em um produto, ou seja, é possível realizar todas as operações de maneira semelhante.

Como adicionar tags a objetos

Clique aqui para obter instruções sobre como adicionar tags a um recurso específico:

Produto	Objects
Orchestrator	Ativos Processos Filas Armazenar buckets Máquinas
Studio	Pacotes
Action Center	Ações

Como remover tags de objetos

Clique aqui para obter instruções sobre como remover tags de um recurso específico:

Produto	Objects
Orchestrator	Ativos Processos Filas Armazenar buckets Máquinas
Studio	Pacotes
Action Center	Ações

Permissões de tags

As tags têm um conjunto de permissões dedicado chamado Tags. Atualmente, apenas as permissões de Exibir e Criar são relevantes para tags. As permissões de Editar e Excluir não têm efeito.

As operações com tags em um determinado objeto são controladas por dois conjuntos de permissões: permissões em Tags e permissões no objeto ao qual você deseja aplicar uma tag. Para exemplificar como isso funciona, vamos ver as operações com tags possíveis para ativos do Orchestrator com base nas permissões que você tem em Ativos e em Tags. O mesmo princípio se aplica a outros objetos.

Exibir em Tags	Criar em Tags
Exibir em Ativos	Pode exibir tags aplicadas a ativos. Não pode alterar tags aplicadas a ativos. Não pode remover tags de ativos.	Pode exibir tags aplicadas a ativos. Não pode alterar tags aplicadas a ativos. Não pode remover tags de ativos.
Editar em Ativos	Pode exibir tags aplicadas a ativos. Pode aplicar tags em ativos, contanto que as tags já tenham sido criadas. Pode remover tags de ativos.	Pode exibir tags aplicadas a ativos. Pode criar e aplicar novas tags a ativos. Pode remover tags de ativos.
Criar em Ativos (igual a Editar em Ativos)	Pode exibir tags aplicadas a ativos. Pode aplicar tags em ativos, contanto que as tags já tenham sido criadas. Pode remover tags de ativos.	Pode exibir tags aplicadas a ativos. Pode criar e aplicar novas tags a ativos. Pode remover tags de ativos.
Excluir em Ativos (igual a Editar em Ativos)	Pode exibir tags aplicadas a ativos. Pode aplicar tags em ativos, contanto que as tags já tenham sido criadas. Pode remover tags de ativos.	Pode exibir tags aplicadas a ativos. Pode criar e aplicar novas tags a ativos. Pode remover tags de ativos.

Limitações

• Ainda não disponibilizamos um local central de onde criar, editar ou excluir tags. Em vez disso, essas operações devem ser realizadas no nível do objeto.
• Nem todos os tipos de recurso são compatíveis com tags. Para determinar se é possível aplicar uma tag a um tipo de recurso, consulte a seção Objetos marcáveis com tags acima.
• Cada objeto pode ter no máximo um milhão de pares de chave-valor.
• Os rótulos e propriedades de chave-valor são limitados a 256 caracteres.
• Nomes de tags não podem conter estes caracteres: <, >, %, &, \, ?, /, :.
• Ainda não oferecemos o registro em log para tags.
• As tags não são compatíveis com cores.
• As tags a seguir são tags proprietárias do UiPath Studio e você não pode defini-las nem usá-las em seus objetos: UiPathStudioProcess, UiPathStudioTest, UiPathStudioTask, UiPathStudioLibrary, UiPathObjects, UiPathActivities, UiPathStudioX, UiPathTestCases, UiPathEntities, UiPathWebServices, UiPathStudioTemplate, UiPathStudioLocalizedTemplate, C#, CSharp, VB, VisualBasic e GettingStartedTemplate.