Versionsverwaltung mit Workspaces

Ein Versionsverwaltungs-Workspace ist ein Ordner auf der Festplatte, neben Ihrem TIA-Portal-Projekt oder an einem beliebigen anderen Ort, der Objekte des Projekts als gewöhnliche Dateien enthält: Bausteine, PLC-Datentypen, Variablentabellen, Technologieobjekte und Bibliothekstypen, eine Datei je Objekt. Weil der Ordner ein gewöhnlicher Ordner ist, können Sie ihn mit Git, SVN oder jedem anderen Werkzeug versionieren, das Sie bereits nutzen. Studio und TIA Portal halten Projekt und Dateien im Gleichschritt: Sie verbinden Objekte mit ihren Dateien, schreiben Änderungen aus dem Projekt in die Dateien, übernehmen geänderte Dateien zurück ins Projekt und sehen auf einen Blick, welche Seite sich geändert hat.

Die Workspaces gehören zum Projekt. TIA Portal speichert sie, ihre Ordner und jede Verbindung im Projekt, sie sind also beim nächsten Öffnen wieder da. Einen Workspace, den Sie in einem Projekt angelegt oder geändert haben, das Sie danach ohne Speichern schliessen, gibt es danach nicht mehr, wie jede andere Änderung auch.

Voraussetzungen

• Eine Verbindung zu TIA Portal mit einem geöffneten Projekt. In einem offline geöffneten Projekt werden die Workspaces nicht angezeigt.
• TIA Portal V17 oder neuer, um Workspaces und Gruppen zu sehen und zu verwalten. Die Sprache der Dateien lässt sich ab TIA Portal V18 wählen, die Einstellungen für den Bibliotheksimport ab TIA Portal V20.
• TIA Portal V20 oder neuer, um Objekte zu verbinden, zu exportieren, den Status zu lesen und abzugleichen. Unter V17, V18 und V19 verwalten Sie nur die Workspaces, und der Workspace-Status sagt das.
• Ob eine TIA-Portal-Installation die Versionsverwaltung überhaupt anbietet, hängt von ihrer Version und ihrem Update ab. Bietet sie sie nicht an, erscheint der Zweig Workspaces der Versionsverwaltung nicht.
• Die Workspaces und ihren Status sehen Sie in jedem Plan. Workspaces anlegen, ändern und löschen sowie Objekte verbinden, exportieren, importieren und trennen setzen den Pro-Plan voraus; ohne ihn öffnet sich der Upgrade-Dialog, und es wird nichts geändert.

Der Zweig Version Control Workspaces

Der Projekt-Explorer zeigt den Zweig Workspaces der Versionsverwaltung am Ende des Baums, nach Project Library und Global Libraries:

• Workspace-Gruppen ordnen Ihre Workspaces, zum Beispiel nach Linie oder Station. Eine Gruppe kann Workspaces und weitere Gruppen enthalten. Gruppen stehen vor den Workspaces, beide nach Namen sortiert.
• Workspaces zeigen ihren Stammordner als Beschreibung oder Kein Stammordner. Verweilen Sie mit der Maus auf einem Workspace, um seinen Stammordner, seine Sprache und ab TIA Portal V20 die Zahl der verbundenen Objekte zu sehen.
• Ein Doppelklick auf einen Workspace öffnet seinen Workspace-Status.

Die verbundenen Objekte selbst sind keine Zeilen im Baum, weil sich ihr Zustand mit jeder Bearbeitung ändert. Sie sehen sie im Workspace-Status.

Der Zweig wird gelesen, wenn Sie ihn anklicken oder aufklappen, wie Hardware, HMI und die Projektbibliothek: Bis dahin zeigt der Ordner ein kleines Ladesymbol. Soll er schon beim Verbinden des Projekts gelesen werden, schalten Sie Workspaces der Versionsverwaltung laden unter Project Explorer in den Einstellungen ein. Aktualisieren im Projekt-Explorer liest den Zweig zusammen mit dem übrigen Baum neu.

