Modellbibliotheken

Die Ansicht Model Libraries im Data Refinery Studio bietet eine zentrale Oberfläche zur Verwaltung von Construction-Kit-(CK-)Modellbibliotheken innerhalb eines Tenants. Sie zeigt alle installierten und verfügbaren Bibliotheken, ihre Versionen und ihren Kompatibilitätsstatus und stellt Werkzeuge zum Importieren und Aktualisieren von Bibliotheken bereit.

Zugriff auf Model Libraries

Wählen Sie in der Rail Data > Model libraries. Die Kopfzeile zeigt die Anzahl der Modelle (z. B. „37 models“).

Bibliotheksüberblick

Die Hauptansicht zeigt alle bekannten CK-Modellbibliotheken in einer Liste und kombiniert dabei Informationen aus:

• Installierten Modellen im aktuellen Tenant (über GraphQL)
• Verfügbaren Modellen aus konfigurierten Katalogquellen (über REST-API)

Jeder Bibliothekseintrag zeigt:

• Name — Klicken Sie darauf, um den Dialog Available Versions zu öffnen
• Version — Installierte Version und, falls vorhanden, die neuere Katalogversion (z. B. v2.4.0 → v2.5.0 available)
• Dependencies (installed) — Die Modelle, von denen die installierte Version abhängt, mit ihren Versionen
• State badge — Aktueller Status (siehe unten)
• History — Öffnet den Dialog Migration History: jede Installation und Migration des Modells mit Versionen, Zeit, Ergebnis (OK) und Dauer
• Action button — Verfügbare Aktion (siehe unten)

Status-Badges

Badge	Bedeutung
Available (grün)	Modell ist installiert und aktuell
Unavailable (rot)	Modell hat ungelöste Abhängigkeiten (ResolveFailed)
Importing (orange)	Der Import des Modells läuft gerade
Not Installed (grau)	Modell existiert im Katalog, ist aber nicht installiert
Service-Managed (violett)	Modell wird von OctoMesh-Diensten verwaltet (System, System.Identity usw.)
Incompatible (grau, mit Tooltip)	Modell erfordert eine andere Hauptversion eines Systemmodells
Blocked (rot, mit Tooltip)	Das angebotene Update würde ein installiertes Modell beschädigen, siehe Blockierte Updates

Aktionsschaltflächen

Pro Modell wird nur eine Aktionsschaltfläche angezeigt:

• Install — Modell ist noch nicht installiert
• Fix — Modell ist installiert, hat aber den Status ResolveFailed
• Update — Eine neuere kompatible Version ist in den Katalogen verfügbar
• Keine Schaltfläche für dienstverwaltete oder inkompatible Modelle
• Bei einem Blocked-Modell wird die Schaltfläche Update (bzw. Fix) deaktiviert angezeigt; ihr Tooltip nennt den ersten Grund

Blockierte Updates

Ein Modell ist Blocked, wenn der Import der angebotenen Version ein anderes installiertes Modell beschädigen würde, z. B. weil EnergyCommunity.Registration-2.8.0 auf Basic-2.4.0 festgelegt ist und das Update Basic-2.5.0 mitbringt. Das ist der Tenant-Upgrade-Guard; das Studio zeigt sein Ergebnis und startet ein blockiertes Update nie. Das Studio hat keine Force-Aktion: Ein beschädigendes Update zu erzwingen ist eine Operation der octo-cli und der API für Datenmodell-Verantwortliche.

Eine blockierte Zeile zeigt:

• das rote Blocked-Badge neben dem Status-Badge; sein Tooltip nennt den ersten Grund
• die deaktivierte Schaltfläche Update bzw. Fix mit demselben Tooltip
• die Schaltfläche Why?, die die Liste der Blocker aufklappt (Hide details klappt sie wieder zu). Jeder Blocker nennt das blockierte Modell (das installierte Modell, das beschädigt würde), das Update, das es verursacht, die betroffene fest verankerte Abhängigkeit, den erforderlichen Bereich oder das Element und, wenn die Kataloge eine neuere Version des blockierten Modells anbieten, die das Problem löst, How to resolve (z. B. update EnergyCommunity.Registration to 2.10.0 first)

Die Kopfzeile zeigt die Anzahl der blockierten Modelle, und die Filterleiste erhält einen Filter Blocked (n), solange es blockierte Modelle gibt. Aktualisieren Sie zuerst das blockierte Modell (der Hinweis nennt die Version), danach das Modell, das blockiert war.

