Skip to main content

Objekt: Projektinformationen

Symbol: _cds_icon_project_information.png

Funktion: Das Objekt enthält die Eigenschaften, Metainformationen und Informationen des Projekts und ermöglicht Ihnen die Urheberschaft und Integrität des Projekts zu überprüfen.

. Aufruf
  • Doppelklick auf das Objekt im Gerätebaum

  • Menü Projekt → Projektinformationen

Voraussetzung: CODESYS erstellt das Objekt, sobald Sie den Befehl Projekt → Projektinformationen ausgewählt haben und sich der Dialog öffnete.

CODESYS speichert die Projektinformationen direkt im Projekt. Wenn Sie zum Beispiel ein Projekt auf ein anderes System übertragen, wird auch das Objekt Projektinformationen übertragen. Sie benötigen kein Projektarchiv.

Für weitere Informationen siehe: Projektinformation abfragen und bearbeiten

Registerkarte: Datei

Die Registerkarte zeigt die Eigenschaften der Projektdatei und deren Attribute an. Sie können diese Attribute nicht editieren. Sie entsprechen den Dateieigenschaften des Windows-Explorers.

Registerkarte: Zusammenfassung

Die Registerkarte enthält die allgemeinen Informationen und Metainformationen der Projektdatei. CODESYS erstellt aus diesen Informationen Schlüssel in der Registerkarte Eigenschaften. Wenn zum Beispiel in Firma der Name Company_A eingetragen ist, ist in der Registerkarte Eigenschaften der Schlüssel Company mit dem Wert Company_A vorhanden.

Wichtig

Wenn Sie Ihr Projekt als Bibliotheksprojekt speichern, sollten Sie die Richtlinien für Bibliotheksentwickler beachten.

Bei einem Bibliotheksprojekt muss eine Firma, ein Titel und eine Version eingetragen sein, um die Bibliothek installieren zu können.

Firma

Name der Firma, zum Beispiel Company_A

Titel

Titel des Projekts, zum Beispiel Automation_A

Version

Version des Projekts, zum Beispiel 0.0.0.1

Freigegeben

standard icon: Schutz gegen Änderung aktiviert

Folge: Wenn Sie nun das Projekt editieren, erscheint eine Eingabeaufforderung, ob das Projekt wirklich geändert werden soll. Wenn Sie diese Abfrage einmalig mit Ja beantworten, erscheinen bei weiteren Editieraktionen keine Abfrage mehr.

Bibliothekskategorien

Kategorien des Bibliotheksprojekts, nach denen Sie im Dialog Bibliotheksrepository sortieren können

Wenn keine Kategorie angegeben ist, wird der Bibliothek die Kategorie Sonstige zugewiesen.

Die Kategorien stammen aus einer oder mehreren externen Beschreibungsdateien im XML-Format. Sie können aber auch aus einem bereits erstellten Bibliotheksprojekt stammen.

Voraussetzung: Das Projekt ist ein Bibliotheksprojekt.

_cds_icon_three_dots.png: Der Dialog Bibliothekskategorien öffnet sich, in dem Sie Bibliothekskategorien hinzufügen können.

Für weitere Informationen zum Anlegen von Bibliothekskategorien siehe: Library Categories

Standard-Namensraum

Voraussetzung: Das Projekt ist ein Bibliotheksprojekt.

Wenn Sie hier keinen Standardnamensraum definieren, gilt automatisch der Name der Bibliotheksdatei als Namensraum.

Platzhalter

Voraussetzung: Das Projekt ist ein Bibliotheksprojekt.

Platzhaltername, der für den Verweis auf diese Bibliothek verwendet wird

Beispiel: SysMem

Referenzen, die über Platzhalter funktionieren, werden gemäß Syntax #<Platzhaltername> dargestellt

