---
title: "KEYCOM OBJECT FORMS"
slug: "keycom-object-forms-15-1-1-3-1-1"
updated: 2026-11-03T11:41:23Z
published: 2026-11-03T11:41:23Z
canonical: "support.keypro.fi/keycom-object-forms-15-1-1-3-1-1"
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.

# KEYCOM OBJECT FORMS

| **KeyCom tools** | ![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-7owraix0.png) |
| --- | --- |

## Object types

Telecommunication networks consist of point objects, line objects, area objects, and other objects. You can use the following buttons to open the object forms for managing point objects:

- **Telecom premises**![teletila](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-9rvgh48d.png)
- **Device**![terminal](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-8ap9lo2s.png)
- **Splice**![jatkos2](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-4hs40e9k.png)
- **Pole**![pole](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-6lcyxd98.png)
- **Manhole**![manhole](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-x0xdnglc.png)
- **Point object**![point](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-msx6mgzl.png)

You can use the following buttons to open the object forms for managing line objects:

- **Cable**![cable](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-vl82dev2.png)
- **Conduit**![conduit](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-xkku8emp.png)
- **Duct**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-woyzqoyd.png)

**Area objects** include:

- **Service area**![servicearea](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-vfoo1iz4.png)
- **Exchange/Telecom area**![telecom_area](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-ly7apxod.png)
- **Other objects** include:
- **Radio link**![radiolink](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-srtc5zbe.png)
- **Route follower**![object_search](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-pxtknt6i.png)
- **Connections management**![connect](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-m5juzl2p.png)

The **functions and information content** on the forms are the **same**, meaning that objects are handled in the same way, but the object form is different for each object. **Depending on your user privileges**, you can, for example, search for objects based on search criteria, modify their location and property values, and locate them on the map. The button functions related to forms used for managing objects are introduced in the chapter [Buttons on object forms](/kb/docs/buttons-on-object-forms-6). Some object forms include buttons that have functions not available on other forms. These functions are introduced in this chapter after providing instructions applicable to all forms.

## Property attributes

The main difference between various forms is the data that is entered on them. For poles, for example, you can add information on the impregnation method and decay class. Regardless of the applicable type and object form, objects have **similar property attributes**. Such information is related to the object owner, its properties, location, area, and plan.

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

The information content of forms for service areas and point type objects is less extensive than the content of other forms. On the Service area form, you can create and view service areas, while the form for point objects can be used, for example, for handling traffic signs.

If you want to create a new object, **Type** and **Usage state** are usually mandatory fields. The system can automatically create an identifier for new objects if this feature has been activated in the system settings. For **cables,** the mandatory fields are **Installation type**, **Usage state**, and **Type**. When you create a new cable, information on its length and measurement method are automatically updated in addition to the identifier.

After entering the mandatory data, click **Create**![line_add](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-4fypj9ij.png)to create the object on the map. When the object was created successfully, the following text is displayed at the bottom of the form: **Saved successfully**. You can then update other property values for the object and save them in the system by clicking **Save form**![save](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-mwywq95v.png).

The property values that can be defined vary depending on the object. For example, you can enter information on a pole’s stanchion and material. You can enter the following information for all objects: owner, renter, and installation year. In addition, you can freely include text in the extra data section.

The **Common settings** tab is the same for all objects. On this tab, you can enter information on mapping and its accuracy, in addition to which the tab includes fields for the mapper and the person who updated the data. This information is automatically saved in the system, and it cannot be edited.

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

## Rental contracts

The **Rental contracts** tab is used for handling rental agreements related to the object. If the object on the form has been connected to a rental contract, the number of contracts is displayed in parenthesis after the name of the tab. More information on **R****ental contracts**![https://stage.keycom.keypro.fi/static/keyrns_core/image/script_edit.png](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-faq2tb8y.png)can be found in the chapter [Rental contract](/kb/docs/rental-contract-1-1-1-3-1-1).

The form includes a list of rental contracts. To open a **Rental Contract** form with the required contract information, select the contract using the right mouse button and click **Open contract**![show_in_form](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-ee668uau.png).

## Extra data

You can define free-form property attributes (Extra data) for the following forms: **Cable, Conduit, Telecom premises, Pole, Manhole, Splice, Point object, Exchange/telecom area, Service area**, and **Plan**. If free-from property attributes have been defined, they can be viewed on the **Extra data** tab of the object forms.

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

You can use the free-form property attributes when searching for objects, and they can also be included in the **List![text_align_justify](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/buttons-on-object-forms-image-hi28t8cx.png)** function and the related report.

### Defining extra data attributes

You can define free-form property attributes in two ways:

1. In the **Extra data![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1792054947050.png)**form that open from the main toolbar.
  - Open the **Extra data![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1792054947050.png)**form and fill in the **Basic information**:![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1792052288825.png)
    - **Object Type**: the object type whose form the extra attribute is added to.
    - **Name** and **Description**: the name and description of the attribute.
    - **Type**: the data type of the attribute: **Alias**, **Float**, **Integer**, **Link**, **Multiple Choice**, **Multiple line Text**, **Read-only** or **Text**.
    - **Order**: the position of the attribute on the **Extra data** tab.
  - **Save**![save](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-rz14o1r2.png)the attribute. It then appears on the **Extra data** tab of the selected object type’s form where a value can be added.
2. **As an admin user:** The admin user of the system can freely define the free-form property attributes, name them, and select their data type (such as text, figure, and date). The admin user can also add fields marked as set to **Read only**. Such fields cannot be viewed by other users.

For more information, see the chapter [Freely defined extra data](/kb/docs/freely-defined-extra-data-3-1-1-1-1-1) in the KeyCom Admin Guide.

### Multiple choice menu

When you select **Multiple Choice** as the **Type** on the **Extra data**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1792054947050.png)form, an **Enum group** field appears. The **Enum group** holds the values that are shown in the multiple choice drop-down menu on the object form. You can select and existing group from the **Enum group** drop-down menu or create a new group by clicking **New group**.

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

