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
| 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. |
| 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, 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" } |