Understanding External Search/Match Web Services

Oracle delivers web services that are triggered and used by External Search/Match functionality. Specifically, these web services are:

  • Match service (SCC_SM_SERVICE).

  • Fetch request and fetch response (SCC_SM_FETCH).

The PeopleSoft Campus Solutions Constituent Web Services Developer's Guide contains more technical details of these web services including examples of the XML message code.

Match Service

When you click the Search or Selective Search buttons on the Integrated Search Criteria page, the system conducts an Internal Search/Match, External Search/Match, or both. External Search/Match sends a Match Request to the external system. This is an XML message that contains all of the fields included in the search request. The external system returns a Match Response, also an XML message.

The Match Request XML message (SCC_SM_SERVICE_REQ) to the external system exposes all information that the system has:

  • All of the search order numbers that can potentially return matching candidates.

  • Search fields.

  • Search data.

  • Search/Match configuration information.

The Match Response XML message (SCC_SM_SERVICE_RESP) from the external system contains:

  • Search order number/rule that found results.

  • Matching candidates.

  • External System ID/cross reference.

  • Person data.

Fetch Request and Fetch Response

When you click the Detail or Import buttons on the Integrated Search Results page for a individual without an employee ID, the system sends a fetch request to the external system. This is an XML message that requests the full person record from an external system. The external system returns a fetch response, also an XML message.

The fetch request XML message (SCC_SM_FETCH_REQ) to the external system contains the external system ID for which the Import or Detail buttons were selected.

The fetch response XML message (SCC_SM_FETCH_RESP) from the external system contains the full person record.

When you import a new person record fetched from an external system:

  1. The HCM system creates an emplID.

  2. The HCM system publishes the PERSON_BASIC_SYNC message, if it has been activated within Integration Broker.

See the PeopleSoft Campus Solutions Constituent Web Services Developer's Guide on My Oracle Support.