Assessment Metadata

Some assessments need some extra information before they are configured correctly. This is managed via the metadata attribute on the position assessment resource.

Cognify Packages

The Cognify assessment consists of several individual games or puzzles that measure up to 4 unique constructs: problem solving, numerical reasoning, processing speed and verbal knowledge. These constructs need to be added to Cognify as assessment packages. Two of the four packages will be mandatory (problem solving and numerical reasoning) and the other two packages (for processing speed and verbal knowledge) are optional.

Available packages can be obtained from the Assessment Packages endpoint and must be provided as metadata when creating or updating the position assessment.

GET https://{BASE_URL}/assessments/{CognifyAssessmentId}/packages

Example

An example of creating a Cognify assessment with multiple packages

POST https://{BASE_URL}/positions/{PositionId}/assessments
{
  "organizationAssessment": "{CognifyAssessmentId}",
  "metadata" : {
    "packages": [ "{Package1Id}", "{Package2Id}", "{Package3Id}" ]
  }
}

Mandatory vs Optional Packages

Available packages, as retrieved from Assessment Packages endpoint, will be marked as mandatory or optional. Mandatory packages must be supplied when configuring the position assessment whilst optional packages need not be supplied if not desired.

Revelian recommends all available packages (i.e. both mandatory and optional) are supplied when adding a Cognify assessment to a position.

Profiles

The Revelian Values Inventory (RVI) and Revelian Work Preferences Profile (RWPP) are both what we call ‘double sided’ assessments. When candidates complete the assessment, their responses are compared against a profile, and the degree of match or congruence with that profile is calculated.

In terms of the Values Inventory, this is a ranked set of 20 values that represent the organisation’s values, which the candidate’s values are then compared with.

In terms of the Work Preferences Profile, this is the result of a questionnaire about the type of work tasks required by a role, which the candidate’s work preferences are then compared with.

A profile can be attached to a position in one of two ways:

  1. Supervisor profile

    In this instance, the supervisor for a position is invited to complete a profile for the position. After the assessment (RWPP or RVI) is added to the position (and the assessment instance resource is retrieved), the profileUrl attribute is available in the assessment metadata. This can be provided to the relevant supervisor so they can complete the profile.

    Example

    An example of creating a RWPP or RVI assessment without a profile id

    POST https://{BASE_URL}/positions/{PositionId}/assessments
    {
      "organizationAssessment": "{AssessmentId}"
    }
    

    Subsequent fetch of the resource will contain profileUrl to provide to supervisor

    GET https://{BASE_URL}/positions/{PositionId}/assessments/{PositionAssessmentId}
    {
      "organizationAssessment": "{AssessmentId}",
      "metadata": {
        "profileUrl": "{ProfileUrl}",
        "profileStatus": "SUPERVISOR_TO_COMPLETE"
      }
    }
    

    Once the supervisor has completed the profile a fetch of the resource will have a profileStatus indicating that the profile has been completed

    GET https://{BASE_URL}/positions/{PositionId}/assessments/{PositionAssessmentId}
    {
      "organizationAssessment": "{AssessmentId}",
      "metadata": {
        "profileUrl": "{ProfileUrl}",
        "profileStatus": "SUPERVISOR_COMPLETED"
      }
    }
    

    Providing the profile URL to the supervisor is not handled by the Revelian API and needs to be performed outside of this process.

  2. An existing profile is ‘attached’ to the position

    In this instance, a previously created profile is added to the position by adding its ID. The profile ID can be obtained from the Assessment Profiles endpoint.

    Example

    An example of creating a RWPP or RVI assessment with an existing profile ID

    POST https://{BASE_URL}/positions/{PositionId}/assessments
    {
      "organizationAssessment": "{AssessmentId}",
      "metadata": {
        "profile": "{ProfileId}"
      }
    }
    

    Subsequent fetch of the resource will have a profileStatus indicating that the profile was attached

    GET https://{BASE_URL}/positions/{PositionId}/assessments/{PositionAssessmentId}
    {
      "organizationAssessment": "{AssessmentId}",
      "metadata": {
        "profileUrl": "{ProfileUrl}",
        "profileStatus": "PROFILE_ATTACHED"
      }
    }
    

    A supervisor can choose to update the profile at any stage, by accessing the profileUrl. If this occurs for an assessment that already has an existing profile attached, the profile property will no longer be present and the profileStatus will be altered from PROFILE_ATTACHED to SUPERVISOR_COMPLETED upon a fetch of the resource.

Benchmarks

Our assessments can be configured with client specific Benchmarks.

Available benchmarks can be obtained from the Assessment Benchmarks endpoint and must be provided as metadata when creating or updating the position assessment.

Benchmarks are applicable for the following assessments: Cognitive Ability Test (RCAT), Cognify, Emotify, Work Safety Assessment (RWSS, RWSL), Work Reliability Scale (RWRS), Abstract Reasoning Test (RART), Numerical Reasoning Test (RNRT) and Verbal Reasoning Test (RVRT)

Example

An example of adding an assessment with a benchmark

POST https://{BASE_URL}/positions/{PositionId}/assessments
{
  "organizationAssessment": "{AssessmentId}",
  "metadata" : {
    "benchmark": "{BenchmarkId}"
  }
}

Locales

Available benchmarks, as retrieved from the Assessment Benchmarks endpoint, will have a locale attached to them. Benchmarks can only be used in a position that match the locale.

Skills Tests

Our Skills assessments require one or more tests to be configured for the assessment.

Available skills test can be obtained from the Assessment Skills Tests endpoint and must be provided as metadata when creating or updating the position assessment.

Example

An example of creating a skills test assessment with multiple tests

POST https://{BASE_URL}/positions/{PositionId}/assessments
{
  "organizationAssessment": "{SkillsTestAssessmentId}",
  "metadata" : {
    "tests": [ "{SkillsTest1Id}", "{SkillsTest2Id}", "{SkillsTest3Id}" ]
  }
}

By default only ‘active’ (or enabled) skills tests will be returned in the list of skills tests

Enabling/Disabling

Individual skills test may be enabled or disabled for your organization. As noted above, only active skills tests will be returned by the Assessment Skills endpoint by default.

Find currently inactive skills tests

To obtain currently ‘inactive’ skills tests the active query parameter with a value of ‘false’ can be submitted.

GET https://{BASE_URL}/assessments/{SkillsAssessmentId}/skills?active=false

Enable an inactive skills test

To enable a currently ‘inactive’ skills test an update (PUT) of assessment skills resource can be submitted with the active property set to true.

PUT https://{BASE_URL}/assessments/{SkillsAssessmentId}/skills/{SkillsTestId}
{
  "id": "{SkillsTestId}",
  "title": "{Title}",
  "description": "{Descrption}",
  "category": "{Category}",
  "timeToComplete": "{TimeToComplete}",
  "numberOfQuestions": {NumberOfQuestions},
  "active": true,
  "_links": [ ... ]
}

Only the active property is valid to alter. If any other property is changed the request will be rejected.