User Manual setup   web

This chapter explains how to set up the office software.

Logging into the office software

You can log into the office software using the login credentials delivered with the software.

The office software can be accessed at: https://sso.ginstr.com/

Login screen at https://sso.ginstr.com/

Please enter your login credentials in this login screen and click on the

log in

button.

Once successfully logged in you will be forwarded to the ginstr lobby.

The ginstr lobby

Once successfully logged in you will see the lobby menu:

ginstr lobby menu

You are now in the lobby.

Depending on the software modules ordered from ginstr, here you will see different buttons that take you to different programs.

Clicking on the ‘ginstr web’ button takes you directly to the interface of the ginstr web office software.

The operation of ginstr web is described in more detail here.

In the top right-hand corner of the lobby you will see your name:

User name at top right-hand corner of the lobby

As soon as you hover the mouse over your name, a menu for basic settings for your user account appears:

User account settings menu at top right-hand corner of the lobby

Changing the password for the main account

Please follow steps 1 to 4 shown below to change the password for the main account immediately after you first log into the lobby.

Procedure for changing the password for the main account

The password provided during the delivery of the software is not safe because it was sent through e-mail or regular postal service.

Defining roles

Roles are rights groups.

You can create as many roles as you like and allocate a role to different users.

To do this, please click on the ‘roles’ menu item on the left-hand side and select ‘add role’.

Enter a name and brief description for the new role and click on the

add

button to save:

Entering role name and description in 'add role' menu

Now click on the name of this role to specify the authorisations associated with it.

Selecting role from 'roles' menu

In the column that has just opened, you are given a selection of all the ginstr apps allocated to your user account. Select the desired app here by clicking on its name:

Selecting desired app from 'roles' menu

In another column that has just opened, you will now see all the tables allocated to the software.

By clicking on the rights for each table, you can activate them for this role and deactivate them again by clicking on them once more:

Assigning user rights for selected app tables

The following rights can be assigned to each table:

create	Once create has been activated for this role, all the users this role is allocated to can enter new data sets in the table but cannot make any changes.
read	Once read has been activated for this role, all the users this role is allocated to can view the data in this table but cannot make any changes.
update	Once update has been activated for this role, all the users this role is allocated to can edit existing data sets in this table and so overwrite the existing values
delete	Once delete has been activated for this role, all the users this role is allocated to can delete existing data sets from this table.

Furthermore, you can specify per ginstr app and/or per table whether older data should be automatically deleted and if so, after how many days.

Activating this data cleansing is always useful for the following reasons if the old data is no longer required after a set period:

• Many processing stages take longer the more data records are stored in the database
• If the storage space assigned in the ginstr cloud exceeds the agreed data volume, additional monthly fees will be charged to expand the ginstr cloud storage
• It is not possible to show more than 10,000 records on the screen at the same time. If there are more than 10,000 records, only part of the data will be loaded and the user then has to decide what part of the data they want to edit every time, as shown below:

Filtering data to be shown by time period

Automatically deleted records cannot be recovered. We therefore recommend that you regularly export older records.

If you have now successfully defined all the roles for your employees, you can proceed with creating the user accounts for them.

Creating subaccounts

For each ginstr customer, there is one main account for the individual who has overall responsibility for this software.

There is also a subaccount for each office employee or field employee. The total number of subaccounts you can create depends on what you have ordered from ginstr.

Now create the subaccounts for each of your office employees and mobile workers.

To do this, go to your user account’s settings and select the ‘subaccounts’ menu item on the left-hand side.

Now please click on ‘add subaccount’ in the second column.

Enter the e-mail address for the subaccount and specify a password:

Creating a new subaccount in the ‘subaccounts’ menu

Select one of the roles defined previously for the subaccount.

Please also activate the application in the ‘applications’ field.

Please ensure that the access status is set to ‘active’.

Save the newly created user subaccount by clicking on the

add

button.

Repeat this process until you have created all the necessary user subaccounts.

Now you can exit the settings menu with the ‘back to lobby’ button, which you will find at the bottom of the left-hand column.

Launching ginstr web

The ginstr web interface can be accessed from the ginstr lobby by clicking on the ‘ginstr web’ button.

ginstr lobby menu

ginstr web account settings

In the top right-hand corner of the ginstr web interface you will see your name. Hovering your mouse over this area will reveal a drop down menu containing two options:

User name at top right-hand corner of the ginstr web interface

Clicking on the setup option below your name will open the general settings page for your ginstr web account, while selecting close ginstr web will close the ginstr web interface and return you to the ginstr lobby.

general

The general section of the ginstr web account settings contains options for customising the ginstr web interface to your preference.

ginstr web general settings page

General Information

This section lists information related to the ginstr web interface software version.

This information is listed for diagnostic purposes only and is not user-configurable.

General Settings

username

