Geocortex Printing Help
Open topic with navigation
The quickest way to create a print template is to use one of the preconfigured templates that come with Geocortex Printing, such as the 8.5 x 11 Landscape template or the A4 Landscape template. The preconfigured templates offer a standard layout that includes the map, overview map, legend, scale bar, map information, and north arrow, with areas for the logo, title, notes, and disclaimer.
This tutorial shows you how to create a print template based on a preconfigured template, configure an application to host the print template, and run the print from the host application.
Geocortex Printing can run in two environments—in the cloud or on premises. To do this tutorial, you must have an ArcGIS identity that gives you access to one of these environments.
Cloud: To do this tutorial in the cloud environment, you need an ArcGIS Online account. You can use a public account or an organizational account. You can get a public account here for free.
On Premises: To do this tutorial using on-premises Printing, Geocortex Printing must be installed and registered either with Portal for ArcGIS or with ArcGIS Online. See
Portal for ArcGIS: If Geocortex Printing is registered with your organization's on-premises installation of Portal for ArcGIS, do this tutorial using the account that you use to access your organization's portal.
ArcGIS Online: If Geocortex Printing is registered with ArcGIS Online, do this tutorial using your ArcGIS Online account.
The steps to create a print template based on a preconfigured template are as follows:
Create a new print template using a preconfigured template.
Brand the print template.
Preview the print.
Save the print template.
Share the print template.
Host and run the template in a supported host application:
In this tutorial, the vertical bar is used to list Print Designer elements that you access in the given order, for example:
Properties | <control> | <section> | <setting>
Click Properties , select <control> in the drop-down list, expand the <section> area, and configure the <setting> property.
Note that <control> can refer to a particular control or band in the layout or to the template as a whole.
Launch Geocortex Print Designer and click Let's get started. Sign in if you are prompted.
If you use Geocortex Printing in the cloud, you can access Print Designer here.
Click the 8.5 x 11 Landscape tile. Alternatively, click New | 8.5 x 11 Landscape.
Print Designer shows the layout of the 8.5 x 11 Landscape template on the design surface ().
The Properties panel () shows the properties for the currently selected item, either a control or the template as a whole. Initially, the template as a whole, Print (XtraReport), is selected.
To select a control, click the control in the layout or select the control in the Properties drop-down list. To select the template as a whole, click the background of the design surface or select the template in the Properties drop-down list.
In the Properties list, the name is followed by the type of control, for example, in "Map (XRMapPictureBox)", the control is named "Map" and the type is "XRMapPictureBox".
You can change the name of any layout element using the Properties | <control> | Design | Name setting. The name can contain letters, numbers, and underscores. It cannot contain spaces or special characters.
Preconfigured template in Print Designer (), with the template's properties shown in the Properties panel ()
To verify the paper size and orientation of the layout as a whole, open Properties | Print (XtraReport) | PageSettings. The Landscape checkbox controls whether the layout is portrait or landscape orientation. The Paper Kind setting controls the height and width of the paper that the print output is intended to be printed on.
Page settings for the print template
Create Print Templates
In this step, you will brand the print template by replacing the default logo with your organization's logo.
In addition to the logo, you may want to configure the font, color, and other appearance settings to conform to your corporate style. For more information, see Brand Print Templates.
The preconfigured templates use Panel controls to organize the template into functional areas. Panels allows you to move and copy related controls as a unit.
The logo is in the TopPanel control with the title.
TopPanel control, containing the logo and title
This tutorial uses a high-resolution image for the logo. The image is larger than the control, so the Sizing setting is used to fit the image to the control.
The size of a control is given in Properties | <control> | Layout | Size. The units are set at the template level, in Properties | Print (XtraReport) | Actions | Measure Units.
In the layout, click the logo's control to select it.
This also selects the control in the Properties panel. The control is called OrganizationLogo.
Default logo selected in the layout
Specify the logo file's location:
Workstation: If the image is on your workstation, you can select the file in the file system. This embeds a copy of the image in the print template. The preconfigured templates use this method.
In Properties | OrganizationLogo | Actions, click the icon in the setting where the default image is configured. Browse to your logo file, select it, and click Open.
Setting to select an image on your workstation
Web Server: If the image is served by a web server, you can specify the image's HTTP or HTTPS URL. In on-premises Printing, you can specify the image's file path on the server instead of the URL.
Cloud Printing does not support file paths.
In Properties | OrganizationLogo | Actions, type or paste the logo's URL in the top Image URL box.
Setting to specify an image by its URL
The custom logo replaces the default logo in the OrganizationLogo control. If the logo is larger than the control, only part of the logo is visible.
Custom, high-resolution logo in the OrganizationLogo control
In Properties | OrganizationLogo | Actions | Sizing, select Squeeze from the drop-down list.
High-resolution logo squeezed to fit the OrganizationLogo control
Drag the middle, right handle of the OrganizationLogo control towards the left to adjust the width of the control.
Alternatively, you can use the settings in Properties | OrganizationLogo | Layout | Size to adjust the size of the control.
Handle to drag to resize the width of the control
Control resized to fit the logo's width
Move the LogoSeparator control to the left.
To move a control, you can either drag the control or select the control and use your keyboard's arrow keys to move it.
Alternatively, modify the Properties | LogoSeparator | Layout | Location settings.
LogoSeparator moved to the left
Increase the size of the MapTitle control to fill the available space.
MapTitle control resized to fit the available space
Use Images in Prints
Print Designer has a Preview function for running prints. The Preview function allows you to verify a print template's layout while you are designing it.
The preview shows a placeholder map and overview map. To produce a print using your own map, you must run the print from a host application.
To preview a
apps.geocortex.com (cloud Printing) or from your domain (on-premises Printing).
Click Preview .
The preconfigured templates have two controls that use parameters in their configuration. A parameter is a placeholder for print content that gets its value when the print is generated. You can use a parameter in any Label control.
The controls in the preconfigured templates, MapTitle and NotesDesc, use parameters called Title and Notes respectively. The Preview prompts you to enter values for Title and Notes.
Prompt to enter values for the Title and Notes parameters
Type in values for Title and Notes, if you want.
Default value for the Title parameter replaced with a custom title
The PDF will open in a new browser tab.
Print preview, showing the placeholder map
Configure Print Inputs
Press Ctrl+S or click File | Save As.
Enter a name for the print template.
When you save a print template for the first time, an item is created for the template in your ArcGIS content. The item's URL is given in Print Designer's Info panel. To open the item in ArcGIS, click the View hyperlink. The Info panel also provides an area to enter a description of the template.
Info panel, showing the URL for the print template's ArcGIS item
When you first save a print template, only you have access to the template. You can share print templates with groups that you belong to, with your entire organization, or with everyone (including the public). In this tutorial, for simplicity, you will share the template with everyone.
Normally, you have to share the host app in addition to the print template. You do not need to share the host app in the context of this tutorial because only you will run the app.
To share a print template, you share the print item in ArcGIS. In some Web AppBuilder scenarios, you also have to share the Geocortex Printing widget that runs the print.
Normally, we do not recommend sharing print templates with everyone unless the application is public and you want to allow anyone to run the print.
Sign in to your ArcGIS account.
You can open your ArcGIS account from Print Designer by clicking Info | View.
Share the print item:
On the print item's details page, click Share.
Select the Everyone (public) checkbox.
If you are running Web AppBuilder in Portal for ArcGIS 10.6+, share the widget item.
This allows anonymous users to run the print.
Go to your Content area.
Open the widget item's details.
Select the Everyone (public) checkbox.
Host the Print Template
To configure an HTML5 viewer to host a print template, you add the template to the Essentials site.
Edit the site in Geocortex Essentials Manager.
Click Print Templates in the sidebar.
Type a display name and optional description for the template.
The HTML5 Viewer's Print function uses the display name to list the available templates for the user.
Example display name and description for a print template
Make sure A print template defined by an ArcGIS item is selected.
Type some text to search for the
Alternatively, copy the
Example ArcGIS print items
Print item selected
Click Save Site.
The viewer now hosts the print template. Users can run the print from the viewer.
You can configure map scales and resolutions for users to select by editing the template.
Run the print
Users run prints using the HTML5 Viewer's Print tool, which generates printable maps based on Geocortex print templates.
Launch the viewer.
Click the Print tool in the toolbar to open the Print Map panel.
In the Desktop and Tablet interfaces, the Print tool displays an overlay on the map. The overlay represents the area to print.
Geocortex Viewer for HTML5 Print Map panel () and overlay ()
Configure the settings in the panel:
Select Layout: Select the print template.
Output Format: The output format is PDF.
Grid, Map Scale, Notes: For this tutorial, use the default values.
Title: For this tutorial, enter the following title:
Select the area to print:
Desktop or Tablet Interface: In the Desktop or Tablet interface, adjust the position of the map under the overlay to indicate the area to print. Clearing the Lock print preview with map checkbox allows the map to move independently of the overlay.
Handheld Interface: In the handheld interface, pan and zoom the map to center the area of interest in the map viewport and then click Center print here.
Click Print to submit the print request to Geocortex Printing.
When the Print Map panel indicates that the print is ready, click Open File to view the PDF.
If you have selected features or drawn markup on the map, the selection and markup will show in the print output.
Print generated from a template hosted by a Geocortex HTML5 viewer
Host the print template
Before a Web AppBuilder app can host a print template, you must register the Geocortex Printing custom widgets. The custom widgets allow you to host and run print templates from Web AppBuilder apps. See Register the Geocortex Printing Custom Widgets for information.
To configure a Web AppBuilder app to host print templates, you add the Geocortex Printing widget to the app and select the templates that you want the widget to run.
To configure a Web AppBuilder app to host the print template:
In Web AppBuilder, configure the app that will host the print template.
Add the Printing widget:
Click Widget to open the Widget panel.
Open the Widget panel
Click Set the widgets in this controller.
Click the icon to add widgets.
Select the Printing widget and click OK.
The Configure Printing dialog box opens.
Configure the Printing widget:
Click Add Print, select the print template to host, and click OK.
Print template added to the Printing widget
Enter a name and description for the template:
The name and description appear in the app's Printing panel.
In the Name box, type the following name for the print template:
In the Description box, type the following description for the print template:
Name and description to appear in Web AppBuilder's Printing panel
Save the app.
Run the Print
Launch the app.
Pan and zoom the map to show the area that you want to print.
Map panned and zoomed to the area of interest
Click the Printing widget to open the Printing panel.
Printing panel with one print template
Click the template.
The panel displays the input parameters and settings.
Input parameters and settings
Configure the inputs and settings:
Title: For this tutorial, enter the following title:
Notes, Map Scale, Resolution, Grid: For this tutorial, use the default values.
When the Printing panel indicates that the print is ready, click Download to view the PDF.
Print generated from a template hosted by a Web AppBuilder app