Entitäten in Lösungen

Lebenszyklus der Data Fabric-Entität in Lösungen, der die automatische Einbeziehung von Abhängigkeiten, die Installation, Aktualisierung und Deinstallation sowie die Überschreibung von Entitäten zur Debugging- und Runtime abdeckt.

Data Fabric-Entitäten können als Ressourcen in eine Lösung aufgenommen werden. Wenn Sie eine Entität auf Ordnerebene in einem Workflow verwenden, der zu einer Lösung gehört, werden die Entität und ihre Abhängigkeiten als Teil des Lösungslebenszyklus gepackt, bereitgestellt und verwaltet.

Auf dieser Seite wird beschrieben, wie sich Entitäten in jeder Phase verhalten – von der Modellierung über Bereitstellung, Runtime, Upgrade und Deinstallation.

Wie eine Entität zur Lösungsressource wird

Wenn Sie eine Data Service-Aktivität zu einem Workflow innerhalb einer Lösung hinzufügen und eine Entität auf Ordnerebene auswählen, wird diese Entität automatisch als Lösungsressource registriert. Sie müssen es nicht manuell hinzufügen.

Automatische Einbeziehung von Abhängigkeiten

Das Hinzufügen einer Entität als Lösungsressource umfasst auch alle ihre Abhängigkeiten. Die enthaltenen Abhängigkeiten unterscheiden sich je nach Entitätstyp.

Native Entitäten

• Zugehörige Entitäten – Wenn Entität A ein Beziehungsfeld auf Entität B verweist, werden beide Entitäten als Lösungsressourcen hinzugefügt.
• Auswahlsätze – Jeder Auswahlsatz, der als Feldtyp in der Entität verwendet wird, ist enthalten.
• Geschachtelte Abhängigkeiten – Wenn Entität B selbst auf Entität C verweist, ist diese Entität ebenfalls enthalten. Die vollständige Abhängigkeitskette wird automatisch aufgelöst.

Verbundentitäten

• Verbindungen – Integration Service-Verbindungen, die von der Verbundentität verwendet werden, sind enthalten.
• Native Entität – Wenn eine Verbundentität auf eine native Entität als Datenquelle verweist, sind diese native Entität und ihre vollständige Abhängigkeitskette enthalten.

Hinweis:

Entitäten auf Mandantenebene, die in einem Workflow verwendet werden, werden nicht automatisch gepackt. Sie müssen bereits in der Zielumgebung vorhanden sein, damit der bereitgestellte Workflow funktioniert. Nur Entitäten auf Ordnerebene sind als Lösungsressourcen enthalten.

Unterstützte Oberflächen

Data Fabric-Entitäten in Lösungen werden für die folgenden Workflowtypen unterstützt:

Oberfläche	Entitäten mit Ordner-Scope	Hinweise
RPA (Studio Web)	✅	Vollständige Unterstützung für das Erstellen, Debuggen und Bereitstellen
RPA (Studio Desktop 26.10 langfristiger Support)	✅	Nur Lösungskontext. Klassische Aktivitäten erfordern UiPath.DataService.Activities v26.10.0
Maestro-BPMN	✅
Maestro-Fall	✅
API-Workflows	✅
Agents	✅ (Vorschau)
Maestro-Flow	Über native Entitätsknoten	Verwendet integrierte Knoten, keine Connector-Aktivitäten
Codierte Apps	✅
Codierungs-Agents	✅
Eigenständige VB-Apps	❌
RPA-Apps (UB).	❌

Hinweis:

Lokaler Arbeitsbereich wird für Entitäten mit Ordner-Scope über Data Service-Connector-Aktivitäten nicht unterstützt. Der Ordner-Scope ist nur in Cloud-Arbeitsbereichen verfügbar.

Lebenszyklus

1. Entitäten erstellen und modellieren

Erstellen Sie Entitäten auf Ordnerebene in der Data Fabric-Benutzeroberfläche. Legen Sie den Speicherort auf Ordner fest und wählen Sie den Ziel-Orchestrator-Ordner aus. Sie können sowohl native Entitäten als auch Verbundentitäten erstellen. Fügen Sie Felder, Beziehungen und Auswahlsätze nach Bedarf hinzu.

Regeln für den Umfang von Beziehungen finden Sie unter Erstellen von Beziehungen. Informationen zur Einrichtung einer Verbundentität finden Sie unter Virtuelle Entitäten.

2. Erstellen Sie einen Workflow

