Foundation Integrations

Kenexa XML Integrations

Requisition Import Integrations:

Requisition data can be imported into Kenexa Recruiter BrassRing from an external system. Requisition data is any information that is in a job requisition such as the job description, job requisition number, and so on.

A client can originate a req in their HRIS system and configure the integration in such a way as to automatically create a req in Kenexa Recruiter BrassRing. The req fields to be transferred are chosen by the client at integration set-up time and recorded in the XML_Integrations_Data_Mapping_Document.doc.

Special Instructions for Requisition Import Integrations

1. Requisitions must be uploaded one at a time thus each XML envelope may contain only one requisition in the payload.

2. “formtypeid” and “name” attributes are required only if the client has more than one Requisition form defined.

3. There are six required requisition tags: REQUISITIONNUMBER, JOB_REQ_STATUS, MANAGER, RECRUITER, JOBTITLE, and JOBDESCRIPTION. All other tags are not required and can be defined by the customer.

4. The JOBOO node is optional and controls auto-posting of requisition to Talent Gateway(s). Each Talent Gateway must have a separate SITE node.

5. Each site node has six attributes: ID, NAME, DAYSTILLPOSTING, POSTINGDAYS,

QUESTIONIDS, and STATUS.

a. Site ID and NAME identify the Talent Gateway to which the requisition should be posted.

b. DAYSTILLPOSTING controls the number of days before the position will be

posted on the Talent Gateway.

c. POSTINGDAYS controls the number of days the requisition should remain

posted on the Talent Gateway.

d. QUESTIONIDS allow the client to select the specific Talent Gateway questions that should appear for that specific requisition posting on the Talent Gateway site. If no value is passed for this attribute, then the default questions associated with the Talent Gateway site will be automatically selected.

e. STATUS controls whether the requisition should be posted (“A”) to Talent Gateway site or removed (“I”) from it.

6. The Proximity node is optional and can be used only when the Proximity Search feature has been enabled by Kenexa on the requisition form. CountryId and StateId are required values. Either CityId or Zip must be passed but you do not need to send both (CityId may be passed as an empty element if Zip is passed). Kenexa will provide a list of valid CountryIds, StateIds, and CityIds.

Sample XML

<?xml version="1.0"?>

<Envelope version="01.00">

       <Sender>

             <Id>EMPLID</Id>

             <Credential>CLIENTID</Credential>

       </Sender>

       <Recipient>

             <Id/>

       </Recipient>

       <TransactInfo transactType="data">

             <TransactId>15747</TransactId>

             <TimeStamp>2006-02-28 09:22:10AM</TimeStamp>

       </TransactInfo>

       <Packet>

             <PacketInfo packetType="data">

                    <PacketId>1</PacketId>

                    <Action>SET</Action>

                    <Manifest>REQUISITION</Manifest>

             </PacketInfo>

             

             <Payload><![CDATA[<?xml version="1.0"?>

<REQUISITION formtypeid='123'>

       <JOB_REQ_STATUS>1</JOB_REQ_STATUS>

       <OPTIONALREQNUMBER>My First Position Number</OPTIONALREQNUMBER>

       <JOBCODE>A00268</JOBCODE>

       <JOBDESCRIPTION>Corporate. Under moderate supervision, designs, develops, tests, debugs and implements moderately complex operating systems components, software tools, and utilities required for the operation, maintenance, and control of computer systems. Makes moderately complex modifications to existing software to fit specialized needs and configurations, and maintains program libraries and technical documentation. Assists in planning, scheduling and implementation. Initiates corrective action to stay on schedule. Typically requires two to three years of experience.</JOBDESCRIPTION>

       <JOBTITLE>Systems Engineer</JOBTITLE>

       <JOBFUNCTION>Information Technology</JOBFUNCTION>

       <JOBFAMILY>Applications</JOBFAMILY>

       <SALARYGRADE>Supervisor/Intermediate Prof</SALARYGRADE>

       <EMPLOYEETYPE>Some Junk Here</EMPLOYEETYPE>

       <FULLTIMEPARTTIME>Full time</FULLTIMEPARTTIME>

       <REGULARTEMPORARY>Regular</REGULARTEMPORARY>

       <STANDARDHOURSPERWEEK></STANDARDHOURSPERWEEK>

       <SHIFT>All Shifts</SHIFT>

       <SALARYRANGE>42.0 - 74.0</SALARYRANGE>

       <NUMBEROFPOSITIONS>1</NUMBEROFPOSITIONS>

       <RECRUITINGCOORDINATOR>3057559</RECRUITINGCOORDINATOR>

       <LASTINCUMBENT></LASTINCUMBENT>

       <REPORTSTO></REPORTSTO>

       <DEPARTMENT>Corporate IT</DEPARTMENT>

       <GLCOSTCENTER></GLCOSTCENTER>

       <PLATFORM></PLATFORM>

       <LOCATION>Bldg 11</LOCATION>

       <CITY>Omaha</CITY>

       <STATE>NEBRASKA</STATE>

       <COUNTRY>United States</COUNTRY>

       <COMPANY>Cool Beans, Inc.</COMPANY>

       <BUSINESSUNIT>Corporate</BUSINESSUNIT>

       <CHANNEL>Corporate</CHANNEL>

       <OGINDICATOR></OGINDICATOR>

       <POSITIONREASON></POSITIONREASON>

       <EEO1JOBCATEGORY>2-Professionals</EEO1JOBCATEGORY>

       <EEOGROUP>Manager</EEOGROUP>

       <WORKCOMPCODE></WORKCOMPCODE>

       <FLSA>Exempt</FLSA>

       <TEAM>

             <EMPLOYEEID>3057559</EMPLOYEEID>

       </TEAM>

       <Proximity>

       <CountryId>223</CountryId><StateId>1924</StateId><CityId>56315</CityId><Zip>02452</Zip>

       </Proximity>

      <JOBOO>

<SITE ID="123" NAME="Acme Inc Careers" DAYSTILLPOSTING="0" POSTINGDAYS="365"

QUESTIONSIDS="" STATUS="A"/>

<SITE ID="456" NAME="Acme Inc Internal Opportunities" DAYSTILLPOSTING="0"

POSTINGDAYS="365" QUESTIONSIDS="" STATUS="A"/>



      </JOBOO>

</REQUISITION>]]></Payload>

       </Packet>

</Envelope>