Como importar entidades

As entidades permitem a utilização de registros do Data Service da UiPath, um serviço centralizado de modelagem e armazenamento de dados. As entidades podem ser usadas em processos de automação que coletam, atualizam e passam dados para outros processos. Todos os tipos de projetos podem ser usados para importar e trabalhar com tais objetos de negócios.

Observação: um robô moderno deve ser criado na instância do Orchestrator, no tenant em que o Data Service estiver habilitado.

Para importar uma entidade:

1. Abra o Data Manager e, em seguida, expanda o nó Entidades. Todas as entidades disponíveis são exibidas.

2. Clique com o botão direito do mouse em uma entidade e, então, selecione Importar. Se você quiser importar todas as entidades, em vez disso clique com o botão direito do mouse no nó Entidades.

   A janela Gerenciar Entidades é aberta.

   
   

   

   
   

3. Selecione a entidade que você deseja importar. Para encontrar uma entidade específica, use a barra Pesquisar Entidades e o tipo de nome da entidade, nome de exibição ou descrição.

   Você pode passar o mouse sobre as entradas na coluna Campos para ver todos os campos definidos de cada entidade, ou clicar no número de campos ou registros para uma entidade para navegar até a página correspondente no Data Service.

4. Insira um namespace para a entidade importada. O namespace padrão é o mesmo que o nome do projeto. O namespace só pode ser editado na primeira vez que você importa uma entidade.

5. Clique em Salvar para importar a entidade para o seu projeto.

   Observação: se você fizer alterações em uma entidade em nível do tenant, use o botão Atualizar, dentro da janela Gerenciar entidades antes de efetivamente importá-las.

As entidades importadas ficam visíveis no painel Projeto, como objetos que fazem parte do seu projeto.

Agora, as entidades importadas poderão ser usadas localmente como objetos em seu projeto. Se você também desejar realizar operações de CRUD neles em Serviços de Dados, precisará instalar o pacote UiPath.DataService.Activities.

Após instalar o pacote do UiPath.DataService.Activities, arraste e solte uma entidade em cima de um sinal de mais, dentro do painel Designer para usar as atividades recomendadas do pacote.

Arraste e solte uma entidade do painel Projeto em um painel de Variáveis ou Argumentos para criar uma variável ou argumento com o tipo de entidade.

Você pode gerenciar as entidades importadas no painel Projeto, clicando com o botão direito do mouse no namespace ou em uma entidade e, então, selecionando no menu de contexto para gerenciar entidades, remover o namespace ou remover a entidade.

Namespaces para Entidades

Depois de importar uma entidade em seu fluxo de trabalho, o namespace dela também é importado. Você pode encontrá-lo ao procurar por tipos em Assemblies de Referência.

Todos os campos que integram uma entidade importada ficam disponíveis como propriedades do namespace da entidade. Portanto, ao trabalhar com entidades, o número de variáveis ou argumentos para gerenciar dados será reduzido.

No exemplo abaixo, o argumento é do tipo definido pela entidade StockPortfolio, suas propriedades visíveis no painel Data Manager são as mesmas que os campos definidos na entidade e disponíveis como propriedades para o argumento.

Confira a página Usando Entidades em Projetos para ver como usá-las.