23
Handbuch Source Control TwinCAT 3 1.1 03.11.2016 Version: Datum:

Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

  • Upload
    hadang

  • View
    215

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Handbuch

Source Control

TwinCAT 3

1.103.11.2016

Version:Datum:

Page 2: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien
Page 3: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Inhaltsverzeichnis

Inhaltsverzeichnis1 Vorwort ....................................................................................................................................................... 4

1.1 Hinweise zur Dokumentation ............................................................................................................  41.2 Sicherheitshinweise ..........................................................................................................................  5

2 Integration des Source-Control Management......................................................................................... 62.1 Projektdateien...................................................................................................................................  62.2 Projekteinstellungen .........................................................................................................................  72.3 Hinweise .........................................................................................................................................  10

3 Konfiguration des Source-Control Client.............................................................................................. 113.1 Wahl des Compare Tools ...............................................................................................................  12

4 Project Compare Tool ............................................................................................................................. 144.1 Verwendung des TcProjectCompare Tools ....................................................................................  144.2 Konfiguration des TcProjectCompare.............................................................................................  194.3 Weitere Optionen............................................................................................................................  20

Source Control 3Version: 1.1

Page 4: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Vorwort

1 Vorwort

1.1 Hinweise zur DokumentationDiese Beschreibung wendet sich ausschließlich an ausgebildetes Fachpersonal der Steuerungs- undAutomatisierungstechnik, das mit den geltenden nationalen Normen vertraut ist.Zur Installation und Inbetriebnahme der Komponenten ist die Beachtung der Dokumentation und dernachfolgenden Hinweise und Erklärungen unbedingt notwendig. Das Fachpersonal ist verpflichtet, für jede Installation und Inbetriebnahme die zu dem betreffenden Zeitpunktveröffentliche Dokumentation zu verwenden.

Das Fachpersonal hat sicherzustellen, dass die Anwendung bzw. der Einsatz der beschriebenen Produktealle Sicherheitsanforderungen, einschließlich sämtlicher anwendbaren Gesetze, Vorschriften, Bestimmungenund Normen erfüllt.

DisclaimerDiese Dokumentation wurde sorgfältig erstellt. Die beschriebenen Produkte werden jedoch ständig weiterentwickelt.Wir behalten uns das Recht vor, die Dokumentation jederzeit und ohne Ankündigung zu überarbeiten und zuändern.Aus den Angaben, Abbildungen und Beschreibungen in dieser Dokumentation können keine Ansprüche aufÄnderung bereits gelieferter Produkte geltend gemacht werden.

MarkenBeckhoff®, TwinCAT®, EtherCAT®, Safety over EtherCAT®, TwinSAFE®, XFC®und XTS® sind eingetrageneund lizenzierte Marken der Beckhoff Automation GmbH.Die Verwendung anderer in dieser Dokumentation enthaltenen Marken oder Kennzeichen durch Dritte kannzu einer Verletzung von Rechten der Inhaber der entsprechenden Bezeichnungen führen.

PatenteDie EtherCAT Technologie ist patentrechtlich geschützt, insbesondere durch folgende Anmeldungen undPatente:EP1590927, EP1789857, DE102004044764, DE102007017835mit den entsprechenden Anmeldungen und Eintragungen in verschiedenen anderen Ländern.

Die TwinCAT Technologie ist patentrechtlich geschützt, insbesondere durch folgende Anmeldungen undPatente:EP0851348, US6167425 mit den entsprechenden Anmeldungen und Eintragungen in verschiedenenanderen Ländern.

EtherCAT® ist eine eingetragene Marke und patentierte Technologie lizensiert durch die BeckhoffAutomation GmbH, Deutschland

Copyright© Beckhoff Automation GmbH & Co. KG, Deutschland.Weitergabe sowie Vervielfältigung dieses Dokuments, Verwertung und Mitteilung seines Inhalts sindverboten, soweit nicht ausdrücklich gestattet.Zuwiderhandlungen verpflichten zu Schadenersatz. Alle Rechte für den Fall der Patent-, Gebrauchsmuster-oder Geschmacksmustereintragung vorbehalten.

Source Control4 Version: 1.1