Fügen Sie in Studio Web oder Studio Desktop (26.10 LTS) Data Service-Aktivitäten zu Ihrem Workflow hinzu. Jede Aktivität hat einen Scope-Selektor – wählen Sie Ordner aus, um mit Entitäten mit Ordner-Scope zu arbeiten.

Der Ordner-Scope in den klassischen Aktivitäten erfordert UiPath.DataService.Activities v26.10.0 oder höher, wo er allgemein verfügbar ist. Weitere Informationen finden Sie unter Klassische Aktivitäten.

Es werden nur Entitäten aus Ordnern angezeigt, auf die Sie Zugriff haben.

3. Debuggen

Wenn Sie einen Workflow innerhalb einer Lösung debuggen, zeigt das Fenster Debug-Konfiguration alle Lösungsressourcen an, einschließlich Entitäten.

Sie können für jede Entität:

• Vorhandene Entität verwenden – Debug wird für die Entität in ihrem aktuellen Ordner ausgeführt.
• Mit einer anderen Entität überschreiben – Wählen Sie eine kompatible Entität aus einem anderen Ordner aus.
• Auswahl entfernen – Eine neue Entität wird in einem Debug-Ordner in Ihrem persönlichen Arbeitsbereich zusammen mit ihren Abhängigkeiten erstellt.

Überschreiben ist nur für Entitäten verfügbar, auf die direkt über eine Aktivität verwiesen wird. Eine verwandte Entität (z. B. Entität B, auf die Entität A über ein Beziehungsfeld verweisen) ist nicht überschreibbar, es sei denn, Sie fügen eine separate Aktivität hinzu, die direkt unter Plattformressourcen darauf verweist.

Hinweis:

Stellen Sie beim Überschreiben sicher, dass die Ersatzentität über ein kompatibles Schema verfügt. Nicht übereinstimmende Beziehungen oder fehlende Felder können während der Ausführung Fehler verursachen.

4. Veröffentlichen

Die Lösung über Studio Web oder Studio Desktop Veröffentlichen . Das Paket enthält den Workflow, Entitätsschemas, Auswahlsätze und Beziehungen. Nur das Schema ist gepackt – es sind keine Daten enthalten.

5. Bereitstellen (Installieren)

Stellen Sie das Paket über den Orchestrator oder von Studio Web in einem Zielordner bereit.

Während der Bereitstellung:

• Entitäten auf Ordnerebene werden automatisch im Zielordner erstellt.
• Auswahlsätze und Beziehungen werden neu erstellt.
• Der Workflow ist an die neu erstellten Entitäten gebunden.

Nur das Schema wird erstellt. Vorhandene Daten werden nicht kopiert. Jede Umgebung verwaltet ihre eigenen Daten.

Wichtig:

Die Erstellung von Inline-Entitäten während der Bereitstellung wird nicht unterstützt. Entitäten werden aus dem im Lösungspaket definierten Schema erstellt. Wenn Sie Entitäten außerhalb einer Lösung erstellen müssen, verwenden Sie die Data Fabric-Benutzeroberfläche.

6. Ausführen (Runtime)

Führen Sie nach der Bereitstellung den Workflow über den Orchestrator aus. Die Automatisierung interagiert mit den Entitäten im Zielordner, genau wie während der Entwicklung.

Runtime-Überschreibungen über Paketanforderungen

Nachdem eine Lösung bereitgestellt wurde, können Sie ändern, welche Entität ein Workflow verwendet, ohne erneut zu veröffentlichen. Navigieren Sie im Orchestrator zum bereitgestellten Prozess und öffnen Sie die Registerkarte Paketanforderungen . Ersetzen Sie eine Entität durch eine andere kompatible Entität aus demselben oder einem anderen Ordner.

Die Ersatzentität muss über ein kompatibles Schema verfügen. Der Workflow wird mit der überschriebenen Entität ausgeführt, während die gesamte Logik unverändert bleibt.

Nur Entitäten, auf die direkt von einer Aktivität verwiesen wird, werden in den Paketanforderungen für die Überschreibung angezeigt.

Hinweis:

Eine Überschreibung der Bereitstellungszeit wird nicht unterstützt. Entitätsüberschreibungen sind während des Debuggens und zur Runtime über die Paketanforderungen verfügbar.

7. Führen Sie ein Upgrade durch

Wenn Sie das Entitätsschema ändern (z. B. ein neues Feld hinzufügen), veröffentlichen Sie die Lösung erneut und aktualisieren Sie die Bereitstellung im Orchestrator.

Während des Upgrades:

• Das Entitätsschema wird im Zielordner aktualisiert, um der neuen Version zu entsprechen.
• Vorhandene Daten werden beibehalten – es werden keine Datensätze gelöscht oder überschrieben.
• Dem Schema werden neue Felder hinzugefügt. Entfernte Felder werden aus dem Schema verworfen, aber die zugrunde liegenden Daten werden beibehalten.
• Wenn die Entität bereits Daten enthält, können Sie überprüfen, welche Änderungen angewendet werden, bevor Sie das Upgrade bestätigen.
• Wenn Schemaänderungen nicht kompatibel sind (z. B. eine Feldtypänderung), zeigt das Upgrade einen Konflikt an. Navigieren Sie zur Data Fabric-Benutzeroberfläche, um den Konflikt zwischen den Quell- und Zielentitätsschemas zu überprüfen und zu beheben, bevor Sie das Upgrade wiederholen.

8. Deinstallieren

Wenn Sie eine Lösung deinstallieren, werden der Workflow und die zugehörigen Ressourcen aus dem Zielordner entfernt.

Das Verhalten der Entität während der Deinstallation hängt davon ab, ob die Entität Daten enthält:

• Entitäten ohne Daten – Entfernt zusammen mit ihren Auswahlsätzen und Beziehungen.
• Entitäten mit Daten – Erhalten, um versehentlichen Datenverlust zu verhindern. Die Entität verbleibt im Ordner und kann direkt in der Data Fabric-Benutzeroberfläche verwaltet werden, es sei denn, der Ordner wird gelöscht.

Zusammenfassung des Lebenszyklusverhaltens

Betrieb	Entitätsschema	Entitätsdaten	Auswahlsätze	Beziehungen
Installieren	Erstellt im Zielordner	Nicht kopiert – beginnt leer	Neu erstellt	Neu erstellt
Aktualisierung	Aktualisiert, um der neuen Version zu entsprechen	Beibehalten	aktualisiert	aktualisiert
Deinstallieren (keine Daten)	entfernt	Keine Angabe	entfernt	entfernt
Deinstallieren (hat Daten)	Beibehalten	Beibehalten	Beibehalten	Beibehalten

Schemaaktualisierung

Wenn sich ein Entitätsschema in Data Fabric ändert, nachdem Sie es bereits in einer Aktivität ausgewählt haben, verwenden Sie die Schaltfläche Aktualisieren neben dem Entitätsselektor in Studio Web. Die Schaltfläche Aktualisieren aktualisiert das Schema der ausgewählten Entität und alle damit verbundenen Entitäten in einer einzigen Aktion.

• Connector-Aktivitäten (Data Fabric-Connector) – Die Schaltfläche Aktualisieren ist immer aktiviert. Um neu hinzugefügte oder entfernte Felder anzuzeigen, öffnen Sie zuerst die Lösungsressource für die Entität und wählen Sie Konfiguration aktualisieren aus, kehren Sie dann zur Aktivität zurück und wählen Sie Schema aktualisieren aus.
• Legacy-Aktivitäten (klassisches Paket von Data Service) – Für native Entitäten ist die Schaltfläche Aktualisieren nur aktiviert, wenn eine Schemaänderung für die ausgewählte Entität erkannt wird. Wenn Sie diese auswählen, wird das Schema direkt aktualisiert. Die Schemaaktualisierung für Verbundentitäten wird in diesen Aktivitäten nicht unterstützt.

Klonen von Entitäten über Scopes hinweg

Sie können ein Entitätsschema mithilfe von Exportieren und Importieren von einem Scope in einen anderen kopieren. Um beispielsweise ein Entitätsdesign auf Mandantenebene in einem Ordner zu verwenden, exportieren Sie das Schema von der Mandantenebene in der Data Fabric-Benutzeroberfläche, die alle nativen Entitätsschemas auf Mandantenebene gleichzeitig exportiert. Sie importieren diese Datei dann auf der Zielordnerebene und wählen aus, welche der exportierten Entitäten und Auswahlsätze in den Ordner gebracht werden sollen.

Die ausgewählten Entitäten werden im Zielordner mit demselben Schema erstellt. Es werden keine Daten kopiert. Ausführliche Informationen zum Exportieren und Importieren finden Sie unter Schemaexport und -import.

Bekannte Einschränkungen

Entitäten auf Ordnerebene in Lösungen haben Einschränkungen bei Überschreibungen zur Bereitstellungszeit, Scope-übergreifenden Beziehungen, Entitätsbenennung und nicht unterstützten Oberflächen. Die vollständige Liste finden Sie unter Bekannte Einschränkungen.