Wichtig: Der Name eines Platzhalters kann nicht mehr geändert werden. Deshalb ist es sehr empfehlenswert, einen Namen zu wählen, bei dem die Wahrscheinlichkeit niedrig ist, dass ein anderer ihn genau so wählt.

Tipp: Sie können referenzierte Bibliotheken über Bibliotheksplatzhalter einbinden. Damit vermeiden Sie Probleme, die aufgrund von Versionsabhängigkeiten oder der Notwendigkeit, herstellerspezifische Bibliotheken zu verwenden, entstehen können.

Autor

Autor des Projekts, zum Beispiel Arnold Best

Beschreibung

Zum Beispiel: Nur für internen Gebrauch

Tabelle 63. Dialog Bibliothekskategorien

Liste von Kategorien

Liste der Kategorien, die dem Bibliotheksprojekt zugewiesen sind

Sie können aus mehrere Quellen stammen.

Wenn Sie alle gewünschten Kategorien eingetragen haben, bestätigen Sie den Dialog mit OK.

Schaltfläche Hinzufügen

Die Befehle Von Beschreibungsdatei und Von anderer Bibliothek erscheinen.

Schaltfläche Entfernen

CODESYS entfernt die selektierte Kategorie.

Befehl Von Beschreibungsdatei

Dialog Beschreibungsdatei auswählen erscheint, in dem Sie eine Beschreibungsdatei mit Erweiterung *.libcat.xml auswählen. Die Datei enthält Befehlskategorien. Wenn Sie den Dialog mit Öffnen beenden, übernimmt CODESYS diese Kategorien.

Befehl Von anderer Bibliothek

Dialog Bibliothek auswählen erscheint, in dem Sie eine Bibliothek auswählen, deren Befehlskategorien übernommen werden sollen. Wenn Sie den Dialog mit Öffnen beenden, übernimmt CODESYS die Kategorien.

Schaltfläche OK

CODESYS stellt die Kategorien als Projektinformation zur Verfügung und zeigt sie im Feld Bibliothekskategorien an.



Registerkarte: Eigenschaften

In dieser Registerkarte können Sie Schlüssel definieren, die Sie mit anwenderspezifischen externen Programmen von außen steuern können.

Wichtig

Wenn Sie ein Bibliotheksprojekt geöffnet haben, beachten Sie bitte die Beschreibung der relevanten Schlüssel in den Richtlinien für Bibliotheksentwickler: „Library Development Summary“.

Wenn Sie als Projekt eine Symbolbibliothek geöffnet haben, muss der Schlüssel VisuSymbolLibrary = TRUE definiert sein. Er kennzeichnet die Bibliothek als Symbolbibliothek.

Schlüssel

Name des Schlüssels

Beliebige Zeichenfolge für neuen Schlüssel eintragen, oder einen bereits in der Tabelle Eigenschaften eingetragenen Schlüssel selektieren.

Typ

Datentyp des Schlüssels

Mögliche Typen: Text, Datum, Zahl, Bool, Version

Wert

Wert des Schlüssels im zulässigen Format:

  • Text: Beliebige Zeichenfolge

  • Datum: Mindesteintrag für dieses Datum: 1.1

    Beispiel: Freitag, 1. Januar 2016 00:00:00

  • Zahl: Ganze Zahl im Integer32-Format, mit oder ohne Vorzeichen

    Beispiel: -32500

  • Bool: True oder False, Gross-/Kleinschreibung nicht relevant

  • Version: maximal vierstellig

    Beispiele: 1.1, 1.0.1.0

Hinzufügen

Fügt den neu definierten Schlüssel in der Tabelle Eigenschaften hinzu

Bearbeiten

Speichert die für den in der Tabelle Eigenschaften selektierten Schlüssel vorgenommene Änderung

Entfernen

Entfernt den in der Tabelle Eigenschaften selektierten Schlüssel

Eigenschaften

Liste der Eigenschaften, die als Schlüssel definiert sind

