Bibliotheken speichern und schließen - 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
Bibliotheken speichern und schließen

Voraussetzung

Anwendung

Globale Anwenderbibliotheken können geschlossen oder gespeichert werden. Alle an der globalen Bibliothek vorgenommenen Änderungen werden nicht automatisch gespeichert. Alle nicht gespeicherten Änderungen werden ohne Benutzeraufforderung durch Schließen einer globalen Bibliothek verworfen.

Globale Systembibliotheken und globale Unternehmensbibliotheken können nicht geschlossen oder gespeichert werden.

Zum Speichern und Schließen einer globalen Bibliothek:

  • Zum Speichern einer globalen Anwenderbibliothek verwenden Sie die Methode Save ( ).

  • Verwenden Sie die Methode SaveAs ( ), wenn Sie eine globale Anwenderbibliothek in einem anderen Verzeichnis speichern möchten.

  • Zum Schließen einer globalen Anwenderbibliothek verwenden Sie die Methode Close ( ).

Feature-Token für SaveAs ( ) sind:

  • Public API: Erforderlich für alle veröffentlichten Features

  • DenyIfTransaction: Erforderlich, da SaveAs nicht innerhalb einer Transaktion zulässig sein darf, da es nicht rückgängig gemacht werden kann.

Programmcode

Ändern Sie folgenden Programmcode, um eine globale Anwenderbibliothek zu speichern:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

UserGlobalLibrary userLib = ...

// save changes and close library

userLib.Save();

userLib.Close();

Ändern Sie folgenden Programmcode, um eine globale Anwenderbibliothek an einem anderen Ort zu speichern:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

TiaPortal portal = new TiaPortal(TiaPortalMode.WithUserInterface);

GlobalLibraryComposition globalLibraryComposition = portal.GlobalLibraries;

//please adapt the path and the extension alx to the installed version of TIA Portal 

FileInfo existingLibraryfileInfo = new FileInfo(@"D:\GlobalLibraries\MyGlobalLibrary\MyGlobalLibrary.alx");

DirectoryInfo targetDirectoryInfo = new DirectoryInfo(@"D:\GlobalLibraries\GlobalLibrarySaveAs");

UserGlobalLibrary userGlobalLibary = globalLibraryComposition.Open(existingLibraryfileInfo, OpenMode.ReadWrite);

userGlobalLibary.SaveAs(targetDirectoryInfo);

Hinweis

Die Beständigkeit der Bibliothek wird nach der Operation SaveAs geändert. Von daher ist die neu gespeicherte Bibliothek nach Durchführung von SaveAs in der Bibliothekskarte verfügbar. Die ursprüngliche Bibliothek jedoch, mit der die Operation SaveAs durchgeführt wurde, ist nicht verfügbar. Die neu gespeicherte Bibliothek hat den gleichen Modus wie die ursprüngliche Bibliothek, für die SaveAs durchgeführt wurde. Das bedeutet, dass die neu gespeicherte Bibliothek im Zielpfad auch im Modus ReadOnly geöffnet wird, wenn die vorhandene Bibliothek im Modus ReadOnly geöffnet wurde. Ähnliches gilt für den Modus ReadWrite.

Ändern Sie folgenden Programmcode, um eine globale Anwenderbibliothek zu schließen:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

UserGlobalLibrary userLib = ...

// close and discard changes

userLib.Close();