Skip to main content
Mitratech Success Center

Client Support Center

Need help? Click a product group below to select your application and get access to knowledge articles, webinars, training content, and release notes or to contact our support team.

Authorized users - log in to create a ticket, view tickets status and check your success plan details.

 

All Designer Form Fields

Workflow forms are created through the Properties page using a set of 30 fully customizable form fields. Form fields can be easily added to and repositioned in the Properties page. Form fields can further be customized by selectively applying preferences specific to each form field and form fields can be imported from PDF.

Workflow forms are created through the Properties page using a set of 30 fully customizable form fields. Form fields can be easily added to and repositioned in the Properties page. Form fields can further be customized by selectively applying preferences specific to each form field.

Accessing the Properties Page

To access the Forms - Properties Page:

  • Click the Business Automation TAP - designer forms (image 1).jpg button  in the TAP Toolbar to access the Business Automation module.
  • Click the Create button.

The Properties Page

The Properties Page contains the following functional areas:

Properties Page.png
 

  • Workflow Title - This lets you assign a name to the workflow form
  • Tool Bar - Provides the tools for specifying form options and form field properties
  • Form Fields Menu - Drag a field to the Editor Window to add the field to the workflow form
  • Editor Window - Provides the work area for creating a workflow form
  • Menu Tabs - Toggles between the Form editorRecord Form, Thank you page, Import form from PDF, and Languages.

                                                                                                        Menu.png

Creating a Form

Workflow forms are created by arranging a selection of form fields to reflect the data, approvals and signatures required by a given business process. A workflow form can be created as a single, continuous form, or it can be divided into two or more logical sections. Form fields can be added to the form manually by dragging and dropping from the Form Fields Menu, or the form can be populated using form field data contained in a tagged PDF file. Additionally, form fields have a unique set of properties that let you configure the appearance and/or functionality of the field.

To create a workflow form:

Save Button.png

Click the Save button while working to save your progress and continue editing.

  1. Access the Properties Page.
  2. Enter a name for the form in the Title Bar.
  3. Set the desired form options for font face, size and style for labels and fields in the form.
  4. For multi-section forms, define the appropriate sections.
  5. Add the appropriate form fields to the form.
    • To add a field to the form from the Form Fields Menu, click and drag the desired field from menu to the Editor Window.
    • To populate the form from a tagged PDF file, click and drag the PDF file from your workstation to the Editor Window.
    • To copy and paste one or more form fields:
      • To copy a single field, click the form field you wish to copy; the selected field is highlighted.
      • To copy multiple fields, press and hold the Ctrl key, then click each field you wish to copy; the selected fields are highlighted. When all desired fields have been selected, release the Ctrl key.
      • Press Ctrl+C to copy the selected form fields; The message "Selected form items were copied" displays.
      • Press Ctrl+V to paste the copied form fields; the copied fields are added to the bottom of the form.
    • To switch between sections (for multi-section forms) click the name of the desired section at the top of the Editor Window.
  6. Edit the form field labels.
    • Double-click a form field label, select the existing text, and enter a new label as appropriate.
  7. Apply properties to form fields as appropriate.
  8. To reposition a form field, click and drag the field to the desired location.
  9. When the form is completed, click the  Save button to save the workflow form.
  10. To create a workflow for the form, click the Workflow link in the Title Bar.
  11. To return to the Designer Homepage, click the Business Automation and then Designer.

Form Field Controls

The tab in the upper right corner of each form field provides three buttons that support the following functions:

Main Heading.png

clipboard_eb025b541606945c4d66ca9fea5c0c47a.png Change Section – Displays the Change Section dialog that lets you move the field to another section of the form.

clipboard_e42020eccfbae14cc408b1d3da12f707b.png Delete – Removes the field from the form.

Understanding Form Fields

The Form Fields menu on the properties page includes 20 Form Fields, four pre-configured form field Blocks and six E-Signature fields that can be selectively inserted into any form. Unless otherwise specified, all fields are repeatable. The purpose and function of each field is described below.

Form Fields

clipboard_e6648c47caf41a1b6c683e70265d7da0f.pngHeading

Use the Heading field to insert a heading in the form. The Heading field is generally used to divide the form into sections and subsections. You can optionally include a sub heading.

Heading.png
 

clipboard_e863aeb49bd29c132b642662f4d5b87b7.pngCustom Text

Use the Custom text field to insert a “read only” text field in the form. The Custom text field is generally used to enter descriptive or instructional text to aid the user in competing the form.

Custom Text.png
 

clipboard_ed5e019dd147662d5bef8cb3c9e4a9636.pngCustom html

Use the Custom html field to insert am HTML-formatted “read only” text field in the form. The Custom html field is generally used to enter descriptive or instructional text to aid the user in competing the form.

Customhtml .png

The Custom html HTML editor uses the Open Source CKEditor HTML editor to create the expiration notification content. Click here to find information on using the features and functions available through the CKEditor.

clipboard_eaa4a396bf8ee0c57c95516e2e2bc30a9.pngText

Use the Text field to insert a single-line text field in the form. The Text field is generally used to support entry of a single, specific value (such as a name, address or phone number).

Text.png
 

clipboard_eddec503f450b8001859d5d357a955f95.pngArea

Use the Area field to insert a text box in the form. The Area field is generally used to support entry of free text.

Area.png
 

clipboard_e049caa3717a6b3c327ae5b4fc01b1579.pngDrop Down

Use the Drop Down field to insert a drop-down menu in the form. The Drop Down field is used to support selection of a single option from a pre-defined list of values.

Dropdown.png
 

clipboard_eb9902ac0938172cdd87fd0842395ca2f.pngMulti select

Use the Multi select field to insert a drop-down menu in the form. The Multi select field is used to support selection of one or more options from a pre-defined list of values.

Multi select.png
 

clipboard_e64ebf1f603ece493ae74cb2f10f66e4e.pngRadio Button

Use the Radio Button field to insert two or more radio buttons in the form. The Radio Button field is used to support selection of a single option from a pre-defined set of values.

 

All radio buttons included in any given Radio Button field are mutually exclusive (only one radio button may be selected by the user).


Radio Button.png

 

clipboard_e42b5ca3b0cdf6e1b4b936d6ef1b3a9f9.pngCheck Box

Use the Check Box field to insert one or more check boxes in the form. The Check Box field is used to support selection of one or more options from a pre-defined set of values.

Checkbox.png

 

clipboard_ecfae6379f0215efef896af7f3ab5e920.pngBoolean Check Box

Use the Boolean Check Box field to insert a single check box. 

Boolean Checkbox.png
 

clipboard_eec64ddf0205d646896f3e129dc524806.png File Upload

Use the File Upload field to insert a file upload dialog in the form. The File Upload field is used to support upload of a single file. For more information see File Upload and Multi Upload File Fields

 

clipboard_e84fa65bfa44ec1274b73889b04a52164.pngMulti Upload

The Multi upload field is used to support upload of a multiple files. For more information see File Upload and Multi Upload File Fields

Types of Attachments

See acceptable attachment types here

clipboard_e87d74a9c5496d182f2ec34caa2f2d46b.pngDatepicker

Use the Datepicker field to insert a date field in the form. The Datepicker field includes a calendar function to support selection of the desired date, and can be pre-filled with the current calendar date if desired.

Datepicker.png

To set the newly created field to the current date, select the checkbox Default Date under the Datepicker Settings. The field is automatically set to today's date

Datepicker Settings .png

Click on Options to be able to configure- Range of Dates and Date format

    Datepicker Options.png

Date Format can be configured by clicking on the clipboard_e07356c9f59aa7dffd23993b3b1c6f27c.png icon. Date can be formatted in 4 ways and the default option(if nothing is  configured) is MM/dd/yyyy.

Date Picker Options.png

 

Range of dates configuration allows user to select dates only from the specified range. It can be accomplished in two ways ,Range of Date and Range of Days.   Range of dates allows user to select dates only between the two dates entered(inclusive of entered dates)

Datepicker.pngCalendar.png

 

Range of Days allows user to select dates for the range of number of days(with respect to the current date) entered. It's necessary to enter either 

 

clipboard_ea261784c70590adac0f9668d2bf0621a.pngAddress

Use the Address field to insert an "auto-complete" type address field. The Address field type uses Google’s address API to auto-complete addresses in any country throughout the world. As an address is entered, the system displays a list of addresses that match the character string. The desired address can be selected from the list at any time.

The Address field is not applicable to Record Forms.


Address.png
 

clipboard_e7c334ddf051effe1afe24b418f128957.png Workflow Records

Use the Workflow records field to insert a drop-down menu containing values taken from a selected field in one or more specified previous workflows.

The Workflow records field is not applicable to Record Forms.


workflow records.png

The Workflow Records field can be used to populate information from one workflow into another. When configuring a pre-population rule on a given stage, users can select a Workflow Records field and create mapping rules. Only fields that have been added to the repository will be available when configuring mapping using the Workflow Records field. Additionally, fields will be displayed using their eSign tag when selecting a parent field for a mapping rule.

Records can also be linked using the Workflow Records field. After selecting the 'Filter's option on the field options tab, check 'Link Records'. When checked, the workflow record that is identified in this field when running a new record will be linked to the record you are creating. If you check 'Link child docs to parent record', documents from the child/linked workflow will be attached to the record identified in the Workflow Records field.

A corresponding dashboard action labeled 'Show Linked Workflows' will automatically filter the dashboard for any records which have been linked to the selected record, either through parent/child relationship or through a Workflow Records field. 


clipboard_e64a147d45919ceb9fcdd479c6d5ac37a.png Table

Use the Table field to insert a table in the form. The Table field lets you include tabular data in the form.

department routing.png

Information can be added into and taken out of a table field using form mapping. Tables can also be prepopulated through the use of workflow records prepopulation.
 

clipboard_e7405624dafcabdaf3fbe22b557010c60.pngSpreadsheet

Use the Spreadsheet field to insert a spreadsheet in the form. The spreadsheet field functions similarly to a Microsoft Excel spreadsheet, supporting Excel-like formulas, custom formatting, the ability to add/remove rows and columns, data validation, custom drop-downs, etc.

Spreadsheet fields are not applicable to Record Forms.

