Application Settings determine the configuration and behavior of the WebFOCUS web application.
The settings appear in the main configuration pane.
Settings on the Application Caches page configure the size and contents of the Data Values Cache on the Application Server. This cache contains values assigned to parameters used in Autoprompt Reports, Embedded BI Applications, or any procedure that includes the FIND parameter syntax to limit the range of available search parameter values.
These settings establish the default configuration for Data Values Cache operations in your environment. Administrators and users who have the privilege to work with the Session Viewer can temporarily override these default settings using options in the Caching list.
The Application Caches page also includes the Report Output Cache setting that establishes the use of a separate cache for report output.
Identifies the IBFS Paths to those folders or Master Files within the paths defined in the Data Values Global Cache Paths or the Data Values User Cache Paths settings whose values should be not be included in these caches.
If no IBFS Paths are defined in this setting, no data values are excluded from the individual resources or folders defined within the paths in the Data Values Global Cache Paths (IBI_DATAVALUES_CACHE_GLOBALPATHS) or the Data Values User Cache Paths (IBI_DATAVALUES_CACHE_INCLUDEPATHS) settings. This is the default value.
If one or more IBFS Paths are defined in this setting, data values from the individual resources or folders defined within these paths are excluded from the Global Data Values Cache and from individual User Session Caches even though the folder or directory in which they are contained is subject to caching.
Paths defined in this setting use the IBFS Path format. At a minimum, they must include the /EDA IBFS subsystem component, followed by the name of the WebFOCUS Server Node. Shorter, higher-level paths define a broad range of folders and the Master Files they contain. Longer paths that extend to a lower level define a narrower range of application folders and Master Files. Paths can extend down to the level of an individual application folder or a single Master File. Typically, this setting requires longer and more specific paths in order to identify the individual folders or Master Files that must be excluded from the paths defined in the other data cache settings.
When this setting includes multiple paths, each one must be separated by a semicolon (;) with no space following, as shown in the following example: /EDA/EDASERVE/retail_samples;/EDA/EDASERVE/ibisamp.
IBFS Paths in this setting use the following structure. Only the first two components of the path are required. You can use the remaining components to narrow the focus of the path.
/EDA/Node/ApplicationFolder/SubFolder1 ... SubFolderN/ResourceFolder/Resource
where:
Is the EDA IBFS subsystem. This component is required for all paths. The initial slash (/) before this component is required.
Is the name of the WebFOCUS Server node. This component is required for all paths.
Is the name of the application folder that contains the resources whose data will be excluded from the data values cache.
Are the names of any folders underneath the application folder that connect to the end point of the path. Include as many folders as are necessary.
Is the end point of the path. If this is the name of a folder that contains one or more Master File resources, then data from all Master Files in the folder is excluded from the cache. If this is the name of a Master File without the .mas extension, then only data from this specific Master File is excluded from the cache.
Identifies the IBFS Paths to those resources whose data source values can be made available to all users without restriction in the Global Data Values Cache.
The paths defined in this setting should only identify resources that contain data that is not subject to DBA or row-level security restrictions. For calls to cache resources that contain data that is subject to these restrictions, the paths defined in the Data Values User Cache Paths (IBI_DATAVALUES_CACHE_INCLUDEPATHS) setting are used.
If no IBFS Paths are defined in this setting, then no data source values are included in the Data Values Global Cache. This is the default value.
If one or more IBFS Paths are defined in this setting, then data values retrieved from the resources identified in those paths are included in the Data Values Global Cache.
Paths defined in this setting use the IBFS Path format. At a minimum, they must include the /EDA IBFS subsystem component, followed by the name of the WebFOCUS Server Node. Shorter, higher-level paths define a broad range of folders and the Master Files they contain. Longer paths that extend to a lower level define a narrower range of application folders and Master Files. Paths can extend down to the level of an individual application folder or a single Master File.
To include multiple folders or Master Files in this setting, you can use a short, higher-level path that includes a range of folders, or a series of longer and more detailed paths that identify a very specific group of folders and Master Files. If this setting must include multiple paths, each one must be separated by a semicolon (;) with no space following, as shown in the following example: /EDA/EDASERVE/retail_samples;/EDA/EDASERVE/ibisamp.
IBFS Paths in this setting use the following structure. Only the first two components of the path are required. You can use as many of the remaining path components as you wish to narrow the focus of the path.
/EDA/Node/ApplicationFolder/SubFolder1 ... SubFolderN/Resource
where:
Is the EDA IBFS subsystem. This component is required for all paths. The initial slash (/) before this component is required.
Is the name of the WebFOCUS Server node. This component is required for all paths.
Is the name of the application folder that contains the resources from which data will be added to the data values cache.
Are the names of any folders in the path underneath the application folder that connect to the end point of the path. Include as many folders as are necessary.
Is the end point of the path. If this is the name of a folder that contains one or more Master File resources, then data from all Master Files in the folder is included in the cache. If this is the name of a Master File without the .mas extension, then only data from this specific Master File is included in the cache.
Identifies the IBFS Paths to those resources whose data source values should only be made available to the individual user who retrieved the data.
The paths defined in this setting should only identify resources that contain data that is subject to DBA or row level security restrictions. For calls to cache resources that are not subject to these restrictions, the paths defined in the Data Values Global Cache Paths (IBI_DATAVALUES_CACHE_GLOBALPATHS) setting are used.
If no IBFS Paths are defined in this setting, then no data source values are cached. This is the default value.
If one or more IBFS Paths are defined in this setting, then data values retrieved from all of the resources identified in those paths can be included in the Data Values User Cache for an individual user. If this setting must include multiple paths, they must be separated by a semicolon (;) with no space following, as shown in the following example: /EDA/EDASERVE/retail_samples;/EDA/EDASERVE/ibisamp.
Paths defined in this setting use the IBFS Path format. At a minimum, they must include the /EDA IBFS subsystem component, followed by the name of the WebFOCUS Server Node. Shorter, higher-level paths define a broad range of folders and the Master Files they contain. Longer paths that extend to a lower level define a narrower range of application folders and Master Files. Paths can extend down to the level of an individual application folder or a single Master File.
To include multiple folders or Master Files in this setting, you can use a short, higher-level path that includes a range of folders, or a series of longer and more detailed paths that identify a very specific group of folders and Master Files. If this setting must include multiple paths, each one must be separated by a semicolon (;) with no space following, as shown in the following example: /EDA/EDASERVE/retail_samples;/EDA/EDASERVE/ibisamp.
IBFS Paths in this setting use the following structure. Only the first two components of the path are required. You can use as many of the remaining path components as you wish to narrow the focus of the path.
/EDA/Node/ApplicationFolder/SubFolder1 ... SubFolderN/Resource
where:
Is the EDA IBFS subsystem. This component is required for all paths. The initial slash (/) before this component is required.
Is the name of the WebFOCUS Server node. This component is required for all paths.
Is the name of the application folder that contains the resources from which data will be added to the data values cache.
Are the names of any folders in the path underneath the application folder that connect to the end point of the path. Include as many folders as are necessary.
Is the end point of the path. If this is the name of a folder that contains one or more Master File resources, then data from all Master Files in the folder is included in the cache. If this is the name of a Master File without the .mas extension, then only data from this specific Master File is included in the cache.
Note: Paths to any folders or Master Files identified in the Data Values User Cache Paths setting take precedence over those identified in the Data Values Global Cache Paths setting. This means that if the same path appears in the Global Cache Path setting and the User Session Class Path setting, then data retrieved from the Master Files in that path moves into the User Session Cache, instead of the Global Cache.
Defines the maximum amount of memory allocated to the Data Values Cache. This cache holds the data source values retrieved from queries to the WebFOCUS Server issued by procedures that identify their Master File sources with a two-part name in the FIND parameter syntax. These values are typically assigned to parameters used in Autoprompt Reports, Embedded BI Applications, or to any procedure that includes the FIND parameter syntax to limit the range of available search parameter values. This cache also contains the IBFS path to the Master File and the ID of the user that ran the procedure. The Data Values Cache uses memory on the machine that hosts the WebFOCUS Application Server.
This setting is assigned a value of zero (0), by default, meaning that no memory is allocated to the data values cache, and no data values are cached.
To activate the use of the data values cache, an administrator must assign a number from one (1) to five hundred (500) to this setting. A value of ten (10) megabytes can accommodate the caching requirements for most organizations.
Indicates whether or not report output is cached. The following values are available:
Report output is information retrieved from the WebFOCUS Server in response to report or chart procedure queries and includes data values, column titles, and formatting features.
Note: The Report Output Cache Rule Name field displays a text string that identifies the rule that governs the way in which report output data is cached. These rules determine if a cache is available to everyone, available only to the user that requested the data, or if it can be shared by the members of the group to which that user is assigned.
Application Contexts settings define the context root locations of various WebFOCUS components.
Note: Values assigned to the Application Context settings are adjusted automatically when your installation is configured to use a reverse proxy server. In order for this change to take effect, the URL for WebFOCUS must be assigned to the WFproxyURL setting in the configuration of your proxy server.
Specifies the context root for the local online Help web application.
The default value is /ibi_help. It is established during the product installation, and identifies the context root to which the local online Help web application is assigned, by default.
To assign the local online Help web application to the WebFOCUS context root, replace the default value with a new value that begins with the WebFOCUS Context, and is followed by the Help Context. For example, /ibi_apps/ibi_help.
To assign the online Help web application to any other context root, replace the default value with a new value that identifies the context root in use in your organization.
The context root defined in this setting only applies to the local host. If the Help Proxy Host and Port (IBI_HELP_PROXY_HOST) setting identifies an external sever name and port, you must also identify the context root for that external server in the Help Proxy Context (IBI_HELP_PROXY_CONTEXT) setting.
Specifies the context root of the remote online Help web application in the target environment identified in the Help Proxy Host and Port (IBI_HELP_PROXY_HOST) setting.
This setting must remain blank if no remote online Help web application is identified in the Help Proxy Host and Port (IBI_HELP_PROXY_HOST) setting. When this setting is blank, no context root is identified for the remote online Help web application. This is the default value.
This setting must identify a context root if a remote online Help web application is identified in the Help Proxy Host and Port (IBI_HELP_PROXY_HOST) setting.
Specifies the name and port number of the external server where a remote online Help web application is installed.
If this setting is blank, no remote online Help web application is available. This is the default value.
If this setting contains a server name and port number, a remote online Help web application is available on the server name and port specified. The remote application does not need to be on the same server as the WebFOCUS web application.
When you specify a value in this setting, you must also specify a value in the Help Proxy Context (IBI_HELP_PROXY_CONTEXT) setting. It cannot remain blank.
When you identify a remote online Help web application by assigning values to these two settings, the Help Servlet acts as a proxy, and directs Help system calls to the host identified in this setting. The term Help Proxy indicates that the values in the settings that include it apply to a remote online Help web application.
If selected, this check box activates the use of Secure Sockets Layer (SSL) security on all calls directed from the WebFOCUS Client to the remote online Help web application located on the remote host identified in the Help Proxy Host and Port (IBI_HELP_PROXY_HOST) setting.
If cleared, calls to the remote online Help web application, do not use SSL security or encryption. This is the default value.
Note: This setting does not affect calls from WebFOCUS or any other application to Help systems located on a local server. All customer-facing applications are SSL-enabled, by default, in compliance with security policy. However, if the WebFOCUS Client is configured to access a Help system on a local intranet server, this setting should be selected if the Help system on that intranet server is also configured to use SSL.
Specifies the context root for ReportCaster content, previously /rcaster, by default. The current default value is /ibi_apps.
Specifies the context root for WebFOCUS web applications. The default value is /ibi_apps.
Identifies the default URL for an installation of WebFOCUS.
This value uses the format:
http(s)://host:portwhere:
This value is optional, and it should be excluded if the URL uses the default port for the protocol it uses in the scheme, which is port 80 for URLs using the http protocol or port 443 for URLs using the https protocol.
The host name and the port number are assigned to this value automatically during the product installation, and they identify the host name or IP address and port number used by your organization. Product components use the URL defined in this setting to access WebFOCUS.
Specifies the context root for the WebFOCUS servlet, previously /ibi_apps, by default. The current default value is /ibi_apps/WFServlet.ibfs.
Application Directories settings define the directories in which various files are located.
Specifies the location of the Application Namespace root directory used by the WebFOCUS installation. The default location is drive D:/455/ibi/apps, unless a different directory was specified during installation.
Specifies the location of the directory where the Change Management Export Package will be placed. The default location is drive:/ibi/WebFOCUS82/cm/export, unless a different directory was specified during installation.
Specifies the location of the directory from which the Change Management Import Package will imported. The default location is drive:/ibi/WebFOCUS82/cm/import, unless a different directory was specified during installation.
Specifies the number of days the files in the logs directory will be retained. The default value is 10 days.
Specifies the location of the directory where files will be transferred during source control operations, such as adding files to source control, checking files in, or checking files out of the source control repository. The default location is drive:/ibi/WebFOCUS82/scm.
This location can be customized. The directory path needs to be on the same machine where WebFOCUS is installed and a UNC path is currently not supported.
Specifies the location of temporary files when running a request. For example, redirected requests are written to this location. The default location is drive:/ibi/WebFOCUS82/temp, unless a different directory was specified during installation.
Specifies the location of the directory used for WebFOCUS Client traces displayed in the Session Monitor and the Session Viewer. The default location is drive:/ibi/WebFOCUS82/traces, unless a different directory was specified during installation.
WebFOCUS directs all diagnostic output to the logs directory. The default location is drive:/ibi/WebFOCUS82/logs, specified with the log4j2.xml file during installation.
Specifies the number of days the files in the traces directory will be retained. The default value is 10 days.
BI Portal settings configure the display and behavior of the BI Portal.
Identifies the default home page.
In this setting, /ibi_apps is the main alias or context under which all WebFOCUS webpages are located. This is the typical context in most installations, but your local installation may use a different context. If that is the case, the name you use in your installation will appear in the label for this setting instead.
Note: Don't use the term /bi as the main alias or context. This is a reserved term, and its use as an alias or context prevents the proper display of the Administration Console and Security Center.
The options in this setting direct users to one of the following locations, by default.
When you select this option, the browser address bar displays only the basic context when the custom welcome page opens. It does not display the full URL of the custom welcome page.
This field contains only that portion of the URL for the custom welcome page that comes after the main alias or context. The main context is automatically added to the value in this field to create a full URL when redirecting users to the custom welcome page identified in this field.
For example, if you use a basic portal for the custom welcome page, and the full URL is:
Server01.ibi.com:8080/ibi_apps/bip/portal/Sales_Performance.
bip/portal/Sales_Performance.
Note: You can use basic portals only if your product version supports them, and the Basic Portal option is enabled.
If you use a collaborative portal for the custom welcome page and the full URL is:
Server01.ibi.com:8080/ibi_apps/portal/sales_october/sales_october.
The value in the /ibi_apps/ field would be:
portal/sales_october/sales_october.
Note: You can use collaborative portals only if your product version supports them, and the Collaborative Portal option is enabled.
If you chose to use the Portals Home Page as the custom welcome page, the value in the /ibi_apps/ field must be:
portals.
Note: The Portals Home Page will be populated with basic or collaborative portals only if your product version supports these portal types, and the Basic Portal option and the Collaborative Portal option are enabled.
Regardless of the values you assign to this setting, users can open any home page by typing one of the following values in the browser address bar:
In the webfocus.cfg file, the Redirect /ibi_apps to setting maps to the IBI_HOME_PAGE_CONFIGURATION setting.
In the webfocus.cfg file, the Show Legacy Home Page option in Banner Links check box maps to the IBI_HOME_PAGE_LEGACY_LINKS setting.
In the webfocus.cfg file, the /ibi_apps/ field maps to the IBI_DEFAULT_WELCOME_PAGE setting.
This information is not yet available.
Activates the display of a warning message advising users that their session will expire due to inactivity, and that any unsaved work will be lost. When this check box is selected, a warning message appears on the Home Page, the Security Center, and on portals. When it is cleared, no warning message appears. This check box is selected, by default.
Defines the number of minutes that a timeout warning message is displayed. This value is relevant only if the Enable Auto Sign-out (IBI_AUTO_SIGNOFF) check box is selected. A value of two minutes is assigned to this setting, by default.
When displayed from the Home Page or the Security Center, the warning message also identifies the time remaining until the session will end. When displayed from a portal, the warning message does not identify the remaining time.
Determines whether the first workspace listed in the Resources tree opens automatically when you open the BI Portal. If this check box is selected (True), the first workspace opens automatically when you open the BI Portal. If this check box is cleared (False), the first workspace remains closed when you open the BI Portal. This check box is cleared, by default.
Identifies the maximum number of public users that can open a session at any one time. Public users start a session without presenting credentials and are granted access privileges defined in the Anonymous group.
When the value in this setting is zero (0), there is no limit on the number of public users. This setting is assigned a value of zero (0), by default.
When a value is defined in this setting, any public user that attempts to open a session after this limit is reached receives a warning message and is unable to complete the request.
Note: This setting is only relevant to the Enterprise Edition, which is the only edition that supports anonymous user access.
Identifies the maximum number of WebFOCUS Designer or InfoAssist visualizations generated from procedures or from Auto Drill, Drill Anywhere, InfoMini, or Insight requests that a single user can keep open simultaneously. When the number of open visualizations equals this limit, the next request to open a new visualization is not completed, and an error message is logged.
This value of this setting is zero (0), by default, indicating that there is no limit on the number of simultaneous visualizations a user can open. To impose this limit, an administrator must enter a value that defines the maximum number of open visualizations.
Enables the display of a custom sign-in page for users. The default value is False.
Defines the IBFS path to the workspace that serves as the default location for connections to data, visualizations, or other resources created by individual users from the Home Page, the My Workspace view, the Getting Started carousel, or any other location outside of a defined workspace.
When a user working outside of a defined workspace selects the Get Data button, the Visualize Data button, or one of the Plus [+] button menu options, the workspace identified in this setting serves as the start location for the selected operation within the Repository, and it is presented, by default, in the Save dialog box as the location to use when first saving new content.
By default, the value in this setting is blank, and My Workspace, located at IBFS:/WFC/Repository/MyWorkspace/, serves as the default workspace repository path. This path is automatically assigned to the URL that launches the operation, and it causes the Workspaces > My Workspace > My Content path to appear in the Save dialog box as the path to the folder where new content created outside of a defined workspace can be saved.
You can replace this default location with a valid IBFS path to a different workspace or to a top-level folder in the Repository. This path is automatically assigned to the URL that launches the operation, and unless the content draws on a data connection assigned to a defined workspace, it causes the Workspaces > My Workspace > My Content path to appear in the Save dialog box as the path to the folder where new content created outside of a defined workspace can be saved.
If you enter an invalid IBFS path or a path to a workspace that does not exist, you receive an error message. The path can only point to a workspace or top-level folder, it cannot point to a lower level location.
For more information about how to configure this setting, see How to Configure a Default Workspace Repository Path.
Notes:
Defines the IBFS path to the workspace whose title and contents are displayed in the carousel that appears at the top of the Home view of the WebFOCUS Home Page.
A workspace whose name matches that of the final folder in the path must be present in the IBFS file system. If there is no corresponding workspace, or if the name of the workspace does not match the name of the final folder in this path, there is no connection and the carousel does not appear.
The IBFS:/WFC/Repository/Getting_Started path is the default value for this setting. This path points to the Getting Started workspace and assigns the Getting Started title to the carousel. This default value ensures that new users see orientation resources as soon as they open the application.
The integrated installation loads the Getting Started workspace automatically. It is also present, by default, in Cloud instances. Other installations and instances of WebFOCUS do not load this workspace, even though they do assign the default path to this setting. Because there is no Getting_Started workspace in these installations, the Getting Started carousel does not appear, even though the path to it is defined in this setting.
If a single blank space appears in the field for this setting, no path is defined, and the Getting Started carousel does not appear in the Home View even if a Getting_Started workspace is available.
Therefore, by clearing the default value, typing a single blank space in this field, and saving your changes, you can hide the Getting Started carousel. When you sign out and sign in again after making this change, the Recents carousel appears in place of the Getting Started carousel. The blank space prevents the Administration Console from overriding the otherwise empty field with the default path when you save your changes and close the Administration Console if you opened it from the WebFOCUS Home Page.
If a path to an alternative workspace appears in the field for this setting, the carousel displays the title of that alternative workspace and the resources contained in the top-level folder of that workspace.
You can substitute an alternative workspace for the Getting Started workspace by typing the IBFS path to the alternative workspace in this field and saving your changes. When you sign out and sign in again, a carousel with the Title and resources of the alternative workspace appears in place of the Getting Started carousel.
The IBFS path must begin with the term, IBFS:/WFC/Repository. You can then type a slash (/) followed by the name of the new workspace that contains the resources you wish to display in the Getting Started carousel. You must separate workspaces and folders in the path with a slash (/) and not a backslash (\). The Title linked to the Name of the alternative workspace appears as the new title of the carousel. The name of the final folder in the IBFS path must match the case and spelling of the Name assigned to the workspace, not the Title. The name of the final folder must also include any underscores or other special characters automatically added to the Name of the workspace in order to ensure that it conforms to IBFS format rules.
You can restore the default value to this setting at any time by removing all characters and blank spaces from this field and saving the page. When you sign out and sign in again, the default path to the Getting Started workspace is reassigned to this setting automatically.
This feature is optional. When selected (True), data from the JavaScript and cascading style sheet resource files, required by the WebFOCUS Home Page and WebFOCUS Designer tools, is combined into XML inline resource bundle files in order to improve system performance on slow networks. When cleared (False), this feature is not activated. This check box is cleared, by default.
Determines when users receive simplified error messages. In simplified error messages, error details can be suppressed to avoid disclosing sensitive or technical information to end users. When a simplified error message is delivered to a user, the fully detailed error message appears in the event.log to support administrator troubleshooting. Error messages in the event.log are preceded by an identifier in the form IBFS-YYMMDD_hhmmss-n, where n is the sequence number for multiple messages generated during the same second.
The simplified error message displayed to the user contains the event.log entry identifier.
Each option in the Message Detail list specifies the highest error level for which end users will receive detailed messages. The options are:
Administrators can customize the styling of a simplified error message by creating and editing the custom template on which it is based. To create a custom error message template, copy the webfocus_ibfs_error.xml file from the prod directory to the custom directory. Both the prod and the custom directories are found in the drive:\ibi\WebFOCUS82\client\wfc\etc\ directory. Make all edits to the copy of the webfocus_ibfs_error.xml file found in the custom directory.
Note: Users with the Display Administration Console (opWFAdminConsole) or Desktop Connect (opDTConnect) privilege always receive the detailed error messages.
Specifies the URL used to access Mobile Favorites. If left blank, the default Mobile Favorites is used.
Specifies whether confirmation will be requested when a user moves a folder by drag and drop. This check box is selected (True), by default.
Controls the public session timeout value, which limits the amount of time that public users can remain idle before a session timeout takes place.
This setting is defined in minutes, and is assigned a value of 120 minutes, by default.
This setting applies to public users only. The timeout limit for all other users is defined in the Session Timeout (minutes) setting. Public users start a session without presenting credentials and are granted access privileges defined in the Anonymous group.
Note: This setting is only relevant to the Enterprise Edition, which is the only edition that supports anonymous user access.
Defines how deeply searches for session privileges reach into the IBFS:/WFC/Repository subsystem during user the sign-in process. If you wish to check for session privileges only on the workspace folder, for example, IBFS:/WFC/Repository/Sales, use the default search depth, 1. To search for session privileges on subfolders directly beneath the workspace folder, use a search depth of 2.
Note: Search depth may be set to any level, but increasing the depth may cause performance issues. It is strongly advised that you make the search depth value as low as possible.
For more information about session privileges, see Session Privileges.
Controls the session timeout value, which limits the amount of time that users who signed in with valid credentials can remain idle before a session timeout takes place.
This setting is defined in minutes, and is assigned a value of 120 minutes, by default.
This setting applies to all users except public users. The timeout limit for all public users is defined in the Public Session Timeout (minutes) setting.
Specifies a custom message that displays in the Messages dialog box when a user signs in. You can enter plain text or HTML tags for text, links, and images, into this field. If you leave this field blank, which is the default value, the Messages dialog box does not display.
The following HTML tags may be used in the sign-in message:
<l>, <br>, <b>, <u>, <a href>, </a>, <img>.
This information is not yet available.
Specifies the type of files that you can upload to the BI Portal. Files that do not use one of the extensions listed in this setting cannot be uploaded to the BI Portal. The list includes the following file extensions, by default:
.png, .ppt, .pptx, .sty, .svg, .txt, .xls, .xlsx, .xml, .zip, .ely
Establishes the default layout for new pages in the BI Portal.
This setting is relevant only if your product version supports collaborative portals, and the Collaborative Portal option is enabled.
The default layout defined in this setting determines the way in which items, such as reports or charts, are organized on the page. Fluid Canvas, the default value, automatically arranges content evenly and redistributes space as you add more items. The other option, Single Area, does not establish a grid, and allows you to place items where necessary.
This setting is relevant only to basic portals. It is not relevant to collaborative portals.
Determines whether basic portals are supported.
Basic portals deliver the full range of reporting, charting, and other features, and are managed from the Portals node.
When this check box is cleared (False), the Portals node does not appear under the Resources tree, and users are unable to create or edit basic portals. However, because data from previously-created basic portals remains in the Repository, users can run a previously-created portal by typing the URL for it directly into the browser address bar. Users can also continue to import change management packages that contain basic portals. This is the default setting.
When this check box is selected (True), the Portals node appears under the Resources tree, and users can create, edit, and run basic portals.
Determines whether collaborative portals, which are also identified as V4 portals, are supported.
Collaborative portals deliver the full range of features offered by a basic portal, such as reporting and charting. They also include responsive-design page templates, the ability to create and maintain independent pages, and the ability to create and maintain blogs, which are interactive messaging components that can be assigned to portals and pages.
The check box in this setting is cleared (False), by default.
When this check box is cleared (False), the Collaborative Portal, Portal Page, and Blog action buttons in the Other tab Action Bar of the Workspaces area on the WebFOCUS Home Page, and the Collaborative Portal, Portal Page, and Blog commands in the workspace shortcut menu on the Legacy home page are not visible to any user.
Collaborative portals created while this check box was selected remain visible and available to administrators, workspace developers, and to any other user whose role in the workspace that contains them includes the Delete Resource (opDelete) privilege. The ability to view, run, edit, and delete previously-created collaborative portals supports administrators and developers in their efforts to create Designer portals, which are also identified as V5 portals, based on previously-created collaborative portals after this setting has been cleared.
When this check box is cleared, users have the following privileges as determined by the group to which they are assigned:
When this check box is selected (True), the Collaborative Portal, Portal Page, and Blog action buttons in the Other tab Action Bar of the Workspaces area on the WebFOCUS Home Page, and the Collaborative Portal, Portal Page, and Blog commands in the workspace shortcut menu on the Legacy home page, are visible to administrators when working in any workspace, and to developers when working in the workspaces to which they are assigned.
When this check box is selected, users have the following privileges, as determined by the group to which they are assigned:
Change Management settings determine which file types can be exported during the change management process, the format of the exported file, and whether some legacy functionality is preserved.
Note: The locations of change management export and import packages are determined by the Application Directories Settings. For more information, see Application Directories Settings.
Determines, by file extension, which files from the WebFOCUS Server or the web will be included in exports created by the change management feature. The values included, by default, are acx, bmp, css, fex, gif, htm, html, ico, jpe, jpeg, jpg, js, mas, mnt, png, sty, and svg.
When this check box is selected (True), the default value for this setting, the following information is preserved for all items imported to an installation of WebFOCUS through the Change Management utility:
These values appear on the General tab of the Properties dialog box.
When this check box is cleared (False), the date and time of the change management import and the ID of the user who ran it override these original values and are assigned to all three properties of items imported through the Change Management facility.
When selected (True), the export package contains the original hrefs. The original hrefs are needed when using change management to move content that has been migrated from WebFOCUS 7, or ReportCaster schedules, from one WebFOCUS 8 environment to another WebFOCUS 8 environment. This setting ensures that the -INCLUDEs and drill downs in code migrated from WebFOCUS 7 continue to work, and ReportCaster schedules, which reference FOCEXECs by handle, continue to work. This check box is cleared (False), by default.
When this check box is selected (True), the export package is compressed and delivered in a zip file.
Select an option from the drop-down menu to specify the name format of the zip file.
Client settings configure miscellaneous WebFOCUS Client options.
Enables the use of external JavaScript files, instead of embedding the JavaScript within the HTML output file, in order to improve performance at runtime. If set to NO, enables the use of an active report or document (format AHTML) in a fully disconnected mode that supports the browser Save As option. The default value is NO.
Note: For more information on the use of external JavaScript files in the HTML output, see the Active Technologies User's Guide.
Controls whether to pass a DBA password to the WebFOCUS Server on each request.
Permitted values are:
For more information, see DBA Password Settings.
Identifies the location of the resource used to render output in the Excel 2007 file (.xlsx) format.
The Excel Server URL drop-down list contains two options:
Specifies the number of prestarted agents available for graph processing. The default value is 10 agents.
Identifies the location of the resource used to render output in graph image file format.
This option is required on z/OS. In all other environments, JSCOM3 is the recommended configuration option.
Note: If your configuration must use a different resource, contact the Customer Support Service Team to obtain assistance.
Turns on the persistent ampersand (&&) feature. By default, this check box is selected, (True). To disable this feature, clear this check box (False). The persistent ampersand feature allows you to persist && variables for the duration of the browser session.
Determines whether a date and time are automatically removed from the end of the file name of all redirected reports using the Microsoft Excel spreadsheet format, regardless of the values assigned to the related Redirection setting and Save Report setting.
If this check box is cleared (False), the Date and Time are automatically added to the file names of redirected Excel reports. This is the default setting.
If this check box is selected (True), the Date and Time are not added to the file names of redirected Excel reports. Select this option when you must override the default system behavior and suppress the addition of a unique date and time to Excel report file names.
For information on the role of this setting in configuration with other report output redirection settings, please see Redirecting and Saving File Output.
With the Dynamic Language Switch feature, the default user interface language for a session is based on the language of the browser, or by setting the IBIWF_language=nn parameter in the URL (where nn is the ISO language abbreviation).
The WebFOCUS Client uses this default setting to control the display language when the browser language of the user is not one of the available options from the Select Language drop-down list during sign-in, or if no parameter is set in the URL call.
For possible values for the ISO language abbreviations, see the WebFOCUS National Language Support for International Computing manual.
Controls how many WebFOCUS Server message lines will be accumulated before WFServlet stops processing the request and displays error message 32100:
Reporting Server messages exceeded IBIF_max_messages, report retrieval aborted.
Messages include -TYPE commands, &ECHO=ALL variables, and errors or warnings from a data adapter. The setting protects against the situation where the Java VM executing WFServlet runs out of memory. The default value is 20000 lines. The IBIF_max_messages setting can be passed with the request, in which case it overrides the value set in the Console. When debug mode is enabled in App Studio, a value of 50000 is passed with each request. A value of 0 indicates that no limit exists.
Globally sets redirection on or off. Possible values are:
Defines the maximum size, in bytes, allowed for responses in the original window when using Internet Explorer.
Responses larger than the size identified in this setting will be launched in a new window, to ensure that it will open without errors. If this setting is blank, no maximum limit is applied. The default value is 400,000 bytes.
Identifies the range of objects that are included when you share an unpublished procedure or object with other users. You can select one of the following options.
Referenced objects are shared in Run mode only.
When you stop sharing an unpublished procedure or object, you also stop sharing its referenced objects. However, any referenced objects shared independently of the procedure or object, remain available to their originally shared users and groups. Referenced objects assigned to multiple shared procedures or objects continue to be shared in Run mode until all of the procedures or objects in which they appear are no longer shared.
Google API v3 does not require an API key. Therefore, this field must remain blank.
Determines the version number of the Google Maps™ API. Can be an integer or decimal value. An integer value represents a stable version. Currently, only Google Maps API v3 is supported.
This setting is only applicable on UNIX. In order to display NLS characters on a report with server-side graphics, you must set this parameter to the appropriate UNIX locale encoding (for example, en_US).
Determines if Master Files retrieved from the WebFOCUS Server include the Master File title and suffix, or not. From the drop-down menu select:
Enables the display of Resource Governor advise messages for the servers you select from the list in this setting. When enabled, redirection is turned on for all report formats when the WebFOCUS Server returns any Resource Governor advise messages to display to the user. You can access the redirection settings by selecting Redirection Settings under the Configuration menu of the Administration Console. By default, the setting is disabled.
The following syntax enables you to include code to be executed on the WebFOCUS Server by the WebFOCUS Client.
_site_profile=command
where:
Is any valid WebFOCUS Server syntax. The site profile is not processed during a WebFOCUS Server sign-in, or when a procedure scheduled in ReportCaster is run. It is only processed when procedures are run on the WebFOCUS Server.
The site profile can also be added directly to the drive:\ibi\WebFOCUS82\client\wfc\etc\site.wfs file.
Deletes files from the temporary directory. Files are deleted if they are older than the number of seconds specified. The default value is 900 seconds.
The following syntax enables you to include code to be executed by the WebFOCUS Client and the ReportCaster Distribution Server. This differs from the _site_profile, which is only executed by a WebFOCUS Client request.
_universal_profile=command
where:
Is any valid WebFOCUS Server syntax.
A _universal_profile should not include any logic or constructs that will execute only on the WebFOCUS Client. For example, http header variables should not be included, because they are available to the WebFOCUS Client, but not to the ReportCaster Distribution Server.
The universal profile can also be added directly to the drive:\ibi\WebFOCUS82\client\wfc\etc\site.wfs file.
Specifies the qualified name of a plug-in class to be invoked by the WebFOCUS Servlet. By default, this variable is set to ibi.webfoc.WFEXTDefault, which is the default plug-in supplied with WebFOCUS that contains several useful functions.
Is a fully qualified Java class that does the transin and transout processing (processing of a request to and output returned by the WebFOCUS Server) for a plug-in for the Servlet version of the WebFOCUS Client. This class must implement the WFTransInOutInterface Java class. For example, one use of this class can be to enable data that is passed between the WebFOCUS Server and the Servlet to be parsed for bi-directionality (left/right versus right/left strings). This setting is blank, by default.
Deferred Reporting settings determine how deferred reports are processed.
When this check box is selected, the default setting, users are prompted to optionally customize the description for the deferred report, which defaults to the title of the report being run deferred. This occurs whenever the description defined in the parameter (IBIMR_defer_description) has not been submitted with the run deferred report request.
When this check box is cleared, the title of the report being submitted to run deferred is assigned to the deferred report description automatically, and no prompt appears.
When this check box is selected, the default setting, the Deferred Request Submitted window displays to confirm a successful deferred request. The user clicks OK to close the window.
When this check box is cleared, the Deferred Request Submitted window does not display.
Activates an automated message that prompts the user to confirm the deletion of a deferred report. When this check box is selected, which is the default, a message prompts the user to confirm the deletion, so a deletion requires two clicks. When this check box is cleared, the user is not prompted to confirm the deletion, so a deletion requires only one click. Making a large number of deletions is faster when suppressing the confirmation message.
Encryption settings determine the encryption provider and encryption and token key locations.
Specifies the encryption provider used to encrypt passwords stored in WebFOCUS files. All options are based on the Advanced Encryption Standard.
The following options are supported:
AES 128 Encryption with Internal Key
This is the default value.
AES 192 Encryption with Internal Key
AES 256 Encryption with Internal Key
AES 128 Encryption with External Key
AES 192 Encryption with External Key
AES 256 Encryption with External Key
If you select an option that specifies an internal key, encryption is based on a key that is embedded within WebFOCUS.
If you select an option that specifies an external key, you must create that key, assign it to a file named key.cfg, and save that file in the following directory:
drive:\ibi\WebFOCUS82\config
For more information about creating an external encryption key, see Default TIBCO WebFOCUS Encryption and AES Encryption.
ESRI settings define the connection to the local application that supports Esri-based maps.
Identifies the path to the internal ArcGIS JavaScript API Source used to develop Esri-based maps. This setting is blank, by default, meaning that the use of an internal source is not activated. To activate the use of an internal ArcGIS JavaScript API to develop Esri maps, type the path to it in this setting, typically, /web_resource/arcgis_api.
The default API that should be referenced by this setting is the ArcGIS API for JavaScript, version 3.28, which can be found at https://js.arcgis.com/3.28/. The ArcGIS JavaScript API zip file is available for download from https://developers.arcgis.com/downloads/#javascript. Access to this file requires a valid user ID and password which you must establish with ArcGIS.
For more information about the Esri ArcGIS Javascript API, see https://developers.arcgis.com.
For more information about how to configure Esri On Premise for InfoAssist, see the Configuring an Esri On Premise Environment topic in the TIBCO WebFOCUS ® InfoAssist User’s Manual.
For more information about how to configure Esri On Premise for App Studio, see the Installing and Configuring Esri on Premise topic in the TIBCO WebFOCUS® App Studio User's Manual.
Filters settings enable protections against common web security vulnerabilities.
When selected (True). the default setting, this check box allows legacy WFServlet requests to run without requiring or using a cross-site request forgery (CSRF) security token.
Requires all POST requests to provide a cross-site request forgery (CSRF) security token to be validated, except for legacy requests, if the exception is allowed by the IBI_CSRF_Allow_Legacy setting. This check box is selected (True), by default.
Specifies the name of the cross-site request forgery (CSRF) security token. The default value is IBIWF_SES_AUTH_TOKEN.
Specifies the default cache control response for static content accessed by the web application. The default value is public, max-age=2592000 (30 days). Consult Customer Support Services for assistance before altering this setting.
When this check box is selected (True), the default value, this setting adds the cache-control response header and the expires response header to static files that use the *.htm, *.html, bindowsBundle.jsp, *.css, *.gif, *.png, *.jpeg, *.jpg, *.txt, *.htc, and CombineImageServlet format.
You can modify the cache-control response header with the Cache Control Header (IBI_HTTP_Response_Header_Cache_Control) setting. You can modify the expires response header with the Expires Header (IBI_HTTP_Response_Header_Expires) setting. However, you must consult Customer Support Services for assistance before altering this setting or either of these other settings.
Specifies the default expiration response header for static content served by the web application. The default value is 2592000 (30 days). Consult Customer Support Services for assistance before altering this setting.
Defines the maximum size for data files uploaded to the Repository or the EDA Server. Data files that are larger than the value in this setting cannot be uploaded. The default value is 2048 megabytes. The maximum allowable value is 10240 megabytes. A value of -1 deactivates this setting.
When selected (True), this check box specifies that RESTful Web Services functions which create, update, or delete can only be run with the HTTP POST method.
This check box is selected, by default.
Note: If the Cross Site Request Forgery Protection (IBI_CSRF_ENFORCE) setting is set to True, then RESTful Web Services also require a CSRF token. The token name is specified with the Cross Site Request Security Forgery Token (IBI_CSRF_Token_Name) setting.
Defines the maximum amount of memory that data from files uploaded to the Repository or the EDA Server can occupy. During the upload process, data moves into memory until it reaches the limit defined in this setting. Any additional data is temporarily cached to disk. The default value is 256 megabytes. A value of -1 deactivates caching.
When this check box is selected, an XCONTENT TYPE header is included in HTTP Response messages issued from the WebFOCUS Server. This is the default value.
By including an XCONTENT TYPE header, a server instructs the browser receiving an HTTP Response message to accept the content type assigned to the message instead of mime sniffing the data it contains and overriding the previously-assigned content type. The server asserts that the content type assigned to the message is reliable, and that the data in the message can be displayed using the content type assigned to it.
The XCONTENT TYPE header also protects the browser that receives it from cross-site scripting attacks in which mime sniffing an HTTP Response message causes a browser to execute unintended programs based on executable code hidden within its data.
When this check box is cleared, HTTP Response messages issued from the WebFOCUS server do not include the XCONTENT TYPE header, and browsers receiving it are vulnerable to cross-site scripting or other attacks. Because changing the default value assigned to this setting leaves users open to this vulnerability, we recommend that you consult Customer Support Services before doing so.
If the Microsoft Internet Explorer cross-site scripting filter is enabled in the Cross Site Scripting Protection (IBI_XSS_PROTECTION) setting, the value assigned to this check box specifies the response the browser makes to a cross-site scripting attack. Permitted values are:
If the Cross Site Scripting Protection Block Mode (IBI_XSS_MODE_BLOCK) check box is clear, (False), the following value is returned:
X-XSS-Protection: 1
Internet Explorer will attempt to make minor corrections to the webpage if it detects a cross-site scripting attack. This is the default value.
If the Cross Site Scripting Protection Block Mode (IBI_XSS_MODE_BLOCK) check box is selected, (True), the following value is returned:
X-XSS-Protection: 1; mode=block
Internet Explorer will not render the webpage at all if it detects a cross-site scripting attack.
Specifies whether the Microsoft Internet Explorer cross-site scripting (XSS) filter is enabled or disabled. Valid options are:
Enables the browser XSS filter by returning an HTTP response header of:
X-XSS-Protection: 1
Disables the browser XSS filter by returning an HTTP response header of:
X-XSS-Protection: 0
This is the default value.
Does not return an HTTP response header to the browser. The browser relies on its default XSS filter settings for the browser security zone.
The Cross Site Scripting Protection (IBI_XSS_PROTECTION) setting works in conjunction with the Cross Site Scripting Protection Block Mode (IBI_XSS_MODE_BLOCK) setting.
Note: Because application development requires HTTP requests to use characters that can be misinterpreted as a cross-site scripting attack, this filter must be disabled in a development environment. You can set Cross Site Scripting Protection (IBI_XSS_PROTECTION) to False (the default value) or Off. If Cross Site Scripting Protection (IBI_XSS_PROTECTION) is off, the browser security settings will determine if Internet Explorer invokes its cross-site scripting protection. This is required only for development purposes. If you maintain a separate production environment, you may set Cross Site Scripting Protection (IBI_XSS_PROTECTION) to True in that installation.
Multiple Reports settings configure options for multi-frame reports.
Controls whether a sequence number is appended to the end of the names on the TOC when IBIWF_mreports=INDEX. On appends a sequence number of 1 (for the first report generated) to n (for the last report generated). Off omits a sequence number. Only the text specified by the IBIWF_mprefix setting applies. The default value is On.
Used to name each frame in a multi-frame report. The name of each frame will be this value followed by an index number. For example, for two frames with IBWIF_mframename set to MYFRAME, the two frames will be named MYFRAME1 and MYFRAME2. The default value is MREPORT.
Specifies whether the report frames in a multi-frame report should appear in the order that the columns are specified in the request or the reverse order. Possible values are FORWARD and REVERSE. The default value is FORWARD.
Specifies up to 50 characters of descriptive text that precedes a sequence number and identifies a report in a TOC. Used to create hyperlink names in index reports. For example, if the value is MyReport, the hyperlinks will be composed of the name MyReport followed by an index number starting with 1. The default value is REPORT.
Note: Do not use this setting if IBIWF_mreports is set to FRAME.
Specifies the maximum number of columns per page in multi-frame reports. The default value is 1 column.
Specifies whether to create an index report, a multi-frame report, or a standard report. Possible values are OFF, INDEX, and FRAME. The default value is Off.
Is the number of vertically stacked reports when the IBIWF_mreports setting is FRAME. This setting is blank, by default.
On-Demand Paging settings configure On-Demand Paging options.
Controls display of On-Demand Paging (ODP) reports.
When this check box is selected (Yes), the ODP report is displayed. This check box is selected, by default.
When this check box is cleared (No), the ODP report is not displayed. Instead, a page with a message displays. You can specify the message text in the IBIODP_disable_msg setting. If you do not, a blank line displays.
This setting contains the message that will be displayed instead of the ODP report output when IBIF_odpenable is set to No. The default value is a blank line (\n).
HTML tag for highlighting text found as a result of a search in an ODP report. The default value is <u>, to underline the text.
Controls the action of the back button in the Web Viewer.
OLAP settings configure OLAP options.
These settings are visible only if the Enable OLAP check box is selected. The Enable OLAP check box appears on the Other Settings page of the Administration Console Configuration tab.
Specifies the location of the OLAP panel. Possible values are TOP and BOTTOM. The default value is BOTTOM.
Enables administrators to preview and set a new color scheme for OLAP components, such as the OLAP Control Panel. The default value is BLACK.
Enables administrators to create a name to preview and set a new color scheme for OLAP components, such as the OLAP Control Panel. The default value is NEUTRAL.
When the check box is selected, the OLAP Control Panel is permanently displayed while running an OLAP report. This check box is cleared, by default.
Specifies whether to display the OLAP Save the data in an Excel fie option. This check box is selected, by default.
Specifies whether to display the OLAP Save the data in an Excel 2000 file option. This check box is selected, by default.
Specifies whether to display the OLAP Save the data in an Excel 2000 file with formulas option. This check box is selected, by default.
Other settings determine miscellaneous configuration settings.
Type WF_USER in this field to send this cookie back to the browser. This allows the WFSIGNON action when authenticating with the WebFOCUS Server.
Specifies the email server used to email WebFOCUS Mobile links.
Activates the use of the UOA_CACHECOMS table in background operations.
The UOA_CACHECOMS table, located in the WebFOCUS Repository database, synchronizes multiple instances of WebFOCUS within a distributed environment by holding entries recording changes made in one instance of WebFOCUS until an internal polling process retrieves and distributes these changes to the other instances. A separate database operation polls the UOA_CACHECOMS table and clears the table of entries that contain the previously-distributed changes once every minute.
When this check box is selected (True), the UOA_CACHECOMS table and its related database processes are activated. This is the default value.
When this check box is cleared (False), the UOA_CACHECOMS table and its related database processes are not activated.
You can clear this check box to suspend the use of this table and its related database operations when you need to enhance performance.
Enables the use of infographics within your product installation.
When this check box is cleared, the use of infographics is disabled for everyone in the organization, including administrators and those users working with a role that includes the Display Easel.ly Link (opEaselly) privilege. By clearing this check box, administrators can override the assignment of the Display Easel.ly Link (opEaselly) privilege, and disable the use of infographics throughout their organization.
When this check box is selected, the use of infographics is enabled for administrators and for users working with a role that includes the Display Easel.ly Link (opEaselly) privilege. This is the default value.
When the use of infographics is disabled, the Utilities menu on the WebFOCUS Home Page, or the Quick Access menu on the Hub does not display the WebFOCUS Infographics option, eliminating the quick link to the Easel.ly website. The shortcut menu does not display the New InfoGraphic option, preventing users from creating new procedures based on Easel.ly template files, even if those files were downloaded directly from the Easel.ly website.
When the use of infographics is enabled, the Utilities menu on the WebFOCUS Home Page, or the Quick Access menu on the Hub displays the WebFOCUS Infographics option that links users directly to the Easel.ly website, where they can download Easel.ly templates that can then be uploaded to a workspace. In addition, when users right-click uploaded Easel.ly template files, the shortcut menu displays the New Infographic option, enabling users to open Easel.ly template files and create new procedures based on them.
The Display Easel.ly Link (opEaselly) privilege is typically available to administrators and to users assigned to the Advanced User or Developer groups within a workspace.
Note: The value in the Enable Legacy Features (IBI_ENABLE_LEGACY_FEATURES) setting takes priority over the value in this setting. Therefore, both the Enable Infographics check box and this check box must be selected in order to make infographics available.
Enables the use of legacy features.
When this check box is cleared (FALSE), legacy feature privileges are not available and cannot be assigned to groups. This is the default setting for the cloud-based free trial installation.
When this check box is selected (TRUE), legacy feature privileges are available and can be assigned to groups. This is the default setting for all installations other than the cloud-based free trial.
The following legacy feature privileges are affected by this setting:
When these legacy privileges are enabled, InfoAssist, the Reporting Object Tool, the WebFOCUS Infographics menu option, and other legacy tools are available to administrators and to users working in the Advanced Users group, the Developers group, and any group whose roles include these privileges.
Note: The value in this setting takes priority over the value in the Enable Infographics (IBI_ENABLE_INFOGRAPHICS) setting. Therefore, both this check box and the Enable Infographics check box must be selected in order to make infographics available.
Enables OLAP settings and functionality. When this check box is selected, OLAP functionality appears in the following locations:
Note: In the Properties dialog boxes of portals and workspaces, this check box appears dimmed and is unavailable. In the Properties dialog boxes of reports, charts, and visualizations, this check box is fully visible and available.
This setting does not activate the use of OLAP within App Studio. To do so, open App Studio, and select the Enable OLAP check box on the Reporting tab of the App Studio Options dialog box. For more information, see the Setting User Preferences Using the Options Dialog Box topic in the WebFOCUS App Studio User's Manual.
This check box is cleared, by default.
For migrated environments, enables the Default Role tab in the Security Center. This check box is cleared, by default.
Identifies the type of files that cannot be uploaded to the WebFOCUS Server. Files types are identified by their extension. For example, PDF files that use one of the extensions listed in this setting cannot be uploaded. This setting is blank, by default, enabling you to upload any type of file.
Identifies the default value assigned to the maximum number of records limit.
This value is set to 5,000, by default. When you change this value, the value automatically assigned to the Designer Maximum Number of Records and InfoAssist Maximum Number of records setting will also change to reflect the value in this setting.
If you assign a value of zero (0) to this setting, no limits are imposed on the maximum number of records. We do not recommend this value because it can degrade the performance of your browser.
Contains one or more FOCUS error message numbers separated by commas. WebFOCUS and ReportCaster regard the FOCUS error messages whose numbers appear in this setting as warnings instead of error messages.
If WebFOCUS encounters one of these FOCUS error message numbers, it generates a warning message instead of an error message and does not highlight the trace that captures the FOCUS error message as an error in the Session Viewer.
If ReportCaster encounters one of these FOCUS error message numbers when executing a report schedule, it distributes the report in spite of the FOCUS error message, and does not trigger an error notification, even if the report schedule is configured to use the On Error Notification Type.
Identifies the paths to those folders in which item descriptions are indexed for the Magnify Search engine.
When the term OFF appears in this setting, item description indexing is deactivated. This is the default value.
When one or more paths appear in this setting, item description indexing is activated for all items within the final folder identified in each path. Whenever an item within a folder identified by one of the paths in this setting is created, or the description or summary of an existing item within that folder is modified, the description and summary of that item are indexed automatically. If the final folder in a path includes multiple folders, item description indexing is activated for all of them.
Paths follow the IBFS path format. For example:
/wfirs/ibfs/WFC/Repository/Retail_Samples/Reports/
Multiple paths must be separated with a semicolon (;).
When this check box is selected, the Display Ask TIBCO WebFOCUS Menu (opInfoSearch) privilege is available in the Security Center Roles dialog box, making InfoSearch available to users. This is the default value for this setting.
When this check box is cleared, the Display Ask TIBCO WebFOCUS Menu (opInfoSearch) privilege is removed from the Security Center Edit Role dialog box, making InfoSearch unavailable to users.
After a new product installation or upgrade, this check box is selected, by default, making InfoSearch and the Display Ask TIBCO WebFOCUS Menu (opInfoSearch) privilege available automatically. However, even when this check box is selected, the text-based search capability it enables becomes available only when users have the Display Ask TIBCO WebFOCUS Menu (opInfoSearch) privilege and dimensionally-indexed Repository content is available.
Because clearing this check box also hides the Display Ask TIBCO WebFOCUS Menu (opInfoSearch) privilege, administrators should not clear this check box unless they intend to remove the ability to use InfoSearch from all users. To re-establish this setting, an administrator must select the Enable InfoSearch check box again.
Note: InfoSearch is a search tool that retrieves content items in the Repository that contain data or metadata that matches the words or expressions used in the search query. It is a superset of the Magnify Search tool, and InfoSearch is purchased separately. Customers that purchase Magnify Search, but not InfoSearch, will be able to use the InfoSearch Retail Samples demo, but they will not be able to use InfoSearch with any other data or content.
Determines whether double-clicking a library item opens the latest version of the report (Last) or a list of report versions (Versions). The default value is Last. The value you specify here appears first in the shortcut menu when you right-click a library item and click View.
This check box is visible only if the license key for your installation includes the TIBCO WebFOCUS Mobile product component.
When this check box is selected, the Display Ask TIBCO WebFOCUS for Mobile Voice (opMobileVoice) privilege is available in the Security Center Roles dialog box, making the Mobile Voice interface available to all users. This is the default value for this setting.
When this check box is cleared, the Display Ask TIBCO WebFOCUS for Mobile Voice (opMobileVoice) privilege is removed from the Security Center Roles dialog box, making the Mobile Voice interface unavailable to all users.
After a new product installation or upgrade that includes a license for the TIBCO WebFOCUS Mobile product component, this check box is visible and selected, by default, making Mobile Voice and the Display Ask TIBCO WebFOCUS for Mobile Voice (opMobileVoice) privilege available automatically.
However, even when this check box is selected, Mobile Voice search capability becomes available only when licensed users are working with a role in which the Display Ask TIBCO WebFOCUS for Mobile Voice (opMobileVoice) privilege is selected, dimensionally-indexed Repository content is available, and at least one Intent phrase has been defined for an available resource.
Because clearing this check box also hides the Display Ask TIBCO WebFOCUS for Mobile Voice (opMobileVoice) privilege, administrators should not clear this check box unless they intend to remove the ability to use Mobile Voice from all users. To re-establish this setting, an administrator must select the Enable Mobile Voice check box again.
When this check box is selected (True), the Run Procedures with Different Connection Credentials (opRunAs) privilege becomes available in the Basic Reporting privilege category of the Roles dialog box.
Users who are granted this privilege can select the Run with different connection credentials option from the shortcut menu. This menu option allows users to provide credentials when running procedures against databases that require additional authentication against their internal credentials in order to provide access to an elevated data set. It extends reporting capabilities to information that would otherwise be unavailable without the ability to authenticate alternative user IDs and passwords at runtime.
When this check box is cleared (False), neither the privilege nor the menu option is available. This is the default value for this setting.
This setting only affects the configuration of the Run with different connection credentials menu option within the WebFOCUS Client. In order to complete the configuration of this functionality, the WebFOCUS Server and individual database connections must also be configured to accept the use of additional credentials. For more information about the WebFOCUS Server configuration, see the TIBCO WebFOCUS® Reporting Server Administration technical content.
For more information about the WebFOCUS Client configuration, see Configuring Run With Different Connection Credentials.
Uploads Repository images to the WebFOCUS Server for embedding in reports and HTML pages. This check box is selected, by default.
The name of the file that contains text strings used to customize labels for global items, such as menu bar options, error messages, and other features. This field is blank, by default.
Note: Consult Customer Support Services before modifying this setting.
Lists all procedures that run when users sign in to a portal or to web services. By default, this setting is blank, and no procedures run in response to user sign in. To configure a list of procedures, type the path name for each of them in this setting, and separate each path name with a comma, as shown in the following example.
IBFS:/WFC/Repository/Public/motd.fex,
The procedures you include in this setting can serve a variety of purposes. For example, you can use this setting to run a procedure that sends a message of the day to users upon sign-in, using the syntax shown in the following example of the message of the day file, motd.fex.
-IF &FOCSECUSER EQ admin GOTO ADMINMSG; -TYPE <UserMsg>Hello normal user</UserMsg> -GOTO DONE; -ADMINMSG -TYPE <UserMsg>Hello admin</UserMsg> -DONE
You could also use this setting to run a procedure that initializes the environment and establishes a procedure within the repository that creates a single foccache ticket that can be used for all subsequent requests, as shown in the following example.
TABLE FILE IBISAMP/CAR PRINT COUNTRY IF RECORDLIMIT EQ 1 ON TABLE HOLD AS FOCCACHE/LATCH END
This procedure cannot produce any report output.
Activates the technical preview mode, which enables users to view and evaluate specific features planned for an upcoming release.
This setting is relevant only to product versions that include preview features. Because each release contains a different set of new features, the code names of preview features for one version may not be relevant to another version. Therefore, lists that do not contain the code name of any feature that appears in the technical preview mode of the version that is currently installed, fail to activate the technical preview mode.
When this setting is blank, the technical preview mode is not activated, and users are not able to preview new features. This is the default value.
When this setting contains a semicolon-delimited list of the code names of one or more of the features that are included in the technical preview mode of the version of the product that is currently installed, WebFOCUS activates the technical preview mode, and users can open and test the new features included in the list.
When the technical preview mode is activated, administrators receive a message identifying the technical preview features that are currently enabled immediately after sign-in. This message is also posted to the event log along with other records of the administrator sign-in event. No other users receive this message after sign-in.
Establishes the maximum number of values to display in the Filters selection panel at design time.
For example, in WebFOCUS Designer, this value defines the maximum number of entries that can be included in a list of alphanumeric filter options that opens from the Filter toolbar. Similarly, in InfoAssist, this value defines the maximum number of entries that can be included in a list of alphanumeric filter options that opens from the Get Values list of the Creating a filtering condition dialog box for a filter based on a Constant value type.
5000 is the default value assigned to this setting.
Identifies the name of the theme assigned to InfoAssist and Business Intelligence Portal designer tools. This value is blank, by default, meaning that the default theme behavior is in effect for these tools. The other value, BIPNeutral, sets the default theme for these designer tools to a more modern and neutral appearance.
Parameter Prompting settings determine parameter prompting behavior in the WebFOCUS Client.
Specifies the value (_FOC_NULL or FOC_NONE) that the WebFOCUS Client assigns (in a -SET command) to the amper variable when the dynamic multi-select list No Selection value is selected. The default value is _FOC_NULL.
Enables or disables parameter prompting for all Managed Reporting requests. Possible values are:
Enables or disables parameter prompting for Managed Reporting procedures (FEXes) when Managed Reporting (IBIMR_PROMPTING) is set to Always Prompt (XMLPROMPT) or Run with Default Values (XMLRUN), and the Prompt for Parameters check box is unselected in the FEX Properties dialog box. Possible values are:
Activates automatic indexing of report and chart parameters. If this check box is selected (True), when users save reports or charts, the parameters on which they are based are indexed automatically, making information about these parameters immediately searchable, and delivering more timely and comprehensive search results.
This check box is selected (True), by default.
Specifies the template that defines the layout of the autoprompt interface.
You can add customized versions of HTML and Responsive autoprompt interface templates to this list by typing template name tags for them in the aptemplates.xml file. However, the Designer autoprompt interface template is not available for customization. For more information, see How to Add Custom Autoprompt Templates and How to Test Custom Autoprompt Templates.
Activates the automatic selection of all values in Responsive Autoprompt multiselect static selection list parameters at runtime, by default.
If this check box is selected (True), Responsive Autoprompt selection list parameters that contain multiselect static lists are automatically assigned FOC_ALL as their initial selection value, by default, causing these lists to automatically display all values as selected at runtime. However, if a multiselect static list designates a default value for display, that value overrides the automatic assignment of FOC_ALL as the initial selection value, and that default value is displayed as the initial selection instead.
If this check box is cleared (False), parameters that contain multiselect static lists are not automatically assigned FOC_ALL as the initial selection value, by default, and all items within the list are not selected automatically at runtime. If a multiselect static list contains a designated default value, that value is displayed, by default. To include all values from the static selection list in a query, a user must manually select the All Values option or individually select all values in the list.
This check box is cleared (False), by default.
Enables or disables amper auto prompting for self-service reporting. Possible values are:
Note: Managed Reporting uses a separate variable setting, which is IBIMR_PROMPTING.
Quick Data settings determine how Quick Data performs authentication.
Applies when MR authentication is selected for the IBI_Quick_Data_Security setting. Permitted values are
Specifies the type of sign-in used by WebFOCUS Quick Data. Permitted values are Reporting Server and Managed Reporting. The default value is Reporting Server and requires no additional configuration.
Repository settings specify the authentication credentials that the JDBC driver uses to access the Repository.
Specifies the maximum number of security policies retained for a single session. The default value is 50 policies and the maximum value is 500 policies.
Specifies the duration, in minutes, that a cached security policy is considered valid. The default value is 180 minutes and the maximum value is 720 minutes.
This information is not yet available.
Specifies the duration, in minutes, that the list of external groups for each user will be retained. The default value is 180 minutes and the maximum value is 720 minutes.
Specifies the number of users for whom to retain the list of group memberships. The default value is 50 users and the maximum value is 1000 users.
Specifies the number of minutes that user security information will be retained after sign-out. The default value is 30 minutes.
Note: This setting may be useful for applications that run web services applications that sign in, perform a minor task, and sign out.
Specifies how many procedures (.fex files) are cached in memory to improve response time. The default value is 100 procedures (.fex files).
Specifies, in minutes, the interval at which other JVMs will synchronize security information with the Repository, when multiple JVMs are using the same repository. For example, security information is not updated in the other application servers in a cluster or in the ReportCaster Distribution Server until this interval elapses. The default value is 1 minute.
Specifies the Java Database Connectivity API (JDBC) driver used to access the Repository.
The value in this setting is not available for updates. If you must change the default value assigned to this setting, contact the Customer Services Support team.
Specifies the password used by the JDBC driver to access the Repository.
Specifies the URL used by the JDBC driver to access the Repository.
The value in this setting is not available for updates. If you must change the default value assigned to this setting, contact the Customer Services Support team.
Specifies the user ID used by the JDBC driver to access the Repository.
The value in this setting is not available for updates. If you must change the default value assigned to this setting, contact the Customer Services Support team.
Specifies whether the Last Accessed On property is updated in the Properties dialog box when a resource is accessed. The default value is ON, which indicates that the property is updated.
Source Code Management settings activate the use of a third-party source control provider with WebFOCUS or App Studio. They also identify the location of the server and root project where the source control provider repository is stored.
When selected, this check box enables the integration of a source control provider to manage application code development in WebFOCUS or App Studio.
This check box and the Enable private working area (IBI_SCM_PWA_ENABLE) check box must be selected to activate the use of Git Source Control operations within WebFOCUS.
Identifies the source control providers that are available for use when working with WebFOCUS or App Studio.
You can select the source control provider that you want to use from the list of available providers included in this setting.
Typically, the applications created by these providers are installed on the same machine as the host server for WebFOCUS or App Studio.
Identifies the version number of the source control provider that is specified in the Provider (IBI_SCM_PROVIDER_TYPE) setting.
For example, when using Team Foundation Server 2013, type the value 2013.
This setting is not relevant to Git. Leave this setting blank when using Git as the source control provider.
When selected, this check box enables the use of a private working area for source control operations within WebFOCUS or App Studio.
This check box and the Enable Source Control (IBI_SCM_ENABLE) check box must be selected to activate the use of Git Source Control operations within WebFOCUS.
Identifies the URL of the server hosting the Team Foundation Server, including the collection name that is used to host the projects.
For example, when using Team Foundation Server 2013, type a value that uses the format http://TFS_hostname:port/tfs/collection_name.
This setting is not relevant to Git. Leave this setting blank when using Git as the source control provider.
Identifies the path and folder name where the root source control project was installed.
For example, when using Team Foundation Server 2013, type the value $/TeamProject1.
This setting is not relevant to Git. Leave this setting blank when using Git as the source control provider.
Before you attempt to configure a source control provider, ensure that all providers that could be made available to WebFOCUS users in the Provider (IBI_SCM_PROVIDER_TYPE) setting list have been configured and are housed in a network location that is available to WebFOCUS.
Before you attempt to configure a source control provider, ensure that all providers that could be made available to App Studio users in the Provider (IBI_SCM_PROVIDER_TYPE) setting list have been configured and are housed in a network location that is available to WebFOCUS.
For example, Team Foundation Server.
For example, when using Team Foundation Server 2013, type the value 2013.
For example, http://TFS_hostname:port/tfs/collection_name.
For example, $/TeamProject1.
Search settings configure general Search operations. They apply to Solr Search.
Identifies the URL of the Solr server for your product installation. When Solr is the designated search engine, the WebFOCUS Client directs indexing and search queries to this URL.
When this value is blank, no URL is identified and no connection can be made to the Solr server engine from the WebFOCUS Client. This setting is blank, by default.
If you are using an IBCloud installation, the cloud administrator must provide you with the correct URL and port number to assign to this setting.
If you are using your own SolrCloud or Solr stand-alone installation, you must identify the URL of the Solr Server in use in your organization and assign it to this value.
For a single cluster Solr configuration, in a non-SolrCloud installation, the format of the Solr URL is:
<scheme>://<host>:<port>/solr
Where:
Is the scheme in use in your organization. We recommend https.
Is the name of the machine that hosts the WebFOCUS Server.
Is the number of the port you use to connect to the Solr search engine.
For example: https://host_name:8983/solr
Specifies the maximum number of search results returned by a search request. Any results beyond this number are not displayed to the user. The default value is 300 results.
This setting is relevant only if your organization uses the Basic Authentication plugin with the Apache Solr search engine.
If Solr Basic authentication is not in use, this setting is blank.
If Solr Basic authentication is in use, this setting contains the name of the collection that contains your search data and is accessible only with a valid Solr username and password. This value can be authenticated only if a collection name is also defined in the Solr Collections API. This is the default value.
The value ibi-protected appears in this setting, by default. If you do not use the default value, you must assign a unique name to this field, and assign the same unique name to your collection in the Solr Collections API.
For more information, see the Collections/Core Admin topic and the Collections API topic in the Apache Solr Reference Guide.
This setting is relevant only if your organization uses the Basic Authentication plugin with the Apache Solr search engine.
A password appears in this setting by default. It is assigned to this setting during product installation. If not in use, leave as is. If in use, replace default password with the password used by your Solr administrator.
If Solr Basic authentication is in use, this setting contains the password that authenticates Solr-based indexing and search queries. This value can be authenticated only if a password is assigned to the security.json file in the Basic Authentication plugin.
If you are working within an IB Cloud installation, you must assign the password provided to you by the Customer Support team to this field.
If you create your own Solr installation, you must create your own password, assign it to this field, and to the password field of the security.json file in the Basic Authentication plugin.
For more information see the Basic Authentication Plugin topics in the Apache Solr Reference Guide.
This setting is relevant only if your organization uses the Basic Authentication plugin with the Apache Solr search engine.
If Solr Basic authentication is not in use, this setting is blank. This is the default value.
If Solr Basic authentication is in use, this setting contains the user name that authenticates Solr-based indexing and search queries. This value can be authenticated only if a user name is assigned to the security.json file in the Basic Authentication plugin.
If you are working within an IB Cloud installation, you must assign the user name provided to you by the Customer Support team to this field.
If you create your own Solr installation, you must create your own user name, assign it to this setting, and assign it to the username field of the security.json file in the Basic Authentication plugin.
For more information, see the Basic Authentication Plugin topics in the Apache Solr Reference Guide.
Text Generation Server settings define the connections to an independent server that provides narrative descriptions for chart headers, footers, and tooltips.
Identifies the URL of the external natural language generation (NLG) server that provides narrative descriptions for chart headers, footers and tooltips. If your product installation supports natural language generation for charts, type the URL of the text generation server in this setting. This setting is blank, by default.
When you activate the use of an external natural language generation (NLG) server, this setting contains a value, typically:
http://machine_name:20000/yseop-manager/direct/savvy-kb/dialog.do
Where:
Validation settings specify the behavior of WebFOCUS when validation tests fail.
Note: The character patterns IBI, IBIFS, and PG_ are reserved for internal product variables. They should not be used at the beginning of variable names.
Specifies the action to take if a URI-parameter validation test fails. The validation test is performed as a precaution against SQL injection and cross-site scripting attacks. Permitted values are:
Specifies the HTTP response code to return to the browser when URI-parameter validation has failed and IBI_Validate.Action is set to ENFORCE. Permitted values are any valid HTTP status code (such as 400 or 403), a URI, or a fully qualified URL. If an HTTP status code is entered, WebFOCUS returns a response header with the status code. If a URL or URI is entered, WebFOCUS returns 200 (success) and redirects the browser to the specified address. The default value is 400.
For diagnostic purposes only. If True, returns an HTTP response header to the browser specifying the URLs that failed validation and the reason for their failure. The default value is False.