Customizing preferences for all users

When you set the preferences in the Central Management component, you control the preferences for all of the users who connect to that Central Management component. You can choose to allow the users to change your selections for their specific clients, or override your users selections in favor of those set in the Central Management component.

Before you begin

Table 1. Central Management component run time metadata properties. In the tree structure, expand predefined > docspec > metadata and for Filter by asset type, select All or Settings.
Property Value Description
Data formatting mixed, source, or template Controls how Rational® Publishing Engine formats rich data from the data source:
  • Mixed: Mixes source and template formatting.
  • Source: Discards template formatting and preserves data source formatting only.
  • Template: Discards source formatting and preserves template formatting only.
Missing data text <data attribute not found> or a String Placeholder text that is used by Rational Publishing Engine when a data attribute is not found in the data source. You can use the default or customize your own text.
Date pattern YYYY-MM-DD, YYYY-DD-MM The format in which dates are to be rendered in the output.
Time pattern HH:MM:SS, HH:MM The format in which times are to be rendered in the output.
dateTime pattern YYYY-MM-DD HH:MM:SS, YYYY-DD-MM HH:MM:SS, YYYY-MM-DD HH:MM, YYYY-DD-MM HH:MM The format in which combination dates and times are to be rendered in the output.
Output locale cs, en, es, fr, de, hu, it, ja, ko, pl, pt_BR, ru, zh_CN, zh_TW The output locale to be used for default date formats if the locale must be different from the system locale.
  • Czech (cs)
  • English (en)
  • Spanish (es)
  • French (fr)
  • German (de)
  • Hungarian (hu)
  • Italian (it)
  • Japanese (ja)
  • Korean (ko)
  • Polish (pl)
  • Portuguese (pt_BR)
  • Russian (ru)
  • Simplified Chinese (zh_CN)
  • Traditional Chinese (Taiwan) (zh_TW)
Image max width Number The maximum width in pixels of each image in the output documents. This property also controls the maximum width of OLEs in Microsoft Word documents.
Image max height Number The maximum height in pixels of each image in the output documents. This property also controls the maximum height of OLEs in Microsoft Word documents.
OLEs as static images true, false Controls how Rational Publishing Engine handles Rational DOORS® OLEs:
  • True: OLEs reach the output as static images
  • False: OLEs are preserved in the output. You can use this option for Microsoft Word output only.
Clean referenced files true, false When set to true, the reference files that are stored in the ref folder, which contain Rational DOORS OLEs, are deleted at the end of the document generation and are not included in the Microsoft Word documents. The size of the Microsoft Word document is smaller when this property is set to true.
Ignore data source configuration errors true, false When set to true, all errors that are generated from issues with the data source configuration element are ignored. When set to false, you are prompted to correct the errors.
Non Unicode fonts font_name For Rational DOORS data sources, you can specify fonts that are sent to Rational DOORS when data is being extracted. You can list more than one font name by separating them with commas.
Stop on pre-command failure true, false Specifies whether the document generation process is to be ended if the pre-command fails.
Pre-command String The pre-command prepares the data before the publishing the document specification. Pre-commands must be a single line value.
Post-command String The post-command runs commands after the document specification is published. Post-commands must be a single-line value.
Table 2. Central Management component engine preferences.

In the tree structure, expand predefined > preferences > engine and for Filter by asset type, select All or Settings.

Preference Value Description
Remote generation true, false When set to true, this property transfers document generation to a server. When set to false, documents generate locally.
Remote engine location URL When Remote generation is set to true, this property designates the server on which to generate the document.
Preview query limit Number The number of data entries that display when you preview the output of a template.
Core debug mode true, false When set to true, additional document generation details display in the log files, such as how a specific element was transformed.
Monitor and control location URL When Remote generation is set to true, this property designates the server on which the document generation details display for an administrator to monitor.

About this task

You cannot add or remove settings from the default list, but you can remove the value from them so that they are not being used.

Procedure

  1. Open the Central Management component administrative user interface. Example: http://server:port/rpews/ui/library.html
  2. In the Filter by asset type column, click Settings.
  3. In the Actions column, click the Edit resource icon.
  4. Edit the customizable fields:
    • Value: The value for the property or preference
    • Tags: Keywords to make your setting searchable in the administrative user interface
    • Private: Prevent other users from seeing this preference
    • Override user value: Prevent other users from changing this value in their client applications from the value that is specified here
    • Description: An explanation of how this setting is used
  5. Click Save changes.

Results

All users who connect to the Central Management component use these settings by default. If a user had one of the clients open when you made the change in the administrative user interface, the settings are changed for that user when the client is restarted.

Feedback