Projektbezogene Attribute lesen - 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
Projektbezogene Attribute lesen

Voraussetzung

Einleitung

Mit dieser Funktion können Sie projektbezogene Attribute aus der TIA Portal Openness API erhalten. Die gelieferten Informationen umfassen Projektattribute, Projekthistorie und vom Projekt genutzte Produkte.

Projektattribute

Die Projektattribute liefern die folgenden Informationen:

Attributname

Datentyp

Schreibbar

Beschreibung

Author

System.String

r/o

Autor des Projekts

Comment

Siemens.Engineering.MultilingualText

r/o

Kommentar des Projekts

Copyright

System.String

r/o

Copyright-Hinweis des Projekts

CreationTime

System.DateTime

r/o

Zeitpunkt, zu dem das Projekt angelegt wurde

Family

System.String

r/o

Familie des Projekts

IsModified

System.Boolean

r/o

Gibt wahr aus, wenn das Projekt geändert wurde

LanguageSettings

Siemens.Engineering.LanguageSettings

r/o

Handhabt Projektsprachen

LastModified

System.DateTime

r/o

Zeitpunkt, zu dem das Projekt zuletzt geändert wurde

LastModifiedBy

System.String

r/o

Autor der letzten Änderung

Name

System.String

r/o

Name des Projekts

Path

System.IO.FileInfo

r/o

Absoluter Pfad des Projekts

Size

System.Int64

r/o

Größe des Projekts in KB

Version

System.String

r/o

Version des Projekts

Ändern Sie den folgenden Programmcode, um auf projektbezogene Attribute zuzugreifen:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

private static void AccessProjectAttributes(Project project)

{

    string author = project.Author;

    string name = project.Name;

    DateTime creationTime = project.CreationTime;

    DateTime modificationTime = project.LastModified;

    string lastModifiedBy = project.LastModifiedBy;

    string version = project.Version;

    MultilingualText comment = project.Comment;

    string copyright = project.Copyright;

    string family = project.Family;

    Int64 size = project.Size;

    LanguageSettings languageSettings = project.LanguageSettings;

}

Ändern Sie den folgenden Programmcode, um die Projektsprachen zu enumerieren:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

private static void AccessProjectLanguage(Project project)

{

   LanguageComposition languages = project.LanguageSettings.Languages;

   foreach (Language language in languages)

   {

   CultureInfo lang = language.Culture;

   }

}

Ändern Sie den folgenden Programmcode, um Kommentartext zu erhalten:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

private static void RetrieveCommentText(Project project)

{

    Language english = project.LanguageSettings.ActiveLanguages.

    Find(CultureInfo.GetCultureInfo("en-US"));

    MultilingualText projectComment = project.Comment;

    MultilingualTextItem textItem = project.Comment.Items.Find(english);

    string text = textItem.Text;

}

Projekthistorie

Die Projekthistorie ist eine Zusammensetzung von Objekten des Typs HistoryEntry, die folgende Informationen enthalten:

Attributname

Datentyp

Schreibbar

Beschreibung

Text

System.String

r/o

Ereignisbeschreibung

DateTime

System.DateTime

r/o

Zeitpunkt, zu dem das Ereignis aufgetreten ist

Ändern Sie den folgenden Programmcode, um HistoryEntries zu enumerieren und auf deren Attribute zuzugreifen:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

private static void AccessHistoryEntryAttributes(Project project)

{

    HistoryEntryComposition historyEntryComposition = project.HistoryEntries;

    foreach (HistoryEntry historyEntry in historyEntryComposition)

    {

    string entryText = historyEntry.Text;

    DateTime entryTime = historyEntry.DateTime;

    }

}

Hinweis

Das Textattribut von HistoryEntry enthält einen String in der gleichen Sprache wie die Benutzeroberfläche. Wenn eine TIA Portal Openness-Anwendung an ein TIA Portal ohne Benutzeroberfläche angehängt wird, liegt der String immer auf Englisch vor.

Verwendete Produkte

Das Objekt UsedProduct enthält die folgenden Informationen:

Attributname

Datentyp

Schreibbar

Beschreibung

Name

System.String

r/o

Name des verwendeten Projekts

Version

System.String

r/o

Version des Produkts

Ändern Sie den folgenden Programmcode, um UsedProduct zu enumerieren und auf die Attribute zuzugreifen.

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

private static void AccessUsedProduct(Project project)

{

    UsedProductComposition usedProductComposition = project.UsedProducts;

    foreach (UsedProduct usedProduct in usedProductComposition)

    {

    string productName = usedProduct.Name;

    string productVersion = usedProduct.Version;

    }

}