Import von Projekttexten - 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
Import von Projekttexten

Voraussetzung

Verwendung

Im TIA Portal finden Sie Projekttexte unter dem Knoten "Sprachen & Ressourcen" eines Projekts. Sie können Projekttexte aus einer *.xlsx-Datei importieren, was zum Beispiel für Übersetzungen genutzt werden kann. Die Einschränkungen beim Exportieren und Importieren von Projekttexten sind die gleichen wie in der Benutzeroberfläche. Diese Einschränkungen umfassen:

  • Exportierte Texte können nur in das Projekt importiert werden, aus dem sie exportiert wurde.

  • Nachdem ein Projekt mit "Speichern unter..." unter einem neuen Namen gespeichert wurde, ist der Import von Texten nicht mehr möglich.

  • Übersetzte Texte können nur in Sprachen importiert werden, die in dem Projekt, aus dem sie exportiert wurden, verfügbar sind.

  • Nur vorhandene Texte können reimportiert werden. Wenn Texte aus dem ursprünglichen Projekt gelöscht oder neu erzeugt wurden, schlägt der Import dieser Texte fehl.

Sie müssen die folgenden Parameter festlegen:

Name

Beispiel

Beschreibung

path

new FileInfo(@"D:\Test\ProjectText.xlsx")

Pfad zur Importdatei

updateSourceLanguage

true

Wenn "true", wird der Text der Referenzsprache anhand der Exportdatei aktualisiert.

Wenn "false", wird der Text der Referenzsprache nicht aktualisiert.

Hinweis

Mehrsprachige Texte werden zusammen mit dem übergeordneten Objekt, zu dem sie gehören, importiert. Mehrsprachige Texte können nicht explizit importiert werden.

Programmcode

Die Verwendung der Beispielparameter führt zum folgenden Programmcode zum Importieren von Projekttexten:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

ProjectTextResult result = project.ImportProjectTexts(new FileInfo(@"D:\Test\ProjectText.xlsx"), true);

Der Import der Projekttexte gibt ein Objekt zurück, das den Status des Imports anzeigt und den Pfad angibt, in dem das Importprotokoll gespeichert wird. Auf diese Attribute kann mit dem folgenden Code zugegriffen werden:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

ProjectTextResultState resultState = result.State;

FileInfo logFilePath = result.Path;