CODESYS erstellt automatisch Schlüssel zu den Informationen der Registerkarte Zusammenfassung.

Klicken Sie auf einen Schlüssel, um ihn in den Eingabefelder, die oberhalb der Liste sind, zu bearbeiten.

Registerkarte: Statistik

Der Dialog gibt eine statistische Auskunft, wie viele Objekte der einzelnen Typen im Projekt verwendet sind.

Registerkarte: Lizenzierung

Der Dialog dient dem Lizenzschutz von Bibliotheken.

Achtung

Sie können nur übersetzte Bibliotheken („Compiled Libraries“) so schützen.

Tabelle 64. Variablen

Dongle-Lizenzierung aktivieren

standard icon: Die Bibliothek benötigt einen Dongle mit Lizenz um verwendet werden zu können.

Firmcode

Lizenzinformationen, die bei der späteren Verwendung der Bibliothek vom Dongle geliefert werden müssen

Produktcode

Aktivierungs-URL

Aktivierungs-Mail



Registerkarte: Signieren

Diese Registerkarte wird nur noch bei bestehenden Bibliotheken angezeigt, deren Signierung mit dieser Registerkarte erstellt wurde. Bei neu erzeugten Bibliotheken ist diese Registerkarte nicht mehr sichtbar.

Für weitere Informationen siehe: Projektinformation abfragen und bearbeiten

Wenn eine zertifikatssignierte Bibliothek erzeugt wird (möglich ab CODESYSV33.5 SP15) und nicht eine Bibliothekskompatibilität mit CODESYS < V33.5 SP15 eingestellt ist, sind die Einstellungen auf dieser Registerkarte deaktiviert. In diesem Fall erfolgt die Signierung über ein Zertifikat, das im Security-Screen dem Benutzerprofil zugeordnet sein muss.

Nicht empfohlen, jedoch für die Kompatibilität mit Versionen < 3.5 SP15 in manchen Fällen noch nötig: Die weniger sichere Signierung einer Bibliothek mit Hilfe dieses Dialogs, mit einem anbieterspezifischen, einmaligen Schlüssel. Voraussetzung: Dieser Schlüssel liegt für Sie in Form einer „Privaten Schlüsseldatei*.libpk mit einem zugehörigen Token bereit. Diesen Schlüssel muss auch der Verwender der Bibliothek erhalten, um prüfen zu können, ob die letzte Signierung tatsächlich durch den Bibliotheksanbieter erfolgt ist.

Signieren aktivieren

standard icon: CODESYS signiert das Bibliotheksprojekt mit einem anbieterspezifischen, einmaligen Schlüssel.

Private Schlüsseldatei

Speicherort der privaten Schlüsseldatei *.libpk, zum Beispiel: D:\for lib developers only\mycomp_libkey.libpk

Token des öffentlichen Schlüssels

Zum Beispiel: 427A5701DA3CF3CF

Voraussetzung: Eine privaten Schlüsseldatei ist angegeben und CODESYS hat den Token ausgelesen und eingetragen.

Private Schlüsseldatei erzeugen…

CODESYS erzeugt eine neue private Schlüsseldatei.

Optionen zur Bausteinerzeugung für den Zugriff auf Projektinformationen

Automatisch 'Projektinformationen'-POUs erzeugen

Hinweis: Die mit dieser Option erzeugten Funktionen können nur verwendet werden, wenn das Laufzeitsystem den Datentyp WSTRING unterstützt! Wenn dies nicht der Fall ist, können Sie die automatisch für die einzelnen Projektinformationen erzeugten Funktionen zumindest in der Applikation für den Eigenschaftenzugriff verwenden. Im Laufzeitsystem sind diese Funktionen nicht registriert!

standard icon: CODESYS erstellt POU-Objekte des Typs FUNCTION in der Ansicht POUs und ermöglicht damit einen programmatischen Zugriff in der Applikation auf die Projekteigenschaften. Für die Eigenschaften Firma, Titel und Version werden die Funktionsbausteine GetCompany, GetTitle und GetVersion erstellt.

