Entidades em Soluções

Ciclo de vida da entidade do Data Fabric em Soluções, abrangendo inclusão automática de dependências, instalação, atualização e gerenciamento de desinstalação, além de substituições de entidades na depuração e no runtime.

As entidades do Data Fabric podem ser incluídas como recursos em uma Solução. Quando você usa uma entidade no nível da pasta em um fluxo de trabalho que pertence a uma Solução, a entidade e suas dependências são empacotadas, implantadas e gerenciadas como parte do ciclo de vida da Solução.

Esta página aborda como as entidades se comportam em cada estágio — desde a modelagem até a implantação, runtime, atualização e desinstalação.

Como uma entidade se torna um recurso da solução

Quando você adiciona uma atividade do Data Service a um fluxo de trabalho dentro de uma Solução e seleciona uma entidade no nível da pasta, essa entidade será registrada automaticamente como um recurso da Solução. Você não precisa adicioná-lo manualmente.

Inclusão automática de dependência

Adicionar uma entidade como um recurso da solução também inclui todas as suas dependências. As dependências incluídas diferem com base no tipo de entidade.

Entidades nativas

• Entidades relacionadas — Se a Entidade A tiver um campo de relacionamento apontando para a Entidade B, ambas as entidades serão adicionadas como recursos de solução.
• Conjuntos de escolhas — Qualquer conjunto de escolhas usado como um tipo de campo na entidade é incluído.
• Dependências aninhadas — Se a própria Entidade B fizer referência à Entidade C, essa entidade também será incluída. A cadeia de dependência completa é resolvida automaticamente.

Entidades federadas

• Conexões — as conexões do Integration Service usadas pela entidade federada são incluídas.
• Entidades de origem nativa — Se uma entidade federada faz referência a uma entidade nativa como uma origem de dados, essa entidade nativa e sua cadeia de dependência completa serão incluídas.

Observação:

As entidades no nível do tenant usadas em um fluxo de trabalho não são empacotadas automaticamente. Eles já devem existir no ambiente de destino para que o fluxo de trabalho implantado funcione. Apenas entidades no nível da pasta são incluídas como recursos da solução.

Superfícies compatíveis

As entidades do Data Fabric em Soluções são compatíveis com os seguintes tipos de fluxo de trabalho:

Superfície	Entidades no escopo de pastas	Observações
RPA (Studio Web)	✅	Suporte completo para compilação, depuração, implantação
RPA (Studio Desktop 26.10 LTS)	✅	Apenas contexto de soluções. As atividades clássicas exigem UiPath.DataService.Activities v26.10.0
BPMN do Maestro	✅
Caso do Maestro	✅
Fluxos de trabalho da API	✅
Agents	✅ (Pré-visualização)
Fluxo do Maestro	Via nós de entidade nativos	Usa nós integrados, não atividades de conector
Apps codificados	✅
Agentes de codificação	✅
Apps VB independentes	❌
RPA (UB) Apps	❌

Observação:

O Espaço de Trabalho local não é compatível com entidades com escopo de pasta por meio de atividades do conector do Data Service. O escopo da pasta está disponível apenas em espaços de trabalho em nuvem.

Ciclo de vida

1. Criar e modelar entidades

Crie entidades no nível da pasta na interface gráfica do Data Fabric. Defina o Local como Pasta e selecione a pasta do Orchestrator de destino. Você pode criar tanto entidades nativas quanto entidades federadas. Adicione campos, relacionamentos e conjuntos de escolhas conforme necessário.

Para obter regras de escopo de relacionamento, consulte Criação de relacionamentos. Para a configuração de entidades federadas, consulte Entidades virtuais.

2. Crie um fluxo de trabalho

No Studio Web ou Studio Desktop (26.10 LTS), adicione atividades do Data Service ao seu fluxo de trabalho. Cada atividade tem um seletor de escopo — escolha Pasta para trabalhar com entidades com escopo de pasta.

O escopo da pasta nas atividades clássicas requer UiPath.DataService.Activities v26.10.0 ou posterior, onde está disponível de forma geral. Para obter mais informações, consulte Atividades clássicas.

Apenas as entidades das pastas às quais você tem acesso são exibidas.

3. Depurar

Quando você depura um fluxo de trabalho dentro de uma Solução, a janela Configuração de debug mostra todos os recursos da Solução, incluindo entidades.

Para cada entidade, você pode:

• Usar a entidade existente — A depuração é executada na entidade em sua pasta atual.
• Substituir por uma entidade diferente — Selecione uma entidade compatível de outra pasta.
• Remover a seleção — Uma nova entidade é criada em uma pasta de depuração em seu espaço de trabalho pessoal, juntamente com suas dependências.

A substituição está disponível apenas para entidades referenciadas diretamente de uma atividade. Uma entidade relacionada (por exemplo, Entidade B referenciada pela Entidade A por meio de um campo de relacionamento) não é substituída, a menos que você adicione uma atividade separada que faz referência a ela diretamente em Recursos de plataforma.

Observação:

Ao substituir, certifique-se de que a entidade de substituição tenha um esquema compatível. relacionamentos incompatíveis ou campos ausentes podem causar erros durante a execução.

4. Publicar

Publique a solução a partir do Studio Web ou do Studio Desktop. O pacote inclui o fluxo de trabalho, esquemas de entidade, conjuntos de escolhas e relacionamentos. Apenas o esquema é empacotado — nenhum dado é incluído.

