Projekt/globale Bibliothek aus Teamcenter laden - 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/globale Bibliothek aus Teamcenter laden

Voraussetzung

Einleitung

Sie können mit TIA Portal Openness ein Projekt und eine Bibliothek aus Teamcenter laden und öffnen. Die API gibt den Startdateipfad zum Öffnen des Projekts oder der Bibliothek im TIA Portal zurück.

Parameter

Parametername

Datentyp

Obligatorisch

Beschreibung

tcGatewayConnectionInfo

Siemens.Engineering.TeamcenterGateway.TcGatewayConnectionInfo

Ja

Gibt während des Verbindungsaufbaus zu Teamcenter tcGatewayConnectionInfo zurück. tcGatewayConnectionInfo muss mit tcGatewayConnectionInfo der aktiven Verbindung übereinstimmen.

itemID

System.String

Ja

Gibt die ID für das TIA-Projekt / die Bibliothek an.

revisionID

System.String

Ja

Gibt die Versions-ID für das TIA-Projekt / die Bibliothek an.

itemType

Siemens.Engineering.TeamcenterGateway.ItemType(Enum)

Ja

ItemType für das Projekt/die Bibliothek in Teamcenter.

localCacheOption

Siemens.Engineering.TeamcenterGateway.LocalCacheOption(Enum

Ja

Inhalt des TcCache wird überschrieben, wenn bereits eine Version des im Laden begriffenen Projekts / der globalen Bibliothek vorhanden ist. "True" bedeutet, der Inhalt wird überschrieben. Bei "False" wird eine Ausnahme erzeugt, wenn die Versionen zwischen TcCache und Teamcenter nicht übereinstimmen oder wenn Inhalte geändert wurden.

Hinweis

Wird einer der obligatorischen Parameter nicht übertragen, wird eine Siemens.Engineering-Ausnahme des Typs TcGatewayException ausgelöst.

Programmcode

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

//Program code: Download project/library in Teamcenter

private void DownloadProjectLibrary(SecureString password)

{

    // Refer Connecting to the TIA Portal section

    TiaPortal tiaPortal = new TiaPortal();

    // Retrieve TcGatewayConnectionProvider and TcGatewayLockProvider from GetService()

    // using tiaPortal instance

    TeamcenterConnectionProvider tcGatewayConnectionProvider= tiaPortal.GetService<TeamcenterConnectionProvider>();

    TcGatewayLockProvider tcGatewayLockProvider = tiaPortal.GetService<TcGatewayLockProvider>();

    // Define user-specific credentials and connection

    string userName = "userName";

    string userRole = "userRole";

    string userGroup = "userGroup";

    string serverURL = "TeamcenterserverURL";

    string teamcenterInstance = "teamcenterInstance";

    try

    {

    // Connection to the Teamcenter using user's credential

    TcGatewayConnectionInfo connectionInfo = tcGatewayConnectionProvider.Connect(userName, password, userGroup, userRole, serverURL, teamcenterInstance);

    // Check out the dataset with specific parameters for editing in TIA Portal

    tcGatewayLockProvider.CheckoutDataset(connectionInfo ,"000495","A",

    DatasetType.T4TiaProjectDataset,"Project30");

    // Use TcGatewaySearchAndDownloadProvider to download the dataset as a file for

    // local processing

    TcGatewaySearchAndDownloadProvider downloadFromTcProvider = tiaPortal.GetService<TcGatewaySearchAndDownloadProvider>();

    FileInfo TIAObjectStarterFilePath = downloadFromTcProvider.Download(connectionInfo,"000495", "A", ItemType.Project, LocalCacheOption.Overwrite);

    var project = tiaPortal.Projects.Open(TIAObjectStarterFilePath);

    //OR

    var library = tiaPortal.GlobalLibraries.Open(TIAObjectStarterFilePath, OpenMode.ReadWrite);

    //User can work on the Project.

    project.DeviceGroups.Create("Group_3");

    project.Save();

    }

    catch(TcGatewayException ex)

    {

    // other operations

    }

}