road data management operation manual · pdf fileroad data management operation manual ......

Road Data

Management

Operation Manual

Road Asset Management Project

AUGUST 2012

Road Data Management

(System Specification and Operation Manual) http://www.rdm.mpwt.gov.kh/

Project RAMP Prepared by:

Nikhil Narayan

(Drupal Consultant)

([email protected])

http://www.rdm.mpwt.gov.kh/

mailto:[email protected]

Contents

Introduction .................................................................................... 1

Abbreviations ................................................................................. 2

System Architecture ....................................................................... 3

Operating Procedure ...................................................................... 4

1. Importing a Survey .......................................................................................................... 4

1.1. How to import a survey ............................................................................................... 4

1.2. How to re-import the survey again ............................................................................ 11

2. Add a Survey using a webform ..................................................................................... 11

2.1. How to add a survey using a webform....................................................................... 11

3. Exporting surveys .......................................................................................................... 13

3.1. How to export survey data in excel format ................................................................ 13

4. Master Tables ................................................................................................................ 14

4.1. How to view master table data ................................................................................... 14

4.2. How to add master table data ..................................................................................... 17

4.3. How to edit existing master table data ....................................................................... 18

5. User Management .......................................................................................................... 21

5.1. Roles .......................................................................................................................... 21

5.2. User Management ...................................................................................................... 21

5.2.1. Resetting passwords ............................................................................................... 21

5.2.2. Creating new users ................................................................................................. 22

5.2.3. Assigning roles to new users .................................................................................. 23

5.2.4. Activating/Blocking users ...................................................................................... 24

Appendix ...................................................................................... 26

1. Survey Tables ................................................................................................................ 26

1.1. Traffic Survey ............................................................................................................ 26

1.2. Travel Time ................................................................................................................ 26

1.3. Travel Time ................................................................................................................ 27

1.4. Community Survey .................................................................................................... 27

1.5. OD Survey ................................................................................................................. 28

2. Master Tables ................................................................................................................ 28

2.1. Road Master Table ..................................................................................................... 28

2.2. Province Master Table ............................................................................................... 28

2.3. Passenger Vehicle Type Master Table ....................................................................... 29

2.4. Passenger Trip Purpose Master Table........................................................................ 29

2.5. Freight Vehicle Type Master Table ........................................................................... 29

2.6. Type of Freight Master Table .................................................................................... 29

JL Narayan, International M&E Consultant RAMP, [email protected] Page 1

Introduction Road Data Management is an application that can be used for storing data centrally in

one location. It allows users to import road survey or enter road survey data from any

location having the required access. The user can then later export data in excel format

using a number of filters that are available in the application such as Date, Road ID,

Province Code etc.

.

This operation manual will cover all the functionalities in the application and how they

can be used. It is important to follow the steps provided in the application for effective

usage of the application.


Abbreviations

Abbreviation Description

RDM Road Data Management

OD Origin Destination

CS Community Survey

TS Traffic Survey

IRI International Roughness Index

TT Travel Time


System Architecture RDM is a Drupal version 7 based systems. Drupal is a PHP based content

management system. It is open source and is distributed under the terms of GNU

General Public License. For more details around Drupal, please visit:

http://drupal.org/about

Drupal is web based and is compatible for with all operating systems.

Drupal Technical requirements:

o Web Server: Apache or Microsoft IIS

o PHP: 5.2 or higher

o Database Server: MySQL – 5.0 or higher, PostgreSQL – 8.3 or higher, or

SQLite.

http://drupal.org/about


Operating Procedure

1. Importing a Survey

1.1. How to import a survey

1. Login to the system using username and password.


2. Click on Import tab.

3. A list of all available surveys will be displayed.


4. Click on survey you want to import.

4.1. Community Survey

4.1.1. This page allows the user to import community survey data.

4.1.2. The first column “Key” is the unique key for all surveys. It should be unique

for each survey.

4.1.3. For Community Survey, start data with a CS prefix and add numbers to it. For

example: CS1, CS2, CS3 etc.

4.1.4. The data should be in the required format. The format can be downloaded from

the application. Click on “Download a template”:


4.1.5. The application allows data in CSV format. This format can be easily created

from an MS Excel file. In MS Excel, click on “file” and select “save as”. In the

“save as” dialog box, select “save as type” as CSV (comma delimited).

4.1.6. Once the data is ready, Click on “Choose file”:


4.1.7. This would open a “Choose file” dialog box. Select the survey file you wish to

upload and click on open.


4.1.8. Once the file has been selected, click on “Import”.

4.1.9. This would import the file.

4.1.10. If the file uploads successfully, then success message will be displayed by the

system. The number in the message signifies the number of records created after