Page 5: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Vorwort

1.2 Sicherheitshinweise

SicherheitsbestimmungenBeachten Sie die folgenden Sicherheitshinweise und Erklärungen!Produktspezifische Sicherheitshinweise finden Sie auf den folgenden Seiten oder in den Bereichen Montage,Verdrahtung, Inbetriebnahme usw.

HaftungsausschlussDie gesamten Komponenten werden je nach Anwendungsbestimmungen in bestimmten Hard- und Software-Konfigurationen ausgeliefert. Änderungen der Hard- oder Software-Konfiguration, die über diedokumentierten Möglichkeiten hinausgehen, sind unzulässig und bewirken den Haftungsausschluss derBeckhoff Automation GmbH & Co. KG.

Qualifikation des PersonalsDiese Beschreibung wendet sich ausschließlich an ausgebildetes Fachpersonal der Steuerungs-,Automatisierungs- und Antriebstechnik, das mit den geltenden Normen vertraut ist.

Erklärung der SymboleIn der vorliegenden Dokumentation werden die folgenden Symbole mit einem nebenstehendenSicherheitshinweis oder Hinweistext verwendet. Die Sicherheitshinweise sind aufmerksam zu lesen undunbedingt zu befolgen!

GEFAHR

Akute Verletzungsgefahr!Wenn der Sicherheitshinweis neben diesem Symbol nicht beachtet wird, besteht unmittel-bare Gefahr für Leben und Gesundheit von Personen!

WARNUNG

Verletzungsgefahr!Wenn der Sicherheitshinweis neben diesem Symbol nicht beachtet wird, besteht Gefahr fürLeben und Gesundheit von Personen!

VORSICHT

Schädigung von Personen!Wenn der Sicherheitshinweis neben diesem Symbol nicht beachtet wird, können Personengeschädigt werden!

Achtung

Schädigung von Umwelt oder GerätenWenn der Hinweis neben diesem Symbol nicht beachtet wird, können Umwelt oder Gerätegeschädigt werden.

Hinweis

Tipp oder FingerzeigDieses Symbol kennzeichnet Informationen, die zum besseren Verständnis beitragen.

Source Control 5Version: 1.1

Page 6: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Integration des Source-Control Management

2 Integration des Source-Control ManagementTwinCAT 3 verwendet das Visual Studio Framework als Basis der Workbench. Einer der Vorteile diesesKonzepts ist der einfache Zugriff auf die große Auswahl an Funktionen rund ums Programmieren in VisualStudio.

Dementsprechend profitiert TwinCAT auch vom Source Control Management in Visual Studio.

Dieser Abschnitt beschreibt, wie Sie dieses Feature in TwinCAT 3 nutzen können.

2.1 ProjektdateienDamit ein TwinCAT-Projekt mit Source-Control Managementsystemen kompatibel ist und die Arbeit inTeams unterstützt, wird es in mehreren Dateien gespeichert. Im TwinCAT-Projekt gibt es folgendeDateierweiterungen:

Dateierweite-rung

Source-Con-trol Manage-ment

Zusammenführen (Mer-gen) zulässig

Beschreibung

*.tsproj ja ja, TwinCAT ProjectCompare verwenden

TwinCAT Projektdatei

*.plcproj ja ja, TwinCAT ProjectCompare verwenden

TwinCAT SPS-Projektdatei

*.tmc ja für PLC-Projekte nichtzulässig

TwinCAT Modul Klasse (Beschreibungsdatei fürein TcCom Modul)

*.tpy nein - Diese Datei dient nur der Kompatibilität mitProgrammen anderer Anbieter.

*.xti ja ja, TwinCAT ProjectCompare verwenden

Bei deaktivierter Mehrfachdatei-Unterstützungwerden Teile der TwinCAT Projektdatei mitdieser Erweiterung gespeichert.

*.TcTTO ja ja, TwinCAT ProjectCompare verwenden

SPS Task-Objekt

*.TcPOU ja ja, TwinCAT ProjectCompare verwenden

Organisationseinheit SPS Programm (POU)

*.TcDUT ja ja, TwinCAT ProjectCompare verwenden

