Using the Object Properties Window

The Object Properties Window can be accessed from the GeoPlan Window, the Network Object Grid Windows, the Long Section Window or the 3D Manhole Window.

See the instructions described in the Accessing Property Sheets section of the Property Sheets topic for more information.

See the Using Flags and the Using the Calendar Editor sections of the Property Sheets topic.

It is possible to customise the Object Properties Window using the Configuration () menu located on its toolbar. This menu has two options:

• Layout - which allows you to customise the properties layout for a particular object/result type displayed in the property editor. You can customise the grouping of properties, and even create new groups of object properties.
  

  Note

  It is not possible to add a new property item. The properties are system properties and cannot be edited.

When you view an object's properties, for example by selecting the object on the GeoPlan using the Properties () tool, the properties will be displayed according to the last layout that was used for displaying that type of object.

Layouts may be saved as local layouts or master database layouts:

• Local layouts are the layouts of the Object Properties Window which have been customised and saved locally to a user's machine. Local layouts include any changes that a user may have made when customising the window layout. These layouts are only available to the user who saved them on that particular machine. When a local layout is saved, it overwrites the previous version of the local layout for that object type.
• Master database layouts consist of the Object Properties Window layouts, including any that have been customised, which are stored as a property of the database, allowing other users to access them. There can be more than one master database layout for the same type of object. Master database layouts are managed using the Manage Layout dialog.

See the section Customising the Layout for information about customising layouts.

• Options - which displays the Object Properties Window Settings dialog that allows you to customise the look and feel of the Object Properties Window. You can show or hide flags, have the properties shown in groups or not and specify if you want results properties to be displayed if available, or not. You can also specify settings for copying objects.

The layout of the Object Properties Window can be modified using any of the following toolbar options:

• Configuration Menu | Layout | Edit. Displays the layout for the current object type in the Object Properties Window, ready for editing.
• Configuration Menu | Layout | Open. This option involves an additional step to the previous option, which allows you to select the object type of your choice (therefore, you do not necessarily have to choose the same object type as the object whose properties are currently being shown in the Object Properties Window). Once this selection is made in the Open Layout Table dialog, the corresponding layout is displayed in the Object Properties Window.
• Configuration Menu | Layout | Manage layouts. This option displays the Manage Layout dialog which enables you to load an existing master database layout, save a new layout or changes to an existing layout, or delete a layout. See the Managing Layouts section for further information about using this dialog.

Using any of the above options, fields (properties) and groups can be moved. Groups can also be added, renamed or deleted.

If in Properties view (i.e. when viewing the properties of a real object, as opposed to viewing the layout for a particular object type, which represents the Layout view) you are still able to manipulate and save the layout. However, editing is restricted and groups CANNOT be added, moved or deleted:

Note

In both Properties and Layout view, groups cannot be moved if they are closed (collapsed).

To customise the layout:

• Make any desired edits in the Object Properties Window.
• Select the:
• Configuration Menu | Layout | Save locally option to save a local copy of the layout. Note that when you save a local layout it overwrites the previous version of the layout for that object type.
• Configuration Menu | Layout | Manage layouts option to save the layout to the master database. See the Save a layout section for further information.

Note

Only layouts that are saved using the Manage layouts option can be saved as master database layouts.

Customised Object Properties Window layouts for all objects in a network can be saved, using the Manage Layout dialog, as a master database layout, allowing other users to access them. Saving to the master database may be undertaken by any user, or only by a Database Owner, depending on whether permissions have been implemented for the master database.

The Manage Layout dialog allows you to:

Load a layout

To load an existing layout:

1. Select the Layout | Manage layouts option from the Configuration menu.

   The Manage Layout dialog is displayed. In this dialog:

2. Select the name of the master database layout you want to load from the Layout list box.

   A Factory default master database layout is available for selection in the Layout list box. This layout consists of unmodified layouts or factory settings for all objects in the database.

WARNING

Loading a Factory default will reset all local layouts back to their factory settings. Saved master database layouts are not reset.

Tip

If you want to load a factory default layout for a particular object type, cancel this operation, and use the Layout |Reset option instead. See the Resetting Layouts section below.

3. Click Load.

   If you have chosen to load the factory default layouts, a message similar to the following one is displayed:

   

   Click OK to load the factory default layouts or Cancel to cancel the load operation.

   If you have chosen to load a master database layout, the dialog closes, and the property sheet for the object, whose properties you are currently viewing, will be displayed in the Object Properties Window according to the selected layout.

Note

Although you may have loaded a master database layout, it is treated as a local layout until any changes you make to it are saved to the master database.

