Journal field type

There are three types of journal field: journal, journal_list, and journal_input.

Table 1. Journal field types
Journal field types Description
journal Allow and store input, and display the combined inputs below the input box. Journal fields display in the activity stream in the form and in the list view.
journal_input Allow and store input, but do not display the combined inputs. Journal input fields only display with the record they are associated with, so they do not display in the activity stream on the list view.
journal_list Do not allow or store input; they merely display the contents of other Journal fields upon which the journal_list field is dependent. If a journal_list field is dependent on more than one Journal field, it will chronologically interweave those fields' inputs. The journal_list field does not display content within the activity stream, but rather in a separate block.
Figure 1. Journal fields examples on a form
Example of each journal field type

The example image contains the three available journal field types. The first is a journal field, with its inputs displayed below the field. The second is a journal input field, which does not show its previous inputs. The third is Journal list field, which is configured to show the input from the journal input field above it.

Restricting journal entries sent in a notification

Administrators can control the number of journal entries notifications include with the following system property.

Property Label Description Number of journal entries (Additional comments, Work notes, etc.) included in email notifications (-1 means all).

Specifies the number of entries from a journal field (such as Additional comments and Work notes) included in email notifications. A value of -1 includes all journal entries.

  • Type: integer
  • Default value: 3
  • Location: System Properties > Email

Code for getting the contents of a journal field into an array

To put the contents of a journal field into an array so that you can iterate through each entry, you can use the code in this page.

var notes = current.work_notes.getJournalEntry(-1);
//gets all journal entries as a string where each entry is delimited by '\n\n'
var na = notes.split("\n\n");

//stores each entry into an array of strings
 for (var i = 0; i < na.length; i++)                 

Journal field script values

The setValue() method is not supported for journal fields. Instead, assign values in script as in the following example.

var gr = new GlideRecord('incident');
//query priority 1 incidents in the state of either 'new' or 'active'.
gr.addQuery('priority', 1);
var gc = gr.addQuery('state', 1);
gc.addOrCondition('state', 2);
//print a list of the incident numbers updated
//add an entry to the 'work notes' journal field for each incident
gr.work_notes = "This is a high-priority incident. Please prioritize.";