Zum Hauptinhalt springen

Externe Daten importieren & synchronisieren

Bringen Sie Objekte aus einem externen System (z. B. dbt, Snowflake, Power BI) als extern verwaltete Objekte in Ihr Modell ein und halten Sie sie synchron, während sich die Quelle ändert.

Enterprise-Edition

Importieren​

  1. Öffnen Sie Model Actions ▸ External ▸ Import External Data.

  2. Fügen Sie ein Payload im itb-Format ein oder laden Sie es aus einer .json-Datei.

    Externe Daten importieren – Einfügeschritt

  3. Überprüfen Sie die Vorschau: Objekte zum Erstellen, Aktualisieren, Löschen sowie etwaige Kollisionen (siehe unten). Kritische Änderungen – etwa das Löschen eines Objekts, von dem eine von Benutzern gezeichnete Beziehung abhängt – werden mit einer Warnung gekennzeichnet.

    Importvorschau mit Erstellen / Aktualisieren / Löschen und Kollisionen

  4. Wählen Sie optional eine Zielgruppe und Ansicht, auf der die importierten Objekte platziert werden.

  5. Schließen Sie ab, um alles als einen einzigen, rückgängig machbaren Schritt anzuwenden.

Verwaltete Objekte sind schreibgeschützt​

Importierte Objekte tragen ein Abzeichen „Verwaltet von …“ (das die externe Quelle benennt) und sind in der Benutzeroberfläche schreibgeschützt – ihre Felder, Attribute und Werte benutzerdefinierter Eigenschaften gehören der Quelle. Sie können dennoch Ihre eigenen Attribute und benutzerdefinierten Eigenschaften daneben hinzufügen; diese bleiben bearbeitbar.

Erneutes Synchronisieren​

Ein erneuter Import gleicht das Modell mit dem aktuellsten Payload ab: geänderte Objekte werden aktualisiert, Objekte, die nicht mehr im Payload enthalten sind, werden entfernt (mit Integritätsprüfungen, sodass eine gemeinsam genutzte Endpunkt-Entität niemals unter einer Beziehung weggelöscht wird), und ein leeres Payload entfernt die gesamte Quelle.

Kollisionen & Übernahme​

Wenn die Quelle ein Objekt liefert, das mit einem übereinstimmt, das Sie bereits von Hand hinzugefügt haben (gleicher Name am gleichen Übergeordneten oder gleiche Endpunkte + Typ bei einer Beziehung), listet die Vorschau es unter Kollisionen auf. Standardmäßig wird das lokale Objekt übernommen – es wird als verwaltet gekennzeichnet und die Quelle besitzt es fortan –, sodass Sie niemals stille Duplikate erhalten. Pro Kollision können Sie stattdessen beide behalten oder das eingehende Objekt überspringen.