Your ginstr iD user name is displayed here, along with the unique 6 digit identifier number for your ginstr account (in brackets).

This item is not editable.

language

This option sets the display language for the ginstr web interface.

Currently ginstr web supports German, English, French, Spanish, Arabic & Hebrew.

time zone

This option sets the time zone for the ginstr web interface.

The time zone selected here will affect all time/date records displayed in ginstr web tables.

time format

This option sets the time format for the ginstr web interface.

The time format selected here will affect all time/date records displayed in ginstr web tables.

first weekday

This option is used to define whether the working week begins on a Sunday or Monday for all ginstr web tables.

date format

This option sets the date format for the ginstr web interface.

The date format selected here will affect all time/date records displayed in ginstr web tables.

show thousands delimiter

This option is used to define whether or not a digit group separator/thousands delimiter is used for large numbers (greater than one thousand) displayed in ginstr web tables.

international call prefix

This option is used to define whether '+' or '00' is used as a prefix for international telephone numbers.

The prefix selected here will affect all international phone number records displayed in ginstr web tables.

default country calling code

This input box can be used to define a default country calling code which will be added automatically as a prefix to all phone number records displayed in ginstr web tables.

reset to default settings

This option can be used to reset the ginstr web interface configuration to the default values.

Your trackables registered with this account will be maintained as well as the data transmitted by these trackables to this ginstr account.

After resetting the configuration of this ginstr account to the default settings ginstr must be restarted.

remove ginstr web account PERMANENTLY

Selecting this option will remove your ginstr web account, all of its subaccounts and trackables immediately and irrevocably.

Note that selecting this option will result in PERMANENT removal of your ginstr web account and all saved data and subaccounts and as such cannot be reversed.

Upon confirming your decision to remove your ginstr web account your browser window will be closed and you will no longer be able to access the ginstr web interface.

Design

upload own logo

This option allows you to upload your own personal logo to be used in place of the default ginstr web logo at the top left hand corner of the ginstr web interface.

To upload your personal logo, click inside the 'choose logo file' input box, select the file location and click on the

upload logo

button.

File Requirements:

Your logo file must be PNG format (transparency is supported).

Maximum dimensions of your logo file = 200 x 29 pixels.

Maximum file size of your logo file = 8KB.

For best results, align your logo to the left of the PNG file.

To remove your personal logo and revert to the default ginstr web logo, click on the

remove logo

button.

measures

The measures section of the ginstr web account settings contains options for customising the display of speed, pressure and temperature values in the ginstr web interface to your preference.

ginstr web measures settings page

show speed in

This option is used to define whether speed values are displayed in kilometres per hour (km/h) or miles per hour (mph).

The speed format selected here will affect all speed values displayed in ginstr web tables.

show pressure in

This option is used to define whether pressure values are displayed in bar, pound per square inch (psi) or kilopascal (kPa).

The pressure format selected here will affect all pressure values displayed in ginstr web tables.

display pressure in

This option is used to define whether pressure values are displayed as absolute or gauge pressure.

absolute pressure is zero-referenced against a perfect vacuum, using an absolute scale, so it is equal to gauge pressure plus atmospheric pressure.

gauge pressure is zero-referenced against ambient air pressure, so it is equal to absolute pressure minus atmospheric pressure.

The pressure format selected here will affect all pressure values displayed in ginstr web tables.

show temperature in

This option is used to define whether temperature values are displayed in degrees Celsius (°C) or degrees Fahrenheit (°F).

The temperature format selected here will affect all temperature values displayed in ginstr web tables.

portlets

The portlets section of the ginstr web account settings contains options for customising the display of portlets within the ginstr web interface to your preference.

ginstr web portlets settings page

map

tile server

The name of the active server which currently provides map tile information appears listed here.

This item is not editable.

cache tiles

The slider here can be used to adjust the length of time in days that map tiles are kept in your local cache.

The cache feature enables faster loading of maps by saving a local copy of previously-accessed map tile information for faster subsequent retrieval.

This option determines how long the cached map tiles are stored locally before updating with the latest available tiles from the active tile server.

show map navigation

This checkbox toggles the display of navigation arrows and zoom controls on all map portlets.

If checked, the map navigation controls will be shown at the top left of any portlet assigned to display a map.

show scale

This checkbox toggles the display of navigation arrows and zoom controls on all map portlets.

If checked, the map scale will be shown at the bottom left of any portlet assigned to display a map.

show longitude/latitude of mouse cursor

This checkbox toggles the display of longitude & latitude values of the current mouse cursor position on all map portlets.

If checked, the longitude & latitude values are displayed above the mouse cursor in any portlet assigned to display a map.

show legend on map

This checkbox toggles the display of a map legend on all map portlets.

The legend groups pushpins by colour & proximity to provide clustering information at a glance.

If checked, the legend will be shown at the top right of any portlet assigned to display a map.