# Execute Maintenance Survey

## Overview

This application can be used to execute maintenance surveys associated to a work assignment.&#x20;

<figure><img src="/files/hYiNp2AKo6BvjiyjvHrF" alt=""><figcaption></figcaption></figure>

*The complete overview of the flow:*&#x20;

{% file src="/files/xsPw8t6DMe0Isx7I2bl8" %}
Click to view the workflow
{% endfile %}

***

## Pre-Requisites to Execute Maintenance Survey

* The work assignment should be in either **Assigned** or **Ongoing** state
* The maintenance survey has to be in the **Published** state
* The maintenance survey should be included in the workflow configuration as an E-Form

***

## Steps&#x20;

### 1. Select a Work Assignment

Select a work assignment from either **assigned** or **ongoing** states. You can search for work assignments based on below fields:

* Work order number
* Task number
* Assignment number
* Assignment state

<div align="left" data-full-width="false"><figure><img src="/files/Wr0AJW8RSeOzrkIjR0Vm" alt="" width="284"><figcaption></figcaption></figure></div>

### 2. Select Action

By selecting a work assignment action, the user can answer the survey associated to that action. If no surveys are attached, the user will be redirected to the same screen.

<div align="left" data-full-width="false"><figure><img src="/files/wGawDrCQ5sVzYI1i9WBC" alt="" width="287"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Work assignment actions are populate based on the current state of the assignment. &#x20;
{% endhint %}

Work assignment states are internally mapped with the following actions.

<table data-view="cards"><thead><tr><th>State</th><th>Actions</th></tr></thead><tbody><tr><td>ASSIGNED</td><td>Accept, Start Work, Incomplete, Cancel</td></tr><tr><td>ONROUTE</td><td>Pause Travel, Waiting at Location, Start Work, Incomplete, Cancel</td></tr><tr><td>WORKSTARTED</td><td>Complete, Incomplete, Pending, Cancel, Pause</td></tr><tr><td>ACCEPTED</td><td>Travel, Start Work, Incomplete, Cancel</td></tr><tr><td>PENDINGCOMPLETION</td><td>Start Work, Complete, Incomplete</td></tr><tr><td>WAITINGATLOCATION</td><td>Start Work, Incomplete</td></tr></tbody></table>

### Action - Complete

This screen allows for setting the status of a particular assignment to "Complete."

* To access this screen, select the "Complete" option from the actions list

#### Report In

Select an Item Class and press 'Next' to continue reporting, or press 'Skip' to skip the following step below and proceed with the application with the field left empty.

<div align="left"><figure><img src="/files/aJx82zANp0R63gv38boj" alt="" width="281"><figcaption></figcaption></figure></div>

A few more fields will appear on the following screen if an Item Class is selected. These fields are not mandatory and can be left empty if desired.

* Failing Function
* Operational Status
* Fault Type
* Cause Code
* Performed Action
* Fault Class
* Long Description
* Cause Details
* Performed Work
* Work Start
* Work Finish

<div align="left"><figure><img src="/files/zK8kNOcsesxDkKnUwX2C" alt="" width="280"><figcaption></figcaption></figure></div>

Once the above steps are completed, you can move on to answer the survey related to the "Complete" work assignment status.

### Action - Incomplete

This screen allows for setting the status of a particular work assignment to "Incomplete."

* To access this screen, select the "Incomplete" option from the actions list
* Choose a cause for the incomplete submission
* Add a comment (optional)
* Enter the remaining hours needed to complete the assignment; if no hours are provided, the system will default to the predefined remaining hours

<div align="left" data-full-width="false"><figure><img src="/files/O4JFed6EwdfgXUgGXri8" alt="" width="286"><figcaption></figcaption></figure></div>

Once the above steps are completed, you can move on to answer the survey related to the "Incomplete" work assignment status.

### Action - Cancelled

This screen enables the status of a particular work assignment to be set to "Cancelled."

* To access this screen, select the "Cancel" option from the actions list
* Choose a cause for the cancellation
* Add a comment (optional)&#x20;

<div align="left" data-full-width="false"><figure><img src="/files/kEQtBPe71Ip33o83AxSH" alt="" width="286"><figcaption></figcaption></figure></div>

Once the above steps are completed, you can move on to answer the survey related to the "cancelled" work assignment status.

### 3. Introductory Text to the Survey

This screen will appear only if the survey has been configured to show an introductory message.

<div align="left" data-full-width="false"><figure><img src="/files/AmO9SpkUrkbccfbi2dSc" alt="" width="287"><figcaption></figcaption></figure></div>

### 4. Responding to Survey

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

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

<div align="left" data-full-width="false"><figure><img src="/files/ct0Kvy20qmu3LdHZFIA3" alt="" width="287"><figcaption><p>Yes/No question</p></figcaption></figure> <figure><img src="/files/zUrpG85JEDEVlH7xMuMH" alt="" width="287"><figcaption><p>Multi-choice question</p></figcaption></figure></div>

<div align="left"><figure><img src="/files/qal8rbdvPlLCPWSbnhst" alt="" width="286"><figcaption><p>Signature question</p></figcaption></figure> <figure><img src="/files/PwufUa229N6GNlMzkDIv" alt="" width="287"><figcaption><p>Picture question</p></figcaption></figure></div>

### 5. Ending Text

This screen is displayed when a survey is configured to include an ending text.&#x20;

<div align="left" data-full-width="false"><figure><img src="/files/PIFAMLTELXxZPcHLbmaP" alt="" width="284"><figcaption></figcaption></figure></div>

When Ending Text step is done, it will mark the end of the survey, and you will be redirected to the Work Assignments screen.


---

# Agent Instructions: 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:

```
GET https://docs.novacura.com/marketplace-documentation/applications/explore-apps/ifs/maintenance-survey/documentation/ifs-cloud/execute-maintenance-survey.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