spreadsheet.png

clipboard_e960fd73aa15b1122febeaa42ade885fb.pngDocument Field

This form field is functionally similar to the document builder but can be added to a form and edited throughout the course of a workflow. The document form field can be used to generate documents that can be attached to notifications, added to a record’s audit log, and used in the eSignature process. By editing a document while the workflow is in progress redlining can take place before a document is generated for signature.

Go Here to read more about the features of the document form field 

Document.png

clipboard_e1ff24d9f2b94c3572782cabd77c70d3e.pngSalesforce Records

Use the Salesforce records field to insert a drop-down menu of Salesforce Record Options in the form. The Salesforce records field is used to support selection of a single option from a pre-defined list of values.

Salesforce record.png
 

clipboard_e8097bcc8aff0336be87bf40133722903.pngSubmit Button

Use the Submit Button field to insert a Submit button in the form. The Submit Button field supports submission of the completed form (or section) and initiates the next stage of the workflow. SaveReset and/or Print buttons can be optionally included in the Submit Button field if desired.

Every form must include a Submit button. A Submit Button field is added to the form the first time you add any field to a blank form.

 

The Submit Button field is not applicable to Record Forms.

Buttons.png

The Generate Draft URL checkbox will generate a notification for the user once the workflow is saved. You can customize this notification by clicking the Draft Notifications icon that appears in the Additional Settings section once that box has been checked.
 

clipboard_eb5bbb8bfa394b81ea1f7b54edee07984.pngCaptcha

 

Use the Captcha field to insert a CAPTCHA field in the form. The CAPTCHA field is intended for use as a security measure in anonymous, public-facing forms to aid in preventing automated submissions of forms by "bots" or other computer programs.

The Captcha field is not applicable to Record Forms.

Captcha.png

clipboard_eed43dede554cf8e25f7f8c6e769e1c19.pngScan Barcode Field

This field can scan both 1 and 2 dimensional bar codes and will copy the associated value into the scan field text section. This field is only compatible with devices which have access to a camera and is not compatible with Internet Explorer.

Button Field

Button.png

This field can be added to a form and when configured, can trigger a specific action or series of actions. Buttons can be used to trigger the following stage level actions: Notifications, Child Workflows, Form Mapping, External API, Salesforce Integration, Teamconnect Integrations. To do so, simply select the desired button field as the trigger field when configuring those actions on a stage. Button fields can be configured to limit the amount of presses, and can also have custom error messages set for when an action fails.

The color, icon, and label on a button field can be updated using the field options. When used on a form, a number will appear next to the button each time it is triggered. This number indicates how many times the button has been triggered in a given session, and will appear green when the corresponding action was successfully triggered, and red when it was not:

Button.png

Triggering a button saves the form, and information about each trigger is added to the workflow's audit trail. 

Blocks
 

Block fields are not applicable to Record Forms.


clipboard_e089433954a59cb53f7a0ea8378506e4c.pngSignature Field

Use the Signature field to insert a signature field in the form. The Signature field lets users "draw" a signature into a field on the form. The Signature field can be populated onto a document, or stored in the TAP audit trail the same as any other form field.

Signature.png


clipboard_e37f2c6103e4087d12201da906941066f.pngSignature Block

Use the Signature block field to insert a pre-formatted signature block in the form. The Signature block field is comprised of two Text fields,with field labels for Name and Email Address.

SignatureBlock .png
 

clipboard_e4822fed982a0473051c55b31fd9e28c7.pngApproval Block

Use the Approval block field to insert a pre-formatted approval block in the form. The Approval block field is comprised of a Drop Down field and an Area field, with field labels for Approval and Approver comments. The Approval menu is pre-configured with the options ApproveDeny and Request More Information.

ApprovalBlock .png
 

clipboard_e868bf4f1dd97487702edaffe3eb08a48.png Address Block

Use the Address block field to insert a pre-formatted address block in the form. The Address block field is comprised of four Text fields and a Drop Down field , with field labels for AddressAddress line 2CityState and Zipcode. The State menu is pre-configured with the two-letter postal code abbreviations for the 50 states.

Address.png

E-Signature Functionality   

E-signature fields are not applicable to Record Forms.

 

clipboard_e36319f9fd4205d0cc27ff282eb66c99d.pngEmail Message

Use the Email Message field to allow the user to enter a personalized message which will appear in the Echosign message field..

Email Message .png
 

clipboard_ec7f814fb082d783d56cc3801c16be469.png Localization

Use the Localization field to to allow the user to select a desired language for specific language notifications.

Localization .png
 

clipboard_e32aa972463cae27ea557cafe27fb9f14.pngPassword

Use the Password Field to allow the user to set a password for the document.

Password .png
 

clipboard_ec7ea11cc95ccee6d5bcf6e19a0aec956.pngExpiration

Use the Expiration field to set the Echosign document expiration date.

Document Expiration .png
 

clipboard_e08f1dd389e9c53c0aa8bfbc7071c8da3.pngReminder

Use the Reminder field to set a daily or weekly Echosign reminder message for the intended signer that a workflow stage requiring an e-signature is pending.

Reminder.png
 

