dl-breadcrumbs__homedl-breadcrumb-item__separatorKonfiguration und Programmierungdl-breadcrumb-item__separatorProgrammieren mit CODESYSdl-breadcrumb-item__separator...dl-breadcrumb-item__separatorCODESYS Development Systemdl-breadcrumb-item__separatorProjekt anlegen und konfigurierendl-breadcrumb-item__separatorProjekt konfigurierendl-breadcrumb-item__separatorProjektinformation abfragen und bearbeiten
dl-pagination__prev-inactivedl-pagination__prev-activedl-pagination__next-inactivedl-pagination__next-active
Projektinformation abfragen und bearbeitendl-permalink__symbolPermanentlink

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

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‎, zum Beispiel ‎showprop : DINT;‎

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

    Sie erhalten Zugriff auf den Wert in der Applikation.

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 < SP15 - Ab Version CODESYS V3 SP17 nur für bestehende Bibliotheken mit der veralteten Signierung, die im Dialog „Projektinformationen“ - „Signieren“ erstellt wurde

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 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 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, zum 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 sichern Ablageort, zum Beispiel ‎D:\for lib developers only\mycomp_libkey.libpk‎ und beenden Sie den Dialog mit „Speichern“.