An administrator can set element descriptions to modify what is displayed for elements in the Details view and in dialogs.
By default, the Description of a
document element is displayed as the value of the first XML content within that element
(or a descendant element). To display a different value, specify a relative XPath that
can be used to extract the description.
- Using the Workbench Ribbon or
the context menu of an object, select .
The Element
Descriptions webform appears.
- Click New to add a
new element description, or select an existing description from the list to
modify it.
- In the Element Name
field, enter the name of the element, and in the XPath(s)
field, enter the XPath expression to use for extracting the description for the
element.
Note: Because the Element
Name and XPath(s) values are within a repeat group,
you can have multiple pairs of these values. However, only one definition
for an element name is allowed. If multiple definitions are set for an
element name, only the first one is used.
| Field |
Description |
|---|
| Element Name |
The element name. Element names are case
sensitive. |
| XPath(s) |
The XPath expression:
<xpath1[,xpath2[...]]>. Attribute names are case
sensitive |
Recommendations regarding
the types of XPaths to use for element descriptions:
- The XPaths should
be relative. This means that they should not start with a '/'
character. Specifying an absolute XPath, if not necessary, slows
things down.
- The Element Descriptions column's use of the XPath picks the first match.
- Be as explicit as possible in specifying what you want. For example, section[1]/title[1] is better than /*/title.
- Add, modify, or delete
additional element descriptions in the repeat group, if desired.
- Click OK.
The element description(s) are
saved in the repository.
Note: An administrator must restart all Astoria Services on all ACS servers
to display changes resulting from altering element descriptions.