Dynamic elements in a report change based on the current properties of the report. When element properties update, the corresponding photo or report text updates.
Note:
Dynamic elements used in a report do not carry through to supplemental pages. Those that originate on a supplemental page reflect their origination properties, not the report properties.
Add a dynamic photo to a report to enhance its appearance by showing an image captured alongside the attribute data.
You can add dynamic text for things such as the file path of a project, the date a report was exported, or a summary statistic.
Dynamic text elements use tags, similar to HTML, so you can combine dynamic and static text in a single text element and apply the available formatting options to customize the resulting text display. When dynamic text is added to a report, only the label appears. The actual value is shown when the report is exported to a PDF. You can format text properties of dynamic text elements, such as font, size, color, and position, or you can edit the tags to modify the output value.
The following is an example of a dynamic text tag for page numbers as shown in the Text View box in the Format Text pane:
Page <dyn type="report" property="current-page"/> of <dyn type="report" property="total-pages"/>
In Tag View , the tags are collapsed into buttons. Click these buttons to change the value being used. In the report view, you see the following result:
Page {Current Page} of {Total pages}
Add a dynamic picture element
Once you've added a picture, you can set it to dynamically update for each page. To do this, double-click the picture to open the Format Picture pane. By default, the Simple Path option is set, meaning that the picture is from a single file location and does not update as the map series pages change. Choose the Dynamic option to update the picture element for each page.
Note:
Dynamic pictures are only available for spatial map series layouts and reports. Otherwise, this option is not available.
The Dynamic option allows you to reference pictures in the index layer included as attachments, raster fields, URLs, or file paths. If the value in the field is empty for a particular index feature, no picture is displayed.
To set a dynamic picture, choose the field containing the attachment or raster from the drop-down menu. If the full picture name is not in the field, or if pictures are available in multiple fields, you can set an Arcade expression to specify the correct picture. Click the Expression button to open the expression builder and write the Arcade expression.
The following is an example Arcade expression that creates a picture URL by concatenating two fields and using static text to provide the correct URL format:
Concatenate two fields and add static text to generate a URL.
"https://" + $feature.DomainName + TextFormatting.BackwardSlash + $feature.URLFileName + ".jpg"
Add a dynamic text element
Complete the following steps to add a dynamic text element to a report:
- Select the section in the report to which you will add dynamic text.
- On the Insert tab, in the Text group, click Dynamic Text .
- Choose a dynamic text element from the gallery.
Using the gallery is the most common way to add a dynamic text element, but you can also type a dynamic text element directly in the Format Text pane.
- In the report view, click to place the dynamic text element in the selected section of the report.
Optionally click and drag a box to place the dynamic text element.
Modify a dynamic text element
Once you've added a dynamic text element to a report, you can change the way the text looks or edit the tag syntax to update the output value. There are three ways to modify a dynamic text element in a report:
- Under the Text tab, on the Format tab, you can modify the text symbol, size, and position.
- In the Contents pane, expand the report section and double-click the dynamic text element to open the Format Text pane to view and edit the dynamic text tag.
Tip:
It is recommended that the text symbol gallery be viewed by category, as this allows report elements to be grouped by styling category instead of as one long listing.
- Double-click the dynamic text element in the report view and type new text or text tags for the element directly in the view. Click away from the selected element to commit the changes.
Dynamic text tags are displayed in the Element pane in either Tag View or Text View . The Tag View button represents the dynamic text element. Click it to edit the tag in the input box. Click the Text View button to show the plain text for the full dynamic text together with any static text.
Dynamic text element categories
The dynamic text tags are sorted into categories. Reports support the following categories of grouped tags:
- Report—Returns property values of the current report
- System—Returns the current date and time or user property values
- Page Number—Returns the page number and count property values
- Project—Returns property values of the project
Additional report-specific tags include the following:
- Summary statistics—Returns the requested statistical value for the report
- Field value—Returns the requested field value for that record
Note:
Field values are automatically added in the Details section and any Group Header sections. Summary statistics are included in all Group Footer and Report Footer sections. Additional statistics can be added directly from the ribbon after report creation.
Report tags
Tags with type="layout" can be used in both layouts and reports. The following table lists the available tags for report information:
Report
Description | Example syntax |
---|---|
Date Exported |
<dyn type="layout" name="ReportName" property="dateExported" format= "short|short"/> |
Metadata | When you select this option from the menu, a text element containing a set of metadata tags is inserted. See the Report metadata table below for details. |
Name | <dyn type="layout" name="ReportName" property="name"/> |
Report metadata
Description | Example syntax |
---|---|
Title | <dyn type="layout" property="metadata" attribute="title"/> |
Tags | <dyn type="layout" property="metadata" attribute="tags"/> |
Summary | <dyn type="layout" property="metadata" attribute="summary"/> |
Description | <dyn type="layout" property="metadata" attribute="description"/> |
Credits | <dyn type="layout" property="metadata" attribute="credits"/> |
Use Limit | <dyn type="layout" property="metadata" attribute="uselimit"/> |
System tags
The following table lists the available tags for system information:
System
Description | Example syntax |
---|---|
Current Time | <dyn type="time" format=""/> |
User | <dyn type="user"/> |
Note:
Select Current Time from the Dynamic Text gallery on the Insert tab to insert a piece of text with both the current date and current time tags. The result in the Format Text pane is Current Time: <dyn type="date" format=""/> <dyn type="time" format=""/>. Date and time dynamic text values can be formatted in many ways.
Page Number tags
The following tags are available for page number information:
Page Number
Description | Example syntax |
---|---|
Page Number | <dyn type="report" property="current-page"/> |
Page Count | <dyn type="report" property="total-pages"/> |
Page Number of Count | <dyn type="report" property="current-page"/> of <dyn type="report" property="total-pages"/> |
Project tags
The following tags are used to list information based off current project settings. Click the Project tab and click Options to review these settings:
Project
Description | Example syntax |
---|---|
Default Folder | <dyn type="project" property="defaultFolder"/> |
Default Geodatabase | <dyn type="project" property="defaultGeodatabase"/> |
Default Toolbox | <dyn type="project" property="defaultToolbox"/> |
Folder | <dyn type="project" property="folder"/> |
Name | <dyn type="project" property="name"/> |
Path | <dyn type="project" property="path"/> |
Date Saved | <dyn type="project" property="dateSaved" format="short|short"/> |
Summary statistics tags
The following tags are available for tabular statistic information:
Summary Statistics
Description | Example syntax |
---|---|
Count | <dyn type="report" property="field-count" field="FieldName"/> |
Mean | <dyn type="report" property="field-mean" field="FieldName"/> |
Median | <dyn type="report" property="field-median" field="FieldName"/> |
Maximum | <dyn type="report" property="field-max" field="FieldName"/> |
Minimum | <dyn type="report" property="field-min" field="FieldName"/> |
Standard Deviation | <dyn type="report" property="field-stddev" field="FieldName"/> |
Sum | <dyn type="report" property="field-sum" field="FieldName"/> |