{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":46565,"path":"servicenow-platform/assessment-metric-category-form.md","title":"Assessment Metric form for a category","bundle":null,"doc_type":null,"release":"australia","body":"\n# Assessment Metric form for a category\n\nDescription of the field values for the Assessment Metric form. Use the fields when you create an assessment metric for a category.\n\n\n
\n\nField\n\n\n\nDescription\n\n
\n\nName\n\n\n\nName of the metric.\n\n
\n\nCategory\n\n\n\nMetric category that the metric belongs to. The system automatically populates this category if you create a new metric from the Metric Category form. **Note:** You cannot change the category if the **Depends on** field is set or if another metric depends on this metric\n\n
\n\nMethod\n\n\n\nDetermines how to use the metric.\n\n- **Assessment** : Non-scripted metric. Make the metric available as a question on an assessment questionnaire. The **Assessment** method is compatible with all data types except **Duration**.\n- **Script**: Scripted metric. Obtain values by writing a custom script. The **Script** method is compatible with the **Duration**, **Number**, and **Percentage** data types.\n- **Default answer from field**: This option appears only if you have selected an **Assessment Metric Type** that contains a table. The **General** tab adds two fields:\n - **Default answer**: Select the default answer for the question. The list comes from the selected table.\n - **Ask question**: Specifies when to ask the question: always or only if the default answer is empty.\n- **Default answer from script**: The **General** tab adds a field:\n\n**Ask question**: Specifies when to ask the question: always or only if the script does not contain a default answer. The script is defined on the **Field Type** tab.\n\n\n **Note:** If you select a **Data type** that is incompatible with the selected **Method**, the system automatically changes the **Method** to the correct value.\n\n
\n\nWeight\n\n\n\nNumeric value that represents the importance of this metric relative to other metrics in the same category. By default, the weight is 10. For weighting suggestions, see [Weight Metrics and Metric Categories](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/c_AssessmentMetrics.md).\n\n This field is visible and required unless the **Data type** is **Date**, **Date/Time**, or **String**. These data types are not included in results calculations.\n\n
\n\nOrder\n\n\n\nNumeric value that determines the order of the metric question on assessment questionnaires, relative to other metric questions in the same category. The metric with the smallest order value appears as the first question in the category section. By default, the order is 100. For more information about questionnaire layout, see [Complete Assessment Questionnaires](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/c_AssessmentQuestionnaires.md). **Note:** It does not matter which order value you use for metrics with the Script method, as they do not appear on questionnaires.\n\n
\n\nActive\n\n\n\nCheck box that determines whether this metric is used to gather assessment results. If a non-scripted metric \\(Assessment method\\) is inactive, the question does not appear on assessment questionnaires generated after the metric becomes inactive. If a scripted metric \\(Script method\\) is inactive, the script does not run.\n\n
\n\nMandatory\n\n\n\nCheck box that makes the metric question mandatory \\(selected\\) or optional \\(cleared\\) on assessment questionnaires. Users cannot submit questionnaires until they provide valid responses to all mandatory questions, which display a red [field status indicator](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/c_AssessmentQuestionnaires.md).\n\n This field is visible only if the **Method** is **Assessment**, the **Depends on** field is empty, and the data type is not **Checkbox**.\n\n
\n\nAllow not applicable\n\n\n\nCheck box that determines whether to include a **Not Applicable** answer option for this metric question on assessment questionnaires. Users can select **Not Applicable** if they do not have sufficient information to respond to a question or if a question does not apply to a particular assessable record. User responses of **Not Applicable** are excluded from results calculations.\n\n This field is visible only if the **Method** is **Assessment** and certain data types are selected.\\[Omitted image \"AssessmentNotApplicableOption.png\"\\] Alt text: Assessments not applicable option\n\n
\n\nAdditional fields you can add by customizing the form\n\n
\n\nDetails\n\n\n\nText field containing an HTML editor. Use this field to present important details about this metric to assessment recipients. Details can include formatted lists, images, videos, or links to external websites. \\[Omitted image \"AssessmentMetricDetails.png\"\\] Alt text: Assessment metric details\n\n
\n\nGeneral Section\n\n
\n\nQuestion\n\n\n\nText to use as the question on assessment questionnaires. Enter a clear, straightforward question that is easy to answer, such as **How likely are you to recommend this vendor for the purchase of office supplies?** \\[Omitted image \"AssessmentQuestionField.png\"\\] Alt text: Assessment question field\n\n
\n\nDescription\n\n\n\nInformation about the metric and what it evaluates. If the **Method** is **Assessment**, include details that help users understand how to answer the question. This text appears as a hint when a user points to the question text on the questionnaire.\\[Omitted image \"AssessmentDescriptionFieldTooltip.png\"\\] Alt text: Assessment description field tooltip\n\n
\n\nDepends on\n\n\n\nSetting used to make this metric a conditional question. Select an existing metric question from the list, which displays **Checkbox**, **Choice**, **Likert Scale**, **Template**, and **Yes/No** metrics of the same category as this metric. Then, use the **Displayed when** field to set the conditions that display this metric question on questionnaires. The system prevents the creation of recursive dependencies between metrics. For example, if Metric A depends on Metric B, Metric B cannot depend on Metric A.\n\n This field is visible only if the Method is Assessment.\n\n
\n\nDisplayed when\n\n\n\nAnswer options for the selected **Depends on** metric question that, when chosen on questionnaires, display this metric question.\n\n This field is visible and required only if the **Depends on** field is set.\n\n
\n\nField Type Section\n\n
\n\nData type\n\n\n\n\\[Required\\] Format of the expected response data. The function of the data type depends on the selected **Method**. If the method is **Assessment**, the data type determines how users answer the corresponding question on questionnaires. If the method is **Script**, the data type determines how the system calculates assessment results.**Note:** If another metric depends on this metric, you cannot change the data type.\n\n
\n\nRandomize answers\n\n\n\nCheck box that determines whether to present the answer options for this metric question in a random order. The order of answer options can influence users, which creates biased results. Randomizing answer options can help prevent this bias.\n\n This field is visible only if a data type that requires metric definitions is selected.\n\n **Note:** Randomizing answer options for certain questions can make those questions confusing for the person answering. In general, only randomize answer options that do not follow a logical order. For example, the following question is confusing when randomization is enabled:\n\n \\[Omitted image \"AssessmentQuestionRandomOrder.png\"\\] Alt text: Assessment question random order\n\n
\n\nTemplate\n\n\n\nMetric template to use for the metric question. A metric template is a set of predefined answer options.\n\n This field is visible and required only if the **Data type** is **Template**.\n\n**Note:** If another metric depends on this metric, you cannot change the template.\n\n
\n\nDependent plugin\n\n\n\nPlugin that contains the tables queried in the script. The system executes the metric script only if the plugin is active. The default available values are **Asset Management**, **CMDB**, **Core**, **Cost Management**, **Procurement**, and **Software Asset Management**. If the **Method** is **Script**, select a plugin.\n\n This field is visible only if the **Method** is **Script**.\n\n **Note:** An administrator may need to add more [Define an option for a choice list](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-administration/t_ViewChoiceListDefinitions.md) of plugins to the field.\n\n
\n\nScale definition\n\n\n\nSetting that determines whether lesser or greater numerical values equate to a good score in assessment result calculations. Select **Low** if lesser numerical values are better, such as for a metric that measures the number of incidents for a vendor. Select **High** if greater numerical values are better, such as for a metric that measures user satisfaction on a scale of one to five. The default value is **High**.\n\n This field is visible and required unless the **Data type** is **Date**, **Date/Time**, or **String**. The results for these data types are not included in results calculations.\n\n **Note:** For information about how to set the scale definition for data types that do not require you to set a numerical value, see [Data Types](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/r_DataTypes.md).\n\n
\n\nMin\n\n\n\nLowest numerical value to be used as an answer option on assessments or as a scaled value in a scripted metric.\n\n This field is visible and required only if certain data types are selected. If the data type is **Choice** or **Likert Scale**, this field is read-only and is set automatically based on the smallest metric definition **Value**.\n\n
\n\nMax\n\n\n\nHighest numerical value to be used as an answer option or scaled value.\n\n This field is visible and required only if certain data types are selected. If the data type is **Choice** or **Likert Scale**, this field is read-only and is set automatically based on the largest metric definition **Value**.\n\n
\n\nScript\n\n\n\nScript that obtains the desired system information. This field is visible and required only if the **Method** is **Script**.\n\n**Note:** Script can now only be edited by Assessment Admins. Survey Creators no longer have the ability to edit the script.\n\n
\n\nRelated List\n\n
\n\nAssessment Metric Definitions\n\n\n\nLists all metric definitions, which appear as answer options for questions on assessment questionnaires. Click **New** to create a new metric definition.\n\n This related list is available only if the Data type is **Choice** or **Likert Scale**.\n\n
**Parent Topic:**[Assessments reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/assessment-reference.md)\n\n**Related topics** \n\n\n[Create an assessment metric for a category](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/t_CreateAMetric.md)\n\n"}}