tia-teamcenter

TIA Portal Teamcenter Gateway

Scope

Teamcenter Gateway workflows exposed by Siemens.Engineering.TeamcenterGateway. The V21 API is provider-based: connection, lock, search/download, and workflow operations are separate services.

Reference files

Load ONLY the reference file(s) relevant to the task.

Installed V21 entry points

Portal-scoped providers:

TeamcenterConnectionProvider connections =
    tiaPortal.GetService<TeamcenterConnectionProvider>();
TcGatewayLockProvider locks =
    tiaPortal.GetService<TcGatewayLockProvider>();
TcGatewaySearchAndDownloadProvider searchAndDownload =
    tiaPortal.GetService<TcGatewaySearchAndDownloadProvider>();

The save provider belongs to the opened project or global library:

TcGatewayWorkflowProvider workflow =
    project.GetService<TcGatewayWorkflowProvider>();

Do not introduce an intermediate service or storage composition that is absent from these installed entry points.

Enforcement

1. Require the exact endpoint, Teamcenter instance, user/group/role or SSO application identity, and expected item/revision/dataset identity.
2. Keep passwords in SecureString; treat TcGatewayConnectionInfo.SessionToken as a secret and never log or serialize it.
3. Require explicit remote-write authorization for checkout, check-in, checkout cancellation, overwrite download, and every save/new-item/new-revision operation.
4. Treat LocalCacheOption.Overwrite as destructive. Use it only for an exact, pre-inventoried cache target.
5. Resolve search results to exactly one expected item and revision. Never use .First() or [0] as selection logic.
6. Disconnect in finally only when the current operation established the connection; do not terminate a caller-owned Teamcenter session.
7. Checkout cancellation is not rollback and does not discard local project/library changes. Do not use it as unconditional cleanup.
8. Do not claim a save, check-in, download, or disconnect succeeded without checking the returned result and/or re-reading authoritative Teamcenter state.