> For the complete documentation index, see [llms.txt](https://help.auxalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.auxalia.com/plant-tools/de/plantsync/how-to-use.md).
# Anwendung
Dieses Kapitel beschreibt den Arbeitsablauf von PlantSync und seine Verwendung.
PlantSync finden Sie im PlantTools-Menüband.
Quellprojekt auswählen
Als Erstes müssen Sie das Quellprojekt auswählen, das das Projekt enthält, mit dem Sie Ihre Zielprojekte vergleichen möchten.
Standardmäßig wird das aktuell geladene Projekt als **Existing Project** angezeigt.
Sie können auch aus der Liste der zuletzt verwendeten Projekte auswählen oder mit **Open...** oder **Open Collaboration Project...** ein Projekt auswählen, das nicht in der Liste enthalten ist.
Bei Verwendung von **Open Collaboration Project...** erscheint das Dialogfeld **Collaboration for Plant 3D** und beginnt mit dem Laden der Projektliste.
Die Liste der Plant 3D-Projekte wird ausgehend vom zuletzt verwendeten Collaboration-Konto/-Projekt angezeigt.
Sie können für die Collaboration Projects auch **ALL PROJECTS** auswählen, um alle Plant 3D-Projekte aller Collaboration Projects zu erhalten.
Natürlich hängt die Ladezeit aller Plant 3D-Projekte in der Liste von der Anzahl der Collaboration Projects sowie der Anzahl der Plant 3D-Projekte in jedem Collaboration Project ab.
Sie können bei den Collaboration Accounts sogar **ALL ACCOUNTS** auswählen.
Dadurch werden die Collaboration Projects automatisch auf **ALL PROJECTS** gesetzt.
Nachdem alle Plant 3D-Projekte geladen sind, können Sie ein bestimmtes Collaboration Project auswählen.
Sie können auch einen Text eingeben, um die Projekte zu filtern.
Schließlich können Sie auch eines der **Template Projects** auswählen, die in den [Einstellungen](/plant-tools/de/plantsync/settings.md) definiert sind.
Zielprojekte auswählen
Der nächste Schritt besteht darin, ein oder mehrere Zielprojekte auszuwählen, die basierend auf dem Quellprojekt die erforderlichen Änderungen erhalten sollen.
Es gibt verschiedene Möglichkeiten, die Zielprojekte auszuwählen.
Mit **Add Collaboration Project...** wird das Dialogfeld **Collaboration for Plant 3D** geöffnet.
Jetzt werden alle Plant 3D-Projekte des zuletzt verwendeten Collaboration-Kontos/-Projekts geladen.
Wie oben bei der Auswahl des Quellprojekts erwähnt, können Sie für das Collaboration-Konto/-Projekt auch **ALL ACCOUNTS** oder **ALL PROJECTS** auswählen, um mehr/alle Ihre Plant 3D-Projekte anzuzeigen.
Im Dialog können Sie bei Bedarf mehrere Projekte auswählen.
Wenn ein Projekt noch nicht in Ihrem lokalen Arbeitsordner vorhanden ist, wird ein Fortschrittsfenster angezeigt, das den Namen des heruntergeladenen Projekts und, falls Sie mehrere Projekte ausgewählt haben, einen Zähler der heruntergeladenen Projekte anzeigt.
Am Ende werden die Projekte in der Liste angezeigt.
Sie können **Remove All** oder **Remove** verwenden, um alle oder ein einzelnes Projekt aus der Liste zu entfernen.
Jetzt wurde alles entfernt.
Sie können auch **Add Project...** verwenden, um ein einzelnes Projekt zur Liste der Zielprojekte hinzuzufügen.
Die Windows-Dateiauswahl öffnet sich, und Sie können zum Zielprojekt navigieren und die **Project.xml** auswählen.
Wenn das ausgewählte Projekt ein Collaboration-Projekt war, das bereits in Ihrem lokalen Arbeitsordner vorhanden ist, wird automatisch das typische ACC-Symbol angezeigt.
Sie können ein Projekt auch aus der Liste der zuletzt verwendeten Projekte auswählen, indem Sie **Add Recently Used Project** wählen.
Anmerkung: Projekte, die nicht mehr existieren, werden aus der Liste entfernt.
Wenn Sie in den [Einstellungen](/plant-tools/de/plantsync/settings.md) einen gültigen Ordner als **Project Top Directory** definiert haben, können Sie diesen Ordner auswählen, um alle Projekte von dort abzurufen.
Alle Projekte werden nun in der Liste angezeigt.
Wenn Sie einen anderen Ordner auswählen möchten, in dem nach Projekten gesucht werden soll, wählen Sie **Browse...**.
Der Windows-Explorer öffnet sich, in dem Sie Ihren Ordner auswählen und auf **Select Folder** klicken.
Auch dies lädt anschließend alle Projekte in die Liste.
Sync-Konfiguration auswählen
Als Nächstes wählen Sie eine Ihrer Sync-Konfigurationen aus.
Die Details zum Erstellen einer Sync-Konfiguration werden unter [Sync Configuration](/plant-tools/de/plantsync/sync-configuration.md) erläutert.
Die ausgewählte Sync-Konfiguration wird dann im Dialog angezeigt.
Vorabgleich-Prozess (Pre-Synchronize)
Der letzte Schritt besteht darin, den Synchronisierungsprozess mit der Schaltfläche **Synchronize** zu starten.
Dadurch werden die in der Sync-Konfiguration definierten Konfigurationen durchlaufen. Der Prozess wird für jedes Zielprojekt ausgeführt.
Bei Bedarf können Sie den Vorabgleich-Prozess beenden, indem Sie auf die Schaltfläche **Cancel** klicken.
Wenn Sie Collaboration Projects ausgewählt haben...
... wird für jedes der Ziel-Collaboration-Projekte ein Download-Fenster mit dem Namen des Projekts und einem Zähler angezeigt, bevor nach Unterschieden zwischen dem Quell- und dem Zielprojekt gesucht wird.
Am Ende werden Ihnen die Unterschiede zwischen Quell- und Zielprojekt angezeigt.
Wenn Sie mehrere Projekte ausgewählt haben, sehen Sie jedes Zielprojekt separat mit seinen individuellen Unterschieden zum Quellprojekt.
Wenn Sie auf die Schaltfläche **Show all** klicken, können Sie auch die in der Sync-Konfiguration definierten Kategorien sehen, bei denen es keine Unterschiede gibt.
Die Schaltfläche **Cancel** ermöglicht es Ihnen, die Synchronisierung abzubrechen.
Vorabgleich-Optionen (Pre Synchronization Options)
Wie oben erwähnt, zeigt Ihnen der Dialog die Unterschiede zwischen dem Quell- und dem Zielprojekt.
Hier ist ein Beispiel einer geänderten Auswahlliste. Das **!** zeigt eine Änderung an. Auf der rechten Seite sehen wir dann, dass der Wert WW entfernt wird, gekennzeichnet durch das **X**. Und der Wert ZZ wird mit der Beschreibung **New ZZ Service** hinzugefügt, gekennzeichnet durch das **+**.
In diesem Beispiel sehen wir, dass die Auswahlliste **Yes\_No** ein **+** hat, weil es sich um eine neue Auswahlliste handelt. Und auf der rechten Seite sehen wir die hinzugefügten Werte für die neue Auswahlliste.
Wenn Sie eine Klasse auswählen, sehen Sie die an der Klasse vorgenommenen Änderungen. In diesem Beispiel werden zwei neue Eigenschaften hinzugefügt. Sie können auch deren Attribute wie Display name, Read Only, Visible, Selection List name und Default Value sehen. Es werden nur die Attribute angezeigt, die von der Standardeinstellung von Plant 3D abweichen. Zum Beispiel ist eine neue Eigenschaft immer lese-/schreibbar, aber wenn sie auf Read-Only = True gesetzt ist, wird dies im Dialog angezeigt.
Wenn Sie vor einem Wert in der Spalte **Field** ein \* sehen, bedeutet das, dass diese Einstellung von einer übergeordneten Klasse stammt. Es ist im Grunde dasselbe wie im Project Setup von Plant 3D.
Wenn eine neue Klasse erstellt wird, sehen Sie dies an den Klassenattributen auf der rechten Seite.
Anmerkung: Wenn in der Synchronisierungskonfiguration nur **Add Classes** gewählt wird, ergänzt PlantSync außerdem alle fehlenden Tag Format-, Annotation- und Symbol-Definitionen für diese Klasse.
Sie können auch in jedem der drei Abschnitte des Dialogs filtern. Hier ein Beispiel für das Filtern innerhalb der Klassen.
Wenn Sie Textdateien wie eine XML-Datei haben, können Sie mit der rechten Maustaste auf die Zeile klicken und Compare auswählen, um die Vergleichs-App zu starten (falls installiert). Siehe [Einstellungen](/plant-tools/de/plantsync/settings.md).
So zeigt WinMerge die Unterschiede an.
Anmerkung: Sie können die Vergleichs-App nicht verwenden, um die Änderungen zwischen der Quell- und der Zielprojektdatei zu kopieren. Sie dient nur dazu, die Unterschiede zu sehen. PlantSync überschreibt die Datei später.
Weitere Details zu den Vorabgleich-Daten finden Sie unter [Sync Configuration](/plant-tools/de/plantsync/sync-configuration.md).
Änderungen übernehmen (Committing Changes)
Wenn Sie auf **Commit changes** klicken, wird zunächst ein Dialog angezeigt, der Sie fragt, ob Sie sicher sind, dass alle Projekte geschlossen wurden. Dies ist besonders wichtig für reguläre Projekte. Bei Collaboration Projects können die Änderungen nur übernommen werden, wenn PlantSync das Projekt auschecken kann.
Nachdem Sie auf **OK** geklickt haben, werden die von Ihnen ausgewählten Änderungen übernommen, und es wird ein Ergebnisdialog angezeigt, der Sie über den Erfolgsstatus informiert.
Anmerkung: Wenn in der Ergebnisspalte nicht das Wort Success steht, werden Sie über das aufgetretene Problem informiert. In einem solchen Fall empfehlen wir, den Synchronisierungsprozess erneut zu starten und nur Teile des Setups zu übernehmen. Wenn es beispielsweise ein Problem mit den P\&ID-Klassen gibt, versuchen Sie, nur die PipeLineGroup und die SignalLineGroup zu übernehmen. Ist dies erfolgreich, versuchen Sie es erneut mit der Klasse Non Engineering Items und beginnen Sie dann mit dem Übernehmen der Unterknoten unter Engineering Items wie Equipment, Inline Assets usw.