FI Finnish
SE Swedish
FR French
PL Polish
DE German
US English (US)

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

English (US)
FI Finnish
SE Swedish
FR French
PL Polish
DE German
US English (US)
  • Log in
  • Home
  • Platform
  • ESM
  • Other Technical ESM Documentation
  • Handler Documentation

Handler - Worklog

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Service Management
    Matrix42 Professional Solution Matrix42 Core Solution Enterprise Service Management Matrix42 Intelligence
  • Identity Governance and Administration (IGA)
    IGA overview IGA solution library
  • Platform
    ESM ESS2 ESS Efecte Chat for Service Management Integrations Add-ons
  • Release Notes for M42 Professional, IGA, Conversational AI
    2026.1 2025.3 2025.2 2025.1 2024.2 2024.1 2023.4 2023.3 2023.2 2023.1 2022.4 2022.3 Release Information and Policies
  • Other Material
    Terms & Documentation Guidelines Accessibility Statements
  • Services
+ More

    • Service Management

    • Identity Governance and Administration (IGA)

    • Platform

    • Release Notes for M42 Professional, IGA, Conversational AI

    • Other Material

    • Services

Handler - Worklog

Worklog handler allows attributes to be saved as multivalue data and present the data as separate comment items for UI. Each comment item contains the comment's author, created time and content. Each comment cannot be deleted, However it can be marked as Read or Unread from UI. Newly added comment will be appended to existing comments by chronological order.

Worklog handler does not need any configuration for metadata.

Once attribute uses this handler, the data stored in the attribute will be formatted as JSON object. Therefore it is not allowed to add Worklog handler to a particular attribute that already has existing values. In addition, default value of attribute with this handler should be kept as empty.

Default label for Worklog handler's button is value of presentation text button_new + attribute's name in lower case. Label value can be overwritten in template's localization editor.

 

Table 1. Attribute Settings

Handler name Datatype
Worklog Text

Table 2. Optional Attribute Metadata

Name Value Description
Hide existing logs in edit mode true/false (Default is false) If true, existing comments are hidden in data card edit mode. This saves space in data card editor.
Ignore data card lock (true/false) true/false (Default is false)

By default, adding a worklog comment will lock the data card momentarily. If another user is editing the data card at the same time, adding comments is not possible. When this setting is set to true, no locks are taken or checked, allowing comments to be added even when another user is editing the data card.

When this setting is true, adding comments does not trigger a full data card save: listeners, handlers, and workflows are not executed. This means for example that the Last updated -timestamp will not be changed. If the worklog attribute is used in integrations, enabling this setting is not recommended.

true: Full save is not triggered when adding a comment, and for example the Last updated -timestamp will not change. false: A full save is triggered when adding a comment, executing listeners, handlers, workflows including updating the Last updated -timestamp.
Show as tabs (true/false) true/false (Default is true)

Attributes using handlers with the metadata "Show as tabs" are always displayed at the top of the class in the new Agent UI (2023) regardless of the ranking.

NOTE: This setting applies only for the new Agent UI (2023)

Determines whether the attribute with the EntityStateMail handler is shown with tab layout.

The following criteria determines whether tabs are shown:

There must be at least two attributes with the Comment handler, Worklog handler or EntityStateMail handler in the same class.
The attributes must have the showAsTabs setting enabled.
The default value of showAsTabs is true.

If the value of showAsTabs is false, the attributes are shown as any other attributes.

In case there is any attribute in between two or more attributes shown on tabs (attributes with EntityStateMail, Worklog or Comment handlers), the attribute is shown below the tabs.
Show button for adding new comments (true/false) true/false (Default is true)

NOTE: This setting applies only for the new Agent UI (2023)

Determines whether the button for adding new comments is shown. This allows admins to set the Worklog attribute to a read-only mode.

 

worklog handler operator journal

Was this article helpful?

Yes
No
Give feedback about this article

Table of Contents

Related Articles

  • Overview of the Handlers
  • EQL Editor
  • Attribute Metadata - ShowCode
  • Attribute Metadata - PrintTemplateName
  • Attribute Metadata - ReferenceSearchFilter

Copyright 2026 – Matrix42 Professional.

Matrix42 homepage


Knowledge Base Software powered by Helpjuice

0
0
Expand