Beschreibung für Projekte, POEs und Symbole

Im 'Beschreibung'-Editor (verfügbar für Projekt-Knoten, POEs und HMI-Symbole) können Sie Informationen zum PLCnext Engineer-Projekt, zu POEs und HMI-Symbolen eingeben.

Mit dem Editor kann z.B. dokumentiert werden, was sich im Rahmen einer Überarbeitung des Elements geändert hat. Sie können mit dem Editor auch HMTL5-Hilfedateien für Funktion/Funktionsbaustein-POEs erstellen.

Der Editor 'Beschreibung' ist in zwei Bereiche unterteilt:

Versionshistorie
Mit Hilfe der Versionshistorie können Sie Änderungen des Elements verfolgen. Geben Sie in diesem Editor Versionsinformationen zum Projekt ein (z.B. Versionsnummer, Lebenszyklus, Autor usw.).
Anwender-Metadaten-Editor (nur im 'Beschreibung'-Editor des Projektknotens verfügbar)
Hier können Sie Schlüssel-Werte-Paare definieren, die in die Metadaten-Datei (.json-Format) eingebunden werden. Die Metadaten-Datei ist Teil des Device and Update Management (DaUM) Pakets (siehe hierzu das Thema "Daten als DAuM-Paket exportieren").
Dokumentationseditor
Hier können Sie mit dem Rich Text Format Editor oder dem HTML-Editor Informationen zum Projekt, zur POE oder zum Symbol eingeben. Zusätzlich können Sie HMTL5-Hilfedateien für Funktion/Funktionsbaustein-POEs erstellen.

Hinweis
Die Unterstützung des RTF-Formats ist veraltet und wird in einer zukünftigen Version von PnE nicht mehr verfügbar sein. Wir empfehlen die Verwendung von HTML5.

Welcher Editor standardmäßig beim Erzeugen eines neues Projekts verwendet wird, ist im Dialog 'Extras > Optionen' unter der Kategorie 'Werkzeug | Beschreibung' definiert.
Beide Editoren sind nachfolgend beschrieben.

Wenn Sie das Projekt als Bibliothek veröffentlichen, wird der Inhalt des Beschreibungseditors ebenfalls exportiert.

Sie öffnen den 'Beschreibung'-Editor für...

das Projekt, indem Sie in der ANLAGE auf den 'Projekt'-Knoten doppelklicken.
eine POE, indem Sie die entsprechende POE in den KOMPONENTEN doppelklicken (Ordner 'Lokal' in der Kategorie 'Programmierung').
ein HMI-Symbol, indem Sie auf das entsprechende Symbol in den KOMPONENTEN doppelklicken (Ordner 'Lokal' in der Kategorie 'HMI').

Wählen Sie dann im Editorenbereich das Register 'Beschreibung'.

Hinweis
Der Inhalt des 'Beschreibung'-Editors wird exportiert, wenn Sie eine Bibliothek veröffentlichen.

Versionshistorie

Die Tabelle Versionshistorie zeigt Eigenschaften jeder Projektversion an. Sie enthält folgende Spalten:

Spalte Beschreibung

Version Zeigt die Versionsnummer an, welche die Version identifiziert.
Die Vergabe einer Versionsnummer ist verpflichtend, wenn Sie für eine neue Version eine Zeile in die Tabelle einfügen.
Wenn Sie eine Versionsnummer in ein leeres Feld eingeben und den Wert mit <Eingabe> oder <Tab> bestätigen, werden die Felder 'Datum' und 'Lebenszyklus' automatisch ausgefüllt und es wird eine leere Tabellenzeile angefügt.

Datum Zeigt das Datum, an dem diese Version angelegt wurde.
Hier wird automatisch das aktuelle Datum eingetragen (sobald Sie eine Nummer in die Spalte 'Version' eintragen) und kann nicht geändert werden.

Lebenszyklus Dieses Feld bietet eine Reihe vordefinierter Lebenszyklus-Bezeichnungen in einer Liste zur Auswahl an. Mit dieser Angabe können Sie die Entwicklungsphase des Elements spezifizieren.
Der Lebenszyklus wird automatisch auf '-Nicht definiert-' gesetzt, sobald Sie eine Nummer in das Feld 'Version' eingeben.

Autor Zeigt an, welcher Autor die Version hinzugefügt hat.

