Projekte vergleichen und zusammenführen

Mit „Vergleichen“ sehen Sie genau, worin sich zwei Projekte unterscheiden, und können für die Teile, die sich sicher kopieren lassen, ausgewählte Änderungen aus dem einen in das andere zusammenführen. Es ist für zwei alltägliche Situationen gedacht:

Änderungen zwischen Umgebungen übernehmen – prüfen, was sich zwischen einem QA-Projekt (Entwicklung) und seinem Produktionsgegenstück unterscheidet, und dann nur die gewünschten Änderungen in die Produktion übernehmen.
Mit einem früheren Snapshot oder einer Kopie abgleichen – ein Projekt mit einer Kopie seiner selbst vergleichen (zum Beispiel einem Klon vom Vormonat), um zu sehen, was sich geändert hat.

Sie behalten die ganze Zeit die Kontrolle: Es wird nichts geschrieben, bis Sie bestimmte Elemente auswählen und anwenden, und Sie können vorher mit einem Probelauf prüfen.

Element für Element abgeglichen (bei Kopien nach ID, bei unabhängigen Projekten nach Name), wird jeder Unterschied als geändert, hinzugefügt oder gleich markiert. Sie wählen aus, was zusammengeführt wird – nichts gelangt in die Produktion, bis Sie es anwenden.

So funktioniert der Abgleich

Um zwei Projekte zu vergleichen, muss PlaidCloud entscheiden, welches Element links welchem Element rechts entspricht. Die Strategie wird automatisch gewählt:

Kopien und Snapshots desselben Projekts werden anhand ihrer internen ID abgeglichen (ein Klon behält dieselben IDs), sodass auch umbenannte Elemente exakt zugeordnet werden.
Unabhängige Projekte – etwa ein QA-Projekt und ein separat aufgebautes Produktionsprojekt – haben keine gemeinsamen IDs und werden daher nach Name abgeglichen. In diesem Fall werden die Elemente mit (name-matched) gekennzeichnet.

Der Abgleich nach Namen macht einen Vergleich zwischen QA und Produktion erst nützlich, da die beiden Projekte getrennt aufgebaut wurden. Er hat aber auch Grenzen: Elemente mit doppelten Namen lassen sich nicht immer eins zu eins zuordnen, und ein Element mit der Markierung ambiguous match bedeutet, dass mehr als ein Kandidat denselben Namen hatte – prüfen Sie diese von Hand, bevor Sie zusammenführen.

Es gibt eine dritte Art des Abgleichs, die verwendet wird, wenn ein Projekt durch Kopieren aus dem anderen aufgebaut wurde: die Zuordnung über die aufgezeichnete Kopierabstammung, sodass eine umbenannte Kopie weiterhin ihrem Original zugeordnet wird. Sie wird nicht automatisch gewählt – Sie fordern sie mit Neu synchronisieren in… an, siehe Aus dem Projekt neu synchronisieren, von dem Sie kopiert haben.

Einen Vergleich öffnen

Öffnen Sie Analysieren.
Wählen Sie in der oberen Menüleiste Projekte.
Klicken Sie mit der rechten Maustaste auf das Projekt, von dem Sie ausgehen möchten (oder verwenden Sie sein Aktionsmenü), und wählen Sie Vergleichen mit….
Im Fenster Projekte vergleichen ist das Projekt, von dem Sie ausgehen, bereits als Quelle eingetragen.
Wählen Sie das Ziel-Projekt aus der Dropdown-Liste – das Projekt, mit dem Sie vergleichen möchten.
Klicken Sie auf Vergleichen.

Beide Projekte müssen im selben Workspace liegen.

Den Vergleich lesen

Die linke Seite gruppiert jeden Unterschied unter seiner Kategorie: Workflows (mit den darunter verschachtelten Schritten), Variablen, Dimensionen, Editoren, UDFs, Ansichten und Tabellen.

Jedes Element trägt ein Kennzeichen mit seinem Status:

Hinzugefügt – in der Quelle vorhanden, aber nicht im Ziel (es würde im Ziel erstellt)
Geändert – in beiden vorhanden, aber die Konfiguration unterscheidet sich
Gelöscht – im Ziel vorhanden, aber nicht in der Quelle
Unverändert – auf beiden Seiten identisch (standardmäßig ausgeblendet)

