# Search Work Order

## Context

Search a work order by various ULB Employees/ users.

## Actors

Employee

Role: Work Order Creator, Work Order Verifier, Work Order Approver.

## Actions

1. **Search Work Order**- It has to be configurable and is mapped with a role on demand.
2. Search Work Order is provided to allow the users to search for a work order and view its details.

#### Search Criteria

<table><thead><tr><th width="122">#</th><th width="190">Field</th><th width="143">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>Ward</td><td>Drop-down</td><td>Auto-complete, matching search. The values populated from ward boundary master data.</td></tr><tr><td>2</td><td>Project type</td><td>Drop-down</td><td>Project type masters value</td></tr><tr><td>3</td><td>Project name</td><td>Textbox</td><td>Project name</td></tr><tr><td>4</td><td>Work order number</td><td>Textbox</td><td>Work Order number, unique identification no.</td></tr><tr><td>5</td><td>Status</td><td>Drop-down</td><td>Workflow state of a work order.</td></tr><tr><td>6</td><td>Created From Date</td><td>Date Picker</td><td>Work Order creation date.</td></tr><tr><td>7</td><td>Created To Date</td><td>Date Picker</td><td>Work Order creation date.</td></tr></tbody></table>

1. At least one parameter is required to perform the search.
2. The date range From Date/ To Date is considered one parameter.
3. An exact search is performed for the values entered/selected except the project name.
4. For project name fuzzy search to be enabled.
5. In case multiple parameter values are supplied AND are applied for searching record.

#### Search Result

The search result is shown as given below.

<table><thead><tr><th width="103">#</th><th>Field</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>Work order number</td><td>Display Only</td><td>A hyperlink to open the work order  in view mode.</td></tr><tr><td>2</td><td>Project name</td><td>Display Only</td><td>Project name with project description displayed as tool-tip on mouseover</td></tr><tr><td>3</td><td>Name of CBO</td><td>Display Only</td><td>Name of the organization to whom Work Order is awarded.</td></tr><tr><td>4</td><td>Role of CBO</td><td>Display Only</td><td>Role of CBO, IA/IP</td></tr><tr><td>5</td><td>Location</td><td>Display Only</td><td>Locality name along with ward name. (Locality + Ward)</td></tr><tr><td>6</td><td>Status</td><td>Display Only</td><td>Workflow status of the work order.</td></tr><tr><td>7</td><td>Work order amount</td><td>Display Only</td><td>Total WO amount.</td></tr></tbody></table>

## Validations

1. At least one parameter is required to perform the search.

## Actions

1. Search - To search the result upon supplying the values of the parameters.
2. Clear Search - To clear the search parameters supplied.

## Notifications

Not applicable.

## User Interface

[<img src="https://static.figma.com/uploads/b6df2735e4cb368306acf5480b50f96e69f96099" alt="" data-size="line">DIGIT-Works](https://www.figma.com/file/M2P3O9WlKtxuLCjQKxLLDg/DIGIT-Works?node-id=1835%3A33232\&t=ewVSJBLAMoyry76D-4)

## Acceptance Criteria

<table><thead><tr><th width="216">Acceptance Criteria</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>At least one parameter is required to perform the search.</td></tr><tr><td>2</td><td>Search results are displayed on matching records found else no record found message is displayed.</td></tr><tr><td>3</td><td>Pagination is applied if more than 10 records are found.</td></tr></tbody></table>


---

# 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.digit.org/works/reference-implementations/muktasoft-v2.2/specifications/functional-requirements/user-stories/work-order/search-work-order.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.