Configuration of Process Monitoring

The various configuration options for Process Monitoring are presented and described below.

Overview of monitoring administration

General module configuration

You can access the settings options via the administration area in the tab Process Monitoring > General tab.

Module

General module settings

Name (ID) Description

Icon
(module_iconCls)

Individually selectable icon that is displayed before the title.
If no icon is to be displayed, e.g. "none" can be entered. If the field is empty, a standard icon is selected.

Base Path REST API
(moduleUrl)

Base path of the module to its offered REST API.
Should not be changed.

Data View Limit
(monitor_data_view_limit)

Queries can query data up to this limit. If in doubt, the query should filter the data more specifically. A very high value can have a negative impact on performance.

Data Count Limit
(monitor_data_count_limit)

When querying or searching via an index, the number of data records that match the current query is only counted up to this value. A very high value can have a negative impact on performance.

OpenSearch Buffer Limit
(monitor_query_buffer_limit_in_mb)

Maximum result quantity in MB that is accepted when querying the data from OpenSearch. A limit that is too large can have a negative impact on the RAM consumption of the system.

Plugin

Settings for managing plugins in the module

Name (ID) Description

Plugin Configuration
(plugin_configuration)

Configuration of plugins that are to be displayed within this module. The plugin configuration page of the respective module should be used for customization.

Component configuration

You can access the setting options via the administration area in the tab Process Monitoring > Components.

Module

General module settings

Name (ID) Description

Custom Views
(function_saveView)

Enables the 'Views Menu' for the monitor.

Name
(module_name)

Name or title of the module/component.

Icon
(module_iconCls)

Individually selectable icon that is displayed before the title.
If no icon is to be displayed, e.g. "none" can be entered. If the field is empty, a standard icon is selected.

Description
(moduleHeader_description)

Can be used as an additional description that is displayed in the module header.

Module Header Content
(moduleHeaderContent)

Additional content in the module header.
These are only displayed if you are in the administration area.
Available values: "deployment"

Left Toolbar
(appToolbarLeftContent)

An array is defined in these settings. Each array element consists of either a string that corresponds to the ID of the desired action or an object that has at least one id attribute and refers to the desired action. If only a string is specified, the action is displayed with the default values for the options. If an object is specified, the options of the actions can be influenced via an additional config attribute.
Possible values: "metadata", "favorites",
"search",
"processstarter",
"changestate",
"processaction",
"export",
"views",
"refresh"

Right Toolbar
(appToolbarRightContent)

An array is defined in these settings. Each array element consists of either a string that corresponds to the ID of the desired action or an object that has at least one id attribute and refers to the desired action. If only a string is specified, the action is displayed with the default values for the options. If an object is specified, the options of the actions can be influenced via an additional config attribute.
Possible values: "metadata", "favorites",
"search",
"processstarter",
"changestate",
"processaction",
"export",
"views",
"refresh"

Configuration

Module-specific settings

Name (ID) Description

Enable Multiple Grids
(function_gridMultipleViews)

Enables the use of multiple grids (tables) in one monitor. These are displayed in different tabs. Each grid can be assigned a basic filter that is used to filter the data.

Multiple Grid Configuration
(function_gridMultipleViewsConfig)

Configuration of the various monitor grids and the data filters used.

Column
(grid_mainSortColumn)

Column by which initial sorting takes place.

Direction
(grid_mainSortDirection)

Direction in which the initial sorting is performed.

Dynamic Row Styles Configuration
(row_style)

Settings for dynamic styling. In <code>columnList</code>, the columns whose content is to be taken into account for styling are listed. Styles for CSS classes are then defined in <code>rowClasses</code>. The name of the classes is formed according to the syntax <code>.-column-name-content</code>. For example, for the column "Status" you can style rows with the value "Error" using the class name <code>.-STATUS-ERROR</code>.

Dynamic Row Styles
(row_styleEnabled)

Enables the feature for customizing the appearance of a monitor row based on its content.

Count Filtered Column
(gui_countFilteredColumns)

Count filters by affected columns, not by the number of filters themselves. This can be different if multiple filters have been applied to a single column.

Text Selection
(grid_textSelectionEnabled)

Enables text selection in the table. This can be disruptive when selecting multiple rows.

Load Mask
(grid_showLoadMask)

Display a load mask during data load.

Custom Renderer
(column_customRenderer)

Definition of custom renderers to customize the display of column values.

File
(column_file)

Column name referring to file content in the record.

MIME Type
(column_mimetype)

Name of the field containing the MIME type of the file in the record.

Child Sub ID
(column_historySubId)

Name of the field that, in addition to the Child ID, forms the primary key.

Child ID
(column_historyId)

Name of the field in the child data that establishes the foreign key reference to the primary data.

Primary Key
(column_id)

Name of the field containing the unique ID of the record.

Status
(column_status)

Name of the field containing the status of the record.

Default MIME Type
(column_default_mimetype)

Defines the default MIME type for displaying attached documents.
All valid MIME types, such as application/text, are possible.