Ein älteres Asset Repository meldet keine Blocker; die Seite sieht dann aus und funktioniert wie bisher.

Filtern & Suchen

Die Filterleiste am oberen Rand bietet:

• Kategoriefilter: All, Installed, Not installed, Updates, New versions — jeweils mit der Anzahl der passenden Modelle
• Textsuche: Filtern nach Modellname oder Version
• Filter Blocked (n): Erscheint, wenn mindestens ein angebotenes Update blockiert ist
• Schaltfläche Fix all (n): Erscheint, wenn Modelle eine Aktion benötigen, mit der Anzahl der Modelle; öffnet den Import-Dialog für alle Modelle auf einmal. Blockierte Modelle gehören nicht dazu
• Refresh catalogs: Lädt die verfügbaren Modelle aus den Katalogquellen neu

Versions-Dialog

Klicken Sie auf einen Modellnamen, um den Dialog <Modell> - Available Versions zu öffnen. Er zeigt:

• Alle über die Kataloge verfügbaren Versionen, neueste zuerst sortiert, jeweils mit dem Katalog, aus dem sie stammen (z. B. LocalFileSystemCatalog, PrivateGitHubCatalog)
• Die aktuell installierte Version, markiert mit Installed
• Eine Install-Schaltfläche pro nicht installierter Version
• Close schließt den Dialog

Import-Dialog

Beim Klicken auf Install, Update, Fix oder Fix All öffnet sich der Import-Dialog:

1. Abhängigkeitsbaum — Zeigt alle transitiven Abhängigkeiten mit ihrem Status:
   • install (blau) — muss importiert werden
   • update (orange) — es wird eine andere Version importiert
   • none (grün) — bereits installiert oder dienstverwaltet
   • incompatible (rot) — erfordert eine inkompatible Systemversion
2. Migrationswarnung — Wenn der Import eine CK-Modellmigration auslöst, werden Details angezeigt, einschließlich Indikatoren für Breaking Changes
3. Import-Zusammenfassung — Listet alle Modelle, die importiert werden, als Badges auf
4. Inkompatibilitätswarnung — Wenn eine transitive Abhängigkeit inkompatibel ist, wird die Import-Schaltfläche mit einer Erläuterung deaktiviert
5. Blockiert-Bereich — Würden die zu importierenden Modelle ein installiertes Modell beschädigen, listet der Bereich Blocked: this update would break installed models die Blocker auf (siehe Blockierte Updates), und die Import-Schaltfläche ist deaktiviert
6. Import-Schaltfläche — Zeigt die Anzahl der zu importierenden Modelle; deaktiviert bei Inkompatibilität oder Blockade

Nach dem Klick auf Import wird jedes Modell nacheinander über Hintergrund-Jobs importiert. Ein Fortschrittsdialog verfolgt jeden Job einzeln und zeigt den Modellnamen und einen Fortschrittszähler (z. B. „Importing Industry.Basic-2.1.0 (1/2)").

Fix all

Die Schaltfläche Fix all (n) in der Filterleiste:

1. Löst die Abhängigkeiten für alle Modelle auf, die eine Aktion benötigen
2. Öffnet den Dialog Fix all: import summary mit dem kombinierten Abhängigkeitsbaum (jedes Modell mit seinen Abhängigkeiten und deren Status, z. B. install (installed: v2.4.0) oder none)
3. Zeigt eine Zusammenfassung aller Modelle, die importiert werden
4. Importiert nach Bestätigung alle Modelle in Abhängigkeitsreihenfolge

Blockierte Modelle (siehe Blockierte Updates) werden ausgelassen. Nach dem Klick listet ein Hinweis n blocked models skipped by Fix all jedes übersprungene Modell mit seinem Grund; Dismiss schließt ihn. Würde der kombinierte Import trotzdem ein installiertes Modell beschädigen, zeigt der Dialog die Blocker, und seine Import-Schaltfläche bleibt deaktiviert.

Vom Server abgelehnter Import

Wird ein Import abgelehnt, obwohl die Seite ihn angeboten hat (z. B. weil die Seite länger offen war und sich der Tenant inzwischen geändert hat), öffnet sich statt eines allgemeinen Fehlers der Dialog Update blocked. Er sagt, dass nichts importiert wurde, und listet dieselben Blocker wie das Panel Why?. Close schließt ihn; die Liste wird neu geladen und zeigt den aktuellen Stand.