Skip to main content
Skip table of contents

Photo

Photo components are used to capture one or more photos from the user’s mobile camera or device gallery.

Configuration

To configure the component, drag it from the Component List to the Mobile Canvas to add it to your page. Next, open the Configuration Panel by either double-clicking the component or selecting it and clicking the “Edit” button that appears upon selection. The section below explains the configuration settings associated with the component.

Appearance

  • Type: This setting dictates the type of input required by the mobile user when interacting with the component. Select from the following options:

    • Photo Box: If selected, the mobile user will be asked to take a photo after tapping the component. After the photo is taken/selected, the photo will appear within the photo box frame as a preview.

    • Photo with Comments: If selected, the mobile user will be asked to take a photo after tapping the component and will be given the option to include comments with the photo.

    • Photo Checklist Item: If selected, the mobile user will be asked to take a photo after tapping the checklist item. After the photo is taken/selected, the checklist item will be marked as complete. The functionality is the same as the Photo Box but takes up less vertical space on the user’s mobile screen.

Use a Photo Box when you only need to capture 1-2 photos and as it takes up more vertical space. Use a Photo Checklist Item when you need to capture many photos as it takes up less vertical space.

  • Allow Users to Capture Multiple Photos: If selected, the mobile user will be able to add as many photos as he or she likes. The photos are stored in a separate “Subpage” which can be accessed and updated by tapping the component. The type of photo component in the subpage adheres to the type selected above.

  • Min / Max: If “Allow Users to Capture Multiple Photos” is enabled, an additional setting appears allowing you to set a minimum and a maximum number of photos that can be added to the component.

Note that no more than 50 photos can be added to the component. This limit is in place to reduce the chance of the user’s mobile device running out of memory and crashing.

  • Show Label: Enable this toggle to show a label above the component. Disabling the toggle will remove the label. In the example above, the labels for all three components are enabled and written according to the Type (“Photo Box”, “Photo with Comments” and “Photo Checklist Item”). To edit a label, simply double-click the label from the Mobile Canvas to bring up the in-line text editor.

  • Enable Watermark: If enabled (by default), a watermark is placed on the photo and visible to backoffice users reviewing the task results. Typically used for audit purposes, the watermark contains the following information by default:

    • Latitude and longitude of the location where the photo was captured

    • Mobile user’s name and user ID

    • Date and time the photo was captured

  • Allow user to choose from gallery: Determines whether or not the mobile user can select a photo from their device’s photo gallery as an input.

    • Enabled: If enabled, the mobile user will be permitted to use their device’s photo gallery to select the photo.

    • Disabled: If disabled (by default), the mobile user will NOT be permitted to use their device’s photo gallery to select the photo. Instead, the user will be required to take a photo using their device’s camera.

The “Allow user to choose from gallery” setting is typically disabled when you want to ensure that the technician takes the photo onsite.

Business Rules

  • Make Input Mandatory(*): Enable this toggle if you wish to make it mandatory for mobile users to fill in this field before navigating to the next page of the task.

  • Visibility Rules: Enable this toggle to set up Visibility Rules which allow you to show or hide a component based on inputs captured from a component elsewhere in the task.


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.