Difference between revisions of "Parking"

From UmsWiki
Jump to: navigation, search
(Supported administrative systems)
Line 1: Line 1:
 
The Parking function makes it easy for users to avoid parking tickets at school. With this module, the school can administer their parking spaces with the parking company. Through the app, students and employees can get a valid, digital parking permit simply by entering their vehicle’s registration number in the app or in UMS Web. When the registration number has been entered, it becomes visible to the parking company. The parking company will then know that the user is allowed to park at the school. Available integration includes Parkzone, APCOA, and City Parkeringssystem.
 
The Parking function makes it easy for users to avoid parking tickets at school. With this module, the school can administer their parking spaces with the parking company. Through the app, students and employees can get a valid, digital parking permit simply by entering their vehicle’s registration number in the app or in UMS Web. When the registration number has been entered, it becomes visible to the parking company. The parking company will then know that the user is allowed to park at the school. Available integration includes Parkzone, APCOA, and City Parkeringssystem.
  
== Prerequisites ==
+
==Prerequisites==
  
=== Supported administrative systems ===
+
===Supported administrative systems===
* Parkzone
 
* Apcoa
 
* City Parkering
 
** The public IP address of the web server and backend server needs to whitelisted at City parkering.
 
  
=== Module requirements ===
+
*Parkzone
 +
*Apcoa
 +
*City Parkering
 +
**The public IP address of the web server and backend server needs to whitelisted at City parkering.
 +
 
 +
===Module requirements===
 
Parking
 
Parking
  
=== Should third party be contacted ===
+
===Should third party be contacted===
 
You'll need a client key (and possibly a password) from the parking company before UMS can communicate with their services.
 
You'll need a client key (and possibly a password) from the parking company before UMS can communicate with their services.
  
== Installation ==
+
==Installation==
 
It is necessary to have a running UMS installation.
 
It is necessary to have a running UMS installation.
  
== Configuration settings ==
+
==Configuration settings==
 
There are two ways of setting up parking: New Parking and Legacy Parking. In the future, Legacy Parking will be moved to the new system. Currently, new Parking settings are used for City Parkering and Legacy Parking settings are used for ParkZone and Apcoa.
 
There are two ways of setting up parking: New Parking and Legacy Parking. In the future, Legacy Parking will be moved to the new system. Currently, new Parking settings are used for City Parkering and Legacy Parking settings are used for ParkZone and Apcoa.
  
=== New Parking Settings ===
+
===New Parking Settings===
 
In the configurator go to:
 
In the configurator go to:
  
Line 30: Line 31:
 
There are 3 main parts of the parking system that needs to be set up:
 
There are 3 main parts of the parking system that needs to be set up:
  
'''1. Parking servers'''
+
==== '''1. Parking servers''' ====
 
 
 
It is possible to set up multiple parking server systems.
 
It is possible to set up multiple parking server systems.
  
Line 42: Line 42:
 
You should have been provided a company key and a password by your parking provider. Enter them in these parking server settings. [[File:Parking server settings.png|thumb|Parking server settings|none|745x745px]]
 
You should have been provided a company key and a password by your parking provider. Enter them in these parking server settings. [[File:Parking server settings.png|thumb|Parking server settings|none|745x745px]]
  
'''2. Parking places'''
+
==== '''2. Parking places''' ====
 
 
 
You can have multiple parking places and you can edit, add, or delete them.
 
You can have multiple parking places and you can edit, add, or delete them.
 
[[File:Parking Places.png|thumb|Parking Places|none|556x556px]]
 
[[File:Parking Places.png|thumb|Parking Places|none|556x556px]]
 
The parking place description is shown to users that have multiple parking systems to choose from, so make sure that this is a good identifier.
 
The parking place description is shown to users that have multiple parking systems to choose from, so make sure that this is a good identifier.
  
When "Delete users" is enabled, users that are removed in UMS will also be deleted from the parking system.
+
===== Delete users =====
 +
Users that are removed in UMS will also be deleted from the parking system.
  
When "Cleanup" is enabled, users that exists in the parking system but not UMS will also be deleted.
+
===== Cleanup =====
 +
Users that exists in the parking system but not UMS will also be deleted.
  
