SAP Knowledge Base Article - Public

2876414 - How Assessment Integration Works (Event Subscription) - Recruiting Management

Symptom

This article describes the steps on How Assessment Integration Works when configured using Event Subscription.

"Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental."

Environment

SAP SuccessFactors Recruiting Management (RCM)

Resolution

1. Candidates are placed in the Assessment Status and an assessment request alert is created in Admin Center > Event Notification Audit Logs. The status in the Assessment portlet will be Initiated.

ask4.png

2. An assessment request is made and logged in Event Notification Audit Logs after which, the middleware application picks up the data via their event listener. If there is no event notification created here, there will be no data for the middleware listener to process.

ask3.png

Note: Middleware listeners typically do not run on schedule, they run when there is data.

3. In an event that alert notifications are not created in the Event Notification Audit Log, please contact Support, provided that your configuration is correct and it has worked before.

4. The Middleware application will send the information to the third-party vendor.

5. The Vendor will sent out an email to the candidate to get an assessment exam, after which, the Vendor sends the assessment information back to the middleware.

6. The Middleware application returns the information to SuccessFactors and marks the assessment as completed.

ask5.png

7. This is what an assessment request looks like. You will find this on the Event Notification Audit Logs in Admin Center, when you click on the View link.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:createRcmAssessmentRequest xmlns:ns6="http://alert.successfactors.com" xmlns:ns5="http://notification.event.successfactors.com" xmlns:ns7="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns2="http://www.boomi.com/connector/wss" xmlns:ns4="com.successfactors.alert" xmlns:ns3="com.successfactors.event.notification">
    <ns4:rcmAssessmentRequest>
        <ns4:entityId>1456</ns4:entityId>
        <ns4:entityName>AssessmentOrder</ns4:entityName>
    </ns4:rcmAssessmentRequest>
</ns2:createRcmAssessmentRequest>

8. Description of Assessment Request Elements seen in the Assessment request above.

a. createRcmAssessmentRequest: The root element of the request to the web service operation.
b. rcmAssessmentRequest: The payload that carries information on the RCM assessment request.
c. entityId: The assessment order id.
d. entityName: The entity being shared. "AssessmentOrder" is the value for all RCM assessments.

9. This is what an assessment response looks like.

------------------------------------------------------------------------
ExecuteTime=[1]
EndPointURL=[endpointURL]
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:createRcmAssessmentRequestResponse xmlns:ns6="http://alert.successfactors.com" xmlns:ns5="http://notification.event.successfactors.com" xmlns:ns7="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns2="http://www.boomi.com/connector/wss" xmlns:ns4="com.successfactors.alert" xmlns:ns3="com.successfactors.event.notification">
    <ns4:rcmAssessmentResponse>
        <ns4:assessmentUrl>assessmentURL</ns4:assessmentUrl>
        <ns4:entityId>1456</ns4:entityId>
        <ns4:receiptId>24257</ns4:receiptId>
        <ns4:status>2</ns4:status>
        <ns4:statusDate>2019-12-19T00:00:00-05:00</ns4:statusDate>
    </ns4:rcmAssessmentResponse>
</ns2:createRcmAssessmentRequestResponse>

Note: The endpointURL and assessmentURL will be shown as actually URLs in your payload.

10. Description of Assessment Order Response Elements seen in the Assessment response above.

a. assessmentUrl: The assessment url to be communicated to candidates. Mandatory field. 
b. entityId: The assessment order id for reference. Mandatory field. 
c. receiptId: Miscellaneous information.
d. status: Mandatory status value. The following enumeration identifies the meaning of each status value.

2 - INITIATED (Expected in the initial order acknowledgement)
1 - IN_PROGRESS (Expected during status updates)
0 - COMPLETED (Expected when an update for assessment completion is received)
99 - INITIATION_FAILED (Expected when something goes wrong in processing the assessment request from the vendor side)

e. statusDate: Date when the transaction is carried out in the standards for XML. Please send the date information in GMT timezone (converted to GMT) as SFAPI does not process any other timezones at present.

Keywords

Assessment, Assessment Integration, Third-party Vendor, Recruiting Management, RCM, Integration, API, Event Subscription, Configuration, How-to , KBA , LOD-SF-RCM-INT , Integrations & Intelligent Services , How To

Product

SAP SuccessFactors Recruiting all versions