clipboard_e2f167a97c069f69da448b95a7b35ac56.png Rejection Reason

Use the Reject Reason field to allow an intended signer to provide a reason for not signing a document, and submit a workflow stage requiring an e-signature without providing the signature.

Rejection Reason.png

 

Form Field Properties

Field Settings.png

All form fields (with the exception of the Custom text field) have a unique set of properties that let you configure the appearance and/or functionality of the field. Field properties can be set using the Preferences dialog (accessed from the Form Field Controls tab) and/or by highlighting the desired field and selecting the desired option from the Properties Page toolbar.

When you highlight a form field, the Properties Page toolbar dynamically updates to display only those properties applicable to the selected field.


To set properties using the Preferences dialog:

  • Click the TAP - designer forms (image 7).jpg button for the desired form field to display the Preferences dialog.
  • Configure the form field properties as desired, then click the Close  button to close the Preferences dialog and return to the Designer screen.


To set properties using the Properties Page toolbar:

  • Click the desired form field.
    • The selected form field is highlighted, and the Properties Page toolbar updates to display the available properties.
  • Click the button for the desired property to display the data entry field.
  • Configure the option as desired.


FORM FIELD PROPERTIES

Toolbar
Button

Property

Description

clipboard_e4e2cf9a20a12a12cab816052a72d1392.png
(unselected)

clipboard_e1b38bcdbe1044b894c3ce2b43ef8e540.png
(selected)

Add Columns

Determines whether or not users can add columns to the spreadsheet field in the workform; click the Add Columns button in the Properties Page toolbar, or select the Add Columns check box on the Preferences dialog, as desired. The default value for this parameter is "unselected" (users cannot add columns to the spreadsheet).

 Used with... Spreadsheet

clipboard_e5efaca767b3af8ecd795e613dd5511da.png
(unselected)clipboard_e012c4d50735a4e304641d2b25cef57df.png
(selected)

Add Rows

Determines whether or not users can add rows to the spreadsheet field in the workform; click the Add Rows button in the Properties Page toolbar, or select the Add Rows check box on the Preferences dialog, as desired. The default value for this parameter is "unselected" (users cannot add rows to the spreadsheet).

 Used with... Spreadsheet

clipboard_e63b61147d6c917a4a5b82c893334b7f8.png(unselected)
clipboard_e90951d8f7b626560f88621331a4911df.png(selected)

Add to Repository

Determines whether or not a form field is added to the repository. Form fields in the repository can be edited during the workflow using the Edit option in the Workflow Dashboard Actions menu, or used with the Filters property to populate the drop-down menu in the Workflow records form field.

 Used with... Address     Area     Boolean Check Box     Check Box     Datepicker     Document Expiration     Email Message     File Upload     Localization     Multi-select     Multi upload     Password Field     Radio Button     Reason for not Signing     Reminder     Salesforce records     Text     Workflow records    

clipboard_e6ede8e94bfe8e1629db63e1861eaab93.png

Align block 1/2

Sets the width of the form field to 50% of its normal size, allowing two fields to be positioned side by side; click the Align block 1/2 button in the Properties Page toolbar, or select the Align block 1/2 check box on the Preferences dialog, as desired. The default value for this parameter is “unselected” (field is not configured for block alignment).

 Used with... Address     Area     Boolean Check Box     Check Box     Datepicker     Document Expiration     Email Message     File Upload     Localization     Multi-select     Multi upload     Password Field     Radio Button     Reason for not Signing     Reminder     Salesforce records     Spreadsheet     Table     Text     Workflow records     

clipboard_e28f68ae22ae38a502f225069241f00f9.png

Align block 1/3

Sets the width of the form field to 33% of its normal size, allowing three fields to be positioned side by side; click the Align block 1/3 button in the Properties Page toolbar, or select the Align block 1/3 check box on the Preferences dialog, as desired. The default value for this parameter is “unselected” (field is not configured for block alignment).

 Used with... Address     Area     Boolean Check Box     Check Box     Datepicker     Document Expiration     Email Message     File Upload     Localization     Multi-select     Multi upload     Password Field     Radio Button     Reason for not Signing     Reminder     Salesforce records     Spreadsheet     Table     Text     Workflow records      

clipboard_e41c32931499d1e51f1a4614f84c75514.png

Attachments access

NOTE

The Attachments access parameter can be configured only through the Properties Page toolbar.

Specifies the user(s) granted access to attachments uploaded using the File Upload field. You can specify one or more authorized users.

 Used with... File Upload     Multi upload     

TAP - designer forms (image 87).jpg Audit Trail Access Limits Audit Trail visibility of this field to users with the roles entered. If left blank, all users with access to the Audit Trail will have visibility into the field.

clipboard_e150c5c37c4a372caa805d3799234a67b.png

Button align

Sets the alignment for buttons included in the field; select leftright or center. The default value for this parameter is center.

 Used with... Submit Button     

clipboard_e4e6c84b3e5604718c818adb1d4751845.png

Columns

Sets the width of the text box in number of columns; specify the text box width as desired. You can manually enter the text box width or use the TAP - designer forms (image 82).jpg buttons to increase or decrease the text box width in one-column increments. The default value for this parameter is 40 columns.

 Used with... Area     Email Message     Reason for not Signing     

