Report Templates

Main Steps to Create and Use a Report Template

You may want to adapt one of the report templates that ship with the LA County sample site. In the default Essentials installation, the report templates are here:

C:\Program Files (x86)\Latitude Geographics\Geocortex Essentials\Default\REST Elements\Sample Sites\LA_County\Resources\TemplateReports

The main steps to create a report template and use it in a site are:

  1. In Geocortex Report Designer, design the report template.

  2. Save the template to the Sites folder.

  3. In Geocortex Essentials Manager, add the template to the site.

  4. Edit the template in Manager and configure its settings.

Design a Report Template

The general procedure to design a report template is:

  1. Open the desired panel at Report Designer's left side: Controls or Geocortex Essentials.

  2. Drag a control from the left panel to the design area.

  3. Click the control to select it.

  4. To move the selected control, drag it across the design area.

  5. To resize the selected control, drag the control's handles.

  6. Configure the selected control 's properties in the panel at Report Designer's right.

    To display feature data in the generated report, set the control's DataField property to the name of the data field.

  7. Repeat this procedure until you have added and configured all the controls that you want in the template.

See also...

Include Data in a Report

Format a Report

Add a Report to an Essentials Site

To add a report to a layer:

  1. In Geocortex Essentials Manager, click Map in the side panel, click the Map Services tab, expand the map service that the layer belongs to, and then click the Edit icon next to the layer.

  2. Click the Reports tab. 

  3. Click Add Report.

  4. In the Display Name box, type a display name for the report.

    The display name can contain spaces and special characters.

  5. In the Description box, type a description for the report.

  6. If the report template includes one or more feature maps, select the Include Feature Maps checkbox.

  7. If the report template references one or more data links, select the Perform Data Linking checkbox.

  8. Click Next.

  9. If the report template (.rpx file) has not yet been placed somewhere within the Sites folder, upload it now:

    1. In the Filename list, open the folder that you want to upload the file to.

    2. Click Upload.

    3. Click Select.

    4. Browse to the file that you want to upload and select it.

    5. Click Open.

    6. Click Upload.

  10. Browse to the report template and select it.

  11. Click Finish.

    The report is added to the list of reports on the Reports tab.

  12. To configure additional settings, edit the report.

    For example, you can configure the output formats that users can choose from.

  13. Click Save Site.

Import Report Templates from Another Site

To import reports from another site:

  1. In Geocortex Essentials Manager, click Map in the side panel, click the Map Services tab, expand the map service that the layer belongs to, and then click the Edit icon next to the layer.

  2. Click the Reports tab.

  3. Click Import Reports.

  4. Select the site where the reports are configured, and then click Next.

  5. Select the map service that contains the layer where the reports are configured, and then click Next.

  6. Select the layer where the report is configured, and then click Next.

  7. Select the reports that you want to import.

    To select multiple reports, hold the Ctrl key down while selecting.

  8. Click Finish.

    The reports are added to the list of reports on the Reports tab.

  9. Click Save Site.

Edit a Report in Geocortex Essentials Manager

To edit a report:

  1. In Geocortex Essentials Manager, click Map in the side panel, click the Map Services tab, expand the map service that the layer belongs to, and then click the Edit icon next to the layer.

  2. Click the Reports tab.

  3. Click the Edit icon next to the report that you want to edit.

  4. Edit the report's settings.

  5. Click Apply Changes.

Report Settings

Reports have the following settings in Essentials:

Configure a Report to be Created in the Background

Web servers and browsers place a time limit on web requests. Normally, reports run with a single request and complete within the time limit. However, reports that are particularly large or contain a lot of data can take much longer.

To ensure that a large or complex report does not time out, you can configure the report to be created in the background. When a report is configured for background creation, you can configure email settings to notify the user when report creation starts and ends.

Only PDF reports can be created in the background.

To configure a report to be created in the background:

  1. In Geocortex Essentials Manager, click Map in the side panel, click the Map Services tab, expand the map service that the layer belongs to, and then click the Edit icon next to the layer.

  2. Click the Reports tab.

  3. Edit the report that you want to configure.

  4. Click Edit Print Job Settings.

  5. To turn on background report creation, select the Enable Print Jobs checkbox.

  6. Click the Email Settings tab to manage email notifications:

  7. Click the Message Settings tab to modify the text of notification emails to the user:

  8. Click the SMTP Settings tab to edit the SMTP server settings for sending status emails:

  9. Click OK.

  10. Click Save Site.

Feature Maps

A feature map is an image that shows a particular feature on a feature layer. Feature maps are used in reports to provide context. When an end user runs the report, a feature map of the currently selected feature is included in the report. The selected feature appears in the center of the map image. The map itself and any visible layers also appear on the feature map, just as they are configured in the Essentials site. This allows the user to see the feature and its surrounding area.

