---
title: "KEYLIGHT OBJECT FORMS"
slug: "keylight-object-forms"
updated: 2026-10-13T08:37:59Z
published: 2026-11-03T11:55:19Z
canonical: "support.keypro.fi/keylight-object-forms"
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.

# KEYLIGHT OBJECT FORMS

## Object types

The street light network includes point and line tools and tools for network maintenance and other purposes.

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

The forms for managing **point objects** are:

- **Telecom premises**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keylight-tools-image-2e0nbmis.png)
- **Splice**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keylight-tools-image-8cvekcqy.png)
- **Manhole**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keylight-tools-image-fm4f5jce.png)
- **Other objects**![point](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keylight-tools-image-43upryp3.png)
- **Pole**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keylight-tools-image-og3kts4n.png)
- **Streetlight**![lightbulb](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keylight-tools-image-jpd2wvhs.png)

The forms for managing **line objects** are:

- **Cable** button![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keylight-tools-image-99ylfwg9.png)
- **Conduit** button![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keylight-tools-image-lqh2ruf0.png)
- **Information related to the maintenance of network objects** is processed using these forms:
- **Premises inspection**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keylight-tools-image-ghd7ff1w.png)
- **Pole inspection**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keylight-tools-image-hm0f3ptu.png)
- **Cable inspection**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keylight-tools-image-86cj8k8m.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-10-1-1-1-1-1). 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 object you are managing determines the form that will open. 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.

If you want to create a new point object (premises, manhole, splice, pole) or conduit, the **required information** include **Type** and **Usage state**. For **cables,** the mandatory elements are **Type**, **Installation type**, and **Usage state**. Required data fields are indicated in yellow on the forms. Certain information elements are updated automatically when a new object is created. For example, when you create a new cable, it gets a **Length** and **Database ID**.

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

After entering the mandatory data, click **Create**![line_add](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/keylight-tools-image-v2dxectu.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/keylight-tools-image-mhj2dird.png).

The property values that can be specified vary depending on the object. For example, for a pole, you can enter information on its material, warranty period, and connection enclosures. For all objects, you can specify the **owner**, **renter**, and **installation year**. In addition, you can freely include text on the **Comments** tab.

The **Common** tab has the same data content for all objects. On this tab, you can enter information on mapping and its accuracy, in addition to which the tab includes information about the creator and updater of the object and the creation and update dates. 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-1752650542488.png)

## 

## Property attributes that can be defined freely (Extra data)

You can define free-form property attributes 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 free-form property attributes when searching for objects, and they can also be included in the **List** function and the related report.

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.

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