Skip to main content

Projektinformation abfragen und bearbeiten

Sie können Informationen, die Ihr Projekt und die dazugehörige Datei betreffen, mit Hilfe des Objekts Projektinformationen abfragen und bestimmte Informationen bearbeiten.

. Das Objekt enthält Informationen über

  • Dateiattribute

  • Metainformationen wie Anbieterfirma, Titel oder Autor

  • Eigenschaften mit Schlüssel

  • Statistik

  • Lizenzierung

  • Signieren: Diese Möglichkeit des Signierens von übersetzten Bibliotheken ist veraltet und sollte aus Sicherheitsgründen nur verwendet werden, wenn eine Kompatibilität mit älteren Versionen erforderlich ist. Wenn diese Methode verwendet wird, kann später mit Hilfe eines öffentlichen Public-Key-Token überprüft werden, ob die Bibliothek zuletzt vom Bibliotheksanbieter signiert wurde. Stellen Sie als Bibliotheksanbieter deshalb dem Kunden den verwendeten öffentlichen Schlüssel unbedingt zur Verfügung, beispielsweise in der Dokumentation.

CODESYS speichert die Projektinformationen als Objekt direkt im Projekt. Wenn Sie dann ein Projekt auf ein anderes System übertragen, wird auch das Objekt Projektinformation mit übertragen, ohne dass dafür ein Projektarchiv benötigt wird.

Sie können mit Hilfe von Eigenschaftenschlüsseln über Funktionsbausteine von extern auf die Projektinformationen zugreifen. Wenn es sich um ein Bibliotheksprojekt handelt, können Sie zusätzlich Informationen zur Lizenzierung abfragen.

Metainformation bearbeiten

  1. Wählen Sie Projekt → Projektinformation.

    Der Dialog Projektinformationen öffnet sich.

  2. Wählen Sie Registerkarte Zusammenfassung.

  3. Geben Sie in den Eingabefelder Ihre Daten ein, zum Beispiel 0.0.0.1 im Eingabefeld Version.

    CODESYS erstellt für jeden eingegebenen Wert eine Eigenschaft mit Schlüssel und verwaltet sie unter der Registerkarte Eigenschaft. Wenn es sich um ein Bibliotheksprojekt handelt, verwendet CODESYS die Eigenschaften weiter und sortiert im Bibliotheksrepository danach.

    Wenn Sie aktivieren, dass CODESYS für diese Eigenschaften jeweils einen Funktionsbaustein erstellt, können Sie auf die Eigenschaften programmatisch zugreifen.

Funktionen für Eigenschaftenzugriff erstellen

  1. Wählen Sie Projekt → Projektinformation.

    Der Dialog Projektinformationen öffnet sich.

  2. Aktivieren Sie die Option Automatisch ‚Projektinformationen‘-POUs erzeugen.

Beispiel 9. Beispiel

Voraussetzung: Die folgende Eigenschaft ist definiert.

Schlüssel = nProp1
Typ= Zahl
Wert= 333

  1. Aktivieren Sie die Option Automatisch ‚Projektinformationen‘-POUs erzeugen.

  2. Deklarieren Sie eine Variable des Typs DINT.

    Beispiel: showprop : DINT;

  3. Rufen Sie die Funktion GetNumberProperty auf: showprop := GetNumberProperty("nProp1");

    Sie erhalten Zugriff auf den Wert in der Applikation.



Tipp

Hinweis: Die mit der Option Automatisch ‚Projektinformationen‘-POUs erzeugen erzeugten Funktionen können nur verwendet werden, wenn das Laufzeitsystem den Datentyp WSTRING unterstützt! Wenn dies nicht der Fall ist, können Sie alternativ die Option Automatisch ‚Bibliotheksinformationen‘-POUs erzeugen verwenden: Die damit erzeugten Funktionen können Sie zumindest in der Applikation für den Eigenschaftenzugriff verwenden. Im Laufzeitsystem sind diese Funktionen nicht registriert!

Bibliotheksprojekt lizenzieren

Wenn Ihr Projekt ein Bibliotheksprojekt ist, können Sie hier die Lizenzierung der Bibliothek bei Verwendung aktivieren. Als Dongle kommt ein „CODESYS Security Key“ zum Einsatz.

Voraussetzung: Das Projekt ist ein Bibliotheksprojekt.

  1. Wählen Sie Projekt → Projektinformationen.

    Der Dialog Projektinformationen öffnet sich.

  2. Wählen Sie Registerkarte Lizenzierung.

  3. Aktivieren Sie die Option Dongle-Lizenzierung aktivieren.

  4. Geben Sie die Daten des Dongles in Firmcode, Produktcode, Aktivierungs-URL und Aktivierungs-Mail an.

    Die Bibliothek ist lizenziert.

Veraltet: Bibliotheksprojekt signieren - Nur noch für Versionskompatibilität mit CODESYS < 3.5 SP15 - Ab Version CODESYS V3 SP17 nur für bestehende Bibliotheken mit der veralteten Signierung, die im Dialog Projektinformationen - Signieren erstellt wurde

Tipp

Ab CODESYS V3 SP15 erfolgt eine Bibliothekssignierung immer zertifikatsbasiert. Sehen Sie zur Durchführung einer solchen Signierung die Hilfeseite zum Befehl Projekt als übersetzte Bibliothek speichern. Im Unterschied zur veralteten Signierung über die Einstellungen im Dialog Projektinformationen - Signieren wird mit dem Zertifikat die gesamte Bibliothek signiert.

Falls Sie aus Kompatibilitätsgründen ein Bibliotheksprojekt noch für eine CODESYS-Version < V3 SP15 signieren müssen, gehen Sie wie folgt vor:

Voraussetzung: Ihnen steht eine private Schlüsseldatei mit einem zugehörigen Token zur Verfügung. In den Projektinformationen des Bibliotheksprojekts ist auf der Registerkarte Zusammenfassung eine Bibliothekskompatibilität mit einer CODESYS-Version < V3 SP15 eingestellt.

  1. Wählen Sie Projekt → Projektinformationen.

    Der Dialog Projektinformationen öffnet sich.

  2. Wählen Sie Registerkarte Signieren.

  3. Aktivieren Sie die Option Signieren aktivieren.

  4. Geben Sie den Speicherort Ihrer privaten Schlüsseldatei an.

    CODESYS trägt den Token automatisch in Token des öffentlichen Schlüssels ein.

    Beispiel: 427A5701DA3CF3CF

  5. Wählen Sie Datei → Projekt als übersetzte Bibliothek speichern.

    Das Bibliotheksprojekt wird als Datei mit der Erweiterung *.compiled-library abgelegt. Sie sehen das Token im Bibliotheksrepository oder Bibliotheksverwalter in den Details zur Bibliothek und können es mit dem veröffentlichten Token des Bibliothekanbeiters vergleichen. Sie überprüfen somit, ob die Bibliothek tatsächlich vom gewünschten Anbieter stammt.

Private Schlüsseldatei erstellen

  1. Wählen Sie Projekt → Projektinformationen.

  2. Wählen Sie die Registerkarte Signieren.

  3. Wählen Sie die Schaltfläche Private Schlüsseldatei erzeugen.

    Der Dialog Private Schlüsseldatei erstellen erscheint.

  4. Wählen Sie einen sicheren Ablageort, zum Beispiel D:\for lib developers only\mycomp_libkey.libpk und beenden Sie den Dialog mit Speichern.

In diesem Abschnitt: