> For the complete documentation index, see [llms.txt](https://docs.ins-pi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ins-pi.com/command/features/assessments.md).

# Assessments

Write questionnaires, ask people or teams to answer them about a record, and run campaigns across many records.

Assessments let you ask structured questions and see who still owes an answer. You write a questionnaire once, then ask a person or a team to answer it about a record, or send it to the owners of many records in a campaign. Answers are stored with the record in your ServiceNow instance, so other features such as reviews and scores can use them.

## What it is

A full-page view called **Assessments**, with the subtitle **Questionnaires and who still owes an answer**. It has three tabs: **Overview**, **Questionnaires** and **Campaigns**.

<figure><img src="https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-e2fd0dee77e9b6ababbfbc4db76ac3fecbd9dd94%2Fcommand-page-assessments.png?alt=media" alt="The Assessments Overview with the six summary cards, Asked of me selected, and the list of questionnaires I still have to answer under its heading."><figcaption><p>The Assessments Overview</p></figcaption></figure>

There are two kinds of questionnaire:

| Kind           | Asked about                      | Typical use                               |
| -------------- | -------------------------------- | ----------------------------------------- |
| **Assessment** | A record, such as an application | Maturity, architecture review, risk check |
| **Survey**     | A person                         | Satisfaction, readiness, pulse checks     |

The **Overview** cards each switch the list below them, and a heading above the list names the card you chose, such as **Late · Due date has passed**:

| Card                    | Shows                                                                                               |
| ----------------------- | --------------------------------------------------------------------------------------------------- |
| **In use**              | Published questionnaires, how often they were asked and answered, with **Ask someone** on each row. |
| **Asked of me**         | What you, or a team you belong to, still have to answer.                                            |
| **Late**                | Requests past their due date and who they are waiting on.                                           |
| **Still being written** | Questionnaires not ready to send.                                                                   |
| **Who is using it**     | Teams and programs using questionnaires.                                                            |
| **Campaigns**           | Rounds in flight.                                                                                   |

## When to use it

* You need the same questions answered consistently about many records.
* A review gate in [Architecture Governance](https://docs.ins-pi.com/command/features/architecture-governance.md) expects an assessment as evidence.
* You want to know who has not answered yet, and what is late.

## How to

### Open the view

1. Click **Assessments** in the activity rail.

### Write a questionnaire

1. Open **Questionnaires** and create a new questionnaire.
2. Enter a **Name**, choose the **Kind** (assessment about a record, or survey asked of a person) and, for an assessment, which records it is about.
3. Add sections and questions. Answer types include **Scale**, **Number**, **Single choice**, **Multiple choice**, **Yes / No**, **Short text**, **Long text**, **Date**, **Record reference** and **Attestation**.
4. Click **Check**, then **Publish**. To change a published questionnaire later, create a **New revision**.

### Edit a draft questionnaire

While a questionnaire is still a draft, you can correct it in place instead of removing and adding questions again.

1. Open the draft from **Questionnaires**.
2. Click **Edit** on the questionnaire, a section or a question. A form opens in place.
3. Change what you need: the **Name** and **Instructions**, a question's text, **Help text**, **Weight** and scale, or each choice's label and score.
4. Click **Save**, or **Cancel** to leave everything as it was.

A published revision has no **Edit** buttons. To change it, create a **New revision**.

### Ask someone about a record

1. On **Overview**, open **In use** and click **Ask someone** on the questionnaire.
2. Under **About**, search for the record.
3. Under **Who**, choose **A person** or **A team** and search for them.
4. Set a **Due date and time** (in your ServiceNow time zone), then click **Ask**.

The request lands in the person's, or the team's, **My Tasks**. For a team, everyone in it is told and anyone in it can answer.

{% hint style="info" %}
Without a due date a request can never show as late.
{% endhint %}

### Run a campaign

1. Open **Campaigns** and create a campaign.
2. Enter a **Name** and choose a published **Questionnaire**.
3. Under **Which records to include**, set a filter, or leave it empty for all records.
4. Under **Who should answer**, choose the field that names each record's owner.
5. Check the preview: **Records**, **People**, **Teams** and **Missing an owner**.
6. Click **Create campaign**, then **Start**, then **Send**. Click **Finish** when the round is over.

<figure><img src="https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-3058c51fff79886473a42081635acf83763c284a%2Fcommand-assessments-campaign.png?alt=media" alt="The campaign form with a questionnaire chosen, the owner field to ask and the preview cards counting records, people, teams and records missing an owner."><figcaption><p>The campaign form and its preview</p></figcaption></figure>

### Answer an assessment

1. Open it from **Asked of me** with **Open**, from the task in **My Tasks**, or from **Open the assessment** in a review.
2. Read **Before you start**, if the questionnaire has instructions.
3. Answer the questions. Required ones are marked with an asterisk. Use **Add a comment** to explain an answer.
4. Use **Overall comment** for anything the answers do not capture.
5. Click **Save** to continue later, **Submit** when you are done, or **Close** to leave without submitting. If you have unsaved answers, Command asks whether to save them first.

The form reads top to bottom as one column: who and what it is about, then each section with numbered questions. A strip at the top stays in view while you scroll, with how many questions are answered and how many required ones are left. If **Submit** is refused, the first missing required question is selected. After you submit, your task list and Home update.

<figure><img src="https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-ec7ca233f43a0b8dd8f8dcc0700aa69bf6adc686%2Fcommand-assessments-answer-form.png?alt=media" alt="An assessment being answered, with a header card naming the record and who it is assigned to, a Before you start box, a progress strip counting answered and required questions, and numbered questions under a section heading."><figcaption><p>Answering an assessment</p></figcaption></figure>

## Good to know

* The **Late** card counts every open request whose due date has passed, and its list shows them with the date and time they were due.
* The **Overview** opens on the card you last clicked, in this browser, also after a reload or in a new tab. Until you pick one, it opens on **Late** when anything is overdue.
* To reload the figures, click the round **Refresh** icon in the header. If part of the page cannot load, what did load stays on screen, and a line above the page says **Could not load the assessment program.** with **Try again**.
* Requests notify people in Command. They do not send email.
* An anonymous survey does not create a task, and your name is not stored with the answers once you submit.
* A campaign reports records that have no owner instead of skipping them silently.
* Administrators choose which questionnaire Command asks for in which situation in **Global Settings > Assessments**.

{% hint style="warning" %}
You may occasionally receive the same request notification twice. This is a known issue and does not create a second request.
{% endhint %}

## Related

* [Tasks, Notifications and Approvals](https://docs.ins-pi.com/command/the-portal/tasks-and-notifications.md)
* [Architecture Governance](https://docs.ins-pi.com/command/features/architecture-governance.md)
* [Ideation Portal](https://docs.ins-pi.com/command/features/ideation-portal.md)
* [Personas](https://docs.ins-pi.com/command/the-portal/personas.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ins-pi.com/command/features/assessments.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
