You can set a number of WebReports configuration preferences by editing the opentext.ini file. Table 1-2 describes the configuration options.
| |
|
|
Notes:
-
Be cautious about making changes to settings in the opentext.ini file.
-
After you make changes, you must restart Content Server.
-
If you are unsure about a change, make sure to consult OpenText Support. |
| |
Table 1-2: WebReports Configuration Options in the opentext.ini File
| Field Name |
Type |
Description |
| addsearchbutton |
String or null |
|
| searchslice |
Integer |
| Determines how many results are retrieved for each call of the search API. Changing this setting will impact the performance of WebReports that use search as a data source. In general, this setting should only be altered upon advice from OpenText Support. |
|
| searchHardLimit |
Integer |
| Determines a maximum limit on the number of results that a WebReport using search as a data source can return. |
|
| searchDebug |
true / false |
| Turns on extra debug information in the thread log for executing WebReports with search as a data source. |
|
| EnableOscriptReportviews |
true / false |
| Controls whether Oscript is permitted within reportviews. Default is true. When set to false no oscript within any reportview will be compiled or executed. This turns the scripting feature off completely on the Content Server. |
|
| OscriptAllowFunction1 |
List of strings |
A list of individual oscript package functions to be permitted within a reportview. For more information about addsearchbutton, see the OpenText WebReports - OpenText Content Server User Online Help (LLESWEBR-H-UGD). |
| OscriptAllowWholePkg |
List of strings |
|
| MaxNestedSubWebReports |
Integer |
| Controls the upper limit of how many levels of sub-WebReports may be nested. |
| If this field is empty, default = 5 | |
| VersionInput |
String dir path |
| Specifies the input directory for a converter (e.g. AdLib eXpress). This should be changed via the Manage WebReports Conversion administration page. | |
| ConversionDir |
String dir path |
| Specifies the output directory for a converter (e.g. AdLib eXpress). This should be changed using the Manage WebReports Conversion administration page. | |
| additionalSearchColumns |
List of strings or list of lists |
| Determines the optional columns available to WebReports that use search data sources. Possible values include: OTHotWords, OTSummary, parentRecord, Score, shortOTSummary. These can be specified as strings within a list or as a list of two element lists where the first element is the column coming back from search and the second column is what you want it to be called in the output. It should be noted that these values are made available via the search index. If the underlying structure of the index were to change in future releases, these columns may no longer be available. | |
| AllowFormCustomview |
true / false |
| Control whether WebReports can be added to form templates as views. This feature is visible by navigating to the views tab of a form template. The options Add WR Power View will be present if the feature is enabled. |
| The feature is enabled by default. | |
| WRNodeMIMETypes |
List of strings |
| Determines the list of MIME types that a WebReport node itself may be set to. Effectively, this is the MIME type of the reportview. Typically, WebReports are assigned the text/plain MIME type, but sometimes it may be useful to permit text/html or other MIME types. | |
| destinationmimetypes |
List of strings |
| The is the MIME type of the output that will be created by WebReports. Depending on client settings, this can determine which application is used to open the resulting document. | |
| WRTriggerSubtypes |
List of integers |
| Controls the sub-types that are able to initiate WebReports from the WR Trigger feature. |
| All sub-types are disabled by default. | |
| DisallowServices |
true / false |
| Enables or disables the WR Services feature. |
| WR Services is enabled by default. | |
| livelinkcategory_maxNumCats |
Integer |
| Defines the maximum number of categories selectable via the category as a data source feature. | |
| livelinkcategory_NumAttrAcross |
Integer |
| Defines the maximum number of attributes that should be displayed on a single line from the category as a data source feature. | |
| livelinkcategory_attrDelimiter |
String |
| This character is used to separate multivalue attributes in the output from the category as a data source feature. | |
| livelinkcategory_maxNumRows |
Integer |
| Controls the maximum number of results that are retrievable from the category as a data source feature. | |
| AllowFormCustomview |
true / false |
| Enables or disables the WR Power View feature which allows a WebReport to be used as a form view. | |
| collectConvDocCache |
Integer |
| For WebReports that use certain destinations that allow for conversion of the WebReport output before delivery to its final destination, the document is stored in a cache which is cleared by an agent after 120 minutes by default. This setting specifies an alternate expiry time for the cache. | |
| SecureServicesSubtags |
List of Strings |
| This setting is used to define any sub-tags that require special security considerations when being used through the WR Services feature. If any of the specified sub-tags are included in a WR Services request then the software will expect that a secure token has also been provided in the request. |
| For example, ?func=webreports.runservice&servicetype=gettagdata&tagdata=1000&subtags=useraction:delete would create an error message unless a valid security token had previously been requested (&servicetype=gettoken) and added to the request like this: ?func=webreports.runservice&servicetype=gettagdata&tagdata=1000&subtags=useraction:delete&securerequesttoken=123456.... |
| This setting is automatically added with a default list on new, full installs but if the software is installed as an Update the default setting is added as a comment. |
| The current set of sub-tags included by default are: SecureServicesSubtags={'CATACTION','NODEACTION','SCACTION','PERMACTION','RMACTION', 'USERACTION','WFACTION','USERINFO','RMINFO','NODEINFO','EMAILINFO','WFINFO','AUDITINFO', 'VERINFO','SCINFO','POINFO'} | |
| UpdateNumber |
Integer |
| The software uses this setting to manage software update versions. You should only change this setting with guidance from OpenText Support. | |
.
Example 1-1: The following example illustrates a typical arrangement:
[WebReports]
addsearchbutton=Custom Report
VersionInput=C:\AdLib eXpress\Input
ConversionDir=C:\AdLib eXpress\Output
OscriptAllowFunction1={'Scheduler.debugbreak','Web.CRLF','Web.Escape','Web.Unescape','Web.DecodeForURL','Web.EncodeForURL','Web.Format','Web.EscapeHTML','Web.EscapeXML'}
OscriptAllowWholePkg={'Assoc','Bytes','Date','List','Math','Pattern','RecArray','Str','String','Boolean','undefined','void','integer','real','record'}
EnableOscriptReportviews=true
MaxNestedSubWebReports=10
additionalSearchColumns={{'OTSummary','Summary'},{'shortOTSummary','shortSummary'},OTHotWords,Score,parentRecord}