Entités dans les solutions

Cycle de vie d’entité Data Fabric dans Solutions, couvrant l’inclusion automatique des dépendances, la gestion de l’installation, de la mise à niveau et de la désinstallation, ainsi que le remplacement des entités lors du débogage et du runtime.

Les entités Data Fabric peuvent être incluses en tant que ressources dans une solution. Lorsque vous utilisez une entité au niveau du dossier dans un workflow qui appartient à une solution, l'entité et ses dépendances sont empaquetées, déployées et gérées dans le cadre du cycle de vie de la solution.

Cette page explique le comportement des entités à chaque étape, de la modélisation au déploiement, à l'exécution, à la mise à niveau et à la désinstallation.

Comment une entité devient une ressource de solution

Lorsque vous ajoutez une activité Data Service à un workflow dans une solution et sélectionnez une entité au niveau du dossier, cette entité est automatiquement enregistrée en tant que ressource de solution. Vous n’avez pas besoin de l’ajouter manuellement.

Inclusion automatique des dépendances

L'ajout d'une entité en tant que ressource de solution inclut également toutes ses dépendances. Les dépendances incluses diffèrent en fonction du type d’entité.

Entités natives

• Entités connexes : si l'entité A a un champ de relation pointant vers l'entité B, les deux entités sont ajoutées en tant que ressources de solution.
• Ensembles de choix - Tout ensemble de choix utilisé comme type de champ dans l'entité est inclus.
• Dépendances imbriquées - Si l'entité B fait référence à l'entité C, cette entité est également incluse. La chaîne de dépendances complète est résolue automatiquement.

Entités fédérées

• Connexions : les connexions Integration Service utilisées par l’entité fédérée sont incluses.
• Entités source natives - Si une entité fédérée fait référence à une entité native comme source de données, cette entité native et sa chaîne de dépendances complète sont incluses.

Remarque :

Les entités au niveau du locataire utilisées dans un workflow ne sont pas automatiquement empaquetées. Elles doivent déjà exister dans l’environnement cible pour que le workflow déployé fonctionne. Seules les entités au niveau du dossier sont incluses en tant que ressources de solution.

Surfaces prises en charge

Les entités Data Fabric dans les solutions sont prises en charge dans les types de workflow suivants:

Surface	Entités à l’échelle du dossier	Remarques
RPA (Studio Web)	✅	Prise en charge complète de la création, du débogage et du déploiement
RPA (Studio Desktop 26.10 LTS)	✅	Contexte des solutions uniquement. Les activités classiques nécessitent UiPath.DataService.Activities v26.10.0
BPMN Maestro	✅
Cas Maestro	✅
Workflows d’API	✅
Agents	✅ (Aperçu)
Flux Maestro	Via des nœuds d’entité natifs	Utilise des nœuds intégrés, pas des activités de connecteur
Coded Apps	✅
Agents de codage	✅
Standalone VB Apps	❌
RPA (UB) Apps	❌

Remarque :

L’espace de travail local n’est pas pris en charge pour les entités à l'échelle des dossiers via les activités du connecteur Data Service. L'étendue du dossier est disponible uniquement dans les espaces de travail Cloud.

Cycle de vie

1. Créer et modéliser des entités

Créez des entités au niveau du dossier dans l'interface utilisateur de Data Fabric. Définissez l' emplacement sur Dossier et sélectionnez le dossier Orchestrator cible. Vous pouvez créer à la fois des entités natives et des entités fédérées. Ajoutez des champs, des relations et des ensembles de choix selon les besoins.

Pour les règles d’étendue des relations, reportez-vous à la section Créer des relations. Pour la configuration de l’entité fédérée, reportez-vous à la section Entités virtuelles.

2. Créer un workflow

Dans Studio Web ou Studio Desktop (26.10 LTS), ajoutez des activités Data Service à votre workflow. Chaque activité dispose d'un sélecteur d'étendue . Choisissez Dossier pour travailler avec les entités à l'échelle des dossiers.

L'étendue du dossier dans les activités classiques nécessite UiPath.DataService.Activities v26.10.0 ou une version ultérieure, où elle est généralement disponible. Pour plus d'informations, consultez la section Activités classiques.

Seules les entités des dossiers auxquels vous avez accès sont affichées.

3. Déboguer

Lorsque vous déboguez un workflow dans une solution, la fenêtre Déboguer la configuration affiche toutes les ressources de la solution, y compris les entités.

Pour chaque entité, vous pouvez :

• Utiliser l'entité existante - Le débogage s'exécute sur l'entité dans son dossier actuel.
• Remplacer par une entité différente - Sélectionnez une entité compatible dans un autre dossier.
• Supprimer la sélection — Une nouvelle entité est créée dans un dossier de débogage de votre espace de travail personnel, avec ses dépendances.

Le remplacement est disponible uniquement pour les entités directement référencées à partir d'une activité. Une entité associée (par exemple, l'entité B référencée par l'entité A via un champ de relation) n'est pas remplaçable, sauf si vous ajoutez une activité distincte qui la référence directement depuis Ressources de la plate-forme.

Remarque :

Lors du remplacement, assurez-vous que l’entité de remplacement dispose d’un schéma compatible. Des relations non correspondantes ou des champs manquants peuvent provoquer des erreurs lors de l'exécution.

4. Publier

Publiez la solution depuis Studio Web ou Studio Desktop. Le package inclut le workflow, les schémas d'entité, les ensembles de choix et les relations. Seul le schéma est empaqueté - aucune donnée n'est incluse.

5. Déployer (installer)

Déployez le package dans un dossier cible à partir d'Orchestrator ou de Studio Web.