#### Creating a new group

1. On the **Extra data![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1792054947050.png)**form, select **Multiple Choice** as the **Type**.
2. Click **New group** next to the **Enum group** field. The **New enum group** window opens:![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1792064248036.png)
3. Enter a **Name** for the group.
4. Click **Add![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-dgibo0ik.png)**to add a row to the list, and type the in the value or text. Repeat for each choice you want in the dropdown. To remove a value, select it and click **Delete![cross](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/buttons-on-object-forms-image-v5xf9hbf.png)**.
5. Click **Save** when all the values needed are added.

Back on the **Extra data** form, check that the new group is selected in **Enum group**, and **Save**![save](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-rz14o1r2.png).

### Value tab

The **Value** tab of the **Extra data** form lists the values that have been entered for the created attribute on the object forms.

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

- You can filter the list with **Search Value** and clicking **Search![search](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/buttons-on-object-forms-image-mtcj53na.png)**.
- Open selected value on form by clicking **Open selected on form**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1792053436491.png).
- Delete selected value from the object by clicking **Delete**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1792053483197.png).
- Click **Add![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-dgibo0ik.png)**to open the object form which the attribute has been assigned to.

## Attached documents

On the object form’s **Attachments** tab, you can view documents attached to the object. The header of the tab indicates the number of attached documents for the object. The attachments can be **files** or **URL links**, and they are listed based on type. If the object form does not have any external documents, the **Attachments** tab includes no information.

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

### Viewing attached documents

Click the name of an attached document to open it for viewing. If the attachment is a **URL link**, it is opened on a new tab in your browser. For files, the functions depend on your browser and browser settings. Usually, the browser asks by default whether you want to save or open the file.

Select **Download all as zip**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1724236890972.png)to download all attachments to your device.

### Editing the information in attachments

1. On the list, select the attachment you want to edit.
2. Click **Edit**![show_in_form](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-lq4ayc5g.png)to open the information on the attachment on the **External documents**![documents](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-nawou7dy.png)form (see [External documents](/kb/docs/external-documents-2-1-1)).
3. Edit information.
4. On the **External documents**![documents](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-7oupi948.png)form, click **Save form**![save](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-rz14o1r2.png)to save your changes.

**Note!** The information included in the attachment is updated on the **Attachments** tab only when the object form data is reloaded.

### Adding an attachment

1. Click **Add**![add](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-szol4b8e.png)to open the **External documents** form (see [External documents](/kb/docs/external-documents-2-1-1)).
2. Choose a document or add a new one (see [Adding external documents](/kb/docs/external-documents-2-1-1)).
3. Click **Attach document**![update_to_form](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-xk65xwws.png).
4. If you want to attach more than one file, go to the drop-down menu for **Attach document**![update_to_form](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-2au2arwe.png)and select **Attach selected documents.**

**TIP**: If the document you want to attach has no location, you will be asked whether you want to use the same location as the object you want to attach it to.

### Removing an attachment

1. On the list, select the attachment you want to remove.
2. Click **Remove![delete](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keycom-object-forms-image-3nz31414.png)**.

The attachment is removed from the object in question, but the document is not completely deleted. You can retrieve it and delete it from the system using the **External documents** form (see [Deleting an external document](/kb/docs/external-documents-2-1-1))

## Tasks

The **Tasks** tab on a network object form lists the **KeyWork tasks** that are attached to that object. The **Tasks** tab header shows the number of tasks in brackets, for example **Tasks (23/40)**: 23 active tasks out of 40 in total. Double-click the row to open the **Task****![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/tehtv-image-ucbtbgut.png)**form.

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

## 

### Assign to fault

Use **Assign to fault![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1791812363790.png)**to attach a fault (network object) to a task.

1. Open the **Task****![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/tehtv-image-ucbtbgut.png)**form in **KeyWork**. The task can be new or existing.
2. Open the object you want to attach to the task, for example from the map or by searching for it.
3. In the toolbar at the bottom of the object form, open the tools menu and select **Assign to fault![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1791812363790.png)**:**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1791812936670.png)**
4. Select the faults type, and if you are attaching multiple objects from a search group (**Attach query set**) or a single task (**Attach current**).

The objects are attached as faults to the open task. After this, the task is listed on the object’s **Tasks** tab.