Each field has several different properties that can be configured. These properties can change how the user is allowed to interact with the field on their device. Below are the different properties that are currently available:

Calculation - This property is used to set the list of operations that will be performed to compute to final value of a field. This property can only be set for a Calculation field. Click here for more information on this property.

Default Value - This property is used to set the initial value of the field when it is first displayed to the user on their device. If there is no default specified the field will default to blank, unless the field is of type Date, Time, Multiple Choice, or Drop Down. In these cases the field will default to the current date, current time, or the first value in the list respectively. However, for a Date or Time field you can set the default to be either the current date/time or blank. This property can be set for Date, Number, Shot Text, Long Text, Time, Drop Down, Multiple Choice, Barcode, and Web Link fields.

Note: You can also set a custom default value on Time fields. Select Custom Time from the Default Value drop down to do so. The custom default will use the Style set for the field. You must enter items into the Value List for Drop Down fields before specifying the default value.

Display - This property is used to set how you want the coordinates of your location presented on the returned submission. This property can only be set for a GPS field.

Draw on Image - This property is used to allow the device user to draw on the image added to the field. This property can only be set for a Photo field. 

Field Mask - This property is used to require the device user to input text data in a specific format. There are eight different types of character masks. Each character requires the user to treat that position in their response a little differently. This property can only be set for a Short Text field. Click here to get a list of the different characters that can be part of a valid Field Mask and their meanings.

Label - The property is the text that is displayed to the user of the device, giving them information on what to input into the control of the field. This property can be set for all field types.

Map Zoom - This property is used to set the zoom of the map you see on the returned submission. This property can only be set for a GPS field.

Maximum - This property is used to specify the maximum value that can be entered as a response to a field. The response entered by the user must be less than or equal to the value entered in the Maximum property. If the Maximum property of a field has no value there is no upper limit for the field. Also, the value must be greater than or equal to the Minimum property of the field. This property can be set for Number fields.

Minimum - This property is used to specify the minimum value that can be entered as a response to a field. The response entered by the user must be greater than or equal to the value entered in the Minimum property. If the Minimum property of a field has no value there is no lower limit for the field. Also, the value must be less than or equal to the Maximum property of the field. This property can be set for Number fields.

Payment Total Field - This property is used to select the field that is the source of the payment amount. This property can only be set for a Payment Field.

Payment Total Screen - This property is used to select the screen on which the payment source field appears. This property can only be set for a Payment Field.

Read Only - This property is used to specify whether a field can be responded to or not. If a field is set to be Read Only the user will not be able to respond. In the case of a Barcode field, it will require a user to use their camera or an attached device to use the field. This property can be set for Short Text, Long Text, Number, Date, Time, and Barcode fields.

Required - This property is used to specify whether the user is required to enter a value in the field on their device before advancing to the next screen. If a field is set to be required, any non-blank field will meet the need. This property can be set for Short Text, Long Text, Number, Drop Down, Multiple Choice, Date, Time, Photo, Signature, Barcode, GPS, and Drawing fields.

Style - This property is used to set a format for a field. You can set different formats for different types of fields. This property can be set for Short Text, Number, Calculation, Drop Down, Multiple Choice, Date, Time, Summary, and Web Link fields. Here are the styles that can be set for the field types:

• Short Text: Email, Number
• Number: Number, Currency
• Calculation: Number, HH:MM, HH:MM:SS, MM:SS, Currency
• Drop Down: Not Editable, Editable
• Multiple Choice: Radio buttons, Checkboxes
• Date: MM/DD/YYYY, DD/MM/YYYY, YYYY/MM/DD
• Time: 24 hour, AM/PM, HH:MM:SS, MM:SS
• Summary: Number, HH:MM, HH:MM:SS, MM:SS, Currency
• Web Link: Button, Link

Summary Entry - This property is used to select the source field for the summation. This property can only be set for a Summary field.

Summary Screen - This property is used to select the screen on which the source field appears. This property can only be set for a Summary field.

Value List - This property is used to set the list of values (separated by a carriage return) that will appear as possible responses to the field. If you want to allow the user to leave the response blank you need to have a blank line in your Value List. In addition, GoCanvas also provides a ‘Populate with…’ option that will allow you to choose a common list of items. This property can only be set for a Drop Down or Multiple Choice field.

More Field Settings

In addition to the standard properties on a field, there are also several advanced properties. These advanced properties can be used to enhance the fields and the responses to the fields even further. You can find these by expanding the More Field Settings tab when editing a field. Below are the different advanced properties that are currently available:

Accuracy(m) - This property is used to specify how accurate the GPS location must be in meters for the acquired coordinates. This is useful because when acquiring a location from GPS satellites, the first points reported by the hardware can often be inaccurate. By specifying a desired accuracy, GoCanvas will reject any reported location coordinates until the desired accuracy is met or until the timeout expires. This property can only be set for a GPS Field.

Email Body - This property is used to designate the field label(s) and response(s) that will be added to the body of auto-generated emails that the device user can send when returning a submission. This property can be set for Short Text, Long Text, Static Text, Number, Calculation, Drop Down, Multiple Choice, Date, Time, Summary, and Barcode fields.

Email File Name - This property is used to designate the field response(s), if any, that will be set as the title of a PDF. This applies to both the PDFs sent in auto-generated emails (that the device user can send when returning a submission), and the PDFs saved from the ‘Submissions’ page. When this property is set, the file name will be the designated field response(s) followed by the name of the app. If this property is not set then the file name will just be the name of the app. This property can be set for Short Text, Static Text, Number, Calculation, Drop Down, Multiple Choice, Date, Time, Summary, and Barcode fields.

