| \n\nField\n\n | \n\nDescription\n\n |
|---|---|
| \n\nName\n\n | \n\nName of the metric \\(question or script\\). If the metric is a scripted data collection, this name appears on the post incident report.\n\n |
| \n\nCategory\n\n | \n\nThe 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 can’t 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\nIndicates the type of metric, as follows:\n\n- **Assessment**: A question that has no default value. There are several data types that can be defined in the **Data Type** field on the **Field Type** tab, such as check boxes, choice lists, text input.\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**: A question where the default response comes from a selected field in the security incident. Selecting this option adds two fields to the **General** tab:\n - **Default answer**: Select the field in the security incident that contains the default answer for the question. For example, for the question: \"Who initially reported this incident?\", the **Requested by** field would be a likely choice.\n - **Ask question**: Specifies when to ask the question: always or only if the **Default answer** field is empty. Using the example above, the question would be asked if the **Requested by** field is empty.\n- **Default answer from script**: A question where the default answer comes from a script. The answer may be a number, string, or percentage. The **General** tab adds a field:\n\n**Ask question**: as the Specifies when to ask the question: always or only if the script doesn’t provide a default answer. The script is defined on the **Field Type** tab.\n\n **Note:** If you select a **Data type** that is incompatible with the selected **Method**, the system automatically changes the **Method** to a compatible value.\n\n |
| \n\nWeight\n\n | \n\n\\[Required\\] Numeric value that represents the importance of this metric relative to other metrics in the same category. By default, the weight is 10.\n\n This field is visible and required unless the **Data type** is **Date**, **Date/Time**, or **String**. These data types aren’t included in results calculations.\n\n |
| \n\nOrder\n\n | \n\n\\[Required\\] Numeric 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.\n\n**Note:** It doesn’t matter which order value you use for metrics with the Script method, as they don’t appear on questionnaires.\n\n |
| \n\nActive\n\n | \n\nCheck box that determines whether this metric is used. If the check box isn’t selected, it’s as if the metric record doesn’t exist.\n\n |
| \n\nMandatory\n\n | \n\nCheck box that makes the metric question mandatory \\(selected\\) or optional \\(cleared\\) on assessment questionnaires. Users can't submit questionnaires until they provide valid responses to all mandatory questions, which are denoted by a red field status indicator.\n\n This field is visible only if the **Depends on** field is empty, and the data type isn’t **Checkbox**.\n\n |
| \n\nField\n\n | \n\nDescription\n\n |
|---|---|
| \n\nQuestion\n\n | \n\nText to use as the question on security incident review questionnaires. Enter a clear, straightforward question that is easy to answer, such as **How did we contain the incident**\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 tooltip when a user hovers over the question text on the questionnaire.\n\n |
| \n\nDepends on and Displayed when\n\n | \n\nSelect a question in the **Depends on** field that the current question depends on. For example, the question, \"What additional logs were needed?\" depends on the question \"Were all needed logs available?\"\n\n Next, use the **Displayed when** field to identify when you want the dependent question to appear in questionnaires. For example, if you want the dependent question to be asked only when the user answers **No** to the \"Were all needed logs available?\" question, select **No** in the **Displayed when** field.\n\n **Note:** The system helps to prevent the creation of recursive dependencies between metrics. For example, if Metric A depends on Metric B, Metric B can’t depend on Metric A.\n\n |
| \n\nField\n\n | \n\nDescription\n\n |
|---|---|
| \n\nData type\n\n | \n\nThe data type of the expected response the list of types available depends on for 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 can’t 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 each time a user opens an assessment questionnaire that contains the question. Answer preference can be influenced by the order in which answer options appear. This can result in biased results. Randomizing answer options can help prevent this bias.\n\n This field is visible only if you select **Likert scale** or **Choice** in the **Data type** field.\n\n |
| \n\nDependent plugin\n\n | \n\n\\[Required if the **Method** is **Script**.\\]Plugin 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**.\n\n This field is visible only if the **Method** is **Script**.\n\n **Note:**\n\n- If the Core default value is used, the script is always run.\n- If you’re an administrator, you can add more choices of plugins to the field.\n\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 defects 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 aren’t included in results calculations.\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. The script has one input variable, set with the ID of the security incident \\(primary\\), and three possible output variables set by the script, string\\_result, scaled\\_result, and actual\\_result. When the data type is String, only the string\\_result is required.\n\n This field is visible and required when the **Method** is **Script**, or the default value comes from a script.\n\n |
| \n\nTemplate\n\n | \n\nA predefined set of common answers to use for the question. For example, a frequency template would likely start with a value of \"Never,\" and go up to the top value of \"Always.\"\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 can’t change the template.\n\n |