Create a Search Widget
Use the Search Widget Properties window (accessed from within the Widget Manager) to create a Search Widget.
To create a Search Widget:
- Create a Widget.
- In the Type drop-down, select Search.
- Define general properties for the Search Widget:
- Title: This field is not used for a Search Widget. A title can be defined, but is not displayed on the Widget.
- Define which type of Search is available (can be run) from the
- Select one option:
- Quick Search: Select this radio button to allow a Quick Search to be run from the Widget (allows Users to search multiple Business Objects for all applicable records that contain specific words or phrases).
- Specific search: Select this radio button to allow a Specific Search to be run from the Widget (allows Users to search one Business Object for all applicable records that contain specific words or phrases).
- Both: Select this radio button to allow both a Quick Search and a Specific Search to be run from the Widget.
- If both types of Searches are available in the Widget, select a default Search (either Quick Search or Specific Search).
- Select one option:
- Define options for Quick Search (if used on Widget):
- In the Options area, click the Quick Search page.
- Custom Watermark Text: Select this check box to include a watermark inside the Search Control's box, and then provide the text to display (example: "Type search words here").
- Select the items (Business Objects) to include in the search, and
then define search options for each: For each item, click the
Add button, and then select a
Business Object (or
Document Repository) to include in the
Define the following search options for each Business Object:Note: Document Repository options are limited to applicable options.
- Name: Auto-fills with the name of the Business Object/Doc Repository.
- Custom Watermark: Select this check box to include a watermark inside the Widget's Search box. Provide the watermarktext to display (example: "Search Incident").
- Search For Any/All Words: Select whether to use any (OR) or all (AND) logic in the search.
- Open [records] Only: Select this check box to limit the
search to records that have not reached their final state (example: Not
Note: The lifecycle and terminology vary depending on the Business Object and scenario (example: "Unapproved Changes" is a lifecycle state for Change, and therefore is only available when searching Changes). If the Business Object does not have a "final" or closed state, the check box is not available.
- Changed: Select a timeframe to limit the search (example: Any time).
- Sort By: Select the Business Object Field (column) to use to sort the search results. Click the Sort in Descending Order button to toggle the sort order between ascending (1-10, A-Z, etc.) and descending (10-1, Z-A, etc.). A non-active icon indicates ascending order; an active icon indicates descending order.
- Search Related: Select this check box to include related
Business Objects in the search (example: If the search word appears in a
Journal entry, the Incident to which it is attached will be included in the
Note: In order to be included in the search, both the related Business Object and the Relationship must be enabled for Full Text Search (example: Select the Include in Full Text Search check box on the Business Object Properties window in a Blueprint (Search Results page) and the When Searching <bus ob> Include <related bus ob> in Full Text Search check box on the Relationship Properties window (General page)).
- Search Attachments: Select this check box to include
Attachments in the search.
Note: Attachments must be imported and attached to Business Objects in order to be searched. For example, if an Incident has an attached Word document that contains the search words, that Incident will be included in the search results.
- Limit Results: Select this check box to limits the results using defined criteria (example: Show only Incidents created within the last year). Click the Query button to define a Query that limits the search results.
- Default to Limited: Always selected.
- Limit Display Text: Provide the text to display above the search results so that users know how the data was filtered.
- Define options for the Specific Search (if used on Widget):
- In the Options area, click the Specific Search page.
- Define specific search options:
- Include All Of The Items Available In Quick Search As Individual Specific Options: Select this check box to include the Business Objects that were defined on the Quick Search page. Each of these objects will be available in a drop-down on the Widget and can be selected and searched individually.
- Include All Standard Options Available To User As Specific Options: Select this check box to include all Business Objects with Quick Search enabled (Show in Quick Search is checked on the Search Results page in the Business Object's properties window in a Blueprint). Each of these objects will be available in a drop-down on the Widget and can be selected and searched individually.
- Select the items (Business Objects) to include in the search, and then define search options for each (same as on the Quick Search page).