clipboard_eeb122e7030811adfc46beaecbbbbc7c8.png

Columns Width

Sets the width of the columns in a table in pixels; specify the column width as desired. You can manually enter the column width or use the TAP - designer forms (image 82).jpg buttons to increase or decrease the column width in one-pixel increments. The default value for this parameter is 150 pixels.

 Used with... Table     

clipboard_ec5169ebbf220f99a83c147ebddcd5f7e.png

Count Columns

Sets the number of columns in a table; specify the number of columns as desired. You can manually enter the number of columns or use the TAP - designer forms (image 82).jpg buttons to increase or decrease the column count in one-column increments. The default value for this parameter is 3 columns.

 Used with... Table        

clipboard_e9a1105bc6371e0b8831a81387aa3bd5c.png

Count Rows

Sets the number of rows in a table; specify the number of rows as desired. You can manually enter the number of rows or use the TAP - designer forms (image 82).jpg buttons to increase or decrease the row count in one-row increments. The default value for this parameter is 1 row.

  Used with... Table      

clipboard_e8ccff73c143446a83fcbc310f70e9d4c.png

Default Date

Indicates whether or not the a “default” date (the current calendar date) will be automatically entered in the field; click the Default Date button in the Properties Page toolbar, or select the Default Date checkbox on the Preferences dialog, as desired. The default value for this parameter is “selected” (“default” date is automatically entered in the field).

 Used with... Datepicker     

clipboard_e92f1238beabf7f5e7609f595f0f491b5.png

Display options

Determines whether a Custom html field is displayed as a form item or as a "popup" dialog. Click the Display options button in the Properties Page toolbar to display the Static html display options dialog.

 Used with... Custom html

clipboard_ec1c6a4a9343467b846b7cf248d1fc5ef.png

e-Signature tag

Configures a form field with an e-signature tag; select the Required or Read only check box in the toolbar, as appropriate.

There is a validation to ensure eSignature tags do not contain unsupported characters. If the eSignature tags in your workflow contain unsupported characters you will receive an error message upon saving changes to that workflow. It is important that these tags do not contain unsupported characters in order to prevent negative impacts to dashboard and other functionalities.

  • Special characters and spaces are not allowed. The tags should also not start with a number. eSignature tags are allowed to have characters a though z (lowercase and uppercase), 0-9 (as long as it is not the first character), and “_”

The e-Signature tag parameter can be configured only through the Properties Page toolbar.

 Used with... Address     Area     Boolean Check Box     Check Box     Datepicker     Document Expiration     Drop Down     Email Message     File Upload     Localization     Multi select     Multi upload     Password Field     Radio Button     Reason for not Signing     Reminder     Salesforce records     Text     Workflow records     

clipboard_e2d2596a06f47d9e41259fd458c9bed59.png
(unselected)

clipboard_e5ae473bbd7c1770d9a063e1ba4de8f0a.png
(selected)

Editable

The Editable parameter can be configured only through the Properties Page toolbar.

Determines whether or not content in a Table field is editable; click the Editable button in the Properties Page toolbar, or select the Editable checkbox on the Preferences dialog, as desired. The default value for this parameter is “unselected” (content in the Table field is not editable).

  Used with... Table      

TAP - designer forms (image 89).jpg

Filters

The Filters parameter can be configured only through the Properties Page toolbar.

Determines the set of options from which users may make selections in the Filters drop-down menu based on a specified default search field.

 Used with... Address     Workflow records     

clipboard_e3f29b72c0bd6280d561ff3bfa4ca7afd.png

Formula

The Formula parameter can be configured only through the Properties Page toolbar.

Defines the content of a field based on specific logical operations performed on one or more other text fields.

 Used with... Document Expiration     Password Field     Text

 TAP - designer forms (image 92).jpg

Heading size

Specifies the size of the primary heading font in (points/pixels/??); specify the heading size as desired. You can manually enter the desired size or use the buttons to increase or decrease heading size in one-unit increments. The default value for this parameter is 20 (points/pixels/??).

Sub heading font size is fixed, and cannot be changed.

TAP - designer forms (image 110).jpg Hide Audit Trail When this box is checked, Audit Trail visibility for values entered into this field will only be available for users with the Super Admin role.

clipboard_ef182780e0367e633891e13cb962ee25e.png(unselected)
clipboard_ef9dfb87f6775cde6563982d4ea372bf2.png(selected)

Hide in attachments

Determines whether or not a form field is hidden in attachments; click the Hide in attachments button in the Properties Page toolbar, or select the Hide in attachments checkbox on the Preferences dialog, as desired. The default value for this parameter is “unselected” (form field is not hidden).

 Used with... File Upload     Multi upload     

clipboard_e1abe193f4346e1ab1c4c98caf3bc035b.png(unselected)

clipboard_ed46c2c5c0716283520f1b8d743aaf238.png(selected)

 

Horizontal options

The Horizontal options parameter can be configured only through the Properties Page toolbar.