Grouping
(column_groupField)

Field by which the display should be initially grouped. The user can change the grouping independently via the interface.

Timestamp
(column_timeseries)

Name of the field defining the reference to the timeline. This is important for sorting and widgets.

Sorting by Multiple Columns
(sort_multi)

Allows sorting by multiple columns.

Number of Columns
(sort_multiColumnCount)

Maximum number of columns to be sorted by. If this is exceeded, the sorting is removed from the column with the currently lowest priority.

Reversed Multi-Sort Order
(sort_multiReversedOrder)

Applies the columns for sorting in reverse order for multiple sorting.

Date Format
(date_format)

Standard format for displaying dates

Field List
(column_list)

List of the fields contained in the data and their data types. This corresponds to the mapping of the OpenSearch index.
It is generated automatically and cannot be changed manually.

Child Field List
(column_historyList)

List of the fields contained in the data and their data types. This corresponds to the mapping of the OpenSearch index.
It is generated automatically and cannot be changed manually.

Column Configuration
(column_config)

Configuration of the view and filter settings for monitor columns.
Is initially generated automatically. Manual adjustments possible.

Child Column Configuration
(column_historyConfig)

Configuration of the columns for displaying the child data in the detailed views.
Is initially generated automatically. Manual adjustments possible.

Collaboration
(module_collab_descriptor)

Settings for Integration with Collaboration Module

Automatic Refresh
(function_autoUpdate)

Activates automatic data updating. Changes to the data are automatically recognized and reloaded.

Filter Bar
(gui_showFilterBar)

Toggle to show or hide the grid filter bar.

Consider Filters
(function_filterRespectOtherColumns)

When this value is active, the suggestion lists in the filters will consider already applied filters.

Hide Tooltip in Table Header
(hideDefaultTableHeaderTooltip)

Prevents the tooltip display of the technical field name underlying the current column.

State in URL
(gui_stateBrowsing)

Changes to the monitor (e.g. filters) are mapped in the URL. This allows you to switch between these states using the browser's forward/back function.

Data

Settings for the data

Name (ID) Description

Index
(data_index)

OpenSearch index name for monitor data.

Excluded Fields
(data_excludedFields)

List of data fields that are excluded from the monitor data. This means that the fields are not transferred to the monitor, even if they are in the index. For example, sensitive or large unused data can be excluded.
Example
["originator", "level"]

Child Index
(data_historyIndex)

OpenSearch index name for child data that can be viewed via the detail view

Data Filter
(data_filter)

This filter can be used to restrict the data displayed. Users do not have the option of bypassing it. The filter can also take into account the organizations, roles, rights or names of the current user.

Filter Operator
(data_filter_operator)

The operator specifies how the filters for organisations, roles, rights and users are logical linked. With OR (default), all data that fulfils one of the filter settings is displayed. With AND, only data that fulfils all filter settings is displayed.

Refresh Buffer
(data_refreshBuffer)

{}

Data View Limit
(instance_data_view_limit)

Queries can query data up to this limit. If in doubt, the query should filter the data more specifically. A very high value can have a negative impact on performance.
The value <code>-1</code> means that the setting from the general monitor settings is used.

Data Count Limit
(instance_data_count_limit)

When querying or searching via an index, the number of data records that match the current query is only counted up to this value. A very high value can have a negative impact on performance.
The value <code>-1</code> means that the setting from the general monitor settings is used.

Detail View

Settings for the different detail windows that can be enabled in the monitor

Name (ID) Description

Split Modew
(detailView_east)

Activates the split view option in the context menu. This can be used to display the detail view in split mode.

Initial Split Mode
(detailView_eastInitialShow)

Automatically opens the detail view in split mode when the monitor loads.

Split Mode Configuration
(detailView_eastConfig)

Settings for the detailed view for process data in the split view.
In a detailed view, the data of the data record can be displayed in a formatted form, child data for this data record can be displayed or other context-related content can be displayed.

Inline
(detailView_inline)

Enable inline detail view for monitor.

Inline Configuration
(detailView_inlineConfig)

Settings for the detailed view for process data in the inline view. The inline view is displayed via a + symbol at the beginning of the line.
In a detailed view, the data of the data record can be displayed in a formatted form, child data for this data record can be displayed or other context-related content can be displayed.

Popup
(detailView_popup)

Enable pop-up detail view for monitor.

Popup Configuration
(detailView_popupConfig)

Configuration for the popup detail view in the monitor.

Export

General settings for data export

Name (ID) Description

Enable
(function_exportEnable)

Allows the export of data from the monitor. The formats offered can be activated and configured separately.

Maximum Records
(function_maxExportLimit)

Maximum number of data records contained in the export. This value can be changed in the export dialog. A high value can have a negative impact on the server's RAM consumption with large data sets.

Export Dialog
(function_exportDialogDefaults)

Defines the default setting in the export window.

CSV Export

Settings for exporting data in CSV format

Name (ID) Description

