Results of migrating a metric category to an assessment template

  • Release version: Yokohama
  • Updated January 30, 2025
  • 2 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 metric category to an assessment template

    This guide explains how ServiceNow customers can track and review the results after migrating legacy metric categories into Smart Assessment Engine assessment templates. It details where to find migration data and how to interpret the status and content of migrated records within the system.

    Show full answer Show less

    Tracking and Viewing Migration Progress

    After initiating migration via the Assessment template migration form, customers can monitor progress and verify completion or errors by navigating to:

    • All > Smart Assessment Engine > Administration > Template Migrations

    Each migration is assigned a unique identifier starting with ATMIG. Selecting a migration record displays the original values used, along with related lists that show the migration status and migrated content details.

    Understanding Migration Results

    The migration process breaks down into sections, questions, and response options, each tracked in distinct related lists with specific fields:

    Section Migrations

    • Number: Unique ID starting with ATSMIG, searchable for the section migration record.
    • Source metric category: The original metric category converted into a section.
    • Target section: The section created in the assessment template.
    • Migration status: Indicates if migration is Completed or Errored.
    • Error details: Describes issues if migration failed.

    Expanding a section record reveals the list of migrated questions.

    Question Migrations

    • Number: Unique ID starting with ATQMIG for each question migration record.
    • Source metric: The legacy metric converted from the question.
    • Target question: The question created in the new template.
    • Migration status: Can be Completed, Not supported (if the metric is unsupported), or Errored.
    • Error details: Explanation of migration errors if any.

    Users can expand the question record to view migrated response options.

    Response Option Migrations

    • Number: Unique ID starting with ATROMIG for each response option record.
    • Source metric definition: Original response option data migrated.
    • Source template definition: Automatically filled if the source metric data type is a template.
    • Target response option: The response option created after migration.
    • Migration status: Indicates Completed or Errored.
    • Error details: Details any migration errors.

    Practical Benefits for ServiceNow Customers

    This migration tracking and detailed results review enable customers to:

    • Verify the successful transformation of legacy metric categories into assessment templates.
    • Identify and troubleshoot any migration errors at the section, question, or response option level.
    • Maintain data integrity and consistency during the transition to the Smart Assessment Engine.

    By understanding these migration results, customers can confidently manage assessment template upgrades and ensure seamless adoption of new template structures.

    You can view the data that was migrated from the metric type to the Smart Assessment Engine assessment template in the related lists on the Assessment template migration form.

    Tracking assessment template migration

    After you have filled out the Assessment template migration form and started the migration process, you can view the progress and confirm if it completed successfully or if there were any errors. For more information on the migration process, see Creating an assessment template from legacy assessment metric types, Migrate a legacy metric type to an assessment template, and How legacy metric types are migrated to sections in templates.

    Viewing the migration results

    To view your migration results, navigate to All > Smart Assessment Engine > Administration > Template Migrations. 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 Section migrations table provides a description of the fields in the related lists.

    Results of the migration

    The following table describes the fields in the Section migrations related list.

    Table 1. Section migrations related list
    Field Description
    Number Unique number that starts with the text ATSMIG in the migration record for the section. You can use the number to search for the record.
    Source metric category Metric category that is created from the section after the metric types are migrated.
    Target section Section that was populated during the migration.
    Migration status Migration status:
    • Completed: The migration is completed successfully.
    • Errored: An error occurred during the migration.
    Error details

    Description of an error that occurred during the unsuccessful migration.
    Select the down arrow for a section to view the list of questions in the section. The following table describes the fields in the Question migrations related list.
    Table 2. Question migrations related list
    Field Description
    Number

    Unique number, starting with the text ATQMIG, that the system assigned to the migration record for the question. You can use the number to search for the record.
    Source metric Metric that is created from a question after the assessment template migration.
    Target question

    Question that was created after the migration.
    Migration status Migration status:
    • Completed: The migration is completed successfully.
    • Not supported: The metric in the original metric type isn’t supported for the migration.
    • Errored: An error occurred during the migration.
    Error details

    Description of an error that occurred during the unsuccessful migration.
    Select the down arrow for a question to view the list of response options for the question. The following table describes the fields in the Response option migrations related list.
    Table 3. Response option migrations related list
    Field Description
    Response option migrations
    Number

    Unique number, starting with the text ATROMIG, that the system assigned to the migration record for the response option. You can use the number to search for the record.
    Source metric definition Metric definition from the options that are migrated for a question.
    Source template definition Field referenced for the template definition from the response options that are automatically filled in if the data type of the source metric is a template.
    Target response option Field that shows the response option that was created after migrating the source.
    Migration status Migration status:
    • Completed: The migration is completed successfully.
    • Errored: An error occurred during the migration.
    Error details

    Description of an error that occurred during the unsuccessful migration.