Criar uma entidade

Crie uma nova entidade em Data Fabric/Data Service, configure seus campos a partir de fontes locais ou externas e defina seu escopo de tenant ou pasta.

Todos os objetos criados no Data Fabric/Data Service são mencionados como Entidades.

Observação:

Você também pode criar e editar entidades nativas diretamente dentro de uma solução Maestro Flow VS Code, sem sair do seu editor. Esse é um recurso de Visualização, disponível apenas no Código VS. Para obter mais informações, consulte Entidades no código VS.

1. Navegue até Data Fabric/Data Service. A página Entidades é aberta.

2. Selecione Criar nova entidade. O painel de criação da entidade abre.

3. Insira um Nome de Exibição para sua entidade. O Nome de Exibição é o nome exibido ao importar a entidade no Studio. Este campo pode ser modificado após a criação da entidade.

4. Insira um Nome para sua entidade. O Nome pode ser alfanumérico, mas deve começar com uma letra. Deve ter entre três e 30 caracteres. O campo Nome é preenchido automaticamente com o mesmo valor fornecido para o Nome de exibição. Você só pode alterar seu valor durante o processo de criação da entidade. Depois que a entidade é criada, o campo Nome não pode ser editado.

5. Opcionalmente, adicione uma Descrição para sua entidade.

6. Na seção Tipo de entidade , selecione o tipo de entidade a criar:

   1. Selecione Nativo para armazenar os dados da entidade na UiPath. Uma entidade Nativa é compatível com operações de criação, leitura, atualização e exclusão, e contém apenas seus próprios campos.
   2. Selecione Federado para criar uma visualização somente leitura cujos campos são lidos de sistemas externos ou de uma entidade nativa do Data Fabric, cada vez que a entidade é consultada. Uma entidade federada não contém campos próprios.
      Observação:

      Não é possível alterar o tipo de entidade depois de escolhido. Para o que cada tipo suporta, consulte Tipos de entidade.

7. Para restringir o acesso aos registros, use a alternância Habilitar acesso a registros baseado em função .

   Observação:

   O acesso a registros baseados em função não se aplica a entidades federadas, e o botão de alternância não é exibido para elas. Os registros de uma entidade federada são mantidos por seus sistemas de origem.

8. Na seção Local :

   1. Selecione Tenant para disponibilizar dados em todo o tenant para todos os usuários com acesso no nível do tenant.
   2. Selecione Pasta para tornar os dados visíveis apenas para usuários com acesso à pasta do Orchestrator selecionada. Se você selecionar Pasta, você terá que selecionar uma pasta de destino do Orchestrator no menu suspenso Selecionar pasta . A entidade que você cria tem o escopo definido para a pasta que você selecionou.
      Observação:

      Não é possível alterar o local da entidade depois de escolhido.

9. Selecione Criar.

10. Para adicionar campos manualmente, selecione Adicionar objeto no assistente de criação de entidades.

11. No painel Adicionar objeto , selecione um tipo de origem.

    Observação:

    Os tipos de origem disponíveis dependem do tipo de entidade. Uma entidade Nativa oferece somente campos Locais . Uma entidade federada oferece origem externa e origem nativa.

    1. Para adicionar campos de sistemas externos, como Salesforce ou SAP, selecione Origem externa. Para os sistemas que você pode escolher, consulte Sistemas externos. Após selecionar um sistema externo no menu suspenso Sistema externo , uma conexão é preenchida por padrão no campo Conexão , ou você precisa adicionar uma conexão manualmente selecionando Adicionar nova conexão. Se você precisar selecionar Adicionar nova conexão, uma nova guia do navegador será aberta solicitando que você forneça informações de autenticação para conectar a UiPath ao seu sistema externo selecionado. Depois que o campo Conexão for preenchido, selecione o objeto no menu suspenso Objeto .

       

    2. Para adicionar campos de uma entidade nativa Data Fabric / Data Service, selecione Origem nativa e, em seguida, selecione a entidade que deseja referenciar. A entidade à qual você faz referência deve estar no mesmo local da entidade que você está criando.

       

    3. Para uma entidade nativa, para adicionar campos armazenados localmente com a UiPath, selecione Campos locais.

    4. Selecione Prosseguir.

       Após o objeto ser adicionado, cada um de seus campos pode ser configurado no editor que é aberto, incluindo o tipo de campo e as configurações em Opções avançadas.

       Observação:

       A criptografia de dados com chaves gerenciadas pelo cliente (CMK) é compatível atualmente apenas com campos de Texto e Texto multi-linha .

       Para criptografar dados para esses campos, habilite a caixa de seleção Criptografar Dados no painel de Opções avançadas do campo.

       

12. Selecione Gerenciar junções para conectar junções entre campos de vários tipos de origem diferentes. Na seção Gerenciar junções , você deve mapear os campos de duas origens diferentes selecionando o Objeto primário, Campo primário, Objeto referenciado e campo Referenciado nos menus suspensos.

    

13. Selecione Salvar.

A nova entidade é exibida em sua lista de Entidades.

Sistemas externos

Uma entidade federada lê seus campos de um sistema externo cada vez que é consultada. Os dados permanecem no sistema de registro e o Data Fabric/Data Service mantém apenas o mapeamento; portanto, não há etapa de cópia para criar e manter atual. Um campo referenciado dessa forma comporta-se como qualquer outro campo em automações, fluxos de trabalho, Apps e Maestro.

Os seguintes sistemas externos estão disponíveis para referência de campos:

• Database Hub (Databricks, Oracle DB, PostgreSQL, Redshift e MS SQL Server)
• Microsoft Azure Active Directory
• Salesforce
• SAP
• ServiceNow
• Snowflake

Para fazer referência a campos de outra entidade Data Fabric/Data Service, em vez de um sistema externo, selecione Origem nativa no painel Adicionar objeto .

As consultas que são lidas de um sistema externo estão sujeitas a um conjunto de limites. Para obter mais informações, consulte Limites de consulta para dados externos.

Modelagem para entidades conectadas a vários sistemas

Com a modelagem de entidade de várias origens, você pode fazer referência a campos de vários sistemas externos, como Salesforce e ServiceNow, em uma única Entidade federada.

Recomendamos uma abordagem de esquema em estrela ao conectar mais de um sistema. Todos os sistemas conectados e objetos externos devem mapear diretamente para uma entidade principal, em vez de encadear um ao outro.

Para incluir campos armazenados no UiPath na mesma exibição, mantenha-os em uma entidade nativa e referencie-a com Origem nativa. A entidade nativa pode servir como o núcleo ao qual cada objeto externo se une.

Observação:

O objeto principal é aquele ao qual todas as outras origens se unem. Pode ser um objeto externo ou uma origem nativa.

Essa abordagem de esquema em estrela cria um layout limpo, conforme apresentado no exemplo a seguir: