English

How To: Customize the size of images in a printed Survey123 for ArcGIS report

Summary

In some instances, when users are printing a survey result, the pre-defined settings for image sizes may not meet user requirements. Users can customize the size of the image in the reports by using a custom form report template in Survey123 for ArcGIS version 2.3. For more information, refer to GeoNet: Moon Landing Release (2.3).

Custom form report templates are authored in Microsoft Word and includes placeholders with specific syntax that the Survey123 for ArcGIS reporting engine understands. The templates are uploaded and associated to a survey with expressions to define the appearance of the report. When the report is printed with the template, Survey123 for ArcGIS replaces the placeholders with the actual data according to the defined expression of the template.

Procedure

The steps provided describe how to customize the size of an image in a survey report with custom form report templates:

Note:
Custom form report templates are currently in beta and only applies to surveys owned by users.
  1. Log in to survey123.arcgis.com.
  2. Click My Surveys.
  3. Filter for Surveys I own. Click the Data button of the survey to be printed.

    Screenshot of the survey with Data highlighted.
     
  4. In the Data tab of the survey, click Report (Beta) > Manage templates....

    Screenshot of survey with Report (Beta) and Manage templates... highlighted.
     
  5. In the Report (Beta) dialog window, click Upload New Template.

    Screenshot of Report (Beta) with Upload New Template highlighted.
     
  6. In the Report Template (Beta) dialog window, select Click here to download the default template for this survey.

    Screenshot of Report Template (Beta) with Click here to download the default template for this survey highlighted.
     
  7. Download the template and open it in Microsoft Word.
  8. Modify the field name code for the image question. Save the word document.
    Note:
    The size of the image can be modified by changing the expression of the field name code. These expressions can be found by clicking Show more options for the image question in the Report Template (Beta) dialog window. For example, the default expression of an image has a width of 460px. If users want to define the size of the image while preserving the aspect ratio, the ${%fieldname|size:200:300} can be used, which sets the image size to 200px * 300px.
     
    Each field name code of a question is unique to the survey and not universal to other surveys.
  9. Return to the Report Template (Beta) dialog window, and click Choose File.

    Screenshot of Report Template (Beta) with Choose File highlighted.
     
  10. Select the saved word document. Click Open.
  11. In the Report Template (Beta) dialog window, name the template and click Save.

    Screenshot of Report Template (Beta) with Save highlighted.
     
  12. After saving the template, close the Report (Beta) dialog window.
  13. Click on the row to be printed and hide the record detail.

    Screenshot of the row detail with the hide button highlighted.
     
  14. Click Report (Beta) and click Generate.

    Screenshot of Report Beta with Generate highlighted.
     
  15. Download the report and open it in Microsoft Word, which shows the image in the size according to the expression of the image field name code.

Related Information