form builder elements

Table of Contents

• What is the Image element?
• How do I add an Image element to my form?
• How do I give permission to use my iOS device's camera?
• How can I limit a user to not using images in their device library?
• How can I limit a user to only using images in their device library?
• How do I take photos? 
• Image Meta Data and Resolution

What is the Image element?

The Image element allows a user to add an image to a form by either taking a picture with the device's camera or selecting a photo from the user's device library.  

PLEASE NOTE: You'll need to make sure that the iForm app has been given permission to use the device's camera. 

How do I add the Image element to my form?

To add the Image element to your form, please follow the instructions below.

STEP 1. With your form loaded in the Form Builder, click the Image button from the left-hand menu.

STEP 2. On the right-hand side, you'll see the element properties. Enter the name of your element. 

PLEASE NOTE: If you check the Based on Label option, it will create a data column based on the Label on the element.

STEP 3. Save your form.

How do I give permission to use my iOS device's camera?

In order to take a picture with iForm, the app must have permission to use the device's camera. Click the following device type for detailed instructions:

• iOS
• Android

How can I limit a user to not using images in their device library?

With the use of the Reference ID 1 field, you can force the user to use the device's camera and block adding images from the device's library.  

To force the user to only take a photo, put PHOTO_LIBRARY_DISABLED in the Reference ID 1 field of the element.

How can I limit a user to only using images in their device library?

To only allow the user to use a photo from the device's library, put CAMERA_DISABLED in the Reference ID 1 field of the element. 

How do I take photos?

Now that you've gotten everything set up, you can take photos from within the app. The following steps will walk you through that process.

STEP 1. Open the form on your device.

STEP 2. Click on the Image element.

STEP 3. Choose whether to take a photo with the camera or choose an image from the device's library.

STEP 4. Take a photo.

STEP 5. To confirm, click Use Photo.

STEP 6. Your photo is saved to the element. 

iForm Tip: Create a multi-paging subform with a single image element instead of putting all image elements on the parent form. That way the user can take as many photos as they need to and record will be able to sync to the server faster and more efficiently.

Image Meta Data and Resolution

Image Meta Data

Images can retain meta data that will be embedded in the image. The meta data will retain information about the photo itself, such as location, time, device etc...  Information can vary between devices.  To see the meta data from an image, you can copy the image url and use this online EXIF tool, http://regex.info/exif.cgi.  

PLEASE NOTE: This only works with images that are taken through the app, meaning it won't work if you upload an already stored photo on the device.

Resolution

These are the resolutions and sizes for the different devices.  Keep in mind that the file sizes are general estimates, results may vary.  To adjust the size of the image, click on the links below based on the device type:

• iOS
• Android