KEYLIGHT OBJECT FORMS

Object types

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

The forms for managing point objects are:

• Telecom premises
• Splice
• Manhole
• Other objects
• Pole
• Streetlight

The forms for managing line objects are:

• Cable button
• Conduit button
• Information related to the maintenance of network objects is processed using these forms:
• Premises inspection
• Pole inspection
• Cable inspection

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

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

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.

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

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.