Objekt 'Bibliotheksverwalter'Permanentlink

Symbol: _cds_icon_library_manager

Der Bibliotheksmanager listet alle Bibliotheken auf, die in das Projekt zur Erstellung von Anwendungen integriert wurden. Sie enthält Informationen über den Typ der Bibliothek, ihre Eigenschaften und ihren Inhalt.

Sie können die Liste der integrierten Bibliotheken erweitern oder reduzieren sowie Bibliothekseigenschaften für nicht abhängige Bibliotheken bearbeiten.

Der Bibliotheksverwalter besteht aus drei Ansichten:

  • Ansicht von oben: Liste der integrierten Bibliotheken

  • Ansicht unten links: Baumstruktur mit allen ausgewählten Modulen der Bibliothek in der oberen Ansicht

  • Ansicht unten rechts: Dokumentation für das in der Baumstruktur ausgewählte Modul

Liste der integrierten Bibliotheken

Liste aller in das Projekt integrierten Bibliotheken. Wenn eine Bibliothek von anderen Bibliotheken abhängt, werden diese referenzierten Bibliotheken automatisch integriert.

Anzeige in grauer Schrift

Die Bibliothek wurde dem Projekt automatisch mit Hilfe eines Plug-ins hinzugefügt.

Anzeige in schwarzer Schrift

Die Bibliothek wurde dem Projekt automatisch mit dem Befehl „Add Library“ hinzugefügt.

„Name“

Anzeige der integrierten Bibliothek in der folgenden Syntax:

„<Platzhaltername> = <Bibliotheksname>, <Version> (<Firma>)“:

„<Platzhaltername>“: Handelt es sich um eine Platzhalterbibliothek für eine Bibliothek, so steht der Platzhaltername vor einem „ = “.

„<Bibliotheksname>“: Name der Bibliothek, die für die Verwaltung im Bibliotheks-Repository verwendet wird.

„<Version>“: Version, auf die bei der ersten Integration verwiesen wurde.

„(<Firma>)“: Anbieter (optional)

„Namespace“

Namensraum für den eindeutigen Zugriff auf den Inhalt der Bibliothek.

Zu diesem Zweck wird sie einem Modulbezeichner vorangestellt:

<Namensraum>.<Bibliotheksmodul-Bezeichner>

Der Namensraum stimmt normalerweise mit dem Bibliotheksnamen überein.

Hinweis: Wenn die Bibliothek die Eigenschaft ‎LanguageModelAttribute "qualified-access-only"‎ hat, dann müssen Sie im Anwendungscode über den Namensraum auf das Bibliotheksmodul zugreifen. Qualifizierter (eindeutiger) Zugang wird erzwungen.

Sie können den Standard-Namensraum für die lokale Verwendung (innerhalb des Projekts) im Dialog „Eigenschaften“ ändern.

„Wirksame Version“

Version der Bibliothek nach der Auflösung. Diese Version wird in dem Projekt verwendet.

Anforderung: Der Bibliotheksmanager ist in der Ansicht „Devices“ vorhanden und eine Platzhalterbibliothek ist ausgewählt.

Beispiel: ‎3.5.10.0‎

Eine Platzhalterbibliothek, die unterhalb einer Anwendung integriert ist, wird aufgelöst, indem der Platzhalterbibliothek im Dialog „Platzhalter“ eine spezielle Auflösung zugewiesen wird. Dann wird die ausgewählte Bibliothek geladen. Andere Auflösungen werden ignoriert. Wird keine spezielle Auflösung angegeben, so wird geprüft, ob in der Gerätebeschreibung und im Bibliotheksprofil der Anwendung eine Auflösung angegeben ist oder nicht. Der erste Suchtreffer wird übernommen.

_cds_icon_info

Symbol mit Tooltip, das über die aktuelle geräteabhängige Auflösung der ausgewählten Bibliothek informiert.

Beispiel, wenn sich der Bibliotheksverwalter in der Ansicht „Geräte“ befindet: „Dieser Platzhalter wird explizit auf diese Version umgeleitet (siehe den Dialog Platzhalter)“

Beispiel, wenn sich der Bibliotheksverwalter in der Ansicht „POUs“ befindet: „Im Gerät "Device_1" wird der Platzhalter in "VisuElemsAlarms, 1.0.0.0 (System)" aufgelöst.“

Eine in der Ansicht „POEs“ integrierte Platzhalterbibliothek wird aufgelöst, indem je nach Anwendung geprüft wird, ob in der Gerätebeschreibung eine Auflösung angegeben ist oder nicht. Anschließend wird das Bibliotheksprofil überprüft. Es wird die erste erkannte Auflösung verwendet. Wenn Sie der Platzhalterbibliothek im Dialog „Platzhalter“ eine spezielle Auflösung zugewiesen haben, dann wird diese immer ignoriert. Das Ergebnis wird im Tooltip des Symbols _cds_icon_info angezeigt.

_cds_icon_libman_signed_lib

Bibliothek, die mit einem vertrauenswürdigen Zertifikat signiert ist (kompatibel mit CODESYS >= V3 SP15)

_cds_icon_libman_signed_lib_with_deps

Bibliothek, die mit einem vertrauenswürdigen Zertifikat signiert ist, aber auf mindestens eine nicht signierte Bibliothek verweist

_cds_icon_libman_signed_legacy_lib

Bibliothek, die mit einem privaten Schlüssel und einem Token signiert ist (kompatibel mit CODESYS < V3 SP15)

_cds_icon_libman_legacy_lib

Bibliothek, die nicht signiert oder mit einem nicht vertrauenswürdigen oder abgelaufenen Zertifikat signiert ist. Im Falle eines nicht vertrauenswürdigen Zertifikats wird im Kontextmenü der Befehl „Trust Certificate“ angeboten.

