Projekt anlegen - 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
Projekt anlegen

Voraussetzung

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:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

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:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

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.