Exporting Search Results

The TalentFilter Search Results Exporting Service exports resume search results to an openned web service on Partner side once a search has completed.

Exact resumes which are exported via Exporting Service can be additionally controlled by PositionSearchResultsExportDefinedByClients service.

TalentFilter Search Results Exporting Service will start exporting results for all searches finished for Partner when 'AcceptPositionSearchResultsWebServiceUrl' is set to non-empty string in [Partners https://www.talentfilter.biz/ws/partners.asmx.

Requirements

  • Your web service must be SOAP compatible
  • You must set  AcceptPositionSearchResultsWebServiceUrl to a non-empty string using the Partner Settings API
  • Your web service should define the  AcceptPositionSearchResults() method with the signature defined below

AcceptPositionSearchResults

Entry Point https://www.talentfilter.biz/ws/partnerSettings.asmx
Method Signature

AcceptPositionSearchResults(string resumesForPosition, string authToken): string

Parameters

authToken: authentication token; the service will be pushing a token previously set in AcceptPositionSearchResultsAuthToken Partner Setting; to set it, see [Partner Settings] API and description of AcceptPositionSearchResultsAuthToken in [Partner Settings List]

resumesForPosition: an XML that fully defines search results schema; this schema unites Search Results and Resumes schemata (see the formal description below)

Result Success/error notification (xml string)

resumesForPosition Parameter Schema

Field Name

Type

Description

Required?

Notes

id

String(50)

Unique ID of search result

Yes

Read-only!

positionId

String(50)

TalentFilter ID of position this search result corresponds to

Yes

Read-only!

createdDate

ISO8601 datetime (string)

When this search result was created

N/A

Read-only!

resumeId

String(50)

TalentFilter ID of resume this search result represents

N/A

Read-only!

searchId

String(50)

TalentFilter ID of search that found this result

N/A

Read-only!

viewedDate

ISO8601 datetime (string)

When this resume was last viewed in UI; or when MarkViewed() was called via API

N/A

Read-only!

searchProvider

String(50)

How this resume was found

N/A

Read-only!

Values:

LocalSearch

ExternalSearch

 

sourceId

String(50)

TalentFilter unique ID of source where this resume was searched from; the name of source can be searched via GetSourceInfo() API call

N/A

Read-only!

concreteScore

int

Score from 0 to 100 for all externally found resumes; not available for locally found resumes; more means more relevance

N/A

Read-only!

conceptScore

int

Score from 0 to 1000 for both locally and externally found resumes; more means more relevance

N/A

Read-only!

title

String(255)

Resume Title

N/A

Read-only!

email

SuggestedValues XML

Resume Email

N/A

Read-only!

phone

SuggestedValues XML

Applicant’s phone

N/A

Read-only!

firstName

SuggestedValues XML

Applicant’s first name

N/A

Read-only!

lastName

SuggestedValues XML

Applicant’s last name

N/A

Read-only!

state

SuggestedValues XML

State

N/A

Read-only!

city

SuggestedValues XML

City

N/A

Read-only!

zip

SuggestedValues XML

Zip code

N/A

Read-only!

address

SuggestedValues XML

Applicant’s address

N/A

Read-only!

postedDate

ISO8601 datetime (string)

When resume was retrieved and posted to TalentFilter

N/A

Read-only!

resumeDate

ISO8601 datetime (string)

When resume was created by its owner (as resume board believes)

N/A

Read-only!

rawText

Text

Resume’s raw text as it searched from remote source

N/A

Read-only!

clarifyXml

Text

Resume clarify terms in XML format

N/A

Read-only!

skillsXml

Text

Skills searched from resume (XML)

N/A

Read-only!

taggedText

Text

Resume’s raw text with tags that highlight miscellaneous features of this resume

N/A

Read-only

Samples

Parameter Sample

<resumes>
<resume>
<id>…</id>
<positionId>…</positionId>
<createdDate>…</createdDate>
<resumeId>…</resumeId>
…
</resume>
</resumes>

Paramter Result Samples

Success:

 

<success/>

 

Error:

 

<error id=”1” title=”Error title”>Error message</error>

 

Request Sample

 

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:rexp="http://www.talentfilter.biz/resultsexport/">
   <soap:Header/>
   <soap:Body>
      <rexp:AcceptPositionSearchResults>
         <rexp:authToken>123</rexp:authToken>
         <rexp:resumesForPosition>
              <resumes>
            <resume>
          <id>...</id>
          <positionId>...</positionId>
                      ...
            </resume>
              </resumes>
         </rexp:resumesForPosition>
      </rexp:AcceptPositionSearchResults>
   </soap:Body>
</soap:Envelope>

 

Result Sample

Success:

 

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <AcceptPositionSearchResultsResponse xmlns="http://www.talentfilter.biz/resultsexport/">
         <AcceptPositionSearchResultsResult>
              <success/>
         </AcceptPositionSearchResultsResult>
      </AcceptPositionSearchResultsResponse>
   </soap:Body>
</soap:Envelope>

Error:

 

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <AcceptPositionSearchResultsResponse xmlns="http://www.talentfilter.biz/resultsexport/">
         <AcceptPositionSearchResultsResult>
             <error id=”1” title=”Error title”>Error message</error>          
         </AcceptPositionSearchResultsResult>
      </AcceptPositionSearchResultsResponse>
   </soap:Body>
</soap:Envelope>

AcceptSourceCredentialsValidationInfo

Description This method is called by TalentFilter Search Results Exporting Service BEFORE the AcceptPositionSearchResults. It is triggered if and only if at least one of AcceptSourceValidationSuccessEvent or AcceptSourceValidationSuccessEvent partner settings is set to True.
Important: By default, this method is called only for changing credentials state; to have it called for every search, use AcceptSourceValidationStatus Partner Setting.
Entry Point https://www.talentfilter.biz/ws/partnerSettings.asmx
Method Signature

AcceptSourceCredentialsValidationInfo(string authToken, string seatSourceId, string validationDatetime, string status): string

Parameters

authToken: authentication token; the service will be pushing a token previously set in AcceptPositionSearchResultsAuthToken Partner Setting; to set it, see [Partner Settings] API and description of AcceptPositionSearchResultsAuthToken in [Partner Settings List]

seatSourceId: ID of Seat Source that changed its credentials validity status

validationDatetime: ISO8601 datetime when this source credentials was last checked

status: one of BECAME_VALID or BECAME_INVALID strings can be passed here

Result Success/error notification (xml string)

Samples

Parameter Result Sample

Success:

 

<success/>

 

Error:

 

<error id=”1” title=”Error title”>Error message</error>

 

Request Sample

 

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:rexp="http://www.talentfilter.biz/resultsexport/">
   <soap:Header/>
   <soap:Body>
      <rexp:AcceptSourceCredentialsValidationInfo>
         <rexp:authToken>123</rexp:authToken>
         <rexp:seatSourceId>1234-1234-1234-1234</rexp:seatSourceId>
         <rexp:validationDatetime>>[YYYY-MM-DDThh:mm:ssTZD (ISO8601)]</rexp:validationDatetime>
         <rexp:status>BECAME_INVALID</rexp:status>
      </rexp:AcceptSourceCredentialsValidationInfo>
   </soap:Body>
</soap:Envelope>

 

Result Sample

 

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <AcceptSourceCredentialsValidationInfoResponse xmlns="http://www.talentfilter.biz/resultsexport/">
         <AcceptSourceCredentialsValidationInfoResult>
              <success/>
         </AcceptSourceCredentialsValidationInfoResult>
      </AcceptSourceCredentialsValidationInfoResponse>
   </soap:Body>
</soap:Envelope>

AcceptSourceSearchExceptionInfo

Description This method is called by TalentFilter Search Results Exporting Service for every search that took place and had exceptions for some of its sources.
Important:
By default, this method is not called; to have it called, use AcceptSourceSearchExceptionInfo Partner Setting.
Entry Point https://www.talentfilter.biz/ws/partnerSettings.asmx
Method Signature

AcceptSourceSearchExceptionInfo(string authToken, string seatSourceId, string sourceId, string searchDatetime, string exceptionText, string searchId): string

Parameters

authToken: Authentication token; the service will be pushing a token previously set in AcceptPositionSearchResultsAuthToken Partner Setting; to set it, see [Partner Settings] API and description of AcceptPositionSearchResultsAuthToken in [Partner Settings List]

seatSourceId: ID of Seat Source that changed its credentials validity status

validationDatetime: ISO8601 datetime when this source credentials was last checked

status: One of BECAME_VALID or BECAME_INVALID strings can be passed here.

Exception Text Meaning:

  • NO_RESUMES: No Results found or able to be loaded from Source
  • FAILED_CONNECTION: Source website failed connection
  • MULTIPLE_LOGIN_ATTEMPTS: Unable to Log on due to Simulatneous log on attempts
  • SOURCE_LIMIT: Daily Results Limit Met
  • BAD_CREDENTIALS: Source Reported Bad Password
Result Success/error notification (xml string)

Samples

Parameter Result Sample

Success:

 

<success/>

 

Error:

 

<error id=”1” title=”Error title”>Error message</error>

 

Request Sample

 

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:rexp="http://www.talentfilter.biz/resultsexport/">
   <soap:Header/>
   <soap:Body>
      <rexp:AcceptSourceCredentialsValidationInfo>
         <rexp:authToken>123</rexp:authToken>
         <rexp:seatSourceId>1234-1234-1234-1234</rexp:seatSourceId>
         <rexp:validationDatetime>>[YYYY-MM-DDThh:mm:ssTZD (ISO8601)]</rexp:validationDatetime>
         <rexp:status>BECAME_INVALID</rexp:status>
      </rexp:AcceptSourceCredentialsValidationInfo>
   </soap:Body>
</soap:Envelope>

 

Result Sample

 

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <AcceptSourceCredentialsValidationInfoResponse xmlns="http://www.talentfilter.biz/resultsexport/">
         <AcceptSourceCredentialsValidationInfoResult>
              <success/>
         </AcceptSourceCredentialsValidationInfoResult>
      </AcceptSourceCredentialsValidationInfoResponse>
   </soap:Body>
</soap:Envelope>