ArcGIS Enterprise

Print reports from ArcGIS Enterprise web apps

Printing maps is essential to GIS. To print a static map from a web application, we rely on print services, just as we rely on a map service to run a web map or a geoprocessing service to run a web tool.

A print service generates high-quality printable documents with a map and elements like titles and legends in an image file format or a vector format (such as PDF). The client application can send these documents to a printer or plotter to produce an excellent-looking map, be it large or small.

Maps may be the most important element printed from your web GIS applications, but in many cases, a map is not enough to convey all the information you want.  Including text and graphical elements that describe the data in the map can make your printed document more useful and informative.

Recently, ArcGIS Pro introduced a new capability to create reports. Reports combine maps (and all their component elements like legends and scale bars) with non-map elements, such as tables and textual descriptions generated from the data in the map extent.

This example report on endangered aquatic species in Canada was created in ArcGIS Pro and then packaged in a custom print service. When we embed that service in a JavaScript app’s print widget, we’re able to regularly print the report template.

Sample report with text elements

As you move the map extent around or select features, the other content in the report dynamically updates. This makes it easy to quickly reproduce professional-quality reports for different geographical areas and data sets while maintaining a consistent look and organization.

Here, we selected several areas of the St. Lawrence River centered around beautiful Riviere-du-Loup, Quebec. The first page of our report (above) included the map, legend, reference inset, and other textual elements. The second page (below) contains a table that shows each of the aquatic species at risk within our selected features. Had we instead selected areas around the Bay of Fundy, our map and table elements in the printed report would have described those selected features.

Dynamic table in a printed report

While reports are really useful on their own in ArcGIS Pro, they can also give an extra dimension to your web applications. Embedding a report in a print service allows it to function as an available template for printing in your app. Anyone using the app can set a specific map extent and then print a report, with its non-map elements describing that map extent, in the same format automatically. It’s highly reproducible, and as with other custom print templates, you can personalize it with your organization’s logos, acknowledgments, and other design elements.

Today, we’ll show you how to use reports created in ArcGIS Pro in a print service to make the report template available in your web apps.

Before we dive deep, let’s cover some basics first:

Requirements and limitations

To create and share reports, you need to be using ArcGIS Pro 2.3 or later. To embed a report in a print service, you need to publish it to ArcGIS Server 10.7 or later.

There is no generic report template available to embed – this is because reports are bound to a specific data schema. The layers with which you associate elements in the report must contain field names that match the field names you use in the report.

This workflow makes use of a custom ArcPy script tool. If you’ve never created a custom tool with ArcPy, don’t fear – we’ll help you make sense of what’s needed.

To help you learn the workflow, we’ve made some sample resources available at the following links:

  1. A zip file containing some sample code:
    • A script tool (.tbx) ready to be published as a print service
    • Two python script files (.py), and
    • A report file (.rptx) created to work with a feature layer used in the following web map, created to only use selected features
  2. A web map that contains a feature layer showing U.S. state boundaries
  3. A finished web application with Select and Print widgets

Prepare the print service

1. Download the zip file linked above and unzip it on your machine.

2. Copy the State Population Subregion Report.rptx file to the folder where you have stored your Layout Templates (.pagx).

If you want to use the default layout templates, you need to copy this .rptx file to the C:\Program Files\ArcGIS\Pro\Resources\ArcToolBox\Templates\ExportWebMapTemplates folder.

3. Open ArcGIS Pro.

4. On the Catalog pane, right click on Toolboxes node and select Add Toolbox option from the context menu. Select Printing.tbx.

Adding a new toolbox

5. Expand the toolbox – you’ll see two script tools in there.

Opening the Printing toolbox

Double-click on the Export Web Map tool to open it.

6. In the tool options, specify the Layout Templates Folder where you have your .pagx and .rptx files stored. If you want to use the default folder, leave that line blank.

7. Click the Run button to execute the tool – stick around to make sure it runs successfully!

8. Next, do the same with the Get Layout Templates Info tool.

9. Share the geoprocessing results of both tool tasks you’ve just run – either as a web tool to your ArcGIS Enterprise portal, or as a geoprocessing service to your stand-alone ArcGIS Server, if that’s what you’re using. On the Configuration tab, for the Execution Mode property, choose Synchronous.

Note: If you publish a geoprocessing service on a server running off your local machine, you can start it right away with the sample web map.

Use the service in a web mapping application

If you published your print service on a server running on your local machine (i.e. localhost), open the sample web application.

If you published the print service on a different machine, you need to create a new Web AppBuilder application from your portal or in ArcGIS Online. You can use the sample web map in your application if you’d like.

Add two widgets to the web app: Select and Print. For the Print widget, specify the URL of the print service you created from your Export Web Map task in the previous step.

Now, it’s time to try out your new print service! Use the Select widget to select a few states on the map.

Click on the Print widget, then click the Print button. You should receive a PDF output file in a few moments.

What did I just do?

While you’re waiting, let’s explain what happens behind the scenes.

The web app makes a call to your print service URL to print from the report template, including the specific states that you selected to give info in the report’s tables.

The print service is technically a geoprocessing service running on ArcGIS Server. Printing on the server does the same basic action as running Export Web Map does in ArcGIS Pro.

While the default print service that comes with ArcGIS Server is basically parallel to Export Web Map, the custom script tool you created modifies that operation to export your specific report template.

Your custom print service performs the work of producing a PDF as specified and returns the output to the web app, which passes it to you.

The completed and printed report

Back to the map

By now, your printed map should be ready.

Click on the result to open it, and you should see your report. The first page contains the map with the selected states highlighted, while the rest of the report includes attribute tables describing the data from your selections.

Had you selected different states before printing, the printed report would have included attribute data for those states instead.

You can see how this makes printing with report templates endlessly versatile. Once your custom print service is up and running on ArcGIS Server, you and your users just need to select what they want to see and hit Print – the service will do the rest.

About the authors

Tanu is a product engineer on Esri Mapping Team focusing on map service, print service, and ArcGIS Pro. He also works on spatio-temporal analysis, spatial aggregation and real-time data. Tanu’s background includes a masters in Urban Planning from University of Akron, Ohio, USA and a bachelor degree from Khulna University, Bangladesh, and worked as GIS Coordinator in City of West Springfield, and GIS Specialist in a hydrology modeling center in Bangladesh before joining Esri in 2007.

Scott is a product engineer on the ArcGIS Enterprise team. Follow him on Twitter: @macd_sm.

Connect:

Next Article

New color ramps in Map Viewer Beta

Read this article