---
title: "Circuits"
slug: "circuits-1-1-1-3-1-1-6"
updated: 2026-09-18T10:28:43Z
published: 2026-11-03T12:01:56Z
canonical: "support.keypro.fi/circuits-1-1-1-3-1-1-6"
excludeFromSearch: true
excludeFromExternalSearch: true
---

> ## 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.

# Circuits

Use the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)**form to manage circuits, connection sections, and connections. This form can be used for creating new circuits and deleting old ones, and for editing and viewing existing circuits. You can also use the form to create a **work order**, to add a **fault history** for a circuit, and to view **sub-circuits****.**

**In the KeyNet![https://stage.keycom.keypro.fi/static/keyrns_core/image/keynet.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet--tykalut-image-83v2vb7l.png)tools, click Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)to open the Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)form. You can also open this form through the list of cable customers, the list of circuits on the telecom premises, the connector list for telecom premises, or the list of customer’s circuits by clicking the right mouse button and selecting it in the displayed menu. In addition, you can open the Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)form by clicking the Open circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)button on the Logical circuit mass creation![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-g64w15tq.png)form.**

## Picking circuits from the map

Use the **Pick from map**![wand](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-5ydt4qg9.png)drop-down menu to pick circuits from the map:

- **Map view area** picks the circuits in the map view.
- **Free area** lets you define an area on the map from which the circuits are picked.
- **Existing area** option is for picking an existing area, for example, circuits within a plan or service area.
- **Use physical reservations** option is for picking circuits with physical connections to the objects defined on the map.

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

When you click **Pick from map**![wand](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-vl1prius.png), a dialogue box is displayed in which you can choose whether to search for circuits based on telecom premises or an installation address (both are selected as a default).

- **When the search is based on telecom premises reserved for a circuit**, the telecom premises in the defined area will be compared with the information stored in the database concerning telecom premises reserved by circuits, and all circuits with telecom premises reserved for circuit connections matching the telecom premises in the defined area will be displayed on the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-8bppcpar.png)**form.
- **When the search is based on an installation address**, the addresses in the defined area are compared with the circuit addresses in the database, and all circuits with an address matching the addresses in the defined area are displayed on the **Circuit****![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)**form.

The functions related to the **Pick from map![wand](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-vl1prius.png)**tool are discussed in the chapter [Picking objects from the map](https://portal.document360.io/kb/docs/buttons-on-object-forms-4-1-1).

## Locating and highlighting a circuit

To highlight the cables connected to the connectors reserved for the circuit, click **Locate and highlight**![arrow_in](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-4qq3dn06.png)at the bottom of the **Circuit**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)form, and use the functions available in the drop-down menu for the button. If several circuit sections have been defined for the circuit, the **Highlight![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1781690872868.png)**function is applied to all of them. The **Highlight all** function highlights all the circuits on the form.

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

