Configure the Upcoming section on the landing page

Freigeben Version: Australia

Aktualisiert 12. März 2026

4 Minuten Lesedauer

Configure the data displayed in the Upcoming section.

Vorbereitungen

Role required: admin

Warum und wann dieser Vorgang ausgeführt wird

Using an extension point, you can call the custom scripts to extend the functionality of the Upcoming section and also easily integrate customizations without having to alter the base code. For information about extension points, see Creating and adding a scripted extension point.

Tabelle : 1. Scripted extension points for the Upcoming section in the base system
Extension point	Description
sn_sow.UpcomingLinkProvider	Gets a list of upcoming task records (changes, incident, requests, and overdue tasks) for the same day and the next day.

Prozedur

Navigate to All > System Extension Points > Scripted Extension Points.
From the Extension Points list, select sn_sow.UpcomingLinkProvider.

Create an implementation using the Create Implementation related link or edit an implementation from the Implementations related list.

Following is an example of how to add a new announcement type for change tasks.

Name: MyCustomUpcomingLinkProvider_ChangeTask

Script:

 var PREFIX_QUERY = 'active=true^' + assignToQuery; 

        var TODAY_QUERY = '^planned_start_dateONToday@javascript:gs.beginningOfToday()@javascript:gs.endOfToday()'; 

        var TOMORROW_QUERY = '^splanned_start_dateONTomorrow@javascript:gs.beginningOfTomorrow()@javascript:gs.endOfTomorrow()'; 

        var encodedQuery = null; 

        var listTitle = gs.getMessage("Change_Task"); 

        if ('beginningOfToday' == request.from && 'endOfToday' == request.to) { 

            encodedQuery = PREFIX_QUERY + TODAY_QUERY; 

        } else if ('beginningOfTomorrow' == request.from && 'endOfTomorrow' == request.to) { 

            encodedQuery = PREFIX_QUERY + TOMORROW_QUERY; 

        } else { 

            throw gs.getMessage("Unsupported date range"); 

        } 

        var LIMIT = 10; 

        var changeTaskGr = new GlideRecordSecure('change_task'); 

        changeTaskGr.addEncodedQuery(encodedQuery); 

        changeTaskGr.setLimit(LIMIT + 1); 

        changeTaskGr.query(); 

        var count = changeTaskGr.next() ? changeTaskGr.getRowCount() : 0; 

        var items = []; 

        if (count > 0) { 

            var msg = null; 

            if (1 == count) { 

                msg = gs.getMessage("{0} change task", [count]) + ""; 

            } else { 

                if (count > LIMIT) { 

                    msg = gs.getMessage("More than {0} change task(s)", [LIMIT.toString()]) + ""; 

                } else { 

                    msg = gs.getMessage("{0} change task(s)", [count]) + ""; 

                } 

            } 

            var route = { 

                route: 'simplelist', 

                fields: { 

                    table: changeTaskGr.getTableName() 

                }, 

                params: { 

                    listTitle: listTitle, 

                    query: changeTaskGr.getEncodedQuery() 

                } 

            }; 

            if (1 == count) { 

                route = { 

                    route: 'record', 

                    fields: { 

                        table: changeTaskGr.getTableName(), 

                        sysId: changeTaskGr.getUniqueValue() 

                    } 

                }; 

            } 

            var item = { 

                label: msg, 

                type: 'route', 

                value: route, 

                "startsWith": { 

                    "icon": "change-outline", 

                    "align": "center" 

                }, 

                "opensWindow": false, 

                "configAria": {}, 

                "download": false 

            }; 

            items.push(item); 

        } 

        return items;

Select Update and save the script include record.
Create a task to verify if it is displayed as an upcoming task.
For example, create a change task.
1. From the All menu, navigate to change_task.list.
2. Select New.
3. Specify the required information.
  - Short Description
  - Description
  - Planned start date. You can specify today's date.
  - Assigned to. Specify the user for whom the upcoming task should appear.
4. Select Submit.
5. Verify that the task appears in the Upcoming section of the Service Operations Workspace landing page for the selected user.