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
Warning
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 device's camera. |
Allow Annotation | If set, the captured photo can be annotated. Now available across all the apps. |
Photo Quality | The quality of the photo sent in the form submission. |
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. The width of the image will be scaled to keep the aspect ratio. |
Maximum Width | The maximum allowed width of the image. The height of the image will be scaled to keep the 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. |
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 |
|