Results of migrating a template to a TPRM SAE template

  • Release version: Xanadu
  • Updated July 31, 2025
  • 4 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Results of migrating a template to a TPRM SAE template

    This topic explains how ServiceNow customers can manage and verify the migration of classic assessment templates to Third-Party Risk Management (TPRM) Smart Assessment Engine (SAE) templates. It outlines the process for tracking migration progress, reviewing results, publishing migrated templates, and understanding the implications for related assessments and rules.

    Show full answer Show less

    Tracking and Viewing Migration Results

    After initiating migration, customers can monitor progress and confirm completion via the Assessment Setup under Classic Template Migration. Each migration is assigned a unique identifier (starting with ATSMIG) to track and search records. Key details include the source classic template, target TPRM SAE template, the migration purpose (aligned with TPRM template classifications), and migration status (e.g., In progress, Completed, Partially completed, Errored).

    Access to view migrated TPRM SAE questionnaires requires the TPR assessment reviewer role. Only published templates can be used for creating assessments, and published templates cannot be updated if active assessments exist.

    Post-Migration Workflow and Template Management

    • Migrated templates initially reside in Draft state and require review for accuracy and completeness.
    • Publishing the SAE questionnaire templates automatically links them to related assessment templates and issue generation rules.
    • For issue generation rules to function properly, at least one question must have the "Enable preferred response" option enabled.
    • Assessment templates and issue generation rules must be marked as Supports smart assessment to enable full functionality with SAE templates.
    • Setting the system property snvdrriskasmt.saeenabled switches default usage to SAE questionnaires and assessments marked as supporting smart assessment, enabling tier-based, provider-based, and event-driven management rules.

    Scoring Migration and Configuration

    The migration includes an automated business rule to transfer scoring configurations from classic templates to TPRM SAE templates to maintain consistency. However, if a new template is created, scoring must be manually enabled and configured.

    Migration Limitations and Requirements

    • Unsupported question types during migration include percentage, ranking, image scale, and custom metric. These must be converted before migration or recreated afterward.
    • Sections containing only unsupported questions result in empty sections which must be populated or removed prior to publishing, as empty sections prevent publishing.
    • Duration information for SAE questionnaire templates is not included in update sets and must be manually exported/imported between instances.
    • Assessments not updated to support SAE will prevent related management rules from functioning correctly.
    • Scoring migration only occurs if the template migration completes without errors.
    • Responses from prior assessments are not migrated.

    Practical Implications for ServiceNow Customers

    Customers migrating to TPRM SAE templates should carefully monitor migration status, review migrated templates in draft, and publish only when confirmed complete. They must verify that assessment templates and related rules are properly flagged to support smart assessments to ensure full functionality. Customers also need to manage unsupported question types proactively and handle manual export/import of duration data when moving templates between instances. Proper scoring configuration is critical to maintain assessment consistency post-migration.

    You can view the templates that were migrated to Smart Assessment format.

    Tracking template migration

    After you have started the migration process, you can view the progress and confirm if it was completed successfully. For more information on the migration process, see Migrate a template to an SAE template and Creating an assessment template from legacy assessment metric types.

    Viewing the migration results

    To view your migration results, navigate to All > Third-party Risk Management > Assessment Setup > Classic Template Migration. In the Assessment template migrations list, select the migration number. Each migration record for a metric type is assigned a unique number that starts with the text ATMIG. The form displays the values that were used to generate the template. The related lists display the status and content of the migrated data.

    The following table describes the fields in the Assessment template migration list.

    Table 1. Assessment template migration list
    Field Description
    Number Unique number that starts with the text ATSMIG in the migration record for the questionnaire. You can use the number to search for the record.
    Source metric type Classic template that migrated.
    Target assessment template Smart Assessment template that is migrated from the source template.
    Purpose
    Purpose for the migrated template.
    Note:
    Known as Template classifications in the Classic assessment engine, TPRM has a Purpose for each classic template classification.
    TPRM purpose options include:
    • TPRM external 3rd-party element questionnaire
    • TPRM external 4th-party questionnaire
    • TPRM external document request
    • TPRM external questionnaire
    • TPRM internal IRQ
    • TPRM internal tiering questionnaire
    To view a TPRM SAE questionnaire template you must have the TPR assessment reviewer role [sn_vdr_risk_asmt.vendor_assessment_reviewer].

    For more information on creating assessment template purposes, see Create an assessment template category.

    Note:
    You can create an assessment only from a published assessment template. You can update a published template only if no active assessment is associated with the template.
    Migration status Value that updates as the template migration process proceeds.
    • In progress: Status for after you start the migration process, the process is in progress until it finishes.
    • Completed: The migration is completed successfully.
    • Partially completed: Only some elements were successfully migrated.
    • Errored: An error occurred during the migration.
    Error details

    Description of an error that occurred during the unsuccessful migration.
    Created Date and time the migration job was created.

    Template migration results

    The following diagram shows the questionnaire to TPRM SAE template migration workflow.

    Figure 1. SAE migration workflow
    Questionnaire to SAE template migration workflow. For a text description, see the text that preceded and follows this diagram.
    1. Migrate templates either one by one or in bulk. After migration, all templates are in the Draft state.
    2. Review each migrated questionnaire template individually to confirm that they’re accurate and complete.
    3. Publish TPRM SAE questionnaire templates. After publishing, the following actions occur automatically:
      • TPRM SAE templates are associated with all related Assessment templates.
      • TPRM SAE templates are associated with all related Issue generation rules.
      Note:
      For Issue-generation rules to work as expected when applied to an TPRM SAE assessment template, at least one question must have the option, Enable preferred response, set to true.
    4. After all questionnaire templates related to an assessment template have been migrated and published, they should be marked as Supports smart assessment and ready for use.
    5. Review each assessment template to confirm it’s marked as Supports smart assessment. If an assessment template isn’t marked as Supports smart assessment, manually adding a new TPRM SAE questionnaire template to it updates its status.
    6. After a questionnaire template has been migrated and published, its related issue generation rule is automatically marked as Supports smart assessment and is ready for use.

    For more information, see Migrate a template to an SAE template, Create a TPRM SAE questionnaire or document request template, Create an external assessment template, and Create an issue generation rule.

    The following diagram shows the relationship between assessment templates and questionnaires after upgrading.

    Figure 2. Assessment templates post-upgrade
    Assessment template impact after upgrading. For a text description, see the text that preceded and follows this diagram.
    • Before setting the Smart Assessment Engine enabled (sn_vdr_risk_asmt.sae_enabled) property, the following are used by default.
      • Existing questionnaire templates
      • Existing assessments
    • After setting the Smart Assessment Engine enabled (sn_vdr_risk_asmt.sae_enabled) property, the following are used by default.
      • SAE questionnaire templates (New or migrated).
      • Assessments marked as Supports smart assessment.
      • Tier-based, Provider-based, and Event-driven management rules only work with assessments marked as Supports smart assessment.
    Note:
    Templates and questions must be reviewed to confirm they’re marked as Supports smart assessment. After the assessment templates and questions are marked as Supports smart assessment, issue-generation rules can be applied.

    Template migration scoring results

    The Migrate scores from classic template business rule automates the migration of scores from the Classic template to the TPRM SAE template, helping ensure consistent scoring configuration. If a new template is created, you must manually enable scoring, define the correct options, and set their scores. For more information, see Scoring assessments, Configure scoring for an assessment, and Normalization in assessment.

    Migration limitations

    The assessment migration process has the following limitations and requirements.

    • The following question types aren’t supported: percentage, ranking, image scale, and custom metric. You must either convert these question types to supported formats before migration or create new questions in the template designer after migration.
    • If a section in the classic template contains only unsupported questions, an empty section is created in the TPRM SAE template. TPRM SAE templates with empty sections can’t be published; therefore, you must either add replacement questions to these sections or delete the empty sections before publishing.
    • When transferring TPRM SAE questionnaire templates between instances, the update set won’t include the duration information. Users must export the duration information manually from the sn_smart_asmt_duration table and import it into the target instances.
    • If an assessment template isn’t updated to support SAE assessments, the related tier-based, provider-based, and event-driven management rules won’t run as expected.
    • The TPRM scoring migration proceeds only if there were no errors during the template migration. If there were errors, the TPRM scoring migration doesn’t occur.
    • Responses from previous assessments aren’t migrated.