**TIP:** You can use the **List**![list_objects](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-n9dl8mbv.png)function to highlight the circuits on a map using different colours. The List function is introduced in the chapter [List](https://portal.document360.io/kb/docs/buttons-on-object-forms-6). To view the components of the **Circuit section**, click **Show components of the section in group display**![groupdisplay](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-wn026bjc.png). Group display is discussed in more detail in the chapter [Group display](https://portal.document360.io/kb/docs/other-tools-21-1-1-3-1-1).

### Highliting a circuit section

You can highlight an individual circuit section by clicking the **Locate and highlight**![arrow_in](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-4qq3dn06.png)button at the bottom of the circuit section toolbar.

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

If you want to highlight a circuit section only partially, select the rows you want to highlight in the circuit section by clicking with the left mouse button while holding down the Ctrl or SHIFT key. Next, in the menu that opens when you click the right mouse button, select **Highlight selected![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1781690872868.png)**or **Locate and highlight selected![arrow_in](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-4qq3dn06.png)**.

Also, from the same drop-down menu, click **Open in** to access additional functions for selected circuit rows. You can view the **telecom premises**, **device**, **cross-section** or **affected area** related to a circuit’s connectors by clicking **Open in**. In addition, you can use the **R****oute follower![https://stage.keycom.keypro.fi/static/keyrns_core/image/object_search.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-z7a168qb.png)**function to follow the route of a circuit’s connector. You also have the option of selecting several circuit reservation lines to be viewed.

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

## Information on circuits

The content of the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)**form consists of the following: basic data (**Circuit information**), installation address information (**Circuit location**), backup circuit information (**Backup circuit**), information related to circuit sections and circuit section reservations (**Circuit sections**).

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

The **Circuit information** section is divided into four tabs (**Information, Comments, Attachments,** **Rental contracts** and **Extra data**).

- On the **Information** tab, you can add basic data on the circuit: **Identifier, Identifier 2, Contract number, Order number, Customer number, Customer, Organization, Redundancy, Importance, Contract length, Database ID** and **Super circuit**.
- You can add additional comments in the **Comments** tab.
- The **Attachments** tab is used for creating and viewing attachments.
- The **Rental contracts** tab is used for viewing any rental contracts related to the circuit. To add a new rental contract, go to the **Rental contracts** tab, which is discussed in more detail in the [Rental contract](/kb/docs/rental-contract-1-1-1-3-1-1-6) chapter.
- **Extra data** tab allows you to define free-form property attributes. Read more in the chapter [Extra data](https://support.keypro.fi/docs/keycom-object-forms-15-1-1-3-1-1-6#property-attributes-that-can-be-defined-freely-extra-data).

Circuit's installation addresses are added in the **Circuit location** section. Read more in [Installation addresses](/kb/docs/circuits-1-1-1-3-1-1-6#installation-address).

Backup circuits are managed in the **Backup circuit** section. Read more in [Circuit backup](/kb/docs/circuits-1-1-1-3-1-1-6#circuit-backup).

A circuit can have more than one **C****ircuit section**, and these sections may have different purposes and different routes. Connection reservations are made in the **Logical reservations** and **Physical reservations** sections. Read more in [Circuit sections](/kb/docs/circuits-1-1-1-3-1-1-6#circuit-sections).

Always remember to save your changes by clicking **Save**![save](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-zh3bd3uw.png)!

**Note!** Click![refresh](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-nd8676uh.png)to restore the original state of the fields for any information on the form that has not been saved.

### Redundancy and importance classification

Use the fields at the top section of the form to define **Redundancy** and **Importance** for a circuit. **Redundancy** and **Importance** values can be defined on the admin user’s administration site.

In the **Redundancy** field, you can choose whether the circuit has partial or full redundancy or no redundancy at all. Redundant circuits have back-up components that enable the functioning of the circuit, for example, in the event that a cable is damaged.

The **importance classification** is determined in accordance with the instructions provided by **Traficom** (Finnish Transport and Communications Agency). Components that belong to a public communications network or a communication service are classified according to type, geographic scope, and number of users. The importance classification ranges from 1 to 5. The more important the service is, the higher the number.

### Circuit customers

Click **Pick customer**![user_add](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-0o4ogacr.png)to open the **Customer![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-hxghl2a8.png)**form, on which you can add the customer data for the circuit. More information on the **Customer![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-hxghl2a8.png)**form is available in the chapter [Customer](/kb/docs/customer-1-1-1-3-1-1-6). Click **Clear customer**![user_delete](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-4px6ai3k.png)to clear the customer data for the circuit.

**TIP:** You can use the **Circuit** form’s **Customer number** and **Customer** fields as search criteria when you pick a customer. The **Customer![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-hxghl2a8.png)**form is opened, and it displays the data for a customer picked earlier or the customers matching the search criteria in the fields. If the fields are empty, the **Customer****![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-hxghl2a8.png)**form is opened without performing a new search.

### Related circuits

The **Related circuits![list_objects](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-n9dl8mbv.png)**list allows to view details of other circuits that have multi-use or shared connectors. The connections are identified through logical or physical reservations associated with multi-use connectors.

The list can be opened from the **Circuit** form **List****![list_objects](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-n9dl8mbv.png)**drop-down menu.

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

From the context menu of the list, the following actions are available:

- **Edit selected![table_go](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-4pqlyjdq.png)**opens the selected circuit in the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)**form for viewing or editing.
- **Compare selected![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)**opens selected circuits in separate forms, enabling side-by-side comparison.
- **Highlight selected![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1781690872868.png)**highlights the selected circuits.
- **Locate and highlight selected![arrow_in](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-4qq3dn06.png)**locates and highlights the selected circuits.

## Installation address

Circuit's installation addresses are added in the **Circuit location** section. If an installation address is not entered when a customer is added, the program will automatically select the customer’s address as the installation address.

You can manage added installation addresses on the grid through the **Address![address](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-2biecgm2.png)**form. To open it, right-click in the installation address row and select **Pick address![address](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-2biecgm2.png)**. For more information, see the [Address](https://support.keypro.fi/docs/address-3-1-1-3-1-1-6) chapter.

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

- To add a new installation address manually, right-click and select **Add new![add](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1l9h9wxj.png)**.
- To delete an installation address, select **Delete****![delete](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-v30qz1wr.png)**.
- To change the address type, double-click the **Type** field and choose the appropriate value.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1781617777759.png)
- Click **Save![save](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-zh3bd3uw.png)**on the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)**form toolbar to store your changes.

**TIP:** The fields in the **Installation address** section on the **Circuit****![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)**form can be used as search criteria after clearing the form. Double-click to activate the fields.

### Updating installation addresses from reservations

Installation addresses can also be updated automatically based on circuit section reservations. If a circuit contains multiple addresses or multiple circuit sections, and the first and last connection reservations differ between sections, multiple installation addresses are created as needed, with the address type **Beginning** and/or **End** assigned based on the differences between the reservations of the circuit sections.

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

1. Right-click in the list of circuit installation addresses.
2. In the context menu, select**![address](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-2biecgm2.png)****Update installation addresses from….**
  - **Logical reservations![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1781617960714.png)**
  - **Physical reservations![connect](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-5doou8du.png)**
3. The system will update the installation addresses according to the selected reservation type.

If the circuit already contains installation addresses, an **Installation address update** window is displayed when performing the update. You can choose to **Replace previous addresses** (existing addresses are removed and replaced with those from the selected reservations), **Add new addresses** (new addresses are added alongside existing ones), or **Cancel update** (no changes are made).

## Circuit sections

A circuit may have one or several **circuit sections**. The basic data in the circuit section includes **Name, Usage, Usage state, Construction state, Speed, Extra usage**, **Comments** and **Created By, Created At, Updated By, Updated At** and actual and planned dates for connecting and disconnecting. Each circuit section may have different purposes of use and different connection reservations.

- To create a new circuit section, click **Add section** from the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)**form's toolbar.
- To remove an existing section, click **Remove section** from the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)**form's toolbar.
- Click **Copy**![page_copy](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-htga11p4.png)to copy a circuit section.

**Note!** You must click **Save** to accept the adding and removing of circuit sections.

### 

### Circuit section list

To view all circuit sections of all circuits in the current search group select **Circuit section list![list_objects](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-n9dl8mbv.png)**from the **List**![list_objects](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-n9dl8mbv.png)drop-down menu. The **Circuit section list** can be used in cases when you need to gather details of circuit sections, such as name, usage, usage state, construction state, or speed.

### Circuit section columns

**To change the order of the circuit section columns,** point at a column header with your mouse, and drag it while holding down the left mouse button. You can modify the displayed columns by positioning the mouse cursor over a column header. This activates the menu. The **Columns** option displays a menu with functions for viewing and hiding columns. The selected columns and column widths are maintained when you browse through the circuits on the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-8bppcpar.png)**form.

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

### Updating connection details and setting connection length

In the circuit section, position the mouse pointer over a connection and click the right mouse button to open a menu in which you can find the function **Update connection details![pencil](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-wuu5tnce.png)****.** This function opens a form on which you can update the details of the connector reserved for the circuit. The updated information appears in the **Connection details** column.

