exor mapcapture installation guide · 2014-03-26 · exor mapcapture installation guide...

Version: 4.7 i

CONFIDENTIALITY STATEMENT

The contents of this document, including system ideas and concepts, are confidential and proprietary in nature and are not to be distributed in any form without the prior written consent of Bentley, Inc.

EXOR

MapCapture Installation Guide

February 2014

Version: 4.7

Submitted by:

Bentley Systems (UK) Ltd.,

9th Floor,

20 Gracechurch Street,

London

EC3V 0BG

EXOR

MAPCAPTURE INSTALLATION GUIDE

DOCUMENT TRACKER

EXOR MapCapture Installation Guide

Trademark

Bentley and the "B" Bentley logo are either registered or unregistered trademarks or service marks of

Bentley Systems, Incorporated, or one of its direct or indirect wholly-owned subsidiaries.

Other brands and product names are trademarks of their respective owners.

Copyright

Copyright © 2013 Bentley Systems, Incorporated.

All Rights Reserved.

Including software, file formats, and audiovisual displays; may only be used pursuant to applicable

software license agreement; contains confidential and proprietary information of Bentley Systems,

Incorporated and/or third parties which is protected by copyright and trade secret law and may not be

provided or otherwise made available without proper authorization.

Restricted Rights Legend

If this software is acquired for or on behalf of the United States of America, its agencies and/or

instrumentalities ("U.S. Government"), it is provided with restricted rights. This software and

accompanying documentation are "commercial computer software" and "commercial computer software

documentation", respectively, pursuant to 48 C.F.R. 12.212 and 227.7202, and "restricted computer

software" pursuant to 48 C.F.R. 52.227-19(a), as applicable. Use, modification, reproduction, release,

performance, display or disclosure of this software and accompanying documentation by the U.S.

Government are subject to restrictions as set forth in this Agreement and pursuant to 48 C.F.R. 12.212,

52.227-19, 227.7202, and 1852.227-86, as applicable.

Contractor/Manufacturer is Bentley Systems, Incorporated, 685 Stockton Drive, Exton, PA 19341-0678.

Unpublished - rights reserved under the Copyright Laws of the United States and International treaties.

EXOR


DOCUMENT TRACKER

Document Tracker

Document Details

File:

Mapcapture Installation Guide V4.7.docx

Prepared by:

J Earnshaw

Manual Name:

Mapcapture Installation Guide

Reviewed by:

I Skinner

Version:

4,7

Approved for issue by:

Date of Issue:

Feb 2014

Product Manager:

Julian Earnshaw

File Name:

Document Centre/Exor/Product Manuals/4.7 Product Manuals/4.7 completed documentation/ Mapcapture Installation Guide V4.7.docx

Document Version Control

Revision Date By Chapter/Page Description

1 01-Mar-2010 JE Document created

2 11-Nov-2010 JE Updated for version 4.3

3 May 2010 IS None No changes for 4.4

4 Nov 2011 IS None No Changes for 4.5

5 Oct2012 IS All Document reviewed for 4.6 release

6 Feb 2013 IS P13

P14

Product Options & Asset Data Model requirements added

Restrict User by AU added to screenshot

7 Feb 2014 BA/IS All Re-formatted into Bentley template for 4.7 release

8 Feb 2014 GK 1 Introduced Prerequisites

EXOR


TABLE OF CONTENTS

Table of Contents

1 Prerequisites .......................................................................................................................................... 1

1.1 Mo24rt.exe .................................................................................................................................... 1

1.2 2007 Office System Driver: Data Connectivity Components ....................................................... 2

2 Installation ............................................................................................................................................. 3

2.1 Installing Map-Capture ................................................................................................................. 3

3 PED file Generation ............................................................................................................................ 15

3.1 Product Options .......................................................................................................................... 15

3.2 Asset Data Model Requirements ................................................................................................. 16

3.2.1 Survey Date Attribute ......................................................................................................... 16

3.2.2 Survey Time Attribute ........................................................................................................ 17

3.3 MAI3863 Ped file Creation ......................................................................................................... 18

4 Getting a Network Shapefile ............................................................................................................... 22

4.1 Network Shapefile using Spatial Manager .................................................................................. 22

5 Running MapCapture .......................................................................................................................... 25

5.1 MapCapture Icon ........................................................................................................................ 25

EXOR


PREREQUISITES

Version: 4.7 1



1 Prerequisites

Before proceeding with Map Capture application installation it is required that the following software is already installed.

1.1 Mo24rt.exe

Warning! Important this MUST be done before installing MapCapture and has to be installed as a System Administrator

This needs to be executed from the run prompt on the start menu with the following extensions.

This will install the ESRI MapObjects runtime application.

Copy the Mo24rt.exe to the c drive root folder. Then click the start button and select the run option. (this may not be

available if you are not logged in as a system administrator)