Jeder Eintrag für die Workspaces steht im Untermenü Workspaces der Versionsverwaltung des Kontextmenüs.

Workspaces anlegen und verwalten

Neuer Workspace

1. Klicken Sie mit der rechten Maustaste auf Workspaces der Versionsverwaltung oder eine Gruppe und wählen Sie Neuer Workspace.... Auf einer Gruppe kommt der Workspace in diese Gruppe, aus der Befehlspalette auf die oberste Ebene
2. Geben Sie den Namen ein. Workspace-Namen sind im ganzen Projekt eindeutig, auch über Gruppen hinweg, und dürfen bis zu 128 Zeichen ohne Schrägstrich, umgekehrten Schrägstrich oder Steuerzeichen haben
3. Wählen Sie den Stammordner des Workspace. Der Dialog öffnet im Ordner des TIA-Portal-Projekts, so wie TIA Portal es vorschlägt; wählen Sie den Projektordner selbst, verwendet Studio einen Unterordner mit dem Namen des Workspace, damit die Dateien nie neben der Projektdatei landen. Jeder andere vorhandene Ordner geht ebenfalls
4. Ab TIA Portal V18 wählen Sie die Sprache der Dateien: Bearbeitungssprache des Projekts oder Andere Sprache... mit einem Sprachcode wie de-DE. Die Sprache muss im Projekt aktiv sein und lässt sich später nicht mehr ändern
5. Die Meldung bestätigt den neuen Workspace mit seinem Stammordner, und die neue Zeile ist markiert

Ab TIA Portal V18 erscheint im Stammordner ein kleiner Ordner .vci; darin hält TIA Portal die Einstellungen des Workspace. Mehrere Workspaces dürfen denselben Stammordner nutzen.

Neue Gruppe

Klicken Sie mit der rechten Maustaste auf Workspaces der Versionsverwaltung oder eine Gruppe, wählen Sie Neue Gruppe... und geben Sie den Namen ein. Gruppennamen sind innerhalb ihrer übergeordneten Gruppe eindeutig.

Umbenennen

Umbenennen auf einer Gruppe oder einem Workspace fragt nach dem neuen Namen. Ein geöffneter Workspace-Status folgt dem Workspace zu seinem neuen Namen.

Löschen

Löschen fragt zuerst und sagt, was wegfällt:

• Das Löschen eines Workspace entfernt den Workspace und die Verbindungen seiner Objekte. Die Objekte bleiben im Projekt, und die Dateien und der Ordner .vci bleiben im Stammordner auf der Festplatte. Bestätigen Sie mit Workspace löschen
• Das Löschen einer Gruppe entfernt jeden Workspace und jede Gruppe darin samt ihren Verbindungen. Die Objekte bleiben im Projekt, und die Dateien bleiben auf der Festplatte. Bestätigen Sie mit Gruppe und Workspaces löschen

Die Meldung nennt, wie viele Verbindungen entfernt wurden. Ein geöffneter Workspace-Status eines gelöschten Workspace schliesst sich.

Stammordner festlegen

Stammordner festlegen... auf einem Workspace wählt einen anderen Stammordner. Hat der Workspace bereits einen Stammordner, können Sie ab TIA Portal V20 auch Stammordner entfernen wählen: Der Workspace behält seine Verbindungen, hat aber keinen Ordner, bis Sie wieder einen festlegen. Verbinden und Exportieren setzen einen Stammordner voraus.

Einstellungen für den Bibliotheksimport

Ab TIA Portal V20 legen Sie mit Bibliotheksimport-Einstellungen... auf einem Workspace fest, wie Bibliothekstypen aus diesem Workspace ins Projekt übernommen werden:

• Globale Bibliothek für Typimporte wählen... wählt die Datei der globalen Bibliothek, in die importierte Bibliothekstypen kommen, und Globale Bibliothek für Typimporte entfernen hebt das wieder auf
• Unbenutzte Typversionen nach einem Import löschen oder Unbenutzte Typversionen nach einem Import behalten entscheidet, was mit Typversionen geschieht, die nach einem Import nicht mehr verwendet werden

