Configure datetime service attributes

In the Management Portal at Entitlement Catalog, on the Attributes tab of the service page, configure datetime attributes to store a date/time combination. For example, in a Postpone Transaction action, you can use a datetime attribute when you choose a date for the Until field. If users need to provide a date, they can then use a date/time picker to provide this date. This ensures that the date/time is provided in the correct format.

  • The specified date and time is converted to UTC time and vice versa, to ensure that dates and times are always converted to the correct local values.

Configuration

Item Explanation and Tips
Restricted information Mask the attribute value in the Management Portal. This ensures you can be compliant with the privacy laws of your country or organization, as unauthorized administrators do not have access to private information like e-mail addresses, phone numbers, social security numbers, etc. This functionality applies to the Management Portal only; restricted information is still shown in the Web Portal.
  • Authorized administrators see the icon Eye-outline-vector-256-256 for restricted attributes and their placeholders anywhere in the Management Portal. They can click this icon to view their value. These values are hidden again when the page is refreshed. This prevents situations in which unauthorized administrators can view restricted information by shoulder surfing authorized administrators. Where appropriate, a button is available to view ALL restricted attributes at once.
  • Unauthorized administrators see the icon Evil eye for restricted attributes and their placeholders. At Transactions, restricted attributes are shown as [attributename]. Although unauthorized administrators cannot see the attribute value, this still allows them to verify if the context or definition of the attribute is correct.
  • You can set administrative permissions on this functionality.
  • The value is also restricted if it is determined by a restricted service attribute, people attribute or people identifier.
DateTime Specify an initial value manually.
  • Click the date picker to select a date. When you select a date, a time is automatically added.
  • Clear the field if the date needs to be provided by an actor during a service transaction, and you do not previously configured dates to be available.
  • The value is limited to 2000 characters.
DateTime at the start of transaction Resolve the initial value dynamically to the start date and time (UTC) of the service transaction. This is useful in services that onboard a new user: when a user is added to the system, you can register dynamically when this happened.
Person attribute

Base the initial value on an existing people identifier or people attribute.

  • The value of the attribute must be in an accepted format:
    • YYYYMMDD
    • YYYYMMDDHHmm
    • YYYYMMDDHHmmss
Service attribute Base the initial value on a service attribute of another service (either text or datetime).
  • The subscriber to the current service must already subscribe to the other service before the value of its service attribute can be resolved.
  • The value of the attribute must be in an accepted format:
    • YYYYMMDD
    • YYYYMMDDHHmm
    • YYYYMMDDHHmmss

You can force mandatory input by enabling Attribute may not be empty after workflow input from actor.

You can use the service attribute in multiple pages of a Provide Information workflow action by enabling Attribute can be used in multiple pages on Provide Information.

Placeholders

When you insert datetime service attribute as a placeholder in actions, you can retrieve its value:

Placeholder Explanation
#Service[{attributename}] Resolve the value of the datetime service attribute.
#Service[{attributename.Localtime}] Use this placeholder to translate the value of the datetime service attribute to the user's local time. You can for example use this placeholder in messages or other notifications.
#Service[{attributename.Description}] Resolve the description of the attribute, e.g. "This is the selected date and time of the actor".