Determines whether radio buttons (in the Radio Button field) or check boxes (in the Check Box field) are displayed vertically (in a single column) or horizontally (in one or more rows);  click the Horizontal options button in the Properties Page toolbar. The default value for this parameter is “unselected” (radio buttons / check boxes are displayed vertically).

 Used with... Check Box     Radio Button  

clipboard_e19a7e991e2eb3703c34da416deec495b.png

Hover tip

Specifies the popup “tip text” shown when the cursor “hovers” over the field; enter the desired text. This parameter is blank by default.

 Used with... Address     Area     Boolean Check Box     Check Box     Datepicker     Document Expiration     Email Message     File Upload     Localization     Multi select     Multi upload     Password Field     Radio Button     Reason for not Signing     Reminder     Salesforce records     Spreadsheet     Table     Text     Workflow records      

TAP - designer forms (image 97).jpg

Label align

Sets the alignment of the field label; select left (left-aligned at the left margin of the form) right (right-aligned at the left edge of the text box) or top (positioned above the text box) The default value for this parameter is left.

 Used with... Area     Check Box     Datepicker     Document Expiration     Drop Down     Email Message     File Upload     Localization     Multi select     Multi upload     Password Field     Radio Button     Reason for not Signing     Reminder     Salesforce records     Table     Text     Workflow records      

TAP - designer forms (image 98).jpg

Max Size

Sets the maximum number of characters that can be entered in the text box. You can manually enter the desired number of characters or use the TAP - designer forms (image 82).jpg buttons to increase or decrease the number of characters in one-character increments. The default value for this parameter is 2000 characters (for Area and Email Message fields) or 300 characters (for Text field).

 Used with... Address     Area     Document Expiration     Email Message     Password Field     Reason for not Signing     Text     

TAP - designer forms (image 89).jpg

Options

The Options parameter can be configured only through the Properties Page toolbar.

Specifies the set of options from which users may make selections. You can choose to Set options manuallyUse data source as option data or Use registered users as options (not available for use with Multi select field).

 Used with... Check Box     Drop Down     Multi select     Radio Button     

clipboard_e590358aadd68f0caaa0fd85bce3e6e70.png

Placeholder

Specifies the placeholder text to be shown in the “empty” field; enter the desired placeholder text. This parameter is blank by default.

