Referir-se a uma entidade em seu aplicativo

Para criar aplicativos mais complexos e melhores, o UiPath^® Apps pode se conectar e interagir com entidades do UiPath^® Data Service.

O Data Service é um serviço de armazenamento de dados persistente que traz recursos de modelagem e armazenamento de dados sem código para seus projetos de Automação de Processos Robóticos (RPA).

Observação: após o carregamento dos dados, ele é atualizado apenas quando uma regra é executada. Quaisquer atualizações feitas no Data Service através de processos ou por outros meios não serão automaticamente coletadas. Certifique-se de atualizar os dados explicitamente nesses cenários.

Atenção:

No momento, não há rolagem infinita relativa às entidades.

Referenciando uma entidade do Data Service

Assim que uma entidade tiver sido criada no Data Service, você poderá referenciá-la a partir de um aplicativo.

Observação: se a entidade no Data Service for alterada, as alterações serão sincronizadas automaticamente após a atualização ou reabertura do aplicativo.

O seguinte exemplo mostra como adicionar uma entidade existente a um aplicativo:

1. A partir de um aplicativo existente no App Studio, expanda o menu suspenso à direita do botão Adicionar controle.

2. Selecione Entidade.

   
   

   

   
   

3. É exibida uma lista de tenants para a conta atual. Selecione o tenant que hospeda as entidades que você precisa importar e, em seguida, clique em Avançar.

   
   

   

   
   
4. O assistente Adicionar entidade é aberto, exibindo a lista de entidades no tenant selecionado.
5. Selecione uma ou mais entidades. O painel direito exibe a lista de campos da entidade destacada.

   Observação:

   Se você selecionar uma entidade que tem como campos outras entidades, as entidades dependentes serão selecionadas automaticamente.

   Desmarcar uma entidade que tem como campos outras entidades não desmarcará as entidades dependentes.

   
   

   

   
   

6. Marque a caixa de seleção ao lado da entidade que você deseja usar em seu aplicativo e clique em Adicionar.

Observação:

• As permissões das entidades são gerenciadas no Data Service. Certifique-se de ter as permissões certas para a entidade que deseja adicionar a partir do Data Service.

• Você pode acessar a ID de um registro recém-criado em uma entidade, usando a seguinte sintaxe: ControlName.CreateEntityRecordRuleName.RecordId

Vinculando uma entidade

As entidades podem ser associadas aos seguintes controles:

• Listas suspensas (simples e de seleção múltipla)

• Botões de rádio

• Editar grades

• Listas

• Tabelas

O seguinte exemplo mostra como fazer referência à entidade chamada País em um controle Tabela.

Antes de começar

Certifique-se de que a entidade seja importada para seu aplicativo.

Procedimento

1. Em seu aplicativo, adicione um controle Tabela.
2. Selecione a tabela e vá para a guia Geral.

3. Na propriedade Origem de dados, você pode fazer referência a uma entidade:

   • Abra o Construtor de consultas, selecione a entidade que você deseja referenciar, aplique condições, se necessário para filtrar os registros de entidades e, em seguida, clique em Salvar.

     
     

     

     
     

Os cabeçalhos de coluna são preenchidos automaticamente com os nomes dos campos de entidade.

A entidade País agora está ligada à tabela.

Observação:

Para usar controles simples (como Lista, Lista suspensa) com entidades, salve a entidade em uma variável de aplicativo e, em seguida, use a variável para exibir os campos de entidade.