Enable
(function_exportConfigCsv)

Activates the option to perform the export in CSV format.
Attention: The export must also be activated in the general settings.

CSV Separator
(function_exportConfigCsvSeparator)

Defines the CSV column separator.

Include Hidden Columns
(function_exportConfigCsvInclHidden)

Include hidden columns in the export

Configured Column Names
(function_exportConfigCsvUseCustomColumnHeaders)

Column label is used from the column configuration. Otherwise the field name is used as it appears in the index.

JSON Export

Settings for exporting data in JSON format

Name (ID) Description

Enable
(function_exportConfigJson)

Activates the option to perform the export in JSON format.
Attention: The export must also be activated in the general settings.

Include Hidden Columns
(function_exportConfigJsonInclHidden)

Include hidden columns in export

Configured Column Names
(function_exportConfigJsonUseCustomColumnHeaders)

Column label is used from the column configuration. Otherwise, the field name is used as it appears in the index.

UTC Date Format
(function_exportConfigJsonUseUTCDateFormat)

Specifies whether dates are to be output in UTC format or in the format "yyyy-MM-dd HH:mm:ss" and the time zone of the user/browser.

XLSX Export

Settings for exporting data in XLSX format

Name (ID) Description

Enable
(function_exportConfigXlsx)

Activates the option to export in Excel format (XLSX).
Attention: The export must also be activated in the general settings.

Include Hidden Columns
(function_exportConfigXlsxInclHidden)

Include hidden columns in export

Configured Column Names
(function_exportConfigXlsxUseCustomColumnHeaders)

Column label is used from the column configuration. Otherwise the field name is used as it appears in the index.

Automatic Column Width
(function_exportConfigXlsxAutoResizeColumns)

Column width is determined automatically.

Advanced Settings

Advanced settings

Name (ID) Description

Endpoint or Processor
(actionEndpointProcessor)

Selection of the REST endpoint or processor for the process actions

INUBIT Base URL
(inubit_baseUrl)

Path to the INUBIT HTTP services

Endpoint or Processor
(changeStateEndpointProcessor)

Selection of the REST endpoint or processor for the state change

DB Table Prefix
(inubit_dbTablePrefix)

Defines the table prefix for querying the correct database table. (Bosch PM Legacy Parameter)

INUBIT Backend Connection
(inubit_proxyId)

Here the ID of the associated backend connection must be specified, under which the relevant INUBIT server is accessible.

File Download Endpoint
(inubit_referenceEndpoint)

Name of the REST Endpoint for file download

Endpoint or Processor
(vpsEndpointProcessor)

Selection of the REST endpoint or processor for the process starter

Maximum file size for preview
(function_filePreviewSizeLimit)

Maximum file size (in bytes) allowed for preview. This is to protect the browser from using too much memory.

Configuration
(function_processStartConfig)

Configuration for the forms in the process starter.

Enable
(function_processActions)

Enables the usage of process actions

Enable
(function_processStart)

Enables the use of process starters.
Users also require the <code>bpcMonitor_startProcess</code> right and, if applicable, <code>loadModule_backendconnection</code>.

Parallelism
(function_processActionAllowParallel)

Allows the user to trigger several multiple actions at once.
This only applies to the current browser tab. If parallelism is deactivated, this does not protect against parallel executions by other users or in other browser tabs.

Configuration
(function_changeStateConfig)

Configuration of function parameters for state change.

Enable
(function_changeState)

Enables the manual state change function.
To allow a user to use this function, they need the bpcmonitor_changeprocessstate permission.
To grant a user permission for selected components, they need specific permissions with the ID of the component: bpcmonitor_changeprocessstate_&#x7B;MONITORID&#x7D;.

Separator
(function_processActionSeparator)

Separator for multiple process actions within a field.

Column Prefix
(function_processActionPrefix)

Columns/fields with this prefix are used as the source for the process actions offered.

Metadata
(function_processActionMetadata)

Any JSON object that is transferred together with the action to add additional configuration values or context information.

Notification Type for Actions
(function_processNotificationDisplayMode)

Notifications that are triggered by actions can be assigned to a specific type.

Resource-Saving Mode
(resource_saving_mode)

In resource-saving mode, aggregations to the index are prevented in order to reduce memory consumption in OpenSearch. This can lead to individual functions being restricted.

Bulk Actions

Settings for bulk actions

Name (ID) Description

Enable
(function_bulkActions)

Allows the use of bulk actions.

Actions
(function_bulkActionConfig)

The actions that the user can use are configured in this JSON.

Endpoint or Processor
(bulkActionEndpointProcessor)

Selection of the REST endpoint or processor for the bulk actions

Parallelism
(function_bulkActionAllowParallel)

Allows the user to trigger several multiple actions at once.
This only applies to the current browser tab. If parallelism is deactivated, this does not protect against parallel executions by other users or in other browser tabs.

Metadata
(function_bulkActionMetadata)

Any JSON object that is transferred together with the action to add additional configuration values or context information.


Keywords: