Single Photo Field

The Single Photo field allows users to capture a single photo from their device's photo library or camera and embed it into the form. This could be used to show visual evidence of a repair that's been made or to communicate details of a component that needs fixing.

 

The Single Photo field also supports drawing overlays for annotation purposes, customizable image names for easier identification and context, as well as configuring quality and size settings so files are compressed prior to submission. All of these options can be configured in the Single Photo Settings menu on the right side of your screen.

Configuration

Important

We recommend avoiding submissions with over 500 photos, as this is the limit officially supported by our team. Clients can choose to exceed this limit, but doing so carries risks, such as potential challenges with internet stability, especially in areas with poor connections. Additionally, large submissions may lead to failed workflows, reports, and downloads. While there's no strict cap on photo numbers, going beyond the supported limit raises the chances of encountering these issues. For a smoother uploading experience, it's best to keep the app open until all images are uploaded and minimize the number of photos for better processing.

Setting	Description
Field Label	The label displayed for the field. This is usually displayed at the top left corner above the field.
Field Key	A Key used to reference the field in submission data. The key is also used to reference the field in rules and calculations.
Hint Text	The text that is displayed if the field has no value set, e.g. "Please enter a value"
Photo Library Enabled	If set a user will be able to select an image from the Photo Library of the mobile device.
Camera Enabled	If set a user will be able to take a picture using the mobile devices camera.
Allow Annotation	If set the captured photo will be able annotated. Now available across all the apps!
Photo Quality	The quality of the photo sent in the form submission. Available Options (Jpg Normal, Jpg Medium, Jpg High, PNG)
Image Name	Customize image names for easier identification and context. You can even use field keys with $ (ex. $RepairType$) for image names. Useful for media downloads and workflow delivery, ensuring meaningful image names, not just GUIDs.
Maximum Height	The maximum allowed height of the image, width of the image will be scaled to keep aspect ratio.
Maximum Width	The maximum allowed width of the image, height of the image will be scaled to keep aspect ratio.
Rules	A Rule or JavaScript snippet that allows you to perform actions on fields or sections within the form. The actions can include hide, show, enable, disable, showSection and hideSection. Rules are executed on field value changes and when the form is opened. ex. if ($field1$ > 23) { hide(); } else { show(); } (Please see the Introduction to Rules Document for more information)
Required	Sets the field to have required input. You will not be able to submit the form until this field has valid input.
Enabled	If not set the field will be visible but cannot be edited or set to accept new input.
Hide Field Label	Hides the Field Label.
Hidden	If enabled the field and all labels are not visible.
Exclude From Reports	If checked, the field will be excluded from HTML and PDF reports and will also be excluded from Excel and CSV exports.
Capture Geo Location	Capture the current latitude and longitude when the acknowledgment button is clicked.
Capture Time Stamp	Capture the current date and time when the acknowledgment button is clicked.
Alert Type	Choose a theme to change the background and font colors of the field cell as displayed in the apps.
Exclude On Sync	If enabled the value of the field will not be submitted in the form submission.

Result Data

Data Type	Domain of Values	Example JSON
String	File Name of asset on Amazon S3	{ "photo_1": "73e0d68e-a648-43e9-9299-518cb81e8359.jpg" }