Activity Log
On this page
A record's activity log contains entries added through workflow actions. Run an action on the record to add an entry; the list itself has no command for adding one. Each entry can have its own attachments, separate from the record's attachments. See Attachments.
Activity log in the Web App
Where the activity log is
On Incident, Problem, Change Request, Service Request, and Work Order records, the activity log is the last part of the General tab, below the Description, not a tab of its own; these records also have a separate History tab. On Project Task records, the activity log is also on the General tab, and the task has a separate History tab. On Service, SLA, Service Catalog Item, Project, Approval Stage, and Reservation records, and on every other record that has an activity log, the activity log is an Activity tab of its own. The forms of Stock Room, Brand, Company Address, Software Product, Vendor Product, Approval Request, PO Item, Invoice, and Invoice Item records have no activity log.
When your personal setting to show a record's activity on a separate tab is on (it is off by default), on these six kinds of records the activity log moves from the General tab to an Activity tab of its own, which becomes the second tab. Records that already have an Activity tab stay as they are.
What you can see and change
You can edit an activity entry only when all three of these hold:
- You have the right to manage activities for the record's class.
- The entry has a category.
- The record can be edited.
The delete icon of an entry is disabled, with its own hint, when the entry is read-only or the record's form cannot be edited. Otherwise, before the delete confirmation appears, the server is asked whether the entry can be deleted; when it returns a message, you see that message instead of the confirmation.
When the record's form has unsaved changes, you are asked to save or discard them before you edit or delete an entry.
Add an activity entry
The activity list has no button for a new entry, in either Table or Cards mode, and the Activity panel opens only an entry that already exists. You add an entry by running a workflow action on the record.
In a new database created with the Default Workflow (see Default Workflow Configuration), the action for a free-form entry is Add Comment, which most classes carry, among them Incident, Change Request, Service Request, and Work Order records. On an Incident:
- In the Action Bar, in the Communication group, click Add Comment.
- In the Add a Comment form, type the entry's text in Comment, which is required.
- Optionally, under Additional, enter Time Spent, select Publish to Self-Service Portal to show the entry to the requester (the check box is cleared when the form opens), and attach files in Attachments.
- Click Submit. The comment is added to the activity log as a new entry.
Log work on a record
On a record's full form, its workflow actions are shown in the Action Bar, on the form's toolbar, or in both, depending on where each action is placed; an action placed in neither is not shown on the form. An action that is not available in the record's status or condition is either hidden or shown disabled, according to one system-wide setting. For running an action and filling in its form, see Perform Actions on Records.
In a new database created with the Default Workflow (see Default Workflow Configuration), Incident, Problem, Change Request, Service Request, Work Order, and Project Task records carry three actions for recording work: Log Work, Automatic Timer On, and Automatic Timer Off. An upgraded database need not have these actions, and an administrator may have changed them.
- On an Incident or a Problem, Log Work is offered in every status except Closed, and only to the record's assignee. When the record is Assigned, the action moves it to In Progress; in any other status, the status stays as it is.
- On a Change Request, a Service Request, or a Work Order, Log Work is offered in every status except Closed, and only to the record's assignee. It is in the Communication group of the Action Bar. It is available to the Administrator (Workflow) and Administrator (Full) roles and, on a Change Request, to the Change Request Manager and Change Request Technician roles; on a Service Request, to the Service Request Manager and Service Request Technician roles; on a Work Order, to the Service Desk Manager, Service Desk Technician, Problem Manager, Problem Technician, Change Request Manager, and Change Request Technician roles. Its form requires a Comment and offers Time Spent, Attachments, and a check box to select when you have made contact about the ticket: Responded to Requester (contact with the requester) on a Change Request or a Work Order, and Responded to Customer (contact with the customer) on a Service Request. The Service Request form also offers Publish to Self-Service Portal. The check boxes are cleared when the form opens. Click Submit to log the work.
- On a Project Task, Log Work is offered only when you are the task's assignee. Its form, "Log your Work", requires a Comment and a Percentage Complete, which starts with the task's current percent complete, and offers Time Spent. The action logs "Work was logged", saves the percent complete to the task, and notifies the task's followers and collaborators. Depending on conditions of its own, it can also set the task to In Progress and update the parent project.
The automatic timer is two activity entries and the time between them:
- Automatic Timer On is offered while the timer is not running. It asks only for an optional Comment, and its form reads "NOTE: Remember to turn the automatic timer off to avoid incorrect time spent entries." It logs "Automatic Timer was Turned On".
- Automatic Timer Off is offered while the timer is running. It logs "Automatic Timer was Turned Off" with a time spent equal to the minutes from the latest "Automatic Timer was Turned On" entry to now.
- On a Project Task, both timer actions are offered only in the Assigned and In Progress statuses.
Most of the supplied actions also carry a Time Spent field, so the time you enter when you run them is recorded on the activity entry they log.
Other supplied actions log entries of their own, which you then see in the activity list:
- On an Incident, Assign to me logs "Current User assigned to self". Assign to... logs "Record was assigned"; its form, "Assign this Incident", offers a Comment and Time Spent.
- The close actions of the Incident, Problem, Change Request, Service Request, Work Order, Project Task, and Project log "Marked as 'Closed'" ("Marked as Closed" on a Service Request).
Show an activity entry to the requester
On Incident, Service Request, Work Order, and Reservation records, the activity list has a Published column, and the header of the Activity panel has a Published switch. The switch is disabled while the entry is read-only. On every other class, the control is absent.
Turning Published on makes the entry visible to the requester. In a new database created with the Default Workflow (see Default Workflow Configuration), an action can also publish the entry it logs: the forms of Add Comment on an Incident and of Log Work on a Service Request offer a Publish to Self-Service Portal check box (see Add an activity entry and Log work on a record).
In the Self Service Portal, a ticket's published entries appear in the History section of the ticket's page, newest first. An entry that is not published does not appear, and the section is absent while the ticket has no published entry. Each entry shows the author's avatar and full name, the date and time it was created, and its text, or, for an entry with no text, the name of the activity that produced it, such as "Requester was notified". An entry with attachments shows a paperclip that lists them. The requester does not see the entry's category, time spent, number, or Published setting. For how the requester reads the history, see Track Your Tickets.
Read the activity list
The activity list shows each entry with the author's avatar, the category, a relative time, the entry number, and the author. The exact date and time appear in a tooltip when you hover. A long entry is collapsed and gets a chevron to expand it. The Web App keeps a loaded activity list for a minute, and switching back to its browser window does not reload it.
- An entry with no text of its own, such as one the workflow logged, shows the name of the activity that produced it instead, so it is never blank.
- When workflow changes the record's status, the entry that the workflow run logs records the old and the new status. The status badge in the header of the entry's Activity panel then shows both.
- Click the author's avatar or name to preview the person; Ctrl+click opens the person's record in a new tab. Entries written by the service do not offer this.
- An entry with attachments shows a paperclip. Click it to list the attachments; opening an attachment from there downloads it.
- The pin marks an entry as pinned or not; a pinned entry has a distinct top border.
- Copy Link copies a link to the entry, both as plain text and as a link captioned with the record's OID and the entry's number after a # sign. Opening that link scrolls the activity list to the entry and selects it, in either mode.
The list's toolbar has two buttons, Table and Cards. Your choice is saved to your settings, so every record opens its activity in the mode you chose last.
- In Cards, a click on a card selects it and a second click clears the selection. The toolbar adds Sort, Collapse All, and Expand All, which are disabled while no card is shown.
- In Table, the toolbar adds a Delete button and an Export button. Delete, like the delete icon, first asks the server whether the entries can be deleted.
In both modes, Search reveals a Filter activities... box. The box narrows the entries that are already loaded, by a case-insensitive match on the author's name or the entry's text (or, for an entry with no text, the activity name). The box does not query the server.
The list shows one chip for each view of the activity list. Shared and personal views have chips with different icons and colors, and a hidden view's chip is dimmed and shown only when hidden views are shown or the view is selected. Chips that do not fit collapse into a +N chip, and at least one chip is always visible. The chips start with the open view, followed by the others by name. Picking a view from the +N list moves its chip to the front; clicking a visible chip keeps the order. The card sort order, newest first by default, is saved with the view.
Open and edit an activity entry
- Open the entry: in Cards, double-click the entry's text or click its Open icon; in Table, open the row.
- The entry opens in a half-width panel titled Activity. Its header shows the entry number, a status badge (with the old and new status when the status changed), the author, and the date.
- Change the entry on its tabs:
- General holds the rich-text Details, the Time Spent duration, and, when configured, a Category.
- Custom Data appears only when the class has user-defined fields placed there.
- Attachments always appears, with a count of the entry's attachments.
- Click Save. It is enabled only when you have changed something and the entry is not read-only.
If you close the panel with unsaved changes, you are asked to confirm.
On the entry's Attachments tab, Save downloads the selected attachments that are files. It checks the first selected file first; if that check fails, nothing is downloaded and an alert reads "An error has occurred while downloading the attachment. Please try again. If the error persists, please contact your Alloy Navigator administrator." The tab has no Delete button.
Review a record's history
The History tab of a record lists the record's recorded changes. It has no actions button.
In a new database created with the Default Workflow (see Default Workflow Configuration), the tab offers six shared views: List, by Change Date, by Changed by, by WF Item #, Executed Actions, and Object Changes. Each shows the change date, who made the change, the action, the attribute, the old and new values, and the workflow item number; none of them shows the workflow action number, which the panel of a change shows. When no current view has been saved, the tab opens on List.
To see one change in full:
- On the History tab, open the change's row: click it, double-click it, or use Open.
- The change opens in a panel titled History, without leaving the record. The panel shows Change Date, Changed by, Action, Attribute, WF Item #, and WF Action #, then the Old Value and the New Value as plain text.
- For a change to a rich-text field, click the maximize icon on the old or the new value to see the full value in a dialog of its own. A change to any other field shows only the plain text.
A middle-click on a row's link opens a new browser tab instead of the panel, and the row's right-click menu keeps its item for opening the row in a new tab.
Search activity and history
Activity text is full-text indexed. An object search with the activity option also matches the text of the records' activity entries, and with the history option it also matches the old values recorded in the records' history. An Everywhere search includes the activity log but never the history.
How time spent adds up
The time of a record's activity entries adds up to the record's own totals:
- On an Incident, Problem, Change Request, Service Request, or Work Order, the record's time spent is the sum of the time of its own activity entries. Its cumulative time spent adds the activity time of every Work Order below it, at any depth.
- On a Project Task, the task's time spent is its own activity time plus that of every task below it, at any depth.
- The totals are recalculated when an entry's time is added or changed and when an entry is deleted. Moving a Work Order to another parent recalculates the cumulative time spent.
- On a Project, cumulative time spent includes entries logged on the project and on its descendant tasks. It is recalculated when tasks are moved to another parent or a task's time spent changes. The project's cumulative time spent is read-only.
In the Web App, the two totals are in the Performance panel of the General tab on Incident, Problem, Change Request, and Service Request records, and in the Prioritization panel of the General tab on Work Order records.
Related topics
- Attachments - the attachments of a record.
- Track Your Tickets - what a requester sees of a ticket.
- Approvals
- Perform Actions on Records - running an action and filling in its form.
- Default Workflow Configuration - the supplied configuration that the work-logging actions come from.