Mail Domain is used only when a parking is created for a user that does not have a private email address entered. If there is a private email address, it will be used. Otherwise, the username concatenated with the Mail Domain will be send. [[File:Parking place seetting edit.png|thumb|Each parking place is connected to a parking system. |none|747x747px]]
+
===== Mail Domain =====
  
'''3. Parking settings'''
+
Is used only when a parking is created for a user that does not have a private email address entered. If there is a private email address, it will be used. Otherwise, the username concatenated with the Mail Domain will be send.
 +
[[File:Parking place seetting edit.jpg|none|thumb|783x783px]]
  
 +
==== '''3. Parking settings''' ====
 
You can set up a parking setting per template, so that one set of users have access to some parking places but not others.
 
You can set up a parking setting per template, so that one set of users have access to some parking places but not others.
  
Line 62: Line 65:
  
 
You can connect a parking setting to a template:
 
You can connect a parking setting to a template:
# Go to edit your template.
+
 
# Find the parking menu and select the parking setting you want for you template.
+
#Go to edit your template.
 +
#Find the parking menu and select the parking setting you want for you template.
 +
 
 
[[File:Parking template.png|thumb|A parking setting is connected to a template.|none|624x624px]]
 
[[File:Parking template.png|thumb|A parking setting is connected to a template.|none|624x624px]]
=== Legacy Parking Settings ===
+
===Legacy Parking Settings===
  
==== 1. ParkZone setup ====
+
====1. ParkZone setup====
 
All settings for the Parking module is set in the configurator. Go to Template Editor -> Parkzone -> Manage -> Add
 
All settings for the Parking module is set in the configurator. Go to Template Editor -> Parkzone -> Manage -> Add
* 'Description' - This is the name for your setting, i.e. 'Test Plads'
+
 
* 'Client Key settings' - Insert the provided client key from ParkZone. To edit the settings for the client key, click 'Manage'. See picture below for illustration.
+
*'Description' - This is the name for your setting, i.e. 'Test Plads'
* 'Permission group' - Insert the provided parking location ID from ParkZone
+
*'Client Key settings' - Insert the provided client key from ParkZone. To edit the settings for the client key, click 'Manage'. See picture below for illustration.
* 'Delete users' - Check this box if a user should be disabled when removed from AD. If left unchecked, the user will only be disabled if the end date is set to now
+
*'Permission group' - Insert the provided parking location ID from ParkZone
* 'Cleanup' - Check this box if UMS should synchronise if users are active or deleted
+
*'Delete users' - Check this box if a user should be disabled when removed from AD. If left unchecked, the user will only be disabled if the end date is set to now
* 'Maximum number of license plates' - Set the limit of license plates a user may add
+
*'Cleanup' - Check this box if UMS should synchronise if users are active or deleted
 +
*'Maximum number of license plates' - Set the limit of license plates a user may add
 +
 
 
[[File:Parking permissiongroupsettings.png|none|thumb|435x435px|Permission group settings for ParkZone.]]
 
[[File:Parking permissiongroupsettings.png|none|thumb|435x435px|Permission group settings for ParkZone.]]
 
The picture below illustrates the settings when managing the client key.  
 
The picture below illustrates the settings when managing the client key.  
 
[[File:Parkzone clientkeysettings.png|none|thumb|567x567px|Manage client key settings for ParkZone.]]
 
[[File:Parkzone clientkeysettings.png|none|thumb|567x567px|Manage client key settings for ParkZone.]]
  
==== 2. APCOA setup ====
+
====2. APCOA setup====
 
All settings for the Parking module is set in the configurator. Go to Template Editor -> APCOA -> Manage -> Add
 
All settings for the Parking module is set in the configurator. Go to Template Editor -> APCOA -> Manage -> Add
* 'Description' - This is the name for your setting, i.e. 'Setup'
+
 
* 'Client key settings' - Insert the provided client key from APCOA. To edit the settings for the client key, click 'Manage'. See picture below for illustration.
+
*'Description' - This is the name for your setting, i.e. 'Setup'
* 'Permission group ID' - Insert the provided parking location ID from APCOA
+
*'Client key settings' - Insert the provided client key from APCOA. To edit the settings for the client key, click 'Manage'. See picture below for illustration.
* 'Delete users' - Check this box if a user should be disabled when removed from AD. If left unchecked, the user will only be disabled if the end date is set to now
+
*'Permission group ID' - Insert the provided parking location ID from APCOA
* 'Cleanup' - Check this box if UMS should synchronise if users are active or deleted
+
*'Delete users' - Check this box if a user should be disabled when removed from AD. If left unchecked, the user will only be disabled if the end date is set to now
* 'Maximum number of license plates' - Set the limit of license plates a user may add
+
*'Cleanup' - Check this box if UMS should synchronise if users are active or deleted
* 'Mail Domain' - User suffix  
+
*'Maximum number of license plates' - Set the limit of license plates a user may add
 +
*'Mail Domain' - User suffix
 +
 
 
[[File:Apcoa permissiongroupsettings.png|none|thumb|435x435px|Permission group settings for APCOA.]]
 
[[File:Apcoa permissiongroupsettings.png|none|thumb|435x435px|Permission group settings for APCOA.]]
  
Line 93: Line 102:
 
[[File:Apcoa clientkeysettings.png|none|thumb|332x332px|Manage client key settings for APCOA.]]
 
[[File:Apcoa clientkeysettings.png|none|thumb|332x332px|Manage client key settings for APCOA.]]
  
== App ==
+
==App==
  
=== Parking spaces ===
+
===Parking spaces===
 
This view is a list of all parking spaces the school has available (based on your template).
 
This view is a list of all parking spaces the school has available (based on your template).
  
Line 101: Line 110:
 
[[File:Parking Spaces App.png|thumb|First choose your Parking Space.|none|432x432px]]
 
[[File:Parking Spaces App.png|thumb|First choose your Parking Space.|none|432x432px]]
  
=== Parking registrations ===
+
===Parking registrations===
 
When you have selected a parking space, you will see a list of your registered license plates along with a timestamp of when this was registered.
 
When you have selected a parking space, you will see a list of your registered license plates along with a timestamp of when this was registered.
  
Line 108: Line 117:
 
[[File:You can add a license plate.png|thumb|You can add a license plate by clicking on the "plus sign" in the top right.|none|459x459px]]
 
[[File:You can add a license plate.png|thumb|You can add a license plate by clicking on the "plus sign" in the top right.|none|459x459px]]
  
=== General info ===
+
===General info===
 
The app does not (visually) act differently whether the school is running APCOA, Parkzone or CityParking.
 
The app does not (visually) act differently whether the school is running APCOA, Parkzone or CityParking.
  
== Web interface ==
+
==Web interface==
 
To register a license plate with a parking system go to “Your info”.
 
To register a license plate with a parking system go to “Your info”.
 
[[File:Your info.png|thumb|Go to your info|none|370x370px]]
 
[[File:Your info.png|thumb|Go to your info|none|370x370px]]
Line 123: Line 132:
 
You can always edit or delete your parking.[[File:A created registration.png|thumb|A created registration|none|390x390px]]
 
You can always edit or delete your parking.[[File:A created registration.png|thumb|A created registration|none|390x390px]]
  
== FAQ ==
+
==FAQ==

Revision as of 13:28, 28 February 2020

The Parking function makes it easy for users to avoid parking tickets at school. With this module, the school can administer their parking spaces with the parking company. Through the app, students and employees can get a valid, digital parking permit simply by entering their vehicle’s registration number in the app or in UMS Web. When the registration number has been entered, it becomes visible to the parking company. The parking company will then know that the user is allowed to park at the school. Available integration includes Parkzone, APCOA, and City Parkeringssystem.

Prerequisites

Supported administrative systems

  • Parkzone
  • Apcoa
  • City Parkering
    • The public IP address of the web server and backend server needs to whitelisted at City parkering.

Module requirements

Parking

Should third party be contacted

You'll need a client key (and possibly a password) from the parking company before UMS can communicate with their services.

Installation

It is necessary to have a running UMS installation.

Configuration settings

There are two ways of setting up parking: New Parking and Legacy Parking. In the future, Legacy Parking will be moved to the new system. Currently, new Parking settings are used for City Parkering and Legacy Parking settings are used for ParkZone and Apcoa.

New Parking Settings

In the configurator go to:

Modules -> Parking

Parking settings in the configurator

There are 3 main parts of the parking system that needs to be set up:

1. Parking servers

It is possible to set up multiple parking server systems.

You can add, edit, or remove a system.

The list of parking servers.

First, choose your parking system (currently only City Parkering is available, but more will be added in future releases).

The description is used as a name or reference in the configurator and is not visible to users.

You should have been provided a company key and a password by your parking provider. Enter them in these parking server settings. 

Parking server settings

2. Parking places

You can have multiple parking places and you can edit, add, or delete them.

Parking Places

The parking place description is shown to users that have multiple parking systems to choose from, so make sure that this is a good identifier.

Delete users

Users that are removed in UMS will also be deleted from the parking system.

Cleanup

Users that exists in the parking system but not UMS will also be deleted.

Mail Domain

Is used only when a parking is created for a user that does not have a private email address entered. If there is a private email address, it will be used. Otherwise, the username concatenated with the Mail Domain will be send.

3. Parking settings

You can set up a parking setting per template, so that one set of users have access to some parking places but not others.

If you only have one parking place, and everyone has access to it, you can just create one parking setting.

You can have multiple parking settings.
A parking setting is a collection of allowed and not allowed parking places.

You can connect a parking setting to a template:

  1. Go to edit your template.
  2. Find the parking menu and select the parking setting you want for you template.
A parking setting is connected to a template.

Legacy Parking Settings

1. ParkZone setup

All settings for the Parking module is set in the configurator. Go to Template Editor -> Parkzone -> Manage -> Add

  • 'Description' - This is the name for your setting, i.e. 'Test Plads'
  • 'Client Key settings' - Insert the provided client key from ParkZone. To edit the settings for the client key, click 'Manage'. See picture below for illustration.
  • 'Permission group' - Insert the provided parking location ID from ParkZone
  • 'Delete users' - Check this box if a user should be disabled when removed from AD. If left unchecked, the user will only be disabled if the end date is set to now
  • 'Cleanup' - Check this box if UMS should synchronise if users are active or deleted
  • 'Maximum number of license plates' - Set the limit of license plates a user may add
Permission group settings for ParkZone.

The picture below illustrates the settings when managing the client key.

Manage client key settings for ParkZone.

2. APCOA setup

All settings for the Parking module is set in the configurator. Go to Template Editor -> APCOA -> Manage -> Add

  • 'Description' - This is the name for your setting, i.e. 'Setup'
  • 'Client key settings' - Insert the provided client key from APCOA. To edit the settings for the client key, click 'Manage'. See picture below for illustration.
  • 'Permission group ID' - Insert the provided parking location ID from APCOA
  • 'Delete users' - Check this box if a user should be disabled when removed from AD. If left unchecked, the user will only be disabled if the end date is set to now
  • 'Cleanup' - Check this box if UMS should synchronise if users are active or deleted
  • 'Maximum number of license plates' - Set the limit of license plates a user may add
  • 'Mail Domain' - User suffix
Permission group settings for APCOA.

The picture below illustrates the settings when managing the client key.

Manage client key settings for APCOA.

App

Parking spaces

This view is a list of all parking spaces the school has available (based on your template).

If you only have 1 present, that parking space will automatically be selected and this step will be skipped.

First choose your Parking Space.

Parking registrations

When you have selected a parking space, you will see a list of your registered license plates along with a timestamp of when this was registered.

Here you can edit and delete existing registrations, as well as create more, up to the allowed number of registrations the school has specified.

Parking registrations.png
You can add a license plate by clicking on the "plus sign" in the top right.

General info

The app does not (visually) act differently whether the school is running APCOA, Parkzone or CityParking.

Web interface

To register a license plate with a parking system go to “Your info”.

Go to your info

If a parking system has been installed and you have access to it, you should see a parking menu.

You can then create a new parking, by clicking on the "create new".

You can see your parking permits.

Enter your license plate and select which parking location you want to use. If you only have access to one parking place, you do not have to choose one.

Once you click 'ok', the parking should be registered with the parking system and you should be good to go.

Enter your registration number and choose a parking spot.

You can always edit or delete your parking.

A created registration

FAQ