Voraussetzung
-
TIA Portal Openness ist mit dem TIA Portal verbunden.
Siehe Verbindung zum TIA Portal herstellen -
Ein Projekt ist geöffnet.
Siehe Öffnen eines Projekts
Einleitung
Sie können mit TIA Portal Openness Programmbausteine und DB-Komponenten aus Dokumentendateien innerhalb eines bestimmten Verzeichnisses importieren. Die Methode ImportFromDocuments() wird verwendet, um PLC-Bausteine aus dem Dokumentenformat direkt in das TIA Portal-Projekt zu importieren.
Parameter
Die Methode ImportFromDocument() akzeptiert bei Verwendung von TIA Portal Openness folgende Parameter:
|
Parametername |
Datentyp |
Beschreibung |
|---|---|---|
|
directoryInfo |
System.IO.DirectoryInfo |
Das Verzeichnis, das die Dokumentendateien für den Import enthält. |
|
fileNameWithoutExtension |
String |
Der Name der zu importierenden Datei ohne deren Erweiterung. |
|
ImportDocumentOptions |
Siemens.Engineering.SW.ImportDocumentOptions |
Optionen zur Anpassung des Importprozesses, wie zum Beispiel die Handhabung von Konflikten oder Überschreibungen mit Hilfe der folgenden Enumerationswerte:
|
Rückgabetyp
Die Methode ImportFromDocument() gibt das Objekt DocumentImportResultForBlocks zurück, das verwendet wird, um das Ergebnis des importierten Dokuments zu speichern. Der Rückgabetyp DocumentImportResultForBlock umfasst folgende Komponenten:
|
Name |
Datentyp |
Beschreibung |
|---|---|---|
|
ImportedPlcBlocks |
Siemens.Engineering.SW.PlcBlockAssociation |
Zusammenstellung importierter PLC-Bausteine. |
|
Messages |
Messages |
Gibt die Meldungen zurück, die während des Importvorgangs protokolliert werden. |
|
Parent |
IEngineeringObject |
Das übergeordnete Engineering-Objekt (IEngineeringObject), das mit diesem operation.IEngineeringObject verknüpft ist. |
|
State |
DocumentResultState |
Der Status des Dokumentenimportvorgangs. |
Programmcode
Um einen Programmbaustein aus einem Dokument zu importieren, ändern Sie folgenden Programmcode:
|
|
|---|
|
private void ImportProgramBlockFromDocument(PlcSoftware plcSoftware) { DocumentImportResult documentImportResultForBlocks = plcSoftware.BlockGroup.Blocks. ImportFromDocuments(new DirectoryInfo(@"D:\Project\Exported Files"), " LAD_Block", ImportDocumentOptions.Override); DocumentResultState documentResultState = documentImportResultForBlocks.State; DocumentResultMessageComposition documentMessages = documentImportResultForBlocks.Messages; // DocumentResultMessageComposition contains list of DocumentResultMessage. DocumentResultMessage documentResultMessage = documentImportResultForBlocks.Messages[0].Message; } |