the import.


4.1.11. In case of an upload failure, the system will not import the survey.

4.1.12. Upload failure will occur due to following reasons:

4.1.12.1. Incorrect ID is used in case of data that is stored in master table. This

includes Road, Province, Vehicle type, etc. While uploading Master table

data, the IDs from the master table should be used.


4.1.12.2. Incorrect data type is entered. For example, Date field will only accept

date and no other value. Number field will accept only number value and no

other value.

1.2. How to re-import the survey again

1. The system uses the “Key” field to match the record. If you wish to re-import the survey

with changes then ensure that the key for particular record is same.

2. For example, if you re-import record with key as CS1, then system will update that record.

You can make changes to the data in the CSV file and re-import.

2. Add a Survey using a webform

2.1. How to add a survey using a webform

1. Click on “Add Survey” tab.

2. After clicking on “Add Survey”, a list of all available surveys will be displayed:


3. Click on any survey to start adding survey data using the web forms.

4. Click on “Save” to save the survey data.


5. Click on “Preview” to review the data before saving.

6. Click on “Save and add another” to save and add more data.

3. Exporting surveys

3.1. How to export survey data in excel format

1. Click on Export Surveys tab.

2. This would display the list of all the surveys:


3. Click on any survey you wish to view. This would open the search filters for that survey.

4. There are number of filters available that allow user to search data. For example: Date,

Road ID, Province, Location, side etc.

5. Simply apply any search criteria and click on “Apply”.

6. If you wish to export data in excel, simply click on the XLS icon on the bottom left corner

of the table. This would download data based on the search criteria in an excel sheet.

4. Master Tables

These tables contain master data which is used in number of surveys. For example, Road

master table consists of lists of all the roads available in Cambodia.

4.1. How to view master table data

1. Click on Master Tables tab.


2. This would display the list of all the master tables.


3. Simply click on any master table to view the data.


4.2. How to add master table data

1. Click on Add Master Tables. This would display the list of available master tables.

2. Select any master table.


3. Fill the form to add a master table record. Ensure that correct data is entered in the master

table record.

4.3. How to edit existing master table data

1. Click on Master tables tab


2. Select any master table

3. Select the record you wish to edit


4. This would open the master table record

5. Update any field and click on save


5. User Management

5.1. Roles

There are three types of roles present in the application. The access to the application is based

on these roles.

Role Description

User admin Responsible for creating new users

and assigning roles to them.

Responsible for resetting

passwords.

Responsible for activating or

blocking any user.

Data entry operator Responsible for entering survey

data into the application.

Master table owner Responsible for adding new master

table data.

Responsible for editing existing

master table data.

In addition to this, there is an admin role which has access to all functionality in the

application. This role should be sparingly used and should be assigned to relevant IT

personnel.

5.2. User Management

5.2.1. Resetting passwords

1. Click on Request new password link.

2. Enter your registered email id and click on “E-mail new password”. The instructions

to reset password will be send by email.


5.2.2. Creating new users

1. Click on People and click on Add user


2. Enter the necessary details to create a user.

5.2.3. Assigning roles to new users

3. While creating the user, select the necessary role.

Roles should be selected after a lot of discretion. The administrator role should be assigned to

only responsible personnel.


5.2.4. Activating/Blocking users

1. Go to People and search the users you wish to block.

2. Select the user by clicking on the checkbox.


3. Under Update options, select the relevant option. If you wish to block the user, select

“Block the selected user” option.


Appendix

1. Survey Tables

1.1. Traffic Survey

S.No Attribute Mandatory Datatype

1 Key Yes Node Module Element

2 Date No Date (ISO format)

3 Start Time From No Text

4 Start Time To No Text

5 Road No No Node reference

6 Province No Node reference

7 District No Text

8 Location (Km milestone +) No Text

9 Side No Text

10 Motorcycle No Integer

11 Motorcycle Trailer No Integer

12 Car No Integer

13 Jeep/4WD No Integer

14 Pick-up No Integer

15 Minibus No Integer

16 Bus No Integer

17 Koyun Etan Small No Integer

18 Koyun Etan Large No Integer

19 Truck Light No Integer

20 Truck Medium No Integer

21 Truck Heavy 3 Rigid Axle No Integer

22 Truck Heavy 4 Rigid Axle No Integer

23 Truck Heavy 4 Trailer Axle No Integer



1.2. Travel Time


1 Key Yes Node module element



4 AWP No Text

5 Starting Point No Text

6 Starting time No Text

7 Ending Point No Text

8 Ending time No Text

9 Length (km) No Float

10 Travel Time (km) No Float

11 Proportion No Text

12 Average Speed Achieved (km/h) No Float