Save a layout

New layouts or changes to existing master database layouts can be saved to the master database as follows:

1. Customise the Object Property Window layouts as required.
   

   An Object Property Window can be displayed by selecting:

   • One of the options described in the Accessing Property Sheets section of the Property Sheets topic.
   • The Layout | Edit option from the Configuration menu.
   • The Layout | Open option from the Configuration menu, and then selecting the appropriate object from the Open Layout Table dialog.
   • The Layout | Manage layouts option from the Configuration menu, and then selecting an existing layout to load from the Manage Layout dialog.

2. Select the Layout | Manage layouts option from the Configuration menu.

   The Manage Layout dialog is displayed. In this dialog:

3. Either:
   • Type in the name for a new master database layout in the Selected layout box.

   Or:

   • Select the name of the layout you want to save the changes to from the Layout list, and its name will be displayed in the Selected layout box.

Note

You will not be able to save any changes to the Factory default layout.

4. Click on the Save button to save the layouts.

   A message similar to the one shown below is displayed:

   

   Click OK to save the layouts to the master database or Cancel to cancel the operation.

Note

This operation may be permissioned and only made available to Database Owners, and a message similar to the one below will be displayed.

Delete a layout

To delete a master database layout:

1. Select the Layout | Manage layouts option from the Configuration menu.

   The Manage Layout dialog is displayed. In this dialog:

2. Select the name of the layout you want to delete from the Layout list, and its name will be displayed in the Selected layout box.

Note

You cannot delete the Factory default layout.

3. Click Delete.

   The following message is displayed:

   

   Click OK to delete the layout from the master database or Cancel to cancel the operation.

Note

The delete operation may be permissioned and only made available to Database Owners. In that case, a message similar to the one below will be displayed.

4. Click OK to confirm the deletion and close the dialog.

Tip

Using the button to close the window will cancel the delete operation.

It is possible to reset the user-defined local property layout for the currently selected object. To do so:

1. Select the Configuration Menu | Layout | Reset Object type (where Object type is the name of the currently selected type of object) from the Object Properties Window Toolbar, and a message similar to the one shown below is displayed:

   

2. Select Yes to reset the layout of the object properties to its factory default.

Tip

You can also use the Manage Layout dialog to load the factory defaults for all objects. This effectively resets the local property layouts for all objects back to their factory defaults. The properties for any selected object will be displayed according to its default layout until saved as a local layout or master database layout, or an existing master database layout is loaded.

To select a value, click on it once. You can edit it by:

• Overwriting it and typing a new value in the box, or
• Right-clicking and selecting an option from the context menu.

Note

Changes are immediately applied at the end of each field edit and you will not be prompted to save any changes when you close the Object Properties Window.

You can also copy/paste values.

For flags, you can select a flag value from the dropdown.

Option	Description
Close	Closes the Object Properties Window for the current object.
Close all	Closes all instances of the Object Properties Window.
Refresh	Refreshes the current Object Properties Window view.
Copy object	Copies the selected object. This can then be pasted into a text editor and saved as CSVCSV is one implementation of a delimited text file, which uses a comma to separate values. which can then be opened in Microsoft Excel. Copy settings are configurable from the Object Properties Window Settings dialog.
Cut	Cuts the selected property value.
Copy	Copies the selected property value.
Paste	Pastes a previously copied or cut property value.
Delete	Deletes selected group.
Show groups	Allows to toggle between showing and hiding property groups. If groups are currently being shown, the option has a tick in front of it. Tip If you have specified for the groups to be hidden, (see Object Properties Window Settings dialog for more details), this option will not be visible on the context menu.
Show validation errors	Allows to toggle between showing and hiding validation errors. If validation errors are currently being shown, the option has a tick in front of it. Tip If you have specified for the validation error column to be hidden, (see Object Properties Window Settings dialog for more details), this option will not be visible on the context menu.
Open all groups	Opens (expands) all groups, displaying all properties contained in each group, in the Object Properties Window.
Closes all groups	Closes (collapses) all groups. All properties which comprise each group are no longer visible in the Object Properties Window.
Move row up	Moves selected row up.
Move row down	Moves selected row down.
Add group	Only enabled if groups are shown and in Layout view. (i.e. when viewing the layout for a particular object type). Adds a new group.
Delete group	Only enabled if groups are shown and in Layout view. Deletes a selected group.
Rename group	Only enabled if groups are shown and in Layout view. Renames a selected group.

Depending on which item is clicked on, or which view of the Object Properties Window is displayed (network object properties, results properties or object type layout), some of the options may be disabled.