Overview
Siemens Teamcenter is the PLM system that owns parts, revisions, BOMs, drawings and change processes for many plants. This connector lets shop-floor logic on MQTT read the released revision and BOM of a part, find its released drawing for a work instruction screen, and raise a problem report from a quality event, without custom code. SiemensTeamcenterApi (SiemensTeamcenterRestApi.lot) is one client connector on https://YOUR_TC_SERVER with 18 events: 1 login, 14 reads and 3 writes. No event deletes, revises or checks out anything.
Teamcenter exposes every SOA service operation as JSON over HTTP:
POST /tc/JsonRestServices/<Library>-<YYYY>-<MM>-<Service>/<operation> with a body of {"header": {"state": {}, "policy": {}}, "body": {...}}. Siemens does not publish an OpenAPI file for Teamcenter. Your installation can generate its own API description (Active Workspace npm run genSoaApi). The events here follow public samples: the Teamcenter REST API Postman collection, TCSwiftBridge and the Mendix Teamcenter connector docs. To add another operation, copy an event and change the operation path.Server host
Teamcenter is installed per customer, or runs as Teamcenter X (SaaS). ReplaceYOUR_TC_SERVER with your web tier host, with no trailing slash. Add the port when the web tier does not use 443 (for example :7001 or :8080). Behind the Active Workspace gateway, the same operations are also served under /tc/RestServices/ and need an X-XSRF-TOKEN header. This template uses /tc/JsonRestServices/ on the web tier.
Authentication
- Publish the credentials on
mes/siemens-teamcenter/session/login. The web tier answers with aJSESSIONIDcookie (Set-Cookie). - Send
"cookie": "JSESSIONID=<id>"in every other payload. One session holds one Teamcenter server process, so reuse it instead of logging in per call.
Payload convention
request: the full SOA envelope, sent as the body unchanged.header.policypicks which properties come back (types[].properties[].name).cookie: the session cookie,JSESSIONID=<id>.- Objects are referenced as
{"uid": "...", "type": "ItemRevision"}. Some operations take plain UID strings.
Events
Replies arrive on
<topic>/response.
Flows
Item revision and BOM
GetItemFromIdwith the item ID returns the item and revision UIDs.CreateBomWindowwith the item UID returns a BOM window and its top BOM line.ExpandBomOneLevelorExpandBomAllLevelswith the top BOM line returns the children. The property policy inheader.policysets which item revision fields come back.CloseBomWindowfrees the window on the server.
Released drawing for work instruction display
GetItemFromIdreturns the revision UID.GetPropertieson the revision withrelease_status_list,date_released,IMAN_specificationandIMAN_Renderingtells you whether the revision is released and which datasets hold its drawing. You can also useExpandGrmRelationsForPrimarywithrelationTypeNameIMAN_specification.- Show the dataset in Active Workspace, or download the file through FMS. File download (
getFileReadTicketsand FMS) is not part of this template.
Problem report from a quality event
CreateProblemReportcreates an item of your problem report type (ProblemReportin the example) in a folder.CreateRelationslinks the affected revision to the problem report revision.StartWorkflowstarts your change process template on it.
Example actions
docs-helper-actions.lot holds example actions. They log in every 25 minutes with Hub secrets, look up an item or a revision’s drawing datasets when a station asks, and create a problem report from a quality event.
Not included
- Delete, revise and checkout operations (left out on purpose).
- File download and upload through FMS (binary content).
- BOM edits (
addOrUpdateChildrenToParentLine,saveBOMWindows). - Teamcenter SSO / Teamcenter X login services and the AWC gateway
/tc/RestServices/variant.
Status
Blocked (beta). Every event works against a local mock Teamcenter web tier, and the connector passeslot_lint. No call has run against a real Teamcenter server. To clear the live test, the factory needs:
- the web tier URL,
- a Teamcenter service user and password (or SSO client details and a way to get
JSESSIONID), - a test item with a released revision, a BOM and a drawing.

