Searching the Help
To search for information in the Help, type a word or phrase in the Search box. When you enter a group of words, OR is inferred. You can use Boolean operators to refine your search.
Results returned are case insensitive. However, results ranking takes case into account and assigns higher scores to case matches. Therefore, a search for "cats" followed by a search for "Cats" would return the same number of Help topics, but the order in which the topics are listed would be different.
Search for | Example | Results |
---|---|---|
A single word | cat
|
Topics that contain the word "cat". You will also find its grammatical variations, such as "cats". |
A phrase. You can specify that the search results contain a specific phrase. |
"cat food" (quotation marks) |
Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase. |
Search for | Operator | Example |
---|---|---|
Two or more words in the same topic |
|
|
Either word in a topic |
|
|
Topics that do not contain a specific word or phrase |
|
|
Topics that contain one string and do not contain another | ^ (caret) |
cat ^ mouse
|
A combination of search types | ( ) parentheses |
|
Expression Language editor
Service Management provides a context-assisted editor to help you build expressions using Expression Language.
When you are entering an Expression Language phrase, start by pressing CTRL and the space bar to display a drop-down list. The list includes both objects and functions. When you hover over the functions, a tooltip displays the function syntax with its arguments. Select an item in the list and press Enter or double-click it to select it.
-
If you select a function, the function appears in the text box. You must complete the expression manually, by adding parentheses and the function arguments.
-
If you select an object, the object appears in the text box. Enter a period manually. A second drop-down list is displayed, including the available fields and relationships for the selected object. If you select a relationship and enter a period, another drop-down list is displayed with the available fields.
For example, if you select entity as the object, typing a period displays a list of the available fields for the current record. If you select AffectsActualService, it denotes the Actual Service affected by the current record. Typing a period displays a list of available fields for that Actual Service. If you select OwnedByPerson, it denotes the person who is the owner of the Actual Service affected by the current record. When you click OK, the editor completes the expression as follows: ${entity.AffectsActualService.OwnedByPerson}.
- You can press CTRL and the space bar at any point in the expression to display the drop-down list of objects and functions. If you display the list after an operator, it also includes the values true, false, and null.
Tip When a drop-down list is open, you can type the first few letters of the required option to filter the list.
When you click outside of the text box, the editor performs a validation on the expression. If the expression is not valid, an error message is displayed, detailing the source of the problem. Examples include an expression containing a field or object that does not exist, or an expression containing the wrong number of parameters for a function.
Color coding
The editor colors different parts of the expression to make it easier to interpret:
- objects are colored purple
- fields are colored blue
- strings are colored red
Note
- You do not need to enter the $ symbol or the brackets manually. When you click OK, the editor automatically inserts these symbols into the expression.
- The Expression Language editor does not display available parameters for dynamic complex fields such as the UserOptions field.