You are here: LearnCenter Designer > Widgets > Adding a Custom Search Widget

Adding a Custom Search Widget

Using a customizable Search Widget, Users can quickly find available training along with the delivery options. Users can search for, and quickly find their Courses, Classes, Learning Plans, ILT Sessions, Enrollments, Training Offerings, External Training, and other LearnCenter Users. On the Widgets page:

  1. Click   on the LearnCenter Design menu to expand it.
  2. Click Widgets.
  3. Click Add Widget.
  4. Select Search from the Select Widget Type drop-down list.

  1. Type a Name for the Widget.

  2. Type a Description for the Widget.
  3. Select a Status for the Widget. By default, the Status of the Widget is Active, which means it will be available for use as soon as you click Save. If you prefer, you can change the Status to Inactive until you are ready for Admins to begin selecting it.
  4. Click Save, and then select the Content tab.

  1. Select the check boxes for the Learning Types to include in Search. If you want to exclude certain types, clear the check boxes.
  2. For Show Selected Categories, indicate which Categories of items you want to include in the results. By default, All Categories is selected. You can manually select categories if you only want Users to search for items mapped to certain Categories. For example, perhaps you only want new employees searching for items that are mapped to the On-boarding Category, or your sales personnel searching for items mapped to the Sales Category.

You can restrict Widgets for certain audiences by using Access Filters. See Access Filters for information.

  1. Click the Filters tab.

Use this tab to indicate which facets should appear on the search results page.

  1. Select the check boxes for the facets you want to include under Filters for Search Results.
  2. If you are using eCommerce, you may want to include price ranges under Cost Range Results. Select the Cost check box to display the Cost Range Results fields. Type a value in the Under box. By default, all remaining ranges double the previous number based on your initial amount (for example 25, 50, 100, 200). You can edit these numbers if you want.
  3. Click the Display tab.

  1. Type the text you want to display for the Widget Header. This is the heading that displays at the top of the Widget. The default text is “Search”.
  2. Select the Highlight search words check box if you want the search terms in the results to be highlighted on the results page.
    or
    Clear the check box if you do not want search terms to be highlighted on the results page.
  3. Select the check boxes next to the items types you want to Display for Results.
  4. (Optional) If you would like any of the field labels to display differently in your output for Users, rest your pointer near the default label and select . A field displays and you can type something else for the label. If you want to return the label to the original default text, click Restore Label. Click the check icon to accept the change, or click the x icon to start over. You cannot change the label for Name.
  5. Indicate which Enrollments, ILT Sessions, and External Training events you want to show up in the search results by selecting (including) or clearing (excluding) Past, Current, or Future.
  6. Indicate whether you want Users to have access to the Advanced Search window by selecting or clearing the Display Advanced Search Options check box.
  7. Click Save when you are finished making changes.

What Users See

The following illustrations are examples of how this Widget displays to Users based on what the Admin selected in the Widget setup. Initially, all Users see the Search field and the Advanced Search button (if the Admin elected to show this during setup.)

 

A minimum of 2 characters is required to search. A wild card is assumed at the end of each word or phrase unless you use quotes (“ “) around each search string. Quotes return exact matches.Using Advanced Search. (See "How to Search for Keywords" below for additional search instructions.)

Users can click Advanced Search to display the Advanced Search window. This window makes it easy to do Boolean-style searches.

Everything you type in Include All of These (AND) is considered required. All words you type in this box should be separated with a space. Each space is considered as “And”.

Everything you type in Include At Least One Of These (Or) is considered an “Or” phrase. All words you type in this box should be separated with a space. Each space is considered as “Or”.

You can connect the two statements (fields) by selecting the ‘And Search’ check box. This means it will search for everything in the top box AND everything in the bottom box. (If you are familiar with Boolean search methodology, this field is the equivalent of surrounding the items in the keyword search field with parenthesis.)

A logical set of facets is provided with the search results so that Users can filter them efficiently.

Notice in the example above that search terms found are highlighted. Use of highlighting can be controlled during the Widget setup. Users can click the item title to view details, or click the launch icon on the right side of the results to open and begin an item. Search results can be narrowed using the facets that appear on the left side of the page. Selecting multiple facets further narrows results, and selecting fewer facets widens the search results. You can clear all selected facets and start over by clicking .

Selecting a facet check box includes its related items in the search results. For each selected Item Types or Categories check box, the page refreshes, and the results are cumulative. For example, a User might want to only include search results that are Learning Plans and Enrollments. Selecting the Learning Plans and Enrollments check boxes displays only Learning Plans and Enrollments in the search results. Users can narrow the results by:

LearnCenter places items in a cost range facet when they are over the minimum, and equal to or less than maximum. For example, if the cost ranges are 25-50; 50-100, and an item costs 50, it is included in the 25 to 50 facet, not the 50 to 100 facet.

Users can further narrow the results by selecting the Enrollments with Seats Available check box. Selecting this item displays only those Enrollments that have seats remaining.

How to Search for Keywords

Users can search for keywords in several ways.

Advanced search terms can be used in combination with one another. For example: “mandatory for comp*“ NOT Supervisors OR “Level1 Welders”.

Users can use parenthesis to group terms. For example: Compliance AND (Ethics OR Harassment). LearnCenter will retrieve results having the terms "Compliance" and "Ethics", as well as items with "Compliance" and "Harassment".

Search is not case sensitive.

The Search operators AND, OR and NOT must be in English for this first phase of the Search feature. The Search field is limited to 100 characters. For all other keywords, you can search using any supported language. The search term must be found in the item for the item be returned.

When using the search operators AND and NOT, tests are performed against each part of a result (i.e. name, description, standard and custom fields) to see if they meet the search criteria entered. If each part of a result passes the test, the result will be included or excluded based on the operator used. If one part of the result fails the test to match the search criteria, then a User may see results they would not expect to see.

How LearnCenter Searches Finds Results

The Search index includes an item’s name,description, all custom fields, and certain standard fields (see the table below for specifics). Search results with matches in name and description will rank higher in the results than those without name or description matches. It is possible for an item to be returned in the search results, but not have any highlighted terms, because the match was on an attribute or element that isn't displayed in the search result description.

Relevancy ranking is determined based on where the search term is found:

The results will include items made available in the Global Search functionality. (See Global Search for details about this existing feature.)

Related Topics IconRelated Topics

 

Copyright © 2010-2015, Oracle and/or its affiliates. All rights reserved.