---
title: "USE CASES"
slug: "use-cases-1"
updated: 2026-03-24T10:37:16Z
published: 2026-03-24T10:37:16Z
canonical: "support.keypro.fi/use-cases-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.keypro.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# USE CASES

## Supply interruption - SMS - Alert

This use case describes how a new alert is created from the **Supply interruption![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-0hsani5g.png)**form, including sending a text message to the area via the **SMS Sending**![C:\Users\saju-1\Pictures\icons\phone.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-g8z63upu.png)form.

To begin creating the alert, open the **Supply interruption![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-0hsani5g.png)**form from the main toolbar of the environment under **Reports**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-6gqdhrw7.png)tools. The button is visible if the **Alert**![C:\Users\saju-1\Pictures\icons\feed_error.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-3817gwpe.png)functionality is enabled in the environment.

On the **Supply interruption![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-0hsani5g.png)**form, you can calculate and view the affected areas of the interruption along with the network objects. **Supply interruption![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-0hsani5g.png)**form helps you identify which customers are affected by the outage and how large the affected area is. The form is also a useful tool during maintenance and modification work. Additionally, it provides information on which valves must be closed during the outage.

## Creating a supply interruption

1. To create a new supply interruption, select a conduit or valve on the **Supply interruption![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-0hsani5g.png)**form using the **Target selection**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-uzgm732j.png)button.
2. Then, select the desired valve or conduit on the map.
3. After the selection, the system automatically performs the calculation, and the supply interruption area—with its consumer points and the valves that need to be closed **(S)**—is highlighted on the map.

**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-105sg06r.png)**

**Note!** When the **Supply interruption** layer is active, you can view previously created interruptions. In that case, use the **Pick supply interruption**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-gngp519y.png)option from the form's toolbar.

### Supply interruption details

The **Supply interruption![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-0hsani5g.png)**form is divided into five different information sections, where you can document information related to the supply interruption. For a successful save, all fields in the **Supply interruption** section (**Identification, In charge, Planner, Network type, Job,** and **Type**) are mandatory. The structure and functionality of the form follow the same rules as other KeyAqua forms.

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1771492274154.png)

The **Supply interruption![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-0hsani5g.png)**form automatically generates an **Identifier** based on the nearest address after the calculation has been completed. The **Identifier** can be edited afterwards. In addition, the **Network type** field is automatically filled in according to the information of the object selected on the map.

- The **Job** field allows you to select whether the supply interruption is planned or unplanned.
- In the **Type** field, you specify what type of supply interruption work it is.
- The **Description** field can be used to enter additional information describing the supply interruption.
- In the **Evaluated dates** section, you indicate the estimated time of the supply interruption.
- In the **Actual dates** section, you enter the actual time when the supply interruption occurred.

Both dates sections include a calendar function: by clicking the field, a calendar opens where you can select both the date and time, then press the **OK** button. By double‑clicking the field, you can select two dates between which, for example, the estimated start date may fall.

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1771491191659.png)

In the **General info** section, the consumers in the affected area, duct volume, water flow, and power are calculated automatically. The section also includes a **State** field, where you can define the state of the supply interruption.

The **Address** section is automatically filled in according to the address of the object selected on the form.

The bottom part of the **Supply interruption![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-0hsani5g.png)**form contains the following tabs:

- **Consumer points**: A list of all consumer points included in the supply interruption.
- **Valves to close**: This tab lists all manholes and their valves that must be closed during the supply interruption.
- **Other objects**: Other objects that are included in the supply interruption.
- **Observations**: Observations related to the objects affected by the supply interruption. The information is collected from the **Investigation****![C:\Users\saju-1\Pictures\icons\eye.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/maintenance-and-reporting-tools-image-ki95vxbx.png)**form.
- **History**: The **History** tab displays information about previous supply interruptions affecting the same consumer points that are included in the supply interruption currently open on the form.
- **Attachments**: You can add attachments to the supply interruption, such as photos or documents.

### Adding valves and conduits to an existing supply interruption

It is possible to add new valves and conduit to a previously created and saved supply interruption.

1. Start adding a new object by clicking the **Add object![wrench](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/duct-tools-image-lidutyfz.png)**button from the form’s toolbar.
2. From the dropdown menu, select **Add valve****![C:\Users\saju-1\Pictures\icons\dh_valve.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-9pvqut5f.png)**or **Add conduit![C:\Users\saju-1\Pictures\icons\dh_conduit.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-gywustoj.png)**.
3. Create or pick the correct network object on the object form that opens, and then click the **Update / Export to form![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-jg6b5yml.png)**to form button located at the bottom right corner of the form.
4. The object will now appear on its own tab within the **Supply interruption![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-0hsani5g.png)**form.

