Kenexa     Kenexa XML Integrations                                                     

 

 

 

User Import Integrations:

Kenexa Recruiter BrassRing user information can be imported from an external system into Kenexa Recruiter BrassRing to facilitate adding and updating Kenexa Recruiter BrassRing users. User Data is any data that applies to Kenexa Recruiter BrassRing users, such as name, username, or password, that is maintained in a client’s HRIS.

Special Instruction for User Import Integrations

Name

Tag

Value

 Type

Notes

FirstName

Required

Required

Text (30)

LastName

Required

Required

Text (30)

EmployeeID

Required

Text (15)

Passing an empty value does not update existing settings.  For each user, EmployeeID serves as a key to identify whether this is an update to the existing user or an insert of a new user.  If supplied, must be unique.

UserName

Required

Required

Text (30)

Must be unique.  Cannot be updated.

Password

Required

Only on insert

Text (25)

Does not update value for existing users even though value is passed.  Required only for insert of new user; for existing users, password will be ignored and cannot be updated through integration process.

Email

Required

Required

Text (70)

Expressuser

Required

Only on insert

Char (1)

Does not update current value in the system if empty string is passed.  Values: 1 (Yes) or 0 (No).  Can be empty for updates.

Manager

Required

Only on insert

Char (1)

Does not update current value in the system if empty string is passed.  Values: 1 (Yes) or 0 (No).  Can be empty for updates.

Recruiter

Required

Only on insert

Char (1)

Does not update current value in the system if empty string is passed.  Values: 1 (Yes) or 0 (No).  Can be empty for updates.

UserType

Required

Only on insert

Single-Select

Does not update current value in the system if empty string is passed.   Can be empty for updates.

UserGroup

Only on insert

Single-Select

Does not update current value in the system if empty string is passed.   Can be empty for updates.

OrgGroup

Single-Select

OrgGroup is required upon insert only if Client has defined any Org Groups within Kenexa Recruiter BrassRing.  Does not update current value in the system if empty string is passed

Country

Single-Select

Defaults toUnited States

Localeid

Single-Select

If no values sent defaults to  client setting’s localid

RemoteLoginID

Phone

Text (40)

Title

Text (50)

Dept

Text (25)

Status

Required

Required

Char (1)

Values: either “A” (Active) or “I” (Inactive).  Users cannot be deleted from the Kenexa Recruiter BrassRing system for historical and reporting purposes.

SUPERVISORID

ROLE

SignatureImage

UserSignature

Language

Single-Select

If no values sent defaults to  client setting’s language

 

 

For example:

User John.Doe is a super user in the system. Passing the information below with no value in the UserGroup will update other fields in the system for the tags for which a value is passed but will not update the existing UserGroup for j.doe. If you don’t want to update an existing value then send blank value for that field and the integration will ignore it.

<Users>

       <User>

             <FirstName>John</FirstName>

             <LastName>Doe</LastName>

             <EmployeeID>092412</EmployeeID>

             <UserName>j.doe</UserName>

             <Password>12345abc!</Password>

             <Email>john.doe@kenexa.com</Email>

             <Expressuser/>

             <Manager/>

             <Recruiter/>

             <UserType/>

             <UserGroup/>

             <OrgGroup/>

             <Status>A</Status>

       </User>

</Users>

 

Note: The file size limit for User Imports should be 64KB per transaction.  Wait for the response (success or failure) then send the next transaction of up to 64KB.

 

Sample XML

 

<?xml version="1.0"?>

<Envelope version="01.00">

       <Sender>

             <Id>HRISUSER</Id>          <!-- Configured for a Client - Integration User - this information does not change once Kenexa provides -->

             <Credential>100</Credential>         <!-- Configured for a Client - Client ID - this information does not change once Kenexa provides -->

       </Sender>

       <Recipient>

             <Id/>

       </Recipient>

       <TransactInfo transactType="data">

            <TransactId>5555</TransactId>                     <!-- This is for tracking purpose for use to the Client only. It can be numeric or alphanumeric -->

             <TimeStamp>2006-02-28 09:22:10AM</TimeStamp>    <!--date-time value for troubleshooting and tracking -->

       </TransactInfo>

       <Packet>

             <PacketInfo packetType="data">

                    <PacketId>1</PacketId>

                    <Action>SET</Action>

                    <Manifest>MANIFESTNAME</Manifest>   <!-- Manifest is configured for a client at the time of integration. Provided by Kenexa-->

             </PacketInfo>

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

<Users>

       <User>

             <FirstName>XML</FirstName>

             <LastName>TEST</LastName>

              <EmployeeID>DUID</EmployeeID>

             <UserName>NETID</UserName>

             <Password>password</Password>

             <Email>johndoe@brassring.com</Email>

             <Manager>1</Manager>

             <Recruiter>1</Recruiter>

             <Country>USA</Country>

             <Localeid>1033</Localeid>

             <RemoteLoginID></RemoteLoginID>

             <Phone>781-555-5555</Phone>

             <Title>Quality Assurance Manager</Title>

             <Dept>Department 1</Dept>

             <UserType>Hiring Manager</UserType>

             <UserGroup>Standard Group</UserGroup>

             <OrgGroup>Orgroup1</OrgGroup>

             <Expressuser>0</Expressuser>

             <Status>A</Status>

       </User>

</Users>]]></Payload>

       </Packet>

</Envelope>

 

© 2008 Kenexa