Click **Set connection length**![pencil](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-7b9fq676.png)to open a form on which you can manually update the required length for the selected connection. The total length of connections is displayed in parenthesis on the header of the **Length** column.

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

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

Use the **Update lengths of connections from cables function![calculator_edit](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-h55ppss3.png)**to update the lengths of all the logical connections reserved for the circuit section based on the actual cable lengths. The program asks you to confirm the mass update of logical connections.

### Copying a circuit section

Take the following steps to copy a circuit section and its connections:

1. In the circuit section toolbar, select **Copy**![copy_connections](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-6lr9xzli.png).
2. Confirm the copying.

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

This creates a new tab in the circuit section. The tab is named. When a circuit section is copied, the name of the copy includes “_copy”.

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

### Splitting the connections in a circuit section

1. Select the connection starting from which you want to split connections to a new section.
2. In the context menu, select **Split to new section![cut_connections](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-aaehfzfi.png)**.
3. Confirm section splitting.

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

The new circuit section is named:

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

### 

### Change of circuit reservation

Sometimes there might be a need to change the existing circuit reservation, for example due to a faulty circuit, to use some other free **port/fiber** to make the circuit function again. With the **Change of circuit reservation![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-zfbv4n31.png)**functionality, you change the device port to some other port in the same device, or to a separate device located in the same telecom premises.

1. Activate the **Change of circuit reservation![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-zfbv4n31.png)**functionality from the **Logical connections** grid drop-down menu:![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1718872341894.png)
2. The **Cross-section![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-gm8oya8l.png)**form opens and the system automatically populates the selected device and connector information that was originally selected from the **Logical reservations** grid.
3. Right click the connector that you want to assign as the new replacement connector and select **Accept change of reservation![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1718802197149.png).** At this point, if you want to cancel the change, click **Cancel change of reservation![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1718803185433.png)**.**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1718802071674.png)**
4. After accepting the changes the system will allow to set the **c****onstruction state** of the replaced connector as **faulty**. ![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1718877794069.png)
5. The changes are applied into the **Logical reservations** grid in the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-8bppcpar.png)**form and the **Cross-section![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-gm8oya8l.png)**form will close.

Note:A permanent connection and related other end connections are treated as a one connection chain. When a permanent connection is changed, the related other end connections are also updated—up to the point where a cross-connection is encountered.

### 

### Viewing the components of a section in group display

View the components of a circuit section in **Group display** by clicking**![groupdisplay](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-tgxugrhk.png)****Show components of the section in group display**. Group displays are discussed in more detail in the chapter [Group display](https://portal.document360.io/#_Ryhm%C3%A4lista).

## Connection reservations for a circuit

A circuit consists of the points of connection (connectors) of the devices located in various telecom premises and the logical connections between them. However, highlighting a circuit also requires that the **physical connections** between the devices’ connectors have been digitized in KeyCom.

### Reserve a connection (connector)

1. To select a connector, click **Reserve connection**![C:\Users\jarkkai-1\Pictures\käyttöohje\image\add.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-y601lba2.png)to open the **C****ross-section![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-gm8oya8l.png)**form.
2. Pick the required **T****elecom premises![teletila](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-2wr2eci4.png)**to the form by using the **Pick![wand](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-5ydt4qg9.png)**tool.
3. Then, on the **Device****s / Cables** tab, select the device with the required connector.
4. After select the required connector on the **Connectors** list using the left mouse button, and click **Reserve to circuit**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-ptrl2w21.png)(the right mouse button can also be used for making the selection).
5. After this, the connector in question will appear on the **Logical reservations** list on the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)**form.

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

If one or several connection routes can be reserved for the connector that is being reserved, the route options are displayed on the circuit’s **Reservation of connections** form.

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

Before making the final reservation, you can highlight on the map the cables and telecom premises that are connected to connectors. To do this, click **Locate and highlight![arrow_in](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-zcfex6gr.png)**on the **Reservation of connections** form. This button is used to highlight the cable routes related to all connectors, as was the case with the highlight function in the circuit section on the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-8bppcpar.png)**form.

You can highlight a connection route only partially. To do this, select the required rows with the left mouse button while holding down the Ctrl key and, with the right mouse button, select **Highlight selected** or **Locate and highlight selected** in the menu.

To reserve the entire connection route, click **Reserve whole route**. If you want to reserve only a part of the route, select the required connection rows with the left mouse button while holding down the Ctrl or SHIFT key. Next, in the menu that opens when you click the right mouse button, select **Reserve selected**.

### Reserve a connection in telecom premises

You can also choose a connector on the **Telecom premises![teletila](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-2wr2eci4.png)**form.

1. Select **Reserve connection from telecom premises** on the **Circuit**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)form, in the drop-down menu for **Reserve connection![C:\Users\jarkkai-1\Pictures\käyttöohje\image\add.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-y601lba2.png)**. This opens the **Telecom premises![teletila](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-2wr2eci4.png)**form.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1770986317282.png)
2. On the form, open the telecom premises where the required connector is located.
3. Then, on the **Devices** tab, select the device with the required connector.
4. After this selection, go to the connector list of the **Telecom premises![teletila](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-2wr2eci4.png)**form and select the required connector using the right mouse button. Click **Reserve to circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-ptrl2w21.png)**.

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

When all the connectors of a circuit have been added to the circuit section, click **Create connections![connect](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-s0ku5sg0.png)**. The tool creates logical KeyNet connections between the listed connectors.

### Automatic route search

Use the **Automatic route search**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-qrgriapn.png)tool to automatically search for a logical route for a circuit. This function opens the **Automatic route search** form, on which you can search for routes between two telecom premises. Pick Telecom premises 1 and Telecom premises 2 on the form and then click Search to search for the possible routes that can be reserved for the circuit. Select the suitable route and click **Reserve to circuit**.

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

### Reserve based on a template

You can use a template circuit to reserve connections for a selected circuit section on the Circuit form . In practice, **Reserve based on template![circuit](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-ezj0sym7.png)** means that the function tries to find unreserved connections between the reserved devices of the circuit section that is used as a template. In the drop-down menu for **Reserve connection**![add](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-gjtmjzdn.png), select **Reserve based on template![circuit](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-ceaog6qf.png)**.

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

When you click **Reserve based on template**, a new **>Circuit form** is opened. The new **>Circuit** form is used for retrieving the circuit used as a template and for selecting the circuit section based on which connections should be reserved. At the bottom of the **>Circuit** form, click **Reserve template**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-dlq8rl5s.png)to have the program reserve any free connections it finds and add them at the end of the original circuit section. The **>Circuit form** is closed after this. The reserved connections are displayed in the circuit section of the original Circuit form. A text **Reserved Successfully** is displayed at the bottom of the form to confirm that the reservation based on a template has been successfully carried out. The **Information** tab will display the name of the person who updated the connection and the related date.

When all the connectors of a circuit have been added to the circuit section, click **Create connections**![connect](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-itughggk.png). The tool creates logical KeyNet connections between the listed connectors.

### Reserve parallel circuit

1. In the drop-down menu for the circuit section’s **Reserve connection**, select **Reserve parallel circuit**![arrow_divide](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-mao0lu31.png).
2. Enter the following information on the form that is displayed: the number of circuit sections with related connections that you want to reserve along the same circuit route and the number of threads/pairs between the reservation and the connections of the original section.
3. If you want to reserve the parallel connectors in one circuit section, select the **Reserve in current section** checkbox. By default, all reservations are made in separate sections.

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

When all the connectors of a circuit have been added to the circuit section, click **Create connections**![connect](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-mjl13zl5.png). The tool creates logical KeyNet connections between the listed connectors.

### Reserve using physical connections

The drop-down menu for **Reserve connection** includes the option **Reserve using physical connections** if physical reservations have been made. Logical reservations are made based on physical reservations. Further information on physical reservations and circuits is available in the [Making physical network reservations](/kb/docs/circuits-1-1-1-3-1-1-6#making-physical-network-reservations) chapter.

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

### Making physical network reservations

It is also possible to make physical network reservations for a circuit. You can find the **Physical reservations** tab next to the **Logical reservations** tab on the **Circuit** form. There are three alternative ways to make physical reservations: 1) reserving single threads, 2) making reservations based on route following and 3) automatic reservations based on logical reservations. You can find the options in the drop-down menu for **Reserve connection**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-nu4jzozi.png):

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

1. ![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-8ael4zij.png)**Reserve connection from cable threads:** This function opens the **Cable** form. In **Tools**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-xa6w2myq.png), select **Thread details**. On the displayed form, click the thread row with the right mouse button and select **Reserve thread to circuit**. The thread you selected is now linked to the connection and visible on the **Physical reservations** tab.
2. ![https://stage.keycom.keypro.fi/static/keyrns_core/image/object_search.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-z7a168qb.png)**Network** **follower:** This function opens the **Route follower![https://stage.keycom.keypro.fi/static/keyrns_core/image/object_search.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-z7a168qb.png)**form. Click **Start trace** to find the route for the thread or connector you selected. The list of route objects includes the network elements related to the selected thread or connector. To select the required row or rows for the circuit, click the right mouse button and select **Reserve selected to circuit** or **Reserve all to circuit**. Further information on **Route follower** is provided in the chapter [Route follower](/kb/docs/route-follower-1-1-1-3-1-1-6).
3. ![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-pbxcpch2.png)**Reserve using logical connections**: This function is available if logical reservations have been made for the circuit. In this case, the physical connection will be reserved based on logical connection reservations.

**Note! Reserve based on template** and **Reserve parallel circuit** are not available for making physical network reservations.

After making the physical connection reservations, you can view your reservations on the **Physical reservations** tab. The columns display various kinds of information such as the identification of telecom premises, device and cable, as well as reserved threads with colour codes and construction state. The **Connection state** column displays a symbol illustrating the connection state.

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

**Connection state:**

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-nllj9w9x.png)**OK**: Connections are in order. The connector/thread on the row has no unnecessary outside connections in addition to the physical connections reserved for the circuit.

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-tiub1f49.png)**No connection reserved**: There is a connection between the connector/thread on the row in question and the subsequent row, but it has not been reserved for a circuit.

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-xvs9hh3v.png)**Deviating connections**: The connector/thread on the row in question has connections to external objects, which cause conflicts.

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-wv80w3ak.png)**No cable level connection**: There is no cable level connection for the connector/thread on the row in question and the subsequent row (there is no cable between the telecom premises, or there is a cable between them, but its thread/connector has not been connected at the cable level to the same object as the other thread/connector).

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-a4o2vrt1.png)**No thread connection/no cross-connection/no internal connection:** A thread connection, cross-connection, or an internal connection is missing for the thread/connector on the row in question and the subsequent row.

### Removing reservations

Both physical and logical reservations can be removed from a circuit by selecting the physical or logical connection row and clicking **Remove reservation![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-nz017ydk.png)**. You can also select multiple rows at once by holding down the Control or Shift key.

### Faulty components when reserving a connection

When attempting to **reserve a connection** that includes connectors or threads that are in **Faulty, P****lanned**, **Under construction**, or in any other non‑operational state, the system displays the **Components requiring special attention** dialog. It alerts you that one or more component may affect the reservation.

The dialog also lists all the connectors that have logical connections to faulty connectors. For example, an entry **A‑1‑1‑1 <> 1** would appear on the dialog because **Connector 1** has logical connection to **Connector A‑1‑1‑1**.

Right‑clicking a row in the grid opens a drop‑down menu that provides an access to the **Telecom premises![teletila](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-2wr2eci4.png)**, **Device![terminal](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/teletila-image-rqw5wd32.png)**, and **Connections management![connect](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-a59mo9go.png)**forms.

