# How to request a permit
- Open the permit panel
Permits can be viewed from the permit panel in the map view. From the left hand sidebar on the map view, click on the
icon to open the permits panel. Click on any permit to view it in the permit summary panel.
- Open the permit creator panel
Near the top of the permit panel you will see the
icon. Click on this to open the permit creator panel.
- Request the permit
Once all required fields have been filled in, click Submit to request the permit.
# Request fields
The various permit fields are:
# Type
Select a type from the list of pre-defined permit templates.
# Description
Add a brief description of the intended purpose of this permit.
# Layers
Optionally add layers to this permit. These layers will show up in any map views associated with this permit. You can also click the
or
icons to toggle alerts for these layers. If the data of a layer with alerts enabled is updated at any point during the permit lifecycle users will be prompted to review the permit before continuing.
TIP
Note that an administrator must designate a layer as being allowed in permits, otherwise it won't be available for selection.
Permit layers may also be assigned at the template category level. These layers cannot be removed or have their alerts enabled value updated.
# Permit area
Define an area that the permit is intended to cover. You can add multiple polygons if required. At least one polygon is necessary to request a permit.
# Valid from
Define a date and time from which you want this permit to be valid. The duration of a permit is defined at the template level.
If a lead time is configured for this permit type, you can only select a start date and time that occurs after the request time plus the lead time.
# Renew on
If the permit type allows the renewal period to be reduced, a button labelled Adjust renewal period will appear below the Valid from selector. Clicking it reveals a new Renew on selector, enabling you to choose a new renewal time from between the start time and the original renewal time.
- The new renewal period (i.e. between the start time and the new renewal time) will be used for all renewals of this permit, not just after creation.
- The renewal time can be set to the minute, so the renewal period doesn't have to be a whole number of hours.
- Click Reset to template default to revert it to the original renewal time.
Some permit types let you request a start time inside the lead time anyway, by asking you to complete additional escalation categories justifying the short notice. For permit types which do not offer these, a start time before the lead time cannot be selected.
# Categories
If any categories are assigned to this permit you will need to respond to any prompts which they contain. Click on a category to open it up. Once you are finished responding to the prompts, click "Confirm" to close the dialog. All category prompts must be completed before requesting a permit. You must also select the permit category signoff users for this category.
# Escalation categories
These appear above the standard categories, under their own Escalation categories heading, and only when the start time you selected falls before the permit type's lead time. They exist so a permit needed at short notice can still be requested, with this short notice signed off by the relevant signoff user(s) rather than passing unnoticed.
These are completed and must be signed off as per standard categories.
TIP
Change the Valid from date to a time after the lead time and the escalation categories disappear, since they no longer apply. Move it back inside and they return.
WARNING
The lead time is measured from the moment you submit the request, so it moves as time passes. If you select a start time only just outside the lead time and then spend a while filling in the rest of the form, the escalation categories may appear before you submit. You will need to complete them to continue.
# Signature requirements
Select the permit signoff users for this permit. This will be pre-filled if there is only one valid selection.
# Attachments
Click the
icon to attach files to your permit. These files will be viewable by anyone looking at this permit.
Attachments are limited to 60MB. Some file extensions are restricted for security reasons.
# Options
# Legend layers only
If toggled on, the legend layer on the permit document will hide sublayers by default.
# Save as draft
You can save your progress when requesting a permit by clicking the
icon at the top of the permit creation panel. You can then close the panel and come back to it another time. When you select a permit type in the creation panel you will be prompted to load the draft for that type if one exists.
Please note that:
- Each user can save one draft instance per permit type.
- Existing drafts are deleted when the permit is requested.
- Drafts expire 180 days after creation.
← Lapsed View a permit →