Saving Searches and Job Agents

This topic provides an overview of saved searches and job agents and discusses how applicants work with saved searches.

Note: This feature has been replaced by My Saved Searches in Fluid. For more information, see Using Fluid Candidate Gateway to Save Searches.

Note: Applicants must sign in before they can save searches and job agents. The system prompts applicants to sign in if necessary.

Page Name

Definition Name

Usage

Save Search Page

HRS_APP_SAV_SCH

Save search criteria, and optionally request email notifications with search results.

My Saved Searches Page

HRS_APP_SEARCHES

View, edit, delete, and run saved searches.

Edit Search Page

HRS_APP_EDTSCH

Edit a saved search.

My Saved Searches (Legacy Search Results) Page

HRS_APP_SCHJOB_NF

View the results of a search that was saved before the introduction of faceted searching in Candidate Gateway

When applicants are signed in to Candidate Gateway, they can save search criteria from the Job Search page. (Search My Profile searches cannot be saved.) Saving enables applicants to rerun the searches without having to re-enter keywords and reselect filters.

Applicants can run the saved searches from the My Saved Searches page. The My Saved Searches page additionally enables applicants to delete and edit saved searches.

When saving a search, applicants can choose to receive automated email notifications listing jobs that meet the saved search criteria. These saved searches are known as job agents, although this term is not used on the Candidate Gateway pages.

To support job agent notifications, you must regularly run the Job Agent Application Engine process (HRS_JOB_AGNT) as described in the topic Using the Job Search Agent. Each time the process runs, the system checks for job openings that meet the saved search criteria. If there are postings that match the criteria, the system sends the applicant both a Candidate Gateway notification and an email with information about the search results. The email includes links to individual job openings that match the applicant's criteria, up to the maximum number of job openings specified in the Max Job Posts Per Notification field on the Recruiting Installation – Jobs Page. If the number of matches exceeds the maximum, the email directs the applicant to visit the Candidate Gateway to view all of the search results.

In Candidate Gateway, the job agent notification is a link that, when clicked, runs the saved search and displays the results on the Job Search page.

If the applicant has multiple job agents, the system generates separate emails and notifications for each job agent.

Although applicants can save an unlimited number of searches, the Recruiting Installation – Applicants Page page has two settings that limit an applicant’s job agents:

  • The Maximum Job Agents field controls how many job agents an applicant can have.

  • The Days Job Search Agent Active field controls how long a job agent remains active.

    After a job agent expires, no further notifications are sent. However, the search still remains available as a regular saved search.

Applicants use the Save Search page (HRS_APP_SAV_SCH) to save search criteria and to request email notifications with search results.

Navigation:

Click the Save Search button on the Job Search page (after entering search criteria).

This example illustrates the Save Search page.

Save Search page

My Saved Search

Field or Control

Description

Name My Search

Applicants enter a unique name to identify the saved search.

Notify me when new jobs meet my criteria

Applicants select this check box to save the search criteria as a job agent.

If the applicant already has the maximum number of job agents (configured in the Maximum Job Agents field on the Recruiting Installation – Applicants Page), the system issues an error, and the applicant must deselect the check box before saving.

Send email notification to

If the search is being saved as a job agent, the applicant must supply an email address for the job agent email notifications. The applicant’s primary email address is the default value.

Save Search

Clicking this button saves the search.

Current Saved Searches

This grid lists the applicant’s existing saved searches to provide context for the current saved search. Reviewing existing saved searches helps applicants choose a unique name for the Name My Search field.

Applicants use the My Saved Searches page (HRS_APP_SEARCHES) to view, edit, delete, and run saved searches.

Navigation:

  • Click the My Saved Searches link in the navigation bar that appears on pages throughout Candidate Gateway if the applicant is signed in.

  • Click the Save button on the Save Search page.

This example illustrates the My Saved Searches page.

My Saved Searches page

Saved Searches

Field or Control

Description

Search Name

Displays the unique search name entered by the applicant.

Created On

Displays the date that the applicant created the saved search.

Notifications Email

If the search was saved as a job agent, this field displays the email where job agent notifications are sent. Otherwise, this field displays the message No notifications will be sent.

Notification Expires On

If the Days Job Search Agent Active setting on the Recruiting Installation – Applicants Page has a value, then searches that were saved as job agents expire after the specified number of days. The expiration date is shown here in the Notification Expires On field so that the applicant is aware of the expiration date.

The expiration date is also given in the email notifications that the job agent process sends to the applicant.

This column is blank for searches that are not job agents.

Edit iconEdit

Clicking this icon displays the Edit Search Page, where the applicant can modify search criteria and job agent settings.

The Edit button is not available for searches that were saved before the introduction of faceted searching in Candidate Gateway. However, applicants can still run these legacy searches.

Delete Delete

Clicking this icon deletes a saved search. An alternative to editing a saved search is to delete the original search and create a new one.

Search

Clicking this button performs the saved search. The Job Search Page appears and displays both the search criteria and the search results.

Applicants use the Edit Search page (HRS_APP_EDTSCH) to edit a saved search.

Navigation:

Click the Edit icon for a saved search on the My Saved Searches page.

This example illustrates the Edit Search page.

Edit Search page

Saved Search Settings

The fields from the Save Search Page appear so that applicants can change either the search name or the job agent settings.

Search Criteria

The original search criteria appears. Applicants can review and modify the criteria. Clicking the Run Search button enables applicants to preview their search results.

Saving Changes

Field or Control

Description

Save Search

Clicking this button saves the search. If the search name is unchanged, saving updates the existing saved search. If the search name is changed, saving creates a new saved search.

Search Results

The system performs the saved search when an applicant initially accesses the page, and updates the results when an applicant clicks the Run Search button. The search results provide the applicant with feedback about the search criteria.

Within the results, applicant can interact with single job postings, but the Edit Search page does not provide options to act on multiple jobs, even if the site is configured to allow multiple job selection on the Job Search page.

Use the My Saved Searches (legacy search results) page (HRS_APP_SCHJOB_NF) to view the results of a search that was saved before the introduction of faceted searching in Candidate Gateway.

Navigation:

On the My Saved Searches page, click the Search button for a saved search that was created before the introduction of faceted searching in Candidate Gateway. You can recognize a legacy search by the disabled Edit icon.

This example illustrates the My Saved Search page that shows search results for legacy searches.

My Saved Searches - Legacy Search Results page

Field or Control

Description

Saved Search Criteria (not editable)

This area of the page displays the original search criteria.

Search Results

The Search Results list for a legacy search are the same as the Search Results list on the Job Search page. Applicants can sort the list, access job details, and click the My Favorite Jobs icon. Site settings control whether applicants can select and act on multiple jobs.