Review or take action on the listed components and decide whether to **Continue** or **Cancel** the process. Click **Refresh** to update the dialog with the latest information.

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

The columns contain information about each affected component:

- **Type:** Indicates the type(s) of the component.
- **Identification:** Shows the identifier(s) of the component(s) requiring attention.
- **Device hierarchy:** Displays the component’s location within the device structure.
- **Thread/Connector:** Identifies the connector(s) or thread(s) involved.
- **Construction state:** Indicates the construction state.

## Reserving a provisioning port automatically

The toolbar on the Circuit form includes the **Reserve provisioning port**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-oynx3640.png)button. This function checks a circuit section’s purpose of use, the installation address of a circuit, and, based on the service availability saved in the system, the provisioning port. It also reserves the port if it finds one. Devices that belong to the provisioning port class can be defined on the admin user’s administration site. Automatic reservation of a provisioning port is made either at the beginning of a connection chain or for a new circuit section. This function notifies the user if no installation address or purpose has been selected for the circuit section.

**There are three ways to search for service availability for circuits that are pre-connected, partially pre-connected or in use:**

**Option 1.** Determine the installation addresses of a circuit sorted according to the **installation addresses** type. Search the database primarily for the best possible **pre-connected** item based on installation addresses. As a secondary option, search for the best possible **partially pre-connected** item. The best possible option is such that it provides a provisioning port that fulfils requirements. The second-best option does not directly provide a provisioning port, but there is one that can be used through a cross connection. The third-best option does not directly provide a provisioning port, but one can be found somewhere on the telecom premises for the **pre-connected** item (primarily those that are actually free). If no route fulfilling the conditions listed above can be found for the circuit, a device with similar device technology is located on the telecom premises at the circuit’s installation address, and the first available provisioning port of that device is reserved.

**Option 2.** The provided address is used as a criterion to search for point availability (telecom premises at the given address are searched). A device with similar device technology as the product’s technology is located on the matching telecom premises, and the first available provisioning port of that device is reserved. The line length of the product is compared to the distance between the addresses of the customer and the telecom premises. The distance between addresses is calculated using Digiroad-based road network data and by following the road network.

**Option 3.** The provided address is used to search for area availability to determine whether the address is within some pre-defined service area. A device with similar device technology as the product’s technology is located in the matching device or telecom premises, and the first available provisioning port of that device is reserved. The line length of the product is compared to the distance between the addresses of the customer and the telecom premises. The distance between addresses is calculated using Digiroad-based road network data and by following the road network.

## Create connections

On the **Circuit![connect](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-rtemwrqw.png)**form, click **Create connections** to create or reserve the required cross-connections and internal connections. If there is a cross-connection between connectors, it is reserved for the circuit. If there is no cross-connection, this function creates a cross-connection and reserves it for the circuit. By default, only cross-connections and internal connections can be created in the system. Logical connections cannot be created.

## Complete the circuit

Use the **Complete circuit**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-j7exyayb.png)function to mark the circuit and its connections as **Completed**. When you click **Complete circuit**, you will be asked: **Are you sure you that you want to complete circuit?** After confirming this, the circuit’s Usage state is **In use**, and its Construction state is **Ready**.

### Additional settings for the completion of circuits

When completing a circuit, you can ensure, for example, that reservations are not removed by default from **GPON** and **Cable TV** circuit types for connectors that have been reserved for the circuit that is to be completed. Cable TV and GPON are so-called **Point-to-Multipoint** circuits, which typically have several circuits that reserve the same connection route all the way up to the splitter device.

When completing pre-connected VSDL-type (Point-to-Point) circuits, you can disconnect all reservations for connectors that have been reserved for other pre-connected P2P circuits. At the same time, the **Usage state** of these circuits is determined to be **“Free”** and the **Construction state** “**Faulty**”. **Point-to-Point** circuits typically function so that each circuit uses a separate connection route from the exchange all the way to the customer.

The settings related to the purpose of use of the circuit section are defined by admin users on the admin site.

### Connection direction

In the circuit section’s toolbar, click **Reverse connections![C:\Users\jarkkai-1\Pictures\käyttöohje\image\arrow_rotate_anticlockwise.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-vytve3an.png)**to reverse the order of connection reservations. This function reverses the order of reservations in the circuit section.

## Saving a circuit

When a circuit is **Saved**![save](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-zh3bd3uw.png), information on the person who updated it and the date of updating is maintained even when changes are made, for example, to circuit sections, the connections reserved for a circuit, additional usage or the attachments related to the circuit.

### Saving a circuit in case of multi-use / shared connectors

When a circuit is **Saved**![save](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-zh3bd3uw.png), the connector reservations related to other circuits are taken into account, and the states of the reserved components are taken into account in the following cases:

- Saving the construction state of a circuit section as **Ready** updates the construction state of the components (connectors and connections) related to the circuit section as **Ready**.
- When the usage state of a circuit section is saved as **Free**, **Pre-connected**, **or Partially pre-connected**, it is checked whether some other circuit with the status **In use** or **Soon in use** has reserved the same components. If the components reserved for the circuit have been reserved for some other circuit with the status **In use** or **Soon in use**, you will be asked the following question: **Do you want to remove connections that are reserved by another circuit with state “In use” or “Soon in use? Select the circuits/connections to remove the overlapping reservation from and press Confirm. If nothing is selected the circuit is saved without removing any overlapping reservations. Press Cancel to abort saving.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1781699147829.png)**
- When the usage state of a circuit section is saved as **In use**, **Soon free,** or **Soon in use**, whether some other circuit with the status **Free**, **Pre-connected,** or **Partially pre-connected** has reserved the same components is checked. If the components reserved for the circuit have been reserved for some other circuit with the status **Free**, **Pre-connected,** or **Partially pre-connected**, you will be asked the following question: **Do you want to remove overlapped connections from other circuits with state “Free”, “Unused”, or “Partially unused”? Select the circuits/connections to remove the overlapping reservation from and press Confirm. If nothing is selected the circuit is saved without removing any overlapping reservations. Press Cancel to abort saving.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1781698352353.png)**