### Adding a contact person

1. Add contact persons to the supply interruption using the **Contact person****![C:\Users\saju-1\Pictures\icons\report_user.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-b585u69g.png)**button at the bottom of the form.
2. On the **Contact persons for object** form that opens, you can view existing contact persons and add new ones.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1771502014776.png)
3. Add a new contact person to the object by clicking the **Add new contact![C:\Users\saju-1\Pictures\icons\add.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-qcdn2zyu.png)**button.
4. On the **Contact person** form that opens, you can search for existing contact persons and save new ones.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1771502447919.png)
5. When adding a new person, fill in at least the required fields on the form and click the **Save**![save](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-gy3zdz9k.png)button.

You can also add an address for the contact person using the **Add****![C:\Users\saju-1\Pictures\icons\add_address.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-zcrh86wk.png)**button.

If you want to link the contact person on the form to your object:

1. Click the **Add this contact to the active object![C:\Users\saju-1\Pictures\icons\house_link.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-y6q5nm07.png)**button.
2. The system will ask for confirmation before adding the contact person to the object. By selecting **Yes**, the contact person is added to the supply interruption’s contact list.
3. Finally, click the **Refresh![C:\Users\saju-1\Pictures\icons\refresh_blue.gif](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-7uolanft.png)**button to update the view on the **Contact persons for object** form.

The contact persons listed can be edited on their own form, and you can set a contact person as **In charge** or **Planner**. Right‑click on the contact person’s row and select the desired action.

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1771504230560.png)

#### Creating a new contact person from the In charge and Planner fields

Next to the **In charge** and **Planner** fields, you can either select an existing contact person from the dropdown menus or create a completely new person by clicking the **Add**![C:\Users\saju-1\Pictures\icons\add.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-e1d3cdyl.png)button next to the field. This opens the **Contact person** form.

1. **Search**![search](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-we104ap6.png)for an existing contact person, or create a new one.
2. Before creating a new contact person, clear the form using the **Clear**![page_white](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-f28816qg.png)function.
3. Fill in at least the fields marked with an **asterisk (*)** on the empty form. You can also add an address for the contact person using the **Add/change address![C:\Users\saju-1\Pictures\icons\add_address.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-fbs0s9a9.png)**button.
4. Click the **Save![save](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-gy3zdz9k.png)**button in the form’s toolbar.
5. After entering all necessary information, click the **Add contact to fields**![user_go](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-oaehng6a.png)button in the toolbar.

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1771505202038.png)

#### Highligting an object on the map

You can select and highlight objects on the map by clicking the associated network objects on their respective tabs.

**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1771505385006.png)**

#### Handout

Click the **Handout****![C:\Users\saju-1\Pictures\icons\reports.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-m10x7658.png)**button to create a notice based on the information in the **Supply interruption![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-0hsani5g.png)**form. The system generates the notice in Excel format, where you can edit the content of the notice, and save or print the form.

![Kuva, joka sisältää kohteen teksti Kuvaus luotu automaattisesti](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-2k9i3b00.png)

### Exporting information to the SMS Sending form

It is possible to send a text message to the customers of the consumer points located in the supply interruption area. To successfully send a text message, the customer must have a mobile phone number saved in the system.

1. Retrieve the supply interruption — or multiple supply interruptions — onto the form, and click the **SMS Service![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-7j03rw12.png)** button.
2. The **SMS Sending****![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-7j03rw12.png)**form opens pre‑filled with the contact information of the customers belonging to the supply interruption.

**Note!** The **SMS Service![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-7j03rw12.png)** button is not automatically enabled in the **Supply interruption![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-0hsani5g.png)**form's toolbar. From the dropdown menu of the **Add object**![wrench](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-m2o5j79y.png) button in the toolbar, you need to add valves, conduits, or consumer points to the form as needed.

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1771507116132.png)

To transfer information from the **Supply interruption![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-0hsani5g.png)**form to the **SMS Sending**![C:\Users\saju-1\Pictures\icons\phone.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-gamb41jg.png)form, add all relevant consumer points to the **Consumer point** tab using the **Add consumer point**![house_link](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-e8uiiv9t.png)option in the **Add object![wrench](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-m2o5j79y.png)**dropdown menu. Export the desired consumer point to the **Supply interruption![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-0hsani5g.png)**form using the **Update /Export to form![update_to_form](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-sdr67le6.png)**button.

Note!For more information about how the **Consumer point** form works, see the [Consumer point](/kb/docs/customerconsumer-point-tools-2-1-1-1-1-1) chapter in the KeyAqua User's manual.

