Externe Synchronisierung

Mithilfe der „Externen Synchronisierung“ können Teilstrukturen aus FirstSpirit (z. B. Vorlagen, Verwaltungs-Teilbäume) in eine Dateisystem-Struktur mit Ordner-Hierarchie exportiert werden, und zwar in einem für „Menschen lesbaren“ und für „IDEs interpretierbaren“ Format. Dort (also außerhalb von FirstSpirit) können die exportierten Daten bearbeitet und anschließend wieder mit FirstSpirit synchronisiert werden. Damit ist es möglich, die Veränderungen im Dateisystem und im FirstSpirit-Projekt weitgehend automatisch zu synchronisieren.

Abbildung im Dateisystem

Die FirstSpirit-Objekte werden im externen Verzeichnis als Dateien abgelegt, die dort auch editiert werden können. Beim Export der FirstSpirit-Objekte ins Dateisystem wird versucht, die Hierarchie im Projekt auf eine Ordner-Hierarchie im Dateisystem abzubilden. Inhaltliche Informationen zu den exportierten FirstSpirit-Objekten werden in XML-Dateien abgelegt. Es gelten folgende Prinzipien, es kann allerdings – abhängig vom jeweiligen Objekttyp – Ausnahmen geben:

• Für jeden Ordner in FirstSpirit wird ein Ordner im Dateisystem angelegt. Dabei wird der Pfad vom in FirstSpirit gewählten Objekt bis zum jeweiligen Wurzelknoten nach oben in Ordnern abgebildet.
• Für jedes FirstSpirit-Element wird prinzipiell eine XML-Datei abgelegt. Diese enthält Informationen wie ID, Referenzname usw.
• Für jedes Register wird eine Datei angelegt.
• Datensätze werden in einer Datei abgelegt.

Rechte zur Ausführung der Funktionalität

Ab FirstSpirit-Version 5.1R2 werden spezielle Rechte für das Ausführen der Funktionalität „Externe Synchronisierung“ im SiteArchitect benötigt:

Der entsprechende Benutzer muss dazu entweder

• Mitglied der Gruppe „External Synchronisation“ sein (siehe Abbildung) oder
• das Recht „Ändern“ auf dem Wurzelknoten der Vorlagen-Verwaltung haben, wenn die Gruppe „External Synchronisation“ nicht im Projekt vorhanden ist.

Die Gruppe „External Synchronisation“ wird dazu in den Projekteigenschaften im ServerManager im Bereich „Gruppen“ angelegt und die Benutzer, die die Externe Synchronisierung ausführen dürfen sollen, dieser Gruppe hinzugefügt.

Unabhängig von der Zugehörigkeit zur Gruppe „External Synchronisation“ sind die jeweils für die auszuführende Aktion Benutzerrechte (Lesen, Ändern, Anlegen) erforderlich.

Hat der Benutzer die erforderlichen Rechte nicht, werden die entsprechenden Icons und Kontext-Menüeinträge der „Externen Synchronisierung“ im SiteArchitect nicht angezeigt.

Zugriff über die FirstSpirit Developer-API

Das Paket de.espirit.firstspirit.store.access.nexport.operations der FirstSpirit Developer-API (siehe auch Seite FirstSpirit API) ermöglicht einen Zugriff auf Inhalte und Funktionen der Funktionalität „Externen Synchronisierung“.