Partner Settings Resources

GetSettings

Description

Returns current partner settings

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

GetSettings(string authToken): string

Parameters

authToken: authentication token that identifies partner application

Result XML string

Samples

Request Sample

 

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ws="https://www.talentfilter.biz/ws/">   <soap:Header/>   <soap:Body>      <ws:GetSettings>
         <ws:authToken>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</ws:authToken>
      </ws:GetSettings>
   </soap:Body></soap:Envelope>

 

Result Sample

 

<partnerSettings>
<AcceptPositionSearchResultsWebServiceUrl>
URL of webservice | or empty string
</AcceptPositionSearchResultsWebServiceUrl>
… see [Partner Settings List] for full list of fields here …
</partnerSettings>

SetSettings

Description

Returns full set of partner settings as they were updates

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

SetSettings(string authToken, string settingsXml): string

Parameters

authToken: authentication token that identifies partner application

settingsXml: settings description XML; at least one setting should be passed

Result XML string

Partner Settings List

Setting

Description

AcceptPositionSearchResultsWebServiceUrl

This setting defines fully qualified URL of web service on Partner’s side. The service must satisfy appropriate requirements (see: [General Requirements]). Its role is to accept resume search results pushed by Search Results Exporting Service

AcceptPositionSearchResultsAuthToken

This setting defines AuthToken that will be passed by Search Results Exporting Service to Partner’s web service. This is to ensure that resumes are pushed by TalentFilter, not by some third party. Allowed values: any string, up to 255 chars.

EnablePasswordlessUi

Allowed values: True | False. False by default. If set to True, enables UIs that display position, found resumes, and resume details. These UIs can be accessed by partner’s users without supplying login/password. The authentication is being done by referrer URL.

This functionality is useful for placing links to TalentFilter position in partner’s system so users can click these links and directly see TalentFilter position and its results.

Sample URL for passwordless access to position:

http://www.talentfilter.biz/external.aspx/Partner/ViewObject?view=brief&id=POSITION_ID

PasswordlessUiReferrerHost

The passwordless UI (described above) will allow access if and only if the referrer host matches the one stored in this setting.

AuthorizedApiAccessIp

New line separated authorized IP’s list

MinResumeExportingConceptScore

Minimal resumes exporting concept score. This affects what resumes will be exported by [TalentFilter Search Results Exporting Service].

MinResumeExportingConcreteScore

Minimal resumes exporting concrete score. This affects what resumes will be exported by [TalentFilter Search Results ExportingService].

AcceptSourceValidationFailureEvent

 

Allowed values: True | False. False by default. Can be set to True if and only if both AcceptPositionSearchResultsWebServiceUrl and AcceptPositionSearchResultsAuthToken are set. Otherwise setting it to True will throw error and the value will not be changed.

If this value is set to True, TalentFilter will call AcceptSourceCredentialsValidationInfo() method of [TalentFilterSearch Results Exporting Service]. The frequency of calls depends on AcceptSourceValidationStatus setting value:

  • if AcceptSourceValidationStatus is False, the event will be reported only if the state changes to INVALID; the subsequent failures of the same source will NOT be reported;
  • if AcceptSourceValidationStatus is True, the INVALID source credentials validation status will be reported for every new search until the status is VALID.

AcceptSourceValidationSuccessEvent

Allowed values: True | False. False by default. Can be set to True if and only if both AcceptPositionSearchResultsWebServiceUrl and AcceptPositionSearchResultsAuthToken are set. Otherwise setting it to True will throw error and the value will not be changed.

If this value is set to True, TalentFilter will call AcceptSourceCredentialsValidationInfo() method of [TalentFilterSearch Results Exporting Service] depending on AcceptSourceValidationStatus setting value:

  • if AcceptSourceValidationStatus is False, the event will be reported only if the state changes to VALID (from INVALID or NA); the subsequent successes of the same source will NOT be reported;
  •  if AcceptSourceValidationStatus is True, the VALID source credentials validation status will be reported for every new search until the status is INVALID.

EnableSuggestedValuesInExportingService

 

Allowed values: True | False. True by default. Determines the behaviour of <suggestedValues> XML in fields of resumes being exported. See [Schema of resumesForPosition parameter] for the list of fields that support this and [Suggested Values XML] for description of XML format.

AcceptSourceValidationStatus

Allowed values: True | False. False by default. Influences the logic of AcceptSourceValidationFailureEvent and AcceptSourceValidationSuccessEvent. If AcceptSourceValidationStatus was set to True, the appropriate events will be reported for every search; otherwise they will be reported only when the validation status changes.

AcceptSourceSearchExceptionInfo

Allowed values: True | False. False by default. Defines if AcceptSourceSearchExceptionInfo method will be called by exporting service on Partner’s side.

PositionSearchResultsExportDefinedByClients Allowed values: True | False. False by default. If set to True, partner can explicitly select resumes from list which will be pushed.
ResumesListExportButtonCaption Type: string, can be empty. 'Export to <partner_name>' by default. Defines the name of the export button on resumes list.

Samples

Request Sample

 

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ws="https://www.talentfilter.biz/ws/">   <soap:Header/>   <soap:Body>      <ws:GetSettings>
         <ws:authToken>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</ws:authToken>
         <ws:settingsXml>
<partnerSettings>
<AcceptPositionSearchResultsWebServiceUrl>
URL of webservice | or empty string
</AcceptPositionSearchResultsWebServiceUrl>
… see [Partner Settings List] for full list of fields here …
</partnerSettings>
         </ws:settingsXml>
      </ws:GetSettings>
   </soap:Body></soap:Envelope>

 

Result Sample

 

<partnerSettings>
<AcceptPositionSearchResultsWebServiceUrl>
URL of webservice | or empty string
</AcceptPositionSearchResultsWebServiceUrl>
… see [Partner Settings List] for full list of fields here …
</partnerSettings>