You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 7 Next »
In SimpleOne, all times are stored in the UTC timezone and appear based in the system time zone. But to users, times appear in their local time zone, according to their preference settings.
This functionality is used whole across the system, for example, in Timepoint Indicators, email notifications, and so on, so very important to set up them carefully, taking all the conditions into account.
Setting up a new timezone
When an instance is deployed or updated, it synchronizes with the IANA database and copies a pack of standard timezones actual for a deploy date. All newly created timezones must be extended from the standard ones.
Role required: admin.
To create a new timezone, please complete the steps below:
- Navigate to System Localization → Timezones.
- Click New and fill in the fields.
- Click Save or Save and Exit to apply changes.
Timezones fields description
Field | Description |
|---|---|
| Name | Timezone name. It is recommended to use the Country/City format when naming the timezone like listed in the TZ database. This field is of the String type and takes only English language. |
| Title | Specify the timezone title. It is used in different interface components, such as choice list in the General Preferences menu, and it is multilanguage. |
| UTC Offset | In this field, the UTC offset (the difference from Universal Coordinated Time) is specified. This field is read-only and inherits offset of the timezone specified in the Parent field. |
| Active | Select this checkbox to make the timezone active or inactive. When timezone is inactive, it is not available to choose as default user timezone, or a timezone for email notification, cannot be used in Timepoint Indicators. |
| Deprecated | Select this checkbox to mark the timezone as deprecated. When selected, the offset for this timezone is equal to 0, and it cannot be selected as Active. For timezones from the IANA list, this flag is set automatically and means that this timezone is no longer supported. The deprecated timezone automatically marked as inactive and cannot be used in any system components, such as schedules, indicators, and so on. Custom timezones extended from the deprecated timezone are also deactivated. |
| Parent | Specify parent timezone with desirable UTC offset from the IANA list. |
Default timezone
You can define a default timezone either for a single user logged in a system or for all users.
Setting a default timezone for a single user
It can be done in two ways:
- In the General Preferences menu, as described in this section.
- Configuring relevant User Preferences.
To go the second way, please complete the steps below:
- Navigate to User Administration → User Preference.
- Click New and fill in the fields.
- Click Save or Save and Exit to apply changes.
| Field | Description |
|---|---|
| User | Specify a user for which you are specifying a default timezone |
| Name | A preference name. In this case, type: user.timezone. |
| Value | A preference value, for example, UTC. |
Also, you can define a default timezone for a user by specifying it in a user profile. For this, please complete the steps below:
- Click on the username on the top right and select Profile.
- Specify a timezone in the Timezone field.
- Click Save or Save and Exit to apply changes.
When specifying a default timezone for a user via the General Preferences menu, a record in the User Preferences dictionary is created.
If the default user timezone was deprecated, then he will be asked to change it to another one. It's also valid for scripts or business-rules where API methods involving timezones are used (for example, methods from the SimpleDateTime class).
Setting a default timezone for all users
To define a default timezone for all users, you need to change the relevant system property value. The user.timezone.default property is responsible for this. To change this property value, please complete the steps below:
- Navigate to System Properties → System Properties.
- Click on the magnifier icon on the top of the list; the search string appears.
- Enter the property name into the Name field and perform a search.
- When found, click on the property name.
- Type the necessary timezone into the Value field; this property will affect all users in the system.
- Click Save or Save and Exit to apply changes.
Timezones in email notifications
The date and time in notifications are set using the system time zone; the recipient time zone is not taken into account.
The system property simple.email.append.timezone controls this aspect and allows to append timezone to dates and times in sent emails.
This property is of the Boolean type, so it can take the only values TRUE or FALSE. When set to TRUE, then the system timezone is appended to time and date in notifications.
Changing the value
Role required: admin.
To change the property value, please complete the steps below:
- Navigate to System Properties → System Properties.
- Locate this property in the list and click on it.
- Change the value in the Value field.
- Click Save or Save and Exit to apply changes.
- No labels
