> 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).
# Verwendung
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 **Vorhandenes Projekt** angezeigt.
Sie können auch kürzlich verwendete Projekte aus der Liste auswählen und mit **Öffnen...** oder **Kooperationsprojekt öffnen...** ein Projekt auswählen, das nicht in der Liste enthalten ist.
Bei Verwendung von **Kooperationsprojekt öffnen...** erscheint das Dialogfeld **Zusammenarbeit für Plant 3D** und beginnt mit dem Laden der Projektliste.
Die Liste der Plant 3D-Projekte wird ab dem zuletzt verwendeten Kollaborationskonto/Projekt angezeigt.
Sie können auch **ALLE PROJEKTE** für die Kooperationsprojekte auswählen, um alle Plant 3D-Projekte aller Kooperationsprojekte zu erhalten.
Natürlich hängt die Ladezeit aller Plant 3D-Projekte in der Liste von der Anzahl der Kooperationsprojekte sowie der Anzahl der Plant 3D-Projekte in jedem Kooperationsprojekt ab.
Sie können bei den Kollaborationskonten sogar **ALLE KONTEN** auswählen.
Dadurch werden die Kooperationsprojekte automatisch auf **ALLE PROJEKTE** gesetzt. Nachdem alle Plant 3D-Projekte geladen sind, können Sie ein bestimmtes Kooperationsprojekt auswählen.
Sie können auch einen Text eingeben, um die Projekte zu filtern.
Schließlich können Sie auch eines der **Vorlagenprojekte** auswählen, die in den \[Einstellungen] (ps\_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. Für die Auswahl der Zielprojekte gibt es verschiedene Möglichkeiten. Mit **Kollaborationsprojekt hinzufügen...** wird das Dialogfeld **Zusammenarbeit für 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 auch **ALLE KONTEN** oder **ALLE PROJEKTE** für das Kollaborationskonto/Projekt auswählen, um mehr/alle Ihre Plant 3D-Projekte anzuzeigen. Im Dialog können Sie bei Bedarf mehrere Projekte auswählen.
Wenn in Ihrem lokalen Arbeitsordner noch kein Projekt vorhanden ist, wird eine Fortschrittsanzeige mit dem Namen des heruntergeladenen Projekts und einem Zähler des heruntergeladenen Projekts angezeigt, falls Sie mehrere Projekte ausgewählt haben.
Am Ende werden die Projekte in der Liste angezeigt.
Sie können **Alle entfernen** oder **Entfernen** verwenden, um alle oder ein einzelnes Projekt aus der Liste zu entfernen.
Jetzt wurde alles entfernt.
Sie können auch **Projekt hinzufügen...** verwenden, um ein einzelnes Projekt zur Liste der Zielprojekte hinzuzufügen.
Die Windows-Dateiauswahl wird geöffnet und Sie können zum Zielprojekt navigieren und **Project.xml** auswählen.
Wenn das ausgewählte Projekt ein Kooperationsprojekt war, das bereits in Ihrem lokalen Arbeitsordner vorhanden ist, wird automatisch das typische ACC-Symbol angezeigt.
Sie können dies auch aus der zuletzt verwendeten Liste tun, indem Sie **Zuletzt verwendetes Projekt hinzufügen** auswählen. Anmerkung: Projekte, die nicht mehr existieren, werden aus der Liste entfernt.
Wenn Sie in den \[Einstellungen] (ps\_settings.md) einen gültigen Ordner als **Hauptverzeichnis des Projekts** 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 **Durchsuchen...**.
Der Windows-Datei-Explorer wird geöffnet, in dem Sie Ihren Ordner auswählen und auf **Ordner auswählen** klicken.
Auch dies lädt dann das gesamte Projekt in die Liste.
Synchronisierungskonfiguration auswählen
Als nächstes wählen Sie eine Ihrer Synchronisierungskonfigurationen aus. Die Details zum Erstellen einer Sync-Konfiguration werden unter [Sync-Konfiguration](/plant-tools/de/plantsync/sync-configuration.md) erläutert.
Die ausgewählte Sync-Konfiguration wird dann im Dialog angezeigt.
Vorsynchronisierungsprozess
Der letzte Schritt besteht darin, den Synchronisierungsvorgang mit der Schaltfläche **Synchronisieren** zu starten.
Dadurch werden die in der Synchronisierungskonfiguration definierten Konfigurationen durchlaufen. Der Prozess wird für jedes Zielprojekt ausgeführt. Bei Bedarf können Sie den Vorsynchronisierungsprozess beenden, indem Sie auf die Schaltfläche **Abbrechen** klicken.
Wenn Sie Kollaborationsprojekte...
... ausgewählt haben, wird für jedes der Ziel-Kollaborationsprojekte ein Download-Fenster angezeigt, in dem der Name des Projekts und ein Zähler angezeigt werden, 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 **Alle anzeigen** klicken, können Sie auch die in der Synchronisierungskonfiguration definierten Kategorien sehen, bei denen es keine Unterschiede gibt.
Mit der Schaltfläche **Abbrechen** können Sie die Synchronisierung beenden.
Vorsynchronisierungsoptionen
Wie oben erwähnt, zeigt Ihnen der Dialog die Unterschiede zwischen dem Quell- und dem Zielprojekt. Hier ist ein Beispiel einer modifizierten Auswahlliste. Das **!** deutete auf eine Änderung hin. 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 **Neuer ZZ-Dienst** hinzugefügt, die mit dem \***+** gekennzeichnet ist.
In diesem Beispiel sehen wir, dass die Auswahlliste **Ja\_Nein** ein **+** hat, da 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, werden die an der Klasse vorgenommenen Änderungen angezeigt. In diesem Beispiel werden zwei neue Eigenschaften hinzugefügt. Sie können auch ihre Attribute wie Anzeigename, Schreibgeschützt, Sichtbar, Name der Auswahlliste und Standardwert sehen. Es werden nur die Attribute angezeigt, die von der Standardeinstellung des Plant 3D abweichen. Wenn beispielsweise eine neue Eigenschaft immer lesbar und beschreibbar ist, wenn sie jedoch auf „Nur lesen“ = „True“ gesetzt ist, wird dies im Dialogfeld angezeigt.
Wenn Sie ein \* vor einem Wert in der Spalte **Feld** sehen, bedeutet das, dass diese Einstellung von einer übergeordneten Klasse oben stammt. Es ist eigentlich dasselbe wie im Projekt-Setup von Plant 3D.
Wenn eine neue Klasse erstellt wird, sehen Sie dies in den Klassenattributen auf der rechten Seite. Anmerkung: Wenn Sie in der Synchronisierungskonfiguration nur **Klassen hinzufügen** auswählen, werden in PlantSync auch alle fehlenden Tag-Formate, Anmerkungen und Symbole für diese Klasse definiert.
Sie können auch in jedem der drei Abschnitte des Dialogs filtern. Hier ein Beispiel für die Filterung innerhalb der Klassen.
Wenn Sie Textdateien wie eine XML-Datei haben, können Sie mit der rechten Maustaste auf die Zeile klicken und „Vergleichen“ auswählen, um die Vergleichs-App zu starten (falls installiert). Siehe [Einstellungen](/plant-tools/de/plantsync/settings.md).
So zeigt WinMerge die Unterschiede.
Anmerkung: Sie können die Vergleichs-App nicht verwenden, um die Änderungen zwischen den Quell- und Zielprojektdateien zu kopieren. Es geht nur darum, die Unterschiede zu sehen. PlantSync überschreibt die Datei später. Weitere Details zu den Vorsynchronisierungsdaten finden Sie unter \[Sync-Konfiguration] (ps\_syncconfig.md).
Änderungen übernehmen
Wenn Sie auf **Änderungen übernehmen** klicken, wird zunächst ein Dialog angezeigt, in dem Sie gefragt werden, ob Sie sicher sind, dass alle Projekte geschlossen wurden. Dies ist besonders wichtig für reguläre Projekte. Bei Kooperationsprojekten 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 ein Ergebnisdialog wird angezeigt, der Sie über den Erfolgsstatus informiert.
Anmerkung: Wenn in der Ergebnisspalte nicht das Wort „Erfolgreich“ angezeigt wird, 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 festzuschreiben. Wenn dies erfolgreich ist, versuchen Sie es erneut mit der Klasse „Non Engineering Items“ und beginnen Sie dann mit der Festschreibung der Unterknoten unter „Engineering Items“ wie „Equipment“, „Inline Assets“ usw.