Introduction To ServiceNow
Introduction To ServiceNow
Introduction To ServiceNow
Part 1 of 2
PDF generated using the open source mwlib toolkit. See http://code.pediapress.com/ for more information.
PDF generated at: Sun, 29 May 2016 06:01:09 PST
ServiceNow Basics
ServiceNow Basics
Overview
The articles in this category help employees, IT support staff, and ServiceNow administrators use the ServiceNow interface and perform
self-service activities.
User Interface
Self-Service
Navigate and use the standard user interface. Use self-service features like homepages and knowledge articles.
Using Forms
Using Lists
Searching
[more]
Homepages
Knowledge Base
Service Catalog
[more]
Reports
View and create reports.
Creating Reports
Standard Reports
Report Types
[more]
Technical Support
Overview
ServiceNow offers world-class customer support to every customer. Quick solution paths can be found using
customer support tools such as user forums [1], blogs [2], product documentation [3], and useful solutions [4]. The
Customer Support team is comprised of trained, experienced professionals with deep product knowledge and
real-world experience. The goal of our customer support effort is to help your team resolve issues as quickly as
possible.
For complete information about contacting Customer Support, see Customer Support [5].
For information about how to request new features and functionality, see Requesting ServiceNow Product
Enhancements [6].
Technical Support
References
[1]
[2]
[3]
[4]
[5]
[6]
References
[1] https:/ / hi. service-now. com/ kb_view. do?sysparm_article=KB0547244
Upgrade History
Upgrade History
Overview
The upgrade history module tracks every upgrade made to an instance. Every record that is examined during an
upgrade is tracked, and the action taken on each record (such as whether the record is updated) is tracked as the
disposition. Administrators can use the upgrade history module to locate and resolve upgrade conflicts and to revert
customizations to out-of-box versions.
Upgrade History
An upgrade history record is created for each upgrade that is run. To view an upgrade history record, navigate to
System Diagnostics > Upgrade History.
This record provides the following fields:
Field
Input Value
From
To
Upgrade
started
Upgrade
finished
Inserted
Updated
Deleted
Skipped
Total
Upgrade
Details
Related list that tracks every record affected by the upgrade. Open one of these records to compare the out-of-box and customized
versions. The upgrade process automatically skips changes to customized objects.
Upgrade History
Upgrade Details
A record is created for every file in an upgrade. Open one of these records to see what has changed and decide
whether to revert your customizations. The upgrade details form displays a side-by-side comparison of the
customization and the corresponding out-of-box version. Modifications, additions, and deletions are marked by a
color code.
The detail record provides the following fields:
Field
Input Value
Disposition
Type
Target name
File name
File differences Comparison of the file in the upgrade with the customized version.
Changed
Indicates whether the file has changed since the last upgrade. To see this field, configure the form.
Disposition
The Disposition field tracks the action taken on each record, such as whether the record is updated. The upgrade
process automatically skips (disposition of Skipped) customized objects. To apply a skipped update, see Reverting
Customizations.
The following dispositions are possible:
Upgrade History
Field
Input Value
Inserted
Updated
Deleted
Skipped
An upgrade component was not applied because the customer had customized the component.
Reverted
Unchanged A baseline component has not changed since the last release (available starting with the Eureka release)
File Names
Administrators can use the file name to identify what components have been updated or skipped. Update records
follow one of the following naming format conventions.
Formatting convention
Examples
Business Rules
Modules
sys_script_4a5bf0360a0007040137c500cd65ad24
sys_app_module_9c718a510a0a0b3b76456b6ac5658724
Dictionary
Field Labels
sys_dictionary_sys_sync_history_version_log
sys_documentation_sc_cat_item_producer_service_submission_message_en
Reverting Customizations
When an object is customized, a corresponding record is added in the Customer Updates [sys_update_xml] table.
This table maintains the current version information for all objects that have been customized.
To prevent customizations from being overwritten by system upgrades, the upgrade process automatically skips
changes to objects that have a current version in the Customer Updates table. Starting with the Calgary release, the
upgrade process does not skip these objects if only excluded fields have changed.
You may want to overwrite your customizations when a software upgrade contains a feature that you would like to
implement. To revert a customized object to a system default version after an upgrade:
1.
2.
3.
4.
Upgrade History
Enhancements
Eureka
Provides the unchanged disposition for baseline components that have not changed since the last release.
Calgary
The upgrade process does not skip objects that have a current version in the Customer Updates table when only
excluded fields have changed.
) in the Edge.
) in the banner frame.
Administrators can customize the application navigator to provide different modules by user role, modify or define
applications and modules, and change its appearance.
Navigating Applications
Module Icons
In addition to names, modules in the application navigator also have icons.
UI15 and UI14: each module has a star icon to the left of the module name. Use these stars to identify and view
frequently used modules. For more information, see Using Favorites.
UI11 and Classic: each module is represented by an icon that can be customized.
in UI15,
Roles: similar to the Switch Perspectives option in UI11. Selecting a role filters the available applications by
that role (for example, select ITIL to show only ITIL items such as Incidents, and filter out Asset Management
items such as Asset Portfolio). You must have access rights to the items to see a perspective in the list.
Administrators can customize perspectives. To see all available applications, click All.
Automatically Add Favorites: when enabled, any module that the user selects is automatically marked as a
favorite.
Refresh Navigator: refreshes the list of applications and modules. Administrators who are customizing the
navigator can test their work without refreshing the whole browser session.
Collapse All Applications: collapses all applications so that only application labels appear.
Navigating Applications
Expand All Applications: expands all applications so that all available modules appear.
Note: To increase or decrease font size on pages and menus in UI15, use the browser's zoom controls. In UI14, click the gear icon in
the banner frame.
Using Favorites
In UI15 and UI14, the application navigator has a star icon beside each module name that can be selected (
) or
deselected (
). Use these icons to select frequently used modules and then display only the favorites in the
application navigator.
Click the star icons to select and deselect modules as favorites.
Click the favorites filter icon (
) beside the navigation filter to turn on and off favorite modules. Selecting this
icon shows the favorite modules; deselecting shows all modules.
By default, a module is automatically selected as a favorite when you open the module. To disable this setting, click
the menu icon (
) in the application navigator header and select Automatically Add Favorites from the list to
remove the check mark.
Navigating Applications
10
Tutorials
The following video demonstrates the UI11 application navigator. For more e-Learning videos, see Tutorials.
Using the UI11 Navigation Filter (01:21)
References
[1] http:/ / en. wikipedia. org/ wiki/ Access_key
Navigating by URL
Overview
Users can navigate to a record or module directly by using a URL. This article explains the URL schema by which
the system generates pages.
URL Schema
The basic schema for a system URL is:
https://<base URL>/nav_to.do?uri=<page name>.do?sys_id=<sys_id>%26<page parameters>
Elements
The URL schema consists of the following elements:
base URL: unique, secure Web address for each instance. The default format is:
https://<instancename>.service-now.com.
Customers who want to display a custom base URL in email notifications can set the
glide.email.override.url property.
nav_to.do?uri= (optional): loads the page in the standard interface, with the banner frame on top and the
application navigator on the left.
<page name>.do?: where the page name is the form, list, UI page, or other page to open. To view a list, use
<table name>_list.do.
sys_id=<sys_id> (optional): where <sys_id> is the sys_id of the record to open in form view. To create a new
record, specify a sys_id of -1.
<page parameters> (optional): may specify a query, view, redirection page, and more. Sample parameters are:
sysparm_view=ess: specifies a view (ess).
sysparm_query=number=INC00040: specifies a query (number is INC00040).
sysparm_query=priority=2^active=true: specifies a complex query with two terms (priority is 2 and active
is true).
sysparm_query=priority=2^active=true^EQ^GROUPBYcategory: groups query results (by category).
sysparm_order=number" specifies the field by which to sort (number).
sysparm_order_direction=desc: specifies a sort order (descending).
sysparm_force_row_count=5: limits the maximum number of results (5 records).
Navigating by URL
11
Long URLs
The default URLs by which the system renders pages may exceed the character limit of Microsoft Internet Explorer,
resulting in an error message. To prevent this error, enable tiny URL support, which generates shortened internal
URLs that fall within the character limit.
The Tiny URL Support plugin is activated automatically but is not enabled. Activate this plugin if Microsoft Internet
Explorer displays failure to open page errors during routine operations in the ServiceNow platform.
Property
Description
glide.use_tiny_urls
false
glide.tiny_url_min_length Minimum length of a redirect URL that is turned into a tiny URL
Type: integer
Default value: 1024
Examples
Open a Form with Preset Values
This example opens a new Incident form in the standard interface with a priority of 1 and an incident state of
Awaiting Problem.
Schema:
https://<baseURL>/nav_to.do?uri=<table name>.do?sys_id=-1%26sysparm_query=<field=value>
Example:
https://<instance
name>.service-now.com/nav_to.do?uri=incident.do?sys_id=-1%26sysparm_query=priority=1^incident_state=3
Navigating by URL
12
You can also use JavaScript to access GlideSystem methods. The following creates the same type of incident as
above, and also populates the caller ID with the current user ID:
https://<instance
name>.service-now.com/nav_to.do?uri=incident.do?sys_id=-1%26sysparm_query=priority=1^incident_state=3^caller
Return a File
This example returns a comma-separated value file of records in the Incident table that meet the query conditions.
Schema:
https://<baseURL>/nav_to.do?uri=<table
name>_list.do?sysparm_<sysparmTypeOrField=value>%26CSV
Example:
https://<instance
name>.service-now.com/nav_to.do?uri=incident_list.do?sysparm_query=active=false%26CSV
13
User Interface
Using Lists
Overview
Lists display information from a data table. Users can search, sort, filter, and edit data in lists. Lists also may be
embedded in forms and may be hierarchical (have sublists).
The list interface contains four main elements:
Title Bar
Breadcrumbs
Column headings
Fields
Title Bar
The title bar displays the title of the list
(table) and provides several controls.
Using Lists
14
New: opens a blank form that allows users to create a new record in the list.
Clicking the New button in a filtered list automatically applies the same filter to the new record. For example,
clicking New in the Closed Incidents list opens a new record preset with Active deselected. In a list filtered for
active, priority 1 incidents, clicking New opens a new record preset with Active selected and Priority set to 1
- Critical. You can change the preset values on the form as needed. If there is a field you do not want to have
populated in this way, you can add the following dictionary attribute to the field:
ignore_filter_on_new=true.
Go to or Search: finds information in the current list. For more information, see Finding Information in Lists.
List Activity Stream (
in UI15,
in UI14): shows recent record activity for all records currently displayed
on a list (starting with the Eureka release). For more information, see Displaying Activity Streams.
Using Lists
15
Breadcrumbs
Breadcrumbs offer a quick form of
filter navigation. A filter is a set of
conditions applied to a table in order to
find and work with a subset of the data
in that table. The current filter is
indicated by a hierarchical list of
conditionsbreadcrumbsat the top
of the table. For more information, see
Using Filters and Breadcrumbs.
Breadcrumbs
Column Headings
Column headings appear at the top of a list header. These headings display column names and provide some list
controls. Column headings are stationary at the top of the list and do not scroll with list content in UI15 and UI14.
The column headings provide the
following controls:
Sorting: Click the column name to
sort the list in ascending order.
Click again to sort in reverse order.
An arrow by the column name
indicates the column currently
being sorted as well as the sort
direction. A downward pointing
arrow indicates the column is sorted
in ascending order in UI15 and
descending order in UI14 and UI11.
Column Headings
Note: When sorting by a choice list field, the sort order is determined by the Value of each choice, not by the Label.
List context menu: Access this menu, also called a right-click menu, by clicking the menu icon ( in UI15,
in UI14) at the top of a list column or by right-clicking the column heading. The list context menu offers these
controls:
Sort (a to z) and (z to a): sort in ascending and descending order.
Show Visual Task Board: create a visual task board based on the current list (starting with the Eureka
release).
Group By: aggregate records by a field. For more information, see Finding Information in Lists.
Bar Chart and Pie Chart: create quick bar and pie chart reports based on the filter criteria of the list. Users
can then modify these reports or create gauges (depending on access rights). For more information, see
Creating Reports.
Configure (Personalize in versions prior to Fuji) (requires access rights): provides administrative functions
related to the information displayed and how it is controlled.
Import (administrators only): import data from an XML file.
Using Lists
16
Export: exports data to Excel, CSV, XML (administrators only), or PDF. For more information, see Exporting
Data.
Update Selected and Update All (administrators and list_updater roles only): change applicable field values.
For more information, see Editing Lists.
Personalize List (
in UI15, in UI14 and UI11): customizes the list layout for the current user. For more
information, see Creating Personal Lists.
Search (
in UI15,
Note: Some of the options displayed on the list context menu depend on the user role and the installed applications.
Fields
Fields display data and provide the following functionality.
Links: open the associated record
in form view. Click the reference
icon or first column field to open
the current record. You can also
click a link to a related record in
other columns to go to that related
record.
Editing: changes the information in
one or more records. For more
information, see Editing Lists.
Reference Icon (
in UI15, in
UI14 and UI11): provides detailed
UI11 Fields
information about the record. Point
to the reference icon to open a pop-up window, or click it to open the record in form view. For more information,
see Reference Icon.
Context menu: also called a right-click menu, offers the following options:
Show Matching and Filter Out: provide quick filter options.
Copy URL to Clipboard: copies to the clipboard the URL for the form view of the record. Follow browser
instructions if browser security measures restrict this function.
Copy sys_id (administrators only): copies to the clipboard the sys_id of the record. Follow browser
instructions if browser security measures restrict this function.
Assign Tag (UI15 and UI14) or Assign Label (UI11 and classic): allows the user to assign a new or existing
tag or label to a record, which provides quick access to frequently referenced or urgent information. When a
tag is assigned to a record in UI15 or UI14, the record is displayed on the Tagged Documents page. When a
label is assigned to a record in UI11 or classic, a link to the record is displayed in the application navigator
under the assigned label. For more information, see Tagging Documents (UI15 and UI14) or Creating and
Using Labels (UI11 and classic).
Assign to me, Approve, and Reject: provide quick edit options.
Add to Visual Task Board: allows users to add the selected record to visual task boards they own (starting
with the Eureka release).
Using Lists
17
Note: Some of the options displayed on the field context menu depend on the user role and the installed applications.
Detail Rows
Detail rows, when enabled, appear below the field row for each record and display a specified field's value. For
example, the detail row might display the short description for each incident in a list. Detail rows support the same
functionality as fields, including links, editing capabilities, and access to the context menu.
Administrators can enable detail rows and add them to lists. For more information, see Administering Detail Rows.
Detail rows are available starting with the Fuji release (UI15 or later required).
Note: When a field is designated as the source for a list's detail rows, the system hides the list column for that field.
Modern cell
coloring on
In UI11 and the classic UI, field status indicators on lists are displayed using a field
background color.
All UI versions display field status indicators for mandatory fields only, starting with the
Eureka release. Previous versions also display field status indicators for modified and
read-only fields.
Modern cell
coloring off
Using Lists
18
Pop-Up Forms
Pop-up forms enable you to edit records without leaving the list (starting with the Fuji release in UI15). To display a
pop-up form, press Shift and click a field link or point to the reference icon for a record. You can edit the pop-up
form like any other form.
In the actions choice list, select an action such as Delete (administrators only), Show on Live Feed or Assign
Tag. The available actions vary depending on the list and which plugins are activated.
Using Lists
19
Hierarchical Lists
Lists can have sublists in a hierarchy that can also be accessed in list view. Hierarchical lists allow users to view
records from related lists directly from a list of records without navigating to a form.
To expand or collapse the related lists on a record in a hierarchical list, click the arrow ( ) beside the reference icon.
See Hierarchical Lists for more
information on how to enable and use
this feature.
Embedded Lists
Some lists may be embedded in forms.
Changes to embedded lists are saved
when the form is saved. For more
) or collapse icon (
Navigating to a List
To open a list using the application
navigator, click the list name or type
the table name followed by .list in the
application navigator filter. For more
information,
see
Navigating
Applications.
An embedded list
Using Lists
20
Note: Consider creating bookmarks for commonly viewed lists.
Editing Lists
21
Editing Lists
Overview
Users can edit data in lists using a variety of methods:
Quick edit functions: change applicable field values using the right-click menu.
List editor: edit field values in a list without opening a form.
Multiple records: edit more than one record at the same time using the list editor or an editing form.
), or click Cancel (
Editing Lists
22
Editing Lists
23
) in the upper
To allow the list editor to open for the list, select the Enable list edit check box. Clear the check box to
prevent the list editor from opening for the list.
To open the list editor with a double-click, select the Double click to edit check box. Clear the check box to
open the list editor using a single click.
2. Right-click the column header and select Update Selected or, if you filtered the data, select Update All. An
editing form opens.
3. Enter appropriate values in any of the fields and click Update to save your changes in all selected records.
24
Personalizing a List
To personalize a list:
1. Open the list.
2. Click the personalize list icon (
in UI15, in previous UIs) in the
upper left corner.
3. Use the slushbucket to select the
columns and the desired order.
To display long text on more than one line, select the Wrap column text check box. Clear the check box to
display text on one line.
To condense the vertical space between rows , select the Compact rows check box. Clear the check box to use
standard row spacing.
25
To highlight list rows as the
cursor passes over them, select
the Enable list highlighting
check box. Clear the check box
to restore the static, alternate row
highlighting.
To use updated field status
indicators available in UI15 and
UI14, select the Modern cell
coloring check box. Clear the
check box to use field status
indicators available in UI11 and
the classic interface.
To reset a list to the default layout, click the personalize list icon and select the Reset to column defaults check box.
in UI15,
View Management
26
View Management
Overview
A view defines the elements that appear when a user opens a form or a list. Administrators and users with the
personalize role can define views for any list and form, which view should be visible by default, and which views
pertain to specific user roles.
Users with the admin or view_changer roles can change views.
Examples of Views
For example, this is the Incident form in the Self-Service View:
Note: Views can be used to define base views. UI Policies can modify those views based on context. For more information, see
Creating a UI Policy.
View Management
27
Switching Views
To switch between list views, click the table name at the top left corner of the list, and then select Views > [Desired
View]:
To switch between form views, click the table name at the left side
of the form header, and then select Views > [Desired View]:
Switching views submits the form, which saves all changes and
triggers any onSubmit client scripts that apply. You cannot switch
form views on a new form that has not been saved yet.
When a user switches views, the selected view is saved as a user
preference so the user sees the same view by default when the
form opens. When a user has a view saved as a user preference
and then opens a URL to a record that specifies another view, the
form displays in the view saved in the user preference, not the
Switching views on a form
URL. For example, if a user selects the Mobile view on an
Incident record and then tries to open the following link, which
specifies
the
visual
task
board
view,
the
form
still
opens
in
the
Mobile
view:
https://{instance}/nav_to.do?uri=incident.do?sys_id={sys_ID}sysparm_view=vtb.
The sysparm_view parameter specifies the view to be used for a list or a form, and can be overwritten by a users
stored preference for a view. You can override this behavior by setting the sysparm_view_forced parameter to true.
Administering Views
Several views are included with the base system, including the Default view and Advanced view. All view records
are saved in the UI View [sys_ui_view] table. Every list and form either has a view associated with it or uses the
Default view if no other view is assigned. Administrators can create additional views or modify the base system
views.
Warning: Do not delete any of the base system views.
View Management
28
Creating Views
Administrators can create views to force all users to use a certain view, despite the view specified by the user's
preference.
1. Navigate to the list or form that you want to create the view for.
2. Right click the header and select the appropriate option for your version:
Fuji or later: Configure > List Layout or Configure > Form Layout
Eureka or earlier: Personalize > List Layout or Personalize > Form Layout.
3. Under the List View section, select the view on which you want to base your new view.
The fields visible for that view appear in the Selected list.
4. From the choice list, select New.
The Create New View form appears.
5. Enter the descriptive name of the view.
6. Click OK.
The same fields in the Available column are the same as the first view you based the new view on.
7. Select the fields to appear in this view by adding or removing the fields from the Selected column. You can also
adjust the order they appear on the form by moving the fields up or down.
If you are creating a view for a form, you can select a form section and configure the fields for that section.
You can create views in the same manner when you configure the form to add a related list.
Deleting Views
You can delete any view that you created. Do not delete the base system views.
1. Navigate to System UI > Views.
2. Click the view to delete.
3. Click Delete on the form header.
Description
Name
Match
Conditions
Active
Select this option to apply the view rule according to the conditions you specified. If unchecked, the view rule is not be applied.
Table
View
View Management
29
Device type
Conditions
Exporting Data
Overview
ServiceNow offers a variety of ways for administrators and users with the itil role to export data:
Form export: Export an individual record from the user interface. Choose PDF or XML format directly from a
form.
List export: Export multiple records from the user interface. Choose CSV, Excel, PDF, or XML format directly
from a list.
Scheduled export with reports: Automatically export multiple records from a table on a set schedule. Create a
scheduled job to regularly export data as a report.
Direct URL access: Export multiple records from a table using the ServiceNow CSV, Excel, PDF, or XML
processor. Specify the table form or list you want to export in the URL.
Web services/SOAP: Export multiple records from a table when an external client makes a web services request.
Create an external application or process to automate the retrieval of data from an instance via web services or
SOAP.
Description
Export table records as a comma-separated value text file. Use this option to export the currently displayed fields in the list or form as
a text file. Configure the list or form to add or remove fields from the export. When exported to CSV, dot-walked fields appear using
their full field name, such as u_assignment_group.parent.
Note: By default, ServiceNow exports all CSV files in Windows-1252 encoding. If you need to export translated data, set the
glide.export.csv.charset system property to UTF-8 (starting with Calgary release).
Excel
Export table records as a Microsoft Excel spreadsheet. Use this option to export the currently displayed fields in the list or form as an
Excel spreadsheet. Configure the list or form to add or remove fields from the export.
XML
Export table records as an XML document. Use this option to export all data from a table or all data for a particular record. The XML
file has an XML element for each column in the table.
Export table records as a Portable Document Format file. Use this option to export the currently displayed fields in the list or form as a
PDF file. Configure the list or form to add or remove fields from the export.
For information about HTML and exported lists see Rendering HTML in Exported Lists
Community.
[1]
on the ServiceNow
Exporting Data
30
Note: When exporting PDF data from a form, only the fields added to the current view are exported. Fields present on the form but
hidden by a UI policy are included in the PDF. When exporting XML data, however, all the fields are exported, regardless of the
view. CSV and Excel records cannot be exported from a form.
Note: To export records in an embedded list, export the record containing the list.
Exporting Data
31
CSV
XML
PDF (Portrait)
PDF (Landscape)
PDF (Detailed Portrait): Exports the list and the associated form for each record.
PDF (Detailed Landscape): Exports the list and the associated form for each record.
You
can
display
Related
List
items
on
detailed
PDF
glide.export.pdf.list.related_list system property to true.
reports
by
setting
the
Note: You can control how line breaks appear in exported CSV data using the glide.csv.export.line_break system
property (starting with Dublin release).
Excel
CSV
PDF
PDF (Landscape)
If you need to share data with another ServiceNow instance or integrate with another application, consider creating a
web service or SOAP message instead.
Exporting Data
32
The final URL should look like one of these sample URLs:
URL
Description
https://<instance name>.service-now.com/incident_list.do?CSV
https://<instance
name>.service-now.com/incident_list.do?CSV&sysparm_query=sys_id%3E%3Db4aedb520a0a0b1001af10e278657d27
Export a particular
incident to a
comma-separated value
text file.
https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_order_by=sys_id
[2]
Note: ServiceNow enforces basic authentication
for direct URL access. The data extracted from the URL contains only the fields
to which the currently authenticated user has read access.
Exporting Data
33
URL Syntax
Export Limits
Description
CSV
?CSV
10,000 rows
Excel
?EXCEL
10,000 rows
XML
?XML
10,000 rows
5,000 rows
Schema
?SCHEMA
N/A
XSD
?XSD
N/A
See Export Limits for information about processor export limits and how to work around them if a table exceeds the
export limit.
Note: Export processors return all requested records regardless of whether you use the table.do or table_list.do format to identify
the export table.
Export Processor
URL Syntax
Export Limits
Description
CSV
?CSV
Excel
?EXCEL
XML
?XML
Schema
?SCHEMA
XSD
?XSD
Exporting Data
34
For example, to export a list of all priority 1 incidents as an XML file, use the following URL:
https://<instance
name>.service-now.com/incident_list.do?XML&sysparm_query=priority=1&sysparm_order_by=assigned_to
URL Syntax
sysparm_query=[column
name][operator][value]
Description
Displays a list of records that match the query. For example: https://<instance
name>.service-now.com/incident_list.do?XML&sysparm_query=priority=1
sysparm_order_by sysparm_order_by=[column Sorts a list of records by the column name provided. For example: https://<instance
name]
name>.service-now.com/incident_list.do?sysparm_query=priority=1&sysparm_order_by=assigned_to
You can sort by only one column using sysparm_order_by. To sort by multiple columns, use
sysparm_query=ORDERBY[column name]^ORDERBY[column name]. For example:
sysparm_query=ORDERBYassigned_to^ORDERBYpriority.
Exporting Data
<assignment_group>d625dccec0a8016700a222a0f7900d06</assignment_group>
<business_duration/>
<business_stc/>
<calendar_duration/>
<calendar_stc/>
<caller_id/>
<category>inquiry</category>
<caused_by/>
<child_incidents>0</child_incidents>
<close_code/>
<close_notes/>
<closed_at/>
<closed_by/>
<cmdb_ci/>
<comments/>
<comments_and_work_notes/>
<company/>
<contact_type>phone</contact_type>
<correlation_display/>
<correlation_id/>
<delivery_plan/>
<delivery_task/>
<description/>
<due_date/>
<escalation>0</escalation>
<expected_start/>
<follow_up/>
<group_list/>
<impact>1</impact>
<incident_state>1</incident_state>
<knowledge>false</knowledge>
<location>108752c8c611227501d4ab0e392ba97f</location>
<made_sla>true</made_sla>
<notify>1</notify>
<number>INC0010040</number>
<opened_at>2012-11-28 16:31:08</opened_at>
<opened_by>6816f79cc0a8016401c5a33be04be441</opened_by>
<order/>
<parent/>
<parent_incident/>
<priority>1</priority>
<problem_id/>
<reassignment_count>0</reassignment_count>
<rejection_goto/>
<reopen_count>0</reopen_count>
<resolved_at/>
<resolved_by/>
35
Exporting Data
<rfc/>
<severity>3</severity>
<short_description>test +XB</short_description>
<skills/>
<sla_due/>
<state>1</state>
<subcategory/>
<sys_class_name>incident</sys_class_name>
<sys_created_by>admin</sys_created_by>
<sys_created_on>2012-11-28 16:31:33</sys_created_on>
<sys_domain>global</sys_domain>
<sys_id>4efe74640982300000a286aa871e705a</sys_id>
<sys_mod_count>4</sys_mod_count>
<sys_updated_by>admin</sys_updated_by>
<sys_updated_on>2012-11-28 18:44:11</sys_updated_on>
<time_worked/>
<upon_approval>proceed</upon_approval>
<upon_reject>cancel</upon_reject>
<urgency>1</urgency>
<user_input/>
<variables/>
<watch_list>dfdc91a809c2300000a286aa871e7057,46d44a23a9fe19810012d100cca80666</watch_list>
<wf_activity/>
<work_end/>
<work_notes/>
<work_notes_list/>
<work_start/>
</incident>
...
</xml>
{
// Call to DownloadFile method supplying the URL and location
to save CSV file locally
int read =
36
Exporting Data
37
DownloadFile("https://demo007.service-now.com/incident_list.do?CSV&sysparm_query=priority=1&sysparm_order_by=assigned_to",
"c:\\test\\incident.csv");
}
Exporting Data
38
{
// Read data (up to 1k) from the stream
bytesRead = remoteStream.Read(buffer, 0,
buffer.Length);
// Write the data to the local file
localStream.Write(buffer, 0, bytesRead);
// Increment total bytes processed
bytesProcessed += bytesRead;
} while (bytesRead > 0);
}
}
}
catch (Exception e)
{
Console.WriteLine(e.Message);
}
finally
{
// Close the response and streams objects here
// to make sure they're closed even if an exception
// is thrown at some point
if (response != null) response.Close();
if (remoteStream != null) remoteStream.Close();
if (localStream != null) localStream.Close();
}
// Return total bytes processed to caller.
return bytesProcessed;
}
Export Limits
The ServiceNow platform provides a default upper limit for XML data exports.
The purpose of the upper limit is to avoid creating performance issues when a table is excessively large. If you need
to export more records than the threshold permits, break up the export into separate manageable chunks.
In
addition
to
the
format-specific
limits,
you
may
need
to
set
com.glide.processors.XMLProcessor.max_record_count to match the upper limit set by the
format-specific limit.
Exporting Data
39
Format
XML
glide.xml.export.limit
glide.ui.export.limit
10,000
CSV
glide.csv.export.limit
glide.ui.export.limit
10,000
EXCEL
glide.excel.export.limit
glide.ui.export.limit
10,000
glide.pdf.max_rows
N/A
5,000
glide.pdf.max_columns
N/A
25
Although the number of columns can be set higher than 25 in the PDF export, this is not advisable as only 25 header
labels fit on a page.
A warning threshold property called glide.ui.export.warn.threshold controls how the records are
exported. If a user attempts to export a number of records from a list that exceeds the warning threshold, a dialog box
offers the choice of waiting for the export to complete or having the exported records emailed as an attachment. The
warning threshold can be changed in the system property. The email attachment must not exceed the maximum
allowed email size or configured email attachment size. For more information, see Exported Table Emails.
glide.csv.export.limit = 20,000
glide.ui.export.limit = 10,000
com.glide.processors.XMLProcessor.max_record_count = 20,000
Default export limit for CSV = 10,000
Exporting Data
40
Records to be Exported
Records Returned
15,000
15,000
30,000
20,000
Note: In the second export, the number of records returned from the database is limited because the number of records specified for
export exceeds the value set in the glide.csv.export.limit property.
Records Returned
10,000
10,000
30,000
10,000
Note: In the second export, the number of records returned from the database is limited because the number of records specified for
export exceeds the default export limit for Excel, 10,000 records.
Records Returned
2,000
2,000
10,000
5,000
Note: In the first export, all records are returned because the number of records specified for export does not exceed the
glide.pdf.max_rows property. In the second export, the number of records returned is limited because the number of records
specified for export exceeds the value in the glide.pdf.max_rows property.
Exporting Data
41
https://<instance
name>.service-now.com/syslog_list.do?XML&sysparm_query=sys_id%3E%3Db4aedb520a0a0b1001af10e278657d27&s
Note: URL queries use typical percent encoding [3]. In this example, the greater than sign (>) is encoded as
%3E and the equal sign (=) is encoded as %3D.
7. Continue issuing this query, using the starting sys_id for the next set of records until you have exported all the
necessary records.
The Excel export cell threshold is customizable using the glide.excel.max_cells integer property. Note: Increasing
this threshold may cause a memory issue in your instance. The threshold is set at an appropriate level to prevent
resource issues.
The export will put the information into the Excel document with 32,000 rows per spreadsheet.
Exporting Data
42
7/17/14 15:53:48 (500) EB39A310EB022100C46AC2EEF106FED9 Maximum record
count for this instance is: 10000: , request is for: 0 Cap the Record
count to Maximum Record Count
07/17/14 15:53:48 (522) EB39A310EB022100C46AC2EEF106FED9 Export API ExportProcessor : Processing EXCEL export request,
ExportParameters:TableName=incident, Query=active=true, Limit=10000,
SortBy=null
07/17/14 15:53:48 (527) EB39A310EB022100C46AC2EEF106FED9 Export API ExportProcessor : Export using background thread
07/17/14 15:53:48 (528) EB39A310EB022100C46AC2EEF106FED9 #748
/poll_processor.do -- total transaction time: 0:00:03.357, total wait
time: 0:00:00.000, session wait: 0:00:00.000, semaphore wait:
0:00:00.000, source: 0:0:0:0:0:0:0:1%0
07/17/14 15:53:48 (550) SYSTEM Enabling elevated role: security_admin
07/17/14 15:53:48 (588) SYSTEM Export API - ExcelExporter : 29 rows
retrieved from database duration_milliseconds=2
07/17/14 15:53:49 (534) NONE New transaction
EB39A310EB022100C46AC2EEF106FED9 #751 /poll_processor.do
07/17/14 15:53:49 (544) EB39A310EB022100C46AC2EEF106FED9 #751
/poll_processor.do Parameters ------------------------sys_action=poll
sysparm_processor=poll_processor
job_id=a61a2314eb022100c46ac2eef106fe0a
07/17/14 15:53:49 (547) EB39A310EB022100C46AC2EEF106FED9 #751
/poll_processor.do -- total transaction time: 0:00:00.013, total wait
time: 0:00:00.000, session wait: 0:00:00.000, semaphore wait:
0:00:00.000, source: 0:0:0:0:0:0:0:1%0
07/17/14 15:53:49 (740) SYSTEM Export API - ExcelExporter : Rows
written to file duration_milliseconds=1150
Enhancements
Fuji
You can enable export logging to record detailed export performance data.
Dublin
A new system property, glide.csv.export.line_break, controls how line breaks appear in exported
CSV data.
A default upper limit is available for XML data exports. However, the upper and lower limits from earlier
versions will continue to function correctly in a Dublin instance.
A new system property, glide.ui.export.warn.threshold, controls how a user receives returned
export records when the limit has been exceeded. The available options are to wait for the export to complete or
have the exported records sent as an email attachment.
Exporting Data
43
Calgary
A new system property, glide.export.csv.charset, controls the character set used to export CSV files.
This property allows localized instances to export strings in a character set supported by the language. Starting
with Calgary, you can set the system property to the character set name you want to use to export CSV files.
References
[1] https:/ / community. servicenow. com/ community/ blogs/ blog/ 2015/ 01/ 05/ rendering-html-in-exported-lists
[2] http:/ / www. w3. org/ Protocols/ HTTP/ 1. 0/ draft-ietf-http-spec. html#BasicAA
[3] http:/ / en. wikipedia. org/ wiki/ Percent-encoding
Uploading Attachments
Overview
You can upload a file as an attachment to an incident, knowledge article, change request, or other record in
ServiceNow. Attachment file size is not limited by default.
Note:
Warning: Uploading large attachments might lead to issues with the user's active session on the instance.
Managing Attachments
To manage attachments on a record:
1. Navigate to the record (example, an incident record).
2. Click the paper clip ( ) in the upper right or the Manage Attachments button (if files are already attached).
From the Attachments pop-up window you can add, delete, or rename attachments.
The number of attachments for a record is listed on the Manage Attachments button.
Adding an Attachment
Do not use the Upload File module in the System Definition
application. This module is not compatible with multi-node instances.
Instead, attach a file directly to a record.
1. Navigate to the record (example, an incident record).
Attachments pop-up window
Uploading Attachments
44
Select multiple files at the same time. This feature is not supported by Internet Explorer.
Add each file on a separate line. Click Add Another
Attachment, and then click Choose File on the next line. Repeat
until all desired files are selected. This feature is available in all
supported browsers.
Select files
Attached files
Uploading Attachments
45
When the upload is complete, the file name is added to the
attachments header. Upload speed depends on the file size and
the speed of your network connection.
Drag-and-drop upload
Warning: Do not navigate away from the record while an upload is in progress. The upload must be completed for the file to be
attached.
Renaming Attachments
To rename a file that is attached to a record:
1. Navigate to the record.
2. Click [rename] beside the file name at the top of the form.
3. Edit the file name and press Enter.
Note: Press Esc instead of Enter to undo your changes and cancel rename.
Deleting Attachments
To delete attachments from a record:
1.
2.
3.
4.
5.
Delete attachments
46
Types of Editors
The are two types of HTML editors in the system:
TinyMCE: A What You See Is What You Get (WYSIWYG) field that displays text as readers would see it on the
screen. TinyMCE is the default editor.
htmlArea: The legacy editor, which offers a more basic WYSIWYG interface as well as a mode that shows only
HTML markup.
The glide.ui.html.editor system property specifies which interface is used for all HTML fields.
Note: Styles declared by HTML fields may be overridden by CSS declarations in the themes.css file that styles the entire instance. To
determine what attributes are overriding a style, use a web development tool (for example, Firebug for Firefox).
Warning: Do not paste graphics into the TinyMCE editor. The editor does not support embedded graphics.
Users can modify the TinyMCE toolbar and add or remove functionality. For more information, see Configuring the
TinyMCE HTML Toolbar.
47
htmlArea
Formatting
In the following table, the Icon column displays icons that are available with the TinyMCE version 3 and htmlArea
editors. The TinyMCE v4 Icon column displays icons that are available with the TinyMCE version 4 editor. Names
marked with an asterisk (*) are not available with the htmlArea editor.
Icon
TinyMCE v4
Icon
Name
Description
New Document*
Bold
Italic
Underline
Strikethrough*
Align Right
Align Center
Align Left
Justify
Applies justified alignment, which stretches the lines to equal width, to the current
paragraph.
[1]
Code reference : text-align:justify
Format
Applies a paragraph style to the current paragraph, such as Paragraph, Heading 1, and
Preformatted.
Font Family
Font Size
Insert/Remove
Bulleted List
Applies or removes unordered list tags for the selected paragraphs. Click the arrow
beside the button to select a different bullet type.
48
Insert/Remove
Numbered List
Applies or removes ordered list tags for the selected paragraphs. Click the arrow beside
the button to select a different number type.
Decrease Indent
Removes indentation from the current or selected paragraphs (removes 30px of left
padding; padding cannot be less than 0).
[2]
Code reference : padding-left
Increase Indent
Applies indentation to the current or selected paragraphs (adds 30px of left padding).
[2]
Code reference : padding-left
Block Quote*
Applies the <blockquote> tag, which defines a long quotation, to the current or
selected paragraphs. Browsers usually indent these elements.
[3]
Code reference : <blockquote>
Applies font color to the current word or selected text. Click the button to use the current
color, or click the arrow next to the button to view more colors. Click More Colors... to
view various color options and the hexadecimal codes.
Select Background Applies background color to the current word or selected text. Click the button to use the
Color
current color, or click the arrow next to the button to view more colors. Click More
Colors... to view various color options and the hexadecimal codes.
Clear Formatting*
Removes the inline styles and formatting from the selected text.
Subscript*
Applies subscript text, which appears half a character below the baseline, to the current
word or selected text.
[4]
Code reference : <sub>
Superscript*
Applies superscript text, which appears half a character above the baseline, to the current
word or selected text.
[4]
Code reference : <sup>
Table Functions
The TinyMCE version 4 editor uses menus and menu selections to create and edit tables. The TinyMCE version 3
editor and the htmlArea editor use icons to create and edit tables.
Table menu
49
To insert a table in the HTML field, click Insert table and
highlight squares in the grid to represent the desired number of
rows and columns. Click the last highlighted square to insert the
table.
After you insert the table, you can modify the size by clicking and
dragging the handles at the table edges.
Insert table
Click Table properties to open the Table properties dialog box.
From this box you can:
Table properties
With the cursor in the desired table cell, click Cell properties to
open the Cell properties dialog box. From this box you can set the
following for table cells:
50
With the cursor in a table cell in the desired row, click Row
properties to open the Row properties dialog box. From this box
you can set the following for rows:
Row type
Alignment
Height
Name
Description
Insert/Edit Table
Inserts a table and defines properties for the current table, including columns, rows, width, layout, and spacing. To
learn more, see the table styles example.
[5]
Code reference : table
Table Row
Properties*
Defines properties for the current row, odd rows, even rows, or all rows in the table. To learn more, see the table
styles example.
[6]
Code reference : tr
Table Cell
Properties*
Defines properties for the current cell, cells in the current row, cells in the current column, or all cells in the table.
To learn more, see the table styles example.
[7]
Code reference : td
Delete Row*
Insert Column
Before*
Delete Column*
51
Editing Functions
Icon
TinyMCE v4
Icon
Name
Description
Cut*
Cuts the selected text. Not supported in all browsers; use keyboard shortcut.
Keyboard shortcut: CTRL + X
Copy*
Copies the selected text. Not supported in all browsers; use keyboard shortcut.
Keyboard shortcut: CTRL + C
Paste*
Pastes the selected text. Not supported in all browsers; use keyboard shortcut.
Keyboard shortcut: CTRL + V
Paste as Plain
Text*
Enables paste as plain text (without source formatting) for the subsequent paste operation.
Opens a new window that allows you to copy and paste content from Microsoft Word into the
HTML field.
Find*
Allows you to locate text strings in the HTML field. Search above (up) or below (down) the
cursor location.
Find/Replace*
Allows you to replace the next (Replace) or all (Replace All) occurrences of a text string in the
HTML field.
Undo*
Redo*
Extended Functions
Icon
TinyMCE v4
Icon
Name
Description
Insert/Edit Link
Configures a link for the selected text. Define the link URL, title (additional information that appears
in the tool tip), and the target (same window or new window or tab).
[10]
Code reference
: <a>
Remove link*
Cleanup Messy
Code*
Fixes standard HTML errors for the selected text, such as invalid tags. Note that clicking this button
may change the layout of existing content. You can click Undo to revert this action if you do not like
the results.
Edit HTML
Source
Opens HTML source code in a separate window. See Editing in HTML Source Mode.
Insert Horizontal
Line
Toggle Invisible
Elements*
Shows or hides invisible elements in the article, such as collapsed table borders.
Insert Special
Character*
Inserts a special character (symbol) at the current cursor location. Click the button to view a list of
available characters. Point to a character to view the name and HTML code. Click a character to insert
it.
Insert/Edit Image
Inserts an image from the image library or an attachment. You can also add images to the image library
with this feature. To learn more, see Embedding Images in HTML Fields.
Insert/Edit
Embedded Media
Embeds a video from the video library or an attachment. You can also add videos to the video library
with this feature. To learn more, see Embedding Video in HTML Fields.
52
Spell Checker
Preview*
Opens a preview of the HTML field in a separate window without saving changes.
Toggle Full
Screen Mode*
Expands the HMTL field to use the full form view for easier editing. Click the button again to return to
standard form view. This feature is not available for Internet Explorer.
) to open the
Note: Fields which are blank may still have default HTML tags applied by default - for example, a <body></body> tag. These tags
will be displayed in the HTML Source Mode.
53
General tab:
Columns: 2
Rows: 4
Cell Padding: 3
Cell Spacing: 3
Border: 1
Width: 75%
5. Enter the following values on the Advanced tab:
Rules: all
Border Color: Click the color picker, click the Named tab, and select Dim Grey (color #696969).
6. Click Insert.
7. Click in the first line of the table and then click Table Row Properties (
8. Enter the following value on the General tab:
).
).
).
Background color: Click the color picker, click the Named tab, and select Silver (color #c0c0c0).
16. Select Update Odd Rows in Table and then click Update.
17. Click in the first column of the table and then click Table Cell Properties (
18. Enter the following value on the General tab:
).
Width: 30%
19. Click Update.
20. Enter data in the cells and then save the article. The table is formatted with a blue header row and alternating
grey and white data rows.
54
References
[1] http:/ / www. w3schools. com/ cssref/ pr_text_text-align. asp
[2] http:/ / www. w3schools. com/ cssref/ pr_padding-left. asp
[3] http:/ / www. w3schools. com/ tags/ tag_blockquote. asp
[4] http:/ / www. w3schools. com/ tags/ tag_sup. asp
[5] http:/ / www. w3schools. com/ tags/ tag_table. asp
[6] http:/ / www. w3schools. com/ tags/ tag_tr. asp
[7] http:/ / www. w3schools. com/ tags/ tag_td. asp
[8] http:/ / www. w3schools. com/ tags/ att_td_colspan. asp
[9] http:/ / www. w3schools. com/ tags/ att_td_rowspan. asp
[10] http:/ / www. w3schools. com/ tags/ tag_a. asp
55
5. Click OK.
Field
Type
Description
Select the image type.
Image
Begin typing a file name and select an image from the list, or click the reference lookup (
) and select an image from the table. To
upload a new image, click New, click Choose File, locate the image you want to use, and click Upload.
Tooltip
Enter alternate text that appears when a user points to the image.
Alt
Enter alternate text that can be used to improve accessibility. For example, it could be used with a screen reader. If this field is left blank,
it defaults to the text entered in the Tooltip field. Available starting with the Dublin release.
Advanced options
Layout
Spacing Enter the number of Horizontal and Vertical pixels around the image.
Size
Note: To resize an embedded image (not available for Chrome browsers), click the image. The sizing frame appears. Drag a sizing
point until the image is the desired size. Corner points adjust the size proportionally.
Linking to a Website
To insert a link to a website in an HTML field:
1. Move the cursor to the position where the link is to appear.
2. Click the Insert/Edit Link icon (
Description
Enter the URL for the link. Copying and pasting is usually the easiest method.
Tooltip Enter the text you want to display for the link.
Target
Select the target window for the URL. For files, the None (use implicit) selection is generally the best choice. However, if you are linking
to a complete Web page, choose New window (_blank) so that the browser opens a new window.
56
Field
Type
Description
Select the video type.
For an attachment or video library file, select a video from the list or click New. For an external URL, enter the URL.
Size
57
Administrative Functions
Administrators with the image_admin role can define the types of video files that can be embedded. To see the list of
file types, navigate to System UI > Embed Object Types. Set the Active field to false for any file types that are not
desired. To add additional types that are not included in the base system, click New to create a new type.
Note: If codebase or pluginspage is specified (to instruct the browser where to get the plugin), point to https pages to avoid
warnings from Internet Explorer about unsecure content on the page.
Enhancements
Dublin
The addition of the Alt field to the Insert/Modify Image dialog box improves accessibility. It can be used, for
example, with a screen reader.
Dot-Walking
Overview
Dot-walking provides access to fields on related tables from a form, list, or script. If the current table contains a
reference to another table, any field on the referenced table can be accessed using dot-walking.
Dot-walking references a field by building a chain of field names separated by dots (periods). For instance,
incident.assigned_to.company references the company of the user assigned to an incident. The recommended limit
for chain length is three levels.
Video Tutorial
The following video tutorial demonstrates how to use dot-walking and database views to include data from related
tables in reports. Also shows how to apply dynamic filters to run a set query against a reference field without
entering JavaScript code in the condition builder. Applies to ServiceNow instances starting with the Fuji release.
Reporting: How to Access Related Tables
Dot-Walking
When the related fields are present, select a set of related fields.
58
Dot-Walking
After the related field is selected, the menu reloads with the related table's fields.
In this picture, the user is currently at incident.caller.company. It is possible to return to higher levels in the hierarchy
by selecting the blue records. For instance, selecting Incident fields returns to the list of incident fields.
The related fields can be dismissed by selecting Remove Related Fields in blue at the bottom of the list:
59
Dot-Walking
Once a reference field is highlighted, the Expand icon appears above the Add icon.
60
Dot-Walking
Selecting the Expand icon opens the list of fields from the related list in the Available pane. In this picture, the user
has opened the Assigned to fields. Like before, the previous lists of fields appear at the top of the list in blue.
61
Dot-Walking
62
Once the field is added to the "Selected" pane, it appears with its full dot-walked syntax. In the next picture, the user
Dot-walking in Variables
Variables can often be added into templates, notifications, or other forms where a value is being called from the
form. For instance, the following is the variable for Assigned to:
${assigned_to}
As above, it is possible to dot-walk to fields on any reference field's original record. In the case above, it is possible
to dot-walk to any field on the assigned_to record, for instance:
${assigned_to.manager}
As is always the case with dot-walking, this can be a longer chain if desired:
${assigned_to.department.manager.mobile_phone}
Sometimes this variable can be selected from a Tree Picker.
).
Dot-Walking
Clicking this icon presents a list of fields available on the current record:
Reference fields have + icons next to their name. Clicking on the + expands a list of the fields on that referenced
field. In this example, expanding the Assigned To field shows the User fields for that record:
63
Dot-Walking
64
Dot-walking in Script
Just as above for field variables, it is possible to dot-walk within a script simply by invoking the dot-walk syntax.
This functionality requires a knowledge of JavaScript.
For scripts which run on the server side (such as Business Rules), however, it is necessary to add current.
The following script, for instance, is a scripted approval rule that requests an approval from the manager of the user
who opened the ticket:
try {
current.opened_by.manager;
} catch (err) {
}
For scripts which run on the client side (such as Client Scripts), current is not necessary. For instance, the Highlight
VIP Caller script runs on the client side:
function onChange(control, oldValue, newValue, isLoading) {
//wait until there is a valid record in the field
if (newValue) {
//get the caller object so we can access fields
var caller = g_form.getReference('caller_id');
var callerLabel =
document.getElementById('label.incident.caller_id');
var callerField =
document.getElementById('sys_display.incident.caller_id')
//check for VIP status
if (caller.vip=='true') {
//change the caller label to red background
//style object is CSSStyleDeclaration, style names are not
standard css names
if (callerLabel)
document.getElementById('label.incident.caller_id').style.backgroundColor='red';
//change the caller's name field to red text
if (callerField)
Dot-Walking
65
document.getElementById('sys_display.incident.caller_id').style.color='red';
}
else {
//not a VIP, remove temporary styles
if (callerLabel)
document.getElementById('label.incident.caller_id').style.backgroundColor='';
if (callerField)
document.getElementById('sys_display.incident.caller_id').style.color='';
}
}
}
Breadcrumbs
Overview
As the amount of data that accumulates in ServiceNow grows, it is often necessary to narrow it down to only specific
data that is needed for a particular task. You can use filters and breadcrumbs to retrieve and display only the specific
data that you need.
Filters
A filter is a set of conditions applied to a table in order to find and work with a subset of the data in that table. Users
can apply, modify, create, and save filters. The current filter is indicated by a hierarchical list of
conditionsbreadcrumbsat the top of the table.
Note: If you create a record from a filtered list, some fields on the record are automatically populated based on the filter conditions.
For example, if the filter on the Incident list is [Impact] [is] [2 - Medium] and you click New, the Impact field is automatically set to
2 - Medium.
Breadcrumbs
66
Breadcrumbs
Breadcrumbs offer a quick form of filter navigation. They are ordered from left to right, with the leftmost condition
being the most general and the rightmost condition being the most specific. Clicking a breadcrumb removes all of the
conditions to its right. Clicking the condition separator (>) before a condition removes only that condition.
In the example, clicking Priority = 2
removes the condition Category =
Software and returns all active
incidents with a priority of 2. By
contrast, clicking the condition
Breadcrumbs
separator (>) before Priority = 2
removes the condition Priority = 2
and returns all active incidents in the software category. In both cases, removing a condition returns a larger results
set. Finally, clicking Incidents goes to the top of the hierarchy, removing all conditions and returning all incidents in
the system.
Click a breadcrumb to refresh the list of records and show the latest information from the database for those records.
Quick Filters
Right-click menu
Breadcrumbs
67
In this example, right-clicking Active and
selecting Show Matching adds the
condition Incident state = Active as the most
specific condition of the filter. By contrast,
right-clicking Active and selecting Filter
Out adds the condition Incident state !=
Active as the most specific condition of the
filter.
Quick filters
Creating Filters
A filter restricts what records appear in a list by providing a set of conditions each record must meet to be included
in the list. A condition consists of these parts:
Field: Each field contains data from a particular column in the list's table. Selecting a reference field allows you
to dot-walk to data from other tables.
Operator: Each field type has its own set of valid operators. The operator sometimes also determines if a value is
needed.
Value: Each field has its own set of valid values determined by the field type. Reference fields have access to
auto-complete, and choice lists provide a drop-down list of options.
Grouping: Each condition line is grouped with either an AND or OR connector. The filter requires all condition
lines linked with an AND connector to be met. The filter evaluates each condition line linked with an OR
connector separately.
Create filters on a list using the condition builder. To make the condition builder appear every time you open the list,
click the Pin/Unpin Filter icon (
in UI15; / in other UIs) so that the pin is pressed down.
To create a filter:
1. Open the condition builder by:
Clicking the Show / hide filter icon (
) beside the breadcrumbs in UI15.
Clicking the arrow ( ) beside the breadcrumbs in UI14 and UI11.
2. Select a field from the drop-down list.
The field type determines the available operators and values. For example, the Active field may have a value
of true, false, or empty, while a text field may have many different values. Similarly, the greater than operator
does not apply to the Active field, but it does apply to the Priority field. For more information, see Condition
Builder.
3. Select an operator from the drop-down list.
4. Select or enter a value, if appropriate.
5. Add or remove conditions to construct the desired filter:
To add a top-level condition, click Add AND condition or Add OR conditionon the condition builder tool
bar, above the conditions.
To add a dependent condition, click Add AND condition or Add OR condition beside the condition.
To remove a condition, click Delete beside the condition.
6. To specify the sort order of the results, click Add Sort, then select a field to sort by and a sort order.
7. Click Save to keep the filter for future use. For more information, see Saving Filters.
Breadcrumbs
68
Using OR Conditions
The condition builder uses two different types of OR conditions, top level and dependent.
Using a dependent OR condition, you can specify alternative criteria to a single operation. Dependent OR conditions
work in the manner A and (B or C).
For example, to return a list of all unassigned problem and incident records from the Task table, create a filter with a
dependent OR on the Number field.
[Assigned to] [is] [empty] AND [Number] [begins with] [PRB] OR [Number] [begins with] [INC].
A top-level OR condition allows you
to display the results of multiple filter
criteria in a single list. Top level OR
conditions work in the manner (A and
B) or (C and D).
Dependent OR condition
OR condition.
[Active] [is] [true] AND [Category] [is] [Hardware]
Top level OR condition
[Active] [is] [false] AND [Category] [is] [Software]
Top-level
and
dependent
OR
conditions can be used together. Filters
using both types of OR conditions
work in the manner (A or B) or (C or
D). By mixing AND conditions with
top-level
and
dependent
OR
conditions, you can create very
specific filters.
Filtering on Multiple
String Values
For a string field, you can create a filter that searches for multiple values by creating a comma delimited list. This
feature enables administrators to copy and paste search criteria from a Microsoft Excel spreadsheet into a filter, for
example.
1. Create the filter with the is one of or is not one of operator.
All selections from the field's choice list appear.
2. Select one or more of the options by using multiple selection key commands.
Breadcrumbs
69
Note: Do not use the "is one of" operator on fields that contain commas, the query does not return the expected set of records.
Instead, create a filter using multiple "or" statements.
Operator
is (dynamic) Me
Description
Computes the value of Caller based on the current user viewing the list.
Computes the value of Assignment group based on the current user viewing the list.
Saving Filters
Depending on your access rights, you may save filters for everyone, a user group, or yourself.
To save a filter:
1.
2.
3.
4.
Breadcrumbs
70
Deleting Filters
Administrators can delete any saved filter: global, group, or personal.
1. Navigate to System Definition > Filters.
To see who created the filter and when, configure the list to add the created_by and created fields to the list.
To see who has access to the filter, configure the list to add the user, group, or domain fields. Filters that are
not assigned to a user or group are global.
2. Click the filter name and click Delete, then confirm the request.
Scripted Filters
The condition builder alone cannot create some filters, such as displaying a record set that is dependent on an
unrelated table. Administrators with a knowledge of JavaScript can create JavaScript functions for use in advanced
filters.
To use a scripted filter:
1. Create a new script include.
2. In the script include Script field, create a JavaScript function that returns an array of sys_ids.
Ensure that the function uses the same name as the script include.
Ensure that the script include is Active and Client callable.
3. Call the JavaScript function from the condition builder.
For more information, see GlideRecord queries and Script Includes.
Breadcrumbs
71
Example
A company provides intensive care for a group of customers. To track these services, the service manager needs a
high-level journal and links to all incidents that the customers raise.
The company creates a new application, Intensive Care, and a table, u_intensive_care. While the table contains a
reference field for the customer name, there is no direct link to the user table. Thus, the manager cannot set up an
incident list filter for customers who are under intensive care using the condition builder.
Solution
Write a JavaScript function that uses a GlideRecord query to build an array of user sys_ids in the u_intensive_care
table (see sample code, below). Call the function from the condition builder in the Incident table (condition, Caller is
javascript:myFunction()).
function myFunction(){
var arrUsers = [];
gr = new GlideRecord('u_intensive_care');
gr.query();
while (gr.next()){
arrUsers.push(gr.u_customer.toString());
}
return arrUsers;
}
Breadcrumbs
72
Field
Description
Label
Enter the text you want to appear as an option when a user selects the is (dynamic) operator.
Script
Field type
Select Reference.
Reference script
Select the client-callable script include or business rule you created for the scripted filter.
Referenced table
Available for filter Select this option to display the option as a filter breadcrumb.
Order
Enter a number to designate the placement of this option in the filter option choice list.
Roles
Active
Option Label
Description
Me
One of My
Assignments
The reference field contains the current user or someone for whom the current user is a
delegate for assignments.
One of My Approvals The reference field contains the current user or someone for whom the current user is a
delegate for approvals.
Group [sys_user_group]
One of My Groups
The reference field contains a group to which the current user belongs.
Enhancements
Eureka
After you run a filter on a list, the column search fields are displayed and filled in with the corresponding search
criteria.
Dublin
Dynamic filter options have been added.
Using Filters
73
Using Filters
Overview
As the amount of data that accumulates in ServiceNow grows, it is often necessary to narrow it down to only specific
data that is needed for a particular task. You can use filters and breadcrumbs to retrieve and display only the specific
data that you need.
Filters
A filter is a set of conditions applied to a table in order to find and work with a subset of the data in that table. Users
can apply, modify, create, and save filters. The current filter is indicated by a hierarchical list of
conditionsbreadcrumbsat the top of the table.
Note: If you create a record from a filtered list, some fields on the record are automatically populated based on the filter conditions.
For example, if the filter on the Incident list is [Impact] [is] [2 - Medium] and you click New, the Impact field is automatically set to
2 - Medium.
Breadcrumbs
Breadcrumbs offer a quick form of filter navigation. They are ordered from left to right, with the leftmost condition
being the most general and the rightmost condition being the most specific. Clicking a breadcrumb removes all of the
conditions to its right. Clicking the condition separator (>) before a condition removes only that condition.
In the example, clicking Priority = 2
removes the condition Category =
Software and returns all active
incidents with a priority of 2. By
contrast, clicking the condition
Breadcrumbs
separator (>) before Priority = 2
removes the condition Priority = 2
and returns all active incidents in the software category. In both cases, removing a condition returns a larger results
set. Finally, clicking Incidents goes to the top of the hierarchy, removing all conditions and returning all incidents in
the system.
Click a breadcrumb to refresh the list of records and show the latest information from the database for those records.
Using Filters
74
https://{instance_name}/incident_list.do?sysparm_query=active=true^impact=1^ORimpact=2.
This selection is not available for the All breadcrumb. Follow browser instructions if browser security
measures restrict this function.
Quick Filters
Right-click menu
Quick filters
Creating Filters
A filter restricts what records appear in a list by providing a set of conditions each record must meet to be included
in the list. A condition consists of these parts:
Field: Each field contains data from a particular column in the list's table. Selecting a reference field allows you
to dot-walk to data from other tables.
Operator: Each field type has its own set of valid operators. The operator sometimes also determines if a value is
needed.
Value: Each field has its own set of valid values determined by the field type. Reference fields have access to
auto-complete, and choice lists provide a drop-down list of options.
Grouping: Each condition line is grouped with either an AND or OR connector. The filter requires all condition
lines linked with an AND connector to be met. The filter evaluates each condition line linked with an OR
connector separately.
Create filters on a list using the condition builder. To make the condition builder appear every time you open the list,
click the Pin/Unpin Filter icon (
in UI15; / in other UIs) so that the pin is pressed down.
To create a filter:
1. Open the condition builder by:
Clicking the Show / hide filter icon (
) beside the breadcrumbs in UI15.
Clicking the arrow ( ) beside the breadcrumbs in UI14 and UI11.
Using Filters
75
Using OR Conditions
The condition builder uses two different types of OR conditions, top level and dependent.
Using a dependent OR condition, you can specify alternative criteria to a single operation. Dependent OR conditions
work in the manner A and (B or C).
For example, to return a list of all unassigned problem and incident records from the Task table, create a filter with a
dependent OR on the Number field.
[Assigned to] [is] [empty] AND [Number] [begins with] [PRB] OR [Number] [begins with] [INC].
A top-level OR condition allows you
to display the results of multiple filter
criteria in a single list. Top level OR
conditions work in the manner (A and
B) or (C and D).
Dependent OR condition
OR condition.
[Active] [is] [true] AND [Category] [is] [Hardware]
Top level OR condition
[Active] [is] [false] AND [Category] [is] [Software]
Using Filters
76
Top-level
and
dependent
OR
conditions can be used together. Filters
using both types of OR conditions
work in the manner (A or B) or (C or
D). By mixing AND conditions with
top-level
and
dependent
OR
conditions, you can create very
specific filters.
Filtering on Multiple
String Values
For a string field, you can create a filter that searches for multiple values by creating a comma delimited list. This
feature enables administrators to copy and paste search criteria from a Microsoft Excel spreadsheet into a filter, for
example.
1. Create the filter with the is one of or is not one of operator.
All selections from the field's choice list appear.
2. Select one or more of the options by using multiple selection key commands.
Note: Do not use the "is one of" operator on fields that contain commas, the query does not return the expected set of records.
Instead, create a filter using multiple "or" statements.
Using Filters
77
Operator
is (dynamic) Me
Description
Computes the value of Caller based on the current user viewing the list.
Computes the value of Assignment group based on the current user viewing the list.
Saving Filters
Depending on your access rights, you may save filters for everyone, a user group, or yourself.
To save a filter:
1.
2.
3.
4.
Using Filters
78
Deleting Filters
Administrators can delete any saved filter: global, group, or personal.
1. Navigate to System Definition > Filters.
To see who created the filter and when, configure the list to add the created_by and created fields to the list.
To see who has access to the filter, configure the list to add the user, group, or domain fields. Filters that are
not assigned to a user or group are global.
2. Click the filter name and click Delete, then confirm the request.
Scripted Filters
The condition builder alone cannot create some filters, such as displaying a record set that is dependent on an
unrelated table. Administrators with a knowledge of JavaScript can create JavaScript functions for use in advanced
filters.
To use a scripted filter:
1. Create a new script include.
2. In the script include Script field, create a JavaScript function that returns an array of sys_ids.
Ensure that the function uses the same name as the script include.
Ensure that the script include is Active and Client callable.
3. Call the JavaScript function from the condition builder.
For more information, see GlideRecord queries and Script Includes.
Example
A company provides intensive care for a group of customers. To track these services, the service manager needs a
high-level journal and links to all incidents that the customers raise.
The company creates a new application, Intensive Care, and a table, u_intensive_care. While the table contains a
reference field for the customer name, there is no direct link to the user table. Thus, the manager cannot set up an
incident list filter for customers who are under intensive care using the condition builder.
Solution
Write a JavaScript function that uses a GlideRecord query to build an array of user sys_ids in the u_intensive_care
table (see sample code, below). Call the function from the condition builder in the Incident table (condition, Caller is
javascript:myFunction()).
function myFunction(){
var arrUsers = [];
gr = new GlideRecord('u_intensive_care');
gr.query();
while (gr.next()){
arrUsers.push(gr.u_customer.toString());
}
return arrUsers;
}
Using Filters
79
Description
Label
Enter the text you want to appear as an option when a user selects the is (dynamic) operator.
Script
Field type
Select Reference.
Reference script
Select the client-callable script include or business rule you created for the scripted filter.
Referenced table
Available for filter Select this option to display the option as a filter breadcrumb.
Order
Enter a number to designate the placement of this option in the filter option choice list.
Roles
Active
Option Label
Description
Me
One of My
Assignments
The reference field contains the current user or someone for whom the current user is a
delegate for assignments.
One of My Approvals The reference field contains the current user or someone for whom the current user is a
delegate for approvals.
Group [sys_user_group]
One of My Groups
The reference field contains a group to which the current user belongs.
Using Filters
Enhancements
Eureka
After you run a filter on a list, the column search fields are displayed and filled in with the corresponding search
criteria.
Dublin
Dynamic filter options have been added.
Reference Icon
Overview
The reference icon (
in UI15 ,
in other UIs) appears to the left of a record on a list, or to the right of a
reference field on a form populated with a record. Pointing to the icon presents a read-only pop-up of the record's
information:
80
Reference Icon
81
Windows Live
Users who are using the Windows Live Toolbar must disable the toolbar to use reference lookups.
Suggestion Fields
Overview
A suggestion field allows users to select predefined text in addition to entering text. Any text or journal field may
offer suggested text, depending on setup. Suggestion fields have a maximum character length of 4000.
To use suggested text in a form field:
1. Click the lightbulb (
) next to the field.
2. Click the suggested text to enter. For long text fields, select a label to view suggested text and then click Select to
enter the response.
Slushbucket
82
Slushbucket
Overview
Slushbuckets allow users to select multiple items from a list of available items. They are used in many operations,
such as personalizing lists, adding items to related lists, and service catalog list collector variables.
The slushbucket interface has two columns: the available items on the left and the selected items on the right.
To add items to the selection, double-click an available item (on the left), or select an item and click the add icon (
in UI15) The new item is added at the bottom of the selected items column on the right.
To remove items from the selection, double-click the item on the right, or select the item and click the remove
icon ( in UI15)
To select multiple consecutive items, hold Shift and click the first and last item.
To select multiple non-consecutive items, hold Ctrl (Command on Mac) and click the desired items.
Arranging Selections
Some slushbuckets allow users to customize the order of selections, such as when configuring a form or list.
To move items one position, select the items and click the up or down icons (
/
in UI15).
To move an item multiple positions, select consecutive items above or below the item then click the up or down
icon. In this example, to move Assigned to to the top of the selections order:
1. Hold Shift and click Short description then Number.
2. Click the down icon.
Slushbucket
83
property:
1.
2.
3.
4.
Tree Picker
84
Tree Picker
Overview
The tree picker is a special reference lookup for:
Configuration Items (CIs) for a field that is dependent on another CI field.
Reference elements for any hierarchical table. A hierarchical table is any table that has a parent field pointing
back at itself.
Values for a user reference that is dependent on the group.
Tree Picker
85
Note: You cannot customize the label names used in the tree picker. The label names are taken from the values in the table. For
example, the Assignment group choices come from the group names in the Groups table (in the Name column).
Note: Dependencies for CIs are enforced only when the dictionary entry for the reference field has tree_picker=true in the
Attributes field.
Condition Builder
86
Condition Builder
Overview
A condition builder constructs a condition statement with a series of contextually generated fields. Condition
builders are used in many operations, such as creating filters, administering surveys, and administering access
control.
Building Conditions
To add a dependent condition, click Add AND condition (
) or Add OR condition (
To add a top-level condition, click Add AND condition or Add OR condition on the condition builder toolbar,
above the conditions.
To remove a condition, click Delete (
group field:
1. Create the filter condition Assignment group is Hardware.
This condition does not return those records where the Assignment group field is empty.
2. Click OR next to the original filter condition.
3. Create an additional filter condition of Assignment group is empty.
4. Run the filter.
Condition Builder
Operators
Several logical operators are available for each field type when creating a condition. See Operators Available for
Filters and Queries.
Enhancements
Eureka
The glide.list.filter_max_length property allows administrators to set a maximum character limit
for a condition builder query.
Dublin
The is (dynamic) operator is available for dynamic filter options.
Calgary
Several new operators are available to compare field values. Use field comparison to evaluate equality between
fields on the same table or on related tables. New logical operators provided by field comparison appear in the list
of available operators by field type.
87
88
In this example, the transaction took the following amount of processing time:
499 milliseconds total time
155 milliseconds on the server
172 milliseconds moving data across the network
172 milliseconds in the browser, rendering the HTML and parsing and executing JavaScript
Response time appears on most pages. However, it does not appear for simple operations (such as paging through a
set of records or changing the sort order of a list) or for the first transaction in a session.
To hide the response time, click the clock (
Point to the clock to view a tool tip with the response time.
To view a detailed breakdown of the browser processing time on forms, click browser.
89
Administrators can disable
response time by setting
glide.ui.response_time
property to false.
Cancelling a Transaction
Overview
A user may cancel a transaction that takes longer than expected. Examples may include:
the
the
Cancelling a Transaction
To cancel the transaction, click the cancellation button. The timer indicates that the transaction is being cancelled.
If the entire transaction completes successfully without user intervention, the timer indicates when the transaction
completes.
90
Cancelling a Transaction
91
Administration
Properties
Administrators can configure behavior of the transaction cancel capability using the following properties.
Property
Definition
Location
com.glide.request_manager.active
glide.ui.transaction.long_response.time
Logging
Canceled transactions appear in the Transaction Log with "CANCELLED: " appended to the URL. Transactions
canceled by a user are logged differently than transactions canceled by Transaction Quotas.
92
Introduction to Searching
Text Search Plugin
Overview
Global text search finds records in multiple tables from a single search
field.
Note: For Exact Match searches, records are returned from the Task
(task) and Knowledge (kb_knowledge) tables only.
Global text search
To perform a global text search, click in the search box (located in the
upper right of the banner frame) or press Access Key [1] + S.
Search results are grouped into logical collections called search groups. Users can search the groups for which they
have access rights. Within each search group, results are divided by table. Administrators may customize search
groups. The default search groups are:
Knowledge and Service Catalog results are displayed as they are in their respective applications, while other results
are displayed in list format.
Search Suggestions
Type-ahead suggestions
The knowledge base and global text
searches provide suggestions as you
type. Type-ahead suggestions appear
under the search box. Suggestions are
based on similar searches that begin
with the same characters.
93
Type-ahead search
Note: Administrators must enable the "Did you mean?" properties for users to see these suggestions.
For
more
information
about
suggestions, see Global Text Search
Suggestions [1] on the ServiceNow
Community.
Did you mean? suggestions
Deselect Results
If you do not want to search some groups or tables, you can deselect a search group or table on a per-user basis. Your
preference is saved for subsequent searches. To deselect a search group, uncheck its checkbox on the search results
page:
If you click a search group's link (e.g., the blue "Tasks" link in the above screenshot), you will get a dialog where
you can deselect specific tables in each group:
Preferences
Click the Search tips and preferences link to set the following personal Global Text Search preferences:
Use remembered expand / collapse preferences - specifies whether you want the collapse state of any search
groups/tables remembered for your next search. For example, when checked, if you collapse the search results for
the "People & Places" search group, it will be collapsed on your next search. When unchecked, all groups/tables
are expanded for every search.
Show list of tables with no search matches - specifies whether or not you wish to see a summary of tables that
had no search matches. For example: No matches for Requests, Catalog Tasks, Tickets
Show selectable search groups - hides or displays the search group checkbox row
Show groups with no search matches - if unchecked, hides a search group if it returns no matches. If checked,
you get a placeholder row telling you there were no matches for that group.
Return task record if searching for exact number - if unchecked, displays the full search results page even if
the search term matches a task number. If checked, you get the task record when the search term matches a task
number.
94
95
References
[1] https:/ / community. servicenow. com/ community/ blogs/ blog/ 2014/ 09/ 24/ global-text-search-suggestions
Searching Knowledge
Overview
You can browse and search for articles that are configured to grant you access, and submit feedback on those
articles. You must have at least one ServiceNow role to contribute content.
Viewing Knowledge
To view the default knowledge homepage navigate to Self-Service > Knowledge.
The knowledge homepage displays
knowledge articles organized by
knowledge base and category, as well
as featured content and popular
articles.
Searching Knowledge
96
Note: The knowledge homepage is not compatible with Internet Explorer 9 or earlier. Using one of these browsers will cause you to
be redirected to the legacy knowledge portal.
Browsing Articles
From the knowledge homepage, you can select a knowledge base to browse articles within that knowledge base. You
can view only knowledge bases you can access. Articles are organized by category.
Searching Knowledge
You can search for knowledge articles
from the knowledge homepage using
the search bar at the top of the page.
Search results include only articles the
current user can read. Documents that
are attached to articles are also listed in
the search results (for those articles to
which you have access).
You can sort results by relevancy, most
recent update, or number of views.
You can filter results in these ways:
Knowledge Bases: select a
knowledge base to search. You can
select only knowledge bases you
can access. If you do not select a specific knowledge base, search results include articles from all knowledge
bases that you can access. You can also select a knowledge base from the choice list in the search bar.
Articles organized by category
Using Knowledge
Feedback
You can view and contribute to
feedback on knowledge articles.
Searching Knowledge
Administrators and knowledge managers can disable some feedback options using fields on the Knowledge Base
form. Administrators can configure feedback options using properties.
Flagging Articles
You can flag an article for incorrect or inappropriate content. Click Flag Article in the article header to open a new
window, allowing you to enter suggested changes.
Suggestions you make when flagging an article do not appear in the public comments for that article.
Rating Articles
The five stars below the article title allow you to indicate the article's effectiveness on a scale of 1 to 5.
Marking Articles
The question Helpful? at the bottom of the article allows you to indicate the usefulness of the article with a simple
Yes or No answer.
Using Comments
Knowledge comments at the bottom of the article use document live feed to enable a conversation around a
knowledge article. For example, you can post replies to comments, add attachments, or Like comments.
97
.doc
.htm
.html
.ini
.pdf
.ppt
.reg
.txt
.xls
.docx
.dotx
.dot
.pptx
.potx
.pot
.xlsx
.xltx
.xlt
98
1. Navigate to System Definition > Dictionary and select the record for the table.
2. Add the following to the Attribute field:
attachment_index=true
3. Click Update.
The indexing process begins. When it is complete, attachments can be searched on that table.
Note: The attachment indexing attribute only applies to the tables on which you explicitly add it. It does not cascade to child tables.
For example, indexing attachments on the cmdb_ci table does not index attachments on the cmdb_ci_computer table.
Enhancements
Calgary
Attachment indexing now supports Microsoft Office (2007 and greater) Open XML file formats.
New properties are available to help administrators debug attachment indexing.
99
.doc
.htm
.html
.ini
.pdf
.ppt
.reg
.txt
.xls
.docx
.dotx
.dot
.pptx
.potx
.pot
.xlsx
.xltx
.xlt
100
1. Navigate to System Definition > Dictionary and select the record for the table.
2. Add the following to the Attribute field:
attachment_index=true
3. Click Update.
The indexing process begins. When it is complete, attachments can be searched on that table.
Note: The attachment indexing attribute only applies to the tables on which you explicitly add it. It does not cascade to child tables.
For example, indexing attachments on the cmdb_ci table does not index attachments on the cmdb_ci_computer table.
Enhancements
Calgary
Attachment indexing now supports Microsoft Office (2007 and greater) Open XML file formats.
New properties are available to help administrators debug attachment indexing.
101
102
3. Select the Text index check box to enable text indexing for text fields on the table.
4. Click Update.
The Search for text option now appears on the list view for the table.
5. Click Generate Text Index.
This process may take a while to complete, and you may notice performance degradation or incomplete search
results while the index is being generated. To view indexing progress, see Viewing Text Indexing Statistics
and Status.
Stop Words
Stop words are common words that are not indexed because they are not meaningful in search results. Articles,
conjunctions, personal pronouns, and prepositions are examples of stop words that are not used in keyword searches.
Administrators can configure stop words for all indexed tables and for specific tables. See Administering ZIng Text
Search.
103
104
Sorting
The list may be sorted by any field displayed on the list. To sort list, select the name of the field, and then choose
either a to z or z to a depending on whether you want the results sorted in ascending or descending order.
This example shows incidents sorted by number in descending order.
105
106
Go To Searches
Locate the first record that starts with a certain value in a specified field and all records that follow it by selecting a
field and entering a text value. (When the specified field is Number, the Go To search finds all records the end with
the entered value.) For example, here we want to find incidents that have a short description that begins with SAP:
Number of Rows
The number of rows displayed on mobile lists is a user preference that is separate from the number of rows displayed
on desktop browser lists. This enables users to display a different number of rows on a mobile device as compared to
a desktop. To adjust this value, simply select a new number of rows and click Go.
107
108
109
110
111