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 estão disponíveis para importação no Studio v2020.8 e superior, podendo ser usadas em processos de automação que coletam, atualizam e transmitem 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. Clique no botão Gerenciar Entidades da faixa de opções para abrir a janela Gerenciar Entidades e visualizar todas as entidades disponíveis. Se ainda nenhuma entidade foi adicionada, todas as entidades serão selecionadas por padrão.

   De maneira alternativa, você pode arrastar uma entidade do painel Recursos e soltá-la no painel Projeto. Se ainda nenhuma entidade foi adicionada, isso abre a janela Gerenciar Entidades com apenas essa entidade selecionada.

   
   

   

   
   

2. 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.

3. 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.

4. 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.

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, sendo que as propriedades visíveis no painel Recursos são as mesmas dos 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.