Overview

This guide will outline how to configure your Oracle Taleo account to connect to Merge (or any other API-based integration).

Creating a User and setting Permissions

Taleo configures their permissions on user level; when creating a user type, it is recommended to duplicate an existing user type that has been validated in the zone already to work properly.

We’ve outlined some steps for granting permissions below:

1. Create and approve a new User

  • Create a Taleo User Account activated with Web Service permissions. If you don't have Web Service permissions enabled in your Taleo instance, skip to Enabling Taleo Web Service Framework

2. Define User Type, User Group, and Coverage Area

  • User accounts are defined by system administrators in SmartOrg.

    • (Navigation: Configuration > [SmartOrg] Administration > [Users] User Accounts.) When creating a user account, system administrators define several elements:

      • User Type (Recruiting)

      • User Group (Recruiting Center)

      • Coverage Area (Requisitions and Search)

      • General Preferences (can be modified by users in Taleo Recruiting, in the My Setup feature, to fit personal preferences)

3. Configure access to endpoint fields

  • We’ll need the user to have access to certain endpoints in order to get things up and running:

    Note: This list is a work in progress and does not encompass all the permissions required for all Merge common models supported in the Taleo integration (i.e Applications is not on this list). We'll continue to update this list as we discover the required permissions for each object.

Taleo Export Request

Field Path

Offer

projectedClass: Offer

Application,Number

AcceptedDate

RefusedDate

ExtendDate

ActualStartDate

Status,Number

Status,Description

UserAfterApprovalSuccess,UserNo

Job Interview Stage

projectedClass: ApplicationState

Number

Description

Attachments

projectedClass: Candidate

Number

AttachedFiles,Number

AttachedFiles,FileName

AttachedFiles,AttachmentType,Code

AttachedFiles,FileContent

Requisition

projectedClass: Requisition

Number

ContestNumber

JobInformation,Title

JobInformation,CreationDate

JobInformation,LastModifiedDate

JobInformation,DescriptionExternalHTML

JobInformation,PrimaryLocation,Number

JobInformation,OtherLocations,Location,Number

State,Number

State,Description

Requision,Department,Number

Requisition,HiringManager

Office

projectedClass: WorkLocation

Candidate

projectedClass: Candidate

Candidate,FirstName

Candidate,LastName

Candidate,CreationDate

Candidate,LastModifiedDate

Candidate,InclusiveLastModifiedDate

Candidate,Anonymous

Candidate,NotifyByEmail

Candidate,City

Candidate,HomePhone

Candidate,MobilePhone

Candidate,WorkPhone

Candidate,Number

Candidate,ReferralType

Candidate,CandidateReferrer,Number

Candidate,EmailAddress

Candidate,WebSite

Candidate,Applications,Number

Candidate,Applications,Requisition,ContestNumber

Candidate,Applications,Requisition,Number

Candidate,Applications,ReferralType

Candidate,Applications,ApplicationState,Description

Candidate,Applications,DisqualifierResultDate

Candidate,Applications,LetterSendRegretLetter

Candidate,Applications,DisqualifierResult,Number

Candidate,Applications,DisqualifierResult,Description

Sources

projectedClass: RecruitmentSource

Description

LastModifiedDate

User

projectedClass: User

User,UserNo

User,FirstName

User,LastName

User,CorporateEmail

User,PersonalEmail

User,CorrespondenceEmail

User,UserAccount,AccountCreationDate

Enabling Taleo Web Service Framework

You will need a User Account with "Web Service" permissions to be able to access and use the TaleoAPI. If you do not have this type of account, please contact your System Administrator to request one:

Step 1: Have the Taleo Production Team Enable the Web Service Framework

By default, the web service framework is disabled. The Taleo Production Team will activate it for you upon a proof of purchase. Contact your Customer Representative for further details about pricing and activation.

Step 2: Generate or Obtain the Web Services WSDL Files

To access the Taleo API, you need the Web Service Description Language (WSDL) files corresponding to the Web Services. A WSDL file defines a Web service that is available to you. Your development platform uses this WSDL to generate an API to access the Web service it defines. Each Web service available through the Taleo product is defined by a dedicated WSDL file. You can either obtain the WSDL files from your Customer Representative or you can generate them yourself if you

have access to the WSDL download page in the Taleo product user interface.

Did this answer your question?