Reports

LocalMaps allows you to bring together maps, tables, and text elements to form one cohesive report through its reporting functionality. The data can be referenced on the fly through spatial query against the feature that is present in your maps or from your connected data sources. You can create your template through the admin panel and include elements such as images, tables, and maps as required.

Once created, reports can be added to one map or multiple maps provided they contain the appropriate layer the report was set up against. This can be done through the Maps and Apps section. Here is a guide to creating and generating reports through LocalMaps.

Pre-requisites

1. Navigate to the admin panel and on the sidebar click on Reports.
2. Select the report group under Report-> Settings.
3. Select the report group here. Note: Ensure that this group should have all the maps and layers that you want to include in your reports.
4. Add export web map URL and Layout service URL that you want to base your report on. Note: Updating these services is optional, by default LocalMaps uses ArcGIS online services for generating reports. This will work fine but at times this may delay the report generation if the request traffic is too high on these services. We recommend generating and publishing services for the reports individually and adding them here.
5. Select a time for the report expiry. Generated report will be available to download through the Viewer during this time.

Creating a Report

1. Click on the Reports -> and on the Reports section.

2. Click on Add Report Configuration to create a new report.

3. In the report configuration dialogue box, give a name to the report under the report name field. This name will be for the administrative reference.

4. Paste the feature layer service URL on which you want to base your report under Report layer field. e.g. Layer URL to paste - https://gis.wcc.govt.nz/arcgis/rest/services/PropertyAndBoundaries/Property/MapServer/0 Note: This layer should be available within the map where you want the report to be generated.

5. Click on Save to continue.

Configuring Output name and format

You can configure the output file name and the format through the options shown below.

To enable dynamic naming based on the selected feature, include the field name with curly braces. E.g. {OBJECTID} report

Adding Text

1. Click on Add Element to get started and select the Rich Text. This will open the report text formatting dialogue box.

2. Add text content as required. You can format the text as Headings, paragraph as needed along with font formatting options.

   Note: You can include the data from the layer you have based your report on. For this, add the datapoint between two curly brackets (“{{“,”}}”). While generating reports, this gets replaced with the data according to the feature on which the report is generated on the map.

   Tip

   If you have the text formatting done in a MS word document, copy and paste the text in this box. This will retrieve the formatting and bring through any images.
   In the example given below, the Datapoint to include is ObjectID, FullAddress and Title. So, the syntax to use is {{ObjectID}}, {{FullAddress}}, {{Title}}. The wording should match exactly how it is configured in the feature layer.
   

3. Once the content is added, click on save to continue. Now the report is created and saved.

4. You can include any images available online by clicking on the ‘Insert image via URL’ option and adding the image URL.

   

Adding Map print to the report

1. Click on Add Element to get started and select the Map Print element. This will add the map layout dialogue box in which you can configure the map print.

   

2. You can configure the map that should appear in your report and how the output should be i.e. Scale, inline or in a new page along with dimensions.

3. Once the map element is added, click on save to continue. Now the report has map element included and saved.
   Note: If you make any changes to the map print element, you need to save the changes manually by clicking on ‘Update web map print JSON’.

Adding Table to the report

1. Click on Add Element to get started.

2. Select the Table element. This will open the table formatting dialogue box in which you can configure queries.

3. Click on Configure queries to get started.

4. In the Layer query dialogue box, give a unique name to the query.

5. Select the query layers from your content, i.e. from Portal or ArcGIS online or your connected data sources.

6. Or alternatively, input the service URL that you would like to query against. When you select it, it will auto-populate the Currently Selected Query Layer field.

7. Select the type of join you want i.e. Spatial join or Table join.
   a. Spatial Join allows you to pull information based on the interaction. i.e. Contains, intersect, overlaps or within.

   
   b. Table Join allows you to pull information based on the criteria setup in the Where clause i.e. Equals, not equals. Example below
   

Spatial Join

1. If Spatial join is selected, select the feature interaction, buffer distance and units and click next.

2. Select the fields that needs to be displayed in the output file and click submit to complete adding the table element.

Table Join

1. If Table join is selected, Select the fields that needs to be displayed in the output file and click next.

2. Select the field you want to match from the target source and the field to match from the existing layer in the web map. After this, select the appropriate clause and click submit.

   Once the elements are added, report can be added to the map and generated.

Add a report to the map

1. Click on the Maps and Apps on the left tab in the administration panel.

2. Select the map where you want the users to generate this report. Please note this map should have the layer used to create the report.

3. Click on the reports tab to view the reports that can be enabled on that map.

4. Select the report and enable it. You will get a confirmation message on the bottom right when the map settings are updated.

Generate Report

1. Open the map and click on a feature from the layer. The pop-up opens with the information associated. If the map has reports configured, you will be able to see the Reports icon on the top right corner of the pop-up. Click to generate a report.

2. Select the report from the drop-down and click on submit to generate a report based on the feature selected.
   

3. Once the report is generated, the status message will change to complete, and you will get a clickable link. Click on the ‘Download Report’ to get the file downloaded to your locale.