Der Kopf des Workspace-Status zeigt beide Einstellungen.

Workspace-Ordner anzeigen

Workspace-Ordner anzeigen öffnet den Stammordner im Windows-Explorer. Öffnen Sie diesen Ordner in Studio als eigenen Ordner, übernimmt die eingebaute Quellcodeverwaltung von Studio die Dateien, und Sie können sie wie alle anderen Dateien committen, vergleichen und pushen; siehe Git-Client.

Objekte in einen Workspace bringen

Ein Objekt kommt auf zwei Wegen in einen Workspace. Mit Workspace verbinden... verknüpft Objekte mit Dateien, die bereits im Ordner liegen, zum Beispiel nachdem Sie ein Repository geklont haben. In Workspace exportieren... schreibt die Dateien aus dem Projekt und verknüpft sie in einem Schritt. Beides setzt TIA Portal V20 oder neuer voraus.

Klicken Sie mit der rechten Maustaste auf eine oder mehrere dieser Zeilen oder auf einen Ordner, der sie enthält, und öffnen Sie das Untermenü Workspaces der Versionsverwaltung:

• Bausteine (FB, FC, OB, DB, fehlersichere Bausteine eingeschlossen)
• PLC-Datentypen
• PLC-Variablentabellen
• Technologieobjekte
• die Ordner Program blocks, eine Bausteingruppe, PLC data types, PLC tags und Technology objects; ein Ordner steht für die Objekte darin

Typen der Projektbibliothek bringen Sie über den Assistenten in einen Workspace, siehe KI-Assistenten-Unterstützung.

In Workspace exportieren

1. Wählen Sie In Workspace exportieren...
2. Wählen Sie den Workspace. Hat das Projekt noch keinen, bietet Studio Neuer Workspace... an; ein Workspace ohne Stammordner bittet Sie, zuerst einen festzulegen
3. Wählen Sie das Dateiformat (siehe unten)
4. Geben Sie den Ordner unterhalb des Stammordners ein, der die Dateien aufnimmt, zum Beispiel Blocks\Main, oder lassen Sie das Feld leer, um in den Stammordner zu schreiben. Ein fehlender Ordner wird angelegt. Ein vollständiger Pfad oder .. wird nicht angenommen
5. Wählen Sie Ordnerstruktur des Projekts übernehmen (die Vorgabe, wie in TIA Portal: unterhalb dieses Ordners landen die Dateien in Unterordnern, die die Bausteingruppen des Projekts abbilden, zum Beispiel BlocksKernelSinamicsSpeedCtrl.scl) oder Alle Dateien in diesen Ordner legen
6. Bestätigen Sie mit Exportieren. TIA Portal schreibt je Objekt eine Datei und verbindet das Objekt mit ihr. Eine Datei gleichen Namens im selben Ordner wird überschrieben

Mit Workspace verbinden

1. Wählen Sie Mit Workspace verbinden...
2. Wählen Sie den Workspace und das Dateiformat wie bei einem Export
3. Wählen Sie den Ordner, der die Dateien enthält. Der Ordnerdialog öffnet sich im Stammordner, und der Ordner muss der Stammordner sein oder darunter liegen
4. Wählen Sie, ob die Dateien in Unterordnern liegen, die die Bausteingruppen des Projekts abbilden (die Vorgabe), oder alle in diesem Ordner
5. Jedes Objekt wird mit der Datei seines Namens im passenden Ordner verbunden. Die Dateien müssen bereits existieren; es wird nichts geschrieben

Dateiformate

Vor der Formatwahl fragt Studio TIA Portal, welche Formate jedes Objekt unterstützt. Objekte, die TIA Portal nicht in einem Workspace führen kann, werden als nicht unterstützt gemeldet. Die Auswahl bietet Bevorzugtes Format jedes Objekts und jedes Format an, das TIA Portal angeboten hat, jeweils mit der Zahl der Objekte, für die es gilt; Objekte, die das gewählte Format nicht anbieten, nehmen ihr bevorzugtes.

