Forge — Bausteintyp-Bibliothek

Forge ist Ihre wiederverwendbare Bausteintyp-Bibliothek: Sie nehmen bestehende Bausteine aus einem PLC-Projekt auf, sammeln und organisieren sie an einem Ort und spielen die gesamte Bibliothek später in jede verbundene PLC aus — die Ordnerstruktur der Bibliothek wird dabei als Gruppenstruktur in der PLC wiederhergestellt. Dazu zeichnet Forge bestehende Projekte als Anlagengraphen nach, die Sie durchsuchen, prüfen, bearbeiten und wieder in eine PLC ausspielen können.

Öffnen Sie den Forge-View-Container in der Aktivitätsleiste. In der Seitenleiste erscheint die Bausteintyp-Bibliothek als Baum aus Ordnern und Typen.

Voraussetzung: Forge ist Teil der kostenpflichtigen Editionen. Bei fehlender Lizenz bleiben die Forge-Befehle deaktiviert — siehe Lizenzierung.

Mit Forge verbinden

1. Öffnen Sie die Befehlspalette (Strg+Umschalt+P) und führen Sie „Mit Forge verbinden" aus — oder klicken Sie im Forge-View-Container auf Verbinden.
2. Sobald die Verbindung steht, zeigt die Statusleiste Forge: Verbunden und die Bibliothek wird geladen.

Zum Trennen führen Sie „Verbindung zu Forge trennen" aus.

Bausteine in die Bibliothek aufnehmen

Sie füllen die Bibliothek direkt aus einem geöffneten TIA-Projekt (siehe Projekt-Explorer). Forge und das TIA-Projekt müssen beide verbunden sein.

1. Rechtsklick auf eine PLC, eine Gruppe oder einen einzelnen Baustein im Projekt-Explorer.
2. „In Forge-Bibliothek erfassen" auswählen.
3. Bestätigen Sie, wie viele Elemente erfasst werden sollen.
4. Forge legt für jedes Element einen wiederverwendbaren Typ an und spiegelt dabei die Gruppenstruktur des Projekts als Ordner in der Bibliothek.

Erfasst werden Bausteine, Datentypen und Variablentabellen — auch solche, die in Software Units liegen.

Nach Abschluss meldet eine Mitteilung, wie viele Typen neu angelegt und wie viele aktualisiert wurden. Elemente, die sich nicht erfassen lassen, werden mit Name und Grund aufgeführt; identische Duplikate werden automatisch übersprungen und nicht als Fehler gezählt.

Bibliothek organisieren

Alle Operationen erreichen Sie per Rechtsklick in der Bausteintyp-Bibliothek:

• Neuer Bausteintyp — legt einen neuen, selbst gepflegten Typ an.
• Bausteintyp bearbeiten / duplizieren / löschen — auf einem Typ.
• Ordner / Unterordner — gliedern die Bibliothek beliebig tief.
• Umbenennen — auf Typ oder Ordner.
• Verschieben nach … — ordnet einen Typ einem anderen Ordner zu; eine Auswahlliste zeigt alle vorhandenen Ordner.

Die Reihenfolge der Einträge lässt sich per Ziehen ändern. Die Ordnerstruktur, die Sie hier aufbauen, bestimmt später die Gruppenstruktur in der PLC.

Beim Schreiben eigener Typ-Vorlagen hilft der KI-Chat: Fragen Sie den Forge Engineer-Agenten — er kennt die Vorlagensprache und unterstützt beim Erstellen, Prüfen und Korrigieren Ihrer Vorlagen.

Einen Bausteintyp bearbeiten

Ein Doppelklick auf einen Typ in der Bausteintyp-Bibliothek öffnet ihn als Tab: links die Felder des Typs, rechts je ein Vorlagen-Tab pro Ausgabeziel. Die Schaltfläche Speichern in der Symbolleiste speichert den gesamten Typ — Felder und alle Vorlagen zusammen.

Ungespeicherte Änderungen gehen nicht verloren: Der Tab markiert sie mit dem üblichen Punkt, beim Wechsel zu einem anderen Tab und zurück bleibt alles erhalten — Felder wie Vorlagentext —, und beim Schließen fragt der Tab zuerst, ob gespeichert oder verworfen werden soll, wie bei jeder anderen Datei.

Eine Vorlage im Texteditor öffnen

Eine Vorlage lässt sich auch in einem normalen Editor-Tab bearbeiten — praktisch, um sie neben anderen Dateien zu platzieren:

• Klicken Sie in der Symbolleiste des Bausteintyp-Tabs auf „Vorlage im Texteditor öffnen", oder
• klicken Sie mit der rechten Maustaste auf den Typ in der Bausteintyp-Bibliothek und wählen „Vorlage im Texteditor öffnen" — hat der Typ mehrere Vorlagen, fragt zuerst eine Auswahlliste, welche geöffnet werden soll.

Der Text-Tab und der Bausteintyp-Tab zeigen immer denselben Inhalt — was Sie im einen tippen, erscheint sofort im anderen. Strg+S im Text-Tab speichert nur diese Vorlage; die Schaltfläche Speichern im Bausteintyp-Tab speichert weiterhin alles.

Ein ganz neuer Bausteintyp muss einmal gespeichert werden, bevor sich seine Vorlagen so öffnen lassen — dasselbe gilt für ein frisch hinzugefügtes Ausgabeziel bis zum nächsten Speichern.

Der Chat sieht Ihre Vorlage

Solange der Bausteintyp-Tab (oder einer seiner Vorlagen-Text-Tabs) aktiv ist, hat der Chat-Assistent diese Vorlage automatisch als Kontext — sie erscheint über dem Chat-Eingabefeld. Fragen Sie direkt zur Vorlage: Der Assistent kennt ihren Inhalt und die verfügbaren Vorlagen-Hilfsfunktionen — ohne dass Sie etwas einfügen müssen.

Ein Projekt zurückentwickeln

Forge kann ein bestehendes PLC-Programm in einem Schritt als Anlagengraph nachzeichnen und gleichzeitig alle Inhalte als gekoppelte Bibliothekstypen erfassen — die Grundlage dafür, das Programm später aus dem Graphen heraus wieder auszuspielen.

1. Rechtsklick auf eine PLC im Projekt-Explorer (Forge und das TIA-Projekt müssen verbunden sein).
2. „Projekt in gekoppelte Bibliothek zurückentwickeln" auswählen und bestätigen — gleichnamige Bibliothekstypen werden überschrieben.
3. Eine Fortschrittsanzeige begleitet den Vorgang; am Ende öffnet sich der neue Graph als Tab, und eine Mitteilung fasst zusammen, wie viele Typen erfasst und wie viele Objekte und Verbindungen gezeichnet wurden.

Elemente, die sich nicht erfassen lassen, nennt die Mitteilung mit Name und Grund — sie erscheinen trotzdem im Graphen, bleiben aber ohne gekoppelten Bibliothekstyp. Greift ein Objekt mehrfach auf dasselbe andere Objekt zu, zeigt der Graph dafür eine einzige Verbindung statt eines Bündels paralleler Linien.

Den Projektgraphen ansehen

Wenn Forge ein bestehendes Projekt einliest, zeichnet es daraus eine visuelle Karte als Graph. Öffnen Sie einen Graphen aus der Liste Plant Graphs im Forge-View-Container — ein Doppelklick öffnet ihn als Tab. Sie verschieben den Ausschnitt durch Ziehen auf der leeren Fläche und zoomen mit dem Mausrad; ein Klick auf ein Element zeigt dessen Details an. Lange Namen werden auf der Karte gekürzt — der vollständige Name erscheint, sobald Sie mit der Maus darüber fahren.

Mehrere Graphen aus der Liste entfernen

In der Liste Plant Graphs lassen sich auch mehrere Graphen gleichzeitig auswählen: Strg+Klick fügt einen Eintrag zur Auswahl hinzu oder entfernt ihn, Umschalt+Klick wählt einen zusammenhängenden Bereich, und Strg+A wählt alle. Drücken Sie anschließend Entf (solange die Liste den Fokus hat) oder klicken Sie mit der rechten Maustaste auf die Auswahl und wählen „N Anlagengraphen löschen" — eine einzige Rückfrage deckt die gesamte Auswahl ab. Einen einzelnen Graphen entfernen Sie über das Papierkorb-Symbol, das beim Überfahren einer Zeile erscheint.

Den Graphen nach Kategoriebändern lesen

Der Graph ordnet alles in übersichtliche horizontale Kategoriebänder, von oben nach unten nach Typ gestapelt: Organisationsbausteine, Funktionsbausteine, Instanz-Datenbausteine, Funktionen, Datenbausteine, Datentypen, Technologieobjekte, Tags und Hardware. Bänder, die nichts enthalten, werden ausgeblendet.

• Jedes Band ist links beschriftet, mit leichter abwechselnder Schattierung, damit sich benachbarte Bänder gut unterscheiden lassen.
• Innerhalb eines Bandes sind die Elemente nach ihrem Projektordner gruppiert, und jede Ordnergruppe trägt ihren Ordnernamen.