Au cours du déploiement:

• Les entités au niveau du dossier sont créées automatiquement dans le dossier cible.
• Les ensembles de choix et les relations sont recréés.
• Le workflow est lié aux entités nouvellement créées.

Seul le schéma est créé. Les données existantes ne sont pas copiées. Chaque environnement conserve ses propres données.

Important :

La création d’une entité en ligne pendant le déploiement n’est pas prise en charge. Les entités sont créées à partir du schéma défini dans le package Solution. Si vous devez créer des entités en dehors d'une solution, utilisez l'interface utilisateur de Data Fabric.

6. Exécuter

Après le déploiement, exécutez le workflow à partir d’Orchestrator. L'automatisation interagit avec les entités du dossier cible, exactement comme lors du développement.

Remplacements de runtime via les exigences du package

Une fois qu’une solution est déployée, vous pouvez modifier l’entité utilisée par un workflow sans avoir à republier. Dans Orchestrator, accédez au processus déployé et ouvrez l'onglet Exigences du package . Remplacez une entité par une autre entité compatible du même dossier ou d’un dossier différent.

L’entité de remplacement doit disposer d’un schéma compatible. Le workflow s’exécute à l’aide de l’entité remplacée tandis que toute la logique reste inchangée.

Seules les entités directement référencées à partir d'une activité apparaissent dans les exigences du package pour le remplacement.

Remarque :

Le remplacement au moment du déploiement n’est pas pris en charge. Les remplacements d'entité sont disponibles lors du débogage et du runtime via les exigences du package.

7. Mettre à niveau

Lorsque vous modifiez le schéma d'entité (par exemple, ajoutez un nouveau champ), republiez la solution et mettez à niveau le déploiement dans Orchestrator.

Lors de la mise à niveau:

• Le schéma d’entité est mis à jour dans le dossier cible pour correspondre à la nouvelle version.
• Les données existantes sont conservées - aucun enregistrement n’est supprimé ou écrasé.
• De nouveaux champs sont ajoutés au schéma. Les champs supprimés sont supprimés du schéma, mais les données sous-jacentes sont conservées.
• Si l'entité contient déjà des données, vous pouvez examiner les modifications appliquées avant de confirmer la mise à niveau.
• Si les modifications du schéma sont incompatibles (par exemple, un changement de type de champ), la mise à niveau affiche un conflit. Accédez à l'interface utilisateur de Data Fabric pour examiner et résoudre le conflit entre les schémas d'entité source et de destination avant de réessayer la mise à niveau.

8. Désinstaller

La désinstallation d’une solution supprime le workflow et les ressources associées du dossier cible.

Le comportement de l’entité lors de la désinstallation dépend du fait que l’entité contient des données:

• Entités sans données - Supprimées avec leurs ensembles de choix et leurs relations.
• Entités avec des données — Conservées pour éviter la perte de données accidentelle. L'entité reste dans le dossier et peut être gérée directement dans l'interface utilisateur de Data Fabric, sauf si le dossier est supprimé.

Résumé du comportement du cycle de vie

Opération (Operation)	Schéma d'entité	Données d’entité	Ensembles de choix	Relations
Installer	Créé dans le dossier cible	Non copié — commence vide	Recréé	Recréé
Mettre à niveau	Mis à jour afin de correspondre à la nouvelle version	Conservé	a mis à jour	a mis à jour
Désinstaller (aucune donnée)	a supprimé	S/O	a supprimé	a supprimé
Désinstaller (contient des données)	Conservé	Conservé	Conservé	Conservé

Actualisation du schéma

Lorsqu'un schéma d'entité change dans Data Fabric après que vous l'avez déjà sélectionné dans une activité, utilisez le bouton Actualiser à côté du sélecteur d'entité dans Studio Web. Le bouton Actualiser met à jour le schéma de l'entité sélectionnée et de toutes ses entités associées dans une seule action.

• Activités du connecteur (connecteur Data Fabric) : le bouton Actualiser est toujours activé. Pour voir les champs nouvellement ajoutés ou supprimés, ouvrez d’abord la ressource de solution pour l’entité et sélectionnez Mettre à jour la configuration, puis revenez à l’activité et sélectionnez Actualiser le schéma.
• Activités héritées (package classique Data Service) : pour les entités natives, le bouton Actualiser est activé uniquement lorsqu’une modification de schéma est détectée pour l’entité sélectionnée. Si vous la sélectionnez, le schéma sera directement mis à jour. L’actualisation du schéma pour les entités fédérées n’est pas prise en charge dans ces activités.

Clonage des entités entre les étendues

Vous pouvez copier un schéma d'entité depuis une étendue à une autre à l'aide de l'exportation et de l'importation. Par exemple, pour utiliser une conception d'entité au niveau du locataire dans un dossier, vous exportez le schéma à partir du niveau du locataire dans l'interface utilisateur de Data Fabric, qui exporte tous les schémas d'entité natifs au niveau du locataire en même temps. Vous importez ensuite ce fichier au niveau du dossier cible, en choisissant les entités et les ensembles de choix exportés à ajouter au dossier.

Les entités sélectionnées sont créées dans le dossier cible avec le même schéma. Aucune donnée n'est copiée. Pour connaître la procédure d’exportation et d’importation détaillée, consultez la section Exportation et importation de schémas.

Limites connues

Les entités au niveau du dossier dans les solutions comportent des limitations sur les remplacements au moment du déploiement, les relations entre l'étendue, le nommage des entités et les surface non prises en charge. Pour obtenir la liste complète, reportez-vous à Limitations connues.