Supported Handlers

Toni Tolvanen
2024-12-02T14:05:03Z

Handlers are functions that are executed on a particular attribute implementing a specific behavior. Handlers implement a specific function such as hiding an issue at a certain state, combining two string attributes to one or calculating the service level performance.

The full documentation is available in the sofware:
[your.environment.address.here]itsm/jsp/help/SpecialHandlerDocs.jsp

The following handlers are supported:

AttributeCombiner - generates a value automatically by combining values of two or more existing attributes.

AutoEntityCreation - creates a new data card automatically when a data card containing an attribute with AutoEntityCreation handler is created.

AutoMailSender - generates and sends an automatic email message comprising the information you define in the parent attribute's metadata.

Average - calculates the average of values which are sent to the attribute via API.

BusinessHoursFinder - copies a reference to BusinessHours data card used to a data card to be edited from behind multiple references.

BusinessTimeBetween - calculates the elapsed time between two date (and time) fields in a data card.

CategoryDropdownReference - is used to generate dependencies between category dropdowns.

ChangeStamp - generates automatically a new value in a target attribute. The handler responds to the change of the parent attribute's value with stamping the target attribute with a new value.

Comment - enables commenting used by ESS2.

Count - executes mathematical calculations on the value of an attribute, which are updated through the API.

CreationStamp - creates a timestamp indicating the date/time when the data card was created.

CreatorStamp - generates an attribute value indicating who has created the data card.

DatacardHiddenState - hides the data card when the value of handler's attribute matches the value(s) configured in its metadata.

DirectLinkGenerator - generates a link to the data card where it is used.
Encryption - allows attributes to be saved in an encrypted form. Algorithm used for two-way encryption is 3DES and for one-way SHA-512.

Encryption - allows attributes to be saved in an encrypted form.

EntitySearch - adds dynamic search results in data card edit and display views.

EntityStateMail - generates the user interface for viewing and sending e-mail.

Expression - uses a Python expression in generating a value for the parent attribute. The handler evaluates the expression and returns the result automatically in the parent attribute's field after the data card is saved.

ExternalLinkParameters - automatically generates a link to a URL denoted in the attribute metadata. The link opens the default browser and accesses the defined URL.

FileUpload - creates a widget for selecting files for uploading them to a data card. User is able to select files in dialog or he can push those using drag and drop.

IDGenerator - generates an unique ID with a freely configurable prefix such as “INC-“ for the attribute.

IPAddress - generates a Search button next to the parent attribute's data field for selecting a free IP address from referred subnets. Clicking the button opens a pop-up window that provides a list of free addresses, from which a suitable address can be selected and consequently reserved.

MailTo - creates a mailto: link that addresses an e-mail message to the address specified in the attribute field.

MonitoringStamp - listens a monitored attribute and sets its own value, if the value of the monitored attribute changes to a defined one. The value of this attribute can be cleared also, when the value of the monitored attribute changes to the defined value. It is also definable, whether the attribute is updated or not once the value is set.

QuickFill - with this, a support person can quickly fill in all the commonly added information onto a data card.

ReferenceCopy - creates a Search command button next to the attribute data field for locating and retrieving data from the referred data card to the referrer data card.

ReferenceDataCopy - copies data from target data card in addition to creating a link to that data card when the datacard is saved.

ReferenceTargetCopy - copies target data cards from the configured reference and sets its attribute to refer to the copies.

ReferenceTargetFinder - looks for a matching target data card. The criteria for the search is defined by attribute metadata pairs.

ReferrerCounter - is used to count the amount of data cards that refer to the same parent data card. It shows the total number of referrers in the parent attribute's data field.

SLADeadline - calculates the deadline of an issue by selecting the strictest deadline attached to the issue.

SLAFinder - tries to find the strictest deadline of SLA cards defined by metadata. Multiple paths can be configured.

TargetDeleter - deletes the target data card when the reference is removed.

TextNote - makes it possible to add specially formatted notes into a text attribute.

TicketReservation - allows a support person to reserve an issue to oneself. The reserve-button created by this handler is in use in both view and edit mode of data card.

TimeZone - generates a dropdown list for user to select a value from available time zones.

Validator - uses a Python expression in validating a value in the parent attribute. The handler evaluates the expression and displays an error if the expression returns a false value.

ValueButton - sets static values in data card view mode.

ValueChangeMonitor - monitors value changes of a target attribute. It stores data about the value, when it has been changed, who has made the change, and for how long the value has been same. The values are hidden, but when a user clicks the Show link in the data card view, the values become visible.

Worklog - allows attributes to be saved as multi-value data and present the data as separate comment items in the UI. Each comment item contains the comment's author, created time and content. A comment cannot be deleted.