Voraussetzung
-
Die TIA Portal Openness-Anwendung ist mit dem TIA Portal verbunden.
-
Ein Projekt ist geöffnet.
Siehe Projekt öffnen
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:
|
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:
|
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:
|
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:
|
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 |
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.