Placeholder text is generally used to provide instructional or advisory information, such as to indicate the content to be provided (e.g., “Last name, First name, Middle initial”) or the format of the value to be entered (e.g. “(###) ###-####”).

 Used with... Address     Area     Document Expiration     Drop Down     Email Message      Localization     Multi select     Password Field     Reason for not Signing     Reminder     Salesforce records     Text     Workflow records     

clipboard_e595eb5f77481346915361fc5a997f298.png

Print Button

Adds a Print button to the field; click the Print Button in the Properties Page toolbar, or select the Print Button check box on the Preferences dialog, as desired. The default value for this parameter is “off” (Print button is not included).

When the Print button is selected by a user filling out a form, the contents of the form (including all entered values) can be printed from the user’s local workstation.

 Used with... Submit Button     

clipboard_e746ba81442f2647cc99a347fdb787135.png
(unselected)

clipboard_e4920454ad2dd0c2026e126abbe06ec42.png
(selected)

Remove Columns

Determines whether or not users can remove columns from the spreadsheet field in the workform; click the Remove Columns button in the Properties Page toolbar, or select the Remove Columns check box on the Preferences dialog, as desired. The default value for this parameter is "unselected" (users cannot remove columns from the spreadsheet).

 Used with... Spreadsheet

clipboard_ef2573e912bb69ef67ad674d3940778f2.png
(unselected)

clipboard_e97d5925ec3cc77a121bc71837f0dbc9b.png
(selected)

Remove Rows

Determines whether or not users can remove rows from the spreadsheet field in the workform; click the Remove Rows button in the Properties Page toolbar, or select the Remove Rows check box on the Preferences dialog, as desired. The default value for this parameter is "unselected" (users cannot remove rows from the spreadsheet).

 Used with... Spreadsheet

clipboard_e9a9fbe11097145b537b50b345c556d5e.png
(unselected)
clipboard_e14e54fea1bde9881997fb5682295a4c8.png
(selected)

Required

Indicates whether or not the field is a “required” field; click the Required button in the Properties Page toolbar, or select the Required check box on the Preferences dialog, as desired. The default value for this parameter is “unselected” (field is not a required field).

When a field is configured as “required,” the form cannot be submitted if content has not been entered in the field.

 Used with... Address     Area     Boolean Check Box     Check Box     Datepicker     Document Expiration     Drop Down     Email Message     File Upload     Localization     Multi select     Multi upload     Password Field     Radio Button     Reason for not Signing     Reminder     Salesforce records     Text     Workflow records    

TAP - designer forms (image 110).jpg Required for Save When checked, the field will be required to be filled before a user can save the form.

clipboard_ea1d1f897145292f9828edfc99da192f9.png

Reset Button

Adds a Reset button to the field; click the Reset Button in the Properties Page toolbar, or select the Reset Button check box on the Preferences dialog, as desired. The default value for this parameter is “off” (Reset button is not included).

When the Reset button is selected by a user filling out a form, all form fields are reset to their default values.

 Used with... Submit Button    

TAP - designer forms (image 104).jpg

Rows

Sets the height of the text box in number of rows; specify the text box height as desired. You can manually enter the text box height or use the TAP - designer forms (image 82).jpg buttons to increase or decrease the text box height in one-row increments. The default value for this parameter is 6 rows.

 Used with... Area     Email Message     Reason for not Signing     

TAP - designer forms (image 105).jpg

Rows Height

Sets the height of the rows in a table in pixels; specify the row height as desired. You can manually enter the row height or use the TAP - designer forms (image 82).jpg buttons to increase or decrease the row height in one-pixel increments. The default value for this parameter is 30 pixels.

 Used with... Table     

clipboard_e8fd924ba36ac2c7c0ccbe392c4a3a826.png

Salesforce options

 

Determines the set of options from which users may make selections in the Salesforce options drop-down menu based on a specified default search field.

 Used with... Salesforce records

clipboard_e3969d2c3f4a90ec672e2b03c3e5183f7.png

Save Button

Adds a Save button to the field; click the Save Button in the Properties Page toolbar, or select the Save Button check box on the Preferences dialog, as desired. The default value for this parameter is “off” (Save button is not included).

When the Save button is selected by a user while filling out a form, any values entered in form fields by the user are saved.

 Used with... Submit Button    

clipboard_e0d700baaea6788a3c678c0db91e91d75.png

Save Text

Specifies the label shown on the Save button; enter the desired label text. The default value for this parameter is save.

 Used with... Submit Button    

clipboard_e8aa7fd6d8449d8d86d611193f1e1c5d3.png

Size

Sets the width of the text box in characters; specify the text box size as desired. You can manually enter the text box size or use the  buttons to increase or decrease the text box size in one-unit increments. The default value for this parameter is 35 characters.

 Used with... Document Expiration     Password Field     Text     

clipboard_efbddf614459a94a05829bdb1e079e43d.png

Sub heading

Inserts a sub heading below the field; enter the desired sub heading text. This parameter is blank by default.

 Used with... Address     Area     Boolean Check Box     Check Box     Datepicker     Document Expiration     Email Message     File Upload     Localization     Multi select     Multi upload     Password Field     Radio Button     Reason for not Signing     Reminder     Salesforce records     Spreadsheet     Table     Text     Workflow records      

clipboard_ec58f111326b1a6fd408ee4452ca1fb6f.png

Submit Text

Specifies the label shown on the Submit button; enter the desired label text. The default value for this parameter is submit.

 Used with... Submit Button    

clipboard_e7ca687edb5c0ac9cbf9a42b93209410e.png

Validation

Sets the validation criteria for contents entered in the field; select EmailAlphabeticAlphanumericNumeric, Numeric decimalsRegular expressionPhone number, SSN (Social Security Number), or Currency, as desired. The default value for this parameter is “no validation.” Once selected, the validation criteria is shown in the upper left corner of the field.

When Regular expression is selected as the validation criteria, use the Regular Expression Builder to select a predefined regular expression or create a custom regular expression, and define the error message shown when user input does not match the desired format.

 

When Currency is selected as the validation criteria, choose the Currency type, the Selection Type (Single currency or Multi-currency), and the  Format against which the entered value will be validated.

 

Once validation has been set for a field, it cannot be removed. If you no longer wish validation to be applied to the field, you must delete the field, and then add a new field to the form.

 Used with... Document Expiration     Text    

clipboard_ef2de69f1bc98aa20e4bf396f44b91df9.png

Width

Sets the width of the drop down menu in pixels; specify the menu width as desired. You can manually enter the menu width or use the TAP - designer forms (image 82).jpg buttons to increase or decrease the menu width in one-unit increments. The default value for this parameter is 250 pixels.

 Used with... Drop Down     Localization     Multi select     Reminder     Salesforce records     Workflow records     

Setting Form Options

By default, labels on form fields are displayed using the Arial (regular) font face with a size of 13 points. Form options let you overwrite the default styles and specify the desired font face, size and style for various labels and fields in the form. You can set options both globally and for specific form field content. Form options are configured using the Properties Page toolbar. The following options are available:

Toolbar
Button


Option


Description

TAP - designer forms (image 112).jpg

Global styles

Lets you overwrite the default font face and specify the desired font face and style (bolditalicunderline) to be applied globally to all text on form fields.

Global styles can be overwritten for specific form field labels and text using the options below.

TAP - designer forms (image 113).jpg

Form label Lets you overwrite the default font face (or Global style when configured) and specify the desired font face, size and style (bolditalicunderline) to be applied to all labels on form fields.

TAP - designer forms (image 99).jpg

Area and input

Lets you overwrite the default font face (or Global style when configured) and specify the desired font face, size and style (bolditalicunderline) to be applied to text entered by the user in text boxes.

Area and input styles are also applied to Placeholder text (see Setting Field Preferences for more information).

TAP - designer forms (image 109).jpg

Subheading Lets you overwrite the default font face (or Global style when configured) and specify the desired font face, size and style (bolditalicunderline) to be applied to subfield text on form fields (see Setting Field Preferences for more information).

TAP - designer forms (image 89).jpg

Checkbox and radio Lets you overwrite the default font face (or Global style when configured) and specify the desired font face, size and style (bolditalicunderline) to be applied to check box and radio button labels.

TAP - designer forms (image 114).jpg

Form columns count Lets you specify the default number of columns for the form; either One columnTwo columns or Three columns. You can choose to apply the selected value to existing fields on a form, or only to new fields added to an existing form. The default value for this option is Three columns.

 

To display Form options in the Properties Page toolbar:

  • Click the Form options link on the Form Editor tab.
    • The Properties Page toolbar updates to display the available options.
       

Working with Sections

When you select the Create button from the Designer Homepage, the Forms Page displays, with a single section defined. Forms can be prepared as a "standalone" (single section) form containing all form fields for a workflow, or they can be divided into two or more logical groupings, or sections. There are a number of considerations in determining whether or not to sectionalize a form, including:

  • Organization - You can use sections to separate a form into logical groupings based on the departments or groups in your organization responsible for the workflow (Purchasing, Shipping, Receiving, etc.).
     
  • Ease of use and maintenance - If a form may require periodic updates or modifications, separating the form into sections can help reduce the amount of time needed to make the necessary changes.
     
  • Controlling form access - In cases where it's desirable to suppress display of groups of form fields at one or more workflow stages, the Form access feature lets you "hide" a section of a form without the need to selectively "hide" the individual form fields.
     

Designer form.png

The sections included in a form are shown at the top of the form editor field. Click a section name to view the section.

  • To add a new section to a form:
    • Click the TAP - designer forms (image 116).jpg icon at the top of the form editor field.

      New sections are assigned a default name and number according to the sequence in which they are added to the form. 

  • To rename a section:
    • Double click the section you wish to rename.
    • Select the current section name, and enter the new name as desired.
       
  • To reposition a section:
    •  Click and hold the left mouse button, then drag the section to the desired position.
       
  • Change.png
  • To move a form field to a new section:
    • Click the field you wish to move, then click the TAP - designer forms (image 6).jpg icon in the form field tab to open the Change Section dialog.
    • Select the section to which you wish to move the selected from the drop-down menu. The menu lists all section in the form except the currently active section.
    • Click the Change section button. The selected field is moved to the bottom of the specified section.
       
  • To delete a section:

    You cannot delete a section that contains form fields. You must first move or delete all fields contained in the section before the section can be deleted.

    • Move any form fields you wish to retain to other sections of the form as described above.
    • Delete any form fields you do not wish to retain in the form.
    • When all fields in the section have been moved or deleted, click the TAP - designer forms (image 8).jpg icon next to the name of the section you wish to delete. The selected section is deleted, and the screen scrolls to the first section of the form.
       

Creating a Thank You Page

The Thank You page is shown to a user upon completing and submitting a workflow stage. The Thank you page option in the Designer lets you create a "generic" Thank You page that applies to all stages of a workflow. It can be found under the MENU drop down on the Form page

 

You can also use the Thank you page property for a workflow stage relationship to create "stage specific" Thank You page that overrides the "generic" Thank You page for the workflow stage with which it is associated.


Thank you page .png

 

 

The Thank You page editor uses the Open Source CKEditor HTML editor to create Thank You page content. Click here to find information on using the features and functions available through the CKEditor.

 

To create a Thank You page:

  1. If necessary, locate and load the workflow for which you wish to create a Thank You page.
     
  2. Click the Thank you page link on the Form Editor tab.
    • The Thank You page editor displays.
       
  3. Enter and format the content for the Thank You page as desired.
  4. When all desired content has been entered, click the TAP - designer forms (image 3).jpg Save button in the Properties Page toolbar to save your changes.
    • A confirmation popup shows the message "Form workflow successfully saved."

Import Form From PDF

The primary purpose of this feature is to eliminate the manual creation of various fields, such as text fields, drop-down fields, area fields, etc. It involves the incorporation of specific acro fields within the Adobe Acrobat editor. This allows for the creation of a PDF, which can subsequently be directly imported for utilization.

To import a form from a PDF file, follow these steps:

  1. Navigate to the Menu Tab --> Import form from pdf.  

  2. Begin by clicking the 'Choose File' option.

  3. From your local storage, select the PDF file of your choice.

The PDF imported form must be configured with acro fields. Otherwise, the form cannot be imported.

  1. Alternatively, you have the option to simply drag and drop the PDF file onto the dialog box.

  2. You have the option to specify whether to include read-only fields.

  3. Now, simply click the 'Import PDF File' button.

  4. The selected PDF will be brought into the designer page as a form.

 

Import PDF Section.png

Working with Record Forms

Record Forms are generally used for business processes that do not require an e-signature or other form of authorization, such as status reports, internal document distribution, etc. Record Forms are created in a similar manner as e-signature forms, using an abbreviated set of form fields.


Record Form Fields.png


To access Record Forms:

  • Click the Business Automation TAP - designer forms (image 1).jpg button  in the TAP Toolbar to access the Business Automation module.
  • Click the Create button.
    • The Designer displays the Forms - Properties page.
  • Click MENU
    • Under Form Editor, click Record Form
    • The Designer displays the Record Forms editor page.