SPS Datentyp

*.TcGVL ja ja, TwinCAT ProjectCompare verwenden

Liste globale Variablen SPS

*.TcVis ja Derzeit nicht unterstützt Visualisierung SPS*.TcVMO ja Derzeit nicht unterstützt SPS Visualisierungsmanager*.TcGTLO ja ja, TwinCAT Project

Compare verwendenListe globale Texte SPS

*.sln nein - Diese Datei ist die „Solution“-Datei vom VisualStudio (VS). Sie enthält u.a. einen Tag mit derverwendeten VS-Version. Wird diese miteingecheckt wird ein Arbeiten mitverschiedenen VS-Versionen erschwert.

*.suo nein Dies ist die Benutzeroptionsdatei des VS-Projektes. Sie enthält Informationen zurausgewählten Plattform, Breakpoints etc. und istnutzerspezifisch! Sie wird beim erstmaligenÖffnen eines Projektes auf einem Rechner neuerzeugt.

HINWEIS! In der *.tmc Datei ist die Beschreibung des Prozessabbilds eines TcCom Modulsgespeichert. Soll dieses direkt nach dem Auschecken (Abholen) eines Projektes zur Verfügung stehen,auch wenn das Projekt vorher noch nicht auf dem eigenen Rechner übersetzt wurde, muss die TMC-

Source Control6 Version: 1.1

Page 7: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Integration des Source-Control Management

Datei mit abgeholt (und somit vorher mit dem Projekt mit eingecheckt) werden. Die TMC-Datei wirdnach dem Übersetzen eines SPS-Projektes automatisch neu generiert. Sie wird daher für SPS-ProjekteNICHT gemergt und muss ab der TwinCAT 3.1 Version 4018 auch nicht mehr unter Source-ControlVerwaltung stehen!

HINWEIS! Generell ist ein manuelles Zusammenführen der Dateien eines TwinCAT-Projektes nichtempfohlen. Hierfür sollte immer das TwinCAT Compare Tool verwendet werden!

2.2 ProjekteinstellungenDamit ein TwinCAT-Projekt, welches unter Verwendung eines Quellcodeverwaltungssystems gemanagtwird, möglichst unabhängig voneinander in einem Team bearbeitet werden kann, können verschiedeneEinstellungen gesetzt werden. Diese sind im Folgenden beschrieben.

Independent Project FileEs ist in TwinCAT möglich, einzelne Subprojekte, NC-Achsen oder IO-Geräte explizit in separaten Dateienzu speichern. Diese enthalten dann alle Parameter etc. des jeweiligen TwinCAT-Objektes, so dass beiÄnderungen an diesem Objekt nicht die komplette Projekt-Datei „ausgecheckt“ werden muss. So werdenz.B. auch die Verknüpfungen eines SPS-Projektes nicht mehr in der TwinCAT-Projekt-Datei gespeichert,sondern in der entsprechenden XTI-Datei des SPS-Projektes.

Damit diese Funktionalität in TwinCAT genutzt werden kann, muss dies einmal „global“ freigeschaltetwerden. Dies erfolgt über die TwinCAT – XAE Environment – File settings Kategorie in den Optionen derTwinCAT Engineering Umgebung.

Die Option „Enable Multiple Files“ schaltet die Nutzung dieser Funktionalität für neue Projekte frei. DieOptionen darunter definieren, für welche Elemente in einem neuen Projekt, diese Funktionalität per Defaulteingeschaltet wird.

HINWEIS! Eine Änderung dieser Optionen wird erst nach einem Neustart derEntwicklungsumgebung wirksam!

Source Control 7Version: 1.1

Page 8: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Integration des Source-Control Management

Verwendung von Independent Project Files in einem ProjektIst diese Option für ein TwinCAT-Objekt nicht per Default aktiviert, kann dies über die Option „IndependetProject File“ im Kontext-Menü des TwinCAT-Objects manuell erfolgen bzw. auch wieder zurückgesetztwerden.

Objekte die als Independent Project File gespeichert sind, werden mithilfe einer kleinen Diskette als OverlayIcon im TwinCAT-Baum markiert. Eine schwarze Diskette zeigt dabei an, dass es für dieses Objekt keinenoch nicht gespeicherten Änderungen gibt, bei einer roten Diskette ist dies der Fall.