Kommentar Kommentar zur Version

Spalte	Beschreibung
Version	Zeigt die Versionsnummer an, welche die Version identifiziert. Die Vergabe einer Versionsnummer ist verpflichtend, wenn Sie für eine neue Version eine Zeile in die Tabelle einfügen. Wenn Sie eine Versionsnummer in ein leeres Feld eingeben und den Wert mit <Eingabe> oder <Tab> bestätigen, werden die Felder 'Datum' und 'Lebenszyklus' automatisch ausgefüllt und es wird eine leere Tabellenzeile angefügt.
Datum	Zeigt das Datum, an dem diese Version angelegt wurde. Hier wird automatisch das aktuelle Datum eingetragen (sobald Sie eine Nummer in die Spalte 'Version' eintragen) und kann nicht geändert werden.
Lebenszyklus	Dieses Feld bietet eine Reihe vordefinierter Lebenszyklus-Bezeichnungen in einer Liste zur Auswahl an. Mit dieser Angabe können Sie die Entwicklungsphase des Elements spezifizieren. Der Lebenszyklus wird automatisch auf '-Nicht definiert-' gesetzt, sobald Sie eine Nummer in das Feld 'Version' eingeben.
Autor	Zeigt an, welcher Autor die Version hinzugefügt hat.
Kommentar	Kommentar zur Version

Doppelklicken Sie in ein Feld, um es zu bearbeiten. Es können keine Zeilen gelöscht werden.

Sie können die Versionshistorie-Tabelle nach Datum sortieren, indem Sie in die Überschrift 'Datum' klicken (wiederholtes Klicken wechselt zwischen abwärts und aufwärts sortiert und unsortiert). Das Pfeilsymbol in der Spaltenüberschrift zeigt die aktuelle Sortierung an.

Dokumentationseditor

Im oberen Bereich können Sie in die Felder 'Bezeichner' und 'Titel' Informationen zum Produkt eingeben (z.B. Produktnummer und Produktname).

Der Inhalt wird in den Eingabebereich eingegeben. Für die Eingabe der Informationen können Sie entweder den Rich Text Format Editor oder den HTML-Editor verwenden. Die Auswahl des Editors, der per Voreinstellung für ein neues Projekt verwendet wird, wird im Dialog 'Extras > Optionen' in der Kategorie 'Werkzeug | Beschreibung' festgelegt. Jeder Editor besitzt eine eigene Symbolleiste, die verschiedene Befehle zum Bearbeiten des Inhalts bereitstellt.

Hinweis
In einem bestehenden Projekt kann der Editor nicht gewechselt werden.

Mit beiden Editoren können Sie den Inhalt in eine HTML-Datei exportieren und Inhalte aus einer HTML-Datei importieren (siehe hierzu die unten stehende Beschreibung).

Beide Editoren unterstützen grundlegende Bearbeitungsfunktionen wie Kopieren, Einfügen, Ausschneiden und Verschieben von Text (mit den Standard-Tastenkombinationen zum Ausschneiden (<Strg>+<X>), Kopieren (<Strg>+<C>), Einfügen (<Strg>+<V>), und Löschen (<Entf>) von markiertem Text).

Mit dem Rich Text Format Editor arbeiten

Der Rich Text Format Editor ist ein einfach zu bedienender Editor, mit dem Sie Text formatieren und Tabellen, Listen und andere Inhalte, wie z.B. Bilder einfügen können. Der Editor bietet typische Formatierungsoptionen bzgl. Schriftart, Ausprägung, Größe, Farbe des Fonts, Ausrichtung. etc.

Zusätzlich zu den typischen Textformatierungen können Sie:

Tabellen einfügen und bearbeiten