Das Layout umschalten

Eine Schaltfläche in der Symbolleiste schaltet zwischen Layout: Kategorie — der oben beschriebenen Bänderansicht — und Layout: Hierarchie um, die den Graphen als Abhängigkeitsbaum entlang der Eltern-Kind-Beziehungen darstellt. Der Graph öffnet sich automatisch in einem sinnvollen Layout, und Ihre Auswahl wird pro Graph gemerkt, sodass er beim nächsten Öffnen so erscheint, wie Sie ihn verlassen haben.

Das Tags-Band einklappen

Das Tags-Band ist anfangs zu einem kompakten Chip eingeklappt (zum Beispiel „Tags ×15"), damit es die Ansicht nicht überlädt. Klicken Sie auf den Chip — oder auf die Beschriftung eines Bandes —, um dieses Band auf- oder zuzuklappen. Ihre Auswahl, was ein- oder ausgeklappt ist, wird pro Graph gemerkt.

In Ordner hineinzoomen

Bei großen Projekten wäre eine Zeile sonst mit Hunderten von Elementen auf einmal überfüllt. Stattdessen fasst jede Zeile ihre Bausteine in Ordnerboxen zusammen, jede beschriftet mit dem Ordnernamen und einer Anzahl — zum Beispiel „Sensoren ×340". Klicken Sie eine Ordnerbox an, um sie zu öffnen und die enthaltenen Bausteine zu sehen; ein erneuter Klick schließt sie wieder. Ihre Auswahl, was geöffnet und was geschlossen ist, wird pro Graph gemerkt.

Gebündelte Verbindungen

Solange ein Ordner geschlossen ist, werden alle Verbindungen in ihn hinein und aus ihm heraus als eine einzige, dickere Linie mit einer Zahl dargestellt — wie viele einzelne Verbindungen sie zusammenfasst. Öffnen Sie den Ordner, fächern sich diese Verbindungen in die einzelnen Linien auf.

Übersicht beim Herauszoomen

Zoomen Sie weit heraus, klappt jede Kategorie zu einem einzigen beschrifteten Balken zusammen und gibt Ihnen auf einen Blick eine klare Übersicht über das gesamte Projekt. Zoomen Sie wieder hinein, erscheinen die einzelnen Bausteine erneut.

Auch bei großen Projekten flüssig

Selbst sehr große Projekte — Tausende von Bausteinen und Datentypen — öffnen sich und lassen sich flüssig verschieben und zoomen, auch Projekte, die sich zuvor gar nicht darstellen ließen.

Einen Baustein finden

Über ein Suchfeld in der Symbolleiste geben Sie einen Bausteinnamen ein. Der Graph öffnet die Ordner auf dem Weg zum Treffer und zentriert ihn, sodass Sie ohne Suchen in der Ansicht direkt zu jedem Baustein springen.

Objekte im Anlagenbaum durchsuchen

Die Ansicht Anlagenbaum in der Forge-Seitenleiste zeigt die Objekte eines Anlagengraphen als Ordnerbaum — dieselbe Ordnerstruktur wie im Projekt. Enthält eine Ordnerebene mehrere Arten von Objekten, gruppiert der Baum sie zusätzlich nach Kategorie (Funktionsbausteine, Datenbausteine, Datentypen usw.).

• Existieren mehrere Graphen, wählt eine Auswahlliste im Kopf der Ansicht, welcher Graph angezeigt wird — jeder Eintrag nennt den Namen samt Erstellungsdatum.
• Das Papierkorb-Symbol in der Titelleiste der Ansicht löscht den angezeigten Graphen (nach Rückfrage).
• Ein Klick auf ein Objekt zeigt seine Details an; ein Doppelklick (oder Enter) öffnet den Graphen als Tab und springt direkt zum Objekt.
• Rechtsklick auf ein Objekt: „Im Graph anzeigen", „Anlagenobjekte öffnen" (öffnet die Tabelle, vorgefiltert auf den Ordner des Objekts) und „Knoten löschen" (mit Rückfrage). Rechtsklick auf einen Ordner: „Anlagenobjekte im Ordner öffnen".

Der Baum aktualisiert sich live, sobald sich der Graph ändert.

Objekte in der Tabelle bearbeiten

„Anlagenobjekte öffnen" (Befehlspalette oder Kontextmenü des Anlagenbaums) öffnet die Objekte eines Graphen als Tabelle in einem Editor-Tab — die zentrale Stelle, um Eigenschaften zu prüfen und über viele Objekte hinweg zu bearbeiten.

• Filtern: Schalter je Objekt-Art, eine Untertyp-Auswahl, ein Feld für das Ordnerpräfix, eine Suche über Symbol und Beschreibung sowie der Schalter „Ohne Kanten" für Objekte ohne Verbindungen. Eine Sortier-Auswahl mit Auf-/Absteigend-Schalter ordnet die Zeilen.
• Spalten: Symbol, Art, Untertyp, Ordner, Beschreibung und Kanten. Zeigt die Tabelle nur Objekte eines einzigen Untertyps, kommt pro Eigenschaft eine eigene Spalte hinzu.
• Inline bearbeiten: Klicken Sie eine Zelle (Symbol, Beschreibung oder eine Eigenschaft) an und ändern Sie den Wert direkt — gespeichert wird sofort. Wurde das Objekt zwischenzeitlich an anderer Stelle geändert, lädt die Tabelle die aktuellen Werte nach, statt sie zu überschreiben.
• „Spalte setzen…": Wählen Sie mehrere Zeilen aus und setzen Sie eine Eigenschaft für alle auf denselben Wert. Der Vorgang läuft mit Fortschrittsanzeige und lässt sich abbrechen; tritt ein Konflikt auf, stoppt er und meldet, wie viele Objekte gesetzt wurden — die übrigen bleiben unverändert.

Wird der Anlagengraph gelöscht, während seine Tabelle geöffnet ist, zeigt der Tab einen entsprechenden Hinweis und lässt sich einfach schließen — eine Fehlermeldung erscheint nicht.

Generierten Quelltext live ansehen

Mit einem ausgewählten Anlagenobjekt (im Anlagenbaum, in der Tabelle oder auf der Karte) öffnet „Generierten Quelltext in Vorschau anzeigen" (Befehlspalette) den generierten Quelltext dieses Objekts — schreibgeschützt, direkt neben Ihrer Arbeit. Beim ersten Mal fragt Forge, für welche Codegenerierungsziele die Vorschau erzeugt werden soll; die Auswahl wird pro Graph gemerkt. Hat das Objekt keinen generierten Quelltext, erscheint ein kurzer Hinweis in der Statusleiste.

Soll die Vorschau Ihrer Auswahl automatisch folgen, aktivieren Sie in den Einstellungen im Abschnitt Forge die Option Preview: Auto Open — die Vorschau aktualisiert sich dann von selbst, während Sie durch die Objekte klicken.

Den Anlagengraphen prüfen

„Anlagengraph prüfen" (Befehlspalette) durchsucht einen Graphen nach Auffälligkeiten — etwa eine Verbindung, die vergleichbare Objekte haben, diesem aber fehlt; eine leere Pflichteigenschaft; oder ein ungewöhnlicher Zahlenwert. Eine Mitteilung fasst Warnungen und Hinweise zusammen, und die Funde erscheinen in der Ansicht Diagnose unter Auffälligkeitsprüfungen. Ein Klick auf einen Fund springt direkt zum betroffenen Objekt auf der Karte. Die Prüfung ist rein lesend — sie ändert nichts am Graphen.

KI-Unterstützung

Der Chat-Assistent kennt Ihre Anlagengraphen: Er kann Objekte und ihre Eigenschaften lesen, den Graphen prüfen und auf Ihre Anweisung Objekte und Verbindungen anlegen, ändern oder entfernen. Jede Änderung am Graphen fragt vorher nach Ihrer Bestätigung — sie kann nicht automatisch freigegeben werden.

Bibliothek in eine PLC ausspielen

Mit einem Befehl materialisieren Sie die gesamte Bibliothek als Bausteine in einer verbundenen PLC.

1. Stellen Sie sicher, dass Forge verbunden ist und im TIA-Projekt eine PLC vorhanden ist (verbinden Sie das Projekt über „Mit TIA Openness Manager verbinden").
2. Klicken Sie in der Titelleiste der Bausteintyp-Bibliothek oder des Projekt-Explorers auf Ausspielen (Wolken-Symbol; im Projekt-Explorer sichtbar, sobald Forge und das TIA-Projekt verbunden sind) — oder führen Sie über die Befehlspalette „Bibliothek in TIA Portal ausspielen" aus.
3. Enthält das Projekt mehrere PLCs, wählen Sie die Ziel-PLC aus der Liste.
4. Existieren bereits gleichnamige Bausteine, erscheint eine Bestätigung mit der Anzahl der zu überschreibenden Bausteine — bestätigen Sie mit „Ausspielen und überschreiben" oder brechen Sie ab.
5. Eine Fortschrittsmeldung begleitet das Ausspielen; am Ende meldet eine Mitteilung, wie viele Bausteine in die PLC übernommen wurden. Anschließend wird das Projekt kompiliert und gespeichert.

Die Bausteine landen in derselben Gruppenstruktur wie in der Bibliothek — verschachtelte Ordner werden als verschachtelte Gruppen in der PLC angelegt. Ein erneutes Ausspielen verwendet bestehende Gruppen wieder und überschreibt die Bausteine.

Unterstützte Inhalte: Programmbausteine (FB/FC/OB, Global- und Instanz-DBs), PLC-Datentypen (UDTs) und PLC-Tag-Tabellen. Typen aus nicht unterstützten Kategorien werden vor dem Ausspielen übersprungen und in der Abschlussmeldung gezählt; Anweisungsliste-Bausteine (AWL/STL) werden ebenfalls vorab übersprungen und in der Abschlussmeldung mit Name und Grund genannt. Auch Inhalte aus Software Units werden vorab übersprungen und in der Abschlussmeldung mit Name und Grund genannt — das Ausspielen in Software Units wird noch nicht unterstützt.

Einen Anlagengraphen ausspielen

Auch ein Anlagengraph lässt sich direkt in eine verbundene PLC ausspielen — mit allem, was er enthält: Bausteine, Datentypen und Variablentabellen.

1. Öffnen Sie den Graphen als Tab und klicken Sie in dessen Titelleiste auf Ausspielen (Raketen-Symbol, sichtbar bei verbundenem TIA-Projekt) — oder klicken Sie auf die Rakete in der Titelleiste der Liste Plant Graphs oder des Projekt-Explorers: Ausgespielt wird der gerade geöffnete Graph; ist keiner geöffnet, wird der einzige vorhandene Graph verwendet, und bei mehreren wählen Sie ihn aus einer Liste. Alternativ führen Sie über die Befehlspalette „Graph in TIA Portal ausspielen" aus.
2. Enthält das Projekt mehrere PLCs, wählen Sie die Ziel-PLC aus der Liste.
3. Existieren bereits gleichnamige Bausteine, bestätigen Sie das Überschreiben mit „Ausspielen und überschreiben".
4. Am Ende meldet eine Mitteilung, wie viele Bausteine in die PLC übernommen wurden. Schlägt ein Baustein fehl, nennt die Meldung Name und Grund — alle übrigen Inhalte werden trotzdem übernommen. Auch vorab übersprungene Elemente — etwa AWL/STL-Bausteine oder Variablentabellen aus Software Units — führt die Meldung mit Name und Grund auf.

Was Forge gerade tut

Das Ausgabe-Panel hat einen eigenen Kanal Forge: Dort sehen Sie laufend, was der Generator und die Forge-Verbindung tun — hilfreich, wenn ein Erfassen oder Ausspielen nicht das erwartete Ergebnis liefert.

Hinweise & Einschränkungen

• Forge und das TIA-Projekt müssen verbunden sein. Fehlt eine der beiden Verbindungen oder enthält das Projekt keine PLC, weist eine Mitteilung darauf hin und es wird nichts verändert.
• Überschreiben ist bestätigungspflichtig — gleichnamige Bausteine werden erst nach Ihrer Zustimmung ersetzt.
• Grafische Bausteine (KOP/FUP) kann TIA Portal je nach Ziel-CPU ablehnen; SCL-Bausteine, Instanz- und Global-DBs, UDTs und Tag-Tabellen werden zuverlässig ausgespielt. Nicht übernommene Bausteine weist die Abschlussmeldung samt Grund aus.
• Anweisungsliste-Bausteine (AWL/STL) werden beim Ausspielen vorab übersprungen und in der Abschlussmeldung mit Name und Grund genannt — statt eines Fehlers aus TIA Portal.
• Gleiche Namen an mehreren Orten: Tragen zwei Elemente denselben Namen — etwa ein Datentyp in den PLC-Datentypen und ein gleichnamiger in einer Software Unit —, werden beide erfasst; das Element aus der Software Unit erhält in der Bibliothek eine eindeutige, an der Software Unit erkennbare Kennung. Nur identische Duplikate am selben Ort werden still übersprungen.
• Variablentabellen aus Software Units werden beim Ausspielen derzeit vorab übersprungen und in der Abschlussmeldung mit Name und Grund genannt — das Ausspielen in Software Units wird noch nicht unterstützt.
• Das Ausspielen verschachtelter Gruppen erfordert TIA Portal V17 oder neuer.