Other Properties
The following properties are not categorized in the system. They are grouped by the function they configure.
To get a list of available system properties, navigate to System Properties → All Properties.
Activity Feed
simple.activity_feed.show_deleted_item_in_history
Specify the column IDs whose values are displayed in the history, even if those columns are deleted.
Type: Array
Default value: []
Example value: ["156943341308746896", "156943341303994936" "155931135900001087"]
In this example, updates of the values of the Subject, Assignment group and Priority fields in the Task table are displayed in the Activity Feed history even after the column has been deleted.
Branding
See more in the Branding customization article.
ui.branding.favicon
Specify the attachment record ID that is the source of the favicon in a browser tab.
Type: String
Default value: Default
Example value: Default
ui.branding.logo
Specify the attachment record ID that is the source of the logo on the main page.
Type: String
Default value: Default
Example value: 159135964224454701
ui.branding.pageTitle
Specify the title of the main page.
Type: String
Default value: Main Page
Example value: Main Page
Budget and Purchases
currency.default
Specify the currency code from an existing active record in the Currencies (currency) table. This code will be the default Currency field value for all new records in the following tables:
- Purchase Requests (purchase_request)
- Budgets (budget)
- Budget Items (budget_item)
- Planned Cost Items (planned_cost_item)
- Actual Cost Items (actual_cost_item)
- Savings (savings)
- Savings Allocation (savings_allocation)
Type: String
Default value: ["RUB"]
Example value: ["USD"]
Cache
cache_system_url.enable
To enable the client-side caching using the URL Caches (sys_cache_system_url) table, set the value to true. Users can clear the cache via the Preferences menu.
Type: Boolean
Default value: true
Example value: true
redis.enable
This system property is deprecated. Changing its value has no effect on the system behavior.
Type: Boolean
Default value: true
Example value: true
Employees
simple.employee.main_representative.excluded_company_classes
Specify the list of the company classes that do not need to have a main representative.
Type: String
Default value: internal
Example value: internal,service_provider,service_partner
Form configuration
simple.presence_indication.additional_info_column_name
Specify the system name of a column from the Employee (employee) table. The value of this column is displayed in the presence indicator. Leave the Value field empty to hide the additional line in the indicator.
Type: String
Default value: job_title
General settings
autosuggest.search_limit
Specify the maximum number of database queries the system can perform to search for autosuggestion options based on the entered word. A higher value improves the accuracy of suggestions but may reduce performance, especially when searching in tables with access control rules.
Type: Integer
Default value: 100
Example value: 220
core.dependency_script
Specify the script name from the Server Script (sys_script) table that is responsible for the CIs dependency map rendering.
Type: String
Default value: CI
Example value: CI
count.autosuggest.items
Specify the number of items appearing in the autosuggest.
Type: Integer
Default value: 20
Example value: 8
model_nesting_definition
Specify the maximum nesting level in the dependency map. It is mentioned in the DependencyMap script from the Server Script (sys_script) table.
Type: Integer
Default value: 99
Example value: 40
simple.date.format
Specify the system date format. Available options are:
- Y-m-d
- d.m.Y
- d/m/Y
If no property value is specified, the Y-m-d format is used.
Type: String
Default value: Y-m-d
Example value:
- If the property value is equal to Y-m-d, then a date is displayed like YYYY-MM-DD (for example, 2020-09-25).
- If the property value is equal to d.m.Y, then a date is displayed like DD.MM.YYYY (for example, 25.09.2020).
- If the property value is equal to d/m/Y, then a date is displayed like DD/MM/YYYY (for example, 25/09/2020).
The available set of date formats is provided by the vendor and stored in the Date Formats (sys_date_format) dictionary.
simple.number.enable_grouping_separator
Set the true value to enable the use of the digit group separators. The system separates every three digits into a digit group and automatically changes the separator depending on the selected language. You can select the number format when you configure a language. Default values:
- Russian – space for digit groups, comma for decimal part: 1 000,25.
- English – comma for digit groups, period for decimal part: 1,000.25.
The separator is applied to columns of Big Integer, Small Integer, Float, Decimal, Integer, Percent Complete types.
The columns to which the digit group separator is never applied
| Columns | Tables |
|---|---|
| sys_id | All tables |
| record_id |
|
| Retrieved Pack |
| process_id | Indication |
| parent_record_id | Record Deletion Log |
| report_width | Report |
| origin_sys_id | VCS Local Pack |
| restored_by_id | VCS Record |
| essence_id | Menu Item |
| element_id | Activities Stream Field |
| instance |
|
Type: Boolean
Default value: true
Example value: true
simple.instance.uri
Specify the URI of the current SimpleOne instance.
A good practice is to use values of the current system property.
It is not recommended to use a hard-coded URI.
Good: ss.getProperty('simple.instance.uri') + '/' + current.getTableName() + '/' + current.sys_id
Bad: 'instance.simpleone.ru/record/' + current.getTableName() + '/' + current.sys_id</pre>
Type: String
Default value: Not defined
Example value: https://instance.simpleone.ru
simple.logs.rotate_period_in_days
Define the logs archiving period in days. If the period is not defined, the default value is 30 days.
Type: Integer
Default value: 30
Example value: 2
simple.logs.enable_script_logging
To enable the logging in the Script Log (sys_log_script) table, set the value to true.
When the property is enabled and the Disable script logging checkbox is selected in records of the Event Registers (sys_event_register) table, the system does not log the execution of the related Event Script Actions.
Type: Boolean
Default value: false
List configuration
list_groups.per_page
Specify the number of groups displayed on the list.
Type: Integer
Default value: Not defined
Example value: 20
list.pagination.enable_pages_calculation
Enable the item count for list pagination.
Type: Boolean
Default value: true
Example value: true
list.per_page
Specify the number of records to display on the list by default.
Type: Integer
Default value: Not defined
Example value: 20
simple.list.record_count_options
Set the options of the choice list with the numbers of records displayed per page. These options are available for selection when clicking the list icon . Use commas to separate the options.
Type: Array
Default value: 10, 20, 30, 40, 50
Example value: 10, 20, 30, 50, 100
Main page
main_page_button_title
Specify the URL text (or the Source Message text) to display on the 404 page.
Type: String
Default value: Go to Main Page
Example value: Go to Main Page
main_page_button_url
Specify the URL path name for the button leading from the 404 page.
Type: String
Default value: Not defined
Example value: /
ui.main_page
Specify a page ID to identify it as the main page. If not specified, the default page is displayed.
Type: String
Default value: Not defined
Example value: Default
Portal
portals.portal_context.enable
To enable page access verification and the following restrictions based on the portal contexts, set the value to true.
If the value is set to true and no access criteria are defined for the portal, users without roles cannot access it.
If the false value is set and no access criteria are defined, users without roles can access the portal.
Type: Boolean
Default value: false
portals.portal_conteхt.override_roles
Specify the user roles to restrict the access to the portal context mechanism.
Type: Array
Default value: []
Example value: ["change_manager", ''incident_manager"]
self_service_portal_button_title
Specify the title (or the Source Message text) for the URL that leads from the 403 page to the Self-Service Portal.
Type: String
Default value: Go to Self-Service Portal
Example value: Go to Self-Service Portal
self_service_portal_button_url
Specify the URL path name for the button that leads from the 403 page to the Self-Service Portal.
Type: String
Default value: Not defined
Example value: /portal
announcement.language.source
Define the source language field that must be used when defining in which language to send announcements to each registered user. Announcements will also be displayed to the user on the self-service portal in this language.
Possible values:
- interface – the language specified in the Interface language field in the user's personal settings.
- notification – the language specified in the Notification language field in the user's personal settings.
The property may be ignored, and the distribution (as well as the announcement display on the portal) will occur in the default translation language in the following cases:
- The notification recipient does not have a user account in the system.
- None of the announcement translation languages matches the language selected in the recipient’s profile settings.
Type: String
Default value: interface
Example value: notification
Reports
report.default.groups_limit
Specify the default value of Group Limits in reports. It is applied if the user has not specified a value.
Type: Integer
Default value: 10
Example value: 15
reports.disable.table_ids
Specify the IDs of the tables for which you need to disable report creation. Separate the values with commas.
This property does not automatically apply to inherited tables. To disable report creation for these tables, specify their IDs.
Type: String
Default value: ["167647292004244061,166981995307089717,157243499603174320,155931135900000004,155931135900000032,155931135900000005,159402748805035286,157460177909485067,157445320406397561,159402748803951284,158280716605434387,158281045502159310,158280586300049332,158281077700978476,158280995208759471,158280695704885445,156525005303455492,155931135900000034,156846397706052732,156846505002453065,156846521800076882,155931135900000012,155931135900000015,156076775207596046,155931135900000030,158408673111989615,158408998015330705,158408807214950243,158512283419825499,155931135900000018,163894885801803524,155931135900000020,155931135900000021,999999999999999999,155931135900000027,155931135900000051,166895109107569503,166609989101707440,160439775103379726,155931135900000062,156846521905974638,155931135900000065,155931135900000066,157052674906839245,155931135900000079,155931135900000080,156076775207617405,156525005704536345,155931135900000081,156076775509799411,160248689701059715,155931135900000085"]
Example value: ["170047161518940482"]
reports.exclude.column_ids
Specify the IDs of the columns you need to exclude from report creation. Separate the values with commas.
The field allows up to 4,000 characters including commas. The characters that exceed this limit get cut off.
Type: String
Default value: Not defined
Example value: ["173253589214935017"]
report.points.limit
Specify the maximum number of points on the chart of reports.
If the number of points is more than the defined maximum number, some parts of the report are hidden and the following message occurs: It's too much data to display. Maximum number of entries for the "{parameter}" parameter: {recordsCount}.
Type: Integer
Default value: 300
Example value: 2000
Security
acl.disabled
To disable all security ACL checks, set the value to true.
Setting this property to true may result in unauthorized access to your SimpleOne instance data, so use it carefully and do not forget to turn it off after all necessary operations.
You must have the security_admin role to set this property to true.
Type: Boolean
Default value: false
Example value: false
allowed.debug.users
Specify a list of users that are allowed to view the debug information page.
Type: String
Default value: Not defined
Example value: ["155964310500000013", "155964310500000023", "155964310500000006", "155964310500000052", "156466039605445245"]
protected.essences
Specify the tables that make up the application core. The versioning on these tables is usually turned off. The default record updating policy on them is usually equal to Protected.
Type: String
Default value: sys_db_table, sys_business_rule, sys_db_column, sys_db_column_override, sys_filter_option_dynamic, sys_role, sys_script, sys_script_client, sys_script_include, sys_security_acl, sys_ui_action, sys_application, sys_event_script_action, sys_event_register, sys_notification_script
Example value: sys_db_table, sys_business_rule, sys_db_column, sys_role, sys_script, sys_security_acl, sys_application
simple.page_access.request_link
Specify an email address that users should use to request access to the restricted pages.
Type: String
Default value: Not defined
Example value: mailto:servicedesk@simpleone.ru
simple.delegation.ignored_roles
Specify the roles that cannot be delegated.
Type: String
Default value: security_admin, admin, impersonator
Example value: change_manager
simple.url_action.redirect_to.blacklist_url
Specify links that are not allowed to be redirected using the redirect_to URL parameter. The work of this system property depends on the value of the simple.url_action.redirect_to.whitelist_url system property.
- If the value of simple.url_action.redirect_to.whitelist_url is empty, all links are allowed except for those that are specified in the simple.url_action.redirect_to.blacklist_url.
- If the value of the simple.url_action.redirect_to.whitelist_url is not empty, only the links specified in it are allowed.
You can list multiple links separated by semicolons. It is also possible to use the wildcard symbol * to prohibit all links that contain the specified value.
Type: String
Default value: Not defined
Example value: *.google.com;https://vk.com/*
simple.url_action.redirect_to.whitelist_url
Specify the links allowed for redirection with redirect_to URL parameter.
- If the value is not set, the redirection is allowed for all links except those that are specified in the simple.url_action.redirect_to.blacklist_url system property.
- If the value is set, the redirection is only allowed for the specified links.
You can list multiple links separated by semicolons. It is also possible to use the wildcard symbol * to allow all links that contain the specified value.
Type: String
Default value: Not defined
Example value: *.google.com;https://vk.com/*
VCS
audit.tables.ignoredList
Specify the tables whose changes are not stored in the History (ignored).
Type: String
Default value: Not defined
Example value: ["sys_version","sys_version_option","sys_history"]
simple.version.back
Specify the name of the current backend build deployed on an instance.
Type: String
Default value: Not defined
Example value: master-build.1079(b)
simple.version.front
Specify the name of the current frontend build deployed on an instance.
Type: String
Default value: Not defined
Example value: master-build.1077(f)
simple.platform.version
Specify the information about the current version of the platform in a user-friendly text form.
Its value assignment is an optional part of the instance deployment procedure.
If defined, a value of this property is returned in response to a version request. For example, it is displayed at the bottom of the Preferences menu as the version info.
If the value of the property is undefined or is equal to false, a combination of simple.version.back and simple.version.front values is returned instead.
Type: String
Default value: Not defined
Example value: Release v1.1.2
vcs_ignore_tables
Specify the tables whose changes are not written down into configuration local packs (ignored).
Type: String
Default value: Not defined
Example value: ["sys_version","sys_version_option","sys_history"]
Work and Time Management
wtm.timesheet.one_scroll.cards_count
Specify the number of timecards loaded per scroll on the Timesheet page.
Type: Integer
Default value: 20
Example value: 30
wtm.overtime_work
Set to true to let employees specify more time than their work schedules allow to spend on tasks.
Type: Boolean
Default value: false
Example value: true
wtm.default_time_spent_time
Specify the time in seconds that will be available by default for employees who do not have a specified work schedule to spend on tasks.
Type: Integer
Default value: 28800
Example value: 43200
Workflows
simple.wf_activity_loop_limit
Specify the maximum number of execution loops for the same workflow action in a row.
Type: Integer
Default value: 10
Value example: 20
Configuration items
simple.ci.dependency_map.display_mode
Specify an entity on which to build configuration item dependency maps. If the property value is not specified or incorrect, the dependency map is built as if the property value was equal to class.
Type: String
Default value: class
Possible values:
-
type – the dependecy map is built based on the CI Type. This means that visually the CIs on the map are located on different levels according to their types and positions.
Example
CI CI Type Order of the CI Position Laptop Electronic equipment 100 Monitor Electronic equipment 100 Desk Furniture 250 The Laptop has a relationship to the Monitor, while the Monitor is related to the Desk. On the dependency map, the Laptop and the Monitor will be on the same level, higher than the Desk, according to their CI types, and the positions of these types.
noteIf the system poperty is set to type, and a CI has a relationship to another CI that does not belong to any type, the latter has a position that equals zero on the dependency map. This is the first level.
-
class – the dependecy map is built based on the CMDB Class. This means that visually the CIs on the map are located on different levels with a step of 150 according to their CMDB classes and the parent-child relations between the classes. The CI title on the map in this case shows the name of the class to which the CI belongs. Also, the dependency map will display the Icon placeholder specified on the CMDB Class form on the CIs of this class.
Example
CI CMDB Class Laptop Work equipment Charger Work equipment Power strip Office equipment The Laptop has a relationship to the Charger that, in its turn, has a relationship to the Power strip. The Work equipment is a parent class of the Office equipment. On the dependency map, the Laptop and Charger are located on the same level, above the Power strip, according to their classes and configured parent-child relationships.
noteIf the system poperty is set to class, and a CI has a relationship to another CI that does not belong to any class, or its class is neither a parent nor a child one, such a CI is located at the top of the dependency map.
-
custom – the dependecy map is built based on the getCustomDependencyMapData script include available at the
\{your instance URL\}/record/sys_script_include/174792342812873874address. With this script, you can define a criterion for the differentiation of levels on the dependency map, as well as other settings of the map. The instruction for the script is avaialble in its record.