Activity formatter The activity formatter provides an easy way to track items not saved with a field in the record, for example, journal fields like comments and work notes. The activity formatter is enabled by default on the Task [task] table and other tables that extend the Task table, such as the Incident [incident] table. It is also enabled on the Approvals [sysapproval_approver] table. You can filter the content that appears on the activity formatter and participate in the record feeds on the record. You can create an activity formatter for any form and configure properties that control what fields appear in the formatter. In UI16, the activity formatter shows updates in real time so you can see the latest information without refreshing the form. User presence enables you to see when other users are entering comments. Figure 1. UI16 activity formatter Figure 2. UI11 activity formatter Create an activity formatter You can create an activity formatter for any audited table. Before you beginRole required: admin Procedure Navigate to System UI > Formatters. Click New. Enter a name for the formatter, such as Activities (task). Select a Table. Enter activity.xml in the Formatter field. Leave the Type as Formatter. Click Submit. Result Note: You can create more than one activity formatter for a table, however, the system does not allow you to add more than one activity formatter to a form. What to do nextAdd the new activity formatter to forms as needed. Add the activity formatter to a form Add an activity formatter to any form to track journal fields on the form. Before you beginRole required: personalize_form Procedure Verify that the table associated with the form is audited. Configure the form layout to add Activities (filtered). Note: In UI16, you cannot place another field in between a journal field and the activities formatter. The Activity Stream is built to keep journal fields stacked on top of the activity formatter. Note: Field styles are not applied to comments and work notes fields used with the activity formatter. Styles for these fields can be set using the glide.ui.activity_stream.style.comments and glide.ui.activity_stream.style.work_notes system properties located on the sys_properties table. Enable the Live Feed-Activity toggle The Live Feed-Activity toggle allows users to switch between the activity feed and the document feed for a record. Before you beginRole required: admin About this task Use live feed to interact with other users on a record by posting messages and adding attachments to the feed. Use the activity formatter to see an overall summary of activity for the record. Figure 3. Live Feed/Activity toggle The glide.ui.show_live_feed_activity property is enabled. Navigate to Collaborate > Feed Administration > Properties and enable the Toggle the display of the live feed tab in the activity formatter option. Procedure Verify that the live feed and record feed plugins are active. View the form to ensure that the activity formatter is visible. If not, configure the form to add it. Set the live_feed dictionary attribute to true on the form. This action adds live feed to the activity formatter. Complete the following steps to enable the system property. Navigate to Collaborate > Feed Administration > Properties. Enable the Toggle the display of the live feed tab in the activity formatter option (glide.ui.show_live_feed_activity property). Customize activities You can customize which fields appear in the activity formatter. You can add or remove fields from the list of activities that users can select when they open the activity filter. Before you beginRole required: personalize_form About this task Figure 4. Customize the fields that appear in the activity filter Note: In the UI15 interface, a the number of updates to each field was shown in parentheses to the left of each field. This has been removed in UI16. Procedure Perform the appropriate action for your version of the UI: UI16 Click the activity filter icon (). At the bottom of the list, click Configure available fields. UI15 or UI11 Right-click the Activity header and select Configure Activities. In the slushbucket, select the desired fields in the Available column and move them to the Selected column. The activities appear in alphabetical order, regardless of the order in the Selected column.Note: In UI16, Configure available fields is responsible for the order of the Additional Comments and Work Notes fields. Click Save to add them to the activity formatter and the filter. What to do next Administrators can also modify the system property Incident activity formatter fields(glide.ui.incident_activity.fields). Access this property through System Properties > UI Properties. The system automatically synchronizes the values in the system property and the selections you made. Configure roles for viewing emails in the activity formatter The system property glide.ui.activity.email_roles enables you to control which roles can see emails in the activity formatter. Before you beginRole required: admin About this task In the activity formatter, users see activity only for fields they have permission to read. For example, self-service users might see the activity formatter on the self-service view of the Incident form, but they do not see work notes, unless security rules have been customized to allow this. If the Sent/Received Emails field is included in the activities list, all users see all emails. No determination is made whether an end user, for example, should see an email containing work notes. Configure this property to restrict this capability to specified roles. Note: Email does not appear as an activity until it is sent. If email properties are not configured for outbound delivery, the message can be found by navigating to System Mailboxes > Outbox. Procedure Navigate to System Properties > UI Properties. Locate the property labeled List of roles (comma separated) that can view emails in the Activity Formatter when "Sent/Received Emails" are included. Add roles to the property, separated by commas. These are the only roles that can see email in the activity formatter. All other roles are prevented from seeing email. If no roles are listed, all users can see email. The itil role is on the list by default. Click Save. Configure the max activity size property Use the glide.max_activity_size property to increase the amount of content that can be visible in the Activity Formatter. Before you beginRole required: admin About this taskThe default size for an activity is 100 * 1024, which causes large amounts of content to be hidden in the Activity Formatter. You can change the default value by adding the glide.max_activity_size property. Procedure Type sys_properties.list in the Application Navigator. Click New and enter the following values. Field Description Name glide.max_activity_size Type integer Value 102400Use this field to increase the number of content allowed in the Activity Formatter. This value should be in bytes, for example 100 * 1024, or 102400. Configure email reply for the activity formatter The system property glide.ui16.emailStreamResponseActions determines whether a user can reply to email using the email reply button in the activity stream. Before you beginRole required: admin About this taskIn UI16, the email_reply UI macro is no longer available. You can use the glide.ui16.emailStreamResponseActions instead. Procedure In the navigation filter, type sys_properties.list. Add the following system property. For more information on adding a system property, see Add a system property. FieldDescription Name glide.ui16.emailStreamResponseActions Description Add the email reply button to the activity stream Type true | false Value Set the value to true. The default value if this property is not configured is false. Click Submit.