Wählen Sie ein geändertes Element aus, um rechts seine Details zu sehen: eine Tabelle Feld / Quelle / Ziel mit dem, was sich geändert hat, und darunter den vollständigen Konfigurationsvergleich. Ist der Vergleich eines Elements sehr groß, wird er gekürzt – klicken Sie auf Vollständigen Vergleich erweitern, um die vollständige Version zu laden.

Die Liste eingrenzen

Nach Name oder Pfad filtern schränkt die Baumstruktur auf passende Elemente ein.
Mit den Statuskontrollkästchen blenden Sie Elemente mit dem Status Hinzugefügt, Geändert, Gelöscht und Unverändert ein oder aus.
Manuelle Bearbeitung erforderlich zeigt nur die Änderungen, die sich nicht automatisch zusammenführen lassen (siehe unten).

Was sich zusammenführen lässt

Nicht jeder Unterschied lässt sich sicher zwischen Projekten kopieren. Der Vergleich kennzeichnet jedes Element, sodass Sie immer wissen, was zusammengeführt werden kann:

Workflows, Schritte und Variablen lassen sich zusammenführen.
Dimensionen, Editoren, UDFs, Ansichten und Tabellen sind nur ansehbar – sie erscheinen im Vergleich, damit Sie sie prüfen können, aber Sie kopieren sie mit ihren eigenen Werkzeugen und nicht von hier aus.

Einige einzelne Änderungen sind auch in einer zusammenführbaren Kategorie als manuell (mit einem Schloss) markiert, weil ein automatisches Anwenden nicht sicher wäre. Der Detailbereich erklärt, warum und was Sie stattdessen tun können. Die häufigsten Fälle:

Schritte in einem Vergleich nach Namen (QA gegenüber Produktion) sind nur zur Prüfung gedacht – die Konfiguration eines Schritts kann auf umgebungsspezifische Verbindungen und Agents verweisen, daher wird sie von Hand kopiert. Anhand des Vergleichs sehen Sie genau, was im Ziel zu ändern ist.
Das Löschen von Variablen wird nicht für Sie angewendet – entfernen Sie die Variable im Zielprojekt von Hand.

Die Zusammenfassungszeile zeigt die Aufteilung auf einen Blick, zum Beispiel „12 zusammenführbar · 5 nur ansehbar“ und „3 erfordern manuelle Bearbeitung“.

Änderungen zusammenführen

Wählen Sie die Elemente aus, die Sie aus der Quelle in das Ziel kopieren möchten. Mit Alle auswählen wählen Sie jedes derzeit angezeigte zusammenführbare Element aus, oder Sie wählen einzelne Zeilen per Mehrfachauswahl. Nur ansehbare und manuelle Elemente lassen sich nicht auswählen.
Klicken Sie auf Probelauf, um die Auswahl zu prüfen, ohne etwas zu schreiben. PlaidCloud meldet, wie viele Operationen angewendet würden (neu bzw. aktualisiert), und kennzeichnet alle, die fehlschlagen würden.
Wenn der Probelauf passt, klicken Sie auf Übernehmen (entweder im Ergebnis des Probelaufs oder in der Fußzeile).
Bestätigen Sie die Operation im Dialogfeld Zusammenführung bestätigen.

Zusammengeführte Elemente behalten im Ziel ihre Identität, sodass Sie den Vergleich später erneut ausführen und weitere Änderungen zusammenführen können, ohne Duplikate zu erzeugen.

Wenn etwas schiefgeht

Ziel geändert – hat jemand anderes das Ziel geändert, nachdem Sie den Vergleich geladen haben, bricht die Zusammenführung ab, um dessen Arbeit nicht zu überschreiben. Aktualisieren Sie den Vergleich und wenden Sie ihn erneut an.
Zusammenführung teilweise angewendet – schlägt eine Operation mittendrin fehl, werden die übrigen als verbleibend gemeldet. Beheben Sie die Ursache und wählen Sie Verbleibende wiederholen, oder brechen Sie ab und aktualisieren Sie.

Aus dem Projekt neu synchronisieren, von dem Sie kopiert haben

Das Vergleichen funktioniert zwischen zwei beliebigen Projekten eines Workspace. Wurde das Ziel jedoch durch Kopieren aus der Quelle aufgebaut – mit Projekt kopieren in ein vorhandenes Projekt –, merkt sich PlaidCloud, welches Objekt im Ziel aus welchem Objekt in der Quelle stammt. Neu synchronisieren nutzt dieses Wissen, um die beiden so zu vergleichen, wie sie tatsächlich zusammenhängen, statt anhand von IDs und Namen zu raten.

