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.

Kategorien

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.

Standardnamensraum

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

Autor

Autor des Projekts, zum Beispiel Arnold Best

Beschreibung

Zum Beispiel: Nur für internen Gebrauch

Tabelle 55. 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 56. 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 CODESYS V3 3.5 SP15) und nicht eine Bibliothekskompatibilität mit CODESYS < V3 3.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.