Objekte synchronisieren
Das externe Synchronisieren von FirstSpirit-Objekten kann auf zwei Arten erfolgen:
- über den Eintrag Automatisch synchronisieren im Konfigurationsbereich
- manuell über die Schaltfläche Elemente synchronisieren.
Für beide Optionen muss zunächst ein externer Ordner ausgewählt werden. Dieser Ordner bildet die Grundlage für den Austausch der Objekte/Dateien mit dem Dateisystem. Aus den lokalen FirstSpirit-Projekten können Elemente in diesen Ordner synchronisiert werden. Eingebundene Objekte werden im Bereich „Externe Synchronisierung“ unter „Eingebundene Objekte“ aufgelistet. Sollen Objekte aus einem FirstSpirit-Projekt nicht nur extern synchronisiert werden, sondern ist auch geplant, diese Objekte in weiteren FirstSpirit-Projekten zu verwenden (durch Importieren aus dem externen Ordner), muss der Anwender sicherstellen, dass alle Abhängigkeiten der Objekte auch ein Bestandteil der Synchronisation sind oder dass diese abhängigen Elemente im Zielprojekt bereits vorhanden sind. Die externe Synchronisierung zeigt dem Anwender diese Abhängigkeiten (für die zu exportierenden Objekte) zwar an, die Synchronisation kann aber auch dann gestartet werden, wenn nicht alle Abhängigkeiten erfüllt wurden.
Erst nachdem alle Objekte eingebunden sind, sollte der Modus für die Synchronisation festgelegt werden.
- Die automatische Synchronisierung wird über die Checkbox „Automatisch synchronisieren“ aktiviert (siehe Seite Konfiguration). Dabei werden alle eingebundenen Objekte ohne weitere Bearbeitung durch den Anwender in den definierten Ordner synchronisiert – und zwar solange der Ordner im Bereich „Externe Synchronisierung“ geöffnet bleibt (das Icon ist deaktiv).
Die Synchronisation erfolgt immer dann, wenn sich eines der eingebundenen Objekte ändert hat (beim Speichern) und sich der lokale SiteArchitect des Anwenders im Vordergrund befindet.
Die Synchronisierung beruht dabei immer auf dem Status des Objekts und der zugehörigen Standardaktion (siehe Seite Eingebundene Objekte). Eine Änderung der Synchronisationsrichtung oder das automatische Auflösen von Konflikten ist in diesem Modus nicht möglich. Abhängige Objekte werden nicht automatisch hinzugefügt. Da auch neue Objekte direkt synchronisiert werden, wird empfohlen, die Checkbox solange zu deaktivieren, bis alle Objekte und ihre Abhängigkeiten erstmalig erfasst wurden.
- : mit einem Klick auf diesen Button wird einmalig die manuelle Synchronisierung der „Eingebundene(n) Objekte“ gestartet (siehe dazu Seite Eingebundene Objekte; wahlweise Exportieren der Änderungen ins externe Verzeichnis oder Importieren der externen Änderungen ins FirstSpirit-Projekt).
Die Übersicht „Eingebundene Objekte“ zeigt immer den Stand der Objekte aus dem externen Verzeichnis an. Diese Objekte sind mit einer Revision im Projekt verknüpft. Um zwischenzeitlich stattgefundene lokale oder externe Änderungen an den Objekten zu erkennen, muss vor der manuellen Synchronisation über das Icon „Dateisystem-Ordner neu laden“ diese Revision aktualisiert werden (siehe Seite Konfiguration). Haben sich seit der letzten Synchronisierung externe Inhalte geändert, werden diese Änderungen nun angezeigt.
Vor der manuellen Synchronisierung können Abhängigkeiten hinzugefügt (siehe Seite Objekte einbinden), die vorgegebene Synchronisationsaktion geändert oder Objekte entfernt werden (siehe Seite „Eingebundene Objekte“, Abschnitt Aktion selbst wählen). Außerdem können bestehende Konflikte auf bestimmten Objekten aufgelöst werden (siehe Seite Konflikte beheben).
Es wird immer nur eine Version eines Objektes synchronisiert. Das bedeutet: Wird ein Objekt in ein externes Verzeichnis exportiert und anschließend neu importiert (z. B. in ein weiteres FirstSpirit-Projekt) enthält die Versionshistorie nur die entsprechenden Anlege- bzw. Import-Operationen – nicht aber die gesamte Versionshistorie des Objektes aus dem Quellprojekt. |
Beim Synchronisieren von FirstSpirit-Projektinhalten werden Objekte geändert, gelöscht und neu angelegt. Abhängig von der ausgeführten Aktion sind dazu die entsprechenden Benutzerrechte (Lesen, Ändern, Anlegen) erforderlich. |
Sollen Datenbank-Inhalte importiert werden, sollte darauf geachtet werden, dass eine entsprechende Datenbank-Verbindung für das Projekt vorhanden ist (siehe dazu FirstSpirit Dokumentation für Administratoren, z. B. Kapitel „Datenbankanbindung“, „Server-Eigenschaften“ / „Datenbanken“ und „Projekt-Eigenschaften“ / „Datenbanken“.) |
Lost & Found – Umgang mit überzähligen Kindelementen im Zielprojekt
Wird ein Vaterelement (Ordner) explizit aus einem Quellprojekt exportiert und in ein Zielprojekt importiert, so werden Kindelemente dieses Ordners, die nur im Zielprojekt enthalten sind,
- in einen vom System angelegten Ordner „Lost & Found“ (in der betreffenden Verwaltung) verschoben, wenn das Kindelement eine UID besitzt (Ausnahme: „Abfragen“ und „Tabellenvorlagen“)
- gelöscht, wenn
- das Kindelement keine UID hat (Ordner in der Vorlagen-Verwaltung, Absätze in der Inhalte-Verwaltung) und von keinem anderen Objekt referenziert wird oder
- das Kindelement eine Abfrage oder eine Tabellenvorlage ist und von keinem anderen Objekt referenziert wird.
Elemente, die noch eingehende Referenzen besitzen (also noch durch ein anderes Objekt referenziert werden), bleiben in jedem Fall im Zielprojekt erhalten und werden nicht gelöscht.