Source Control8 Version: 1.1

Page 9: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Integration des Source-Control Management

Keep unrestored LinksWenn nicht anders eingestellt, ist TwinCAT bemüht, nicht mehr benötigte Informationen auch nicht mehr mitzu speichern, damit die Projektablage nicht unnötig belastet wird. Hierzu gehört auch, dass TwinCATüberprüft, ob Verknüpfungen noch gültig sind. Werden ungültige Verknüpfungen gefunden, werden sieautomatisch gelöscht. Dieser Mechanismus ist beim Mergen (Zusammenführen) von Projekten hinderlich, dabei einem Merge lediglich der Code und die Verknüpfungen gemergt werden können, das Prozessabbildaber erst nach einem erneuten Kompilieren des nun gemergten Codes aktualisiert zur Verfügung steht.Somit ist es möglich, dass die Verknüpfungsinformationen neuer sind, als das Prozessabbild und damitwürde der Optimierungsautomatismus alle Verknüpfungen zu den neuen Variablen im Prozessabbildlöschen. Mit der Option „Keep unrestored Links“ werden die Verknüpfungsinformationen die zum Löschenmarkiert sind, erhalten und automatisch wieder hergestellt, sobald die Variablen im Prozessabbildauftauchen.

Source Control 9Version: 1.1

Page 10: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Integration des Source-Control Management

2.3 HinweiseDie folgenden Punkte sollten bei der Verwendung von TwinCAT 3.1 in Zusammenarbeit mit Source ControlSystemen beachtet werden:

• Sowohl in der Baumansicht des TwinCAT- Projektes als auch in der Baumansicht des SPS-Projektessind TwinCAT-Objekte enthalten, deren Informationen in separaten Dateien gespeichert sind (alsonicht direkt in der jeweiligen Projektdatei). Diese Elemente sind mit einer kleinen Diskette im Baum-Icon gekennzeichnet. Im Falle eines Merges der jeweiligen Projektdatei (Dateien mit den Endungen*.tsproj und *.plcproj) kann somit nicht auf deren Inhalt zugegriffen werden. Es ist somit zum Beispielnur möglich, dass eine POU einem SPS-Projekt hinzugefügt wird, es kann aber nicht auf dieÄnderungen innerhalb einer POU zugegriffen werden. Hintergrund ist, dass die Source-Control-Clientsnicht in die jeweiligen Dateien die sie zum Mergen auschecken „hineinschauen“ und automatisiert auchalle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden.

• Da TwinCAT-Objekte in den Projekt-Dateien mit einer GUID eindeutig identifiziert werden, ist es immernotwendig das Löschen eines Objektes mit einem „Checkin“ zu bestätigen. Ein Löschen und neuAnlegen eines Objektes mit demselben Namen und demselben Inhalt ist aus diesem Grund immer eineÄnderung!

• Einige Objekte im TwinCAT-Baum erfordern, dass diese für deren Darstellung im Baum auch imHintergrund geladen werden. So werden alle Methoden, Aktionen etc. einer POU auch in diesergespeichert. Aus diesem Grund ist es sinnvoll, bei einem erneuten Abholen eines Projektes aus demSource Control System dieses vorher im TwinCAT zu schließen.

Source Control10 Version: 1.1

Page 11: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Konfiguration des Source-Control Client

3 Konfiguration des Source-Control ClientAuswahl des Source-Control Clients

1. wählen Sie Menü Tools -> Options der Microsoft Visual Studio Shell

ð Das Dialogfenster zeigt alle Einstellungen der Microsoft Visual Studio Shell Umgebung an.2. Wählen Sie "Source Control"

Abhängig vom gewählten Source-Control Managementsystem sind weitere Einstellungen erforderlich. Diesegewährleisten, dass das Project Compare zum Vergleichen von Projekten in TwinCAT aufgerufen wird. FürClients des Visual Studio Team Foundation Servers und den AnkhSVN Client für Subversion werden dieseEinstellungen automatisch aus dem TwinCAT Project Compare generiert.

