> For the complete documentation index, see [llms.txt](https://docs.novacura.com/marketplace-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.novacura.com/marketplace-documentation/applications/explore-apps/ifs/maintenance-survey/documentation/ifs-cloud/creation-of-maintenance-surveys.md).

# Creation of Maintenance Surveys

## Overview

This application is used to create maintenance surveys and to edit existing surveys. The application includes:

* Creating new surveys
* Add questions to the surveys
* Update/edit questions of created surveys
* Changing the status of surveys

<figure><img src="https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2FFub6BAqxI11G4EsM7hdI%2FCreation%20of%20Maintenance%20Surveys%20Cloud.png?alt=media&amp;token=5d3c6a5a-3ca7-4782-825a-00a26d90df52" alt=""><figcaption></figcaption></figure>

*The complete overview of the application:*

{% file src="/files/XhGkl0J7vCi8QGQmIGJx" %}

## Steps

### Create new Maintenance Survey

On the first screen of the application, there's a drop-down list consisting of existing surveys which can be selected and edited. From here, it is also possible to create a new survey.

Select 'Create New' from the list to begin creating a new survey.

<div align="left"><figure><img src="https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2F2pbLO97Z5KL77xcpT5FS%2Fcreateorupdatequestion.png?alt=media&amp;token=afdd21c6-a806-4b74-971c-f32bfdd4c3df" alt=""><figcaption></figcaption></figure></div>

#### Survey Details

The next step contains several fields, some of which are mandatory to fill out.

The following fields are mandatory:

* Survey Id
* Survey Name
* Description
* Creation Date
* Closing Date
* Introduction Text
* Ending Text
* Workflow Type
* Rank

The following fields are optional:

* Show Introduction Text
* Show Ending Text
* Always Start New
* Answer Once
* Temp Save
* Auto Save
* Loop Survey
* Loop Text

{% hint style="warning" %}
Checkboxes 'Loop Survey' and 'Answer Once' can not be selected together!
{% endhint %}

{% hint style="warning" %}
Checkboxes 'Always Start New' and 'Temp Save' can not be selected together!
{% endhint %}

When the fields are filled out, press 'Next' to proceeds to the next step of the application.

<div align="left"><figure><img src="https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2Fpol2ilFxDzPNL0S68xqd%2Fsurveydetails.png?alt=media&amp;token=3f391016-b2a0-418d-84c5-0d123f75100c" alt=""><figcaption></figcaption></figure></div>

#### Create survey question - Question Type

A survey can contain a variety of different question types. The available types are:

* Yes/No
* Multi-choice
* Numerical
* Statement
* Picture
* Signature
* Survey
* Date
* Time
* Date/Time

Select the appropriate question type, and then press 'Next' to proceed.

<div align="left"><figure><img src="https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2FSpimeUsYTjHmg36fcvjJ%2Fcreatesurveyquestion1.png?alt=media&amp;token=61e26db8-dce7-4008-afa5-1d6b1bc62aaa" alt=""><figcaption></figcaption></figure></div>

#### Create survey question

Fill out the survey question and the fields that decides how the question should behave. Depending on which question type selected in the previous step, the fields may vary. Check the box 'Optional' if the question should be considered optional for the survey.

The survey question will be saved and added to the survey when 'Create Question' is pressed, and the application will proceed to the next step.

<div align="left"><figure><img src="https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2FN5odum5NWcEHzIztmI8c%2Fcreatesurveyquestion-2.png?alt=media&amp;token=36551fdf-d0f8-4d7a-853b-252c22361f2f" alt=""><figcaption></figcaption></figure></div>

#### Create new survey, end the application, approve survey, or add additional question

Decide whether to create a new survey, end the application by clicking 'Menu', approve the survey, or add an additional question to the survey.

<div align="left"><figure><img src="https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2Fwq9jJpNMhmNdvIXxHQh2%2Faddnewquestion.png?alt=media&amp;token=16e5d95e-5856-434c-a269-1c5dd7d21a8a" alt=""><figcaption></figcaption></figure></div>

If 'Approve Survey' is chosen, this next screen will be shown and give the option to publish the survey, or to end the application by clicking 'Menu'.

<div align="left"><figure><img src="https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2F72DOsQSPN4jxNA3RhAli%2Fapprovesurvey.png?alt=media&amp;token=852f3c63-6375-425b-891d-879d48e0836f" alt=""><figcaption></figcaption></figure></div>

Publishing the survey will end the application.

### Update Maintenance Survey

In this application, two things can be updated on a survey which are:

* State of survey
* Survey questions

{% hint style="warning" %}
To update the questions of a survey, the survey needs to be in a 'Planned' state. Surveys in state 'Approved' or 'Published' can be changed to 'Planned', allowing the option to update their survey questions!
{% endhint %}

{% hint style="info" %}
**The colours of the surveys in the drop-down list signify which state it is in:**

* Purple = Approved
* Yellow = Planned
* Green = Published
  {% endhint %}

On the first screen of the application, select which survey to update in the drop-down list. To find a specific survey easier, click on the magnifying glass icon to filter the list using, for example, the survey's Id or Description.

<div align="left"><figure><img src="https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2FkCQ4ojo4iPeSZRpvHf8P%2Fcreateorupdatequestion.png?alt=media&amp;token=3d82a016-fd52-42da-aff9-8b859cb7c4ac" alt=""><figcaption></figcaption></figure></div>

#### Update state of survey

* If the selected survey is in state 'Approved', it is possible to set the state to 'Planned' or 'Published'.&#x20;
* If the selected survey is in state 'Planned', it is possible to set the state to 'Approved'.
* If the selected survey is in state 'Published', it is possible to set the state to 'Planned'.&#x20;

#### Update survey questions

Select one or more questions to update, and then press 'Next'.

<div align="left"><figure><img src="https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2FjKJz0IBo8eYiXghh1OrE%2Fupdatesurvey.png?alt=media&amp;token=b7f3417d-0427-443a-8ff8-675b67d8a60b" alt=""><figcaption></figcaption></figure></div>

On this screen, the user can now update the selected question. Press 'Update'  when done to save the changes. The application will redirect back to the previous step.

<div align="left"><figure><img src="https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2FFmX4dAPbDflw02bF1TIv%2Fupdatequestion.png?alt=media&amp;token=06d830dc-8abb-4c4d-9396-a3d8c419167b" alt=""><figcaption></figcaption></figure></div>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.novacura.com/marketplace-documentation/applications/explore-apps/ifs/maintenance-survey/documentation/ifs-cloud/creation-of-maintenance-surveys.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
