How legacy metric types are migrated to sections in templates

  • Release version: Yokohama
  • Updated January 30, 2025
  • 3 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 How legacy metric types are migrated to sections in templates

    This document explains the process and mappings used to migrate legacy metric types to sections within assessment templates in the Smart Assessment Engine application, starting with the Yokohama release. It provides a detailed mapping of legacy metric components to new assessment template structures, ensuring ServiceNow customers can understand how existing data transitions into the updated Smart Assessment Engine format.

    Show full answer Show less

    Metric Type and Category Mappings

    • Metric Types: Legacy metric types such as Name, Description, and Table fields are migrated to corresponding fields within the Assessment Template and Context Item tables.
    • Metric Categories: These are migrated to the Section table in assessment templates, mapping fields like Name, Description, and Order to their equivalent fields in the Section table.

    Metric and Question Mappings

    • Legacy metrics map to the Question table with attributes such as Enable justification (Allow additional information), question labels, guidance statements, mandatory flags, min/max values, and order preserved.
    • After migration, all questions are set to data type Text by default, with numeric-scale metrics assigned a Horizontal response layout.
    • Metric types are mapped to specific question types, for example:
      • Attachment → Attachment
      • Choice → Drop-down list
      • Date → Date/Time
      • Likert scale → Radio button
      • Multiple selection → Check box
      • Numeric scale → Radio button
      • Reference → Reference
      • Yes/No → Radio button
    • Additional legacy fields such as Reference table and Condition filter are mapped into the Question table to maintain filtering and referencing capabilities.

    Metric Definitions and Template Mappings

    • Metric definitions are migrated to the Choice table, preserving display text labels and order sequences based on the original template definitions.
    • Only assessment metric templates with the Allow image field set to false are migrated; no field mapping occurs for the template table itself.
    • Metrics with a data type of template are migrated as Radio button questions if their Allow image field is false at the template level.
    • Assessment template definitions are also migrated to the Choice table, maintaining display text and ordering consistent with the original template-definition records.

    Practical Impact for ServiceNow Customers

    Understanding these mappings helps ServiceNow customers anticipate how their existing legacy assessment data will be transformed within the Smart Assessment Engine's updated template structure. This ensures continuity and preserves assessment integrity post-migration, allowing for accurate reporting and assessment management using the new framework.

    Legacy metric types are migrated to specific sections in the assessment templates in the Smart Assessment Engine application.

    How metric types are mapped

    This tables shows the mapping used to move the existing metric types to the section in the assessment templates.

    Table 1. Metric types for assessment type
    Existing metric type Mapped to
    Name (Translated text) (Max length 255) Name (Translated text) field in the Assessment Template table.
    Description (Translated text) (Max length 1000) Description (Translated html) field in the Assessment Template table.
    Table (Table Name) Table (Table Name) field in the Context Item table.

    How metric categories are mapped

    This tables shows the mapping used to move the existing metric categories to the section table in the assessment templates.

    Table 2. Metric categories are mapped to the Section table
    Existing metric type Mapped to the Section table
    Name (Translated text) (Max length 255) Name (Translated text) field.
    Description (Translated text) (Max length 1000) Description (Translated text) field.
    Order (Integer) Order (Order Index) field.

    How metrics are mapped

    This tables shows the mapping used to move the existing metrics to the question table in the assessment templates.

    Table 3. Metrics are mapped to the Question table
    Existing metric type Mapped to the Question table
    Allow additional information (True/False) Enable justification (True/False) field.
    Data type (String) (Max length 40) Based on the Data type field value, the appropriate question type reference is added to the Question table. Data type is string.
    Details (Translated html) (Max length 8000) Guidance statement (Translated html) field.
    Question (Translated text) (Max length 512) Label (Translated text) field.
    Mandatory (True/False) Is mandatory (True/False) field
    Max (Integer) Max number (Decimal) field
    Min (Integer) Minimum number (Decimal) field
    Order (Integer) Order (Order index)

    How metric types are migrated to question types

    After migration, all Question records are set as data type Text.

    After migration, all Question records whose source metric is template/Numeric-scale are set with a response layout of Horizontal.

    This tables shows the mapping used to move the existing metric types to the question types in the assessment templates.

    Table 4. Metric type mappings
    Existing metric type Mapped to
    Attachment Attachment
    Choice Drop-down list
    Date Date
    Date/Time Date/Time
    Likert scale Radio button
    Multiple selection Check box
    Numeric scale Radio button
    Reference Reference
    Yes/No Radio button

    How fields are mapped

    This tables shows the mapping used to move the existing fields to the question table in the assessment templates.

    Table 5. Fields are mapped to the Question table
    Field in the existing table Mapped to the Question table
    Reference table Table field.
    Condition Filter condition field.

    How metric definitions are mapped

    This tables shows the mapping used to move the existing metric definitions to the choice table in the assessment templates.

    Table 6. Metric definitions are mapped to the Choice table
    Metric definition in the existing table Mapped to the Choice table
    Display Text label field in the Choice table
    Order Integer data type is mapped to the Order field in the Choice table that is based on the same ascending sequence of the template-definition records in the Value field that is associated with a particular template.

    How assessment metric templates are mapped

    Only templates where the Allow image field is set to false are migrated. No field mapping is done for this table.

    Metrics whose data type is template are migrated as questions of the type Radio button if the Allow image field is set to false at the template level.

    How assessment template definitions are mapped

    This tables shows the mapping used to move the existing template definitions to the choice table in the assessment templates.

    Table 7. Assessment template definitions are mapped to the Choice table
    Assessment template definition in the existing table Mapped to the Choice table
    Display Text label field.
    Value Integer data type is mapped to the Order field in the Choice table, based on the same ascending sequence of the template-definition records in the Value field that is associated with a particular template.