Source Control 11Version: 1.1

Page 12: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Konfiguration des Source-Control Client

3.1 Wahl des Compare ToolsNach der Wahl des Source Control Clients, welcher im Projekt zur Anwendung kommen soll, muss diesernoch so konfiguriert werden, dass das TwinCAT Project Compare Tool zum Vergleichen undZusammenführen (Mergen) von TwinCAT-Dateien verwendet wird. Die Konfiguration der einzelnen Clientskann sich dabei deutlich unterscheiden.

Während Clients wie z.B. TFS oder PlasticsSCM es erlauben für die verschiedenen Dateitypenverschiedene Compare-Tools zu definieren, gibt es auch Clients bei denen es nur möglich ist, ein generellesCompare-Tool einzustellen (z.B. AnkhSVN). Darüber hinaus erlauben es Source Control Systeme wie GITauch zwischen lokalen (Projekteinstellungen) und globalen Einstellungen zu unterscheiden.

Für die Source Control Clients, die in Zusammenarbeit mit TwinCAT am häufigsten Anwendung finden (TFS,GIT und AnkhSVN) kann die Konfiguration des Compare Tools automatisiert aus dem TwinCAT ProjectCompare-Tool heraus erfolgen.

Da im Folgenden nicht auf alle Besonderheiten der verschiedenen Clients eingegangen werden kann, wirdfür die Beschreibung der Übergabeparameter auf das Kapitel Übergabeparameter TwinCAT Project CompareTool [} 14] des Project Compare Tools verwiesen.

HINWEIS! Hinweis: Einige Clients erlauben lediglich die Verwendung eines generellen Compare/Merge-Tools für alle Dateiendungen. Aus diesem Grund bietet das TwinCAT Project Compare-Toolebenfalls die Möglichkeit weitere Compare-Tools für spezielle Dateiendungen zu definieren (sieheKonfiguration des TcProjectCompare [} 19]).

Konfiguration des TcProjectCompareUm das TwinCAT Project Compare Tool aus der TwinCAT Entwicklungsumgebung heraus aufzurufen,müssen die gewählten Source-Control-Plug-Ins im Visual Studio entsprechend konfiguriert sein.

Einstellen des TwinCAT Project Compare als Standardtool für “Compare and Merge” Funktionen fürSubversion AnkhSVN, Microsoft Team Foundation Server bzw. GIT Clients:

1. öffnen Sie TwinCAT Compare2. wählen Sie Menü Tools -> "Configure User Tools... "

3. wählen Sie im folgenden Dialog ein Standardtool „Merge (verschmelzen)“. Dieses wird für alle Bereicheaußerhalb der SPS verwendet (z. B. zum Vergleich von Vorgaben für Aufgaben).

Source Control12 Version: 1.1

Page 13: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Konfiguration des Source-Control Client

4. Klicken Sie auf "Export Configuration"

5. Wurde das erforderliche Source-Control-Plugin in Visual Studio Shell bereits ausgewählt, können Siedie Vorgaben für dieses Plugin exportieren, sofern Sie einen Microsoft Team Foundation Server oderAnkhSVN-Client verwenden.

Source Control 13Version: 1.1

Page 14: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Project Compare Tool

4 Project Compare ToolDas TwinCAT Project Compare Tool ist ein Anwendungsprogramm, welches zum Vergleichen oderZusammenführen von TwinCAT Projekten verwendet werden kann. Das Tool kann sowohl integriert imVisual Studio als auch stand-alone verwendet werden. Ist der Source-Control-Client entsprechendkonfiguriert, wird das Tool im Falle eines Compare oder Merges automatisch aufgerufen. WeitereInformationen zur Konfiguration von Source-Control Management -Clients finden Sie unter Konfiguration vonProject Compare [} 19].

4.1 Verwendung des TcProjectCompare Tools

Übergabeparameter TwinCAT Project Compare ToolDa hier nicht auf alle Besonderheiten der verschiedenen Clients eingegangen werden kann, werden imFolgenden die Übergabeparameter des TwinCAT Project Compare Tools kurz erläutert:

Übergabeparameter für TwinCAT Versionen > 4020:

/filel Dateipfad linke Seite/filer Dateipfad rechte Seite/filem Dateipfad für die gemergte Datei/dl Anzeigename linke Seite/dr Anzeigename rechte Seite/sc Aufruf über Source Control Client

Übergabeparameter für TwinCAT Versionen <= 4018:

Dateipfad linke SeiteDateipfad rechte SeiteDateipfad gemergte Datei

/dl Anzeigename linke Seite/dr Anzeigename rechte Seite/sc Aufruf über Source Control Client

Im Project Compare Tool der Version <= 4018 wurden die Dateipfade für die linke, rechte und gemergteDatei anhand der Reihenfolge des Aufrufes bestimmt. Die Reihenfolge war hier immer linke Seite, rechteSeite, gemergte Datei.

Beispiele:

Vergleich (Compare/ Diff):

Version 4018 für PlasticSCM:

C:\TwinCAT\3.1\Components\TcProjectCompare\TcProjectCompare.exe"@destinationfile" "@sourcefile" /sc

Version 4018 für TFS:

C:\TwinCAT\3.1\Components\TcProjectCompare\TcProjectCompare.exe %2 %1 /dl %7 /dr%6 /sc

Version 4020 für TFS:

C:\TwinCAT\3.1\Components\TcProjectCompare\TcProjectCompare.exe /filel %2 /filer%1 /dl %7 /dr %6 /sc

Zusammenführen (Merge):

Source Control14 Version: 1.1

Page 15: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Project Compare Tool

Version 4018 für PlasticSCM:

C:\TwinCAT\3.1\Components\TcProjectCompare\TcProjectCompare.exe /dl"@destinationsymbolic" /dr "@sourcesymbolic" "@destinationfile" "@sourcefile""@output" /sc

Version 4018 für TFS

C:\TwinCAT\3.1\Components\TcProjectCompare\TcProjectCompare.exe %2 %1 %4 /dl%7 /dr %6 /sc

Version 4020 für TFS

C:\TwinCAT\3.1\Components\TcProjectCompare\TcProjectCompare.exe /filel %2 /filer%1 /filem %4 /dl %7 /dr %6 /sc

Starten des Project CompareTools über die KommandozeileDie Übergabe-/ Kommandozeilen-Parameter des Project Compare Tools sind im AbschnittÜbergabeparameter TwinCAT Project Compare Tool verfügbar:

Beispiel: Der Aufruf für ein Compare über die Kommandozeile mit dem Compare Tool der Version 4020oder neuer sieht demnach wie folgt aus:

C:\TwinCAT\3.1\Components\TcProjectCompare\TcProjectCompare.exe /filel <Dateilinke Seite> filer <Datei rechte Seite>

Verwendung des Compare Tools nach Starten der Exe-Datei:Hinweis: Wenn Sie im TwinCAT Projekt Encryption verwenden, können Sie nur mit der im Visual Studiointegrierten Version des TcProjectCompare arbeiten (siehe Starten des TcProjectCompare-Plugins im VisualStudio [} 17])!

Nach dem Start des TCProjectCompare Tools erscheint folgender Dialog:

Mit diesem Dialog können Sie die zwei TwinCAT Projekte auswählen, die verglichen werden sollen. Dasrechte Projekt ist das Originalprojekt, das linke Projekt das zu vergleichende.

Source Control 15Version: 1.1

Page 16: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Project Compare Tool

Um die Änderungen in einem TwinCAT Objekt (z. B. einer POU) anzuzeigen, öffnen Sie den Vergleich fürdieses Element per Doppelklick.

Source Control16 Version: 1.1

Page 17: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Project Compare Tool

Starten des TcProjectCompare-Plugins im Visual StudioZum Starten des TcProjectCompares im Visual Studio wählen Sie bitte den Menüeintrag Ansicht -> AndereFenster -> TcProiectCompare.

Source Control 17Version: 1.1

Page 18: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Project Compare Tool

XML-Vergleich von TwinCAT ObjektenAlle TwinCAT Dateien werden als XML-Dateien auf der Festplatte abgelegt. Eventuell kann es hilfreich sein,nicht die grafischen Editoren für einen Vergleich zu verwenden. Aus diesem Grund ist es möglich auch einenVergleich in der integrierten XML-Diff-View durchzuführen.

