Voraussetzung
-
TIA Portal Openness ist mit dem TIA Portal verbunden.
Siehe Verbindung zum TIA Portal aufbauen -
Ein Projekt ist geöffnet.
Siehe Öffnen eines Projekts
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
|
//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 } } |