_cds_icon_libman_unavailable_opt_lib

Bibliothek, die als optional definiert und derzeit nicht verfügbar ist

_cds_icon_libman_try_to_reload

Bibliothek, deren Status gerade ermittelt wird

_cds_icon_libman_unlicensed_lib

Lizenzierte Bibliothek, für die derzeit keine gültige Lizenz verfügbar ist

_cds_icon_tampered_library

Bibliothekssymbol für eine Bibliothek, die nicht geladen werden kann, weil ihre Signatur (Verschlüsselung) nicht überprüft werden konnte

Tab. 589: Befehle im Bibliotheksverwalter

_cds_icon_libman_add_library „Bibliothek hinzufügen“

Öffnet den Dialog zur Auswahl einer Bibliothek. Es werden alle im Bibliotheksrepository installierten Bibliotheken angeboten.

_icon_delete_library „Bibliothek löschen“

Entfernt die aktuell ausgewählte Bibliothek aus dem Projekt

_cds_icon_properties_library „Eigenschaften“

Öffnet den Dialog zur Anzeige und Bearbeitung der Eigenschaften der aktuell ausgewählten Bibliothek

_cds_icon_details „Einzelheiten“

Öffnet einen Dialog mit Details zu der aktuell ausgewählten Bibliothek (allgemeine Informationen, Inhalt, Eigenschaften, Lizenzinformationen)

_cds_icon_libman_try_to_reload „Versuchen Sie, die Bibliothek neu zu laden“

Wenn Sie eine als nicht gefunden markierte Bibliothek auswählen, können Sie mit diesem Befehl versuchen, sie erneut in das Projekt zu laden.

_cds_icon_libman_download „Fehlende Bibliotheken herunterladen“

CODESYS sucht nach den fehlenden Bibliotheken auf den in den Projektoptionen angegebenen Download-Servern.

Danach können Sie die Bibliothek herunterladen und installieren.

_cds_icon_placeholders „Platzhalter“

Das Dialogfeld „Platzhalter“ wird geöffnet. Dort wird die aktuelle Auflösung angezeigt und Sie können sie bearbeiten.

_icon_library_repository „Bibliothek Repository“

Öffnet das Dialogfeld „Library Repository“ zum Installieren und Deinstallieren von Bibliotheken und zum Definieren von Bibliotheksspeicherorten

_cds_icon_libman_icon_legend „Legende des Symbols“

Öffnet den Dialog „Information“ mit einer Legende der Symbole, die den aktuellen Status einer Bibliothek in der Liste der integrierten Bibliotheken anzeigen (siehe oben)

_cds_icon_summary „Zusammenfassung“

Öffnet das Dialogfeld „Library Summary“. Im Dialog werden alle Bibliotheken, auf die im Projekt verwiesen wird, in einer Baumstruktur angezeigt, sowie die Bibliotheken, die auf diese Bibliotheken verweisen.

  • Befehl „Alle Vorkommen in der Bibliothekshierarchie anzeigen und Dialog schließen“: Im Editor des Bibliotheksmanagers werden die Bibliotheken in der geöffneten Baumstruktur markiert, die diese Bibliothek referenzieren oder verwenden. Erfordernis: Eine Bibliothek wird ausgewählt. Das Dialogfeld „Informationen“ wird dann geschlossen.

    Dieser Befehl wird auch ausgeführt, wenn Sie auf eine Bibliothek doppelklicken.

Anzeige der Bibliotheken

  • „Verwaltete Bibliothek“: Name und Version der Bibliothek

  • „Anzahl der Vorkommnisse“: Anzahl der Stellen, an denen diese Bibliothek von anderen Bibliotheken referenziert wird.

Wenn Sie auf „+“ für eine Bibliothek klicken, werden die Bibliotheken, die auf diese Bibliothek verweisen, auf der nächsttieferen Ebene angezeigt.

_cds_icon_libman_trust_cert „Vertrauenswürdiges Zertifikat“

Nur im Kontextmenü einer im Bibliotheksmanager ausgewählten Bibliothek, in der die Bibliothek mit einem nicht vertrauenswürdigen Zertifikat signiert wurde. Der Befehl verwandelt das nicht vertrauenswürdige Zertifikat in ein vertrauenswürdiges Zertifikat und das vorangestellte Symbol ändert sich von _cds_icon_libman_legacy_lib zu _cds_icon_libman_signed_lib.

„Bibliothek exportieren“

Nur im Kontextmenü einer im Bibliotheksmanager ausgewählten Bibliothek: Öffnet den Standarddialog zum Speichern der Bibliotheksdatei im Dateisystem

Baumstruktur aller Module einer ausgewählten Bibliothek

Alle Bibliotheksmodule, die in die Bibliothek integriert wurden, sind in der Baumstruktur aufgelistet.

Anforderung: In der oberen Ansicht ist eine Bibliothek ausgewählt.

Die üblichen Sortier- und Suchfunktionen sind in der Menüleiste verfügbar.

Dokumentation für das in der unteren linken Ansicht ausgewählte Bibliotheksmodul

Registerkarte „Eingänge/Ausgänge“

Schnittstelle (Eingänge/Ausgänge) des Bibliotheksmoduls

Registerkarte „Grafisch“

Grafische Darstellung des Moduls

Registerkarte „Dokumentation“

Dokumentation für das Bibliotheksmodul.

Hinweis: Als Bibliotheksentwickler müssen Sie die Regeln für die Aufnahme der Dokumentation in die "Richtlinien für die Entwicklung von Bibliotheken" befolgen.

Registerkarte „Parameterliste“

Anforderung: Das Bibliotheksprojekt enthält eine Parameterliste.

Sie können die Werte dieser Parameter in der Spalte „Wert (editierbar)“ ändern.