Dictionary Creator

From Golden Retriever Wiki

Revision as of 20:04, 27 April 2020 by Jeff (talk | contribs) (→‎Spacer)

Note: This page is under development and as such is not yet complete.

Dictionary Creator

Collection dictionaries are made by account administrators from the Admin Portal in the Dictionary Creator main menu item. Here you can create, view and edit what data is collected and how it is collected.

When you first navigate to the Dictionary Creator window you will see a drop-down menu which contains all of your collection dictionaries as well as an empty collection dictionary form. You can either start a new dictionary from scratch by typing in a name and adding new fields or modify an existing one by selecting it from the list. When you load an existing dictionary you will have both a Create Dictionary and an Update Dictionary button. The Create Dictionary works like save as and will create a new dictionary with whatever name you have entered in the Dictionary Nam box. Update Dictionary will save your changes to the existing dictionary.


Dictionary Settings

Dictionary Name

Each dictionary needs a name. It is suggested to name each dictionary with the customer name and year. Where multiple dictionaries are used for the same customer those line or circuit names can be used as well.

Sub Folder

Sub Folders are a great way to organize your collection dictionaries in the mobile app. This is optional and if not set here the dictionary will be shown in the main dictionary directory.

Dictionary Order

By default all dictionaries will be shown in the mobile app in alphabetical order. Normally this works but if you wish to specify the order manually the number you enter here will dictate the order shown when selecting a dictionary in the app.

Default Search Field

When searching online records the user has the option of which field to search. Any of the dictionary fields may be set as the default search field. To make things more efficient the most common search field can be set here (i.e. Pole Number).

Field for Device Map

In the [Databases Summary Page] it is possible to view on a map, the most recent record's GPS location for each device. By setting an inspector name instead of the id of the device, any change in phone/tablet will not effect this maps functionality.

Duplicate Records Allowed

By default saving changes as duplicate records is allowed. This is to avoid data loss due to editing mistakes. However, this does create more administration work later on to edit and consolidate these duplicates. By selecting this option no duplicates will be allowed by the mobile app for map markers once they turn from red to green. This is when working from a map of data supplied by the utility as this is location specific (Pole Number, etc makes no difference.

Photo Required

If a photo is required for every inspection record select this check-box to force a photo before the app will save a new record.



Dictionary Fields

Add Field

To add a new dictionary field click on the green Add field here button at the location you wish to add the field.

Move Field

The fields will appear on the mobile app collection form according to the order they are in the Dictionary Creator. They can be moved by using the up/down arrow buttons to the right of the field.

Delete Field

To delete a field click on the red X by the field.

Defining Fields

First, select the field type from the drop-down list. The available field types are:

  • Altered Data
  • Attachment
  • Comment
  • Custom GPS
  • Date Picker
  • Elevation
  • Picklist
  • Picklist - Multiple Selection
  • RUS Deduction
  • Signature
  • Spacer
  • Strength Calc - ANSI Tables
  • Text
  • Weather


Once you have selected the field type you may assign a name to it and complete any field options.

Field Type Descriptions

Altered Data

This is a hidden field from the mobile app user and will record any changes made to the original utility supplied data (as seen by the app users in the map or online search function).

Attachment
Comment
Custom GPS
Date Picker
Elevation
Picklist
Picklist - Multiple Selection
RUS Deduction
Signature
Spacer

The spacer is not a data field but a horizontal line which is displayed in the mobile app to visually separate different categories of fields in the collection form. Use of this is completely voluntary.

Strength Calc - ANSI Tables
Text
Weather

Upload Supplied Data

When asset location and other details are supplied by the utility this information can be uploaded into the collection dictionary to give a map of the assets to be inspected.

Note: the file must be a CSV (comma delimited and enclosed with double quotes), any coordinates must be in WGS84 format (EPSG:4326), and the column names must match the columns in the dictionary for them to be used by the program.

Assign Dictionary

For Administrators working with multiple Golden Retriever accounts you may assign/unassign collection dictionaries as needed. Select the checkbox beside the account(s) you wish to have access to the dictionary - both on mobile app and in the [Dictionary Summary] page of the Admin Portal.