Voraussetzung
-
Die TIA Portal Openness-Anwendung ist mit dem TIA Portal verbunden.
Siehe Verbindung zum TIA Portal aufbauen
Einleitung
Projekte können über die TIA Portal Openness API erstellt werden
-
durch Aufrufen der Methode Create auf ProjectComposition
-
durch Aufrufen der Methode Create auf IEngineeringComposition
ProjectComposition.Create
Ändern Sie folgenden Programmcode:
|
private static void ProjectCreate() { TiaPortal tiaPortal = new TiaPortal(); ProjectComposition projectComposition = tiaPortal.Projects; DirectoryInfo targetDirectory = new DirectoryInfo(@"D:\TiaProjects"); // Create a project with name MyProject Project project = projectComposition.Create(targetDirectory, "MyProject"); } |
Entsprechend diesem Beispiel
-
wird ein Ordner "D:\TiaProjects\MyProject" erzeugt.
-
wird eine Projektdatei "D:\TiaProjects\MyProject\MyProject.aPXX" erstellt.
|
Hinweis Parameter targetDirectory Der Parameter targetDirectory kann auch einen UNC (Universal Naming Convention)-Pfad darstellen, von daher kann ein Projekt auch auf einem freigegebenen Laufwerk im Netzwerk erstellt werden. |
IEngineeringComposition.Create
Ändern Sie folgenden Programmcode:
|
public struct ProjectCreateParameters { public DirectoryInfo TargetDirectory; public string Name; public string Author; public string Comment; } private static Project ProjectAttributeCreate(ProjectCreateParameters parameters) { try { TiaPortal tiaPortal = new TiaPortal(); ProjectComposition projectComposition = tiaPortal.Projects; // Prepare the create parameters var createParameters = new List<KeyValuePair<string, object>> { new KeyValuePair<string, object>("TargetDirectory", parameters.TargetDirectory), // Mandatory new KeyValuePair<string, object>("Name", parameters.Name) // Mandatory }; if (!string.IsNullOrEmpty(parameters.Author)) { createParameters.Add(new KeyValuePair<string, object>("Author", parameters.Author)); // Optional if (!string.IsNullOrEmpty(parameters .Comment)) { createParameters.Add(new KeyValuePair<string, object>("Comment", parameters.Comment)); // Optional } // Create a project with both mandatory and optional parameters return ((IEngineeringComposition)projectComposition) .Create(typeof(Project), createParameters) as Project; } catch (Exception ex) { Console.WriteLine($"Exception of type {ex.GetType()} occurred: {ex.Message}"); return null; } } |
Entsprechend diesem Beispiel:
-
wird ein Ordner "D:\TiaProjects\MyProject" erzeugt.
-
wird eine Projektdatei "D:\TiaProjects\MyProject\MyProject.aPXX" mit den Projektattributen Autor gleich "Bob" und Kommentar gleich "This project was created with openness" erstellt.
Parameter zum Erstellen eines Projekts mit optionalen Projektattributen
|
Parameter |
Datentyp |
Obligatorisch |
Beschreibung |
|---|---|---|---|
|
Author |
String |
Nein |
Autor eines Projekts. |
|
Comment |
String |
Nein |
Kommentar zum Projekt. |
|
Name |
String |
Ja |
Name eines Projekts. |
|
TargetDirectory |
DirectoryInfo |
Ja |
Verzeichnis, in dem der erstellte Projektordner enthalten ist. |