Zum Inhalt springen
JelinaJelina DocumentationTechnische Dokumentation
Zur Website

Wartungssperre, Sicherung und Bereinigung

Die Wartungssperre dient Vorgängen wie der Konfigurationswiederherstellung, bei denen Schreibzugriffe angehalten werden müssen. Sie verhindert weitere Änderungen an Geschäftskonfiguration und Steuerung während der Wiederherstellung.

Die Zustandsfolge lautet OFF → ENTERING → ACTIVE → EXITING → OFF. Aktivierung und Deaktivierung können Wartezeit benötigen; maßgeblich ist die Statusabfrage.

Während der Sperre werden geschützte Konfigurations- und Steuer-Schreibzugriffe mit Anwendungscode 200162 abgelehnt. Verwenden Sie die aktuellen Schnittstellen zum Aktivieren und Deaktivieren, nicht die entfernten Capability- oder stufenweisen Austrittsschnittstellen.

Vorgang Schnittstelle
Status abfragen GET /maintenance/state
Sperre aktivieren POST /maintenance/enter
Sperre deaktivieren POST /maintenance/exit
  1. Speichern Sie die aktuellen Einstellungen als Konfigurationssicherung.
  2. Aktivieren Sie die Wartungssperre und laden Sie eine zur Version passende Sicherungsdatei hoch.
  3. Prüfen Sie Wiederherstellungsergebnis und Cache-Neuaufbau und deaktivieren Sie nach Bestätigung die Sperre.
  4. Falls Vorlagen synchronisiert werden müssen, gleichen Sie anschließend die gewünschten UDE-Typen oder -Instanzen ab.

POST /ems-data/backup lädt die Konfigurationssicherung herunter; POST /ems-data/restore nimmt sie über das Multipart-Feld file entgegen. Eine Konfigurationssicherung speichert die Inhalte ihres Sicherungsmanifests und ist kein vollständiges Systemabbild. Prüfen Sie, ob Archivierungspläne, Laufzeitmetadaten und andere benötigte Inhalte im eigenen Sicherungsumfang enthalten sind.

Die Sammelbereinigung verarbeitet Daten und Konfigurationen nach Kategorie und baut zugehörige Caches neu auf. Das Bereinigen von Roh- oder freigegebenen Daten kann auch Konfigurationen und Gruppenzuordnungen betreffen. Die UDE-Bereinigung umfasst Regeln und Verzeichnisse erzeugter Objekte.

Prüfen Sie zunächst Kategorien und Referenzen und rufen Sie dann POST /ems-data/batch/clear auf. Kategorien werden getrennt verarbeitet. Erfolgreiche Teilschritte werden bei Fehlern anderer Kategorien nicht zurückgerollt; prüfen Sie jedes Ergebnis einzeln.

Für einmalige Datenausgaben verwenden Sie Historienexport, für langfristige Aufbewahrung regelmäßige Archivierung. Die Wirksamkeit von Parametern beschreibt Laufzeitkonfiguration.