Email Subject - This property is used to designate the field response(s), if any, that will be set as the subject of auto-generated emails that the device user can send when returning a submission. When this property is set, the subject of the email will be the designated field response(s) followed by the name of the app. If the property isn’t set then the subject will just be the name of the app. This property can be set for Short Text, Static Text, Number, Calculation, Drop Down, Multiple Choice, Date, Time, Summary and Barcode fields.

Decimal - In a number field, users have the option to set the number of decimal places available in the field. If the style is set to currency, the decimal will automatically be set to 2 decimal places. If the style is set to number, however, you can choose how many decimal places will be allowed by opening the More tab in the palette and changing the decimal places field. Your options are no limit, or from 0-6.

Export Label - This property is used to allow a different label in the exported data than is displayed on the user's device so that the customer interfaces to GoCanvas do not have to be rewritten with every new app version. If no Export Label is specified for a field, the Label will be used when exporting data. This property can be set for all field types.

Force Accuracy - This property is used to specify that if the accuracy is not met and the timeout has been exceeded, that no location will be captured. This property can only be set for a GPS field.

Image Size - This property is used to set the size of the image on the returned submission. This property can only be set for a Photo field.

Image Source - This property is used to specify whether you want your user to upload an image from their camera only, from their gallery only, or from any source. The default setting is Any. This property can only be set for a Photo field.

Max Character Length - This property is used to specify the maximum number of characters that can be entered as a response to a field. This property can only be set for a Short Text field. 

Mobile Style - This property is used to set the size of the multi-line textbox on a mobile device. This property can only be set for a Long Text field.

Mobile Visible - This property is used to set whether a field is visible or not visible on the user’s device. If a field is set to be not visible, the device user will not see it but it will show up on the submission. This property can be set for Short Text, Long Text, Static Text, Number, Calculation, Drop Down, Multiple Choice, Date, Time, Summary, Barcode, and Web Link fields.

Page Break After - This property is used to start a new page after a field on a submission saved as a PDF. This property can be set for all field types.

Show This Field on PDF - This property is used to set when a field can be seen on the PDF of a returned submission. This property can be set for all field types. Learn more about field visibility. 

Receipt Label - This property is used to allow a different label to be printed on the receipt than is displayed in the app. In some instances, you may want the copy of the submission printed from the device to print a much less detailed label of a field than what is displayed to the device user. This is mainly due to the lack of space on the standard receipt style paper. This property can be set for all field types.

Reference Col - This property is used to specify which column in the specified Reference Data list will be used to populate the field. This property can be set for Short Text, Long Text, Static Text, Number, Drop Down, Barcode, and Web Link fields.

Reference Data - This property is used to specify which Reference Data list will be used to populate the field. This property can be set for Short Text, Long Text, Static Text, Number, Drop Down, Barcode, and Web Link fields. Learn more about reference data.

Reference Field - This property is used to specify which (if any) other field the current field is dependent on. If a Reference Field is selected, the value of the current field will be updated any time the value of the Reference Field is changed. This property can be set for Short Text, Long Text, Static Text, Number, Drop Down, Barcode, and Web Link fields.

Reference Image - This property is used to set a background image for a drawing. In an app when you open a drawing field the reference image will be there for you to draw on top of. This property can be set for a Drawing field.

Reference Screen - This property is used to specify which screen the Reference Field is on. This property can be set for Short Text, Long Text, Static Text, Number, Drop Down, Barcode, and Web Link fields.

Report Label - This property is used to allow a different label to be displayed in the submission than in the app. In some instances, you may want the printed copy of the submission to display a more or less detailed label of a particular field than what is displayed to the device user. This property can be set for all field types.

Show This Field on Web - This property is used to set when a field can be seen on a returned submission. This property applies to submissions you see in the "Submissions" area if you just click on an individual submission to view it on the web. This property does NOT apply to the PDF of a submission. Field visibility on a PDF is set by the PDF Visible property. This property can be set for all field types. Learn more about field visibility.

Show This Field on PDF - This property is used to set when a field can be seen on the PDF of a returned submission. This property can be set for all field types. Learn more about field visibility.

Signature Size - This property is used to set the size of the signature on the returned submission. This property can only be set for a Signature field. 

Submission Name - This property is used to designate the field response(s), if any, that will be set as the title of the submission. This property can be set for Short Text, Static Text, Number, Calculation, Drop Down, Multiple Choice, Date, Time, Summary, and Barcode fields.

System Default - This property is used to auto-populate a field with the device user’s Username (email), Company Name, First Name, Last Name, or Full Name. This property can only be set for a Short Text field. 

Tile Photo - This property is used to tile your images on the GoCanvas generated PDF with 3 thumbnailed images across the page. This comes in handy when you have a screen with multiple images that you would like to show left to right. The tiled images will always show as the smallest size. This property can only be set for an Image Capture field.

Timeout(ms) - This property is used to set the maximum amount of time, in milliseconds, to wait for location coordinates of the desired accuracy. If the time limit has expired, and accuracy has not been met, the location will be reported. This property can only be set for a GPS field.

Unsecured Access - This property is used to allow you to access an image by the image URL exported in the CSV or XML without being logged into GoCanvas. This property can only be set for an Image Capture field.