## Deleting a circuit

When a circuit is **Deleted**![cross](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/buttons-on-object-forms-image-v5xf9hbf.png), the following is considered:

- Whether or not the usage state of all the circuit sections of the circuit is **Free** is checked. If not, the following notification is displayed: **Circuit cannot be deleted since saved usage states of all sections are not "Free".**
- The system checks that other circuits are not using the circuit. If they are, the following notification is displayed: **Circuit cannot be removed since it has subcircuit(s).**

## Backup circuits

You can set **Backup circuits** for the **Primary circuits** in KeyCom environment. In the middle of the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-4jh64x3a.png)**form, there is the **Backup circuit** column. The info of the backup circuit will appear there.

Start by right-clicking an empty section and then click **Link backup circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-g4bndkro.png)**. This will open a new >**Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-l79yffxi.png)**form, in which you can add the necessary info. Choose **Use as a backup circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-8u3u9ig6.png)**in the toolbar. It is located at the bottom right corner of the **>Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-l79yffxi.png)**form. This will assign the selected backup circuit to the primary circuit in question.

**You will find the following columns in the Backup circuit section:**

1. Primary circuit
2. Primary circuit section
3. Backup circuit
4. Backup circuit section
5. Backup ruleset (A list showing the rules that can be set for each environment). **Note! Double-click the section to open the dropdown menu to choose a rule.**

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

### Functions of the context menu

You can find all functions of this feature in the context menu Open it by **right-clicking** the column after you have added a **Backup circuit**.

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

1. **![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-hj0sjrgs.png) Edit selected:** Open a circuit on a backup circuit form and edit it.
2. **![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-2f20ycmm.png) Open selected (list):** Open the primary circuit and the selected backup circuits (with circuit sections) into a separate circuit section list.
3. **![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-ivbsvi1s.png) Unlink backup circuit**: Unlink a backup circuit from a primary circuit.
4. **![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-lq8wqact.png) Link backup circuit:** It links a backup circuit to a primary circuit. If the selected circuit is already linked to a primary circuit, this action is not available.
5. **![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-9e18qqvd.png) Swap to primary:** Swap the selected backup circuit a primary circuit and make any changes related to the existing relationships between other primary and backup circuits**.**
6. **![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-7lgjo2zc.png) Validate selected:** Validate the rules for the selected backup circuits in relation to the primary circuit.
7. **![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-embk6vl2.png) Highlight:** Highlight the selected circuits on the map in the default highlight color (blue) based on the components assigned to the circuits.
8. **![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-l57vpluh.png) Locate and highlight:** Locate the selected circuits on the map and highlight them in the default highlight color (blue).

### Backup circuit section list

Open the **Circuit sections** list by clicking the **Open selected (list)![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-qptp719r.png)**from the **Context menu** or in the submenu of the **Circuit**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-l79yffxi.png)form. The list shows both the primary circuit and the backup circuit with the selected circuit sections. The **Circuit section list** will be automatically populated based on the search set of the **Circuit**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-by39rhtw.png)form with all basic information of the circuit section.

If the link between **primary/backup circuit** was not originally made at the circuit section level, the **Circuit section list** will show both the primary and the **backup circuit** with all circuit sections and their basic information.

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

### Grouplist display list options

When you choose to show all the components on **Group display list![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-7qa110ws.png)**you can also decide whether you want to show common components only or not. First, select **multiple** circuit sections in the **Circuit section list** to open the **Grouplist options** window. To select multiple rows, hold down **Shift** on the keyboard while selecting the rows. Then right-click and click **Show components of the circuit in group display![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-7qa110ws.png)**.

- **Show only common components**: Lists all telecom premises and cables that can be found in the logical and physical reservations for all selected circuits/circuit sections.
- **Backup circuit ruleset**: Activates a selection list where the user can select environment-specific configured backup rules. Read more about the [Backup circuit rulesets](/docs/circuits-1-1-1-3-1-1-6#_Backup_circuit_ruleset).

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

### Backup circuit rules

It is possible to set up environment-specific **Backup rules** for validation in the **Circuit backup rule manager**. The **Backup circuit ruleset** function opens a list where you can choose rules for the **Backup circuits**. You can access these rules in two different ways:

**Option 1:** Double-click the field under the **Backup ruleset** section on a **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-l79yffxi.png)**form to open a drop-down menu.

**Option 2:** Open [Grouplist options](/docs/circuits-1-1-1-3-1-1-6#_Grouplist_options).

### Managing circuit backup rules

To manage the circuit backup rules, click the **Manage circuit backup rules![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-2zgyzbgw.png)**tool on the toolbar of the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-6vm0tstj.png)**form. Using this tool, you can create or choose preconfigured rulesets for the backup circuits.

To create a new circuit backup rule, click **Add new**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-emkcmqks.png)in the **Available rules** field. It will open a **Create circuit backup rule** form. Specify a label for the rule and choose the rule type.

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

You can also create a new rule type by clicking **Add new**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-o5yi8srh.png)on the **Create circuit backup rule** form. When creating a new rule type, you must at least fulfil the **Rule** function and **Txt** fields. Click **Save![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-e177vhw3.png)**to save your work and return to the **Create circuit backup rule** form where you can now select the rule in the dropdown menu. When you click **Save![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-sjbgy2de.png)**, the new **Backup rules** can be found in the **Available rules** section.

To activate a **Ruleset** on the **Circuit**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-29ihj0r8.png)form, click **Add new![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-e1adx4zq.png)**or choose a pre-existing **Ruleset** in the drop-down menu. To move rules from the **Available rules** field to the **Selected rules** field, right-click the rule(s) that you want to add. Then click the arrows in the middle of the form, depending on which direction you want to move the rule between the fields.

