Bibliothek oder Passwort-geschützte Bibliothek erzeugen und prüfen

So erstellen Sie eine Bibliothek:

  1. Wählen Sie die Bibliothekskonfiguration aus, auf deren Basis Sie die Bibliothek erstellen wollen.

  2. Empfohlen für eine logi.CAD 3-Bibliothek: Validieren Sie die Bibliothek auf Basis der Bibliothekskonfiguration.
    images/s/b2ic8e/9012/1ca6q62/_/images/icons/emoticons/information.svg logi.cals empfiehlt Ihnen, die bibliotheksbezogene Validierung für eine logi.CAD 3-Bibliothek selbst zu starten, da die bibliotheksbezogene Validierung einer logi.CAD 3-Bibliothek aus Performance-Gründen nicht in allen Varianten von logi.CAD 3 automatisch gestartet wird. Im Gegensatz dazu wird bei der Erzeugung einer logi.SAFE- oder logi.WEB-Bibliothek die bibliotheksbezogene Validierung automatisch gestartet.

  3. Für die Erzeugung und Prüfung der Bibliothek (= für die automatische Validierung) wählen Sie eine dieser Möglichkeiten:

    1. den Befehl Bibliothek erzeugen im Kontextmenü der Bibliothekskonfiguration

    2. den Befehl Erzeugen im Kontextmenü der zu erzeugenden Bibliothek (die Bibliothek ist als Unterebene der aufgeklappten Bibliothekskonfiguration im Projektexplorer sichtbar)

    3. den Befehl Erzeugen (Passwort-geschützt)... im Kontextmenü der zu erzeugenden Bibliothek
      images/s/b2ic8e/9012/1ca6q62/_/images/icons/emoticons/information.svg Mit dieser Möglichkeit können Sie die Sourcen der Bibliothekselemente zusätzlich in einer passwort-geschützten Bibliothek bereitstellen. Siehe "Sourcen in einer passwort-geschützten Bibliothek bereitstellen" über die Unterschiede der Erzeugungsmöglichkeiten.

  4. Stellen Sie sicher, dass die Bibliothek korrekt erstellt wurde:

    1. Stellen Sie anhand der Meldungen in der Sicht Fehlerprokokoll sicher, dass die Bibliothek erstellt wurde.

    2. Sofern die Validierung durch Sie selbst oder automatisch gestartet wurde: Stellen Sie anhand der Meldungen in der Sicht Validieren: Objektname sicher, dass keine Regelverletzungen entdeckt wurden. Falls doch, beheben Sie diese Regelverletzungen und validieren/erzeugen Sie die Bibliothek erneut.

    3. Sofern in Ihrer Variante von logi.CAD 3 der Bibliothekerzeugungs-Bericht erzeugt wird, können Sie anhand dieses Berichts sicherstellen, dass die Bibliothek mit den korrekten Bibliothekselementen erstellt wurde.

Beachten Sie: Ältere Dateien der Bibliothek (mit dem gleichen Namen und der gleichen Version) werden automatisch gelöscht. Dieses Löschen erfolgt auch, falls die neue Datei nicht erzeugt werden konnte. logi.cals empfiehlt daher, die Versionsnummer in der Bibliothekskonfiguration vor jedem Erzeugen einer Bibliothek zu ändern.

Gut zu wissen

images/s/b2ic8e/9012/1ca6q62/_/images/icons/emoticons/lightbulb.svg logi.CAD 3 stellt ein Werkzeug für das automatisierte Erzeugen, Bereitstellen und Verifizieren der Bibliothek zur Verfügung.

Ablage der Bibliothek und anderer Dateien

logi.CAD 3 erzeugt:

  • die Bibliothek im Unterordner target des Projekts

  • den Bericht für die Validierungsprüfung im gleichen Ordner wie die Bibliothekskonfiguration
    Details zum Bericht: Siehe unter "Ergebnisse der Prüfung in Sicht "Validieren"".

  • den Bibliothekerzeugungs-Bericht (im HTML- als auch im XML-Format) im Unterordner target des Projekts – mit dem Namen Bibliothek__Version.buildreport.html und Bibliothek__Version.buildreport.xml
    Dieser Bericht enthält Informationen über die Bibliothek, wie z.B. welche Bibliothekselement mit welcher Testabdeckung enthalten sind. images/s/b2ic8e/9012/1ca6q62/_/images/icons/emoticons/information.svg Die Erzeugung dieses Berichts ist nicht in allen Varianten von logi.CAD 3 verfügbar.

Gut zu wissen

images/s/b2ic8e/9012/1ca6q62/_/images/icons/emoticons/lightbulb.svg Der Ordner target wird standardmäßig nicht im Projektexplorer angezeigt. So können Sie den Ordner target im Projektexplorer anzeigen lassen: Klicken Sie auf images/download/attachments/451280970/IconViewMenu-version-1-modificationdate-1598000630466-api-v2.png in der Symbolleiste des Projektexplorers und wählen Sie Filter und Anpassungen... Im Dialog entfernen Sie die Markierung bei target Ordner (unter Filter) und drücken Sie OK.

images/s/b2ic8e/9012/1ca6q62/_/images/icons/emoticons/lightbulb.svg Mit Hilfe von Dateien, die für die Bibliothek zusätzlich erzeugt wurden, und einem Kommandozeilen-Werkzeug kann ein Administrator nachweisen, dass die Bibliothek seit ihrer Erzeugung verändert wurde oder nicht. Kontaktieren Sie logi.cals, falls Sie mehr Informationen zu dieser Möglichkeit haben wollen.

Inhalt der Bibliothek

Der Inhalt wird laut den Spezifikationen der Bibliothekskonfiguration erzeugt, wobei die Bibliothekskonfiguration selbst ebenfalls in die Bibliothek kopiert wird.

Dabei erzeugt logi.CAD 3 möglicherweise Dateien mit Dateierweiterung .iecst (statt der Dateien mit der ursprünglichen Dateierweiterung, wie z.B. .iecfbd), sofern der Wert INTERFACE oder OBJECT beim Schlüsselwort DEPLOY für die jeweilige POE (z.B. die FBS-POE) spezifiziert wurde. Mehr Informationen darüber und über den weiteren Inhalt der Bibliothek (z.B. automatisch erstellte Ordner) finden Sie in einem der folgenden Artikeln:

Troubleshooting: Probleme beim Erzeugen einer logi.SAFE- und logi.WEB-Bibliothek analysieren

Falls Sie fehlerhafte →Vendor-Bausteine in einer logi.SAFE- oder logi.WEB-Bibliothek verwenden, schlägt das Erzeugen der Bibliothek fehl. Üblicherweise enthält die Datei compile_result.txt entsprechende Fehlermeldungen, die bei der Analyse des Fehlers weiterhelfen.
images/s/b2ic8e/9012/1ca6q62/_/images/icons/emoticons/information.svg Die Datei compile_result.txt wird standardmäßig nicht im Projektexplorer angezeigt. Lesen Sie unter "Anwendung kann nicht erstellt oder geladen werden" nach, wie Sie die Datei in logi.CAD 3 anzeigen lassen.

Falls die Datei compile_result.txt jedoch keine aussagekräftige Meldung enthält, aktivieren Sie am besten so den "Development Mode" für das Erzeugen der Bibliothek:

  1. Beenden Sie logi.CAD 3.

  2. Gehen Sie zum Ordner, in dem Sie logi.CAD 3 installiert haben.

  3. Suchen Sie die Datei logiCAD3.ini und öffnen Sie diese in einem Texteditor.

  4. Tragen Sie -Dlc3.logisafe.devmod am Ende der Datei ein und vergeben Sie den Wert true.

    Beispiel
    ...
    -Dlc3.logisafe.devmod=true
  5. Speichern Sie die Datei.

  6. Starten Sie logi.CAD 3.

  7. Erzeugen Sie die logi.SAFE- oder logi.WEB-Bibliothek erneut.
    images/s/b2ic8e/9012/1ca6q62/_/images/icons/emoticons/warning.svg Diese Bibliothek ist nicht für den Einsatz geeignet, da die nachfolgenden, erforderlichen PiL-Tests für diese Bibliothek fehlschlagen werden.

  8. Prüfen Sie nun den Inhalt der Datei compile_result.txt auf aussagekräftigere Fehlermeldungen und korrigieren Sie den Vendor-Baustein entsprechend.

  9. Nach der Korrektur des Fehlers beenden Sie logi.CAD 3 erneut, deaktivieren Sie den "Development Mode" (indem Sie -Dlc3.logisafe.devmod aus der Datei löschen) und erzeugen Sie dann logi.SAFE- oder logi.WEB-Bibliothek erneut.