PTC Windchill

The current Windchill backend only supports loading via a technical user. All communication takes place via Windchill’s OData API. Structural assembly data is returned as X3D while geometric data is returned as PVZ.

Configuration options are as follows:

windchill:
  # Whether the Windchill backend is enabled.
  enabled: false
  # The Windchill server base URL.
  # Example: https://windchill.company.com
  baseUrl:
  # User credentials for the technical user. Basic authentication is used.
  user:
    # Name of the technical user.
    name:
    # Password of the technical user.
    password:
  # Prefixes to use for links in assembly data. These must be registered as
  # data pools in the system.
  prefixes:
    # Prefix for links pointing to additional assemblies. Note that each
    # assembly is generated via OData and output as X3D.
    structure: "urn:windchill:structure:"
    # Prefix for links pointing to individual parts. These are output as PVZ.
    part: "urn:windchill:part:"
  # Number of levels to resolve when querying OData to resolve assemblies. The
  # more levels are resolved, the longer loading takes.
  expandLevels: 1
  # Location fixup settings to convert improbably large Windchill coordinate
  # values to more meaningful ones. This may not be necessary depending on the
  # data quality in your Windchill instance. If enabled, the following
  # settings divide any numerical position value by `locationDivisor` if the
  # value itself is larger than `locationTriggerValue`.
  fixups:
    locationTriggerValue: 1e3
    locationDivisor: 1e13

Once configured, the following endpoints will be available to configure as URNs for data pool rules:

• /wc/x3d/{oid}: Returns an X3D structure for the given Windchill ID. Note that IDs must be the full value of OR:wt.epm.EPMDocument:12345.

• /wc/pvz/{oid}: Returns the PVZ part for the given Windchill ID. Note that IDs must be the full value of OR:wt.epm.EPMDocument:12345.

• /wc/pvz/{number}/{revision}: Returns a PVZ of the given part number and revision.

• /wc/pvz-dynamic/{oid}: Returns a monolithic PVZ part for the given Windchill ID. Note that IDs must be the full value of OR:wt.epm.EPMDocument:12345.

---

Was this page helpful? Please leave a thumbs up or down.

👍 Yes 👎 No