{"id":535052,"date":"2019-07-05T14:38:36","date_gmt":"2019-07-05T21:38:36","guid":{"rendered":"https:\/\/www.esri.com\/arcgis-blog\/?post_type=blog&p=535052"},"modified":"2021-12-06T07:24:55","modified_gmt":"2021-12-06T15:24:55","slug":"print-reports-from-arcgis-enterprise-web-apps","status":"publish","type":"blog","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/mapping\/print-reports-from-arcgis-enterprise-web-apps","title":{"rendered":"Print reports from ArcGIS Enterprise web apps"},"author":7351,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":""},"categories":[22941],"tags":[24921,31201,296842,29441,32751],"industry":[],"product":[36571,36561],"class_list":["post-535052","blog","type-blog","status-publish","format-standard","hentry","category-mapping","tag-javascript","tag-print","tag-print-service","tag-reports","tag-web-apps","product-arcgis-enterprise","product-arcgis-pro"],"acf":{"short_description":"By baking a report template into a custom print service, you can make informative reports available for printing in ArcGIS Enterprise.","flexible_content":[{"acf_fc_layout":"content","content":"

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.<\/p>\n

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.<\/p>\n

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. \u00a0Including text and graphical elements that describe the data in the map can make your printed document more useful and informative.<\/p>\n

Recently, ArcGIS Pro introduced a new capability to create reports<\/a>. 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.<\/p>\n

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.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":560452,"id":560452,"title":"report4","filename":"report4.png","filesize":304746,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report4.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/mapping\/print-reports-from-arcgis-enterprise-web-apps\/report4","alt":"Sample report with text elements","author":"7351","description":"","caption":"","name":"report4","status":"inherit","uploaded_to":535052,"date":"2019-07-06 00:06:16","modified":"2019-07-06 00:06:43","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":1920,"height":1077,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report4-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report4.png","medium-width":464,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report4.png","medium_large-width":768,"medium_large-height":431,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report4.png","large-width":1920,"large-height":1077,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report4.png","1536x1536-width":1536,"1536x1536-height":862,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report4.png","2048x2048-width":1920,"2048x2048-height":1077,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report4-826x463.png","card_image-width":826,"card_image-height":463,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report4-1920x1077.png","wide_image-width":1920,"wide_image-height":1077}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

As you select features or filter them with a definition query, 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.<\/p>\n

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.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":560462,"id":560462,"title":"report3","filename":"report3.png","filesize":99665,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report3.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/mapping\/print-reports-from-arcgis-enterprise-web-apps\/report3","alt":"Dynamic table in a printed report","author":"7351","description":"","caption":"","name":"report3","status":"inherit","uploaded_to":535052,"date":"2019-07-06 00:11:01","modified":"2019-07-06 00:11:13","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":1080,"height":743,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report3-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report3.png","medium-width":379,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report3.png","medium_large-width":768,"medium_large-height":528,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report3.png","large-width":1080,"large-height":743,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report3.png","1536x1536-width":1080,"1536x1536-height":743,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report3.png","2048x2048-width":1080,"2048x2048-height":743,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report3-676x465.png","card_image-width":676,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/07\/report3.png","wide_image-width":1080,"wide_image-height":743}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

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\u2019s highly reproducible, and as with other custom print templates, you can personalize it with your organization\u2019s logos, acknowledgments, and other design elements.<\/p>\n

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.<\/p>\n

Before we dive deep, let\u2019s cover some basics first:<\/p>\n"},{"acf_fc_layout":"content","content":"

Requirements and limitations<\/h2>\n

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.<\/p>\n

There is no generic report template available to embed \u2013 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.<\/p>\n

This workflow makes use of a custom ArcPy script tool. If you\u2019ve never created a custom tool with ArcPy, don\u2019t fear \u2013 we\u2019ll help you make sense of what\u2019s needed.<\/p>\n

To help you learn the workflow, we\u2019ve made some sample resources available at the following links:<\/p>\n

    \n
  1. A zip file containing some sample code:<\/a>\n