Introduction To ServiceNow1
Introduction To ServiceNow1
Introduction To ServiceNow1
Part 1 of 2
PDF generated using the open source mwlib toolkit. See http://code.pediapress.com/ for more information.
PDF generated at: Tue, 18 Nov 2014 21:03:04 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
Customer Support
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, located in our support centers in San Diego, Amsterdam, and London, 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.
Customers working for commercial organizations can read this page to learn about obtaining customer support from
ServiceNow, including online resources and a customer support phone number. Customers working for government
organizations can obtain information specifically for their needs by reading the Customer Support for United States
Government Customers page.
Note: Customer Support does not provide assistance with implementations. Please contact the ServiceNow
Implementation Services [5] team.
Technical Support
ServiceNow Wiki
The ServiceNow Wiki is the main repository for ServiceNow product documentation. Recommended starting points
are the Main Page or the Site Map. The search functionality returns answers from both the wiki and the ServiceNow
community. Each article in the wiki offers comment and ratings functions. Participation and feedback are
encouraged. Questions concerning documentation can be registered on the Product Documentation forum in the
ServiceNow Community site or directly on each wiki page, using the Feedback tab.
ServiceNow Community
The ServiceNow User Community [11] offers blogs, articles, forums, and events related to ServiceNow usage,
administration, and customization. Searching the Community returns answers from all parts of the Community site.
User Forums
User forums [7] are an excellent resource for assistance with your ServiceNow instance questions. Forums are also
the place to discuss items related to ServiceNow functionality and processes with other users.
Knowledge Base
The Knowledge Base contains known errors, useful solutions, and troubleshooting tips to address commonly asked
questions. It can be accessed within HI [12] by navigating to Self-Service > Knowledge.
ServiceNow Monitoring
ServiceNow has a robust monitoring and diagnostics framework based on delivering cloud service to the end user.
This framework helps detect, respond, predict, and prevent issues at each layer of the service dependency. For
additional information, see ServiceNow Monitoring - Overview and Insight [13] in the HI knowledge base.
Support Basics
Hours: All support tools and materials are available on our websites 24 hours a day. The Customer Support team
is available 24 hours a day, 7 days a week, including all holidays.
Online Support: Customer Support system at hi.service-now.com [12]. Customers receive user IDs during the
implementation process.
Phone Support: For information, see Contact Us [10].
Technical Support
Submitting an Incident
To report an issue, submit an incident. For help filling out the incident form, click More Information near each field
for details about that field or choice.
For all HI incident reports, you must select an incident type. It is essential for quick resolution of the problem that
you choose the most appropriate selection. Additional fields appear on the incident form based on the type you
specify. The type options are:
Question or request: For general information, select this option.
Something is broken: If the instance behaves in an unexpected way or does not perform the way it should, select
this option. The issue may be caused by a bug, misconfiguration, or user error.
Performance issue: If the entire instance or sections of the instance are operating slowly, select this option.
Outage: If the entire instance or sections of the instance are completely inaccessible, select this option.
Technical Support
multiple articles, pages, or posts, click Found an answer. A feedback and rating screen appears. You can
type specific feedback and click a feedback button.
If there is no longer a reason to submit the incident, click Cancel submission. A feedback and rating screen
appears. You can type specific feedback and click a feedback button.
If you still need to file the incident, click Continue submission. Follow the remaining steps in this process.
8. Provide additional information.
The Type and Category specified on the first screen of the incident record producer are added to the top of
the Additional Information screen for reference.
Available fields on the Additional Information screen depend on the Type and Category specified.
Click More Information for details about a specific field.
9. [Optional] To add an attachment, click the paperclip icon and browse to a file. Attachments such as
screenshots, log files, and text files can provide additional, helpful information.
10. If you read any ServiceNow documentation, such as a wiki page, knowledge base article, or community post,
that did not provide an answer, copy and paste the URL into the text box to help us improve our product
documentation.
11. In Timezone currently set in your user profile, check the time zone listed. To change the time zone for this
individual incident, select a different time zone. On the incident record, the specified time zone appears in the
Requested time zone for incident field.
12. Click Submit.
A feedback and rating screen
appears with the incident
number listed at the top. You can
type specific feedback and click
a feedback button. If you click a
feedback button, your new
incident is displayed.
Submitting an Outage
Incident
5.
6.
7.
8.
If multiple instances are affected, select the one that is most critical and list the others in the Details section.
Customers can only select their instances. ServiceNow partners can select their own instances and the
instances of customers they manage.
In Are all geographical locations affected?, select Yes if more than a one region is affected by the outage.
In Can you get to the login page?, select Yes if you are able to view and use the login page on the instance.
[Required] In Details, type a description and any information that could help ServiceNow resolve the outage.
In Do you know when this issue occurred?, select an answer. If you select Yes, I know the start and end time,
specify the time the outage started and stopped.
9. In Timezone currently set in your user profile, check the time zone listed. To change the time zone for this
individual incident, select a different time zone. On the incident record, the specified time zone appears in the
Requested time zone for incident field.
10. In Is this issue affecting all users or some users?, select an answer.
Technical Support
5
11. [Optional] To add an attachment,
click the paperclip icon and
browse to a file. Attachments such
as screenshots, log files, and text
files can provide additional, helpful
information.
12. Do one of the following:
P2
P3
P4
Any request or defect that is important, but not significantly impeding work or progress.
Technical Support
[12]
Clone Request
Instance Upgrade Request
New Instance Request
Request Plugin Activation
References
[1] http:/ / community. service-now. com/ forums
[2] http:/ / community. service-now. com/ blog
[3] http:/ / wiki. service-now. com/ index. php?title=Main_Page
[4] https:/ / hi. service-now. com/ nav_to. do?uri=kb_home. do
[5] http:/ / www. servicenow. com/ services/ implementation-services. html
[6] http:/ / community. servicenow. com/
[7] http:/ / community. servicenow. com/ forums
[8] https:/ / community. servicenow. com/ login. jspa?registerOnly=true
[9] http:/ / hi. service-now. com
[10] http:/ / www. servicenow. com/ support/ contact-support. html
[11] http:/ / community. servicenow. com
[12] https:/ / hi. service-now. com/
[13] https:/ / hi. service-now. com/ kb_view. do?sysparm_article=KB0529232
Field
Description
Urgency
Short Description
Documentation
Additional
Comments
Public information about the enhancement request. Customers, partners, and ServiceNow employees can view and add
comments.
Release Terminology
Release Type
This table defines the types of releases that may be available in a family.
Type
Feature
release
Scope
Upgrade Policy
Patch release
Hotfix
*A feature provides a complete solution that customers can implement to add value to their organization. New
features are only available as part of a feature release. Features are supported with patches and hotfixes.
Release Phases
After release, each product family moves through three phases for customers and partners.
Phase 1: Early access by invitation only
Phase 2: Opt-in or auto-upgrade scheduled based on available dates
Phase 3: Opt-in, on-demand, or auto-upgrade
The following table provides a brief summary:
Phase
Phase
1
Yes
Phase
2
Yes
Phase
3
No
* The maximum number of customers that can upgrade per week is at the discretion of ServiceNow. The number
varies during the life cycle of a particular release version.
For more information about entitlements, see Requesting a Version Entitlement.
Release Cycle
The following diagram illustrates a hypothetical release cycle based on the types of releases that ServiceNow offers.
The example progresses as follows:
1.
2.
3.
4.
5.
6.
Is the scheduled upgrade time the starting or ending time? How long does an
upgrade take?
The scheduled upgrade time is when the instance record in HI is changed to reflect the new assigned version. Read
about this process in the Upgrades Best Practices.
The upgrade job starts after the HI instance record is updated to the new assigned version. The job typically runs
every hour on the hour, but is user configurable, so it may run at a different time for you. If you are using the default
configuration, the upgrade could be delayed up to 59 minutes past the specified time.
The amount of time required to complete the upgrade is affected by many factors including, but not limited to, how
busy your instance is at the time of upgrade, how much data is stored in the database, what version you are
10
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.
11
Upgrade History
12
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, personalize the form.
Upgrade History
13
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:
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
After you revert a customization, Reapply Changes becomes available. Click this button to reapply your
customizations (undo the revert).
Note: Reverting a customization is not tracked in update sets. You must perform this procedure on each instance for which you want
to revert your customizations.
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.
Troubleshooting Guide
The following pages are pages which give troubleshooting help. Another source for Troubleshooting and Frequently
Asked Questions is the HI's Knowledge Base, under the categories Technical Support Useful Solutions or FAQ. If
neither the Troubleshooting Guide nor the Knowledge Base provide adequate solutions to a problem, consult
customer support.
Performance
Homepage Performance
Email Notifications
System Update Sets
Access Controls
Reference Qualifiers
Task Activity
Process Guides
Adding Content Items to Service Catalog
14
15
Navigating Applications
16
Module Icons
In addition to names, modules in the application navigator also have icons.
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.
UI14
Navigation Filter (
): filters the applications and modules that appear in the navigator
based on the filter text. To learn more, see Using the Navigation Filter.
Favorites Filter (
): filters the modules displayed in the application navigator, showing either all modules or
the modules marked as favorites.
Menu (
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
17
Expand All Applications: expands all applications so that all available modules appear.
Note: To increase or decrease font size on pages and menus, click the gear icon on the banner.
Using Favorites
In 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
18
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
19
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
20
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
21
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
) may appear at the bottom right of some lists to indicate the processing time required
Title Bar
The title bar displays the title of the list
(table) and provides several controls.
Using Lists
22
of the list title (UI14) or when you
click the arrow icon ( ) beside
the list title (UI11). This menu
provides the following list controls:
View: changes the columns and order of the list to a predefined layout. Administrators can customize views.
Filters: applies a saved filter or allows you to edit a personal filter.
Group By: aggregates records by a field.
Show: changes the maximum number of records per page.
Refresh List: refreshes the list to show changes immediately.
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 (
): (UI14) shows recent record activity for all records currently displayed on a list. For
more information, see Displaying Activity Streams.
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
Using Lists
23
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, starting with the
Eureka release.
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 to the right of the column
name indicates the column currently
being sorted as well as the sort
direction.
Column Headings
): customizes the list layout for the current user. For more information, see Creating
Using Lists
24
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 ( ): provides
detailed information about the
UI11 Fields
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 (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 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 (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).
Note: Some of the options displayed on the field context menu depend on the user role and the installed applications.
Using Lists
25
2. Select the Modern cell coloring check box to use the UI14 style field status indicator. Clear this check box to use
the UI11 and classic style.
3. Click OK.
For more information, see Creating Personal Lists.
UI11 and Classic: in the column heading right-click menu, Update Selected records using an editing form.
For more information, see Editing Lists.
In the Actions choice list, Delete (administrators only), Show on Live Feed, Assign Tag, or Remove Label
(if applicable). For more information, see Creating and Using Labels.
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
An example hierarchical list
) or collapse icon (
Using Lists
26
To edit a row, double-click in an empty area of the field. See Using the List Editor.
To delete a row, click the delete icon ( ) beside the row.
New rows are removed immediately.
Existing rows are designated for deletion when the record is saved. To clear this designation, click the delete
icon again.
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
27
Editing Lists
28
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
29
Editing Lists
30
) 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.
31
Personalizing a List
To personalize a list:
1. Open the list.
2. Click the personalize list icon (
in the upper left corner.
To use updated field status indicators available in UI14, select the Modern cell coloring check box. Clear the
check box to use field status indicators available in UI11 and the classic interface.
5. Select list editing options (requires setup).
32
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.
Note:
To reset a list to the default layout, click the personalize list icon (
) and select the Reset to column defaults check box.
If a list is personalized, an indicator (
) appears in the upper left corner.
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.
For example, this is the Incident form in the Self-Service View:
Here is a quick video showing list and form view management in action.
View Management
33
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.
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.
Administering Views
Several views are included with the base system, including the
Default view and Advanced view. All view records are saved in
Switching views on a form
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 created additional views or modify the base system views.
Warning: Do not delete any of the base system views.
Creating Views
1. Navigate to the list or form that you want to create the view for.
2. Right click the header and select 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.
View Management
34
If you are creating a view for a form, you can also select a form section and personalize the fields for that
section.
You can also create views in the same manner when you personalize 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.
Input Value
Name
Match Conditions Select whether Any or All of the conditions need to be met.
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
Device type
Conditions
Exporting Data
35
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. Personalize 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. Personalize 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. Personalize the list or form to add or remove fields from the export.
Exporting Data
36
Note: When exporting PDF data from a form, only the fields that are visible from the current view are exported. 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.
Excel
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.
Exporting Data
37
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.
The final URL should look like one of these sample URLs:
Exporting Data
38
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&ORDERBYsys_id
[1]
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
39
Export Processor
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
40
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&ORDERBYassigned_to
URL Syntax
Description
sysparm_query sysparm_query=[column
name][operator][value]
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
ORDERBY
Sorts a list of records by the column names provided. For example: https://<instance
name>.service-now.com/incident_list.do?sysparm_query=priority=1&ORDERBYassigned_to
ORDERBY=[column
name]&[column name]
Exporting Data
<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/>
<rfc/>
41
Exporting Data
<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 =
DownloadFile("https://demo007.service-now.com/incident_list.do?CSV&sysparm_query=priority=1&ORDERBYassigned_to",
42
Exporting Data
43
"c:\\test\\incident.csv");
Exporting Data
44
// 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 starting with the Dublin release. If
you are using an older version, see the previous version information.
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.
Click the plus to expand previous version information
In releases prior to Dublin, the ServiceNow platform provides default upper and lower limits for XML data exports that are used under different
query conditions. The purpose of having two limits is to avoid creating performance issues when a table is excessively large. For exports that
exceed the upper threshold, break up the export into separate, manageable chunks.
Note: If you continue to use the upper and lower limits for XML data exports in a Dublin instance, they will continue to function
correctly. To ensure functionality in subsequent releases, however, modify your code to use the single Export Limit.
Exporting Data
45
Lower Limit:
The lower limit controls how many records ServiceNow exports by default from a list view. By default, exporting records from a list exports a
maximum of 10,000 records. To exceed the 10,000 record limit, create a URL export containing the sysparm_record_count.
For example, this query exports up to 40,000 records from the system log: http://<instance
name>.service-now.com/glide/syslog_list.do?sysparm_record_count=40000
Upper Limit:
The upper limit of 50,000 records is the maximum number of records that can be exported by a sysparm_record_count query parameter in
the URL. If the value of the sysparm_record_count query parameter exceeds 50,000 records, the platform defaults to 50,000.
Note: The upper limit for PDF exports is 5,000 rows. Since PDF exports cannot be broken up into smaller increments like other
data formats, any URL export using a PDF processor cannot have a sysparm_record_count value greater than 5000.
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.
Exporting Data
46
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
6,000
6,000
10,000
7,500
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
47
https://<instance
name>.service-now.com/syslog_list.do?XML&sysparm_query=sys_id%3E%3Db4aedb520a0a0b1001af10e278657d27&O
Note: URL queries use typical percent encoding [2]. 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
48
Enhancements
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.
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] http:/ / www. w3. org/ Protocols/ HTTP/ 1. 0/ draft-ietf-http-spec. html#BasicAA
[2] 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.
Uploading Attachments
49
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
Select files
Uploading Attachments
50
5. Close the pop-up window to return to the form.
Attached files
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.
Uploading Attachments
51
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
52
HTML Editors
There are two HTML editors available: TinyMCE (default) and htmlArea. The glide.ui.html.editor
system property specifies the editor used for HTML fields.
htmlArea Editor
The htmlArea editor is the legacy
editor for HTML fields.
TinyMCE version 4 editor
Using an HTML
Editor in WYSIWYG
Mode
htmlArea
The following sections describe the HTML field editing functions in WYSIWYG mode. 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.
53
Users can modify the TinyMCE toolbar and add or remove functionality. For more information, see Configuring the
TinyMCE HTML Toolbar.
Formatting
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.
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.
54
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
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
55
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:
Row type
Alignment
Height
56
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*
Editing
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.
57
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.
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.
58
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.
59
) 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.
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
60
61
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 thetarget 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.
62
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
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.
When the related fields are present, select a set of related fields.
63
Dot-Walking
After the related field is selected, the menu reloads with the related table's fields.
64
Dot-Walking
The new field is: caller.company
When looking at the list, it is easy to see where in the dot-walk the user currently is. Each selected reference is stored
at the top, and the number of dots in front indicate how many dots from the initial record the user has reached.
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:
65
Dot-Walking
Once a reference field is highlighted, the Expand icon appears above the Add icon.
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.
66
Dot-Walking
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:
67
Dot-Walking
68
${assigned_to.department.manager.mobile_phone}
Sometimes this variable can be selected from a Tree Picker.
).
For example, this Users glide list field has a select fields icon:
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:
Dot-Walking
69
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
Dot-Walking
70
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)
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
Breadcrumbs
Overview
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.
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.
71
Breadcrumbs
72
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 / so that the pin is pressed down.
To create a filter:
1. Open the condition builder by clicking the arrow ( ) beside the breadcrumbs.
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
Builders.
3. Select an operator from the drop-down list.
Breadcrumbs
73
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]
Breadcrumbs
74
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
Field
Caller
75
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
76
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, personalize the list to add the created_by and created fields.
To see who has access to the filter, personalize 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;
}
Breadcrumbs
77
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.
Breadcrumbs
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
Overview
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.
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.
78
Using Filters
79
Quick Filters
Right-click menu
Quick filters
Using Filters
80
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 / so that the pin is pressed down.
To create a filter:
1. Open the condition builder by clicking the arrow ( ) beside the breadcrumbs.
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
Builders.
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 condition on 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.
8. Click Run to apply the filter.
Note: To find all records that do not contain the specified value, create a filter with two conditions: [field] [is not] [value] or [field]
[is] [empty].
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].
Using Filters
81
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.
Using Filters
82
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
83
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, personalize the list to add the created_by and created fields.
To see who has access to the filter, personalize 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.
Using Filters
84
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
85
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.
Reference Icon
Reference Icon
Overview
The reference icon 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:
Windows Live
Users who are using the Windows Live Toolbar must disable the toolbar to use reference lookups.
86
Suggestion Fields
87
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.
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
88
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 Add. 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 Remove.
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 personalizing a form or list.
To move items one position, select the items and click Up or Down.
To move an item multiple positions, select consecutive items above or below the item then click Down or Up. 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 Down.
Slushbucket
89
Administrators can modify the glide.xmlhttp.excessive property to change the number of items that
appear in the Available column of the slushbucket. To modify this property:
1.
2.
3.
4.
Tree Picker
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.
90
Tree Picker
91
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).
Tree Picker
92
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
93
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
94
Operators
Several logical operators are available for each field type when creating a condition.
Field type
Operators
Field type
Operators
String:
is
is not
is empty
is not empty
starts with (case sensitive)
ends with (case sensitive)
contains
does not contain
is anything
is empty string
is same as
is different
Date-time:
on
not on
at or before
before
after
at or after
between
trend
relative
is empty
is not empty
is anything
is same
is different
is more than
is less than
Numeric:
is
is not
is empty
is not empty
less than
greater than
less than or is
greater than or is
is anything
is same as
is different
is
is not
is one of
is not one of
is empty
is not empty
less than
greater than
less than or is
greater than or is
is anything
is same as
is different
Boolean:
is
is not
is empty
is not empty
is anything
is same as
is different
Event:
is
is not
is one of
is not one of
contains
starts with (case sensitive)
ends with (case sensitive)
does not contain
is anything
is same as
is different
changes
changes from
changes to
Condition Builder
is (dynamic)
95
Me
One of My Assignments
One of My Approvals
Users With Roles
One of My Groups
Note: These operators return records that have a matching value in the fields you are querying. They do not return records with null
values in the queried fields. To return records with null values, use the is empty operator.
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.
96
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.
97
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.
98
Cancelling a Transaction
99
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.
100
Introduction to Searching
Text Search Plugin
Overview
Global text search finds records in multiple tables from a single search
field.
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:
Global text search
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.
101
Type-ahead search
Note: Administrators must enable the "Did you mean?" properties for users to see these 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.
102
103
Searching Knowledge
Overview
The knowledge search lets all users search the ServiceNow knowledge base for specific articles or topics and then
filter, organize, and refine search results, depending on administrator settings. Use the Advanced search link to
filter search results by topic, category, and search location.
By default, only published articles that have not passed their valid to date appear in knowledge searches for most
users. Draft and review articles appear to users with role-based permissions. Administrators can change the roles that
see draft or review articles, as needed.
In addition to the search options above the knowledge portal, you can search the knowledge base from:
Global text search: available to users with role-based permissions, the global text search field in the banner
frame searches the knowledge base as well as other types of records to which you have access rights.
Forms: the knowledge icon ( ) appears beside certain fields. Click the icon to launch a knowledge search for
the field's text. The search results appear in a pop-up window. This icon appears beside the Short description
field on the Incident and Problem forms by default; administrators may add it to other forms.
Content pages: created with the Content Management System (CMS), content pages can include knowledge
search options.
By default, knowledge searches also search the contents of attachments. Administrators can enable or disable this
feature.
Note: Knowledge search terms are stemmed
[1]
Searching Knowledge
104
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.
Type-ahead search
Note: Administrators must enable the "Did you mean?" properties for users to see these suggestions.
The articles viewed most frequently over the past 30 days (default) appear at the beginning and the least viewed
articles appear at the end. Administrators can modify the time period considered when sorting by view count.
Select an option from the Sort by field to sort by relevancy or by date modified, rather than view count.
Note: The sort option selected for Sort by is the only sorting factor applied; the other factors are not considered for secondary
ranking. So, for example, if you select to sort by Relevancy, and the search returns several results with the same relevancy values, the
Number of Views or Last modified values are not considered when ordering these same-value results.
Searching Knowledge
105
Advanced Search
After refining a search, you can either refine it further or return to search
all articles:
Click the icon to search the knowledge base for the text in the associated field. Search results appear in a pop-up
window, eliminating the need to navigate away from the current page. The pop-up results window offers the same
options for refining the search as the standard search results page.
When viewed from the pop-up window, the article view includes an Attach to Task button; the button name
changes to reflect the active form. Click this button to attach the article to the current incident, problem, or other
record. Other users who open the same record can refer to the attached knowledge articles, as needed.
Users with the admin or knowledge_admin role also see an Edit Article button. Click this button to open the article's
Knowledge form.
Searching Knowledge
106
If more than one translation of an article is available, the Language box appears in article view. Click a language
link to display the article in the selected language.
Searching Knowledge
References
[1] http:/ / en. wikipedia. org/ wiki/ Stemming
107
.doc
.htm
.html
.ini
.pdf
.ppt
.reg
.txt
.xls
.docx
.dotx
.dot
.pptx
.potx
.pot
.xlsx
.xltx
.xlt
108
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.
109
.doc
.htm
.html
.ini
.pdf
.ppt
.reg
.txt
.xls
.docx
.dotx
.dot
.pptx
.potx
.pot
.xlsx
.xltx
.xlt
110
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.
111
112
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.
113
114
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.
115
116
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.
117
118
119
120
121