13 Allowed Speed (km/h) No Float


1.3. Travel Time


1 Key Yes Node module element



4 Start Place Name No Text

5 End Place Name No Text

6 Start measure No Integer

7 End measure No Integer

8 Speed No Float

9 IRI Left No Float

10 IRI Right No Float

11 IRI Lane No Float

1.4. Community Survey

S. No Attribute Mandatory Data type

1 Community Survey Yes Node module element


3 Road ID No Node reference

4 Name of Person No Text

5 Location No Text

6 Male Adults No Integer

7 Female Adults No Integer

8 Male Children No Integer

9 Female Children No Integer

10 Motorcyles Owned No Integer

11 Cars Owned No Integer

12 Scooters Owned No Integer

13 Lorry/Etan Owned No Integer

14 Other Vehicles Owned No Integer

15 Travel (Km/Month) No Float

16 Travel by Bus (km) No Float

17 Travel by Car (km) No Float

18 Travel by Other Vehicles (km) No Float

19 Family Occupation Agriculture No Integer

20 Family Occupation Service No Integer

21 Family Occupation Business No Integer

22 Family Income Min (USD) No Float

23 Family Income Max (USD) No Float

24 Family Income Avg (USD) No Float

25 Travel Quality (Excellent) No Integer

26 Travel Quality (Very Good) No

27 Travel Quality (Good) No Integer

28 Travel Quality (Poor) No Integer

29 Savings in Travel Cost (2008) - Lower No Integer

30 Savings in Travel Cost (2008) - Somewhat Lower No Integer

31 Savings in Travel Cost (2008) - No Change No Integer

32 Savings in Travel Cost (2008) - Over No Integer

33 Access to Public Transport (2008) - Better No Integer

34 Access to Public Transport (2008) - Somewhat Better No Integer


S. No Attribute Mandatory Data type

35 Access to Public Transport (2008) - No Change No Integer

36 Min Distance to School (km) No Float

37 Max Distance to School (km) No Float

38 Mean Distance to School (km) No Float

39 Travel of School Children by Walk (%) No Float

40 Travel of School Children by Personal Vehicle (%) No Float

41 Travel of School Children by Bus (%) No Float

42 Travel of School Children by Other Travel Modes (%) No Float

43 Availability of Goods in the Nearest Market (Better) No Integer

44 Availability of Goods in the Nearest Market (Somewhat Better) No Integer

45 Easy to carry Goods to Nearest Market (Better) No Integer

46 Easy to carry Goods to Nearest Market (Somewhat Better) No Integer

47 Easy Access to Market (Better) No Integer

48 Easy Access to Market (Somewhat Better) No Integer

1.5. OD Survey

TBD

2. Master Tables

2.1. Road Master Table


1 Road_ID Yes Node module element

2 Road_Name Yes Text

3 Origin_Destin Yes Text

4 From Yes Integer

5 To Yes Integer

6 Length Yes Integer

7 Start_Point Yes Text

8 End_Point Yes Text

9 Road_Type Yes Text

http://www.rdm.mpwt.gov.kh/road-master-table

2.2. Province Master Table


1 Province ID Yes Node module element

2 Province Name Yes Text

3 Capital Yes Text

http://www.rdm.mpwt.gov.kh/province-master-table

http://www.rdm.mpwt.gov.kh/road-master-table

http://www.rdm.mpwt.gov.kh/province-master-table


2.3. Passenger Vehicle Type Master Table


1 Passenger Vehicle Type ID Yes Node module element

2 Passenger Vehicle Yes Text

http://www.rdm.mpwt.gov.kh/passengervehicletype-master-table

2.4. Passenger Trip Purpose Master Table


1 Passenger Trip Purpose ID Yes Node module element

2 Passenger Trip Purpose Yes Text

http://www.rdm.mpwt.gov.kh/passengertrippurpose-master-table

2.5. Freight Vehicle Type Master Table


1 Freight Vehicle Type ID Yes Node module element

2 Freight Vehicle Type Yes Text

http://www.rdm.mpwt.gov.kh/freightvehicletype-master-table

2.6. Type of Freight Master Table


1 Type of Freight ID Yes Node module element

2 Type of Freight Yes Text

3 Description Yes Text

http://www.rdm.mpwt.gov.kh/typeoffreight-master-table

http://www.rdm.mpwt.gov.kh/passengervehicletype-master-table

http://www.rdm.mpwt.gov.kh/passengertrippurpose-master-table

http://www.rdm.mpwt.gov.kh/freightvehicletype-master-table

http://www.rdm.mpwt.gov.kh/typeoffreight-master-table

road data management operation manual · pdf fileroad data management operation manual ......

Documents