Bevorzugtes Format jedes Objekts nimmt SCL, wo es angeboten wird, sonst SimaticML, sonst SimaticSD, sonst das erste Format, das TIA Portal anbietet. Ein Bibliothekstyp wird als drei Dateien geschrieben: seine Quelle und zwei kleine Beschreibungsdateien, die TIA Portal zum Zurücklesen braucht.

Das Ergebnis

Eine Meldung fasst den Lauf zusammen, zum Beispiel 12 von 14 Objekten in den Workspace "Station_A" exportiert., sagt, wie viele auf beiden Seiten bereits gleich waren, und nennt jedes Objekt, das nicht verarbeitet wurde, mit dem Grund: ein Objekt, das TIA Portal nicht in einem Workspace führen kann, ein Format, das das Objekt nicht anbietet, eine fehlende Datei, eine bereits verbundene Datei, eine schreibgeschützte Datei, ein know-how-geschützter Baustein oder unter TIA Portal V21 ein Objekt, das zuerst übersetzt werden muss. Ist ein Objekt gescheitert, ist die Meldung eine Warnung und bietet Workspace-Status öffnen an.

Der Workspace-Status

Workspace-Status öffnen auf einem Workspace, ein Doppelklick auf seine Zeile oder die Schaltfläche in der Exportmeldung öffnet einen Tab je Workspace. Er zeigt den Zustand jedes verbundenen Objekts.

Kopf. Der Workspace und seine Gruppe, der Stammordner, die Sprache der Dateien und der Kommentar des Workspace, falls er einen hat; ab TIA Portal V20 ausserdem die globale Bibliothek für Typimporte und ob unbenutzte Typversionen nach einem Import gelöscht werden.

Zusammenfassung. Die Zahl der verbundenen Objekte und wie viele in jedem Zustand sind.

Tabelle. Eine Zeile je verbundenem Objekt mit einem Kontrollkästchen, dem Objekt (seinem Ort im Projekt), der Datei (ihrem Pfad unterhalb des Stammordners), dem Format, dem Zustand und bei einem Konflikt den Schaltflächen zum Auflösen. Alle Objekte auswählen im Tabellenkopf hakt jede Zeile an.

Die Werkzeugleiste bietet:

• Aktualisieren fragt TIA Portal nach dem aktuellen Zustand jedes verbundenen Objekts
• Auswahl in Workspace exportieren schreibt die angehakten Objekte, die im Projekt geändert wurden oder deren Datei fehlt, in ihre Dateien. Andere angehakte Zeilen bleiben aussen vor
• Auswahl aus Workspace importieren übernimmt die angehakten Dateien, die im Ordner geändert wurden, ins Projekt. Es fragt immer zuerst, ... Objekte aus dem Workspace "..." ins Projekt importieren?, weil TIA Portal jedes Objekt im Projekt durch den Inhalt seiner Datei ersetzt. Speichern Sie das Projekt vorher, wenn Sie einen Weg zurück behalten möchten. Bestätigen Sie mit Importieren
• Trennen entfernt nach einer Bestätigung die Verbindung der angehakten Objekte. Die Objekte bleiben im Projekt und ihre Dateien im Ordner

TIA Portal liest die Dateien eines Workspace so, wie sie sind, ohne sie vorher zu formatieren. Wenn Sie SCL-Dateien eines Workspace in Studio bearbeiten, führen Sie vor dem Import Dokument formatieren aus, damit sie im Layout des TIA-Portal-Editors ankommen, mit den Werten des Abschnitts SCL-Formatierung in den Einstellungen.

Beide geändert. Ein auf beiden Seiten geändertes Objekt ist nie Teil eines Exports oder Imports der Auswahl. Entscheiden Sie stattdessen in seiner Zeile:

• Projektversion behalten schreibt die Projektversion in die Datei; die Änderungen in der Datei gehen verloren. Bestätigen Sie mit Datei überschreiben
• Dateiversion behalten importiert die Datei ins Projekt; die im Projekt gemachten Änderungen gehen verloren. Bestätigen Sie mit Projektobjekt überschreiben

Offene Editoren. Ein Baustein, Datentyp oder eine Variablentabelle, die während des Imports ihrer Datei in einem Studio-Editor offen ist, zeigt sofort den importierten Inhalt. Ein Editor mit ungespeicherten Änderungen behält Ihren Text; beim Speichern meldet Studio, dass das Projekt eine neuere Fassung hat, und lässt Sie entscheiden.

Identische Objekte. Ein Objekt, das auf beiden Seiten gleich ist, lässt sich nicht abgleichen; TIA Portal lehnt es ab, und Studio sagt, dass es nichts abzugleichen gibt.

Einen verbundenen Baustein in Studio speichern. Öffnen Sie einen verbundenen Baustein aus dem Projekt-Explorer, ändern und speichern Sie ihn, bleibt er verbunden: Studio kompiliert den gespeicherten Baustein, erhält seine Verbindung und schreibt die gespeicherte Fassung sofort in seine Datei im Workspace-Ordner, die Zeile bleibt also Identisch. Eine Meldung nennt die geschriebene Datei. Konnte die Datei nicht geschrieben werden, etwa weil sie schreibgeschützt ist, weist eine Warnung Sie darauf hin, das Objekt im Workspace-Status zu exportieren, bevor Sie etwas importieren, weil der Workspace es sonst als Datei geändert zeigt.

Schreibgeschützte Dateien. Hält Ihr Versionsverwaltungssystem Dateien schreibgeschützt, bis Sie sie auschecken, wird ein Export in eine solche Datei abgelehnt. Machen Sie die Datei beschreibbar, zum Beispiel durch Auschecken, und versuchen Sie es erneut.

Nach jeder Aktion zeigt die Fusszeile den laufenden Vorgang, eine Meldung fasst das Ergebnis zusammen und nennt jedes Objekt, das nicht verarbeitet wurde, und die Ansicht liest den Status neu. Ändern sich die Dateien im Ordner, während der Tab offen ist, zum Beispiel nach einem Pull, erscheint der Hinweis Dateien im Workspace-Ordner haben sich geändert. Klicken Sie auf Aktualisieren, um den aktuellen Stand zu lesen.; die Ansicht fragt TIA Portal nie von sich aus.

Ist noch kein Objekt verbunden, weist die Ansicht Sie auf Mit Workspace verbinden... und In Workspace exportieren... im Projekt-Explorer hin.

Ein typischer Ablauf mit Git

1. Legen Sie einen Workspace an, dessen Stammordner der Ordner Ihres Repositorys ist oder ein Ordner darin
2. Markieren Sie die Ordner Program blocks und PLC data types und führen Sie In Workspace exportieren... aus
3. Committen Sie die Dateien mit Git, in der Quellcodeverwaltung von Studio oder in einem anderen Client
4. Öffnen Sie nach einem Pull den Workspace-Status: Die Objekte, deren Dateien geändert eingetroffen sind, zeigen Datei geändert. Haken Sie sie an und führen Sie Auswahl aus Workspace importieren aus
5. Nach der Arbeit in TIA Portal zeigen die geänderten Objekte Projekt geändert. Exportieren Sie sie und committen Sie erneut

Was TIA Portal tut

• TIA Portal schreibt eine Datei je Objekt, benannt nach dem Objekt, und ab TIA Portal V18 einen Ordner .vci mit den Einstellungen des Workspace in den Stammordner
• Ein Export auf eine noch nicht verbundene Datei gleichen Namens überschreibt diese Datei ohne Rückfrage; die Bestätigung von Studio sagt das, bevor Sie starten
• Beide Richtungen überschreiben die andere Seite: Ein Export ersetzt die Datei, ein Import ersetzt das Objekt im Projekt. Studio fragt vor jedem Import und vor dem Auflösen eines Konflikts
• Ein Objekt, das auf beiden Seiten gleich ist, lässt sich nicht abgleichen
• Das Löschen eines Workspace oder einer Gruppe und das Trennen von Objekten löscht nie Dateien und ändert nie die Objekte im Projekt
• Die Workspaces werden mit dem Projekt gespeichert