Aktion	Vorgehensweise
Tabelle einfügen	Setzen Sie den Cursor an die gewünschte Position im Editor und klicken Sie in der Symbolleiste auf folgendes Symbol: Legen Sie im Dialog die Anzahl der Spalten und Zeilen der gewünschten Tabelle fest (Sie können anschließend beliebige Spalten und Zeilen löschen oder hinzufügen).
Größe einzelner Spalten oder Zeilen anpassen	Um die Größe einer einzelnen Spalte zu ändern, ziehen Sie den Spaltenrand bis zur gewünschten Breite. Um die Größe einer einzelnen Zeile zu ändern, ziehen Sie den unteren Zeilenrand bis zur gewünschten Höhe.
Spalten und Zeilen einfügen	Um eine einzelne Spalte einzufügen, selektieren Sie eine Spalte und wählen 'Spalte rechts einfügen' oder 'Spalte links einfügen' aus dem Kontextmenü. Um eine einzelne Zeile einzufügen, selektieren Sie eine Zeile und wählen 'Zeile oberhalb einfügen' oder 'Zeile unterhalb einfügen'.
Spalten und Zeilen löschen	Um eine einzelne Spalte zu löschen, selektieren Sie diese und wählen 'Spalte löschen' aus dem Kontextmenü. Um eine einzelne Zeile zu löschen, selektieren Sie diese und wählen 'Zeile löschen' aus dem Kontextmenü.
Tabelle löschen	Selektieren Sie die Tabelle und wählen Sie 'Tabelle löschen' aus dem Kontextmenü.

Bild in den Text einfügen

Mit dem HTML-Editor arbeiten

Mit dem HTML-Editor wird der Inhalt im Bearbeitungsmodus als einfacher Text eingegeben und mit Standard HTML-Tags und CSS-Stilen formatiert, wie im folgenden Beispiel gezeigt. Mit der Schaltfläche 'Bearbeitungsmodus einschalten' schalten Sie den Editor zwischen Bearbeitungsmodus (Schaltfläche gedrückt) und WYSIWYG-Modus um (im WYSIWYG-Modus sehen Sie, wie der Inhalt angezeigt wird).

Weitere Infos
Informationen zum Erstellen von Beschreibungen für benutzerdefinierte Funktion-/ Funktionsbaustein-POEs finden Sie im Thema "Hilfedateien und Beschreibungsdateien für Bibliotheken.

CSS-Datei zuweisen / Hilfevorlagenordner importieren

Optional können Sie eine CSS-Datei mit den Stilen zur Formatierung der HTML-Elemente zuweisen. Der Name der verwendeten CSS-Datei wird unterhalb des Beschreibungsbereiches angezeigt.

Die standardmäßig verwendete CSS-Datei befindet sich im Hilfevorlagenordner. Dieser Ordner enthält neben dem CSS-Stylesheet alle Dateien, mit deren Hilfe Sie Online-Hilfeseiten für benutzerdefinierte POEs (Funktionen und Funktionsbausteine) erstellen können. Der Speicherort des Standard-Vorlagenordners ist im Dialog 'Extras > Optionen' in der Kategorie 'Werkzeug | Beschreibung' definiert.

Sie können auch Ihre eigenen Hilfevorlagendateien und CSS-Datei für Dokumentationszwecke verwenden. Importieren Sie dazu Ihren Hilfevorlagenordner über den Kontextmenübefehl 'Hilfevorlage importieren' des Projektknotens.

Sprache für Beschreibung wählen

Die Beschreibung der Funktions-/Funktionsbaustein-POE kann in den Sprachen erfolgen, die von PLCnext Engineer unterstützt werden (die Liste der verfügbaren Sprachen sehen Sie im 'Extras > Optionen'-Dialog unter der Kategorie 'Lokalisierung > Internationale Einstellungen'). Abhängig von der aktuellen Sprache der Benutzeroberfläche wird die sprachspezifische POE-Beschreibung angezeigt, wenn die entsprechende Hilfe für die FU/FB-POE in PLCnext Engineer aufgerufen wird.

Zur Auswahl der gewünschten Sprache wählen Sie diese in der Combobox aus (die Auswahlliste enthält alle in PLCnext Engineer unterstützten Sprachen).

Inhalte in/aus einer HTML-Datei importieren/exportieren

Um den Inhalt (Text, Bilder, usw.) in eine HTML-Datei zu exportieren, klicken Sie in der Symbolleiste auf , geben Sie einen Speicherort und einen Dateinamen an und klicken Sie auf 'Speichern'.
Wenn Sie den Inhalt im HTML-Editor exportieren und eine CSS-Datei zugewiesen haben, wird die CSS-Datei mit exportiert.
Um Inhalte aus einer HTML-Datei zu importieren, klicken Sie in der der Symbolleiste auf , wählen Sie im Öffnen-Dialog die Datei aus und klicken Sie auf 'Öffnen'. Das Text wird an der aktuellen Cursorposition eingefügt.