Hierzu öffnen Sie bitte das Kontext-Menü des TwinCAT-Objektes (via Rechts-Klick) und wählen die Option„Compare in Xml-Diff“.

Source Control18 Version: 1.1

Page 19: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Project Compare Tool

4.2 Konfiguration des TcProjectCompareEinige Clients erlauben lediglich die Verwendung eines generellen Compare/ Merge-Tools für alleDateiendungen. Aus diesem Grund bietet das TwinCAT Project Compare-Tool ebenfalls die Möglichkeitweitere Compare-Tools für spezielle Dateiendungen zu definieren.

Einstellen eines externen Compare-Tools für Dateiendungen:

1. Öffnen Sie TwinCAT Compare2. Wählen Sie Menü Tools -> "Configure User Tools... "

Source Control 19Version: 1.1

Page 20: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Project Compare Tool

3. Klicken Sie auf "Add"

4. Beschreiben Sie im Folgenden Dialog um welche Dateiendung es sich handelt, welches Toolaufgerufen werden soll (Zeile Command) und welche Übergabeparameter im Falle eines Compare oderMerges benötigt werden. Bestätigen Sie anschließend die Einstellungen mit OK.

4.3 Weitere OptionenUnter dem Menü Tools -> Options sind weitere Optionen vorhanden, um das TcProjectCompare Tool an dieeigenen Bedürfnisse anzupassen. Diese Optionen sollen im Folgenden beschrieben werden.

Optionsreiter GeneralIm Reiter General sind generelle Einstellungen des TcProjectCompare Tools hinterlegt.

Im Bereich „Automatic reload after modification“ können Sie einstellen, ob nach einer Änderung die Datei/das Projekt neu geladen werden soll.

Im Bereich „LogFile“ können Sie das Logging für das TcProjectCompare-Tool aktivieren.

Source Control20 Version: 1.1

Page 21: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Project Compare Tool

Optionsreiter Source ControlIm Bereich „Merge into“ können Sie festlegen, ob auf die lokale oder die Server-Datei gemergt werden soll.Da das TcProjectCompare nur von der rechten Seite in die linke mergen kann, wird hier definiert in welcherRichtung die Dateien im TcProjectCompare dargestellt werden.

Im Bereich „Visual Studio Integration“ können Sie festlegen, ob Sie das TcProjectCompare stand-alone oderintegriert im Visual Studio verwenden wollen. Letztere Option ist erst ab der TwinCAT Version 3.1 Build >4020 verfügbar.

Source Control 21Version: 1.1

Page 22: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Project Compare Tool

Optionsreiter ProjectIm Bereich „Expansion“ in diesem Reiter können Sie festlegen, ob beim Öffnen einer Projekt-Datei derkomplette Baum oder nur die Teile die Änderungen enthalten „aufgeklappt“ werden.

Im Bereich „Search“ können Sie festlegen, ob Suchanfragen innerhalb des TcProjectCompare-Tools nur diegeänderten Elemente oder alle Elemente berücksichtigen.

Optionsreiter PLCIn diesem Reiter können Sie festlegen, ob beim Vergleich von PLC POUs Leerzeichen oder Kommentareignoriert werden sollen.

Source Control22 Version: 1.1

Page 23: Handbuch Source Control - download.beckhoff.com · alle darin aufgeführten Abhängigkeiten mit aus dem Source-Control-System laden. • Da TwinCAT-Objekte in den Projekt-Dateien

Project Compare Tool

Optionsreiter XMLIm Bereich „Expansion“ können Sie festlegen, ob beim Öffnen einer XML-Datei der komplette Baum oder nurdie Teile die Änderungen enthalten „aufgeklappt“ werden.

Im Bereich „Search“ können Sie festlegen, ob Suchanfragen innerhalb des TcProjectCompare-Tools nur diegeänderten Elemente oder alle Elemente berücksichtigen bzw. ob auch in den Werten oder Kommentarender XML-Elemente gesucht werden soll.

Source Control 23Version: 1.1