Zugriff auf Bausteine in Bibliotheken - TIAPortal

TIA Portal Openness: API für die Automatisierung von Engineering-Workflows

ft:publication_title
TIA Portal Openness: API für die Automatisierung von Engineering-Workflows
Product
TIAPortal
Version
V20
Publication date
01/2025
Language
de-DE
Zugriff auf Bausteine in Bibliotheken

Voraussetzung

Einleitung

Sie können mit TIA Portal Openness den Versionsstand aus dem Bibliotheksobjekt abrufen, ohne das Objekt zu instanziieren und zu übersetzen.

Die folgende neue Export-Aktion wird im Engineering-Objekt LibraryTypeVersion zum Exportieren des Versionsinhalts bereitgestellt.

Die Aktion erstellt die exportierte XML-Datei auf dem mit exportFileInfo angegebenen Versionsstand.

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

void Export('''FileInfo''' exportFileInfo, '''ExportOptions''' exportOptions)

Es wird eine Ausnahme zurückgegeben:

  • Wenn die Benutzerausnahme lautet "Die Versionsdaten können nicht exportiert werden, weil sie sich im Arbeitszustand befinden" und die zu exportierende Version den Zustand "Im Test" aufweist.

  • Wenn eine allgemeine DataExchange-Benutzerausnahme, z B. "FileAlreadyExists" vorliegt, und die Meldung ausgegeben wird: "Der Export kann nicht durchgeführt werden, weil die Datei 'D:\\*.xml' bereits vorhanden ist.".

Engineering-Objekt Bibliothekstypversion

Die folgenden Ergänzungen werden am Objekt Library TypeVersion engineering vorgenommen:

  1. Die Export-Aktion wird an LibraryTypeVersion bereitgestellt.

  2. Ein Navigator zum Navigieren zum durchsuchbaren Versionsinhalt.

    • Navigatorname: ContentObject

    • ReadPublicationLevel : System

    • Zusammenhangsname: Engineering.Library.DefaultVersionContentObject

    • Der Basisnavigator bietet eine Standard-Implementierung, um eine leere durchsuchbare Sammlung als Versionsinhalt bereitzustellen. Der Kunde kann diesen Navigator überschreiben und den Versionsinhalt bereitstellen.

  3. "LibraryTypeName" und "LibraryTypeGuid" am Objekt LibraryTypeVersion.

Attribute

ReadPublicationLevel

LibraryTypeName

System

LibraryTypeGuid

System

Hinweis

Dies ist erforderlich, weil ohne diese Information nicht klar wäre, zu welchem Typ die exportierte Version (laut Versionsstand in der exportierten XML-Datei) gehört.

Exportierter Inhalt

Der folgende Inhalt wird in der exportierten Datei angezeigt:

  • Exportierter Versionsstand der Bibliothek

Attribute

SimaticMLAAccess

Author

ReadWrite

Guid

ReadOnly

Modified Data

ReadOnly

VersionNumber

ReadWrite

LibraryTypeName

ReadOnly

Library TypeGuid

ReadOnly

Exportierte Navigatoren:

  • Comment

Hinweis

Attribute mit schreibgeschütztem SimaticMLAccess werden nur exportiert, wenn Sie die Exportoption "ExportOptions.WithReadOnly" wählen.

Programmcode

Ändern Sie folgenden Programmcode, um den Versionsstand des exportierten Inhalts zu exportieren:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

Guid g = new Guid("35ad9996-d6d7-40c9-989f-0f0c7e21a7b2");

//Block1

var version = m_Project.ProjectLibrary.FindType(g).Versions[0];

version.Export(new FileInfo(@"D:\ExportCodeBlock.xml"),ExportOptions.WithReadOnly);

Siehe auch

Projekt öffnen