Reporting Tool

The Reporting tool provides a very simple way for users to report issues (e.g. Fly-tipping, potholes, hazards). Although the tool is very simple to use, it supports a number of advanced features for submitting reports to your back-office system of choice.

../_images/reporting.png

When the user activates the Reporting tool an orange marker will be shown at the map centre. This is the location that will be reported. The user may now position the marker exactly by either (1) clicking on the map or (2) dragging the marker or (3) using the Set My Location option which will position the marker at the location reported by their browser or mobile device.

The user submits the report with the REPORT button and should receive notification of successful submission as shown below.

../_images/submitted.png

With Mappin’s support for multiple projects, the Reporting tool can be configured in different projects to report different incident types (e.g. Fly-tipping, potholes).

Configuration

The Reporting tool has the following settings.

../_images/reporting_settings_1.png

When the user clicks REPORT, the reporting tool optionally performs some pre-submission checks before sending the information configured in its settings to a third-party HTTP endpoint / URL (e.g. your back-office system) using the HTTP POST method.

Alias

How the reporting tool will be called in Mappin for users (e.g. Report Fly-tipping).

Layer

A layer used for pre-submission checks. At present, a layer must be selected here even if no pre-submission checks are desired.

Check Intersection

If enabled, will check that the reported location intersects a feature from the pre-submission checks layer. If enabled and the check fails, Failure Msg (see below) will be displayed to the user and the report will not be submitted. To disable pre-submission checks, disable this option and also set Check Within (see next option) to zero.

Check Within

If specified (and Check Intersection is enabled), Mappin will check that the reported location either intersects a feature from the pre-submission checks layer or is within Check Within map units of a feature. If specified and the check fails, Failure Msg (see below) will be displayed to the user and the report will not be submitted.

Failure Msg

A failure message shown to the user if any of the pre-submission checks fail.

Submission Url

The URL to which the report will be submitted to by Mappin using the HTTP POST method (e.g. http://your-back-office-system.example.com).

Submission data

As a minimum, the x and y coordinate values are submitted within the report. The alias settings can be used to control the HTTP POST variable names used. The ADD FIELD button can be used to add optional fields.

Optional field (Literal)

A Literal field adds a POST variable with a static value that never changes. If you have configured multiple Mappin projects for reporting different types of incident and you send all reports to the same endpoint, then this can be a useful setting to specify what type of report is being submitted.

Here we define a POST variable called report_type which has the value flytipping.

../_images/optional_1.png

Optional field (Attribute)

An Attribute field allows attribute values from nearby features to be included in the report. For example, when reporting dog fouling in parks, you wanted to include the name of the park in the report submission - you’d just specify Intersection with the Public parks or gardens:Name attribute.

Condition can be Intersection or Nearest (returns the selected attribute value of the nearest feature).

../_images/optional_2.png

Optional field (Optional CRS)

An Optional CRS field allows x and y coordinates to be submitted in other coordinate reference systems. In the example below we’ve added lon and lat fields which will return longitude and latitude in WGS 84 (EPSG:4326).

../_images/optional_3.png