Skip to main content

How to Update the Job Requisition and Application Templates

Shanie Grancioso avatar
Written by Shanie Grancioso
Updated over a week ago

1. Add the following fields to the Job Application Template:

Note: Ensure these updates are made to all templates where the assessment integration will be used.

Sample code:

<field-definition id="sapiaScore" type="number" required="false" custom="true" public="false" readOnly="false" anonymize="false" forward-intact="true" sensitive="false">

<field-label mime-type="text-plain"><![CDATA[Sapia Chat Score]]></field-label>

<field-description><![CDATA[Sapia Chat Score]]></field-description>

</field-definition>

<field-definition id="sapiaRecommendation" type="text" required="false" custom="true" public="false" readOnly="false" anonymize="false" forward-intact="true" sensitive="false">

<field-label mime-type="text-plain"><![CDATA[Sapia Recommendation]]></field-label>

<field-description><![CDATA[Sapia Chat Recommendation]]></field-description>

</field-definition>

<field-definition id="sapiaVideoScore" type="number" required="false" custom="true" public="false" readOnly="false" anonymize="false" forward-intact="true" sensitive="false">

<field-label mime-type="text-plain"><![CDATA[Sapia Video Score]]></field-label>

<field-description><![CDATA[Sapia Video Score]]></field-description>

</field-definition>

  • Make the new custom fields reportable by navigating to:
    ​Provisioning > Configure Reportable Custom Fields > Application tab

    • Add the following fields:

      • sapiaScore

      • sapiaRecommendation

      • sapiaVideoScore

    • Click Save Extended Field Mapping

  • In Admin Center, run a Metadata Refresh.

2. Add the following field to the Job Requisition Template:

Sample code:

<field-definition id="assessment" type="derived" required="true" custom="false">

<field-label><![CDATA[Assessment]]></field-label>

<field-description><![CDATA[Assessment]]></field-description>

</field-definition>

  • Permission the assessment field on the Job Requisition XML.

  • Add any required operators and statuses as needed.

Note: If you are using a multi-stage application, you will need to update the permissions in the Job Requisition Template. Ensure these updates are made to all templates where assessment integration will be used.

Sample code:

<field-permission type="write">

<description><![CDATA[job code permissions]]></description>

<role-name><![CDATA[R]]></role-name>

<status><![CDATA[pre-approved]]></status>

<field refid="assessment"/>

</field-permission>

  • In the Job Requisition Template, add the Assessment Integration Feature for each status where the integration will be used and onwards.

Note: This permission allows users with access to view the assessment portlet for a candidate on the job application.

Example: The configuration below allows five users to access the portlet in two statuses.

Sample code:

<feature-permission type="assessmentIntegration">

<description><![CDATA[Operators with below roles can see Assessment detail report for the applicant when the application is in Assessment Status]]></description>

<role-name><![CDATA[S]]></role-name>

<role-name><![CDATA[T]]></role-name>

<role-name><![CDATA[O]]></role-name>

<role-name><![CDATA[R]]></role-name>

<role-name><![CDATA[G]]></role-name>

<status><![CDATA[Assessment]]></status>

</feature-permission>

<feature-permission type="assessmentIntegration">

<description><![CDATA[Operators with below roles can see Assessment detail report for the applicant when the application is in Offer Status ]]></description>

<role-name><![CDATA[S]]></role-name>

<role-name><![CDATA[T]]></role-name>

<role-name><![CDATA[O]]></role-name>

<role-name><![CDATA[R]]></role-name>

<role-name><![CDATA[G]]></role-name>

<status><![CDATA[Offer]]></status>

</feature-permission>

3. On the Application Template:

  • In the candidate-summary-display-options-config section, add an additional section that includes the following fields:

    • sapiaScore

    • sapiaRecommendation

    • sapiaVideoScore

Note:

  • This must be done for each template where the assessment is used.

Sample code:

<candidate-summary-display-options-config>

<category id="ScreeningData" name="ScreeningData">

<label xml:lang="en_GB"><![CDATA[Candidate Shortlisting Data]]></label>

<column field-ref="sapiaScore" select-by-default="false" gridOrder="7"></column>

<column field-ref="sapiaRecommendation" select-by-default="false" gridOrder="8"></column>

<column field-ref="sapiaVideoScore" select-by-default="false" gridOrder="9"></column>

</category>

</candidate-summary-display-options-config>

Did this answer your question?