The following screen capture shows a feature map in a report for a tax parcel. The feature map is circled. The parcel in the feature map is highlighted cyan.

Parcel report with a feature map showing the selected parcel

Main Steps to Create and Use a Feature Map

The main steps to create a feature map and use it in a report template are:

  1. In Geocortex Essentials Manager, add a feature map to the layer that the report belongs to.

    Alternatively, if you already have a feature map for this layer in another site, you can import the feature map.

  2. In Report Designer, add the feature map to the report template

  3. In Geocortex Essentials Manager, make sure that the report's Include Feature Maps checkbox is selected.

Add a Feature Map to a Layer

To add a feature map to a layer:

  1. In Geocortex Essentials Manager, click Map in the side panel, click the Map Services tab, expand the map service that the layer belongs to, and then click the Edit icon next to the layer.

  2. Click the Feature Maps tab. 

  3. Click Add Feature Map.

  4. In the Display Name box, type a display name for the feature map.

    The display name can contain spaces and special characters.

  5. Click Apply.

    This generates the feature map's ID. The ID appears immediately above the display name.

  6. Take note of the feature map's ID.

    You will need the ID when you add the feature map to the report template.

  7. If you want to zoom the feature map out from the feature to show more of the surrounding area, enter a distance in the Buffer Distance box and select the units.

    Click Apply to see a preview. Repeatedly change the buffer distance and click Apply until you are happy with the buffer distance shown in the preview.

  8. If you want to change the highlight color, enter the color's hexadecimal value (for example, #EE82EE) or HTML color name (for example, violet) in the Highlight Color box. Click Apply to refresh the preview.

    Alternatively, click the color picker and select the new color from the color map.

  9. To adjust the opacity of the highlighting, drag the Opacity slider. Click Apply to refresh the preview.

  10. To turn off highlighting, clear the Highlight Feature checkbox.

  11. In the Resolution box, change the resolution of the feature map image if you want. The resolution is in pixels per inch.

    The default resolution is appropriate for viewing the report on screen.

  12. Click OK.

    The feature map is added to the list of feature maps on the Feature Maps tab.

  13. Click Save Site.

To reorder list items, click and drag the  Sort handle Click and drag to change the order.

Import Feature Maps from Another Site

To import feature maps from another site:

  1. In Geocortex Essentials Manager, click Map in the side panel, click the Map Services tab, expand the map service that the layer belongs to, and then click the Edit icon next to the layer.

  2. Click the Feature Maps tab. 

  3. Click Import Feature Map.

  4. Select the site where the feature maps are configured, and then click Next.

  5. Select the feature maps that you want to import.

    To select multiple feature maps, hold the Ctrl key down while selecting.

  6. Click Finish.

    The feature maps are added to the list of feature maps on the Feature Maps tab.

  7. Edit each imported feature map and adjust the settings as needed to make the imported settings work in this layer.

    For example, the buffer distance could exceed the scale range of the layer that you imported the feature map into.

  8. Take note of each feature map's ID.

    You will need the IDs when you add the feature maps to report templates.

  9. Click Save Site.

To reorder list items, click and drag the  Sort handle Click and drag to change the order.

Feature Map Settings

Feature maps have the following settings:

Add a Feature Map to a Report Template

To add a feature map to a report template:

  1. In Report Designer, open the report that you want to add the feature map to:

  2. Drag a Picture control from the left panel to the desired position on the design surface.

    If there is no Picture control, the Geocortex Essentials-specific controls may be open. Click Controls to open the standard controls.

  3. Drag the Picture's handles to adjust its size to the size that you want the feature map.

  4. Make sure that the Picture is selected on the drawing surface.

    This displays the Picture's properties in the right panel.

  5. Configure the Picture's properties:

    1. In the Data area, set DataField to the feature map's ID.

      This puts the feature map into the Picture control. If you do not know the feature map's ID, edit the layer in Manager and click the Feature Maps tab to see the ID.

    2. In the Behavior area, make sure that Visible is set to True.

      If Visible is False, the feature map will not appear in the report.

    3. If you want the feature map to have a border, configure the LineColor, LineStyle and LineWeight properties in the Appearance area.

    The Picture's properties will look something like this:

    Example configuration for a Picture that contains a feature map

  6. To add a caption to the feature map, drag a TextBox control below the Picture on the design surface and set the Text property in the Data area to the caption's text.

  7. Save the report template.

© 2017 Latitude Geographics Group Ltd. All Rights Reserved.

Documentation Version 4.11