Configuring FlexPLM for Asynchronous Image Conversion
When dealing with small files, it might be advantageous to use synchronous conversion as the default processing behavior. Everything from system load, number of users, network bandwidth, upload times, can influence the setting of the threshold. Asynchronous conversion is configured by setting the following property:
com.lcs.wc.document.imageGeneration.maxFilesizeConvertThreshhold
This property determines the file size threshold for enabling asynchronous conversion. Any graphics file that is larger than this threshold is converted asynchronously. Any graphics file that is smaller than this threshold is converted synchronously. The administrator can also determine the number of threads used for asynchronous conversion with the following property:
com.lcs.wc.util.ProcessingQueueSize
The default number of threads is one.
When generating thumbnails and web-viewable images, it is possible to delay the processing of the queue entry to ensure the document and its primary content is checked in. To configure the system to wait to generate the thumbnail or viewable for a set period of time, enter the following property settings in the custom.lcs.properties file:
• Enter the following property setting to set the total time for the system to wait for the document to be checked in. The value of this property setting is the delay, specified in seconds.
com.lcs.wc.document.aSyncGeneration.ttlSleepDelay=#
• Enter the following property setting to specify how frequently the system verifies if the document has been checked in during the ttlSleepDelay period when creating the viewable. The value of this property setting is the delay, specified in milliseconds.
com.lcs.wc.document.aSyncGeneration.viewableSleeperInterval=#
• Enter the following property setting to specify how frequently the system verifies if the document has been checked in during the ttlSleepDelay period when creating the thumbnail. The value of this property setting is the delay, specified in milliseconds.
com.lcs.wc.document.aSyncGeneration.thumbnailSleeperInterval=#
Graphical Interface Changes
When the thumbnail file or the web-viewable file is created synchronously, the user can view the results immediately. This is not the case when the conversion is asynchronous. Control is returned to the browser as soon as the document and its contents are uploaded and checked in, or as soon as the image page and its contents are uploaded and checked in. The user is unable to view the thumbnail or web-viewable file that is the result of the asynchronous conversion until the queue entry completes processing for the conversion task and the user refreshes or reloads the view page in the browser. By default, a blank image appears when the asynchronous conversion is in process.
Use the following properties to configure a work-in-process image to inform the user that the uploaded image is being processed in the background:
com.lcs.wc.document.imageGeneration.async.workInProcessImage.enabled=true
com.lcs.wc.document.imageGeneration.async.workInProcessImage.url.path=
/Windchill/rfa/images/blue-loading.gif