Manual IMS
Manual IMS
build 4933
GeoStruct IMS 14
GeoStruct B.V.
Winthontlaan 200
3526 KV Utrecht
[email protected]
www.geostruct.com
Change Registry
Version Date Release
1.0 21-10-2015 Final design
2.0 26-05-2016 Release IMS 9.0
3.0 14-03-2016 Release IMS 10.0
4.0 22-05-2017 Release IMS 10.1
5.0 06-11-2017 Release IMS 11.0
6.0 30-06-2018 Release IMS 12.0
7.0 04-02-2019 Release IMS 13.0
8.0 06-09-2019 Release IMS 14.0
9.0 12-03-2021 Release IMS 14 Build 4933
8 InfraMap .................................................................................................................123
8.1 Navigating and Selecting ..............................................................................................124
8.1.1 Panning........................................................................................................................................ 124
8.1.2 Zooming ...................................................................................................................................... 124
8.1.3 Selecting ...................................................................................................................................... 124
8.1.4 Draw and Edit Geometries .......................................................................................................... 126
8.1.5 Edit Object Info ........................................................................................................................... 127
8.1.6 Precision drawing with Snap ....................................................................................................... 127
8.2 Layers ..........................................................................................................................128
8.2.1 Layers Pop-up .............................................................................................................................. 130
8.2.2 Correct Projection ....................................................................................................................... 131
8.2.3 External Source Attributes .......................................................................................................... 132
8.2.4 Style ............................................................................................................................................. 133
8.2.4.1 Line Style (all types) ................................................................................................................. 133
8.2.4.2 Fill Style (Point and Polygon): .................................................................................................. 133
8.2.4.3 Point Style (Point) .................................................................................................................... 133
8.2.5 Labels .......................................................................................................................................... 133
8.3 Status bar ....................................................................................................................134
9 InfraPlanner ............................................................................................................206
9.1 File Commands ............................................................................................................206
9.1.1 General ........................................................................................................................................ 207
9.1.2 Resources .................................................................................................................................... 207
9.1.2.1 Activities .................................................................................................................................. 208
9.1.3 Workweek ................................................................................................................................... 210
9.1.4 Map Fields ................................................................................................................................... 211
9.1.5 Alerts ........................................................................................................................................... 212
9.1.6 Work time only ............................................................................................................................ 213
9.1.7 Auto create Sub-tasks ................................................................................................................. 213
9.1.8 Set Current Object ....................................................................................................................... 213
9.1.9 Goto Current Task ....................................................................................................................... 213
9.1.10 Allow Conflict .............................................................................................................................. 213
9.2 Home Commands.........................................................................................................213
9.2.1 Refresh ........................................................................................................................................ 213
9.2.2 Add Tasks .................................................................................................................................... 213
9.2.3 Plan Project ................................................................................................................................. 214
9.2.4 Select Period ............................................................................................................................... 215
9.2.5 Delete All ..................................................................................................................................... 215
9.2.6 Check Deleted Objects ................................................................................................................ 215
9.2.7 Progress Viewer .......................................................................................................................... 215
10 StreetView ...........................................................................................................216
11 Net Grid ...............................................................................................................217
12 Snap Reports ........................................................................................................218
13 Report Designer....................................................................................................220
14 Grid Capabilities ...................................................................................................225
14.1 Add and Delete Grid Records ....................................................................................225
14.1.1 Add Records ................................................................................................................................ 225
14.1.2 Delete Records ............................................................................................................................ 225
14.2 Edit Grid Cells ...........................................................................................................226
14.2.1 Activate Cell Editor ...................................................................................................................... 226
14.2.2 Select and Deselect Cell Text....................................................................................................... 226
14.2.3 Discard Changes .......................................................................................................................... 226
14.2.4 Open Cell Editor's Dropdown ...................................................................................................... 226
14.2.5 Close Cell Editor's Dropdown ...................................................................................................... 226
14.2.6 Change Values ............................................................................................................................. 227
14.2.6.1 Change Date/Time Values ................................................................................................... 227
14.2.6.2 Change Numeric Values ...................................................................................................... 227
14.2.6.3 Change Values of Cells That Provide Dropdown Items ....................................................... 227
14.2.6.4 Edit Images .......................................................................................................................... 227
14.3 Sort Grid Rows..........................................................................................................227
14.3.1 Sort Data in Grid Views ............................................................................................................... 227
14.4 Group Grid Rows ......................................................................................................228
14.4.1 Group Data .................................................................................................................................. 228
14.4.2 Ungroup Data .............................................................................................................................. 229
14.4.3 Change Group Order ................................................................................................................... 229
The information contained in this document may change without notice, and may have been altered or
changed if you have received it from a source other than the original GeoStruct IMS installation package. Use of
this information constitutes acceptance for use in an “AS IS” condition, without warranties of any kind, and any
use of this information is at the user’s own risk. GeoStruct B.V. disclaims all warranties, either expressed or
implied, including the warranties of merchantability and fitness for a particular purpose. In no event shall
GeoStruct B.V. be liable for any damages whatsoever, including direct, indirect, incidental, consequential or
special damages, arising from the use or dissemination hereof, even if GeoStruct B.V. has been advised of the
possibility of such damages. Some states in the USA do not allow the exclusion or limitation of liability for
consequential or incidental damages, so the foregoing limitation may not apply. Reference herein to any
specific commercial products, process, or service by trade name, trademark, manufacturer, or otherwise, does
not necessarily constitute or imply its endorsement, recommendation, or favoring by GeoStruct B.V. The views
and opinions of authors expressed herein do not necessarily state or reflect those of GeoStruct B.V., and shall
not be used for advertising or product endorsement purposes. Links and addresses to Internet resources are
inspected thoroughly prior to release, but the ever-changing nature of the Internet prevents GeoStruct B.V.
from guaranteeing the content or existence of the resource. When possible, the reference contains alternate
sites or keywords that could be used to acquire the information by other methods.
IMS introduces a number of concepts with which these models are described. Below is a summary of these
terms. To avoid confusion, these terms are written with a capital letter.
IMS uses a database to store the data. Before you can start working with the application a connection to an
IMS database must be established.
At the initial start-up there is no known database to which IMS can connect. The 'Create Database Connection'
dialog box appears. For a description of this screen, see section 4.1 of this chapter.
IMS remembers the last connection to a database. This connection is used when IMS is started the next time. A
pop-up screen appears requesting the login data:
After entering the correct name (default ‘Admin’) and password (blank by default), press OK. The IMS
application will start and the main screen is displayed.
IMS saves all screen and layout settings in special files that are loaded on start up. If there is any trouble with
loading these files, check ‘Don’t load application layout settings’.
Select the database provider. Four database systems are supported: Microsoft SQL Server (MSSqlServer),
MySql, Oracle and Access. Depending on the provider, the dialog box can be adapted according to the
capabilities of the database provider.
Note: Only use Access for exchanging data between different servers. The Access database has not
been tested in production environments.
The ‘Use Windows identity to sign on (SSO)’ check box is used to sign in without extra IMS login screen (Single
Sign On). To use SSO, the IMS user name must be the same as the Windows login name. To show the ‘Create
Database Connection’ dialog box on startup, press the Ctrl button while IMS is starting.
After entering the correct data, the connection must be checked by pressing the ‘Test connection’ button. If
the test is successful the following message appears:
The OK button on the 'Create database connection' screen is now available. Press OK and IMS will start with
the selected database.
The database administrator must ensure the correct login credentials. Contact your database administrator for
a list of available databases and/or the server name.
The connection parameters can be stored locally for reuse. These are stored in the file
%USERPROFILE%\AppData\Local\GeoStruct\GeoStruct IMS\Connections.txt.
Press the OK button to close both windows and IMS will start up with the new (empty) database.
This chapter briefly explains the names of the different user interface elements and how they can be used.
Tab page Quick Access Toolbar Command Button Button group Ribbon Interface
Check Button
Dock panel title Maximize Button
Dock panel
The table below explains the various components of the user interface:
Component Explanation
Tab page Serves to create a logical organization of the various button groups. The IMS main
screen has two main Tab’s: Home and Support. If Plug-ins are loaded, there may be
more Tab’s added.
Quick Access Toolbar The toolbar where buttons are always accessible, regardless of the selected Tab.
Command Button A button through which a command is issued.
Button Group Serves to create a logical organization in the different buttons.
Check Button Button that can be switched on and off.
Dock Panel A panel that can be ‘docked’. That is, the panel can easily be positioned adjacent to
other panels. See also ‘Docking Panels’ below.
Dock Panel title It contains the name of the panel. It also contains the buttons that close or hide the
panel.
Auto Hide Button This button allows a panel to be hidden in the Hidden Panels.
Maximize Button This button allows a panel to be maximized.
The following sections of this chapter provide more detailed information about a number of features of the
user interface.
Initially, only the Shortcuts to the Quick Access Toolbar and the Tab pages are displayed. If the Shortcut of a
specific page is pressed, the Command Shortcuts of that page are displayed:
You can use ‘Add To Quick Access Toolbar’ in order to add the selected button to the Quick Access Toolbar
(QAT). This makes the button always readily accessible, regardless of the selected Tab page.
If the button is already in the QAT, you can replace the first menu item with ‘Remove from Quick Access
Toolbar’.
‘Customize the Ribbon’ gives you the possibility to fine-tune the Ribbon to your needs.
Note: In case some buttons/groups of buttons are not visible, use the ‘Reset all customizations’
command in the Reset submenu.
Selecting ‘Minimize the Ribbon’ reduces the entire Ribbon interface to the tabs of the Tab pages. Simply click
on the tab you need and the Tap page will briefly reappear.
The markers indicate where the panel can be docked. If the cursor is moved over a marker, a blue rectangle
appears showing the new screen position. The following figure shows the Object Types panel as it is dragged
over the tab marker:
In case your PC is equipped with multiple monitors, the Floating Panels can be arranged without covering one
or a part of the other panels. The separate panels can be placed in a new docking window by dragging one
panel over the other and docking at the desired location:
The standard Exception handler shows the GeoStruct IMS Error message dialog box. In this dialog box the
exception or error that occurred is shown. This dialog is shown when the current process cannot continue.
The details in this dialog are very useful for GeoStruct to solve errors and bugs. Therefore there are two
methods to send the details via mail to [email protected].
If you can send emails directly from your PC, use the Send Mail button. The e-mail client will be started with
the fields already completed. If no mail client is available directly, use the Copy button. The text is copied to the
clipboard. Preserve the text so it can be send to GeoStruct in another way.
Figure 20
This method is used when exceptions are not fatal and the current process can or must continue. Always
examine the messages and send them to [email protected] if necessary. Select the message the message
or use Ctrl+A and copy it to the clipboard with Ctrl+C. Paste it to an email message.
Figure 21
6.1 Home
6.1.1 Panels of the Main Screen
When IMS first starts, the Main Screen starts-up with the standard layout, as shown below:
The Check Buttons of the panels that are active are highlighted in the Ribbon. In the above setting, this
highlight color is set to orange. In section 6.1.8, Skins, will be explained how the color settings can be adjusted
for IMS.
The button ‘Object Detail’ is no longer orange and the panel ‘Object Detail Async’ has taken the space of the
panel ‘Object Detail’.
A panel can also be closed by pressing the cross in the Panel Title of the screen.
This chapter explains the various buttons and functionalities of the Home Tab.
6.1.4 Panels
Figure 26 - Panels
6.1.4.1 Projects
The available Projects are shown in the Projects panel.
First a brief explanation of the terminology:
The Current Project (the active project) is the Project in which all new Objects are saved. If there is no Current
Project, the Objects will be created in the Root. That is, these Objects do not have a Project. The text of the
Current Project is always red.
The selection of Objects can be extended by Selected Projects. The text of Selected Projects is bold.
In the ‘Select Objects in’ dropdown list, the objects that will be displayed in the Object Type panel and the
Objects panel are specified.
Note: if the Project Selection is set to Recycle Bin, Administrators will see all Objects in the Objects panel that
are deleted. All other users will see only deleted Objects of users that belong to the same User Groups as the
Current User.
Depending on the selected Projects, the menu item ‘Remove from Selection’ is replaced by ‘Add to Selection’
or by ‘Invert Selection’ (if several Projects have been selected).
Menu-item Explanation
Set Current Project The selected Project becomes the Current Project. The text of the Project turns
red.
Reset Current Project The Current Project is reset. There is no active Project.
Add to Selection The selected Project is added to the selection.
Remove from Selection The selected Project is removed from the selection.
Invert Selection The selected Projects are either removed or added to the selection, depending
on their current status (whether or not in the selection).
Clear Selection The selection is cleared.
Refresh List The Project list is rebuilt from the database.
Sort Ascending Sorts the Projects in alphabetical order.
Expand All Expands all Projects
Collapse All Collapses all expanded Projects
Search Project Searches the Project that contains the text entered in the dialog box.
Delete Project Deletes the selected Project. Only available for Super Users. The Project is put
in the Recycle Bin with all containing Objects. Only the complete Projects can be
restored, not an individual Object.
Project Selection is the combination of the Current Project, Selected Projects and the setting of ‘Select Objects
in’ drop-down menu.
The contents of the Object Types window will be adapted, depending on the content of the Project Selection:
Note: The Object Types available within a project can be set per project. In Edit Structures (see 6.2.1.2)
will be explained how Object Types can be linked to projects.
Projects can be dragged. By dragging and dropping one Project on another Project, the dragged Project
becomes a Sub-Project. This is only performed if this Project is permitted as a Sub-Project.
- ‘Refresh’ refreshes the content of the window Object Types (this is necessary if the data model is
modified during the session).
- ‘Show Existing Only’ shows the Object Types of which Objects are present in the current Project
Selection.
- ‘Show Existing Also’ shows all allowed Object Types and the Object Types of which Objects are present
in the current Project Selection. It will show Object Types that are not allowed in the current project
with the ‘[NOT ALLOWED]’ postfix.
- ‘Expand All’ expands all nodes in the tree list.
6.1.4.3 Objects
In the Objects panel the Objects of the current Object Type are displayed. The Project Selection determines
which Objects will be displayed. See 6.2.1.1.
The Objects are displayed in the Object Grid. The operation of the grid is described in chapter 14, Grid
Capabilities. Section 6.1.7.2 Display Fields shows how the fields, that are visible for an object, can be set.
In order to switch back and forth between previously selected objects, the Previous or Next arrow in the top
left of the Objects window can be clicked. This is a navigation function; it does not undo changes. Below the
buttons are displayed:
When the function Include Relations is activated, the relationships of the Object with other Objects is
displayed. These relationships can be defined via Edit Model, as described in section 6.2.1.1.
6.1.4.3.2 Filter
Objects can be filtered by specific properties by using the Filter drop-down menu. It is also possible to filter by
individual data; see Filter Grid Data 14.5.
Figure 33 - Filter
If the selected filter is Connected or NotConnected, the Node can be specified using the Nodes drop-down
menu:
If none of the options for Object Status is ticked, the field in Object Status column will indicate the value None.
Select the User Group that may modify the Object. Press Ctrl-Delete to delete the User Group.
This dialog box provides an overview of the Structures that can be added.
The column Min Count indicates the minimum of Structures that have to be present. The column Max Count
indicates the maximum number of Structures that may be present. The column Count indicates the actual
number.
Select the desired Structure and use the Add drop-down menu to set the number of Structures that should be
added.
Press OK to add the Structures to the Object.
Enter the search text in the Find What text box. If the text should be replaced, enter it in the text box ‘Replace
with’. If the text to be searched is case sensitive, tick the ‘Match case’ checkbox. If only the whole word must
be sought, tick the ‘Match whole word’ checkbox.
Click Find Next to find the next text. The search will start from the current position. If necessary, position the
cursor on the desired record. Click Replace to replace the found text. Click Replace All to replace all found texts.
Objects can be very complex. They can contain all sorts of Sub Objects, connectors and documents. So, be
careful when deleting Objects. The consequences can be profound.
Deleted Objects are not immediately removed from the database. They are placed in a special Project: the
Recycle Bin Project. Objects form the Recycle Bin can be put back or be permanently removed. See 6.1.4.1.
This arrow indicates to which Project the Object will be moved. If the Object is held above a folded Project for a
short time, the folder will unfold. This eliminates the need to unfold the Projects before an Object can be
dragged to the correct Project.
If the left mouse button is released, the following message will appear:
Figure 43 - Verification
When pressing Yes the Object will be moved to the new Project (in this case Hoogland).
Note: IMS will check whether the Object could be part of the new Project. This is defined in the Project
Structure. If the Object cannot be part of the Project, this will be reported and the action is cancelled.
If any, the Sub-Objects are listed under the Task. These may be nested; underneath a Sub-Object may be other
Sub-Objects. The connections of every Sub-Object are also displayed, as described above.
Note: If an Object is a Task type, but no tasks are planned for the Object, the From column contains
the text ‘NOT PLANNED’
Files that belong to the Object are shown with an attachment icon.
Double click the file to open the file. For dwg and dxf files, GeoWorks will be used. For sor files the SOR file
viewer will be used. All other files will be opened with the default Windows application.
You can drag a file from Windows explorer and drop it on an Object to attach a new file. You can delete the file
by pressing the Delete key.
By right clicking on an Object or a connection the following pop-up menu appears (the menu can vary,
depending on the selected item):
From Object Detail and Object Detail Async (see 6.1.4.5) connections can be made. Drag a free connector to
another free connector (normally, an output may connect to an input). Release the mouse button when the
arrow is on the desired connector.
It is checked if the connection is allowed. If this is the case, the connection is created:
If the Node is set to AutoConnectSubObjects, not only the cable will be connected, but also any sub-connectors
will be made. See Edit Model 6.2.1.1.
If a connection between two Objects can not directly be made, it is checked if a Connection Type is defined that
can be inserted between the two free connectors. A new Connection will be made and connected to the two
connectors.
Connections and Objects can also be deleted (if the data model allows this). Select the desired connection or
Object and press the Delete key.
If it is allowed by the data model, Sub-Objects from one owner can be dragged to another owner.
With the Object Detail Async button in the Panels Button Group of the Main Screen multiple Object Detail
Async panels can be started so that several Objects can be displayed simultaneously.
Thus, these Objects are always available, while other Objects can be worked on. The Object Detail Async panel
has some additional commands in the pop-up menu and some commands have a slightly different function.
Function Explanation
Make Current Make the selected Object the root Object in the panel. The Current Object
does not change.
Set as Current Object Make the selected Object the Current Object. The root Object in the panel
does not change.
Go to Connected Object Make the connected Object the root Object in the panel. The Current Object
does not change.
Set Connected Object Current Make the connected Object the Current Object. The root Object in the panel
does not change.
Goto Owner The Owner of the selected Object becomes the new root Object. The Current
Object does not change.
Collect Mode (multiple roots) If set, multiple Objects can be dragged to the panel, without resetting is.
Link a new file to the Current Object by pressing the + button in the grid. By pressing the ‘…’ button in the
Source Location column, the Select File dialog box appears:
The location of the file is determined by the ‘Save Files to database’ setting. This is a global setting and can only
be altered by an Administrator.
The file can be viewed by pressing the ‘…’ button in the View File column. Not all file types are supported by
the viewer. If the file cannot be viewed, the default Windows application is used to open the file. The default
application is always used when the ‘…’ Open File button is pressed. Remember to save the file in the database
again if the file is altered outside IMS. This is not necessary if the file is not saved in the database.
To save the file outside IMS, press the ‘…’ button in the Save As column.
With ‘Auto View File’ the Auto View File function can be turned on or off. If the Auto View File function is
turned on, files are automatically loaded from the database or disk in the viewer. Turn the automatic file
loading off if loading of files if slow.
The ‘Save Files to database’ setting is only available for Administrators. It determines if the file is saved to disk
or in the database. Be aware, when the file is not saved in the database, other users may not be able to view or
open the file if the file is not saved in a location that is available for all users. On the othe hand, if the files are
sabed to the database, the database can become very large. Backups, restores and copying of the database can
become time consuming.
6.1.4.7 Coordinates
In the Coordinates panel the coordinates of a Current Object are displayed. These coordinates are used in
InfraMap as the Object Geometry. In the following figures the coordinates are displayed, respectively, in
WGS84 (with Longitude (Lon) and Latitude (Lat) in degrees) and RD (Dutch coordinate system) with X and Y in
meters. The Z coordinate is in both systems in meters.
If the right mouse button is clicked in the panel, the following pop-up menu appears:
With the Refresh command, the coordinates are reloaded from the database.
With the Zoom To command, the currently selected coordinate is centered in InfraMap (if open) and shown as
a red circle. Double click on the row will execute the same command.
6.1.4.8 Documents
In the Documents panel, all Documents are displayed that are linked to the Current Object. A Document is
derived from a Document Type, see 6.2.1.3.
Figure 56 - Documents
Click the Open button or double-click the line in the grid to open the selected document.
This window is synchronized with the Objects panel. In this window the specification of the Current Object is
displayed by focusing on the row in the grid. In the example above the Spec is 1.
When right-clicked in the Spec grid, the following pop-up menu appears:
With the command ‘Set Spec of Selected Objects’ the specification of the selected Objects is set. Here, the
application will ask for confirmation before the command is actually executed (see figure below).
Note: When changing a specification, the related structure can change. The present Spec Structure is
removed or replaced. If Objects to insert have the same Type and Spec, they will be preserved.
With the Refresh command the data of the Spec table is reloaded from the database.
With the Enable Editing command the Grid is placed in edit mode. This is to prevent accidental changes to the
Spec table (these can have a major impact on the network topology).
Only Super Users, Application Administrators and Administrators can change, add or delete Spec records. A
Spec record can only be deleted if no Objects are linked to this record. If a record is deleted, the following
message appears:
Note: If a Spec record is deleted, the database will get a new revision number so that earlier Project
Exports are no longer compatible. This is to prevent the emergence of corrupt Objects in the database.
6.1.5 Windows
The Windows button group contains commands to open a number of separate panels.
6.1.5.1 NetView
See chapter 7.
6.1.5.2 InfraMap
See chapter 8.
6.1.5.3 InfraPlanner
See chapter 9.
6.1.5.4 StreetView
See chapter 10.
6.1.6 Tools
Figure 63 - Tools
There are several extra tools and functions available in the Tools button group of the Main Screen. In this
section these tools are explained.
Select the required Label Definition. The labeler is being implemented. This could take some time, depending
on the settings in the Label Definition.
If the incorrect Object type is selected, the following message appears. Select the correct Object and restart the
command.
With the New button, a new sequence can be created. The following dialog box appears.
Give the name of the sequence and add the label definitions to the right list by dragging or double clicking the
label definition in the left list box. The order in the right list will be the order in which the label definitions are
executed. You can change the order by dragging an item to another location in the list. Double click on an item
in the right list to remove the item.
Important note: all used Label Definitions must have the same start object(s). Otherwise the labeler is not
executed and the next Exception log will appear:
Execute a sequence by double clicking the sequence name or by selecting the sequence and clicking ‘Execute’.
6.1.6.3 Reports
Click Reports to open the window with available reports:
Figure 70 - Filter
Here, the filter criteria can be specified used to filter the data for the report. The operation of the filter is the
same as used in grids. See chapter 14.
Note: The filter applies to the current selected report. The filter is reset if another report is selected.
After selecting a report and pressing OK, the Print Preview function will start:
The Print Preview function is a standard module, which is explained in chapter 15 Print Preview.
The selected Object and Sub-Objects are displayed in the middle. Left and right are the connections. The thin
lines represent the connections between the connectors. If the mouse is moves over the end of a connector,
the name and status of the connector is displayed:
By dragging from a free connector to another connector, a connection can be prepared. This means that the
connection between connectors is displayed as a line in the screen, but that this connection is not yet saved in
the database.
Left-click on the object to select it. It is now dotted blue. Hold the Shift key and left-click to select multiple
objects.
Multiple connectors and connections can also be selected using the command Select By Window: left-click (not
on an object) and drag a window across the desired objects and release the button.
The selected connections can be deleted using the Delete key. NOTE: existing connections can also be deleted
in this manner.
Menu-item Explanation
Select this type on this side Only available is a shape is selected. Selects all shapes of the same Object Type
on the same side of the screen (left, middle or right)
Prepare all All free connectors are, when possible, automatically provided with a prepared
connection.
Prepare selected All selected shapes receive a prepared connection. When a connector is
selected, it will be used as start point for the first connection. Note: do not
select a shapes from the middle Object. These are not used.
Connect now All prepared connections are now saved in the database.
Sorted Reconnect Reconnects the selected connections or all connections of a particular Object
Type sorted.
Clear Prepared All prepared connections are deleted (cancelled).
Rebuild Window is rebuild.
Hide Existing Connections Existing connections are hidden. Casts light on connections that have to be
made.
Set as Current Object Sets the selected Object as Current Object
Set to the Left Rebuilds the window with the selected Object on the left side. See example
below.
Set to the Middle Rebuilds the window with the selected Object in the middle (not always
available.
Set to the Right Rebuilds the window with the selected Object on the right side.
Open Color Mapper See Color Mappings, 6.1.7.3.
Filter Object Nodes See 6.1.6.5.1.
Sort connectors on name Will sort the connectors on Object shapes by name instead of Node Id
Sort Sub Objects on label Will sort the Sub Objects on Label instead of Handle
Note: The connection rules are always checked when creating connections. If a manual connection
cannot be made a message will appear in the status bar (bottom left of the screen). If a connection is
made automatically, the number of connections made is displayed.
The Filter Object Nodes panel allows you to filter specific Object Types and/or Nodes. When filtered, these
Object Types and/or Nodes are no longer displayed in the Connect Sub-Objects panel. This is especially useful if
the panel turns unclear due to the large amount of details.
Check the Object Types and the corresponding Nodes that should not be displayed in the Connect Sub-Objects
panel. If you only check the Object Type, nothing of this type is displayed.
With the Save, Load and Delete button you can manage different filter configurations.
Functioning is equal to Connect Sub-Objects, as described in 6.1.6.5. In this situation, you can also create
connection objects. With other words, if a direct link between two connectors is not permitted, it will be
examined if a connection type is permitted between the two connectors.
Proceed as follows: select in the Objects window the Objects of which the geometry needs to be created. Open
the Create Geometries window. On the left side, select the field that represents the X coordinate and press the
X> button. Repeat this for the Y coordinate and possibly the Z coordinate. Select the Projection. It must match
the projection in which the coordinates are saved in the Info table.
Press Import. To continue, click Yes to the following message.
At first, an Object Type needs to be selected for which the Bulk Input must take place. This is possible in the list
on de left side of the window. Below the list with Object Types the number of new Object to be made of the
selected Object Type can be set:
Then press Start to create new Objects. These new Objects are visible in the Objects window as Objects with
the highest Handle.
Figure 88 - Objects
If the requested Object is not in the Current Project, the following message is displayed:
When pressing Yes, the Current Project will be set to the Project of the searched Object.
Next, type the value to search. You can use a ‘%’ character to match multiple characters. The ‘_’ character can
be used to match a single character:
Finally, all Objects that match the entered value, will be shown in a list. If more than 10000 Objects are find,
only the first 10000 will be shown.
Select an Object and press OK or double click an Object to make it current. The list will reappear until Cancel is
pressed.
6.1.7 View
Figure 91 - View
In the View button group the layout and the field settings of the window can be set and changed.
Pressing Yes will close IMS and all changes to the layout of the window will be removed. When restarting, the
main screen will start with the standard layout.
In this window the fields can be set that are visible to a particular Object Type in various components and
functions. Components include the Objects Panel, NetView Window etc.
If the field Component is set to a specific component, such as ObjectsControl, then the Object Panel will display
the fields that have been entered in the Value column. If no value is entered for a component, then the fields
entered under Default component will be displayed for this component. If these are also not entered, all fields
of the Object will be displayed.
It is advisable to fill the Display Fields extensively. For Object Types without Display Fields, all fields are
retrieved. This has a negative impact on the overall system performance.
The following example will explain step by step how to fill the Display Fields for an Object Type. Start by clicking
the + sign at the bottom of the table or by clicking in the lower record (‘*’).
Finally, click in the Value field on the ‘…’ button. The following dialog appears:
The left list shows all the available fields; the right list shows the fields that are displayed for the specific
component.
Drag fields from the left list to the right list to add fields. Double-clicking in the left list adds the field at the
bottom of the right list. The order of the fields is changed by dragging a field in the right list to another
position.
A field is removed by double-clicking on the field in the right list, or by dragging it to the list on the left.
In the left column, select the Object Type that contains a color field; select the color field in the right column.
The ‘Copy To User’ command enables Application Administrators to copy the color fields and color mappings to
another user. Other users do not see these components.
In order to link the names of the colors to real colors, click Color Mappings....
In the left column, enter the name of the color; in the right column, select the appropriate color using the
'Color picker' pop-up. See below.
6.1.8 Skins
In Skins, different color settings can be selected by clicking one of the icons in the Button Group.
Clicking on the arrow on the right (see below) will show some additional possibilities.
6.2 Support
The more administrative and maintenance related components are incorporated in the tab Support of the
Main Screen. For example, Creating Models and Structures, Reports and User Settings.
In the Data Model button group Object Types, Structures and Projects can be defined, among other things.
The warning indicates that when changing the data model, previously made exports and Maps (see manual
InfraMap) no longer correspond with the current data model. Previously exported projects can no longer be
read into the current database without possible data corruption. With previously created Maps a warning will
be given and opening it can cause errors.
Preliminary:
Press the Refresh button to refresh all connectors in all boxes. As this is time consuming, this function is not
performed automatically.
On the left, you see the list with existing Customer Defined Object Types (CdoTypes).
With the ‘Add Object Type’ button, a new Object Type is added to the list:
With the ‘Copy Object Type’ button an Object Type that is selected in the list can be copied. After pressing
‘Copy Object Type’ the following message appears to indicate which information is copied exactly:
When pressing Yes, a new Object Type will be created that is a copy of the selected Object Type.
The name of the new Object Type can be changed by clicking on the Name field and typing the new name.
Function Explanation
(Select All)
Object A standard network component, for example a homeconnector or junction box.
Connection A connection is used for connecting two objects, for example a cable. A connection will
normally always have two connectors (one input and one output). These two connectors
are automatically generated when the Mode of an Object Type is set to ‘Connection’.
Project A project is displayed in the Projects panel. It helps with organizing the data.
Document With a document, additional information can be made available, for example by using an
AutoCAD drawing for displaying schemes etc. The software required for a particular
document type must be available on the system.
PathLink A PathLink is a component used for determining the ‘shortest path’. These are usually the
paths that serve as the foundation for the network design, such as trenches, pressings
and structured drilling. The connections can be drawn automatically over these paths in
InfraMap.
Task A task or activity that is used in InfraPlanner.
Resource A resource or employee who will perform the task in InfraPlanner.
Dimension This allows dimensions to be created in InfraMap.
In the field Icon you can add an image to the Object Type. Double-click the Icon field, or press the button ‘∙∙∙’
button in the field on the right and select the image file you want to use from the file select dialog box.
At the right of the Infra Model screen, you will see a number of tabs. Here you define the properties of the
selected Object Type. These are explained in the next sections.
Pressing the button Add Column, adds a new column line to the Info Table. You will see this as a new row in the
Info grid.
You can enter any kind of text into the field Name. We recommend that you use only alphanumeric characters
and no spaces. Third party applications may encounter problems with non-alphanumeric characters.
It is important to use the correct names for certain Info columns (Special Column Names), since these may have
a special purpose in IMS. This is shown in the following message (displayed as a tool tip of the Add Column
button):
- GeoLength: In the column GeoLength, the actual length of a connection (Object Type with Mode
Connection) or trench (Object Type with Mode PathLink) is automatically stored as it is drawn in
InfraMap.
- Resistance: Resistance can be used to adjust the resistance of a PathLink. You normally would use
GeoLength for this purpose. Resistance adds a multiplication factor to individual paths.
Geometry: Geometry allows you to use an SQL Server geometry instead of the Coordinates Table
which is used by default to record the location of the Objects.
- MapLineColor: MapLineColor defines the line color of a Geometry in InfraMap. This also applies to the
Spec table.
- MapFillColor: MapFillColor defines the fill color of a Geometry in InfraMap. This also applies to the
Spec table.
- LabelLeft: Only applicable for Trench Content Layer (see 0). To control the text alignment of the labels
of the Trench Content.
The value in the column Size allows you to adjust to the length of a string. Size is ignored for all other types.
The field in the column Generator allows you to set the Value Generator for the info field. Clicking the field in
the column Generator, opens the Value Generator dialog box. See section 6.2.1.5 for more details on the Value
Generator functionality. When the field in the column Generator is set to ‘Yes’, a Value Generator has been set
for the info field.
In the column ‘Name’ you may enter the names of the connectors. Any name is possible.
‘Groups’ can be used to group connectors with identical properties. Connectors with the same number, belong
to the same group. This feature enables you to filter connectors in certain situations, for example Object Detail.
‘Mode’ enables you to define the Connector capabilities. Clicking the field in the column Mode, displays a pop-
up list. The meaning of the Modes is as follows:
Mode Explanation
ConnectSubObjects If checked: connections of Sub Objects whose AutoConnect is turned
on are automatically connected.
AutoConnect See above.
DisconnectSubObjects If checked: connections of Sub Objects whose AutoDisconnect is
turned on are automatically disconnected.
AutoDisconnect See above.
The button Add Range allows you to create multiple Connectors at once. Enter the desired number of
Connectors in the field ‘Number to add’. In ‘Name Format’, enter the text to be used for the new Connector;
‘{0}’ will be replaced by the Connector sequence number. Example: if you have to create 10 new entries for an
Object Type, you will have to fill out:
The Group is optional; set Group to 0 if the Connectors do not have anything in common. Specify the desired
Mode in the Mode Selection List.
Multiple Connector names can also be updated in this way. Select the connectors of which the name must be
changed, give the new name in the Format textbox and press Update:
The Update Selection button allows you to modify the Mode of all selected Connectors at once.
On the left side of the screen, you will see the Connectors that form the starting point of the connection; on
the right side of the screen you will see the Connectors that form the endpoint of the connection.
The Check All and Uncheck All buttons allow you to check or uncheck all Connectors on the right side of the
field.
Proceed as follows:
Select the applicable outputs in the 'From Connectors' box.
Select the connectors that can be connected to this output in the ‘Select Connectors to Add’ box. Use Shift or
Ctrl key to select multiple Nodes (you may want to filter the Connectors if the list would appear cluttered).
Then click the button <<Add Connectors. The selected connections are copied into the 'To Connectors' box.
In order to remove the connectivity options, you will have to select the Connectors in the 'To Connectors' box.
Click the Delete button.
6.2.1.1.8 Relations
With Relations you can link Object Types to each other. An Object that is related to another Object, can display
the attributes (Info, Spec) of the linked Object.
Relations create one to n relations between Objects.
Note: Be careful with Relations. When you change a linked Object, all Objects that have a relation with
this Object will contain the modified data. For example: a Client and a Cabinet are related through the
object called Address. The Client moves, so the address of the Client is changed. It turns out that the
cabinet has moved along. This was not meant to be. In order to avoid this, a new Address object had to
be created and linked to the Client.
A database can become so complex that conversions turn out to be costly and complicated. Always
consider this before starting to use Relations.
6.2.1.2.1 Structures
You can add a Structure by pressing the + button in the Structure Grid. In the Name field, you can enter the
Structure name. In the Mode field, you can specify the Structure mode:
There are five options: Template, Rigid, Concept, UsablePathLinks and nothing checked,
A Template structure has a Project-type as Owner and can be used as ‘automatic stamp’ (see 8.4.4.2.). It will be
created ‘as is’, without Owner Object.
A Rigid Structure cannot be changed once it is entered. This is desirable for components that have a fixed
structure, for example fiber optic cables including tubes and fibers.
A Concept Structure allows you to add Object Types in the Structure as Sub Objects to the Owner. If these Sub
Objects are allowed in the Owner Project, they will not be deleted if the Owner is deleted. If the Owner of
Structure is a Project, only the contents of the Structure can be used in this Project. Objects in a Project will be
deleted if the Project is deleted.
A UsablePathLinks Structure defines the path links that can be used for specific Connection types. The Owners
of this Structure are the Connection Types. The Contents contains all Path Link Types that may be used for the
Connection path. When creating Connections in InfraMap, only path links of these types will be used to create
the path.
Note: the Spec in the structure contents is not used to determine the usable path links.
A Structure without a Mode checked can be added to the Owner and changed at a later time.
6.2.1.2.2 Owners
As indicated above, a Structure usually has an Owner (except the Template Structure). The Owner can be
specified in this sub-screen. If the Owner is a Project and the Structure is a Concept Structure, the Structure
contains the allowed Objects in the Project.
Leave Owner blank if the desired Structure is determined by the Specification. Include the Structure in the Spec
record of the Object Type that has to become the Owner. The Project contents can also be defined by the Spec
Structure.
Function Explanation
Object Type The Object Type of the Owner.
Min Count Minimum number of Structures that the Owner must contain.
Max Count Maximum number of Structures that the Owner may contain.
Note: If the Min Count is greater than 0, it will mean that automatically that number of Structures is
introduced when the Owner is created. Set both counts to 0 if no Structures may be inserted, for
instance for UsablePathLink Structures.
Select the Object Type to be added in the Object Types list. At Count, enter the number of Objects to be added;
if required, enter the Spec ID of the Objects to be added in the Spec field. If the Spec is set to 0, the
Specification will be requested for each Object. If the Spec is set to -1, the Spec is only asked once for every
Object Type in the contents list.
Press the Add button. The new Objects with the specified Spec shall be added to the Structure Contents.
Figure 125
With the ‘Delete’ command or delete button, you will delete the selected Object or Connection. If a connector
is selected, the Objects will be disconnected.
With ‘Delete All’ all Objects and Connections will be deleted from the Structure.
‘Edit Info Values’ allows you to enter default Info values for the selected Object. If no Info record is available
yet, it will be created. Enter the values in the appropriate fields:
In order to change the Spec, click the Spec field to select the desired Specification for the Object:
Objects can be interconnected in the Structure Contents screen. This process is in line with the panel Object
Detail, see 6.1.4.4.
Structures can be nested. This means that Objects in a Structure can be Owners of other Structures.
In the ‘Document Object Types’ selection list: select the Object Type to be used for the Document Type.
The
Column Explanation
Name Enter the name of the Document Type.
Doc. Template The template used to create the new Document.
Projection If applicable, enter the projection or coordinate system for the drawing
User Group The User Group that can use this Document Type. If User Group is empty, the
Document Type is available for all users.
CdoType settings Click the ‘…’ button to open the ‘Document CdoType Settings’ dialog.
Note: Document Administrators can only add and edit Document Types with User Groups they are part of.
In the dialog box ’Document CdoType Settings’ you have to define the Object Types that have to appear in the
Document:
On the right hand side, you see the Attributes grid. Attributes are the fields that must be shown on the
Document. The grid lists the attributes of the selected Document Setting from the grid on the left hand side.
In the grid on the left-hand side, you have to enter a self-explanatory name for the Sub Net.
In ‘From Node-Types’, check all connections that can be used as most ascending point in the network.
In ‘To Node-Types’, check all connections that can be used as most descending point in the network.
If necessary, select a Network Calculation plug-in. This plug-in can calculate the network in order to display the
calculation results in certain modules (such as NetView).
This plug-in should be a Microsoft.Net library as these are specifically built for IMS network calculations. For
more info please contact your supplier.
You can define a Value Generator for each possible combination of Object Type, Info field and Specification.
If you press the button + at the bottom of the field, and keep it pressed, a new blank line will appear. In this
line you can select the desired Object Type under the column CdoType. In Field Name you can select the
desired Info Field. Spec ID allows you to set the desired specification to which the Value Generator applies.
The meaning of the various options of the Value Generator are explained in the table below:
Option Explanation
Start Value / Values Here, fixed texts can be entered. If one value is entered, this value will be used
as the initial value. For multiple texts, separate them by a semi-colon (;). All texts
must be unique.
To get the values from another table column, use the ‘^’ character before [table
name].[column name].
If the value of the Increment is 0, the texts will be used as a drop-down list. If the
value of the Increment is 1, the next value from the list is used for a new Object.
Format String The manner in which the generated value needs to be formatted. This field may
be left blank.
See http://msdn.microsoft.com/en-us/library/8wch342y.aspx.
This setting will not be executed if Values are also entered.
Pre fix Text that is placed in front of the generated value. This field may be left blank.
Post fix Text that is placed behind the generated value. This field may be left blank.
Value is editable If this box is checked, the generated value can be edited afterwards.
Increment A number with which the new value is increased. If ‘Start Value’ is left blank, it is
also the start value. Leave this value empty if a drop-down list should be used.
Reset on owner count When releasing a new value, the value is reset to the start value if the Object has
a different Owner than the previous Object. Count represents the ‘depth’ of the
nesting of the Structure.
Reset on owner type As above. Here, the Owner must be of a specific Type.
Reset on project count As ‘Reset on owner count’. Here, not the Owner is checked, but the Project.
The command Label Definitions specifies in which way the Object Info fields should be automatically
populated. Label Objects allows you to run these Label Definitions. See 6.1.6.1. The following dialog box
records these definitions:
d. Sub Net: Only applies if ‘NetworkDown’ or ‘NetworkUp’ is selected in Object Retrieval. You
have to select the Subnet that is used to build the network. See 6.2.1.4.
e. Owner Type: Only applies if ‘SubObjects’ is selected in Object Retrieval. Select the Object
Type of the Owner.
3. Counters. Per label definition multiple Counters can be specified. When a certain condition is
detected, the counter will be automatically increased. This condition is determined by the 'Incr. on’
settings. The counter can be reset. To do so, use the 'Reset on' settings.
Note: the Regular Expression Language is very powerful but can be quit complex. To learn more about regex,
see https://docs.microsoft.com/en-us/dotnet/standard/base-types/regular-expressions
Note: The Show Format rules button gives an overview of the formatting rules that can be applied:
6.2.2 Import/Export
Export to Current Database exports the Project to another project in the current database. You can select the
Target Project after pressing the Start button.
Export to XML exports to an XML file. Enter the name in the text box or select to select the button ‘…’ to select
the file.
Export to Database exports to another database. Enter the connector text in the text box or click the button ‘…’
to open the dialog box ‘Create Database Connection'. See 4.1, Logging on to another database.
In case you use another database for the export, it will be verified if the data models of the source and target
database are identical. Otherwise, the following message will appear:
The export cannot be carried out unless the ‘Ignore Model Differences’ is checked. See below.
Use the Check button to test the model differences. It will verify if the Object Types, Info columns, Spec
columns, Connectors and Connectivity rules are the same in both databases. The Structures are not checked at
the moment. Structure differences will not lead to data corruption, but can give unexpected data results.
After the databases are evaluated and differences are found, the next message box appears:
First, choose the source from which the data should be imported.
‘Import from XML’ imports from an XML file. Enter the name in the text box or select to select the button ‘…’ to
select the file.
‘Import from database’ imports from another database. Enter the connector text in the text box or click the
button ‘…’ to open the dialog box ‘Create Database Connection'. See 4.1, Logging on to another database.
Once the settings are made, press the Start button to begin the import.
After the connection is made, the current data model is transferred to the empty database.
Note: Different database providers use different field separators. Hereby Reports, Document
Attributes, and filters (stored in Document Settings and InfraMap) may become incompatible in the
new database. Before putting it into production, test the new database extensively.
Select the text file to be imported. Enter the separator to be used in order to separate the fields (‘\t’ is a tab):
If the separator does not appear in the list, you may also enter the separator manually. You can only use one
character. If the language in which the file was created, does not match the current Windows settings, you
have to select the appropriate language from the list or type the first few letters of the abbreviation until the
correct language is selected.
For control purposes, a question is asked:
If the answer is affirmative, the text file shall be checked for errors. If the text file contains errors, the following
error message appears: Check the text file for errors.
If no errors are detected, start the import process. The status bar in the Main Screen indicates the number of
Objects created.
If you have more than one Object selected, you have the option to only update the selected Objects. Use this
option also to improve speed significantly with large text files. If only one or no Object is selected, all Objects in
the Project or database are updated.
The Objects are located in the database using a key that checks each line in the text file. The Objects that are
located will be updated with the other attributes of the text line.
You specify the key in the following screen:
Subsequently you have to specify which fields should be updated. Do not check anything and press OK to
import all fields.
Next, you can specify if you want to update the Objects in the Current Project or want to use all / selected
projects:
If you selected No, select if you want to use the Objects in Selected Projects or All Objects:
6.2.3 Database
In the following screen you can specify which parts of the data model should be upgraded to the current
version:
You can enter or modify an SQL query in the text field. Only ‘SELECT’ queries are allowed.
If you press No, you can give the date and time. All Objects in the Recycle Bin that are deleted before this date
will be removed.
Note: If you delete Objects, they are first moved to the Recycle Bin. ‘Empty Recycle Bin’ deletes these Objects.
Use this command only if you are 100% certain these Objects are no longer needed.
Press Yes to deletes ALL Objects from the database, including all Connectors, Projects and Documents. Use this
command to create an empty database with the current data model. Press No to delete the Objects of the
Current Object Type in the Current Project.
Before you can run this command, you have to (literally) enter 'DELETE ALL OBJECTS' in the next screen.
6.2.4 Users
The Users button group contains commands for creating and managing users and user settings.
The overview below shows the Commands that require specific user rights.
Administrator commands:
Edit Model, Transfer Model, Delete All Objects, Purge Deleted Objects, Table Browser, Update Db
Schema, Upgrade Database, Lock Structs /Spec, Users Management (can manage Administrators),
Export with Ignore Model differences, File Browser with Delete option
Note 1: If a command demands special privileges, it is mentioned in this manual directly under the command
name.
Note 2: The Admin user name cannot be changed.
Note 3: Don’t tamper user properties outside IMS. These users will be locked. They can only be unlocked in the
User Management window by changing a property and save it.
Note 4: a user can change its password with the ‘Change Password’ command in the User Settings sub menu.
In the grid on the left-hand side, you will find the user groups. Here you enter the name of the User Group. If
the name is preceded by a ‘#’, you’ll create a utility group. A Utility Group is used as a helper group. It will be
ignored for Document Types, Report Definitions and Recycle Bin for none Application Administrators.
In the check-list on the right you will find the users. Check the users that are part of the selected user group. A
user can belong to multiple groups.
The tab ‘Object type mapping’ specifies the rights for an Object Type. An Object Type you can be linked to a
User Group that is allowed to create (Create Group), to edit (Edit Group) and to remove (Delete Group) Objects
of that specific type. If left blank, all users with write rights will have these rights.
Select the appropriate group in the box User Group. In the field 'Plugin file' you can select the plug-in to be
loaded. The plug-in files (DLL) should be in the IMS program folder; otherwise they will not be included in the
plug-in list. If necessary, change the description in the Description field.
With ‘Bulk Input’ multiple entries can be created. First type the column name (without table name), then select
the User Group for whom the entries must be made and select the applicable Object Types. Only Object Types
that have the column name in common will be selectable.
Note: Due to speed considerations, the column names are read from the database at start-up; therefore, IMS
must be restarted to see the changes. Note that 'Display Fields' may conflict with Hidden Columns. Delete
conflicting columns from the Display Fields.
This command allows to create multiple users with mostly the same properties.
The User Settings dialog box allows you to view and modify the stored user settings.
Select ‘User’ in the user selection menu. The grid now displays all settings stored in the database. Be careful
while changing settings. This might cause unexpected errors.
Since IMS 10.0, other windows can also contain plugin commands. The windows that support plugin commands
are: Main, NetView, InfraMap and InfraPlanner.
The creation of plugins is not within the scope of this document. To get more information of the development
of IMS plugins, you can contact us at [email protected].
Open the NetView screen by clicking the NetView Check Button in the Windows button group.
The NetView screen consists of three windows: the Home tab, the Properties window and the Viewer window.
The Viewer window is the drawing screen.
In the Properties window you will see the properties of selected Shapes. A Shape is a figure that represents an
Object.
Moving the cursor over an Object, enables you to see the connections as blue squares. Move the cursor over a
connection and the name of the connection is displayed. The color will change: green is a free connection, red
is a connection in use.
Click on a free connection and drag this one to another connection in order to connect them.
Please find below several NetView screen commands explained.
7.1 Home
7.1.1 New Graph
The New Graph command empties the current screen.
7.1.4 Open…
Open a previously saved Infra Graph (igx) file.
Note: Fields that have been changed in the database, will not be automatically adjusted in the graph. If
a file is created with another database, the file can be opened but synchronization between database
and graph will not take place (correctly).
7.1.5 Save
Save the current graph. If the graph has no name yet, you may now enter the name.
7.1.7 Print
The Print Graph screen appears. This can be used to provide a print of the NetView screen.
Where possible, the downward Objects are connected to the upward Object with the correct Connection Type.
The final situation may look like this:
7.1.17 Layout
Select the layout that best suits the current network topology. At this moment, two layout options are
available: Tree and Spring. Tree layout is the most suitable for tree structures; in this case only the network is
branching without feedback loops or loops. The graphs shown above are created with the Tree layout. The
Spring layout is suitable for networks with more complex network structures, for example containing loops.
The distance between components is divided as evenly as possible. If necessary, switch off 'Fixed Connectors'
for a better result. Experiment using both layouts to achieve the best result.
Note: If LinePath is defined in the Appearance of the Properties for the Object type, the setting of the
type of line does not affect the method used for drawing the connection. If the LinePath is set to
Rectangular, the RectangularLineShape can be set in the line Properties to five different shapes.
Figure 178
With this dialog box the NetView Document Types are managed. In a Document Type, the shape settings (like
appearance and layout) are stored. The individual settings are created and modified with the Properties panel
(see 7.2). With the Edit button, Document Settings dialog appears. Here the individual settings can be deleted.
7.1.20 X-Offset
Specifies the horizontal distance in pixels between two Objects if the network is drawn conform the Tree
method.
7.1.21 Y-Offset
Specifies the vertical distance in pixels between two Objects if the network is drawn conform the Tree method.
7.1.22 Up Direction
This Check Button allows you to determine whether the network should be read in the upward direction
relative to the current Object while executing 'Draw Network'.
Drag a connection to the desired location and drop it. Use the Save Settings button to save the locations; this
allows you to use them the next time.
This window enables you to specify the X- and Y-offset of the individual connector. If a number of connectors
have the same X- or Y-coordinate, respectively tick ‘Keep Current X value’ or ‘Keep Current Y value’.
The Apply button shows you the result on screen.
The Reset All button resets all connectors to their original position.
To divide the connectors evenly, use the Divide X and Divide Y buttons. First select the connectors to divide. To
divide horizontally, click Divide X. To vertically divide the connectors, click Divide Y. Enter the start value
(relative to the shape) in the following dialog box:
7.1.33 Snap
Turns Snap mode on or off. If Snap is turned on, this mode controls an invisible grid that restricts cursor
movements to specified intervals.
7.2.1 Appearance
The Appearance settings determine the Shape's appearance.
If you press the Add Color button, the three-digit RGB code will be entered into the input field. The Alpha
channel is missing. In case you would require this channel, you can easily add this in front. This is the result
with ARGB Code 20; 208; 77; 175 and 160; 208; 77; 175:
7.2.1.2 Color
This sets the fill color. For more possibilities, see the color input field 7.2.1.
7.2.1.4 ImageFileId
Defines the image used for the Object instead of the standard Object Type icon. Select an image using the
following dialogue box (the file is stored in the database):
7.2.1.5 PenWidth
Defines the thickness of the edge.
7.2.1.6 SelectedColor
Select the color of the Shape as it is. For more possibilities, see the color input field 7.2.1.
7.2.1.7 ShowBorder
Defines if the edge should be shown or not.
7.2.1.8 ShowLabel
Defines if the Label should be shown or not. Overruled the ‘Show Labels’ (7.1.29) setting.
7.2.1.9 ShowTextAsToolTip
Specifies whether the PopupText property of the shape must be shown as tooltip text. The PopupText property
can be formatted by the ‘NetViewControlPopup’ component in Display Fields.
7.2.1.10 TextColor
Determines the color of the text label. For more possibilities, see the color input field 7.2.1.
7.2.2 Automation
The Automation settings allows you to control the automatic drawing of the Objects.
7.2.2.1 AutoAdd
Determines whether a Sub Object is drawn automatically when the Owner is drawn. This only applies if
DrawSubjects (see 7.2.2.4) is switched on.
7.2.2.2 ClearNetView
Determines whether NetView should be cleared on drawing this shape. This property is used to the clear
current diagram when the starting shape is drawn.
7.2.2.4 DrawSubObjects
Determines if the Sub Objects of the Object should be added automatically.
7.2.2.5 Offset
Indicates the offset if the Object is drawn automatically. Works with ColumnRowField. For example: if the
Offset is 10,20 (X, column = 10, Y, row =20) and the Object has ColumnRow value D5, then the total offset
relative to the Owner will be: X = 10 * 4 = 40 (D is the fourth letter) and Y = 5 * 20 = 100
7.2.2.6 OffsetSubObject
Indicates the offset of the Object relative to the Owner if the object is drawn automatically.
7.2.2.7 OffsetXfield
The name of the Info field that holds the X offset value. Is added to Offset.X. Only applicable is the shape is
automatically drawn.
7.2.2.8 OffsetYField
The name of the Info field that holds the Y offset value. Is added to Offset.Y. Only applicable is the shape is
automatically drawn.
7.2.3 Layout
7.2.3.1 AutoSaveXY
Specifies whether the X, Y and OffsetX, OffsetY coordinates must be saved automatically to the database if the
shape is moved. Only applicable if XField and YField are set.
7.2.3.2 HeightFactorField
Defines the Spec field that determines the relative height of the Object. The value in this field is used as a
multiplier of the Size Height (see 7.2.3.5).
7.2.3.3 Location
Defines the current position of the Shape. Will not be saved in the Settings.
7.2.3.4 Padding
Specifies the surrounding space of the Shape. This is added to the current size (see Size) after all the sub-
objects are drawn automatically.
7.2.3.5 Size
Indicates the height (Height) and width (Width) of the Shape.
7.2.3.6 TextAlignment
The alignment of the text. Select Center, Near (left) or Far (right)
7.2.3.7 TextOffset
Indicates the offset of the text label relative to the Shape position.
7.2.3.8 WidthFactorField
Defines the Spec field that determines the relative width of the Object. The value in this field is used as a
multiplier of the Size Width (see 7.2.3.5).
7.2.3.9 XField
Specifies the Info Column that holds the X position. When set, overrules other position settings. If AutoSaveXY
is true, this field will be automatically set if the shape position changes
7.2.4 Misc
7.2.4.1 Filter
Specifies the criteria that determines whether the Object must be drawn. By creating settings with different
filters for the same Object Type, you can create different appearances, dependent on the object properties.
See also 7.2.5.
7.2.4.2 Mobile
Specifies if the shape can be moved.
7.2.4.3 PopupText
Specifies the popup text of the shape label. Use Display Fields with the component 'NetviewControlPopup' to
set the popup text.
7.2.4.4 Resizable
Specifies if the shape can be resized.
7.2.4.5 Text
The label text. Will not be saved in the Settings.
For the commands, InfraMap makes use of the Ribbon interface; the InfraMap screen contains two dockable
panels (see chapter 5). The Map panel shows you the map. The Layer panel shows you the layers. A layer is
linked to an Object Type. Objects are drawn in the Map as indicated in the Layers panel. A drawn Object is
called a Geometry.
At the bottom of the screen you will see the status bar. On the left you will find the cursor's location in latitude
(Lat) and longitude (Lon) degrees. On the right you will see prompts and instructions during the execution of a
command.
Pressing Enter or Space allows you to repeat the last executed command. This is also indicated in the Status
bar. See 8.3.
The last opened Map file is stored in the database and reused when InfraMap is reopened.
Note: copyright applies to some of the maps offered online. Additional conditions may be imposed on
the use and publication of the material.
Maps with satellite photos: ©2017 HERE, ©2017 Digital Globe, ©2017 Microsoft. All other maps: ©2017
OpenStreetMap
8.1.1 Panning
Panning allows you to move the map without changing the scale.
Using the mouse: press the middle mouse button or Alt and right mouse button and drag the map to the
desired location. This also works when another command is active.
Using the keyboard: use the arrow keys. The map is moved 10 pixels in the direction shown. If you
simultaneously press the Control key, the map moves 100 pixels.
8.1.2 Zooming
Zooming increases or reduces the magnification of the map. In InfraMap the mouse position is used as zoom
center.
Using the mouse: turn the mouse wheel up to zoom in. Turn the mouse wheel down to zoom out. This also
works when another command is active.
Double right-click to zoom to the maximum size of the map; all geometries are now visible on the map. This
only works if no selection is active.
Using the keyboard and mouse (zoom by window): Press Alt and click left. Drag a window and click left again.
Zooms in on the area in the window.
Using the keyboard: press - to zoom out; press + to zoom in.
8.1.3 Selecting
Before you can alter the geometries, you have to select them first. You can only select geometries when no
other command is active. A selected geometry is given in red dots. Each point in the Geometry has a Grip point.
A Grip point is a black square. If you press the Grip point, it turns active and becomes red.
Left-click on the geometry/geometries: the geometry/geometries of the top layer are selected. Geometries on
other layers are not selected. In order to select only one geometry, you have to click on the location where
there is only one geometry.
Drag a window to the right. Click again with left. All Objects that are inside the window are selected. See
figures below.
Press X while dragging a window: you are now able to draw a polygon. Close the draw function by pressing
Space or Enter. All Objects inside or partially inside the polygon are selected. See figures below.
If you have made a selection and you right-click in the map, the 'Select Geometries' pop-up will appear. This list
shows all selected geometries. The items selected in the list are selected on the map. You can confirm the
selection by pressing Space or Enter. The Escape button cancels the changes in the selection. Double-clicking an
item selects the item and closes the box.
You can also draw a line with a given length. Give the start point of the line and locate the cursor in the correct
direction and right click. In the next dialog box the distance to the next point is given.
Figure 194
Accept the value and a line is created with the given angle and distance.
Figure 195
After selecting a geometry, it can be directly edited by selecting a Grip point. There are two types of Grip
points: Black Grip points represent real points. In the figure above, this are the edges of the figure. The gray
Grip points are virtual points. They don’t exist yet, but when they are dragged, a point will automatically be
inserted in the geometry.
To move a point, left click on a point and drag it to the desired location and click left again:
When drawing or stretching lines you can also draw orthogonally (perpendicular). Use Ctrl Shift to draw
perpendicular from the last position:
8.2 Layers
The Layers panel displays all layers in a grid, see Chapter 14. A layer is associated with an Object Type to be
drawn on the map. A layer may also be linked to an External Data Source or a Web Map Server.
The layer with the focus, is the active or Current Layer. When you create a new Object in InfraMap, this layer is
used.
Note: The Layer panels are stretched, see below. This makes all columns visible. In the standard layout
you can make these fields visible using the slider at the bottom.
Each layer has a number of properties. The columns and associated functionality are listed in the table below.
Column Explanation
Name Select the Object Type of the WMS layer from the drop-down list.
Index The index number determines the level at which the layer is drawn. The layer with the
lowest number is drawn last and will cover all other Objects in the same location.
Type Determines the type of the Geometry: None, Point, Line, Polygon, Image.
Category An optional name for a collection of layers. Layers can be grouped (see below)
Color The line color of the layer.
Style To set the style of the layer. See 8.2.4
Labels Labels are attributes of the Object Type to be displayed on the map. See 8.2.5
Visible Turns the visibility of the layer on and off.
Show Labels Turns the visibility of the labels on and off.
Selectable Turns the ability to select the layer on and off.
Editable Determines whether the layer may be changed.
Scalable Determines whether geometries scale to the zoom level.
Max Zoom Maximum zoom level above which the layer is no longer visible.
Min Zoom Minimum zoom level below which the layer is no longer visible.
Projection The coordination system of projection that is used for the layer (e.g. RD or WGS84).
Filter The filter that determines whether an Object is visible or not.
Filter on/off Toggle the current filter on or off.
Note: If the Geometry Type is set to Image, the first file in the Object files will be used as image.
To add a new Layer, press the (+) sign at the bottom of the panel and select the Object Type from the Name
popup list.
The interface of each plugin differs and will be described in a separate document. At time of writing, two plugin
libraries are available:
- GDAL External Source. GDAL / OGR plugin. For files supported, see
http://www.gdal.org/ogr_formats.html
- DXF External Source: Extended DXF support (in comparison with GDAL plugin)
By default, the new layer will have a min zoom level of 17 and a max zoom level of 24. This to prevent
exhaustive data loading.
Function Explanation
Move Layer Up Moves a layer up. This is the same as reducing the index of a Layer by one.
Move Layer Down Moves a layer down. This is the same as raising the index of a Layer by one.
Default Proj Select the projection or the coordinate system that is to be used as default for
new layers. In The Netherlands RD is generally used.
Correct <projectie> Correct deviations in the projection. See below.
Show Project Layers Display all layers that may be used in the Current Project.
Set all Layers Visible Set all layers to visible.
Set all Layers Invisible Set all layers to invisible.
Restore visible Layers Restore the visibility of layers to the settings before the last use of ‘Set all Layers
(in)visible’
Use Object filter Copies the filter in the Objects panel to the Layer filter (only applicable if Current
Object Type and Layer Object Type are the same).
Show Attribute window Show the External Source Attributes window for External Source Layers
Set properties for Shows the Layer Properties dialog, so you can set properties for multiple layers.
selection
Note: The correction only determines which way the geometries are displayed on the screen. Changes
are stored in the original projection.
A Right click on the Group header will show the Select Group Rows popup. Select this command to select all
rows in the Group. This makes it easy to change (multiple) properties on multiple Layers. See ‘Set properties
for selection’.
It shows the attributes of selected external source geometries. In this window a filter can be composed. With
the ‘Set Layer Filter’ button, this filter will be copied to the Layer filter.
The layer style determines the way in which geometries are drawn on the map. Each geometry type has its own
style pop-up dialog box. The above figure shows the most comprehensive window. In the explanation of the
elements, we will indicate which setting applies to which geometry type.
8.2.5 Labels
Labels allows you to display the attributes from the Info and/or Spec table on the map at the geometry.
Checked fields are displayed on the map. If a selected attribute is checked, the panels on the right become
active. Here you can enter Label color and alignment settings.
8.3.1 Coordinates
The coordinate field shows the current cursor position. By default the coordinates are displayed in WGS84
(height, width). If the switch ‘Show Local CS’ is switched on (see 8.3.4.4), the coordinates are shown in the
coordinate system of the current layer.
8.3.2 Price
The price field shows the total price of all the selected geometries. This field is only active if the Show Cost
switch is switched on (see 8.3.4.3).
8.3.3 Message
The message field displays messages that are of interest to the user:
It also displays messages that might be useful while entering and changing geometries:
The commands on the Ribbon are divided into several Tab Pages and Button Groups. We will discuss the
commands in the Home Tab Page using the button group subdivision.
8.4.1 File
8.4.1.4 Save As
Saves the Map as a file with a different name.
8.4.1.6 Export
The command Export allows you to export the current map into three formats: KMZ or KML (Google Earth and
Google Maps, KMZ is the zipped version of KML), DXF (CAD applications like AutoCAD and Bricscad) and TXT
(Well-known text).
When exporting KML or KMZ, use ExportKML as component in Display Fields for the name of the shape. Export
of the geometry labels as Extended Data can take a lot of time. Don’t export them if they are not needed:
Figure 212
You can choose to export points as Google Icons or with the InfraMap Point settings. In the latter case, if
MapLineColor and MapFillColor exist in the Spec table, they will be used. Info colors will be ignored.
If KMZ is exported, the local icon files are added to the KMZ file. If KML is exported, you must copy the local
created image files with the KML file. Otherwise a red cross is shown instead of the icon:
When DXF is exported, the Point Objects are replaced by Point Entities.
Once the file is stored, you will be asked if the file has to be opened in the specific application.
With this dialog box, the generation of the pdf is configured. You can create a multiple page pdf, with different
paper sizes, scales and title blocks.
First select the File you want to create.
You can optionally add a title block to the pdf page. You can use an existing image (bmp, jpg or png) or a report
definition file. In the latter case, an image file will be generated from the report. The image will be placed at
the given location. Below is a short description on how to add extra parameters to your title block.
To prevent the title block overwriting part of your map, you can set margins for the bottom and right part of
the pdf (you cannot use the margins if the location of your tile block is at the top). You first need to calculate
the size of the title block in millimeters. If the title block occupies mostly the bottom, only set the bottom
margin. If it occupies the right part, set the right margin.
Select the paper size, print area and (optional) the scale.
The Cluster layer will always be drawn in the pdf. To draw normal layers over the clusters, check ‘Draw clusters
behind layers’.
Printing of layers with transparency takes a lot of time and memory. Check ‘Ignore Transparency’ to prevent
this.
Figure 218
To automatically generate area pages, select the polygons to use before you start the Export to PDF command.
Click ‘Generate Area Pages’. All pages will be generated with the current paper size. The scale will be ignored.
The paper will be automatically rotated if this will better fit to the size of the area.
Note: only GeoStructOSM, Open Street Map or User Defined Map can be used as background map. Printing of
other maps is prohibited. If another map is used, it will be replaced by Open Street Map.
The Area settings can be saved. Enter the name in the ‘Saved Areas’ text box and press Save. To load a setting,
select the name from the Settings list and press Load.
As said above, a title block can be generated from a report definition. When creating a new report, select the
Title Block option. Optionally select the template to use.
In the report definition, extra parameters can be used to add information to the title block. The parameter
name must be one of the following: PDFExportPage, PDFExportScale, PDFExportObjectsOnPage or
PDFExportPageSize.
Parameter PDFExportPage adds the current page number and total page number (as ‘1 / 2’) to the title block.
PDFExportScale adds the scale of the current page to the title block. PDFExportObjectsOnPage adds
concatenated text of the selected geometries to the title block. For the text, the Reports Display Fields are
used. PDFExportPageSize adds the name of the paper size of the current page to the title block.
To add one of these parameters, in the Report Designer, right click the Parameters item in the Field List. Click
Add Parameter.
Once added, the parameter can be drag and dropped on your report.
Before running the command, you have to select the KML or KMZ file to be imported.
Before a KML file is actually imported, you have to link the KML Styles to the IMS Object Types. This happens in
the following dialog box:
On the left you find the KML Style Names. Select the Style to be imported. From the list on the right hand side,
select how the Style should be converted to an IMS object. It is important to figure out in advance which type
(point, line or polygon) the Style has in the KML. After selecting the Object Type from one of the lists, you have
to add the link; to do so, press Add Mapping.
Select the Projection (Coordinate System). All KML geometries will be converted to this coordinate system.
Note: when Projection ‘Unknown’ is selected, no coordinate conversion will take place and the GeoLength
cannot be calculated correctly. If the target projection is unknown, It’s better to use Projection WGS84 instead.
Don’t use Projection None. It will cause errors when loading the geometries in the map.
After all mappings have been set, press Start Import in order to start the import operation.
You can store and recall settings with the Settings popup list.
8.4.2 Edit
The Edit functions can only be applied on previously selected geometries. To select, see 0.
Note: the Objects are not deleted from the database. In order to do so, see 8.4.4.14, Delete Objects
Figure 224
If affirmative, the intersections will be calculated and the following message appears:
If this is the desired result, press Yes. Changes are now being implemented.
Select Yes it the lines at the first point should be used to match the point Objects. Select No to use the last
point.
All Point Objects are checked one at a time, at every point the following question appears:
The current point Object is in the middle of the screen; it can now be checked or moved to the correct point:
Confirmation will copy all Geometries on all visible layers that can be modified within the selected polygon and
cut these off if necessary. New Objects will not be connected.
8.4.3 Drawing
The commands in this button group allow you to draw Objects from the database on the map.
The network is built based on the parameters specified in Network Setup. All connections that are not drawn,
will be drawn via the shortest path.
If you have achieved the intended result, press Enter or Space. Press Escape to abort the entry.
8.4.4 Objects
The commands in this button groups allows you to create geometries and Objects in the database.
Enter the position in the Map. This creates the Template in the database; the Geometries are drawn on the
entered position.
In this screen you can specify the required connections in the ‘From...’ and ‘To…’ dropdown list. Additionally
you may add sub object connectors to these dropdown lists using the Add Sub Connectors button.
Next use 'Connection Type' in order to specify the connection type.
Press OK to enter and draw the new connection, if possible via the shortest path.
An Object can also be connected to a cable. In that case you have to leave Connection Type blank.
Select the Central Object or press Escape to cancel. New connections are entered and drawn, if possible via the
shortest path.
Then select the Object Type to be inserted from the pop-up list (double-click the desired Object Type or press
Enter):
This calculates where to place the Object by calculating the position providing the minimum connection length.
If the optimum cannot be calculated for whatever reason, you will receive a message and the command will be
cancelled:
If this command can be executed, the optimum is represented by the red circle, as shown below:
If you answer Yes to the question given in the dialogue box, the new Object shall be placed.
If multiple connection types can be used, the type must be choosen:
New connections will be created between the new Object and the selected Objects using the shortest path. See
figure below.
Note: If the selection contains only one Object, you can calculate the optimum position for this one
Object.
The selected connection is split in two; both parts can be connected to the selected Point Object via the
following dialogue box:
Note: Agree with your colleagues who is working in which area or Project. This avoids ambiguities and
errors.
Note: you can also use these maps to work off-line temporarily. Be careful when emptying the Map
Cache.
8.4.6 Settings
Many maps are copyrighted. Before using a map, check if you are allowed to use its material. If so, click OK.
Otherwise, click Cancel.
8.4.6.6 Retrieval
Determines how Geometries are read from the database.
• Current Project: Geometries in Current Project are displayed (see 6.1.4.1).
• Current View: Geometries of Object in the visible area are displayed.
• Selected Projects: Geometries in the selected Projects are displayed (see 6.1.4.1).
In this panel you see the selected geometry as a straight line with points. Each point has an index number. This
number is the reference with the original geometry, as shown below in the Map with number 1 as start point
and number 9 as end point.
To move points in the Z direction, select all points that must be moved to the same Z-coordinate. Select by left
clicking in the grip point (notice that the selected points get a purple circle in the map). The Z coor field will be
set on the Z coordinate of the last clicked point.
Now enter the desired Z-coordinate in the field and check ‘Move Points’ and set ‘Left straight line’ and ‘Right
straight line’
Because the check boxes ‘Left straight line’ and ‘Right straight line’ are on, extra points are inserted to create
the line straight up and down.
With the Select All button all grip points will be selected. This is convenient when many points must be moved.
To deselect a point, left click on the selected point. To clear the selection, left click outside a grip point.
Use Delete Points to remove unused or unwanted points.
The ‘Use User Settings instead of Global Settings’ check box is only available for Application Administrators.
They can set the Trench Content for all users by unchecking the check box. All other users can only set the
trench content for individual use.
Notes: In order to define the Labels to be used, you have to add the appropriate fields in 'Display
Fields' to the 'TrenchContent' component (see 6.1.7.2).
The labels will be sorted. To manipulate the sorting, you can use the following sorting characters to
prefix the label: '#', '$', '%', '&', '{', '|', '}', '~'. The first four characters will become the first in the list,
the latter four will be at the end. The sorting character will be removed from the label before showing
on the map.
The ‘Use User Settings instead of Global Settings’ check box is only available for Application Administrators.
They can set the Junction Content for all users by unchecking the check box. All other users can only set the
junction content for individual use.
Note: In order to define the Labels to be used, you have to add the appropriate fields in 'Display Fields'
to the 'JunctionContent' component (see 6.1.7.2).
This command sets the current layer to ‘Oriented Label Layer’ (the current layer has to be a ‘Line’ layer):
2- Draw an Oriented Label in InfraMap using the Geometry to be labelled as starting point.
The first method is the fastest but is less flexible. You need to modify the structure to enable the adding of the
label to the Owner. You also need to add the label as Sub-Object to the Owner.
Here you may enter the maximum distance between trench nodes. If the distance between two nodes is
greater than the value entered, no shortest path will not found from one trench to the other.
These commands provide you with support when creating paths, for example trenches.
Before you can run this command, there has to be a trench to which the house inputs can be connected. First
select a Geometry of the correct type (here a Trench) using the 'Create Object' command, see 8.4.4.1.
After you have entered the trench, you may select the house connections and the new trench.
If the 'Auto Split' Check Button is turned on, the trenches will be split automatically.
Important Note: if the paths contains Z or Alt coordinates, these will be removed. This is shown in the window
title. Be aware of this before starting this procedure.
If the Object of the line contains the field ‘TrenchOffset’, the value in this field will be used to create the
trenches. If the column is missing, the value, as entered in the dialog above will be used. If the value is zero (0),
a copy of the line will be created.
Note: The OSM Loader plugin can be used to load Open Street Map roads into the database that can be used as
the lines to offset. This plugin will automatically fill the TrenchOffset column with the correct values.
After given the maximum crossing length, the crossings are made:
Note: If the distance between two crossings is less than 1 M, the crossing will be skipped.
Once confirmed, all separate paths are replaced by a solid path (up to the first junction).
This dialogue box allows you to control and monitor the process.
Max allowed gaps: specifies the maximum allowed distance between two paths that are automatically split.
Max confirmed gaps: specifies the maximum allowed distance between two paths to be split when confirmed
by the user.
Press Start to start the process. If the distance between a spilt point and the Path is greater than the ‘Max
allowed gaps’ and smaller than ‘Max confirmed gaps’, the split point is marked with a red circle; the specified
Zoom Level zooms in to the split point and the question appears:
If you press Yes, the end point of the Path will be moved to the red circle and the Geometry will be included in
the 'splitting' process.
This group of buttons (test) contains commands for the shortest path algorithm. The shortest path calculation
is used to draw lines on the map. Paths should be drawn contiguously; between paths, you can only use end
point or nodes as the starting or ending point of the shortest path.
Note: paths with length 0 often cause overlap. You may delete these paths from the database without any
problem.
Nodes that are not able to reach each other, will be drawn as colored circles.
Figure 303
The short path calculations uses the path resistance to calculate the path
Typically, if a path becomes cheaper if it contains connections, the resistance must be set between 0 and 1. An
individual connection can become longer, but less path links will be used. On the other hand, if a path becomes
more expensive, the value must be bigger than 1. Set the resistance to 1 if you always want to use the shortest
path for new connections. See the figures below.
After pressing OK, you have the option to calculate the used path resistance for each path link.
Note: on startup and when connections are deleted, the path resistance is NOT set or updated. So be
sure to set the used paths after startup and again after connections are deleted. If path resistance is
8.5.3 Grouping
The grouping commands are meant as support while design of a network; they include for example finding
Objects that are close to each other.
After buffer distance input, the buffers are drawn on the Current Layer:
In case the buffers are created around point geometries, semi circles are created (polygons with multiple points
to mimic a circle).
Auto Cluster uses the current InfraMap selection. If no selection is made, all Objects on the Current Layer are
used. Next, you will have to select the Object type that should be used to connect new Clusters to:
Press OK to start Auto Cluster. After initialization the current calculation status is displayed on screen using
Cluster colors:
The status bar indicates the progress, for example, best price so far and which Geometry was used.
You may choose to create all clusters all at once (press Yes) or to create individual clusters (press No). If you
press Cancel, no clusters are created.
Here you may enter, optionally, the maximum deviation in respect to the maximum connection count. This
allows the process to limit cable length or to minimize overlap.
Testing takes place in order to determine which objects can be used for the clustering; the objects must have
the correct free connection and be located on a path link. If no suitable objects are found, the following
message appears:
After these checks have been carried out, the following message appears:
If you press Yes, the optimization process is started. The clusters are drawn on screen in order to follow the
process.
Press Yes to create all groups. Press [No] to create individual groups. The program zooms in to an individual
group and the following message appears:
Next, indicate if you would like to interconnect the Objects automatically or if you would like to see the
'Connect Objects' dialogue box (see 8.4.4.3):
Finally, enter the maximum number of Objects that may appear in the chain. If this number is lower than the
number of selected Objects, Auto Cluster will first calculate which Objects can best be placed in the chain.
Note: This number cannot exceed twelve. TSP Solver, containing a faculty function, is used in order to
calculate the route. 12! = 479.001.600. Nearly 500 million calculations are required to calculate a route
with 12 points.
If you select to connect the Objects automatically, the following message appears afterwards:
Note: because only one structure will be inserted, the structure min count and structure max count is not used.
Be sure the structure you want to use contains all components in one structure.
After selection is made, you may optionally select the end terminator:
The cables are replaced by a new structure or added to a new owner. The latter is the case when the selected
cables form part of a Concept Structure. See 6.2.1.2.
8.5.5 Utilities
If you have selected two Objects, switch on the 'Use Selected Object' radio button.
If ‘Use Selected Object’ is switched on, the route between these two objects is determined.
If ‘Use Address’ is switched on, the route between two entered addresses is determined.
Addresses can be selected using the buttons from the map. In order to view the specified address on the
map, press the button.
Optionally, click ‘Avoid Highways’ in order to avoid highways. Click ‘Use Walking Route’ in order to determine
the walking route.
If you press Yes, the addresses are searched. The following result is displayed:
8.5.5.5 Measure
Draw a polyline; the total length is shown in the status bar.
And give the distance that must be measured over the network connections:
When only lines are selected, new objects on the current layer will be generated on a given distance:
Figure 346
Here you give the distance in meters that the new geometry must be translated, relative to the original
geometry. Click on geometry for the start point or press Escape to use the line start point (green point), give
end point or escape to use line end point (red point). Finally give the side by clicking on the location.
You can offset this line; press Cancel to create a line without offset:
The Convex Hull method will be used to calculate the two possible lines:
Select the project to use as target project. The geometries will be moved to this project.
Always select a Sub Net (see 6.2.1.4) that has a network calculation plugin, otherwise no results will be shown.
After calculation, the number of network faults are shown and the geometries with faults are selected:
8.5.7.1 WMS
Display the Web Map Server dialogue box. This allows you to add Web Map Servers as data source. A WMS
layer is drawn in the same order as other Layers and is always drawn after the base map is drawn:
As example a number one server is predefined. You can open a server in order to see more details. Click on an
item to view the Map Info.
Always check Info to learn which SRS (Spatial Reference System) is supported. See Appendix 16.1 for the SRS
Ids supported by IMS.
If you have found the required layer, you can add this layer to the list of available layers by pressing Add Layer.
Before you add the layer, you can select the Image type that will be used. Only types that are available on the
server, are selectable.
The WMS layers are added to the ‘Name’ section list in the InfraMap Layers panel. You can change the name of
the layer in the Layers panel. Use Delete Layer to delete the selected layer.
Enter the server web address (Server URL). The URL must only contain the path and no query string
parameters (like ‘?request=GetCapabilities’). You can use a previous defined server from an existing InfraMap
layer. Press the ‘Select layer server’ button and select the server from the list.
If the server requires authentication, add your username and password in the appropriate fields.
Use the Add button to add to the new DXF files to the list.
You can delete the selected files using the Delete button.
Thick ‘Disable DXF File loading’, if you do not wait to load these files (temporarily).
Sets the projection to the value that corresponds to the coordinate system in which the drawing has been
created. In the Netherlands this usually RD.
‘Min zoom’ and ‘Max zoom’ determine the zoom factors of the drawing.
The Resources panel shows the resources/employees, as specified in the data model. Checking a resource will
display it in the Planner screen. This enables you to view several resources simultaneously.
The Calendar panel allows you to select the period that should be displayed in the Planner.
The Alerts panel shows the alerts that have occurred. An alert is a notification on a task that fails to obtain the
correct status on time. See 9.1.7.
The Planner screen displays the current scheduled tasks for the selected resources. This may concern tasks that
are linked to Objects, but could also be manually scheduled tasks.
The planner screen contains two tab pages: the Scheduler screen, that works like the Calendar in Outlook, see
https://documentation.devexpress.com/#InterfaceElementsWin/CustomDocument4849.
The Grid view shows the tasks in a tabular form. Here you can easily search, filter and modify tasks. You can
also sync the scheduler or the Current Object by using the appropriate command from the popup menu.
In this screen you can enter the general settings for the Planner.
- Visible Time: ‘Start time’ and ‘End time’ indicate the start and end time visible in the Planner.
- Time Scale: ‘Interval for time slots’ indicates the smallest plannable unit.
- Show Tasks: ‘Show tasks only in limited time interval’ limits the period of which the tasks are read,
based on the ‘Backwards’ and ‘Forward’ set limit. You may want to select this option when opening
the Planner takes a lot of time.
9.1.2 Resources
This command is only available for Document Administrators
Before starting this command, be sure to set the Current Project that allows adding resources. Otherwise, the
command will show a message and exit.
The Resource Wizard simplifies the creation of multiple resources and the corresponding IMS Users. The wizard
is self-explanatory. Follow the instructions on the screen.
9.1.4 Activities
This command is only available for Document Administrators
The Activities window allows you to define activities and link these to Task Object Types. The Activities are
editable for Application Administrators and read only for Document Administrators.
With Duration you specify the time needed to execute the activity.
When a task has sub tasks (that is: a Task Object that can contain Sub Objects of the Task type), you can define
how these tasks must be planned relative to the owner start time. There are three options: Start, Mid and End.
You can also set Expand Owner. If checked, the owner task planned End time will be set to the end time of the
last sub task end time if this is later than the current end time.
If an activity can be interrupted for a lunch break, set 'Dividable by Break'. And if it can be broken by end of the
day, set 'Dividable by Day'.
The 'Use Length' field indicates that the GeoLength field of the Object should be used in order to calculate the
duration. If checked, duration will be interpreted as duration / meter. The Task duration will be GeoLength *
duration.
You can use the 'Use Field Value' in combination with 'Info Field' if another Info field value is used instead of
‘GeoLength’.
‘Workset Configuration’ allows you to configure a work set for field workers. The work set configuration is used
by client apps (such as GeoWorks) to support the execution of tasks. The work set configuration contains the
properties that the field worker must fill in, while or after executing the task.
In the Miscellaneous part, you can configure some additional properties. The exact implementation on the
client side is dependent of the client app.
- Allow create task: if checked, new tasks can be created or copied.
- Show Object Files: the files that are linked to the Task Object, can be downloaded and viewed in the
field app.
- User must update or add Geometry: the geometry that belongs to the Task owner must be added or
updated in the field app.
- User can update spec: if checked, the Spec ID of the Task Object can be updated by the field
technician. Select the spec column to show in the field app.
- Screen mode: sets the default startup mode of the field app.
- Take Picture. There are three options:
o None: no picture can be taken
o Optional: it is optional to take pictures
o Mandatory: at least one picture must be added to the task
- Sign: see ‘Take Picture’
- Map Layers to add: defines the layers that can be used by the field worker to add to the map. This will
not create new task but only new Objects and Geometries.
- Default Map Zoom level: the zoom level that is used at startup of the field app.
GeoStruct has developed special web applications that seamlessly integrate in office, back office and in the
field work. For more details, please mail to [email protected].
The Resource tab allows you to link resources to activities. This allows you to know which resource can perform
a specific tasks.
9.1.5 Workweek
This command is only available for Application Administrators
Click the resource(s) for whom you would like to define the work week. In the ‘Work days’ list, select the work
days for these resources. In case there are work days with different working hours, you have to select these
separately.
Next, indicate ‘Start time’, ‘End time’ and breaks (‘Break start’ and ‘Break end’) for these work days.
Press Save to store the Work days.
If necessary, repeat this procedure for other resources.
Select the days on which the resource has a day off (use Ctrl and/or Shift keys for multi-selection).
9.1.7 Alerts
This command is only available for Application Administrators
Alerts allows you to set which activities generate a notification if they fail to obtain the correct status on time.
You can view these messages in the Alerts sub-panel in InfraPlanner. Also, an Alert popup is shown.
Select the activity to be monitored from the Activity list. Next, select the Status (Planned, Started, Finished
etc.). You may change the control parameter (is / is not) in order to indicate if the status must have the
specified value or not. Specify the amount of time after which this status value should be reached. You may
also change the message that is shown.
To delete an existing alert, select it from the ‘Existing Alerts’ list and press Delete.
9.2.1 Refresh
This command updates (refreshes) the tasks and resources by re-reading them from the database.
Note: This command is identical to ‘Add Tasks for Selected Objects’ in the pop-up menu of the Planner.
Proceed as follows:
- Select the start date for project in ‘Start Project’
- In ‘Activities to Execute’: select the first activity to be executed. Thick ‘One Resource per Activity’ if
you only require one resource per Object. Thick ‘Dependencies must be Finished’ if all dependent
Objects must be scheduled before this activity can be executed. All the other fields are for information
purposes only and cannot be changed.
- Go to ‘Objects for Activity’ (right grid), select the Objects to be executed by a resource and select the
resources required to execute these Objects. Repeat until all Objects are linked. Alternatively, you can
select 'Use all Resources'. This allows you to schedule all resources for all Objects.
- Repeat all steps for the next activity. If different tasks have to be executed sequentially, you can add a
dependency with ‘Dependencies for Selected Activity’.
After all settings have been made, a proposal is calculated by pressing ‘Analyse’. The calculation result will be
written in the Start and End fields. After the analysis has been completed, you will have to check the calculation
accurately. Once you have approved the schedule, this can be finalized by pressing the 'Create' button. The
schedule is created in the database and the tasks will be displayed in the Planner.
The 'Show in Map' button displays the progress of the work in InfraMap. All relevant geometries are
temporarily hidden and switched on step by step. This makes the spatial distribution of the work transparent.
This location is approximate and thus gives only an indication of the Object in the field.
In the panorama picture can be navigated. Go to http://www.google.com/streetview/ for instructions.
For locations where Street View imagery is not available, Street View shows a gray generic image, with the text
"Sorry, we have no imagery here."
Building a network starts at the current connector(s). If ‘Use all Connectors’ is not checked and no explicit
connector is selected in Object Detail, the first connector of the Current Object is used. If ‘Use all Connectors’ is
checked, all connectors of the Current Object will be used.
Click ‘Get Up Network’ to build the network in an upwards direction (from input to output).
Click ‘Get Down Network’ to build the network in a downwards direction (from output to input).
If necessary, select a Sub-net (see 6.2.1.4) to indicate the boundaries of the network to be built.
Check ’Include Type’ if the name of the Object Type must be included in the Object description.
Check ‘Use all Connectors’ if all connectors of the first object must be used.
Check ‘Show Connectors’ if the connector columns must be shown between the objects.
Use the ‘Export to Excel’ to generate a spreadsheet of the current grid view.
The ‘Select Data Source’ command links database information to the Snap document; select one of the Object
Types from the list:
Select the desired fields from the Data Explorer list (multi-select, drag to the empty document):
With Report Designer reports can be designed and made available to specific user groups.
Reports are designed in the Report Designer Panel. This chapter covers only a few important features of the
panel. For a detailed description see Report Designer.
Click on ‘New…’ to create a new report. The following dialog box appears:
• Report Name: the name of the report. This name must be unique.
• User group: the user group who may use this report (see 6.2.4.1.2). Document Administrators can only
create or edit reports that have a User Group the user is part of. Application Administrators can edit all
reports.
• Choose the type report:
o Standard Report: choose a Table or View and the columns to be displayed.
o Cost Report: to create a cost calculation.
o Connection Report: all connections of the current Object are displayed.
o Strand Report: not to be used, only available for compatibility
If Cost Report is chosen, the following window appears:
Select the desired fields of the Object Types that have to be included in the report. The values entered in the
columns ‘Length Fields’ and ‘Length Price Fields’ will be multiplied to obtain the total price. This combination
will mainly be used for connections and paths. The ‘Unit Price Fields’ are mostly used for object.
After the window is closed, a blank report will be generated. The report can now be arranged at its discretion.
To quickly achieve results, the Reports Wizard can be chosen. For that click the arrow:
Note: if the Spec column is used from the CostTable (see Field List), the fifth (5 th) column from the Spec table is
used if it exists. This is the first column that is not automatically generated by IMS.
If the basic parameters need to be changed, choose ‘Modify…’. The same window is displayed as described for
‘New…’.
There are several panels and windows that use a grid control, for instance the Objects panel. Here we will
explain the general capabilities of the grid control. Every individual panel or window may have its own specific
tools. They will not be explained here but in the chapter for that specific component. It’s also possible that
components that use the Grid control have disabled some capabilities of the Grid control.
Remark: the color of the screen pictures differ from the rest of this manual. That’s because these picture were
made with a different Skin (see 6.1.8).
If a cell editor provides a dropdown, you can activate the editor and open its dropdown by pressing ALT+DOWN
ARROW or F4.
To sort records by a column's values while preserving existing sort conditions, do one of the following:
• Click a column header while holding the SHIFT key down, until an Up or Down Arrow icon is displayed
within the header.
• Right-click a column header and select ‘Sort Ascending’ or ‘Sort Descending’ from the context menu
that appears:
To remove sorting by a column, click a column header while holding the CTRL key down. You can also select
Clear Sorting from the column header context menu.
To remove grouping by all columns, right click the group panel and select ‘Clear Grouping’ from the context
menu:
The filter dropdown list will be immediately closed, and the control will display the records which
contain the specified value in the specified column field.
If the filter dropdown list provides check boxes to the left of filter values, multiple values can be
selected (checked) simultaneously:
In this mode, click OK to close the filter dropdown list and apply the filter.
You can sequentially filter data against multiple columns using the method described above.
Use Microsoft Excel Style Custom Filter Dialog
• If the filter panel at the bottom of the grid control is visible, click the ‘Edit Filter’ button:
The Filter Editor is also invoked when choosing the (Custom) item in a column's filter dropdown list, if the
current filter criteria applied to the column consists of three or more simple filter conditions, or if the filter
criteria contain advanced comparison operators such as ‘Is between’ and ‘Is any of’.
To learn how to work with the Filter Editor, refer to Filter Data via the Filter Editor.
• Focus the group row and press PLUS (to expand the row) or MINUS (to collapse the row).
• Focus the group row and press RIGHT ARROW (to expand the row) or LEFT ARROW (to collapse the
row).
To expand or collapse all group rows, right-click the group panel at the top of the control. This opens the group
panel context menu. Then select Full Expand or Full Collapse respectively:
• Focus the master row and press CTRL+PLUS (to expand the row) or CTRL+MINUS (to collapse the row).
• Drag and drop a column/band header onto the Customization Form if it's open:
The Customization Form will be displayed listing hidden columns and bands (if any):
2. Drag the required column/band from the Customization Form onto the column/band header panel
and drop it at a specific position.
To change the widths of all columns so that they display their contents in the best possible way, right-click the
header of any column and select ‘Best Fit (all columns)’.
To focus the first cell within the current row in Grid Views, press HOME.
To focus the last cell within the current row in Grid Views, press END.
To move focus to the Auto Filter Row displayed at the top of a Grid View, do one of the following:
• Click this row.
• If a top data row is focused, press CTRL+UP ARROW.
To move focus between rows while preserving the current selection, use CTRL+ARROW keyboard shortcut
Select a Range of Rows
To select all rows, press CTRL+A. Before pressing this shortcut, ensure that the focused cell is not being edited.
Note:
A filter condition group is a set of conditions combined by the same logical operator. The following filter
expression contains two groups combined by the logical OR operator: "([Product] = 'Chang' And [Quantity] >
20) Or ([Product] In ('Tofu', 'Konbu') And [Quantity] < 100)". In the Filter Editor it's represented as follows:
For step-by-step examples of creating filter criteria, see Examples of Using the Filter Editor.
To add a condition or a group of conditions that have been copied to the clipboard, press CTRL+V or
SHIFT+INSERT. The new condition will be added to the focused group.
To cut a condition/group of conditions to the clipboard, focus this condition or the group's logical operator and
press CTRL+X or SHIFT+DELETE.
To cut a condition or a group of conditions to the clipboard, focus this condition or the group's logical operator
and press CTRL+X or SHIFT+DELETE.
To paste a condition or a group of conditions from the clipboard to the focused group, press CTRL+V or
SHIFT+INSERT.
To activate the operand value's edit box without changing the value, click the value or focus the operand value
via the keyboard and press F2, SPACE, ENTER or ALT+DOWN
To discard changes to the value and close the active edit box, press ESC.
14.12.8 Navigation
To focus a specific filter condition or a group's operator within the Filter Editor, do one of the following:
• Click the target element.
• Use arrow keys to move focus via the keyboard.