5. Implantar (instalar)

Implante o pacote em uma pasta de destino do Orchestrator ou do Studio Web.

Durante a implantação:

• As entidades no nível da pasta são criadas automaticamente na pasta de destino.
• Os conjuntos de escolhas e os relacionamentos são recriados.
• O fluxo de trabalho é associado às entidades recém-criadas.

Apenas o esquema é criado. Os dados existentes não são copiados. Cada ambiente mantém seus próprios dados.

Importante:

A criação de entidades em linha durante a implantação não é compatível. As entidades são criadas a partir do esquema definido no pacote da solução. Se você precisar criar entidades fora de uma Solução, use a interface gráfica do Data Fabric.

6. Executar (runtime)

Após a implantação, execute o fluxo de trabalho do Orchestrator. A automação interage com as entidades na pasta de destino, exatamente como fez durante o desenvolvimento.

Substituições de runtime por meio dos Requisitos do pacote

Após uma implantação da solução, você pode alterar qual entidade um fluxo de trabalho usa sem republicar. No Orchestrator, navegue até o processo implantado e abra a aba Requisitos do pacote . Substitua uma entidade por outra entidade compatível da mesma pasta ou de uma pasta diferente.

A entidade de substituição deve ter um esquema compatível. O fluxo de trabalho é executado usando a entidade substituída enquanto toda a lógica permanece inalterada.

Apenas entidades referenciadas diretamente de uma atividade aparecem nos Requisitos do pacote para substituição.

Observação:

A substituição do tempo de implantação não é compatível. As substituições de entidades estão disponíveis durante a depuração e no runtime por meio dos Requisitos do pacote.

7. Atualização

Quando você modificar o esquema da entidade (por exemplo, adicionar um novo campo), republique a solução e atualize a implantação no Orchestrator.

Durante a atualização:

• O esquema de entidade é atualizado na pasta de destino para corresponder à nova versão.
• Os dados existentes são preservados — nenhum registro é excluído ou substituído.
• Novos campos são adicionados ao esquema. Os campos removidos são descartados do esquema, mas os dados subjacentes são mantidos.
• Se a entidade já contiver dados, você poderá revisar quais alterações são aplicadas antes de confirmar a atualização.
• Se as alterações de esquema forem incompatíveis (por exemplo, uma alteração do tipo de campo), a atualização exibirá um conflito. Navegue até a interface gráfica do Data Fabric para revisar e resolver o conflito entre os esquemas de entidades de origem e de destino antes de tentar novamente a atualização.

8. Desinstalar

Desinstalar uma solução remove o fluxo de trabalho e recursos associados da pasta de destino.

O comportamento da entidade durante a desinstalação depende de se a entidade contém dados:

• Entidades sem dados — Removidas junto com seus conjuntos de escolhas e relacionamentos.
• Entidades com dados — Preservadas para evitar perda de dados acidental. A entidade permanece na pasta e pode ser gerenciada diretamente na interface gráfica do Data Fabric, a menos que a pasta seja excluída.

Resumo do comportamento do ciclo de vida

Operação	Esquema de entidade	Dados da entidade	Conjuntos de Escolhas	relacionamentos
Instalar	Criado na pasta de destino	Não copiado — começa vazio	Recriado	Recriado
Atualização	Atualizado para corresponder à nova versão	Preservado	atualizou	atualizou
Desinstalar (sem dados)	removido	N/A	removido	removido
Desinstalar (tem dados)	Preservado	Preservado	Preservado	Preservado

Atualização do esquema

Quando um esquema de entidade for alterado no Data Fabric após você já selecioná-lo em uma atividade, use o botão Atualizar ao lado do seletor de entidade no Studio Web. O botão Atualizar atualiza o esquema da entidade selecionada e todas as suas entidades relacionadas em uma única ação.

• Atividades do conector (conector do Data Fabric) — O botão Atualizar está sempre habilitado. Para ver campos recém-adicionados ou removidos, primeiro abra o recurso Solução para a entidade e selecione Atualizar Configuração; em seguida, retorne à atividade e selecione Atualizar Esquema.
• Atividades legadas (pacote clássico do Data Service) — Para entidades nativas, o botão Atualizar é habilitado apenas quando uma alteração de esquema é detectada para a entidade selecionada. Selecioná-la atualiza o esquema diretamente. A atualização do esquema para entidades federadas não é compatível com essas atividades.

Clonagem de entidades entre escopos

Você pode copiar um esquema de entidade de um escopo para outro usando a exportação e a importação. Por exemplo, para usar um design de entidade no nível do tenant em uma pasta, você exporta o esquema do nível do tenant na interface gráfica do Data Fabric, que exporta todos os esquemas de entidade nativos no nível do tenant de uma vez. Em seguida, você importa esse arquivo no nível da pasta de destino, escolhendo qual das entidades e conjuntos de escolhas exportados traz para a pasta.

As entidades selecionadas são criadas na pasta de destino com o mesmo esquema. Nenhum dado é copiado. Para o procedimento detalhado de exportação e importação, consulte Exportação e importação de esquemas.

Restrições conhecidas

As entidades no nível da pasta em Soluções têm limitações sobre substituições no tempo de implantação, relacionamentos entre escopos, nomenclatura da entidade e superfícies não compatíveis. Para a lista completa, consulte Limitações conhecidas.