PTC Visualization Domain
The PTC Visualization (Visualization) domain provides access to the visualization services of Windchill.
Use Windchill Visualization Services (WVS) to publish lightweight representations of native document content in Windchill. These lightweight representations are then stored in the Windchill database and can be viewed, managed and modified. You can open representations of Windchill documents, such as, CAD Documents, EPMDocuments, and WTDocuments, in Creo View. You can view and annotate the primary content and attachments of the documents in Creo View.
Use the PTC Visualization domain to download CAD data and view it in Creo View.
The following table lists the significant OData entities available in the PTC Visualization domain. To see all the OData entities available in the PTC Visualization domain, refer to the EDM of the domain. The domain EDM is available at the metadata URL.
|
Items
|
OData Entities
|
Description
|
|
Windchill representation
|
Representation
|
The Representation entity is a lightweight representation of CAD data that is stored in Windchill and is associated with parts and documents. The entity returns the following URLs, which you can use to start Creo View and download CAD data:
• CreoViewURL
• 3DThumbnailURL
• 2DThumbnailURL
• AdditionalFiles
|
In addition to the entities, this domain also contains RepresentationHyperlink complex type, which retrieves additional information for a Representation. It contains a URL and additional attributes, such as, Object ID, Comments, Description, FormatIcon, CreatedOn, LastModified, FileName, FileSize, MimeType, Format and so on.
URLs Retrieved in the Representation Entity
Windchill Visualization Services converts CAD, XML, document, and other data formats into a neutral file format. The converted data is stored as a representation. You can view representations as thumbnail images, which are displayed on information pages of parts and listings throughout Windchill.
In Windchill REST Services, the Representation entity retrieves the following URLs. You can use these URLs to download the CAD data. The URLs are returned in the body of the response. Along with the URL, the entity also retrieves attributes such as, FileSize, MimeType, FileName, Format, and so on for 3D thumbnail, 2D thumbnail, and additional files.
• CreoViewURL—Contains the URL that starts the Creo View application.
• 3DThumbnailURL—Contains the URL for 3D thumbnail.
• 2DThumbnailURL—Contains the URL for 2D thumbnail.
• AdditionalFiles—Contains the URL to download additional files, which are non-native Creo View files. These files are associated with the specified representation.
For example, consider a DerivedImage with OID 786687. To retrieve the URLs for Creo View, thumbnail and additional files, send the following GET request:
GET /Windchill/servlet/odata/Visualization/Representations('OR:wt.viewmarkup.DerivedImage:786687') HTTP/1.1
The function
GetDynamicStructureRepresentation() returns a URL you can use to download the dynamic structure of a Creo View representation.
Refer to the section on GetDynamicStructureRepresentation(), for more information.