Für benutzerdefinierte Eigenschaften stehen folgende Funktionsbausteine zur Verfügung:

  • GetBooleanProperty: BOOL (TRUE/FALSE)

  • GetNumberProperty: DINT (Zahlenwert)

  • GetTextProperty: WSTRING (Zeichenfolge)

  • GetTextProperty2: POINTER TO WSTRING (ohne Längenbegrenzung)

  • GetVersionProperty: VERSION (Versionsnummer als Zeichenfolge)

Hinweis: Aktivieren Sie diese Option nicht für Standardbibliotheken, da dies auf kleinen Systemen aufgrund des zusätzlichen Speicherbedarfs Probleme verursachen kann.

Hinweis: Wenn eine Bibliothek auch diese Projektinformations-POUs enthält, sollten Sie den Operator __POOL verwenden, um sicherzustellen, dass diese POUs zugegriffen wird.

Automatisch 'Bibliotheksinformationen‘-POUs erzeugen

standard icon: CODESYS erstellt Programmierobjekte des Typs FUNCTION in der Ansicht POUs und ermöglicht damit einen programmatischen Zugriff in der Applikation auf die Bibliothekseigenschaften.

Für die Eigenschaften Version und Freigegeben werden die Funktionen GetLibVersion (Versionsnummer als Zeichenfolge), GetLibVersionNumber (Versionsnummer als Zahlenwert) und IsLibReleased (TRUE/FALSE) erstellt.

Hinweis: Im Laufzeitsystem sind diese Funktionen nicht registriert! Die Option steht als Ausweichlösung zur Verfügung, falls das Laufzeitsystem den Datentyp WSTRING nicht unterstützt und Sie deshalb die mit der Option Automatisch ‚Projektinformationen‘-POUs erzeugen erzeugten Funktionen nicht verwenden können.

Projektkompatibilität erzwingen zu

standard icon: Wenn Sie eine Bibliothek mit dem Befehl Projekt Speichern unter speichern, wird das gewählte Format gespeichert. Beim erneuten Ausführen des Befehls Projekt speichern unter ist dann die gespeicherte Auswahl per Default ausgewählt.

Wenn Sie diese Option aktiviert haben und ein Objekt hinzufügen, das ein neueres Speicherformat erfordert, öffnet sich ein Dialog. In dem Dialog müssen Sie die Aktualisierung explizit bestätigen oder abbrechen.

  • Wenn Sie Ja klicken, werden alle Änderungen im Projekt ohne Datenverlust gespeichert. Allerdings kann das Projekt künftig nicht mehr mit dem ursprünglich eingestellten Speicherformat geöffnet werden. Als neues erzwungenes Speicherformat wird das neue Format festgelegt.

  • Wenn Sie Nein klicken, bleibt das Projekt kompatibel zu dem eingestellten Speicherformat, es werden jedoch eventuell nicht alle Änderungen gespeichert.

Tipp

Die Option Projektkompatibilität erzwingen zu ist für die Entwicklung kompatibler Bibliotheken nützlich. Gleichzeitig wird es damit möglich, die neueste Version des Programmiersystems zu verwenden.

. Auswirkungen bei aktivierter Option:
  • Die Abfrage zur Aktualisierung des Speicherformats wird unterdrückt.

  • Neuere Features, die im Projekt gespeichert werden müssen, können nicht verwendet werden. Für die reine Entwicklung von Bibliotheken, die nur textuelle Objekte (wie beispielsweise POUs, DUTs, Schnittstellen) enthalten, ist dies keine Einschränkung.

  • Die Compilerversion kann frei ausgewählt werden, Patch-Versionen können jedoch nicht ausgewählt werden.

  • Bei aktuell ausgewählter neuester Compilerversion kann eine ältere Compilerversion ausgewählt werden.