C:\Mo24rt.EXE /ABCDEFGHIJKLMNOPQX

Figure 1 – Run Mo24rt.exe

Click ok and the installer will begin.

Figure 2 – Progress Indicator

Once the installation has completed the box will disappear and the install has finished.

EXOR


PREREQUISITES

Version: 4.7 2



1.2 2007 Office System Driver: Data Connectivity Components

Data Connectivity components for office 2007 are required if Map Capture is going to be used with eb Document

Manager. All required information related to this download can be found at Microsoft's Download Center

(http://www.microsoft.com/en-gb/download/details.aspx?id=23734).

After downloading the appropriate installer please follow the installation instructions.

The installed drivers are used to generate the required files for use with eB Bulk loader.

http://www.microsoft.com/en-gb/download/details.aspx?id=23734

EXOR


INSTALLATION

Version: 4.7 3



2 Installation

This document is a guide to the installation of MapCapture and covers in detail all the steps in the installation process.

2.1 Installing Map-Capture

Double-click the MC4 setup icon and the installation will begin

Figure 3 – Installing MapCapture

Note: If you get this screen during the installation you have missed install step one, the installation of the MapObject

Runtime. Please refer to Section Error! Reference source not found..

EXOR


INSTALLATION

Version: 4.7 4



Figure 4 – Installer Information

When this screen appears click next

Figure 5 – InstallShield Wizard

EXOR


INSTALLATION

Version: 4.7 5



The License screen will then appear.

Figure 6 – License Agreement

Check the I Accept radio button and then click next.

EXOR


INSTALLATION

Version: 4.7 6



Please enter the user details then click next.

Figure 7 – User Details

EXOR


INSTALLATION

Version: 4.7 7



Figure 8 – Set Installation Folder

At this point, you can select a different installation folder if required, the default is c:\Exor\MC4\.

The installation will then continue after clicking next.

EXOR


INSTALLATION

Version: 4.7 8



Figure 9 – Check Options & Install

Having checked your options click the Install button to complete the installation.

Figure 10 – Installation Progress

EXOR


INSTALLATION

Version: 4.7 9



The confirmation Screen appears.

Figure 11 – Confirmation Screen

Click the finish button when it appears.

EXOR


INSTALLATION

Version: 4.7 10



After Installation the following directory structure will be created.

Figure 12 – Map Capture Directory Structure

We now need to run the MapCapture shortcut from the desktop by double-clicking on the icon.

Figure 13 – Desktop Icon

This will create a number of other folders that we require to move on.

EXOR


INSTALLATION

Version: 4.7 11



You will get the following messages on the initial first startup but do not worry.

Figure 14 – Information popup

Click No.

EXOR


INSTALLATION

Version: 4.7 12



Once MapCapture starts, select the close button

Figure 15 – Start MapCapture

EXOR


INSTALLATION

Version: 4.7 13



Then select the file/exit from the menu.

Figure 16 – Exit MapCapture

EXOR


INSTALLATION

Version: 4.7 14



Now that we have closed MapCapture, the following menu structure will have been created under the MC4 folder.

Figure 17 – MapCapture Menu Structure

We now need two files to allow MapCapture to work these are:

A Current PED file created from the main exor system using form MAI3863

A network Shape file typically extracted from Spatial Data Manager or Spatial Manager

EXOR


PED FILE GENERATION

Version: 4.7 15



3 PED file Generation

3.1 Product Options

The following product options must be configured before the PED file is created:

Option Description Example value

PED4CHRASS If set to Y, the 2 character MAI asset codes will be translated to the 4 character NM3 equivalents when creating the PEDIF file. If set to N the 2 character codes will be exported as normal

Y

PEDDATEATR If set to Y, any date attributes (record type 12) will be exported with a type of ‘D’ and a length of 11 when creating the PEDIF file. If set to N the date attributes will be exported with a type of ‘S’ and a length of 7 as was previously the case before the introduction of this option

Y

EXOR


PED FILE GENERATION

Version: 4.7 16



3.2 Asset Data Model Requirements

All asset types that are to have defects logged against them must have the SURVEY_DATE and SURVEY_TIME

attributes defined as shown below within Asset Metamodel – NM0410.

Note: These specific changes are only required from version 4.6.1.0 of map capture.

Warning! The following are mandatory for each field for the selected attribute:

3.2.1 Survey Date Attribute

Figure 18 – Survey Date Arrribute

Field Value Notes

Name Any unused DATE or VARCHAR2 field for the selected asset type

This field does not have to be a specific DATE attribute, if a VARCHAR2 attribute is used it must have a format of DATE applied in the ‘Format’ field and a date format mask must be defined in the subsequent ‘Format Mask’ field, e.g. DD-MON-YYYY.

Format DATE Must have a format of DATE.

View Attribute SURVEY_DATE SURVEY_DATE is the required value for this field

Column Name SURVEY_DATE SURVEY_DATE is the required value for this field

Inspectable null This checkbox must not be checked

EXOR


PED FILE GENERATION

Version: 4.7 17



3.2.2 Survey Time Attribute

Figure 19 – Survey Time Attribute

Field Value Notes

Name Any unused VARCHAR2 field for the selected asset type This field must be a VARCHAR2 field.

Format VARCHAR2 Must have a format of VARCHAR2

View Attribute SURVEY_TIME SURVEY_TIME is the required value for this field

Column Name SURVEY_TIME SURVEY_TIME is the required value for this field

Inspectable null This checkbox must not be checked

EXOR


PED FILE GENERATION

Version: 4.7 18



3.3 MAI3863 Ped file Creation

The PED file is a file that contains all the metadata from the main exor application. This is used to ensure that the data

collected by MapCapture is compatible with the main database and loading problems will be minimised.

Whenever you make a significant change to the setup of your exor system – create new network elements, add new asset

types, add new inspection types you should create a new PED file.

To create a PED file, follow these steps:

Log into exor as the main Highways owner and go to form MAI3863. This can be selected through fastpath.

Figure 20 – Access Via Fastpath

Figure 21 – Module Selection

Note: The Listeners must be running to get the required file out.

For more information contact your Exor Administrator.

EXOR


PED FILE GENERATION

Version: 4.7 19



Figure 22 – Download Inspections by Assets

After completed the mandatory fields, you may choose a road type or a road ID.

Restrict Inspector by AU will restrict the inspectors available to the user when selecting the inspectors within map

capture.

Click on the ‘running person’ icon in the top left of the form to run the PED file extract.

When the extract is running, you should click the ‘Spooled Output’ tab to ascertain the name of the new PED file.

Figure 23 – Spooled Output Tab

EXOR


PED FILE GENERATION

Version: 4.7 20



The PED file, as extracted by the extract function, will be left on the database server. Should you need to transfer it to

your PC, use the ‘Download From Oracle Directory’ function. This can be found under the exor/directory management

folder on the launchpad

Figure 24 – Download PED file from Oracle Directory

Figure 25 – Select INTERPATH

Select INTERPATH from the menu, click [View Files], then select the relevant PED file from the picklist.

EXOR


PED FILE GENERATION

Version: 4.7 21



Figure 26 – Select PED file

When you click the [Download] button, the PED file will then be downloaded onto your PC

Rename this file to survey.ped.

You should then copy the PED file to the ‘metadata’ folder under the MapCapture folder on each of your DCDs.

EXOR


GETTING A NETWORK SHAPEFILE

Version: 4.7 22



4 Getting a Network Shapefile

4.1 Network Shapefile using Spatial Manager

I will be using Spatial Manager for this process but other GIS systems can be used to generate the required shape file.

Figure 27 – Network Shapefile

EXOR



Version: 4.7 23



Having selected the required area click on the Display tab. Right-click on the Network Layer you wish to export goto

Data/export data.

Figure 28 – Export Data

The Export data box will appear.

Figure 29 – Export Data Box

Select the location to which you wish to send the output then click OK.

EXOR



Version: 4.7 24



Figure 30 – Export Progress

This will now generate the required network files.

Note: For Mapcapture to work, you will require two key fields in the shape file these are AGENCY and LINKCODE

as one field and SECTION as another, for example:

Typical Example for RMMS type Network: 1234A354 P/12345

Agency Code of 1234 4 Characters

Linkcode of A354 P 6 Characters

Section Number 00045 5 Characters

These have to match the format of your main exor system.

These resulting fields in the shape file need to be:

AGENCYLINKCODE 1234A354 P

SECTION 00045

EXOR


RUNNING MAPCAPTURE

Version: 4.7 25



5 Running MapCapture

Figure 31 – MapCapture Desktop Icon

You should now see the MapCapture icon on your desktop, double-click on the icon to start the application.

5.1 MapCapture Icon

After clicking on the icon, you will see the screen below and flashing at the bottom you will see the edif file being read,

the screenshot below is reading the type 4 records.

Figure 32 – Application Startup

EXOR


RUNNING MAPCAPTURE

Version: 4.7 26



Having read the edif file you may get a message telling you there were errors or warnings in the file.

Figure 33 – Error or Warnings popup

If you see this message, a log file will have been created in the same metadata folder.

Having clicked the OK message, you will get the main Launch Window.

Figure 34 – Start MapCapture

MapCapture is now installed and ready to be configured. Please read the MapCapture Config Guide.

exor mapcapture installation guide · 2014-03-26 · exor mapcapture installation guide...

Documents