Skip to main content
YE_143421243-Newcomer
3-Newcomer
September 11, 2026
Solved

Usage of doPublish API

  • September 11, 2026
  • 2 replies
  • 82 views
I am using Windchill PDMLink Release 12.0 and Datecode with CPS 12.0.2.13 Currently we are looking for a way to upload local files to the representation of EPMDocument. We think using custom publish mechanism via doPublish API can be a solution, and checking the web page below that introduces usages of the doPublish API. https://support.ptc.com/help/windchill/r13.1.2.0/en/index.html#page/Windchill_Help_Center/customization/WCCG_BusLogicCust_WCVisualization_CustPublish.ht ml However, we are not sure if this API can be used without Windchill Visualization Service configuration. Currently we do not have any WVS configuration, and as our understanding, configuring a WVS worker and letting WVS publish workflow works properly require bit tough development effort. Hence, if the doPublish API must be used upon a proper WVS configuration, we will look for another way. Could you kindly answer the question if the doPublish API can be used without Windchill Visualization Service configuration?
Best answer by BryanK

Hi, I doubt that this will work. 

the doPublish API cannot be used effectively without Windchill Visualization Service (WVS) configuration.

Without any WVS configuration (queues not set up or running, no workers if content conversion is required, missing basic properties, etc.), the job is queued but never processed into an actual Representation. The call may return successfully (or appear to), but no usable Representation is created.

 

Do not rely on doPublish if you have no WVS configuration and simply want to attach local files as Representations.

Prefer RepHelper.loadRepresentation (if the files are already on the server) or the WRS CreateRepresentationFromLocalFile action, or the direct DerivedImage + content attachment approach.

Full WVS worker setup is only required if you need automatic conversion of native CAD data into viewables. For pre-converted/local files it is unnecessary.

2 replies

BryanK17-PeridotAnswer
17-Peridot
September 11, 2026

Hi, I doubt that this will work. 

the doPublish API cannot be used effectively without Windchill Visualization Service (WVS) configuration.

Without any WVS configuration (queues not set up or running, no workers if content conversion is required, missing basic properties, etc.), the job is queued but never processed into an actual Representation. The call may return successfully (or appear to), but no usable Representation is created.

 

Do not rely on doPublish if you have no WVS configuration and simply want to attach local files as Representations.

Prefer RepHelper.loadRepresentation (if the files are already on the server) or the WRS CreateRepresentationFromLocalFile action, or the direct DerivedImage + content attachment approach.

Full WVS worker setup is only required if you need automatic conversion of native CAD data into viewables. For pre-converted/local files it is unnecessary.

    YE_143421243-NewcomerAuthor
    3-Newcomer
    September 14, 2026

    Thank you for kind reply!! 

    It seems that the WRS CreateRepresentationFromLocalFile is the easiest way to attach a local file as EPMDocument’s representaion, but this Web API is quite new. We will consider using RepHelper.loadRepresentation or creating DerivedImage as you mentioned. We’ll start checking our Javadoc. We appreciate your answer. Thank you so much!

     

    Terms & ConditionsAccessibility statement