Timeline sub item

Use the Timeline Sub Items related list to define child spans for the timeline, based on records in a table that references the parent timeline's table.

About this task

This can be used to generate a hierarchical relationship starting from a timeline page to any number of levels. For example, if there is a timeline page for a release, a sub item might be sprints, and a sprint might have stories as a sub item.

To create a new sub item:

Procedure

  1. Navigate to System UI > Timeline Pages.
  2. Open the timeline page for which you want to add a sub item.
  3. Go to the Timeline Sub Items related list and click New.
  4. Fill in the the form as described in the table and click Submit.
    The Timeline Sub Item form provides the following fields.
    Table 1. Timeline Sub Items
    Field Definition
    Parent [Read-only] Identifies the parent of the timeline sub item.
    Name Enter a unique name that describes the function of this timeline. For example, Sprints for High Priority Changes.
    Table Select the table called by this timeline. The selected table must have at least one reference field to the table selected for the parent timeline page. For example, if the parent timeline page uses the Scrum Release [rm_release_scrum] table, you might choose the Sprint [rm_sprint] table for a timeline sub item.
    Start date field Select a time-related field from the specified table to use as the start date for the timeline. For example, Planned start date.
    End date field Select a time-related field from the specified table to use as the end date for the timeline. For example, Planned end date.
    Parent Reference Column Select a reference field on which to base the timeline connection between the sub item records and the parent records. If multiple reference fields are available, choose the reference field that forms part of the hierarchy to be modeled by this timeline. If this list is blank, the sub item table contains no reference fields to the parent table. In this case, you must choose a different table for the sub item.

    ServiceNow uses the parent reference column to determine which records are displayed at each level of the timeline.

    Display Options
    CSS span color Enter a custom span color using any CSS color format, such as RGB or hexadecimal. If this field is blank, the default span color, light blue, is used.
    Span text fields Select fields from the specified table to have those values appear as span labels. For example, you might select Number and Short description. The span labels also appear in the left pane if the timeline displays the left pane.
    Tooltip text fields Select fields from the specified table to have those values appear as tooltips. For example, you might select Category, Assigned to, and Due date.
    Filtering and Sorting
    Condition builder Create a condition to filter the results that appear in the sub item. For example, you might create a condition that displays only active, high priority incidents.
    Perform custom sort Select this check box to enable custom sorting. Configure the sort order by selecting fields in the Sort by and Sort by order fields.
    Sort by Select any field in the list for sorting the spans in the timeline. Common practice is to select either the Start date field or the End date field as the sorting field. If you select a different sorting field, also include that field in the list of Tooltip text fields to give users a way of discovering the sort criteria.
    Sort by order Select the sort order for the sorting fields selected.
    Interactive options
    Allow horizontal moving? Select this check box to permit users to drag timeline spans horizontally. Dragging changes the start and end dates and updates the record.
    Allow start time dragging? Select this check box to permit users to update the record by dragging the start time of a span.
    Allow end time dragging? Select this check box to permit users to update the record by dragging the end time of a span.
    Restriction Specify the behavior when dragging a child span (available only if no Range calculator was specified for the parent timeline page).
    • None: No restriction is in place.
    • Restrict by parent: Child span can be moved only within the time frame defined by the parent span.
    • Update parent: Parent span is updated when the child span is moved outside the time frame defined by the parent span.