Oracle® Fusion Middleware User's Guide for Oracle WebCenter Spaces 11g Release 1 (11.1.1) Part Number E10149-05 |
|
|
View PDF |
This chapter describes how to use the features provided through the Search service.
This chapter includes the following sections:
Section 55.1, "What You Should Know About the Search Service"
Section 55.2, "Setting Preferences for WebCenter Spaces Search Results"
Audience
This chapter is intended for users who want to use and manage search, as well as WebCenter Spaces administrators with the Application-Manage
Configuration
permission and individual Space moderators who want to configure search within their Spaces. For more information, see Section 51.2.1.2, "Understanding Permissions and Permission Models in a Space."
The Search service enables the discovery of information and people through an intuitive user interface, returning only the results you are authorized to view. With all relevant information easily navigable, you do not have to switch between applications performing multiple searches.
Use the Search service to run, refine, and save custom searches. By default, WebCenter Search looks for your search terms in every searchable service enabled in the application. You can configure the services to which a search has access with your personal preferences (see Section 55.2.1, "Selecting the Services to Search").
Information in WebCenter services is searched by name and content. When a search is run for a term that has been added as a tag to a document, the document is returned in the results, and the related tags appear in the Tag refiner section. For more information about tagging, see Chapter 56, "Working with the Tags Service."
In all cases, searches return only the results you are authorized to view. For example, if you are not a member of the Finance Space, then any search results from that Space do not display.
In addition to WebCenter Search, the Documents service provides its own search engine for file searches. This saves time and increases the relevancy of results by narrowing the scope of a search to files. The Documents service searches within a specific Space's document library. For more information, see Section 40.28, "Running Document Searches."
With WebCenter Spaces applications, internal WebCenter live search adapters are set as the default search platform; however, large-scale WebCenter implementations should be configured to use Oracle SES for best performance. Oracle SES provides unified ranking results for the following resources:
Documents, including wikis and blogs
Announcements and Discussions
Spaces, lists, pages, and people resources in WebCenter Spaces
Note:
Oracle WebCenter Spaces includes the additional Oracle SES crawler that indexes Spaces, lists, pages, and people resources in WebCenter Spaces. Oracle SES crawling of these resources supported in WebCenter Portal applications.For example, when you run a search for a user name, most likely, you are looking for that persons's contact information (that is, the exact user name in the People Connections service), not necessarily documents that the user wrote. The unified ranking in Oracle SES allows you to see the most relevant results, across all different types of searches, without configuring Search Preferences.
Additionally, with Oracle SES as the WebCenter search engine, you can use the wildcard character [*] in the middle or end of a term for wildcard matching. For example, when you search for keywords like wiki
or page
, Oracle SES does not return the wiki page MyWikiPage in search results. However, My*
or My*Page
does return MyWikiPage.
Note:
The default WebCenter search adapters do not support any wildcard searching.You can set your personal search preferences to specify which services to search and the order of services in your search results. For example, you may find that search results from the Documents service prove more useful that search results from other services. You can disable any service from which you do not want to see search results. For more information about setting search preferences, see Section 55.2, "Setting Preferences for WebCenter Spaces Search Results."
Oracle Portal applications automatically set Oracle SES as the default search crawler, but you can manually override search with Oracle SES and have WebCenter Portal applications search using the original WebCenter search adapters.
See Also:
"Configuring Search with WebCenter Search Adapters" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenterWhen you search content, you may find that the results from one service are more relevant to you than results from other services. You may find it useful to be able to exclude some services from a search and specify the order in which the results from selected services are listed.
Use WebCenter Spaces search preferences to choose the services to search and specify the display order for search results. This section contains the following subsections:
Your WebCenter administrator makes services available to the application. By default, all enabled services are selected to be searched. You can disable any service from which you do not want to see search results. For example, if you frequently search for a particular type of technology, including your personal contacts in the search is probably not useful.
To specify which services should be searched:
Click the Preferences link at the top of the application.
Click Search to open the Search Preferences pane (Figure 55-1).
To add a service to a search, choose one or more services on the Available Services list and click the Move selected items to list icon to move them to the Selected Services list.
To remove services from search, choose one or more services on the Selected Services list and click the Remove selected items from list icon to move them to the Available Services list.
Click OK to save your changes and exit the Preferences dialog.
Alternatively, click Apply to save your changes without exiting.
The services you add to the Selected Services list are included in future WebCenter Spaces searches. The services on the Available Services list are not searched.
Of all the services you include in a WebCenter Spaces search, you may find that some services provide more relevant results than others. For example, you may find that search results from the Documents service prove more useful that search results from other services. WebCenter Spaces Preferences provide controls for specifying the order in which services are listed in search results.
To specify a display order for search results:
Click the Preferences link at the top of the application.
Click Search to open the Search Preferences panel (Figure 55-2).
Choose one or more services on the Selected Services list and click the Move icons to the right of the list to move your selections higher or lower on the list.
The order you specify here determines the order each service is listed in search results.
Click OK to save your changes and exit the Preferences dialog.
Alternatively, click Apply to save your changes without exiting.
WebCenter provides search services for the application and beyond.
This section includes the following subsections:
This section describes how to run a global search and how to run a search within a specific Space.
This section includes the following subsections:
Global search provides an application-wide search. By default, you can perform a global search from the search field at the top-right of the application.
To perform a global search:
Locate the global search field and enter a search term.
For example, the search field at the top right of the WebCenter application is a global search field (Figure 55-3).
Press Enter or click the Search icon next to the global search field (Figure 55-4).
Results display in the search Results page (Figure 55-5).
Click a link to open a result.
Optionally, refine the search.
With the default WebCenter search adapters, you can refine by author or last modified date using the Refine Search section. With the Oracle SES adapter, you can refine by author, content type, last modified date, Space, and tag. For more information, see Section 55.3.2, "Refining the Display of Search Results." You can also save the search so that you can access the results later. For more information, see Section 55.3.3, "Saving Searches."
You can configure how search results are displayed. Specifically, you can control which services are included in the search and the order in which those services are listed in the results. Set this in the Search Preferences panel of the Preferences dialog (for information see Section 55.2, "Setting Preferences for WebCenter Spaces Search Results").
An estimated number of search results appears if your application is configured with the Oracle SES adapter (Figure 55-6).
Figure 55-6 Estimated Number of Search Results
If your application uses the WebCenter search adapters, then an estimated number of results is not included. Click the Previous and Next links to view any additional results. These links may appear even if no additional results are available.
WebCenter search performs global (that is, application-wide) searches.
For members of a Space to perform searches limited to that Space, the Space administrator must create a new Resource Catalog, add the Search task flow to the catalog, and then assign this catalog to the Space. (The Search task flow is not available in the default Resource Catalog.) For example:
Go to Administration - Resources - Resource Catalogs, and either click to create a new resource catalog or select an existing resource catalog and select Edit - Copy.
Enter a name for this new Resource Catalog (Figure 55-7).
Figure 55-7 Editing a Default Resource Catalog to Include Search
Click Edit - Edit, Add, then Add from Library.
Select Task Flows, then scroll down to select the Search task flow, and click Add (Figure 55-8).
Figure 55-8 Add Resource Catalog Item Dialog
You see the Search task flow added to the Resource Catalog. Optionally, you can drag and drop the task flow into one of the folders. With the Search task flow selected, click Edit (pencil) to add a description for this new catalog item (Figure 55-9).
Figure 55-9 New Resource Catalog with the Search Task Flow Added
On the Target tab, add a description (Figure 55-10).
Figure 55-10 Edit Resource Catalog Item - Target Tab
On the Options tab, for New Attribute Name select Icon URI, and for New Attribute Value, enter /adf/webcenter/search_qualifier.png
(Figure 55-11).
Figure 55-11 Edit Resource Catalog Item - Options Tab
Click Add, then OK and OK again to close the Edit. You see the new icon and description appear in the Resource Catalog (Figure 55-12).
Back on the Administration - Resources - Resource Catalogs page, select this new Resource Catalog, and click Edit - Show to make it available.
Create a new Space, and display the General page of the Space administration settings.
For Resource Catalog for Pages, select the new Resource Catalog, and click Apply (Figure 55-13).
Figure 55-13 Space Administration Settings for New Resource Catalog
In the new Space, create a new page (Figure 55-14).
On the new page, click Add Content, navigate to the Search task flow, and click Add to add the Search task flow to the page. Click Close.
Click Save, then Close.
You can configure how the search results are displayed. Specifically, you can control which services are included in the search and the order in which those services are listed in the results. For information about setting display options for Space search results, see Section 55.2, "Setting Preferences for WebCenter Spaces Search Results."
The Search service provides a means of narrowing down your searches using refiners, which you can add to the current search to produce a smaller set of results.
With the default WebCenter search adapters, you can refine your search by specifying a time range within which the result was last modified and by limiting results to those associated with a particular user.
Note:
Results from people, tags, tagged items, and favorites, which do not supply refiners to the Search service, do not appear in refined searches.With the Oracle SES adapter, you additionally can refine the search by content type, Space, and tag.
To refine the display of search results:
Perform a global search as described in Section 55.3.1.1, "Performing a Global Search."
Or perform a Space search as described in Section 55.3.1.2, "Performing a Space Search."
The search results display on the Search results page.
In the Refine Search section, choose criteria to refine the search. For example, choose a time-range limitation from the Last Modified box (Figure 55-16).
Figure 55-16 The Last Modified Refiner on the Search Results Page
For example, click Past 7 Days to view all results that originated in the past week. Click March 2010 to view all results that originated in March 2010.
The number next to each time range indicates the search's best guess at how many search results fall within the specified range.
Some date selections, such as years or months, provide additional refinement options when you choose them. For example, when you refine a search by all results occurring within 2007, your refined results display and additional refinements appear in the Last Modified box.
Alternatively, click Custom Date Range and enter a date in the field provided (optionally, with an end date also), or click the Select Date icon and choose a date from a date picker (Figure 55-17).
To refine the display of search results by author (that is, by the user name of the person who created, uploaded, or originated the result), choose someone from the Author box (Figure 55-18).
Figure 55-18 The Author Box on the Search Results Page
For example, click vicki to view all results contributed by the user vicki
.
The number next to each user name indicates the search's best guess at how many search results are associated with the specified user.
Click More... or Less... to see more or less authors in the Author box.
When a refinement is selected, it appears above the Results list with a Delete icon, enabling you to remove the refinements you have applied to search results (Figure 55-19).
Figure 55-19 Delete Icon to Remove Refinement of Search Results
Click the Delete icon to remove that particular search results refinement and broaden the list of displayed results.
After you have performed a search, you can save it so that you can run it again later without having to re-enter the search terms. You can also share the saved search with Spaces.
Note:
You can save searches only if you are logged in to the application.This section includes the following subsections:
Saved searches are useful for the searches you run frequently. They assist in keeping you current as new information is added to the search pool.
To save a search:
Perform a global search as described in Section 55.3.1.1, "Performing a Global Search."
Or perform a Space search as described in Section 55.3.1.2, "Performing a Space Search."
The search results display on the Search results page.
Click Save below the search field (Figure 55-20).
The Create Saved Search dialog opens (Figure 55-21).
In the Name field, enter a meaningful name for the search.
The value you enter in the Name field is the value that appears on the dropdown list of saved searches.
The search that was in the Search field is saved, no matter what name you give it. For example, if the search term was admin, but you enter jcr in the Name field. The saved search searches for the term admin and not jcr.
Optionally, in the Description field, enter a description of the search.
Select the Share in space checkbox to enable other members of the Space to see this search on the Space's dropdown list of saved searches. Only one Space can be specified.
Click the Spaces icon to select the spaces in which to share the saved search.
Click OK to save the search.
The All Saved Searches task flow provides a quick and easy way to see all saved searches. The saved searches to which you have access depends on the location.
Go to your Home Space. After you have saved searches, there is a dropdown list for Saved Searches in your Home Space.
Go to any page containing the All Saved Searches task flow (Figure 55-22).
In a Space, the All Saved Searches task flow lists all your saved searches for the Space and all shared saved searches for the Space (made both by yourself and other users). It does not list your global saved searches or saved searches made against other Spaces. In a Home Space, the All Saved Searches task flow lists all your global saved searches.
Go to any page where the saved search was placed.
The Saved Search task flow shows the results of the particular search.
To run a saved search:
Log in and find the saved search:
Locate the page containing the All Saved Searches task flow.
Locate the page containing the saved search. In this case, the search results are immediately visible.
From the All Saved Searches task flow or the Saved Search panel in the Home space, click the link for the saved search you want to run.
Tip:
The description is rendered as a tooltip when you move your cursor over the name of the saved search.View the results on the dynamically-generated Search Results page.
In WebCenter Spaces, you can share a saved Space search if you think the results of a search might be useful for other Space members.
To share a saved search:
Go to the Space where the search was performed and saved.
Click Manage (Figure 55-27).
The Manage Saved Searches window opens (Figure 55-28).
In the Saved searches dropdown list, select the saved search you want to share.
Select the Share in space checkbox, and click the Spaces icon to select the Spaces in which you want to share this saved search.
The saved search is now available for other members of the Space to run. The search is listed in the Saved Searches list for all Space members and in the All Saved Searches task flow, if one exists.
Click Apply, then OK.
After you have added the results of a saved search to a page, you can customize it.
Click the Personalize icon (Figure 55-25) to make changes to the saved search.
In the Customizing Saved Searches dialog, you can to change the search terms, add refiners, or choose the services to search (Figure 55-26).
Figure 55-26 Customizing Saved Searches Dialog
To delete a saved search:
Click Manage (Figure 55-27).
The Manage Saved Searches window opens (Figure 55-28).
In the Saved searches dropdown list, select the saved search you want to delete.
Click the Delete button, then Apply and OK.
The Search service task flows have associated properties, which users with sufficient privileges can access from the Component Properties dialog in Oracle Composer (Figure 55-29).
For information about accessing the Component Properties dialog, see Section 16.5.2.3, "Setting Component Properties."
The following sections provide information about properties of the Search service task flows and describe the properties on the Parameters tab.
The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 55.4.2, "Search Service Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 18, "Wiring Pages, Task Flows, Portlets, and UI Components."
Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 16.5.2, "Setting Properties on Page Components."
The content of the Events tab depends on the events supported by the task flow. For more information, see Section 16.5.2.8, "Working with Component Contextual Events."
The Child Components tab displays all of the components contained within the current component. It provides controls for rearranging, showing, and hiding child components. Not all components contain children. So this tab may be omitted. For more information, see Section 16.5.2.6, "Working with Child Components."
All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."
Table 55-1 describes the properties that are unique to the Search task flows.
Table 55-1 Search Service Task Flow Parameters
Property | Description | Task Flow |
---|---|---|
A list of IDs of services or executors to omit when displaying search results. This parameter is intended for internal use only. Do not change this value. |
Search |
|
Show or hide the input box. Set to true (default) to show the input box, or set to false to hide it. |
Search |
|
Either search keywords or the saved search GUID. This parameter is intended for internal use only. Do not change this value unless you want coded search main views. If you do change this value, then you must also specify |
Search |
|
Unique ID to limit the search scope. To limit the search to a particular Space, set this to the GUID of the Space; for example, |
Search |
|
A marker specifying whether the This value is set automatically and is for internal use only. Do not change it unless you want coded search main views. |
Search |
|
Unique ID to limit the search scope. To limit the search to a particular Space, set this to the GUID of the Space; for example, |
Search Toolbar |
|
Value to limit the size of the search box. The default value is 42. Enter a lower number (for example, 30) to shorten the length of the search box. This also changes the size of the search box in the Search task flow. |
Search Toolbar |
Note:
The All Saved Searches and the Search Preferences task flows do not have any unique properties.