KEYCOM OBJECT FORMS

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
• Device
• Splice
• Pole
• Manhole
• Point object

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

• Cable
• Conduit
• Duct

Area objects include:

• Service area
• Exchange/Telecom area
• Other objects include:
• Radio link
• Route follower
• Connections management

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

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

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.

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 Rental contractscan be found in the chapter Rental contract.

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.

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.

You can use the free-form property attributes when searching for objects, and they can also be included in the List function and the related report.

Defining extra data attributes

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

1. In the Extra dataform that open from the main toolbar. 
   • Open the Extra dataform and fill in the Basic information:
     • 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.
   • Savethe 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 in the KeyCom Admin Guide.

Multiple choice menu

When you select Multiple Choice as the Type on the Extra dataform, 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.

Creating a new group

1. On the Extra dataform, select Multiple Choice as the Type.
2. Click New group next to the Enum group field. The New enum group window opens:
3. Enter a Name for the group.
4. Click Addto 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.
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.

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. 

• You can filter the list with Search Value and clicking Search.
• Open selected value on form by clicking Open selected on form.
• Delete selected value from the object by clicking Delete.
• Click Addto 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.

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 zipto download all attachments to your device.

Editing the information in attachments

1. On the list, select the attachment you want to edit.
2. Click Editto open the information on the attachment on the External documentsform (see External documents).
3. Edit information.
4. On the External documentsform, click Save formto 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 Addto open the External documents form (see External documents).
2. Choose a document or add a new one (see Adding external documents).
3. Click Attach document.
4. If you want to attach more than one file, go to the drop-down menu for Attach documentand 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.

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)

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

Assign to fault

Use Assign to faultto attach a fault (network object) to a task.

1. Open the Taskform 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:
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.