Understand image field

Understand image field

When accessed via your iOS devices' browsers, you can upload images and attach image URLs but you cannot capture them via the image field. This is because media objects are not supported by iOS.

The image field enables your users to submit an image through your form. They can either take a photo or upload one. The following is how an image field looks on a form:

  • When a user accesses from a web browser:

  • When a user accesses from a phone or tablet:

Size limits

  • When a user accesses from a web browser and uploads an image from the device's local storage, the image field can accept an image up to 10 MB
  • When a user accesses from an iPhone or iPad device and uploads an image from the device's local storage, the image field can accept an image up to 5 MB
  • When a user accesses from an Android device and uploads an image from the device's local storage, the image field can accept an image up to 5 MB

The images that your users submit through your form are stored in your account and are counted towards your account’s total storage limit. Visit your account's usage details page to view its current storage details.

Uploaded image's name

When your users upload an image to this field, the image's name is set in the following format:

<unique_number>_<uploaded_image_name>
  • The image's name is prepended by an underscore (_) and a system-generated number that uniquely identifies that image in your account
  • The image's name will automatically be trimmed when it exceeds 150 characters
  • Whitespaces and other special characters, excepting hyphens (-), will be replaced by an underscore (_).

On accessing from a web browser

The following is an example of how an image field looks when a user accesses from a web browser.

Subject to the browse options you enable for your field, your users can upload an image:

To upload an image from local storage

  1. Click the Upload icon in the image field. This will launch the device's file explorer.
  2. Select the required image.
  3. Alternatively, you can drag and drop the required image onto the field.

To upload an image in cloud storage, by entering its link

  1. Click the URL icon in the image field.
  2. Enter the required image's URL.
  3. If the image options have been enabled for the image field, enter a Link Name and Title for the image URL you entered.

Take a photo using the device's camera

  1. Click the Camera icon in the image field.
  2. If it is the first time your user is accessing the image or video field, they will be prompted to grant permission to use the device's camera:
    • They can either Allow or Block
    • If they select Block, they will be prompted with the message Allow access to media. They won't be able to take a photo till they Allow access to the camera.
  3. Click Allow. This will launch the image recorder in a pop-up window.
  4. Click the Camera icon at the bottom of the pop-up, to take a photo.
  5. Click Done to use the photo, or click Retake to retake the photo and then click Done.
  6. The photo you took will appear in the image field.

On accessing from a phone or tablet

When your users access your form from a phone or tablet and tap on the image field, they can add an image in two ways:

  • Take a photo
  • Choose a photo from their device's photo gallery. This option becomes available when you Enable photo gallery field property.

Additionally, users of iOS13 and later can scan multiple images and upload them as a PDF to the file upload field.

Take a photo

  1. Tap on the image field. This will launch the device's primary or secondary camera, depending on what value the Default Camera field property is set with.
  2. If the Enable photo gallery field property is enabled, tap Take Photo. This will launch the device's camera.
  3. If the Allow to Switch Camera field property is enabled, you will be able to switch between the device's cameras.
  4. Take a photo by tapping the Shutter button. You will get to preview the image you took.
  5. Tap Use Photo at the bottom-right corner of the screen, or tap Retake at the bottom-left corner to retake the image.
  6. If the Annotation (for mobile) field property is enabled, you will get to add annotations to the image.
  7. Click Done at the top-right corner of the screen. The photo you took will appear in the image field.

Choose a photo from device's photo gallery

  1. Tap on the image field, then tap Choose Photo. This will launch the device's photo gallery.
  2. Select the required image.
  3. If the Annotation (for mobile) field property is enabled, you will get to add annotations to the image.
  4. Tap Done at the top-right corner of the screen. The photo you selected will appear in the image field.

Field properties

You can also perform the following customizations for the user experience of the image field on your form:

Downloading images

URL to download an image

Note: This URL works for images that are either uploaded from local storage or captured using the device's camera.

An image stored in the image field can be downloaded using the following URL:

https://<domain>/<account_owner_name>/<appLinkName>/<reportLinkName>/<fieldLinkName>/download/imageName

where,

  • domain will be DC specific—for example, you'll need to use creatorexport.zoho.com if your account is in Zoho's US data center, and creatorexport.zoho.eu if in the EU data center.
  • account_owner_name contains the user name of the Creator application's account owner and the link name of the application.
  • reportLinkName is the link name of the report where the corresponding image field is displayed. (To know the report link name, click on Report Settings ->Summary from the edit mode of the report to get the reportLinkName).
  • fieldLinkName is the link name of the corresponding image field. Click here to learn more about the script name for a field.
  • imageName is the corresponding image's name. Learn more

For example, imagine that you've built an application named Zylker Automobile Service. In this application, you have created a form named Emergency service request, where users can capture the picture of their damaged vehicle, add a description for the image and submit the form. When you access the Emergency service request report, you may want to download the images. To do this, you can configure a custom action in your report, such that when you click the button Download image, the image gets downloaded. This custom action has the above URL format constructed as follows:

tempFilename = input.<fieldLinkName>.getsuffix("image/");
tempFileName = tempFileName.getprefix("\" lowqual");
openURL = ("https://creatorexport.zoho.com" + zoho.appuri + "<reportLinkName>/<fieldLinkName>/download/" + tempFileName, “window type”); 

where,

  • tempFileName is a variable that stores the filename of each image stored in the image field
  • getsuffix() returns all the characters which follow the first occurrence of searchString in the string. Learn more
  • getprefix() returns all the characters which precede the first occurrence of searchString in the string. Learn more
  • zoho.appuri returns the application details in the format:
     /<account_user_name>/<application_link_name>
  • The openUrl Deluge task is used to redirect the user to the specified URL. This URL can be opened in the same window, new window, parent window, popup window, or iframe

Now, when you access the Emergency service request report, you can see the View image button:

In the above image, Megan is the <account_user_name> and zylker-automobile-service is the <application_link_name>​​

Tip: This URL format can be used to download files from the file upload, image, audio, video and signature fields.
​​

Download images in bulk using the file download tool

Note:
  • The file download tool supports downloading of files from file upload, image, and signature fields as of now. You cannot download the files if these fields are in a subform inside the parent form.
  • This tool is currently only supported for Windows.
  • Ensure that you have ten or fewer authtokens in your accounts.zoho.com to avoid any username or password-related errors

Zoho Creator provides a tool that enables you to download all the images stored in an image field, at once. To use this tool:

  1. Download the tool and run it. Ensure to download the right tool:
    As announced recently, this tool will be completely phased out by November 30, 2020. Please reach out to us at support@zohocreator.com for file download related queries.
  2. Enter your Zoho Creator account credentials and click on Sign in

  3. ​Alternatively, you can use a pre-generated application-specific password and the email address used to log in to your Zoho account to sign in to the filedownloader.exe tool.
  4. Select the required Application Name. This is the application containing the uploaded files.
  5. Select the required View Name. This is the report in the specified application containing the files.
  6. Enter the Field Deluge Name. This is the field link name of the required file upload field. Click on the "?" icon to view field deluge names in your applications.
  7. Specify the Local Folder Path. This is the folder where your files will be saved.
  8. Click Download.

Once all the images have been downloaded, a success message will pop up. The downloaded images will be stored in the folder specified in the tool.

Share this post : FacebookTwitter

Still can't find what you're looking for?

Write to us: support@zohocreator.com