Once you have added at least one consumer point, the **SMS Service**![C:\Users\saju-1\Pictures\icons\phone.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-gamb41jg.png)button becomes active in the form’s toolbar. Click the button to transfer the consumer points to the **SMS Sending**![C:\Users\saju-1\Pictures\icons\phone.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-gamb41jg.png)form.

Note!For more details about the **SMS Sending** form, see the [SMS SENDING AND ALERTS (these functions are subject to a separate order)](/kb/docs/sms-sending-and-alerts-these-functions-are-subject-to-a-separate-order-3-1-1-1-1-1) chapter in the KeyAqua User's manual.

## Supply interruption calculation

The system calculates the network objects included in the supply interruption already on the **Supply interruption![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-0hsani5g.png)**form. To speed up this calculation, the system performs an automatic background process every night.

If the connections of the network objects are modified and you want to see how these changes affect the supply interruption area within the same day, you can start the supply interruption calculation (background task) manually.

Click the **Start supply interruption calculation**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-wuywd68e.png)button to manually trigger the calculation. The user will receive an email notification once the supply interruption calculation has been completed.

### Review supply interruption area

The **Review supply interruption area![C:\Users\saju-1\Pictures\icons\supply_review.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-y2ry12l9.png)**is a feature developed for the quick visualization of supply interruption areas.

1. Click the **Review supply interruption area![C:\Users\saju-1\Pictures\icons\supply_review.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-y2ry12l9.png)**button and, in the window that opens, select the **Pick a target on the map**![C:\Users\saju-1\Pictures\icons\pick.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-hzfyuc03.png).
2. Then, select an object (conduit/valve) on the map.
3. The network objects belonging to the supply interruption area will be highlighted on the map.
4. Use the **Clear![C:\Users\saju-1\Pictures\icons\page_white.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-z4mkbv7u.png)**button to remove the supply interruption area highlighting from the map.

## Creating an alert from the Supply interruption form

The **Alerts![C:\Users\saju-1\Pictures\icons\feed_error.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-mdv1ig64.png)**button becomes active on the **Supply interruption![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-0hsani5g.png)**form once a supply interruption has been saved or an existing one has been loaded onto the form.

When clicking the button, the **Alerts****![C:\Users\saju-1\Pictures\icons\feed_error.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-mdv1ig64.png)**form opens, and the text field is automatically pre-filled with the information ***Supply interruption***.

- If a disruption notice has already been created for the selected supply interruption, its details are automatically loaded into the form.
- If no disruption notice has been created previously, the form will be pre‑filled with the information described later in this guide.

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1771513933099.png)

### Creating a new alert

When an alert is created directly from the **Supply interruption![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-0hsani5g.png)**form, the following information is automatically filled on the new alert:

- Start date and time, based on the following rules:
  - Supply interruption **Start** **date**, if the **New start** **date** is empty
  - Supply interruption **New** **start** **date**, if it has been entered
  - Pre-notice is activated, and the date and time are set according to the creation time.
- End date and time, based on the following rules:
  - Supply interruption **End date**, if the **New end date** field is empty
  - Supply interruption **New e****nd date**, if it has been entered
  - Post‑notification is set to 2 weeks after the defined end date. This setting must be configurable per system, expressed in days.
- The **Category** is determined according to the type of work in the supply interruption as follows:

| **The supply interruption job** | **Alert category** |
| --- | --- |
| Planned | Planned works |
| Unplanned | Fault |

- **Network**: The **Network** is determined according to the supply interruptions network type.
- **State:** The alert's state is determined according to the following rules:

| **Supply interruption state** | **Alert** **state** |
| --- | --- |
| Not valid | New/Planned |
| Valid | In progress |
| Complete | Resolved |

- **Other details**: The number of consumer points included.
- **Locations**: Areas are created for the alert based on the geometry of the supply interruption. For each consumer point related to the supply interruption, the linked consumption area is retrieved, and a separate area‑type object is created for it.

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1771516683828.png)

Please refer to the [SMS SENDING AND ALERTS (these functions are subject to a separate order)](/kb/docs/sms-sending-and-alerts-these-functions-are-subject-to-a-separate-order-3-1-1-1-1-1) chapter in the KeyAqua User's manual for more information on creating a new alert.

### Updating a supply interruption

When the supply interruption is completed, the actual start and end dates must be entered into the **Alert![C:\Users\saju-1\Pictures\icons\feed_error.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/kytttapaukset-image-mdv1ig64.png)**form.

When the form is saved, these details are updated in the previously created alert.

The advance and post‑notification times are determined according to the previously described rules, based on the updated dates

### Correspondences

The correspondences for category, type, and state between supply interruptions and alerts can be configured by Keypro Oy for each system environment.

The activation of advance and post‑notifications (defined in days, 0–n) can also be configured on a per‑environment basis.