**Read more** about activating **Backup circuit rulesets** on the **Circuit**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-ckbjkwja.png)form in [Backup circuit rules](/docs/circuits-1-1-1-3-1-1-6#_Backup_circuit_rules).

## Sub-circuits

You can view sub-circuits on the Sub-circuit form. On the **Circuit**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png), click **Sub-circuits![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-ny8k6lho.png)**to open the sub-circuits of the selected circuit. This function opens a circuit-type form that displays basic information on the selected circuit, such as identifier, name of the circuit section, usage, speed, time slot, and comments. The parent circuit’s identifier is displayed in the header of the sub-circuit form.

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

You can activate a circuit/circuits selected on the sub-circuit list and open them on the **Circuit** form by clicking the right mouse button and selecting **Edit selected**.

You can locate/highlight the selected sub-circuits on the list and define the highlighting colour as was the case with the circuit list. In the **Reports** menu of the sub-circuit form, you can print a list report and a report on a circuit’s sub-circuits.

### Creating sub-circuits

You can reserve a sub-circuit for a circuit and define the time slot applied to the circuit route. To reserve a sub-circuit, start by creating a **new circuit** and click **Reserve connection**![add](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-3oqo415g.png)on the **Circuit**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)form. **Cross-section** form is displayed, on which you can select the required telecom premises, device and connector that is used for creating a sub-circuit for the circuit to be reserved. Click **Reserve circuit**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-gx7rrhpu.png)to open the **Circuit reservation** form. The form displays the connection chain of the circuit that is to be used as the sub-circuit, and displays the connectors reserved for the circuit in separate menus.

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

On the **Reservation of circuit** form, select the start and end points. The connection chain between them is reserved for the circuit. Enter the time slot applied to the sub-circuit. Click **Reserve to circuit** to reserve a sub-circuit for a circuit. The sub-circuit is now displayed on the connection list for the circuit section. The first and last component (start and end points) and the time slot of the circuit reserved as a sub-circuit are displayed.

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

You can update the time slot reserved for a circuit. Click the right mouse button over the **Time slot** row and select **Update time slot**.

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

This opens the **Enter time slot** menu, in which you can enter the new value.

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

Click **Update** to save the time slot for the sub-circuit, or click **Cancel** to cancel the action.

## Circuit diagram

You can create a **Circuit diagram**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1c3fyt4t.png)of the connections reserved by the circuit. This diagram is created based on your selections.

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

**Circuit diagram settings:**

- **Show logical reservations**: Illustrates the circuit’s logical reservations in a diagram.
- **Show physical connections**: Illustrates the physical network between the logical reservations.
- **Show sub-circuit connections**: Illustrates the sub-circuit connections of the sub-circuit that the circuit uses.
- **Show physical reservations**: Illustrates the circuit’s physical reservations in a diagram.
- **Combine parallel connections**: Combines the physical reservations of one circuit into one diagram, when the entire reservation chain is parallel (the diagram displays, for example, connectors 1–3 as numbers instead of three diagrams).
- **Hide direct splices:** Direct splices between cables are hidden in the diagram.
- **Generate based on selection**: Creates a circuit diagram based on the reservation rows you have selected.

You can also define the **default width** of the diagram.

After you have defined the diagram settings, click **OK** to view the **Circuit diagram** form. The diagram also includes more detailed information on the identifiers and addresses of telecom premises, as well as information on the colour coding of cables and their usage state.

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

### View all circuits in a diagram

In the drop-down menu for **Circuit diagram**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-xjtaga6y.png), click **Show all circuits in diagram![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-w2cozzhx.png)**to create a circuit diagram based on multiple circuits. This function creates a diagram of all the circuits that have been retrieved to the form.

### Display selected in a diagram

You can select the required circuits for the circuit diagram from search results. When several circuits have been retrieved to the **Circuit** form, click **Show in list**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-8u5x5vza.png). In the displayed dialogue box, select the circuits that you want to include in the diagram. When a row is selected, click the right mouse button and select **Open selected on diagram![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-3c7qiwno.png)**.

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

In the displayed **Circuit diagram options**, define your settings and click **OK** to create a diagram.

## Reports

You can create various reports from the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-8bppcpar.png)**form, for example, circuit reports, bill of materials, and work order reports.

### Circuit report

You can create separate reports on a circuit section’s logical and physical connections.

Click **Reports![report](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-3mouut23.png)**to open the **Circuit section’s connections** dialogue box. Select either **Logical reservations** or **physical reservations** as the report type. Based on the reservation type, a circuit report will be created with logical or physical reservations and their start and end points.

### Bill of materials

Use the **Bill of Materials** function in the **Reports![report](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-6sc44pfw.png)**menu to create a bill of materials for the circuit’s connections. The bill of materials lists all network elements that the circuit is using. You can save the report as a file or open it directly in Excel. The components included in the bill of materials can also be saved in Finnish **VerkkoGML** format by using the **Export** function. Exporting to Finnish VerkkoGML is described in more detail in the chapter [Exporting to VerkkoGML](/kb/docs/exporting-and-importing-1-1-1-3-1-1).

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

### A work order report

You can print a **Work order** for the circuit through the **Reports** menu. A **work order report** is a report on the circuit’s logical and physical reservations in either Excel or PDF format. On the Work order report options form, you can define the logical and physical reservation information that you want to include in the **extended work order**:

1. **Abnormal** reservations and reservations **to be deleted**
2. Cable information
3. Additional diagram information and map extract If you select the **With map** checkbox, the printout will include an additional page with the circuit highlighted on the map.
4. Physical reservations diagram

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

## Error history for a circuit

You can activate the circuit error history function in the toolbar of the **Circuit** form. Click **Circuit error report**![script_lightning](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1f1pjsjz.png)to open a new form for entering the error history of the circuit.

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

On this form, you can enter information on the error type, state, creator, and creation date as well as provide more details as free-form text. These fields can also be used as the search criteria for the form. In addition, the header of the form displays the identifier of the circuit that the error is related to. Click **Show in list**![text_align_justify](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-qh8eqv1i.png)to open the Circuit error history list for the circuit in question.