So kann ein Mandant Dev, QA und Produktion als getrennte Projekte führen und Änderungen zwischen ihnen vorwärts übernehmen. Sie kopieren Dev einmal nach QA; ab dann zeigt das erneute Synchronisieren von QA gegenüber Dev nur, was sich seitdem in Dev geändert hat, und Sie können die gewünschten Teile nach QA übernehmen – und anschließend auf dieselbe Weise QA in die Produktion. Kein Export, kein Archiv, kein zweiter Workspace.

Warum das wichtig ist

Bei einem gewöhnlichen Vergleich zweier unabhängig aufgebauter Projekte müssen Elemente nach Namen zugeordnet werden, weil sie keine gemeinsamen IDs haben. Das funktioniert, bis beim Kopieren etwas umbenannt wurde. Landet beim Kopieren eines Projekts ein Objekt, dessen Name oder ID im Ziel bereits existierte, erhält das eingehende Objekt eine neue Identität ( copy angehängt) – ein einfacher Vergleich sieht die umbenannte Kopie daher als unabhängig von ihrem Original in der Quelle: Das Quellelement erscheint als Hinzugefügt und die eigene Kopie im Ziel als Gelöscht, nebeneinander. Sie sähen zwei Hälften desselben Objekts, ohne sie einander zuordnen zu können.

Neu synchronisieren ordnet sie stattdessen nach Abstammung zu – der aufgezeichneten Kopierabstammung –, sodass ein umbenanntes oder neu nummeriertes Objekt weiterhin dem Objekt zugeordnet wird, von dem es stammt, und nur echte Änderungen als Unterschiede erscheinen.

Ein erneutes Synchronisieren ausführen

Öffnen Sie Analysieren.
Wählen Sie Projekte.
Klicken Sie mit der rechten Maustaste auf das Projekt, aus dem Sie kopiert haben – die Quelle, z. B. Dev – oder verwenden Sie sein Aktionsmenü, und wählen Sie Neu synchronisieren in….
Wählen Sie das Ziel, in das Sie zuvor kopiert haben – z. B. QA.
Klicken Sie auf Neu synchronisieren.

Das Fenster ist dasselbe Fenster Projekte vergleichen, und alles unter Den Vergleich lesen, Was sich zusammenführen lässt und Änderungen zusammenführen gilt unverändert. Der einzige Unterschied ist die Art, wie Elemente zugeordnet werden.

Wenn keine Abstammung vorliegt

Neu synchronisieren benötigt eine aufgezeichnete Kopie zwischen den beiden Projekten. Wenn Sie ein Paar neu synchronisieren, das nie durch „Projekt kopieren“ verbunden war – oder nur teilweise –, sagt PlaidCloud Ihnen das, statt etwas vorzutäuschen:

Überhaupt keine Abstammung – ein Banner teilt mit, dass der Vergleich auf die gewöhnliche Zuordnung zurückgefallen ist und kein erneutes Synchronisieren darstellt. Er verhält sich genau wie ein normaler Vergleich, einschließlich der Aufteilung in Hinzugefügt/Gelöscht bei allem, was eine frühere Kopie umbenannt hätte. Das sehen Sie, wenn Sie zwei nicht zusammenhängende Projekte oder ein Projektpaar neu synchronisieren, das durch einen Archivimport statt durch „Projekt kopieren“ verbunden ist.
Teilweise Abstammung – hat die Kopie nur einige Kategorien umfasst, nennt ein Banner diejenigen, die zurückgefallen sind. Diese Kategorien werden dann nach Namen zugeordnet, was dieselbe sichere Teilmenge zusammenführt wie ein Vergleich zwischen QA und Produktion – Variablen und Änderungen an Workflow-Datensätzen werden übernommen, während Schritte und neu hinzugefügte Workflows nur zur Prüfung dienen (siehe Was sich zusammenführen lässt).

In beiden Fällen zeigt und führt das Fenster die Zuordnung zusammen, die Sie tatsächlich erhalten haben – ein erneutes Synchronisieren fällt nie stillschweigend auf einen Abgleich nach Namen zurück, während es Ihnen mitteilt, es habe über die Abstammung abgeglichen.