Kategorie Common

Die Kategorie Common enthält allgemeine Informationen und Metainformationen der Projektdatei. TwinCAT erstellt aus diesen Informationen Schlüssel in der Registerkarte Eigenschaften. Wenn zum Beispiel im Textfeld Firma der Name „Company_A“ eingetragen ist, ist in der Registerkarte Eigenschaften der Schlüssel Company mit dem Wert „Company_A“ vorhanden.

Kategorie Common 1:

Projektinformation

Bei einem Bibliotheksprojekt muss eine Firma, ein Titel und eine Version eingetragen sein, um die Bibliothek installieren zu können.

Firma

Name der Firma, in der dieses Projekt (Applikation oder Bibliothek) erstellt wurde. Er dient neben der Bibliothekskategorie zur Sortierung im Bibliotheks-Repository

Titel

Titel des Projekts

Version

Version des Projekts, zum Beispiel „0.0.0.1“

Freigegeben

Kategorie Common 2:: 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.

Bibliothekskategorien

Kategorien des Bibliotheksprojekts, nach denen Sie im Dialog Bibliotheks-Repository sortieren können. Wenn keine Kategorie angegeben ist, wird der Bibliothek die Kategorie „Sonstige“ zugewiesen. Soll sie einer anderen Kategorie angehören, muss eine solche definiert sein.

Die Definition von Bibliothekskategorien erfolgt in einer oder mehreren externen Beschreibungsdateien im XML-Format. Für die Zuordnung der Bibliothek kann entweder eine solche Datei aufgerufen werden oder aber eine andere Bibliotheksdatei, die bereits selbst die Informationen über die Kategorien aus einer Beschreibungsdatei aufgenommen hat.

Voraussetzung: Das Projekt ist ein Bibliotheksprojekt.

Kategorie Common 3:

Der Dialog Bibliothekskategorien öffnet sich, in dem Sie Bibliothekskategorien hinzufügen können.

Standard-Namensraum

Die Standardeinstellung für den Namensraum einer Bibliothek entspricht dem Bibliothekstitel. Für eine Bibliothek kann auch explizit ein davon abweichender Namensraum definiert werden: entweder allgemein für die Bibliothek bei der Bibliothekserstellung an dieser Stelle in den Projektinformationen oder für den lokalen Gebrauch der Bibliothek in einem Projekt im Eigenschaften-Dialog der Bibliotheksreferenz.

Der Namensraum der Bibliothek muss als Präfix des Bezeichners verwendet werden, damit ein eindeutiger Zugriff auf ein Modul möglich ist, das mehrfach im Projekt vorhanden ist, oder wenn der Gebrauch dieses Präfixes durch die Bibliothekseigenschaft LanguageModelAttribute „qualified-access-only“ („Eindeutiger Zugriff auf Bibliotheksmodule oder -variablen“) erzwungen wird.

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

Platzhalter

An dieser Stelle kann ein Standardname des Platzhalters festgelegt werden, der diese Bibliothek repräsentiert bzw. referenziert. Falls ein dieser Stelle nicht explizit ein Platzhalter festgelegt wird, entspricht die Standardeinstellung für den Platzhalternamen einer Bibliothek dem Bibliothekstitel.

Autor

Autor des Projekts

Beschreibung

Kurze Beschreibung des Projekts (z. B. Inhalt, Funktionalitäten, allgemeine Hinweise wie nur für den internen Gebrauch etc.)

Bibliothekseigenschaften

Globale Versionsstruktur erzeugen

Erzeugt im SPS-Projekt eine globale Variablenliste, welche die Versionsinformationen enthält.

Automatisch Bibliotheksinformationen-POU erzeugen

Schaltfläche Hinzufügen: POU-Objekte vom Typ „Funktion“ werden automatisch im Projektbaum angelegt, die verwendet werden können, um im Applikationsprogramm auf die Projekteigenschaften zuzugreifen. In diesem Fall werden spezielle Funktionen für die Eigenschaften Firma, Title und Version erzeugt (F_GetCompany, F_GetTitle, F_GetVersion). Falls diese Funktionen über Hinzufügen zum Projekt hinzugefügt wurden, können sie über Entfernen aus dem Projekt entfernt werden.

Dokumentationsformat

Optionen:

  • Bis TC3.1 Build 4024: reStructuredText:
  • Ab TC3.1 Build 4026: TcDocGen

Bei der Bibliothekserstellung werden Kommentare, die einem bestimmten Format entsprechen, neustrukturiert und in dieser angepassten Darstellung in der Registerkarte Dokumentation im Bibliotheksverwalter angezeigt. Dadurch ergeben sich zusätzliche Möglichkeiten der Bibliotheksdokumentation.

Implizite Prüfungen für Compiled Libraries erlauben

Verfügbar ab TC3.1 Build 4026

Kategorie Common 4:: TwinCAT führt implizite Prüfungen auch für Bausteine aus geschützten Bibliotheken (*.compiled-libraries) aus.
Voraussetzung: Die Compiler-Definition „checks_in_libs“ ist in den SPS-Projekteigenschaften im Feld Compilerdefinitionen eingetragen (Kategorie Übersetzen).

Siehe auch: Bausteine für implizite Prüfung verwenden

Qualified_only für Bibliothekszugriff erzwingen

Verfügbar ab TC3.1 Build 4026

Kategorie Common 5:: Objekte aus dieser Bibliothek dürfen nur mit der Angabe des Namensraums der Bibliothek verwendet werden.

Siehe auch: Attribut 'qualified_only'

Referenzierung als Bibliothek erlauben

Verfügbar ab TC3.1 Build 4026

Kategorie Common 6:: Sie können das SPS-Projekt in einem anderen SPS-Projekt als Bibliothek referenzieren.

Siehe auch: SPS-Projekt als referenzierte Bibliothek verwenden

Allgemein

ID-Änderungen in TwinCAT-Dateien minimieren

Kategorie Common 7:: Die GUIDs der SPS-Objekte (z. B. POUs) werden mit denen des SPS-Projekts verknüpft (mittels XOR). Damit werden Änderungen der GUIDs der SPS-Objekte vermieden, wenn diese mehrmals in verschiedenen Projekten verwendet werden.

Dialog Bibliothekskategorien

Kategorie Common 8:

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.

Hinzufügen

Die Befehle Aus Beschreibungsdatei… und Aus anderer Bibliothek… erscheinen.

Entfernen

TwinCAT entfernt die selektierte Kategorie.

Aus 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 TwinCAT diese Kategorien.

Aus anderer Bibliothek…

Dialog Bibliothek auswählen erscheint, in dem Sie eine Bibliothek (*.library) auswählen, deren Befehlskategorien übernommen werden sollen. Wenn Sie den Dialog mit Öffnen beenden, übernimmt TwinCAT die Kategorien.

OK

TwinCAT stellt die Kategorien als Projektinformation zur Verfügung und zeigt sie im Feld Bibliothekskategorien an.

Abbrechen

Schließt den Dialog. Der Vorgang wird abgebrochen.

Siehe auch: