Bentley i-model Composition Server for PDF Help

Advanced Configuration Properties

The following advanced settings are available in the iCS for PDF Browser in Orchestration Framework Administrator (under Configuration, right-click Advanced and select Edit):

SettingDescription
Create Audit Records If True (default), Bentley i-model Composition Server for PDF audit records are added to the source document when it is extracted and when renditions from it are distributed.
Enable Advanced Job Properties If False (default), some properties, including incremental settings, are not displayed on the Job Builder dialog.
Enable Office Attribute Exchange If True, attribute exchange is performed on Microsoft Office documents during extraction. This feature requires that a supported version of Microsoft Office be installed on the Bentley i-model Composition Server for PDF computer.

The default is False.

Extensions Requiring Copy Out A semicolon-separated list of file extensions (without the dot) identifying which Microsoft Office documents should be copied out instead of exported when documents are extracted. This property is used only if Office attribute exchange is enabled. Documents must be copied out in order for Office attribute exchange to occur.

Export operations are generally faster and less prone to concurrency failures than Copy Out operations. If Office attribute exchange is disabled or the document file extension is not one of those listed in this property value, extraction is always accomplished using export.

The default list of extensions is: doc;docx;xls;xlsm;xlsx

Enable Pending Distributions If True (default), distributions for source documents having multiple versions are deferred until all extractions and renditions are complete. This ensures that distributions associated with older source versions are never created on top of distributions associated with more recent source versions, which might otherwise occur in high-volume orchestrations performing simultaneous processing.

Setting this property to False can improve performance, but should only be done if your jobs only ever contain one version of a source document.

Job History Retention Max Days The maximum number of days to retain job history in the Bentley i-model Composition Server for PDF database. Job history records older than this period are deleted before adding a new job history record. If set to zero, job history records are never deleted.

The default is 90.

Max Document Rows in Email If greater than zero, the maximum number of document rows to include in the job email notification message. If set to zero, the success/failure tables in the email body are never truncated.

The default is 500.

Require Folder Creator Full Control If True, when creating new folders in the destination datasource, the ProjectWise user creating the folder must have Full Control permissions in addition to the permissions of the parent folder. If False, the newly created folder always only inherits the permissions of the parent folder, which can result in distribution failures if the parent folder permissions do not give write access to the submitting user.

The default is False.

Reference Extensions to Ignore Add the file extensions (including the dot) to this semicolon-separated list to identify which reference document file types to never extract and to ignore when determining if a master document needs to be re-processed. For example, you might choose to add the point cloud extension (.POD) to this list if your point cloud references happen to be on non-printing levels and do not affect the rendition. Adding file extensions to this list has the potential to improve performance, but should only be done if you know that the file extension you are adding is never going to be used in the rendition.

The default is undefined.

Update Titleblocks in References If False (default), MicroStation/AutoCAD attribute exchange (titleblock update) is only performed for the master document. This is the default setting.

In order to attribute exchange to occur, the file must be opened in read-write mode. When Bentley i-model Composition Server for PDF is configured with multiple InterPlot processors, if two or more processes simultaneously attempt to open the same reference in read-write mode, all but one will fail and cause rendition errors. Since Bentley i-model Composition Server for PDF is commonly set up for high-volume concurrent processing, and placing title blocks inside references is an atypical workflow, the default behavior is to minimize the chance of failure by not performing attribute exchange inside references. This property may safely be set to True if Bentley i-model Composition Server for PDF is configured to use a single InterPlot processor.

Version Name Conflict Behavior Specifies the behavior when Bentley i-model Composition Server for PDF attempts to create a document in the destination data source with a specific version name (copied from the source document) and a document having that same name, file name, and version string already exists. The property value may be one of the following:
  • Skip without reporting error - Do nothing and do not fail the source document.
  • Report error - Do nothing and fail the source document.
  • Generate unique version name - Append a new version to the destination document having a unique version name that does not match that of the associated source document version. This is done by appending ".0", ".1", and so on, to the source version name.

The default is to generate a unique version name.