diff --git a/images/sapsuccessfactors/assessment/sapsuccessfactors_JR_sent_assess_on_application_45.png b/images/sapsuccessfactors/assessment/sapsuccessfactors_JR_sent_assess_on_application_45.png new file mode 100644 index 00000000..477019fd Binary files /dev/null and b/images/sapsuccessfactors/assessment/sapsuccessfactors_JR_sent_assess_on_application_45.png differ diff --git a/images/sapsuccessfactors/assessment/sapsuccessfactors_updated_results_on_SAP_UI_46.png b/images/sapsuccessfactors/assessment/sapsuccessfactors_updated_results_on_SAP_UI_46.png new file mode 100644 index 00000000..04a64784 Binary files /dev/null and b/images/sapsuccessfactors/assessment/sapsuccessfactors_updated_results_on_SAP_UI_46.png differ diff --git a/integration-configuration-concepts/ats/sapsuccessfactors-assessment.mdx b/integration-configuration-concepts/ats/sapsuccessfactors-assessment.mdx index 01e49285..c6067995 100644 --- a/integration-configuration-concepts/ats/sapsuccessfactors-assessment.mdx +++ b/integration-configuration-concepts/ats/sapsuccessfactors-assessment.mdx @@ -5,238 +5,8 @@ description: "To send webhook notifications successfully from SAP SuccessFactors import IntegrationFooter from "/snippets/integration-footer.mdx"; - - This guidance is intended for users who have administrative privileges for their SAP SuccessFactors account. - - -## Grant permissions to begin assessments with third-party vendors - - - - In the Provisioning Account, you can create an Integration User and assign the necessary permissions to facilitate effective collaboration with third-party vendor assessments and SAP SuccessFactors. - - - - - SFAPI Retrieve Assessment Order Permission - - SFAPI Update Assessment Report Permission - - - - - Make sure to provide recruiting users with the Manage Assessment Vendors permission. - - In _Provisioning > Company Settings_, enable the following options: - - Enable Assessment Integration - - SFAPI - - Enable SFAPI Web Services - - Grant the following permissions to the SFAPI integration user: - - Access to Event Notification Subscription - - Retrieve Assessment Order - - Update Assessment Report (please note that this permission is listed twice, ensure it is granted only once) - - Enable Assessment Integration (which requires Candidate Workbench) from the Provisioning Account. - - - - - - - -## Set the API login exceptions - - - - Navigate to _Admin Tools > Password & Login Policy Settings > Set API Login Exceptions > Add_ the following information: - - - **Username:** Select the SFAPI integration user. - - **Maximum Password Age (days):** Set this option to -1. - - **IP Address Restrictions:** Specify the designated IP addresses or address range for use with the integration. - - - - - -## Add your vendor and upload the assessment vendor packages - - - - Go to _Manage Assessment Vendors_, Click "Export" to download the CSV file. Add your vendor with a unique `clientId` and mark it as active by entering `Y` in the active column. - - Add a Vendor - - - Please select a updated file to import the Assessment Vendor List into SAP SuccessFactors. - - Upload a file of vendor - - - - - You can upload Assessment Vendor Packages from _Provisioning > Managing Recruiting > Import/Export Assessment Vendor Packages_. Prepare a CSV file with the required columns and values, as illustrated in the image. - - - **vendorId:** Identifies the assessment vendor (`vendorId` has to be the same as `clientId`) - - **packageCode:** Identifies an assessment package to use for the order. - - **shortName:** Shortened name of the package for use on the candidate summary page. - - **Label:** Language in which the assessment is displayed - - - Import/Export Assessment Vendor Packages - - - Choose file to import the Assessment Vendor List in SAP SF. - - - - -## Create a subscriber and set up an external event - - - - Go to the _Event Notification Subscription_ page. Under the _Subscriber_ tab, add a subscriber using your `Subscriber Id` and `Client Id`. Note that your `clientId` should match the one uploaded with your vendor's name in the previous step. - - Create a Subscriber - - - - - Navigate to the _External Event_ tab and click the `+ Add New` button to create a new external event. - - Add New external event - - - Select the values for the specified field: - - **Event Type:** Select `rcm_assessment_alert_v2` - - **Subscriber:** Select the subscriber you created in the previous step. - - **Protocol:** Select `SOAP_OVER_HTTP_HTTPS` - - **Endpoint URL:** Enter the endpoint URL provided by StackOne, which will be used to receive assessment order requests. - - **Authentication:** Select `NO` - - - The Endpoint URL must contain the query parameter `externalTriggerToken`, which you will receive from the StackOne Connection Hub. This token verifies requests from SAP SF for the specific vendor. - - - - Setup external event - - - To save the configuration for the External Event, click the `Save` button. - - - - -## Manage fields for the Job Requisition template - - - - Navigate to _Admin Center_ and search for _Manage Templates_ - - Navigate to Job Requisition template - - - Navigate to the _Recruiting Management_ tab, select _Job Requisition_, and choose the template that is in use for the specific job requisition, such as `Standard Job Requisition`. - - Go to the _Recruiting_ and select any specific job requisition. - - Specific Job Requistion - - - Click on the `i` icon to view the Job Requisition Template. - - JR Info - - - - - Standard Job Requisition - - - - - Please add the following field that will be visible within the Job Requisition and allow you to select an assessment. - - - **assessment:** This field enables the recruiter to select a specific assessment to associate with the job requisition. - - - - This approach will only be used if you have permission to upload the Job Requisition template via an XML file; otherwise, you can manually add the fields and click the `Publish` button. - - - ```XML - - - - - - - - - - - ``` - - - - Add a field from JR field template - - - - - - -## Manage the permissions for the assessment feature - - - - To add or update feature permissions, navigate to the specific Job Requisition Template > Application Status Configuration, select Feature Permissions Defined, and then click on `Add Feature Permission` from the modal. - - - **Feature Permission Description:** [Operators with below roles can see Assessment detail report for the applicant when the application is in Phone Screen Status] - - **Feature Permission Type:** Select `assessmentIntegration` - - **Feature Permission Role Name:** Select `All` - - **Feature Permission Status:** Select the talent pipeline stage from dropdown on which you want to initiate the assessment. - - - You can add multiple feature permissions for `assessmentIntegration` for the specific talent pipeline stage. - - - - - This approach will only be used if you have permission to upload the Job Requisition template via an XML file; otherwise, you can manually add the permissions and click the `Publish` button. - - - ```XML - - <\!\[CDATA\[Operators with below roles can see Assessment detail report for the applicant when the application is in Scheduled Status\]\]> - <\!\[CDATA\[S\]\]> - <\!\[CDATA\[T\]\]> - <\!\[CDATA\[O\]\]> - <\!\[CDATA\[R\]\]> - <\!\[CDATA\[G\]\]> - <\!\[CDATA\[Scheduled\]\]> // You can choose any stage from the options provided; for this document, we have selected "Scheduled." - - - <\!\[CDATA\[Operators with below roles can see Assessment detail report for the applicant when the application is in New Application Status \]\]> - <\!\[CDATA\[S\]\]> - <\!\[CDATA\[T\]\]> - <\!\[CDATA\[O\]\]> - <\!\[CDATA\[R\]\]> - <\!\[CDATA\[G\]\]> - <\!\[CDATA\[Default\]\]> - - ``` - - - After adding the feature permissions, click on `Publish` to save your changes. - - Add feature permission from the JR template - - - - When an assessment is configured in `Default` or `New Applicant`, the assessment is triggered when the candidate applies for the job. Immediately after applying and passing the prescreening questions, the candidate will be redirected to an assessment vendor site. After completing the assessment, the candidate will be redirected back to the career site. - - - - - - -## Edit Job Requisition to select Assessment +## Associate assessment to the job requisition @@ -247,29 +17,13 @@ import IntegrationFooter from "/snippets/integration-footer.mdx"; Click on the link labeled as `Add More Assessments` to add an assessment association row where you can select below details - add a row of fields + Go to Actions menu - - **Status:** Select `Stage` where you have setup the assessment integration feature, as described in the prior step. - - **Vendor:** Select your vendor. + - **Status:** Select the stage at which the vendor established the assessment integration feature. + - **Vendor:** Select the vendor. - **Assessment:** Select the assessment package that the recruiter wants to send to the candidate. - **Email Template:** Select the email template that will be sent to the candidate once the assessment is triggered. - - - Navigate to _Admin Center_ and search for `OData API Metadata Refresh and Export` - - OData API Metadata Refresh and Export - - - Click on the `Refresh` button next to Cache. - - Refresh button - - - - - Go to Actions menu - @@ -293,18 +47,11 @@ import IntegrationFooter from "/snippets/integration-footer.mdx"; Assessment will be automatically triggered when a candidate moves successfully. You will see an 'Initiated' message in the Assessment portlet for that candidate's application. - Apply Updates + Job Requisition Fields If you see an 'Initiation Failed' message, you can re-trigger the assessment from the Take Action menu - - - The assessment request will be displayed in the candidate's application within the Assessment portlet - - Assessment Request portlet - - ## To check the results of the assessment @@ -313,7 +60,7 @@ import IntegrationFooter from "/snippets/integration-footer.mdx"; Navigate to the stage where the assessment was triggered. The results will be available in the Assessment portlet within the candidate's application. - Check Result of the Assessment + Job Requisition Fields