The **Circuit error history** form is by default pre-populated with the error history details related to the circuit and organised by creation date, error type, and state. You can search the form based on this information. For example, you can retrieve all errors of the circuit based on type. Click **Clear**![page_white](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1uvvopys.png)to clear all information on the Circuit error history form. Click **Save![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-d7tebb87.png)**to create a new error history row and to update existing information. Click **Delete![cross](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-r8899k9z.png)**to delete the selected error history detail.

## Change history of a circuit

To view the change history of a circuit, select **Change history**![clock_edit](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/buttons-on-object-forms-image-9cz37v06.png)in the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)**form's toolbar. The top section of the displayed form lists the various circuit versions, while the bottom section displays the changes made to the selected version.

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

### Restoring the values of an object

1. In the **Versions** section, select the row that you want to restore.
2. In the **Changes** section, select the checkboxes for the rows that you want to restore.
3. Click **Restore![update_to_form](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/buttons-on-object-forms-image-zcwsctik.png)**to update the selected information on the object form.
4. Click **Save form![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-d7tebb87.png)**on the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-1asw50rt.png)**form to confirm the changes.

Click **Refresh**![refresh_map](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/map-view-image-2rxb6uwk.png)to update the view with the latest background changes.

### Comparing object versions

In the **Versions** list, select the rows for comparison to see, in the **Changes** list, the current version in addition to the selected versions.

## Supercircuit

## 

The **Super circuit** form provides a way to collect multiple circuits under a single group. The **Super circuit** form is available from the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-29ihj0r8.png)**menu on the main **KeyCom toolbar**.

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

The **Super circuit** form allows to:

- Group several related circuits into one managed group
- Summarize circuit information using lists
- Locate and highlight super circuit routes across the map view
- View reservation details for the first and last reserved objects

**Note!** A Super circuit form does not create new circuits to the system and is only used to group existing circuits.

### Creating a super circuit

1. Open the **Super circuit** form from the main toolbar under the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-29ihj0r8.png)**menu.
2. In **Information** tab:
  1. Enter the **Identifier** for the super circuit.
  2. Select the **Type**.
  3. Select the **Usage state**.
  4. Select the **Network type**.
  5. Add comments if needed by switching to **Comments** tab.
3. Click **Add circuit** from the toolbar.
4. **Search![search](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/buttons-on-object-forms-image-y2qagq6d.png)**or **Pick![wand](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/buttons-on-object-forms-image-2y9mpqgs.png)**a circuit on the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-29ihj0r8.png)**form.
5. Click **Update to form**![update_to_form](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-u13luorz.png)on the **Circuit![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-29ihj0r8.png)**form's toolbar.
6. Repeat the action and add all required circuits.
7. Verify all circuits and related information in the **Circuit****s** list.
8. Review **The first and last reserved component** section to confirm that system has correctly identified the network objects and check the automatically calculated totals:
  1. Total number of sections
  2. Total number of fibers
9. **Save![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-sjbgy2de.png)**the super circuit.

### Managing super circuits

The **Super circuit** form provides tools for reviewing all circuits included in the super circuit and understanding how they are connected across the network. This includes both the **Circuits** list and the automatically generated **The f****irst and last reserved component** section. If logical or physical reservations exist, the total number of sections and fibers are presented in **Total number of sections** and **Total number of fibers** fields.

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

**Note!** If a connection listed in the **Connections** grid is marked with a symbol![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1774446769513.png), the system indicates that two consecutive connections in the list are linked to the same telecom premises. This means that at least one of the endpoint reservations (logical or physical) of both connections (either the first or the last reservation) is allocated to the same telecom premises.

#### Context menu tools

Right‑clicking a circuit in the **Circuits** list opens a context menu with tools for editing, highlighting, and organizing circuits:

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

- **Edit selected** – Opens the circuit in its own form.
- **Highlight selected** – Highlights the circuit on the map in the chosen color.
- **Locate and highlight selected** – Moves the map to the circuit’s location and highlights it.
- **Add circuit** – Opens the **Circuit****![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-29ihj0r8.png)**form.
- **Remove selected circuits** – Detaches circuits from the super circuit without deleting them.
- **Move circuits up / down** – Reorders circuits and updates order numbers.

All related circuits can be highlighted at once by clicking **Locate and highlight selected![arrow_in](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/buttons-on-object-forms-image-f8vev3bo.png)**from the **Super circuit** form's toolbar.

#### Editing a super circuit

1. **Search![search](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/buttons-on-object-forms-image-y2qagq6d.png)**a super circuit on the form or **Pick![wand](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/buttons-on-object-forms-image-2y9mpqgs.png)**a related circuit from the map.
2. Next, review and edit the **Information** fields as needed.
3. In the **Circuits** section, use the toolbar or right‑click menu to:
  1. Add circuits
  2. Remove circuits
  3. Reorder circuits
4. Verify that the **The f****irst and last reserved component** section has updated automatically based on changes to the **Circuits** list.
5. When all changes are complete, click **Save![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keynet-tools-image-sjbgy2de.png)**to store the updated super circuit.

#### List view

The **Show in list![list_objects](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/buttons-on-object-forms-image-pmsd3gko.png)**drop-down menu provides two different kind of list views:

- The **Network objects of super circuit![list_objects](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/buttons-on-object-forms-image-pmsd3gko.png)**list displays all network objects related to the circuits in the super circuit.
- The **Extended network objects of super circuit![list_objects](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/buttons-on-object-forms-image-pmsd3gko.png)**list **displays** information about all network objects reserved for the related circuits in logical or physical reservations, with the details of the infrastructure that is used by the reserved network object.

## KeyCom service availability and scheduled CSV batch runs (This function is subject to a separate order)

The system can generate service availability information as separate scheduled CSV files. The basis of service availability information is always the address and property data. This data can be produced using five different methods:

1. KeyCom service availability based on connection residential addresses
2. KeyCom service availability based on the address
3. KeyCom service availability based on service areas
4. KeyCom service availability based on telecom premises addresses
5. KeyCom service availability based on potential availability