Bekannte Einschränkungen

• Verbinden, Exportieren, der Status und das Abgleichen setzen TIA Portal V20 oder neuer voraus. Unter V17 bis V19 lassen sich die Workspaces nur verwalten
• Der Inhalt von Software-Units wird nicht abgedeckt: Bausteine, PLC-Datentypen und Variablentabellen in einer Software-Unit lassen sich aus Studio nicht verbinden oder exportieren, und ein Objekt einer Software-Unit, das in TIA Portal selbst verbunden wurde, erscheint im Workspace-Status ohne seine Art
• TIA Portal bietet für Technologieobjekte das Format SimaticML an, kann den Export eines Technologieobjekts aber ablehnen; die Meldung nennt das Objekt und den Grund, den TIA Portal angegeben hat
• Unter TIA Portal V21 lässt sich ein nicht übersetztes Objekt nicht exportieren; übersetzen Sie es im Projekt und versuchen Sie es erneut
• Der Import einer geänderten Bibliothekstyp-Datei wird unter TIA Portal V20 nicht angeboten, weil er TIA Portal beenden würde. Importieren Sie sie mit TIA Portal V21 oder neuer. Der Export von Bibliothekstypen funktioniert in beiden Versionen
• Die Sprache eines Workspace wird einmal beim Anlegen gewählt
• Ob die Versionsverwaltungs-Schnittstelle verfügbar ist, hängt von der installierten TIA-Portal-Version und ihrem Update ab

KI-Assistenten-Unterstützung

Der Assistent erreicht die Workspaces über das Tool Manage TIA Version Control Workspaces. Er listet die Gruppen und Workspaces, liest den Status eines Workspace und die Dateiformate von Objekten, legt Workspaces und Gruppen an (ein neuer Workspace darf im Ordner des verbundenen TIA-Portal-Projekts, in Ihrem Dokumente- oder Desktop-Ordner, im Exportordner oder in einem geöffneten Ordner liegen), ändert und löscht sie, verbindet Objekte mit vorhandenen Dateien, exportiert Objekte in einen Workspace (Sie können einen ganzen Ordner des Projekt-Explorers nennen, etwa Program blocks oder eine Bausteingruppe, und die Dateien behalten die Ordnerstruktur des Projekts, sofern Sie keinen flachen Ordner verlangen; ein noch nicht vorhandener Stammordner wird nach Ihrer Freigabe angelegt), trennt sie und gleicht in der Richtung ab, die Sie verlangen. Zum Beispiel: «Welche Workspaces hat das Projekt?», «Exportiere alle Bausteine von PLC1 in den Workspace StationA, Ordner Blocks» oder «Übernimm die geänderten Dateien von Station_A ins Projekt».

Auflisten und das Lesen des Status ändern nichts und laufen ohne Rückfrage. Vor jeder anderen Aktion zeigt Ihnen der Assistent eine Karte mit dem, was er tun wird, und führt sie erst nach Ihrer Freigabe aus: Die Karte eines Imports sagt, dass TIA Portal die Objekte im Projekt ersetzt, die Karte eines Exports, dass der bisherige Inhalt jeder Datei verloren geht, sofern Ihr Versionsverwaltungssystem ihn nicht aufbewahrt, und die Karte eines Löschens, was entfernt wird und dass die Dateien bleiben. Ein auf beiden Seiten geändertes Objekt fasst er nur an, wenn Sie es nennen und sagen, welche Seite gilt. Danach meldet der Assistent jedes Objekt, das nicht verarbeitet wurde, mit dem Grund. Das Tool gehört zur Tool-Kategorie tia-version-control und setzt den Pro-Plan voraus. Wie der KI-Chat auf Tools zugreift, beschreibt die KI-Integration.