Skip to main content

Complete List of Forms Module How Tos (Advanced Suite)



How To: Access a Form's Shareable URL Link/QR Code

To access a form’s sharable URL Link or QR Code, go to the Home Page of the Forms Module and select the three-dot icon to the right of the form title whose URL Link or QR Code you want. image.png

Click “Overview” on the context menu, opening the form specific Overview Tab.

image.png

Both the Form URL and QR Code are visible on this tab.

How To: Add a Field to a Form

To add a field to a form, go to the Home Page of the Forms Module. . Click the three-dot icon to the right of the form title that you want to add a field to opening the Form context menu. Select “Fields”.

image.png

This opens the Fields Tab for the specific form of interest.

There are two ways to add an individual field to the Fields Table from here. Click the “New Field” button opening the New Form Field Modal.

image.png

The creation of a new field will always require you to enter a field name. Include an input for the displayed label and select the field type from a dropdown menu. The inputs on the New Form Field Modal will vary based on the Field Type.

Possible field types in the Forms Module include Form Fields, Formatting Fields, Utility Fields, Account Fields, and Reference a Database Entry. For an explanation of field types and the formatting choices associated with each one, reference the Understanding Fields Section of the Forms Module in the User Manual.

A form field can only have on field type. If you need to utilize another (e.g., formatting purposes), you can set the displayed label to be the same but the field label must be unique.

Once you are finished inputting the information for the new field, select “Save” and the new database field will show in the Fields Table on the Fields Tab.

image.png

Fields can also be imported in bulk into a Form from a CSV file or PDF Field Import.

How To: Import Form Fields from a CSV File

To import form entries from a CSV, form fields must have already been created.

How To: Add a Field to a Form

To add a field to a form, go to the Home Page of the Forms Module. . Click the three-dot icon to the right of the form title that you want to add a field to opening the Form context menu. Select “Fields”.

image.png

This opens the Fields Tab for the specific form of interest.

There are two ways to add an individual field to the Fields Table from here. Click the “New Field” button opening the New Form Field Modal.

image.png

The creation of a new field will always require you to enter a field name. Include an input for the displayed label and select the field type from a dropdown menu. The inputs on the New Form Field Modal will vary based on the Field Type.

Possible field types in the Forms Module include Form Fields, Formatting Fields, Utility Fields, Account Fields, and Reference a Database Entry. For an explanation of field types and the formatting choices associated with each one, reference the Understanding Fields Section of the Forms Module in the User Manual.

A form field can only have on field type. If you need to utilize another (e.g., formatting purposes), you can set the displayed label to be the same but the field label must be unique.

Once you are finished inputting the information for the new field, select “Save” and the new database field will show in the Fields Table on the Fields Tab.

image.png

Fields can also be imported in bulk into a Form from a CSV file or PDF Field Import.

How To: Import Form Fields from a CSV File

{{@402}}

How To: Import Fields from a PDF Field Import

{{@400}}


How To: Import Form Fields from a CSV File

To import form entries from a CSV, form fields must have already been created.

How To: Add a Field to a Form

{{@373}}

How To: Import Form Fields from a CSV File

{{@402}}

How To: Import Fields from a PDF Field Import

{{@400}}

To import form entries from a CSV, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form you wish to import entries into. Select “Manage Entries”.

image.png

This opens the Manage Entries for (FORM NAME) Page.

image.png

Click the “Import Entries” button beneath the page header. This opens the Upload CSV for (FORM NAME) Modal.

image.png

Click the “Download Template” link at the top of the modal and a CSV file will be downloaded to your personal device. Notes have been provided if you are using the downloadable template to Upload bulk CSV form entries.

Notes Regarding the Downloadable Template for Uploading CSV Files

The first row of the CSV file is for each of the form fields. If you download a CSV Template from the Upload CSV Modal, two additional column headers will show that are not form fields: Entry ID and Modify Existing Entry.

If you are importing form entries and no entries have been added to the form yet, leave these columns blank in your upload.

If form entries already exist in the database, the Entry ID column will contain the unique system generated ID for each pre-existing database entry. Leave this column blank if the row is to be imported as a new entry. The second column, Modify Existing Entry, should have a “Y” input if the existing entry is being modified and an “N” input if it has not been modified. Leave this column blank if the entry is new.

image.png

After creating your Forms Entries CSV file, save it as a CSV UTF-8 for importing. Click the “Choose File” button on the Upload CSV Modal and open the relevant file from your personal device.

image.png

Confirm that the correct CSV file now shows in the Upload CSV Modal.

image.png

Select the “Upload” button.

image.png

The entries imported from the CSV file will now show on the Upload CSV for (FORM NAME) Page.

The system automatically indicates to ignore the first row. Click “Import Now” if there are no errors.

A summary of the import will now show on the CSV Upload Page.

image.png

Click the “Entries for (FORM NAME)” link to see all imported entries on the Manage Entries Page.

How To: Import Fields from a PDF Field Import

Importing fields from a PDF Field Import has multiple purposes. Not only will the form fields be generated through this process, the PDF will also be saved by the system, so that future form entries can be downloaded into this PDF, allowing for customizable outputs.

A form must have already been created with no fields added for this method to work. If a field has already been added to the form, you are no longer able to bulk import form field names from a PDF Field Import. You are now required to enter each field name individually. Regardless, you can still upload a PDF Form that the system will use for future form entry downloads.

How To: Create a Form

{{@386}}

How To: Add a Field to a Form

{{@373}}

How To: Upload a PDF Form

{{@408}}

To import field names from a PDF file, go to the Home Page of the Forms Module.

Select the three-dot icon to the right of the Form Title opening the Form’s context menu. Select “Form”.

image.png

This opens the Fields Tab for a specific form. Select the “PDF Field Import” button.

image.png

This opens the PDF Field Import Modal.

image.png

To import fields using a PDF, use the “Prepare Form” tool in Adobe Acrobat Pro. Add the fields you wish to use for your form. Add a button on your document.

image.png

Within the button properties, click on the Actions Tab. On the “Mouse Down” trigger, add the “Submit a Form” Action.

image.png

Confirm that the Export Format is “PDF The complete document”.

image.png

Open the PDF and submit the form to generate the fields here.

You do not need to fill in any of the fields, and you must not sign it.

image.png

Select “Allow” and the PDF will confirm that the fields were added to the database.

image.png

Go to the Fields Table in the database Monday, and a warning now states that a PDF is associated with the form and that adding/editing or deleting fields may result in the PDF no longer being compatible.

To import form entries from a CSV, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form you wish to import entries into. Select “Manage Entries”.

image.png

This opens the Manage Entries for (FORM NAME) Page.

image.png

Click the “Import Entries” button beneath the page header. This opens the Upload CSV for (FORM NAME) Modal.

image.png

Click the “Download Template” link at the top of the modal and a CSV file will be downloaded to your personal device. Notes have been provided if you are using the downloadable template to Upload bulk CSV form entries.

Notes Regarding the Downloadable Template for Uploading CSV Files

The first row of the CSV file is for each of the form fields. If you download a CSV Template from the Upload CSV Modal, two additional column headers will show that are not form fields: Entry ID and Modify Existing Entry.

If you are importing form entries and no entries have been added to the form yet, leave these columns blank in your upload.

If form entries already exist in the database, the Entry ID column will contain the unique system generated ID for each pre-existing database entry. Leave this column blank if the row is to be imported as a new entry. The second column, Modify Existing Entry, should have a “Y” input if the existing entry is being modified and an “N” input if it has not been modified. Leave this column blank if the entry is new.

image.png

After creating your Forms Entries CSV file, save it as a CSV UTF-8 for importing. Click the “Choose File” button on the Upload CSV Modal and open the relevant file from your personal device.

image.png

Confirm that the correct CSV file now shows in the Upload CSV Modal.

image.png

Select the “Upload” button.

image.png

The entries imported from the CSV file will now show on the Upload CSV for (FORM NAME) Page.

The system automatically indicates to ignore the first row. Click “Import Now” if there are no errors.

A summary of the import will now show on the CSV Upload Page.

image.png

Click the “Entries for (FORM NAME)” link to see all imported entries on the Manage Entries Page.

How To: Import Fields from a PDF Field Import

Importing fields from a PDF Field Import has multiple purposes. Not only will the form fields be generated through this process, the PDF will also be saved by the system, so that future form entries can be downloaded into this PDF, allowing for customizable outputs.

A form must have already been created with no fields added for this method to work. If a field has already been added to the form, you are no longer able to bulk import form field names from a PDF Field Import. You are now required to enter each field name individually. Regardless, you can still upload a PDF Form that the system will use for future form entry downloads.

How To: Create a Form

To create a new form, open the Home Page in the Forms Module from the Main Menu and select the Create Form button beneath the page header.

image.png

This will open the New Form Modal.

image.png

Input the Form Title (a required field), form notes, and any open/permissive/restrictive tags to be associated with the form.

There are three additional sections to the New Form Modal that expand when clicked with additional options for customization. Modal images and explanations of each input are included below.

Basic Settings Section

image.png


New Form Modal: Basic Settings Section Explanation

Modal Input

Explanation

Group

A dropdown menu will list all existing form groups. The form will automatically be placed in the group selected.

Allow Public Entries Checkbox

If the checkbox is selected, public entries (individuals not registered with KAStrack) will be allowed to submit form entries.

URL Link

A URL Link is used to share the form publically. KAStrack will autofill the URL Link with the form title, but this can be customized if desired.


You cannot use spaces or symbols in the URL link. They will replaced with a hypen if used.

The next two checkboxes are specific to the PDF options for form entries that are not submitted via a PDF. To understand which option is better for this specific form, be sure to read about the relationship between PDFs and Forms.

Use KAStrack Generated PDF

If you have a PDF entry on file but do not want the downloaded form entry to utilize the customized PDF form, select this checkbox and KAStrack will use the generic PDF format.

Use the Appropriate Uploaded PDF Revision

If you have a PDF entry on file and want the downloaded form entry to utilize the customized PDF form, select this checkbox and KAStrack will use the most recent version of the PDF submitted.









Allow Integration With











Allow integrations with is a dropdown menu that lists all modules you can use a form for. Selecting a module here will enable this form to be visible in the modules selected. Possible uses are listed below.

Module

Purpose

Assets

Attach to Task

Attendance

Integrate with the Attendance Log Module

Datbase

Reference from Database

Dispatch

Include in a Dispatch

Documents

Add to Photo

Forms

Reference from a Form

Grid

Integrate with the Grid Module

Kanban

Integrate with the Kanban Module

People

Use as activity for certification

Advanced Settings Section

image.png


New Form Modal: Advanced Settings Section Explanation

Modal Inputs

Explanation

Allow Payment Checbox

(Expands when selected)

Payment Profile

Select “All Enabled Configurations” from the dropdown menu for payments to be allowed.

Payment Description

This description is what will show on a payment receipt.

Default Pattern for Entries

This textbox uses mail merge fields.



Allow the User to Save AS Draft Checkbox


(Expands when selected)


Allow Logged Out User to Save as a Draft

Selecting this checkbox will allow logged out users and public entries to save their response as a draft and come back to the form (on the same device).

Validate Fields when Saving as Draft

Fields with validation don’t validate on a draft, so inputting fields here tells the system to validate fields when the draft is saved.

Save Draft Button Text

The form creator can customize the text on the Save button.

Auto Save

When auto-save is enabled, any edits made to a field will automatically be saved. When auto-save is disabled, the information will only be saved when the save draft button is clicked.





Allow Default Access Checkbox





When Selected

The form will follow module level permissions in regards to what access an individual will have.

If allow default access is not selected, the additional form specific permissions are now required. The system will ignore module level distinctions for this form and will be guided by the form specific permissions listed below.

Admins

A checkbox allows for admins to be prohibited from viewing entries. Users or roles listed here will have admin level permissions for this form. This includes editing and deleting the form, managing the form fields and (unless prohibited) managing entries.

Manage Entry Permissions

Users or roles listed here have manage level permissions for this form. This includes adding, editing and deleting entries.

Manage Pending Approval Entry Permissions

Users or roles listed here can edit entries that are pending approval.

Show in the Dashboard Forms Widget

Users and certification roles selected here will show this form in the Dashboard Forms Module Summary Widget.

Form Styling Section

image.png


New Form Modal: Form Styling Section

Modal Inputs

Explanation

Save Button Text

Change the verbiage on the save button by inputting other text here.

Cancel Button Text

Change the verbiage on the cancel button by inputting other text here.

Submission Message

Change the verbiage on the form submission message by inputting other text here.

Show Green Checkmark Checkbox

Selecting the show green checkmark with submission message checkbox will show a green checkmark to the left of the submission message when a form is submitted.

Show the Form Title Checkbox

Select the Show the Form Title Checkbox will show the form title for a logged-out entry. This does not impact a system, modal based entry.



Apply Whole Form

SCSS to



Logged Out Only

Select “Logged Out Only” if the styling doesn’t correspond with a popup modal or the regular form page. This would result is SCSS styling only applies to public entries.

Logged In Only

Select “Logged In Only” if you only want to apply the SCSS formatting to the logged in, internal users.

Always

Selecting “Always” applies the SCSS formatting that has been established in both internal and external forms.

SCSS for Whole Form

This is the textbox where scripting language should be input, that allows for greater customization than what is generally available.

Select the Save button on the New Form Modal after customizing your form and the system will direct you to the form's Fields Tab where you can begin to input Form fields.

image.png

How To: Import Fields from a PDF Field Import

{{@400}}

How To: Import Form Fields from a CSV File

{{@402}}

How To: Upload a PDF Form

{{@408}}


How To: Add a Field to a Form

To add a field to a form, go to the Home Page of the Forms Module. . Click the three-dot icon to the right of the form title that you want to add a field to opening the Form context menu. Select “Fields”.

image.png

This opens the Fields Tab for the specific form of interest.

There are two ways to add an individual field to the Fields Table from here. Click the “New Field” button opening the New Form Field Modal.

image.png

The creation of a new field will always require you to enter a field name. Include an input for the displayed label and select the field type from a dropdown menu. The inputs on the New Form Field Modal will vary based on the Field Type.

Possible field types in the Forms Module include Form Fields, Formatting Fields, Utility Fields, Account Fields, and Reference a Database Entry. For an explanation of field types and the formatting choices associated with each one, reference the Understanding Fields Section of the Forms Module in the User Manual.

A form field can only have on field type. If you need to utilize another (e.g., formatting purposes), you can set the displayed label to be the same but the field label must be unique.

Once you are finished inputting the information for the new field, select “Save” and the new database field will show in the Fields Table on the Fields Tab.

image.png

Fields can also be imported in bulk into a Form from a CSV file or PDF Field Import.

How To: Import Form Fields from a CSV File

{{@402}}

How To: Import Fields from a PDF Field Import

{{@400}}


How To: Upload a PDF Form

Uploading a PDF allows an individual to create a customized output for form entries. In order to do so, the PDF must be created on Adobe Acrobat Pro (or comparable software) and have made use of form fields.

A PDF can be created and uploaded after a form is in use, however no additional fields can be created at this time.

To upload a PDF form to be used for form entry outputs, go to the Home Page of the Forms Module. Click the three-dot icon to the right of the form title opening the context menu and select “Upload PDF”.

image.png

This will open the Upload PDF Form Modal.

image.png

Select “Choose File” to retrieve the PDF from your personal device.

Input a title for the PDF or select the clickable “Use Filename” link to have the system use the filename as the title. The revision date will automatically show the current day, but can be altered. Select the appropriate checkbox if the document is to be public, or if it is a 360 degree photo.

You can select individuals or certification roles as the document owner(s).

Select “Save” and a confirmation modal will appear stating, “File was uploaded.”

image.png


To import field names from a PDF file, go to the Home Page of the Forms Module.

Select the three-dot icon to the right of the Form Title opening the Form’s context menu. Select “Form”.

image.png

This opens the Fields Tab for a specific form. Select the “PDF Field Import” button.

image.png

This opens the PDF Field Import Modal.

image.png

To import fields using a PDF, use the “Prepare Form” tool in Adobe Acrobat Pro. Add the fields you wish to use for your form. Add a button on your document.

image.png

Within the button properties, click on the Actions Tab. On the “Mouse Down” trigger, add the “Submit a Form” Action.

image.png

Confirm that the Export Format is “PDF The complete document”.

image.png

Open the PDF and submit the form to generate the fields here.

You do not need to fill in any of the fields, and you must not sign it.

image.png

Select “Allow” and the PDF will confirm that the fields were added to the database.

image.png

Go to the Fields Table in the database Monday, and a warning now states that a PDF is associated with the form and that adding/editing or deleting fields may result in the PDF no longer being compatible.


How To: Add a Forms Group

To add a group in the Forms Module, select Groups on the Main Menu and go to the Manage Groups Page in the Forms Module.

image.png

Select the “New Group” button opening the New Group Modal. Input the name of the new group.

image.png

Select “Save” and the new group will now show in the Form Groups Table on the Manage Groups Page.

image.png

How To: Add a New Module Level (Forms Module)

To add a new module level in the Forms Module, go to the Settings Page and select the “New Module Level” button.

image.png

This opens the New Module Level Modal.

image.png

Input a name for the new module level and select the “Save” button.

image.png

The new module level will now show in the module level table on the Settings Page. Module levels created by your organization can be customized. The table below explains the action icons shown to the right of the custom module level.

Module Level Customization Icons

Icon

Explanation

image.png

The eyeball icon allows you to view users assigned to the module level as well as the permissions assigned to them.

image.png

The bulleted list icon allows you to assign permissions to customized module levels.

image.png

The pencil icon opens the Edit Module Level Modal.

image.png

The trashcan icon opens the Delete Module Level Confirmation Modal.

Select the bulleted list icon to add permissions to the new module level.

image.png

Click the checkboxes for the permissions you would like to be granted to the new module level.

Select “Save” when done added permissions.

How To: Add an Individual Form Entry

To add a form entry, go to the Home Page of the Form Module. Click the three dot icon to the right of the form you wish to add an entry to opening the context menu.

image.png

Select “Webform” to open a modal that displays the form fields.

image.png

Input the data for each field for the new entry and select the “Save” button. You will return to the Forms Table on the Home Page.

image.png

The new entry will be recorded, impacting the Entries Count displayed in the Forms Table.

How To: Add Forms to a Group

In order for forms to be placed into groups, form groups have to be created first.

How To: Add a Forms Group

To add a group in the Forms Module, select Groups on the Main Menu and go to the Manage Groups Page in the Forms Module.

image.png

Select the “New Group” button opening the New Group Modal. Input the name of the new group.

image.png

Select “Save” and the new group will now show in the Form Groups Table on the Manage Groups Page.

image.png

image.png

When groups have been added to the Forms Module, the Forms Table on the Home Page is broken into different sections for each group.

To place forms into groups, drag the form by the directional arrow to the left of the Form Title into the desired Group Table.

image.png

How To: Add Tags to a Form Entry

To add tags to a form entry, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form that you wish to edit an entry in. This opens the Form’s context menu. Select “Manage Entries” from the context menu opening the Entries for (FORM NAME) Page.

image.png

To the right of every Entry ID is a three-dot icon. Click the three-dot icon for the entry you wish to add tags to opening the Forms Entry context menu. Select “Tags”.

image.png

This opens the Tags for Entry Modal.

image.png

Add the tags you want to be associated with the specific form entry and select “Save”.

How To: Approve a Form Entry Pending Approval

To approve a form entry pending approval, go to the Home Page of the Forms Module.

image.png

Select “View Entry” from the Actions column of the Form Entries Pending Approval Table opening the view form entry modal.

image.png

Select the “Approve” button opening a confirmation modal that states, “Are you sure you want to approve this entry?”

image.png

Select “Confirm” and a confirmation modal states, “Approved”.

image.png

How To: Archive a Form

To Archive a form, it cannot be live. You must close the form first.

How To: Close a Form

To close a live form, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form that you wish to close. This opens the Form’s context menu. Select “Close Form”.

image.png

This opens the Close Form Confirmation Modal which states, “Are you sure you wish to close this form? Any draft entries will be deleted, and new entries will only be able to be added via manage entries.”

image.png

Select “Confirm” and an Update Status Modal appears stating, “The form is now closed.”

image.png

The status of the form will now show as closed in the Forms Table.

image.png


To archive a closed form, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form that you wish to archive. This opens the Form’s context menu. Select “Archive Form”.

image.png

Selecting “Archive Form” will open a confirmation modal stating, “Are you sure you wish to archive this form? Any draft entries will be deleted, no new entries will be added and the form will no longer be available to reference.”

image.png

Select “Confirm” and an Update Status Modal will appear.

image.png

Click the “Close” botton and return for the Forms Home Page. The form will no longer be visible on the Home Page.

How To: Bulk Edit/Delete Form Entries

To bulk edit form entries, go to the Home Page of the Forms Module. Click the three-dot icon to the right of the specific form you wish to bulk edit, opening the Form’s context menu. Select “Manage Entries”.

image.png

This opens the Manage Entries for (FORM NAME) Page. Select the “Enable Bulk Edit Mode” checkbox.

image.pngA “Delete Selected” button now appears. A checkbox also shows to the left of every Entry ID. Selecting checkboxes allows for the bulk deletion of entries.

Hovering the cursor over a specific field entry will show an edit icon. Click the edit icon and the form field will now open for edits. Click the disk icon for your changes to be saved by the system.

How To: Clear a PDF Cache

To clear the PDF cache, go to the Home Page of the Forms Module. Click the three-dot icon to the right of the form title opening the Forms Table context menu. Select “Clear PDF Cache”.

image.png

This opens the Clear PDF Cache Modal.

image.png

Select between two options: “Clear Only” or “Clear and Rebuild”. 

If you choose to clear and rebuild, the process can take time to complete if you have a lot of entries.

Select “Clear Now” and a confirmation modal will appear stating, “The cache has been cleared.”

image.png

How To: Close a Form

To close a live form, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form that you wish to close. This opens the Form’s context menu. Select “Close Form”.

image.png

This opens the Close Form Confirmation Modal which states, “Are you sure you wish to close this form? Any draft entries will be deleted, and new entries will only be able to be added via manage entries.”

image.png

Select “Confirm” and an Update Status Modal appears stating, “The form is now closed.”

image.png

The status of the form will now show as closed in the Forms Table.

image.png


How To: Convert a Database to a Form

To convert a database to a form,  go to the Home Page of the Forms Module. Select the “Convert Database to Form” button beneath the Manage Forms header.

When you convert a database to a form, the database will no longer be available in the Database Module and cannot be converted back to its original database form.

image.png

This will open the Convert Database to Form Modal.

image.png

All available databases will in a dropdown menu. Select the database you wish to convert to a form and click the “Convert” button. A confirmation modal will appear stating, “The database has been converted.”

image.png

The original database will now show as a form in the Forms Table on the Home Page.

image.png

How To: Copy a Form

To copy a form, go to the Home Page of the Forms Module and select the three dot icon to the right of the form title you wish to copy.

image.png

Select “Copy Form” from the context menu opening the Copy (FORM NAME) Modal.

image.png

Input the desired name for the newly copied Form and select “Copy”.

The copied form will now show on the Forms Home Page.

How To: Create a Form

To create a new form, open the Home Page in the Forms Module from the Main Menu and select the Create Form button beneath the page header.

image.png

This will open the New Form Modal.

image.png

Input the Form Title (a required field), form notes, and any open/permissive/restrictive tags to be associated with the form.

There are three additional sections to the New Form Modal that expand when clicked with additional options for customization. Modal images and explanations of each input are included below.

Basic Settings Section

image.png


New Form Modal: Basic Settings Section Explanation

Modal Input

Explanation

Group

A dropdown menu will list all existing form groups. The form will automatically be placed in the group selected.

Allow Public Entries Checkbox

If the checkbox is selected, public entries (individuals not registered with KAStrack) will be allowed to submit form entries.

URL Link

A URL Link is used to share the form publically. KAStrack will autofill the URL Link with the form title, but this can be customized if desired.


You cannot use spaces or symbols in the URL link. They will replaced with a hypen if used.

The next two checkboxes are specific to the PDF options for form entries that are not submitted via a PDF. To understand which option is better for this specific form, be sure to read about the relationship between PDFs and Forms.

Use KAStrack Generated PDF

If you have a PDF entry on file but do not want the downloaded form entry to utilize the customized PDF form, select this checkbox and KAStrack will use the generic PDF format.

Use the Appropriate Uploaded PDF Revision

If you have a PDF entry on file and want the downloaded form entry to utilize the customized PDF form, select this checkbox and KAStrack will use the most recent version of the PDF submitted.









Allow Integration With











Allow integrations with is a dropdown menu that lists all modules you can use a form for. Selecting a module here will enable this form to be visible in the modules selected. Possible uses are listed below.

Module

Purpose

Assets

Attach to Task

Attendance

Integrate with the Attendance Log Module

Datbase

Reference from Database

Dispatch

Include in a Dispatch

Documents

Add to Photo

Forms

Reference from a Form

Grid

Integrate with the Grid Module

Kanban

Integrate with the Kanban Module

People

Use as activity for certification

Advanced Settings Section

image.png


New Form Modal: Advanced Settings Section Explanation

Modal Inputs

Explanation

Allow Payment Checbox

(Expands when selected)

Payment Profile

Select “All Enabled Configurations” from the dropdown menu for payments to be allowed.

Payment Description

This description is what will show on a payment receipt.

Default Pattern for Entries

This textbox uses mail merge fields.



Allow the User to Save AS Draft Checkbox


(Expands when selected)


Allow Logged Out User to Save as a Draft

Selecting this checkbox will allow logged out users and public entries to save their response as a draft and come back to the form (on the same device).

Validate Fields when Saving as Draft

Fields with validation don’t validate on a draft, so inputting fields here tells the system to validate fields when the draft is saved.

Save Draft Button Text

The form creator can customize the text on the Save button.

Auto Save

When auto-save is enabled, any edits made to a field will automatically be saved. When auto-save is disabled, the information will only be saved when the save draft button is clicked.





Allow Default Access Checkbox





When Selected

The form will follow module level permissions in regards to what access an individual will have.

If allow default access is not selected, the additional form specific permissions are now required. The system will ignore module level distinctions for this form and will be guided by the form specific permissions listed below.

Admins

A checkbox allows for admins to be prohibited from viewing entries. Users or roles listed here will have admin level permissions for this form. This includes editing and deleting the form, managing the form fields and (unless prohibited) managing entries.

Manage Entry Permissions

Users or roles listed here have manage level permissions for this form. This includes adding, editing and deleting entries.

Manage Pending Approval Entry Permissions

Users or roles listed here can edit entries that are pending approval.

Show in the Dashboard Forms Widget

Users and certification roles selected here will show this form in the Dashboard Forms Module Summary Widget.

Form Styling Section

image.png


New Form Modal: Form Styling Section

Modal Inputs

Explanation

Save Button Text

Change the verbiage on the save button by inputting other text here.

Cancel Button Text

Change the verbiage on the cancel button by inputting other text here.

Submission Message

Change the verbiage on the form submission message by inputting other text here.

Show Green Checkmark Checkbox

Selecting the show green checkmark with submission message checkbox will show a green checkmark to the left of the submission message when a form is submitted.

Show the Form Title Checkbox

Select the Show the Form Title Checkbox will show the form title for a logged-out entry. This does not impact a system, modal based entry.



Apply Whole Form

SCSS to



Logged Out Only

Select “Logged Out Only” if the styling doesn’t correspond with a popup modal or the regular form page. This would result is SCSS styling only applies to public entries.

Logged In Only

Select “Logged In Only” if you only want to apply the SCSS formatting to the logged in, internal users.

Always

Selecting “Always” applies the SCSS formatting that has been established in both internal and external forms.

SCSS for Whole Form

This is the textbox where scripting language should be input, that allows for greater customization than what is generally available.

Select the Save button on the New Form Modal after customizing your form and the system will direct you to the form's Fields Tab where you can begin to input Form fields.

image.png

How To: Import Fields from a PDF Field Import

Importing fields from a PDF Field Import has multiple purposes. Not only will the form fields be generated through this process, the PDF will also be saved by the system, so that future form entries can be downloaded into this PDF, allowing for customizable outputs.

A form must have already been created with no fields added for this method to work. If a field has already been added to the form, you are no longer able to bulk import form field names from a PDF Field Import. You are now required to enter each field name individually. Regardless, you can still upload a PDF Form that the system will use for future form entry downloads.

How To: Create a Form

To create a new form, open the Home Page in the Forms Module from the Main Menu and select the Create Form button beneath the page header.

image.png

This will open the New Form Modal.

image.png

Input the Form Title (a required field), form notes, and any open/permissive/restrictive tags to be associated with the form.

There are three additional sections to the New Form Modal that expand when clicked with additional options for customization. Modal images and explanations of each input are included below.

Basic Settings Section

image.png


New Form Modal: Basic Settings Section Explanation

Modal Input

Explanation

Group

A dropdown menu will list all existing form groups. The form will automatically be placed in the group selected.

Allow Public Entries Checkbox

If the checkbox is selected, public entries (individuals not registered with KAStrack) will be allowed to submit form entries.

URL Link

A URL Link is used to share the form publically. KAStrack will autofill the URL Link with the form title, but this can be customized if desired.


You cannot use spaces or symbols in the URL link. They will replaced with a hypen if used.

The next two checkboxes are specific to the PDF options for form entries that are not submitted via a PDF. To understand which option is better for this specific form, be sure to read about the relationship between PDFs and Forms.

Use KAStrack Generated PDF

If you have a PDF entry on file but do not want the downloaded form entry to utilize the customized PDF form, select this checkbox and KAStrack will use the generic PDF format.

Use the Appropriate Uploaded PDF Revision

If you have a PDF entry on file and want the downloaded form entry to utilize the customized PDF form, select this checkbox and KAStrack will use the most recent version of the PDF submitted.









Allow Integration With











Allow integrations with is a dropdown menu that lists all modules you can use a form for. Selecting a module here will enable this form to be visible in the modules selected. Possible uses are listed below.

Module

Purpose

Assets

Attach to Task

Attendance

Integrate with the Attendance Log Module

Datbase

Reference from Database

Dispatch

Include in a Dispatch

Documents

Add to Photo

Forms

Reference from a Form

Grid

Integrate with the Grid Module

Kanban

Integrate with the Kanban Module

People

Use as activity for certification

Advanced Settings Section

image.png


New Form Modal: Advanced Settings Section Explanation

Modal Inputs

Explanation

Allow Payment Checbox

(Expands when selected)

Payment Profile

Select “All Enabled Configurations” from the dropdown menu for payments to be allowed.

Payment Description

This description is what will show on a payment receipt.

Default Pattern for Entries

This textbox uses mail merge fields.



Allow the User to Save AS Draft Checkbox


(Expands when selected)


Allow Logged Out User to Save as a Draft

Selecting this checkbox will allow logged out users and public entries to save their response as a draft and come back to the form (on the same device).

Validate Fields when Saving as Draft

Fields with validation don’t validate on a draft, so inputting fields here tells the system to validate fields when the draft is saved.

Save Draft Button Text

The form creator can customize the text on the Save button.

Auto Save

When auto-save is enabled, any edits made to a field will automatically be saved. When auto-save is disabled, the information will only be saved when the save draft button is clicked.





Allow Default Access Checkbox





When Selected

The form will follow module level permissions in regards to what access an individual will have.

If allow default access is not selected, the additional form specific permissions are now required. The system will ignore module level distinctions for this form and will be guided by the form specific permissions listed below.

Admins

A checkbox allows for admins to be prohibited from viewing entries. Users or roles listed here will have admin level permissions for this form. This includes editing and deleting the form, managing the form fields and (unless prohibited) managing entries.

Manage Entry Permissions

Users or roles listed here have manage level permissions for this form. This includes adding, editing and deleting entries.

Manage Pending Approval Entry Permissions

Users or roles listed here can edit entries that are pending approval.

Show in the Dashboard Forms Widget

Users and certification roles selected here will show this form in the Dashboard Forms Module Summary Widget.

Form Styling Section

image.png


New Form Modal: Form Styling Section

Modal Inputs

Explanation

Save Button Text

Change the verbiage on the save button by inputting other text here.

Cancel Button Text

Change the verbiage on the cancel button by inputting other text here.

Submission Message

Change the verbiage on the form submission message by inputting other text here.

Show Green Checkmark Checkbox

Selecting the show green checkmark with submission message checkbox will show a green checkmark to the left of the submission message when a form is submitted.

Show the Form Title Checkbox

Select the Show the Form Title Checkbox will show the form title for a logged-out entry. This does not impact a system, modal based entry.



Apply Whole Form

SCSS to



Logged Out Only

Select “Logged Out Only” if the styling doesn’t correspond with a popup modal or the regular form page. This would result is SCSS styling only applies to public entries.

Logged In Only

Select “Logged In Only” if you only want to apply the SCSS formatting to the logged in, internal users.

Always

Selecting “Always” applies the SCSS formatting that has been established in both internal and external forms.

SCSS for Whole Form

This is the textbox where scripting language should be input, that allows for greater customization than what is generally available.

Select the Save button on the New Form Modal after customizing your form and the system will direct you to the form's Fields Tab where you can begin to input Form fields.

image.png

How To: Import Fields from a PDF Field Import

{{@400}}

How To: Import Form Fields from a CSV File

{{@402}}

How To: Upload a PDF Form

{{@408}}


How To: Add a Field to a Form

To add a field to a form, go to the Home Page of the Forms Module. . Click the three-dot icon to the right of the form title that you want to add a field to opening the Form context menu. Select “Fields”.

image.png

This opens the Fields Tab for the specific form of interest.

There are two ways to add an individual field to the Fields Table from here. Click the “New Field” button opening the New Form Field Modal.

image.png

The creation of a new field will always require you to enter a field name. Include an input for the displayed label and select the field type from a dropdown menu. The inputs on the New Form Field Modal will vary based on the Field Type.

Possible field types in the Forms Module include Form Fields, Formatting Fields, Utility Fields, Account Fields, and Reference a Database Entry. For an explanation of field types and the formatting choices associated with each one, reference the Understanding Fields Section of the Forms Module in the User Manual.

A form field can only have on field type. If you need to utilize another (e.g., formatting purposes), you can set the displayed label to be the same but the field label must be unique.

Once you are finished inputting the information for the new field, select “Save” and the new database field will show in the Fields Table on the Fields Tab.

image.png

Fields can also be imported in bulk into a Form from a CSV file or PDF Field Import.

How To: Import Form Fields from a CSV File

{{@402}}

How To: Import Fields from a PDF Field Import

{{@400}}


How To: Upload a PDF Form

Uploading a PDF allows an individual to create a customized output for form entries. In order to do so, the PDF must be created on Adobe Acrobat Pro (or comparable software) and have made use of form fields.

A PDF can be created and uploaded after a form is in use, however no additional fields can be created at this time.

To upload a PDF form to be used for form entry outputs, go to the Home Page of the Forms Module. Click the three-dot icon to the right of the form title opening the context menu and select “Upload PDF”.

image.png

This will open the Upload PDF Form Modal.

image.png

Select “Choose File” to retrieve the PDF from your personal device.

Input a title for the PDF or select the clickable “Use Filename” link to have the system use the filename as the title. The revision date will automatically show the current day, but can be altered. Select the appropriate checkbox if the document is to be public, or if it is a 360 degree photo.

You can select individuals or certification roles as the document owner(s).

Select “Save” and a confirmation modal will appear stating, “File was uploaded.”

image.png


To import field names from a PDF file, go to the Home Page of the Forms Module.

Select the three-dot icon to the right of the Form Title opening the Form’s context menu. Select “Form”.

image.png

This opens the Fields Tab for a specific form. Select the “PDF Field Import” button.

image.png

This opens the PDF Field Import Modal.

image.png

To import fields using a PDF, use the “Prepare Form” tool in Adobe Acrobat Pro. Add the fields you wish to use for your form. Add a button on your document.

image.png

Within the button properties, click on the Actions Tab. On the “Mouse Down” trigger, add the “Submit a Form” Action.

image.png

Confirm that the Export Format is “PDF The complete document”.

image.png

Open the PDF and submit the form to generate the fields here.

You do not need to fill in any of the fields, and you must not sign it.

image.png

Select “Allow” and the PDF will confirm that the fields were added to the database.

image.png

Go to the Fields Table in the database Monday, and a warning now states that a PDF is associated with the form and that adding/editing or deleting fields may result in the PDF no longer being compatible.

How To: Import Form Fields from a CSV File

To import form entries from a CSV, form fields must have already been created.

How To: Add a Field to a Form

To add a field to a form, go to the Home Page of the Forms Module. . Click the three-dot icon to the right of the form title that you want to add a field to opening the Form context menu. Select “Fields”.

image.png

This opens the Fields Tab for the specific form of interest.

There are two ways to add an individual field to the Fields Table from here. Click the “New Field” button opening the New Form Field Modal.

image.png

The creation of a new field will always require you to enter a field name. Include an input for the displayed label and select the field type from a dropdown menu. The inputs on the New Form Field Modal will vary based on the Field Type.

Possible field types in the Forms Module include Form Fields, Formatting Fields, Utility Fields, Account Fields, and Reference a Database Entry. For an explanation of field types and the formatting choices associated with each one, reference the Understanding Fields Section of the Forms Module in the User Manual.

A form field can only have on field type. If you need to utilize another (e.g., formatting purposes), you can set the displayed label to be the same but the field label must be unique.

Once you are finished inputting the information for the new field, select “Save” and the new database field will show in the Fields Table on the Fields Tab.

image.png

Fields can also be imported in bulk into a Form from a CSV file or PDF Field Import.

How To: Import Form Fields from a CSV File

{{@402}}

How To: Import Fields from a PDF Field Import

{{@400}}


How To: Import Form Fields from a CSV File

To import form entries from a CSV, form fields must have already been created.

How To: Add a Field to a Form

{{@373}}

How To: Import Form Fields from a CSV File

{{@402}}

How To: Import Fields from a PDF Field Import

{{@400}}

To import form entries from a CSV, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form you wish to import entries into. Select “Manage Entries”.

image.png

This opens the Manage Entries for (FORM NAME) Page.

image.png

Click the “Import Entries” button beneath the page header. This opens the Upload CSV for (FORM NAME) Modal.

image.png

Click the “Download Template” link at the top of the modal and a CSV file will be downloaded to your personal device. Notes have been provided if you are using the downloadable template to Upload bulk CSV form entries.

Notes Regarding the Downloadable Template for Uploading CSV Files

The first row of the CSV file is for each of the form fields. If you download a CSV Template from the Upload CSV Modal, two additional column headers will show that are not form fields: Entry ID and Modify Existing Entry.

If you are importing form entries and no entries have been added to the form yet, leave these columns blank in your upload.

If form entries already exist in the database, the Entry ID column will contain the unique system generated ID for each pre-existing database entry. Leave this column blank if the row is to be imported as a new entry. The second column, Modify Existing Entry, should have a “Y” input if the existing entry is being modified and an “N” input if it has not been modified. Leave this column blank if the entry is new.

image.png

After creating your Forms Entries CSV file, save it as a CSV UTF-8 for importing. Click the “Choose File” button on the Upload CSV Modal and open the relevant file from your personal device.

image.png

Confirm that the correct CSV file now shows in the Upload CSV Modal.

image.png

Select the “Upload” button.

image.png

The entries imported from the CSV file will now show on the Upload CSV for (FORM NAME) Page.

The system automatically indicates to ignore the first row. Click “Import Now” if there are no errors.

A summary of the import will now show on the CSV Upload Page.

image.png

Click the “Entries for (FORM NAME)” link to see all imported entries on the Manage Entries Page.

How To: Import Fields from a PDF Field Import

Importing fields from a PDF Field Import has multiple purposes. Not only will the form fields be generated through this process, the PDF will also be saved by the system, so that future form entries can be downloaded into this PDF, allowing for customizable outputs.

A form must have already been created with no fields added for this method to work. If a field has already been added to the form, you are no longer able to bulk import form field names from a PDF Field Import. You are now required to enter each field name individually. Regardless, you can still upload a PDF Form that the system will use for future form entry downloads.

How To: Create a Form

{{@386}}

How To: Add a Field to a Form

{{@373}}

How To: Upload a PDF Form

{{@408}}

To import field names from a PDF file, go to the Home Page of the Forms Module.

Select the three-dot icon to the right of the Form Title opening the Form’s context menu. Select “Form”.

image.png

This opens the Fields Tab for a specific form. Select the “PDF Field Import” button.

image.png

This opens the PDF Field Import Modal.

image.png

To import fields using a PDF, use the “Prepare Form” tool in Adobe Acrobat Pro. Add the fields you wish to use for your form. Add a button on your document.

image.png

Within the button properties, click on the Actions Tab. On the “Mouse Down” trigger, add the “Submit a Form” Action.

image.png

Confirm that the Export Format is “PDF The complete document”.

image.png

Open the PDF and submit the form to generate the fields here.

You do not need to fill in any of the fields, and you must not sign it.

image.png

Select “Allow” and the PDF will confirm that the fields were added to the database.

image.png

Go to the Fields Table in the database Monday, and a warning now states that a PDF is associated with the form and that adding/editing or deleting fields may result in the PDF no longer being compatible.

To import form entries from a CSV, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form you wish to import entries into. Select “Manage Entries”.

image.png

This opens the Manage Entries for (FORM NAME) Page.

image.png

Click the “Import Entries” button beneath the page header. This opens the Upload CSV for (FORM NAME) Modal.

image.png

Click the “Download Template” link at the top of the modal and a CSV file will be downloaded to your personal device. Notes have been provided if you are using the downloadable template to Upload bulk CSV form entries.

Notes Regarding the Downloadable Template for Uploading CSV Files

The first row of the CSV file is for each of the form fields. If you download a CSV Template from the Upload CSV Modal, two additional column headers will show that are not form fields: Entry ID and Modify Existing Entry.

If you are importing form entries and no entries have been added to the form yet, leave these columns blank in your upload.

If form entries already exist in the database, the Entry ID column will contain the unique system generated ID for each pre-existing database entry. Leave this column blank if the row is to be imported as a new entry. The second column, Modify Existing Entry, should have a “Y” input if the existing entry is being modified and an “N” input if it has not been modified. Leave this column blank if the entry is new.

image.png

After creating your Forms Entries CSV file, save it as a CSV UTF-8 for importing. Click the “Choose File” button on the Upload CSV Modal and open the relevant file from your personal device.

image.png

Confirm that the correct CSV file now shows in the Upload CSV Modal.

image.png

Select the “Upload” button.

image.png

The entries imported from the CSV file will now show on the Upload CSV for (FORM NAME) Page.

The system automatically indicates to ignore the first row. Click “Import Now” if there are no errors.

A summary of the import will now show on the CSV Upload Page.

image.png

Click the “Entries for (FORM NAME)” link to see all imported entries on the Manage Entries Page.

How To: Upload a PDF Form

Uploading a PDF allows an individual to create a customized output for form entries. In order to do so, the PDF must be created on Adobe Acrobat Pro (or comparable software) and have made use of form fields.

A PDF can be created and uploaded after a form is in use, however no additional fields can be created at this time.

To upload a PDF form to be used for form entry outputs, go to the Home Page of the Forms Module. Click the three-dot icon to the right of the form title opening the context menu and select “Upload PDF”.

image.png

This will open the Upload PDF Form Modal.

image.png

Select “Choose File” to retrieve the PDF from your personal device.

Input a title for the PDF or select the clickable “Use Filename” link to have the system use the filename as the title. The revision date will automatically show the current day, but can be altered. Select the appropriate checkbox if the document is to be public, or if it is a 360 degree photo.

You can select individuals or certification roles as the document owner(s).

Select “Save” and a confirmation modal will appear stating, “File was uploaded.”

image.png



How To: Create a Form Aggregation

To create a form aggregation, go to the Forms Home Page and select the “Form Aggregation” button.

image.png

This opens the Form Aggregation Page.

image.png

Select the “Create Aggregation” button opening the New Form Aggregation Modal.

image.png

Input the form aggregation title, and any tags to be associated with the aggregation.

Select the reference form from the dropdown menu provided.

The reference form defines which fields will be used as column headers in the form aggregation report.

KAStrack will automatically input information to the Match Forms Regex Field, but it may not be the correct input for your aggregation. (Regex is way to match strings of text to other strings of text. The carrot symbol means “starts with.”) What follows the carrot symbol should be an identifier that would indicate the forms are related.

Contact KAStrack’s technical support team for additional guidance on setting up your aggregation if Regex is unclear.

If you do not want to add a date restriction, leave the restrict entries based on field dropdown menu blank. If you would like to restrict entries, you can do so by 1) including entries from on or after a specific date OR by 2) including entries from before a specific date.

image.png

Select “Save” and your aggregation will now show in the Form Aggregation Table.

How To: Create a New Form Field Rule

To add a form field rule, go to the Home Page of the Forms Module. Click the three dot icon to the right of the form title that you want to create a rule for opening the Form context menu. Select “Rules”.

image.png

This opens the Rules Tab containing the Rule Table.

If your form is already live, you will be asked to enable editing before you can add a new rule to your form.

image.png

After enabling editing (if required), select the “New Rule” button opening the New Form Rule Modal.

image.png

Input the Rule Name and Rule Status (both required fields).

Click the plus icon to the right of Conditions to add a condition to the rule, expanding the section for the input of the trigger, what must be true, and what happens if it is true.

image.png

Once the condition has been entered, select “Save” to return to the New Form Rule Modal.

image.png

The condition created will show in the modal.

As many conditions as desired can be entered, as well as none at all.

Click the plus sign to the right of Actions to add an action to the rule, expanding the section for the configuration of the action to be taken when the conditions are met.

Once the rule has been entered, select “Save” to return to the New Form Rule Modal. The action will now show in the modal.

image.png

Select “Save”. A popup will confirm that the rule was saved stating, “Rule was saved.”

image.png

The rule will now show in the Rules Table.

image.png

How To: Delete a Form

To delete a form, go to the Home Page of the Forms Module. Click the three dot (…) icon to the right of the form you want to delete to open the Form’s context menu.

image.png

Select “Delete Form” opening the Delete Form Confirmation Modal which displays the Form Title and states, “Are you sure you want to delete this Form? This will delete the form and all entries. This cannot be undone!”

image.png

Select “Delete” to confirm you wish to delete the form and a confirmation modal will appear stating “This Form has been deleted.”

How To: Delete a Form Entry

To delete a form entry, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form that you wish to delete an entry in. This opens the Form’s context menu. Select “Manage Entries” from the context menu opening the Entries for (FORM NAME) Page.

image.png

To the right of every Entry ID is a three-dot icon. Click the three-dot icon to the right of the entry you wish to delete opening the Forms Entry context menu. Select “Delete Entry”.

image.png

This opens the Delete Form Entry Confirmation Modal that states, “Are you sure you want to delete this Form Entry?”

image.png

Select “Delete” to confirm deletion of the form entry. A confirmation modal stating, “This form entry has been deleted,” appears.

image.png

The form entry no longer shows on the Manage Entries Page.

How To: Delete a Forms Group

To delete a group in the Forms Module, select Groups on the Main Menu and go to the Manage Groups Page in the Forms Module. Click the three-dot icon to the right of the forms group you wish to delete opening the form group context menu.

image.png

Select “Delete Group” opening the Delete Group Confirmation Modal which states, “Are you sure you want to delete this Group?” and includes the group name.

image.png

Select “Delete” and a confirmation modal will confirm “This group has been deleted.”

image.png

The group name will no longer show on the Form Groups Table.

How To: Delete All Testing Entries

To delete all entries made while a form is in Preview Mode, go to the Home Page of the Forms Module and select the three dot icon to the right of the form title you wish to delete entries in.

A form must be in preview mode to bulk delete existing entries.

image.png

Select “Delete All Entries” from the context menu opening the Deletion Confirmation Modal.

image.png

The modal states, “Are you sure you wish to delete all entries from form (FORM NAME)? Any sequential number fields will be reset. Entries linked to object from other modules will also be deleted. This cannot be undone.”

Click the “OK” button and the Delete All Entries Modal stating “All entries have been deleted” appears.

image.png

Click the “Close” button and return to the Forms Module Home Page.

image.png

The Forms Table will now show that there are 0 entries associated with the Form.

How To: Download a PDF Form

While this option will show on the context menu, you can only download a PDF if a PDF has been associated with the specific form selected.

To download a specific form PDF, go to the Home Page of the Forms Module and click the three-dot icon to the right of the Form Title opening the Form Table context menu.

image.png

Select “Download PDF” and the form pdf will automatically be downloaded to your personal device.

image.png

The download will show all form fields without any entry information being input.

How To: Edit a Form

To edit a form, go to the Home Page in the Forms Module. Click the three-dot icon to the right of the form you wish to edit opening the specific form’s context menu. Select “Edit Form”.

image.png

This opens the “Edit Form Modal”.

image.png

The title, tags, groups, and modules for integration can be altered from this modal, as well as advanced settings and form styling. A detailed explanation of these options can be found in the explanation of how to create a form.

How To: Create a Form

To create a new form, open the Home Page in the Forms Module from the Main Menu and select the Create Form button beneath the page header.

image.png

This will open the New Form Modal.

image.png

Input the Form Title (a required field), form notes, and any open/permissive/restrictive tags to be associated with the form.

There are three additional sections to the New Form Modal that expand when clicked with additional options for customization. Modal images and explanations of each input are included below.

Basic Settings Section

image.png


New Form Modal: Basic Settings Section Explanation

Modal Input

Explanation

Group

A dropdown menu will list all existing form groups. The form will automatically be placed in the group selected.

Allow Public Entries Checkbox

If the checkbox is selected, public entries (individuals not registered with KAStrack) will be allowed to submit form entries.

URL Link

A URL Link is used to share the form publically. KAStrack will autofill the URL Link with the form title, but this can be customized if desired.


You cannot use spaces or symbols in the URL link. They will replaced with a hypen if used.

The next two checkboxes are specific to the PDF options for form entries that are not submitted via a PDF. To understand which option is better for this specific form, be sure to read about the relationship between PDFs and Forms.

Use KAStrack Generated PDF

If you have a PDF entry on file but do not want the downloaded form entry to utilize the customized PDF form, select this checkbox and KAStrack will use the generic PDF format.

Use the Appropriate Uploaded PDF Revision

If you have a PDF entry on file and want the downloaded form entry to utilize the customized PDF form, select this checkbox and KAStrack will use the most recent version of the PDF submitted.









Allow Integration With











Allow integrations with is a dropdown menu that lists all modules you can use a form for. Selecting a module here will enable this form to be visible in the modules selected. Possible uses are listed below.

Module

Purpose

Assets

Attach to Task

Attendance

Integrate with the Attendance Log Module

Datbase

Reference from Database

Dispatch

Include in a Dispatch

Documents

Add to Photo

Forms

Reference from a Form

Grid

Integrate with the Grid Module

Kanban

Integrate with the Kanban Module

People

Use as activity for certification

Advanced Settings Section

image.png


New Form Modal: Advanced Settings Section Explanation

Modal Inputs

Explanation

Allow Payment Checbox

(Expands when selected)

Payment Profile

Select “All Enabled Configurations” from the dropdown menu for payments to be allowed.

Payment Description

This description is what will show on a payment receipt.

Default Pattern for Entries

This textbox uses mail merge fields.



Allow the User to Save AS Draft Checkbox


(Expands when selected)


Allow Logged Out User to Save as a Draft

Selecting this checkbox will allow logged out users and public entries to save their response as a draft and come back to the form (on the same device).

Validate Fields when Saving as Draft

Fields with validation don’t validate on a draft, so inputting fields here tells the system to validate fields when the draft is saved.

Save Draft Button Text

The form creator can customize the text on the Save button.

Auto Save

When auto-save is enabled, any edits made to a field will automatically be saved. When auto-save is disabled, the information will only be saved when the save draft button is clicked.





Allow Default Access Checkbox





When Selected

The form will follow module level permissions in regards to what access an individual will have.

If allow default access is not selected, the additional form specific permissions are now required. The system will ignore module level distinctions for this form and will be guided by the form specific permissions listed below.

Admins

A checkbox allows for admins to be prohibited from viewing entries. Users or roles listed here will have admin level permissions for this form. This includes editing and deleting the form, managing the form fields and (unless prohibited) managing entries.

Manage Entry Permissions

Users or roles listed here have manage level permissions for this form. This includes adding, editing and deleting entries.

Manage Pending Approval Entry Permissions

Users or roles listed here can edit entries that are pending approval.

Show in the Dashboard Forms Widget

Users and certification roles selected here will show this form in the Dashboard Forms Module Summary Widget.

Form Styling Section

image.png


New Form Modal: Form Styling Section

Modal Inputs

Explanation

Save Button Text

Change the verbiage on the save button by inputting other text here.

Cancel Button Text

Change the verbiage on the cancel button by inputting other text here.

Submission Message

Change the verbiage on the form submission message by inputting other text here.

Show Green Checkmark Checkbox

Selecting the show green checkmark with submission message checkbox will show a green checkmark to the left of the submission message when a form is submitted.

Show the Form Title Checkbox

Select the Show the Form Title Checkbox will show the form title for a logged-out entry. This does not impact a system, modal based entry.



Apply Whole Form

SCSS to



Logged Out Only

Select “Logged Out Only” if the styling doesn’t correspond with a popup modal or the regular form page. This would result is SCSS styling only applies to public entries.

Logged In Only

Select “Logged In Only” if you only want to apply the SCSS formatting to the logged in, internal users.

Always

Selecting “Always” applies the SCSS formatting that has been established in both internal and external forms.

SCSS for Whole Form

This is the textbox where scripting language should be input, that allows for greater customization than what is generally available.

Select the Save button on the New Form Modal after customizing your form and the system will direct you to the form's Fields Tab where you can begin to input Form fields.

image.png

How To: Import Fields from a PDF Field Import

Importing fields from a PDF Field Import has multiple purposes. Not only will the form fields be generated through this process, the PDF will also be saved by the system, so that future form entries can be downloaded into this PDF, allowing for customizable outputs.

A form must have already been created with no fields added for this method to work. If a field has already been added to the form, you are no longer able to bulk import form field names from a PDF Field Import. You are now required to enter each field name individually. Regardless, you can still upload a PDF Form that the system will use for future form entry downloads.

How To: Create a Form

{{@386}}

How To: Add a Field to a Form

{{@373}}

How To: Upload a PDF Form

{{@408}}

To import field names from a PDF file, go to the Home Page of the Forms Module.

Select the three-dot icon to the right of the Form Title opening the Form’s context menu. Select “Form”.

image.png

This opens the Fields Tab for a specific form. Select the “PDF Field Import” button.

image.png

This opens the PDF Field Import Modal.

image.png

To import fields using a PDF, use the “Prepare Form” tool in Adobe Acrobat Pro. Add the fields you wish to use for your form. Add a button on your document.

image.png

Within the button properties, click on the Actions Tab. On the “Mouse Down” trigger, add the “Submit a Form” Action.

image.png

Confirm that the Export Format is “PDF The complete document”.

image.png

Open the PDF and submit the form to generate the fields here.

You do not need to fill in any of the fields, and you must not sign it.

image.png

Select “Allow” and the PDF will confirm that the fields were added to the database.

image.png

Go to the Fields Table in the database Monday, and a warning now states that a PDF is associated with the form and that adding/editing or deleting fields may result in the PDF no longer being compatible.

How To: Import Form Fields from a CSV File

To import form entries from a CSV, form fields must have already been created.

How To: Add a Field to a Form

{{@373}}

How To: Import Form Fields from a CSV File

{{@402}}

How To: Import Fields from a PDF Field Import

{{@400}}

To import form entries from a CSV, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form you wish to import entries into. Select “Manage Entries”.

image.png

This opens the Manage Entries for (FORM NAME) Page.

image.png

Click the “Import Entries” button beneath the page header. This opens the Upload CSV for (FORM NAME) Modal.

image.png

Click the “Download Template” link at the top of the modal and a CSV file will be downloaded to your personal device. Notes have been provided if you are using the downloadable template to Upload bulk CSV form entries.

Notes Regarding the Downloadable Template for Uploading CSV Files

The first row of the CSV file is for each of the form fields. If you download a CSV Template from the Upload CSV Modal, two additional column headers will show that are not form fields: Entry ID and Modify Existing Entry.

If you are importing form entries and no entries have been added to the form yet, leave these columns blank in your upload.

If form entries already exist in the database, the Entry ID column will contain the unique system generated ID for each pre-existing database entry. Leave this column blank if the row is to be imported as a new entry. The second column, Modify Existing Entry, should have a “Y” input if the existing entry is being modified and an “N” input if it has not been modified. Leave this column blank if the entry is new.

image.png

After creating your Forms Entries CSV file, save it as a CSV UTF-8 for importing. Click the “Choose File” button on the Upload CSV Modal and open the relevant file from your personal device.

image.png

Confirm that the correct CSV file now shows in the Upload CSV Modal.

image.png

Select the “Upload” button.

image.png

The entries imported from the CSV file will now show on the Upload CSV for (FORM NAME) Page.

The system automatically indicates to ignore the first row. Click “Import Now” if there are no errors.

A summary of the import will now show on the CSV Upload Page.

image.png

Click the “Entries for (FORM NAME)” link to see all imported entries on the Manage Entries Page.

How To: Upload a PDF Form

Uploading a PDF allows an individual to create a customized output for form entries. In order to do so, the PDF must be created on Adobe Acrobat Pro (or comparable software) and have made use of form fields.

A PDF can be created and uploaded after a form is in use, however no additional fields can be created at this time.

To upload a PDF form to be used for form entry outputs, go to the Home Page of the Forms Module. Click the three-dot icon to the right of the form title opening the context menu and select “Upload PDF”.

image.png

This will open the Upload PDF Form Modal.

image.png

Select “Choose File” to retrieve the PDF from your personal device.

Input a title for the PDF or select the clickable “Use Filename” link to have the system use the filename as the title. The revision date will automatically show the current day, but can be altered. Select the appropriate checkbox if the document is to be public, or if it is a 360 degree photo.

You can select individuals or certification roles as the document owner(s).

Select “Save” and a confirmation modal will appear stating, “File was uploaded.”

image.png



Confirm you wish to edit the form by clicking the “Save” button. Selecting “Cancel” will return you to the Forms Home Page.

How To: Edit a Form Entry

To edit a form entry, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form that you wish to edit an entry in. This opens the Form’s context menu. Select “Manage Entries” from the context menu opening the Entries for (FORM NAME) Page.

image.png

To the right of every Entry ID is a three-dot icon. Click the three-dot icon for the entry you wish to edit opening the Forms Entry Context Menu. Select “Edit Entry”.

image.png

Selecting “Edit Entry” from the Forms Entry Table opens the Edit Form Entry Modal.

image.png

Make changes as desired to edit the entry and select the “Save” button.

Your edits will now show in the Forms Entry Table.

How To: Edit a Form Entry Pending Approval

Anyone can edit a form entry if they have the permission to edit entries, regardless of the approval requirements.

To edit a form entry pending approval, go to the Home Page of the Forms Module.

image.png

Select “View Entry” from the Actions column of the Form Entries Pending Approval Table opening the view form entry modal.

image.png

Select the “Edit” button opening the Edit Form Entry Modal.

Make any necessary edits to the entry in the modal and select “Save” when done.

How To: Edit a Forms Group

To edit a group in the Forms Module, select Groups on the Main Menu and go to the Manage Groups Page in the Forms Module. Click the three-dot icon to the right of the forms group you wish to edit opening the form group context menu.

image.png

Select “Edit Group” opening the Edit Group Modal.

image.png

Edit the group name as desired and select “Save” when done.

The name change will now be reflected in title on the Form Groups Table.

How To: Edit the Status of a Form Rule

To change the status of a form rule, go to the Home Page in the Forms Module. Click the three dot icon to the right of the form title that you want to create a rule for opening the Form context menu. Select “Rules”.

image.png

This opens the Rules Tab containing the Rule Table.

If your form is already live, you will be asked to enable editing before you can add a new rule to your form.

image.png

After enabling editing (if required), you will be able to change the status of the rule.

image.png

To the right of a rule’s status is an icon. Click the slider bar icon and it will change the inactive status to active (and vice versa).

image.png

How To: Export Form Entries

To export form entries, go to the Forms Table on the Home Page of the Forms Module. Click the three-dot icon to the right of the title of the form from which you wish to export all entries opening the Forms Table context menu. Select “Manage Entries”.

image.png

This opens the Manage Entries Page for the specific form of interest. Select the “Export Entries” button under the Entries Page header.

image.png

This automatically downloads a CSV file that can be accessed from the downloads folder on your personal device.

How To: Import Fields from a PDF Field Import

Importing fields from a PDF Field Import has multiple purposes. Not only will the form fields be generated through this process, the PDF will also be saved by the system, so that future form entries can be downloaded into this PDF, allowing for customizable outputs.

A form must have already been created with no fields added for this method to work. If a field has already been added to the form, you are no longer able to bulk import form field names from a PDF Field Import. You are now required to enter each field name individually. Regardless, you can still upload a PDF Form that the system will use for future form entry downloads.

How To: Create a Form

To create a new form, open the Home Page in the Forms Module from the Main Menu and select the Create Form button beneath the page header.

image.png

This will open the New Form Modal.

image.png

Input the Form Title (a required field), form notes, and any open/permissive/restrictive tags to be associated with the form.

There are three additional sections to the New Form Modal that expand when clicked with additional options for customization. Modal images and explanations of each input are included below.

Basic Settings Section

image.png


New Form Modal: Basic Settings Section Explanation

Modal Input

Explanation

Group

A dropdown menu will list all existing form groups. The form will automatically be placed in the group selected.

Allow Public Entries Checkbox

If the checkbox is selected, public entries (individuals not registered with KAStrack) will be allowed to submit form entries.

URL Link

A URL Link is used to share the form publically. KAStrack will autofill the URL Link with the form title, but this can be customized if desired.


You cannot use spaces or symbols in the URL link. They will replaced with a hypen if used.

The next two checkboxes are specific to the PDF options for form entries that are not submitted via a PDF. To understand which option is better for this specific form, be sure to read about the relationship between PDFs and Forms.

Use KAStrack Generated PDF

If you have a PDF entry on file but do not want the downloaded form entry to utilize the customized PDF form, select this checkbox and KAStrack will use the generic PDF format.

Use the Appropriate Uploaded PDF Revision

If you have a PDF entry on file and want the downloaded form entry to utilize the customized PDF form, select this checkbox and KAStrack will use the most recent version of the PDF submitted.









Allow Integration With











Allow integrations with is a dropdown menu that lists all modules you can use a form for. Selecting a module here will enable this form to be visible in the modules selected. Possible uses are listed below.

Module

Purpose

Assets

Attach to Task

Attendance

Integrate with the Attendance Log Module

Datbase

Reference from Database

Dispatch

Include in a Dispatch

Documents

Add to Photo

Forms

Reference from a Form

Grid

Integrate with the Grid Module

Kanban

Integrate with the Kanban Module

People

Use as activity for certification

Advanced Settings Section

image.png


New Form Modal: Advanced Settings Section Explanation

Modal Inputs

Explanation

Allow Payment Checbox

(Expands when selected)

Payment Profile

Select “All Enabled Configurations” from the dropdown menu for payments to be allowed.

Payment Description

This description is what will show on a payment receipt.

Default Pattern for Entries

This textbox uses mail merge fields.



Allow the User to Save AS Draft Checkbox


(Expands when selected)


Allow Logged Out User to Save as a Draft

Selecting this checkbox will allow logged out users and public entries to save their response as a draft and come back to the form (on the same device).

Validate Fields when Saving as Draft

Fields with validation don’t validate on a draft, so inputting fields here tells the system to validate fields when the draft is saved.

Save Draft Button Text

The form creator can customize the text on the Save button.

Auto Save

When auto-save is enabled, any edits made to a field will automatically be saved. When auto-save is disabled, the information will only be saved when the save draft button is clicked.





Allow Default Access Checkbox





When Selected

The form will follow module level permissions in regards to what access an individual will have.

If allow default access is not selected, the additional form specific permissions are now required. The system will ignore module level distinctions for this form and will be guided by the form specific permissions listed below.

Admins

A checkbox allows for admins to be prohibited from viewing entries. Users or roles listed here will have admin level permissions for this form. This includes editing and deleting the form, managing the form fields and (unless prohibited) managing entries.

Manage Entry Permissions

Users or roles listed here have manage level permissions for this form. This includes adding, editing and deleting entries.

Manage Pending Approval Entry Permissions

Users or roles listed here can edit entries that are pending approval.

Show in the Dashboard Forms Widget

Users and certification roles selected here will show this form in the Dashboard Forms Module Summary Widget.

Form Styling Section

image.png


New Form Modal: Form Styling Section

Modal Inputs

Explanation

Save Button Text

Change the verbiage on the save button by inputting other text here.

Cancel Button Text

Change the verbiage on the cancel button by inputting other text here.

Submission Message

Change the verbiage on the form submission message by inputting other text here.

Show Green Checkmark Checkbox

Selecting the show green checkmark with submission message checkbox will show a green checkmark to the left of the submission message when a form is submitted.

Show the Form Title Checkbox

Select the Show the Form Title Checkbox will show the form title for a logged-out entry. This does not impact a system, modal based entry.



Apply Whole Form

SCSS to



Logged Out Only

Select “Logged Out Only” if the styling doesn’t correspond with a popup modal or the regular form page. This would result is SCSS styling only applies to public entries.

Logged In Only

Select “Logged In Only” if you only want to apply the SCSS formatting to the logged in, internal users.

Always

Selecting “Always” applies the SCSS formatting that has been established in both internal and external forms.

SCSS for Whole Form

This is the textbox where scripting language should be input, that allows for greater customization than what is generally available.

Select the Save button on the New Form Modal after customizing your form and the system will direct you to the form's Fields Tab where you can begin to input Form fields.

image.png

How To: Import Fields from a PDF Field Import

Importing fields from a PDF Field Import has multiple purposes. Not only will the form fields be generated through this process, the PDF will also be saved by the system, so that future form entries can be downloaded into this PDF, allowing for customizable outputs.

A form must have already been created with no fields added for this method to work. If a field has already been added to the form, you are no longer able to bulk import form field names from a PDF Field Import. You are now required to enter each field name individually. Regardless, you can still upload a PDF Form that the system will use for future form entry downloads.

How To: Create a Form

{{@386}}

How To: Add a Field to a Form

{{@373}}

How To: Upload a PDF Form

{{@408}}

To import field names from a PDF file, go to the Home Page of the Forms Module.

Select the three-dot icon to the right of the Form Title opening the Form’s context menu. Select “Form”.

image.png

This opens the Fields Tab for a specific form. Select the “PDF Field Import” button.

image.png

This opens the PDF Field Import Modal.

image.png

To import fields using a PDF, use the “Prepare Form” tool in Adobe Acrobat Pro. Add the fields you wish to use for your form. Add a button on your document.

image.png

Within the button properties, click on the Actions Tab. On the “Mouse Down” trigger, add the “Submit a Form” Action.

image.png

Confirm that the Export Format is “PDF The complete document”.

image.png

Open the PDF and submit the form to generate the fields here.

You do not need to fill in any of the fields, and you must not sign it.

image.png

Select “Allow” and the PDF will confirm that the fields were added to the database.

image.png

Go to the Fields Table in the database Monday, and a warning now states that a PDF is associated with the form and that adding/editing or deleting fields may result in the PDF no longer being compatible.

How To: Import Form Fields from a CSV File

To import form entries from a CSV, form fields must have already been created.

How To: Add a Field to a Form

{{@373}}

How To: Import Form Fields from a CSV File

{{@402}}

How To: Import Fields from a PDF Field Import

{{@400}}

To import form entries from a CSV, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form you wish to import entries into. Select “Manage Entries”.

image.png

This opens the Manage Entries for (FORM NAME) Page.

image.png

Click the “Import Entries” button beneath the page header. This opens the Upload CSV for (FORM NAME) Modal.

image.png

Click the “Download Template” link at the top of the modal and a CSV file will be downloaded to your personal device. Notes have been provided if you are using the downloadable template to Upload bulk CSV form entries.

Notes Regarding the Downloadable Template for Uploading CSV Files

The first row of the CSV file is for each of the form fields. If you download a CSV Template from the Upload CSV Modal, two additional column headers will show that are not form fields: Entry ID and Modify Existing Entry.

If you are importing form entries and no entries have been added to the form yet, leave these columns blank in your upload.

If form entries already exist in the database, the Entry ID column will contain the unique system generated ID for each pre-existing database entry. Leave this column blank if the row is to be imported as a new entry. The second column, Modify Existing Entry, should have a “Y” input if the existing entry is being modified and an “N” input if it has not been modified. Leave this column blank if the entry is new.

image.png

After creating your Forms Entries CSV file, save it as a CSV UTF-8 for importing. Click the “Choose File” button on the Upload CSV Modal and open the relevant file from your personal device.

image.png

Confirm that the correct CSV file now shows in the Upload CSV Modal.

image.png

Select the “Upload” button.

image.png

The entries imported from the CSV file will now show on the Upload CSV for (FORM NAME) Page.

The system automatically indicates to ignore the first row. Click “Import Now” if there are no errors.

A summary of the import will now show on the CSV Upload Page.

image.png

Click the “Entries for (FORM NAME)” link to see all imported entries on the Manage Entries Page.

How To: Upload a PDF Form

Uploading a PDF allows an individual to create a customized output for form entries. In order to do so, the PDF must be created on Adobe Acrobat Pro (or comparable software) and have made use of form fields.

A PDF can be created and uploaded after a form is in use, however no additional fields can be created at this time.

To upload a PDF form to be used for form entry outputs, go to the Home Page of the Forms Module. Click the three-dot icon to the right of the form title opening the context menu and select “Upload PDF”.

image.png

This will open the Upload PDF Form Modal.

image.png

Select “Choose File” to retrieve the PDF from your personal device.

Input a title for the PDF or select the clickable “Use Filename” link to have the system use the filename as the title. The revision date will automatically show the current day, but can be altered. Select the appropriate checkbox if the document is to be public, or if it is a 360 degree photo.

You can select individuals or certification roles as the document owner(s).

Select “Save” and a confirmation modal will appear stating, “File was uploaded.”

image.png



How To: Add a Field to a Form

To add a field to a form, go to the Home Page of the Forms Module. . Click the three-dot icon to the right of the form title that you want to add a field to opening the Form context menu. Select “Fields”.

image.png

This opens the Fields Tab for the specific form of interest.

There are two ways to add an individual field to the Fields Table from here. Click the “New Field” button opening the New Form Field Modal.

image.png

The creation of a new field will always require you to enter a field name. Include an input for the displayed label and select the field type from a dropdown menu. The inputs on the New Form Field Modal will vary based on the Field Type.

Possible field types in the Forms Module include Form Fields, Formatting Fields, Utility Fields, Account Fields, and Reference a Database Entry. For an explanation of field types and the formatting choices associated with each one, reference the Understanding Fields Section of the Forms Module in the User Manual.

A form field can only have on field type. If you need to utilize another (e.g., formatting purposes), you can set the displayed label to be the same but the field label must be unique.

Once you are finished inputting the information for the new field, select “Save” and the new database field will show in the Fields Table on the Fields Tab.

image.png

Fields can also be imported in bulk into a Form from a CSV file or PDF Field Import.

How To: Import Form Fields from a CSV File

To import form entries from a CSV, form fields must have already been created.

How To: Add a Field to a Form

{{@373}}

How To: Import Form Fields from a CSV File

{{@402}}

How To: Import Fields from a PDF Field Import

{{@400}}

To import form entries from a CSV, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form you wish to import entries into. Select “Manage Entries”.

image.png

This opens the Manage Entries for (FORM NAME) Page.

image.png

Click the “Import Entries” button beneath the page header. This opens the Upload CSV for (FORM NAME) Modal.

image.png

Click the “Download Template” link at the top of the modal and a CSV file will be downloaded to your personal device. Notes have been provided if you are using the downloadable template to Upload bulk CSV form entries.

Notes Regarding the Downloadable Template for Uploading CSV Files

The first row of the CSV file is for each of the form fields. If you download a CSV Template from the Upload CSV Modal, two additional column headers will show that are not form fields: Entry ID and Modify Existing Entry.

If you are importing form entries and no entries have been added to the form yet, leave these columns blank in your upload.

If form entries already exist in the database, the Entry ID column will contain the unique system generated ID for each pre-existing database entry. Leave this column blank if the row is to be imported as a new entry. The second column, Modify Existing Entry, should have a “Y” input if the existing entry is being modified and an “N” input if it has not been modified. Leave this column blank if the entry is new.

image.png

After creating your Forms Entries CSV file, save it as a CSV UTF-8 for importing. Click the “Choose File” button on the Upload CSV Modal and open the relevant file from your personal device.

image.png

Confirm that the correct CSV file now shows in the Upload CSV Modal.

image.png

Select the “Upload” button.

image.png

The entries imported from the CSV file will now show on the Upload CSV for (FORM NAME) Page.

The system automatically indicates to ignore the first row. Click “Import Now” if there are no errors.

A summary of the import will now show on the CSV Upload Page.

image.png

Click the “Entries for (FORM NAME)” link to see all imported entries on the Manage Entries Page.

How To: Import Fields from a PDF Field Import

Importing fields from a PDF Field Import has multiple purposes. Not only will the form fields be generated through this process, the PDF will also be saved by the system, so that future form entries can be downloaded into this PDF, allowing for customizable outputs.

A form must have already been created with no fields added for this method to work. If a field has already been added to the form, you are no longer able to bulk import form field names from a PDF Field Import. You are now required to enter each field name individually. Regardless, you can still upload a PDF Form that the system will use for future form entry downloads.

How To: Create a Form

{{@386}}

How To: Add a Field to a Form

{{@373}}

How To: Upload a PDF Form

{{@408}}

To import field names from a PDF file, go to the Home Page of the Forms Module.

Select the three-dot icon to the right of the Form Title opening the Form’s context menu. Select “Form”.

image.png

This opens the Fields Tab for a specific form. Select the “PDF Field Import” button.

image.png

This opens the PDF Field Import Modal.

image.png

To import fields using a PDF, use the “Prepare Form” tool in Adobe Acrobat Pro. Add the fields you wish to use for your form. Add a button on your document.

image.png

Within the button properties, click on the Actions Tab. On the “Mouse Down” trigger, add the “Submit a Form” Action.

image.png

Confirm that the Export Format is “PDF The complete document”.

image.png

Open the PDF and submit the form to generate the fields here.

You do not need to fill in any of the fields, and you must not sign it.

image.png

Select “Allow” and the PDF will confirm that the fields were added to the database.

image.png

Go to the Fields Table in the database Monday, and a warning now states that a PDF is associated with the form and that adding/editing or deleting fields may result in the PDF no longer being compatible.


How To: Upload a PDF Form

Uploading a PDF allows an individual to create a customized output for form entries. In order to do so, the PDF must be created on Adobe Acrobat Pro (or comparable software) and have made use of form fields.

A PDF can be created and uploaded after a form is in use, however no additional fields can be created at this time.

To upload a PDF form to be used for form entry outputs, go to the Home Page of the Forms Module. Click the three-dot icon to the right of the form title opening the context menu and select “Upload PDF”.

image.png

This will open the Upload PDF Form Modal.

image.png

Select “Choose File” to retrieve the PDF from your personal device.

Input a title for the PDF or select the clickable “Use Filename” link to have the system use the filename as the title. The revision date will automatically show the current day, but can be altered. Select the appropriate checkbox if the document is to be public, or if it is a 360 degree photo.

You can select individuals or certification roles as the document owner(s).

Select “Save” and a confirmation modal will appear stating, “File was uploaded.”

image.png


To import field names from a PDF file, go to the Home Page of the Forms Module.

Select the three-dot icon to the right of the Form Title opening the Form’s context menu. Select “Form”.

image.png

This opens the Fields Tab for a specific form. Select the “PDF Field Import” button.

image.png

This opens the PDF Field Import Modal.

image.png

To import fields using a PDF, use the “Prepare Form” tool in Adobe Acrobat Pro. Add the fields you wish to use for your form. Add a button on your document.

image.png

Within the button properties, click on the Actions Tab. On the “Mouse Down” trigger, add the “Submit a Form” Action.

image.png

Confirm that the Export Format is “PDF The complete document”.

image.png

Open the PDF and submit the form to generate the fields here.

You do not need to fill in any of the fields, and you must not sign it.

image.png

Select “Allow” and the PDF will confirm that the fields were added to the database.

image.png

Go to the Fields Table in the database Monday, and a warning now states that a PDF is associated with the form and that adding/editing or deleting fields may result in the PDF no longer being compatible.

How To: Import Form Entries from a CSV

If a field has already been added to a form, you are no longer able to bulk import form field names from a CSV file. You are now required to enter each field name individually.

How To: Add a Field to a Form

To add a field to a form, go to the Home Page of the Forms Module. . Click the three-dot icon to the right of the form title that you want to add a field to opening the Form context menu. Select “Fields”.

image.png

This opens the Fields Tab for the specific form of interest.

There are two ways to add an individual field to the Fields Table from here. Click the “New Field” button opening the New Form Field Modal.

image.png

The creation of a new field will always require you to enter a field name. Include an input for the displayed label and select the field type from a dropdown menu. The inputs on the New Form Field Modal will vary based on the Field Type.

Possible field types in the Forms Module include Form Fields, Formatting Fields, Utility Fields, Account Fields, and Reference a Database Entry. For an explanation of field types and the formatting choices associated with each one, reference the Understanding Fields Section of the Forms Module in the User Manual.

A form field can only have on field type. If you need to utilize another (e.g., formatting purposes), you can set the displayed label to be the same but the field label must be unique.

Once you are finished inputting the information for the new field, select “Save” and the new database field will show in the Fields Table on the Fields Tab.

image.png

Fields can also be imported in bulk into a Form from a CSV file or PDF Field Import.

How To: Import Form Fields from a CSV File

To import form entries from a CSV, form fields must have already been created.

How To: Add a Field to a Form

{{@373}}

How To: Import Form Fields from a CSV File

{{@402}}

How To: Import Fields from a PDF Field Import

{{@400}}

To import form entries from a CSV, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form you wish to import entries into. Select “Manage Entries”.

image.png

This opens the Manage Entries for (FORM NAME) Page.

image.png

Click the “Import Entries” button beneath the page header. This opens the Upload CSV for (FORM NAME) Modal.

image.png

Click the “Download Template” link at the top of the modal and a CSV file will be downloaded to your personal device. Notes have been provided if you are using the downloadable template to Upload bulk CSV form entries.

Notes Regarding the Downloadable Template for Uploading CSV Files

The first row of the CSV file is for each of the form fields. If you download a CSV Template from the Upload CSV Modal, two additional column headers will show that are not form fields: Entry ID and Modify Existing Entry.

If you are importing form entries and no entries have been added to the form yet, leave these columns blank in your upload.

If form entries already exist in the database, the Entry ID column will contain the unique system generated ID for each pre-existing database entry. Leave this column blank if the row is to be imported as a new entry. The second column, Modify Existing Entry, should have a “Y” input if the existing entry is being modified and an “N” input if it has not been modified. Leave this column blank if the entry is new.

image.png

After creating your Forms Entries CSV file, save it as a CSV UTF-8 for importing. Click the “Choose File” button on the Upload CSV Modal and open the relevant file from your personal device.

image.png

Confirm that the correct CSV file now shows in the Upload CSV Modal.

image.png

Select the “Upload” button.

image.png

The entries imported from the CSV file will now show on the Upload CSV for (FORM NAME) Page.

The system automatically indicates to ignore the first row. Click “Import Now” if there are no errors.

A summary of the import will now show on the CSV Upload Page.

image.png

Click the “Entries for (FORM NAME)” link to see all imported entries on the Manage Entries Page.

How To: Import Fields from a PDF Field Import

Importing fields from a PDF Field Import has multiple purposes. Not only will the form fields be generated through this process, the PDF will also be saved by the system, so that future form entries can be downloaded into this PDF, allowing for customizable outputs.

A form must have already been created with no fields added for this method to work. If a field has already been added to the form, you are no longer able to bulk import form field names from a PDF Field Import. You are now required to enter each field name individually. Regardless, you can still upload a PDF Form that the system will use for future form entry downloads.

How To: Create a Form

{{@386}}

How To: Add a Field to a Form

{{@373}}

How To: Upload a PDF Form

{{@408}}

To import field names from a PDF file, go to the Home Page of the Forms Module.

Select the three-dot icon to the right of the Form Title opening the Form’s context menu. Select “Form”.

image.png

This opens the Fields Tab for a specific form. Select the “PDF Field Import” button.

image.png

This opens the PDF Field Import Modal.

image.png

To import fields using a PDF, use the “Prepare Form” tool in Adobe Acrobat Pro. Add the fields you wish to use for your form. Add a button on your document.

image.png

Within the button properties, click on the Actions Tab. On the “Mouse Down” trigger, add the “Submit a Form” Action.

image.png

Confirm that the Export Format is “PDF The complete document”.

image.png

Open the PDF and submit the form to generate the fields here.

You do not need to fill in any of the fields, and you must not sign it.

image.png

Select “Allow” and the PDF will confirm that the fields were added to the database.

image.png

Go to the Fields Table in the database Monday, and a warning now states that a PDF is associated with the form and that adding/editing or deleting fields may result in the PDF no longer being compatible.


To import form field names from a CSV file, go to the Home Page of the Forms Module. go to the Home Page of the Forms Module and click the three-dot icon to the right of the form that you wish to import fields into. This opens the Form’s context menu. Select “Manage Entries” from the context menu opening the Entries for (FORM NAME) Page.

image.png

Select the “Import Entries” button beneath the page header.

image.png

This opens the Upload CSV Modal.

image.png

When creating your CSV file, the first row of your CSV file will be used to name form fields. Each individual cell in the first row will be a field used for data entry. You cannot specify the field type at this time. You can input entries in additional row.

After creating your fields CSV file, save it as a CSV UTF-8 for importing.

image.png

Click the “Choose File” button and open the relevant file from your personal device.

image.png

Confirm that the correct CSV file now shows in the Upload CSV Modal and select “Upload”.

image.png

Configure each form his as desired. Field types shown on the dropdown menu include form fields: Text, Text Box, Checkbox, Dropdown, Radios, Data, and Date/Time.

Select “Import Now” and a summary of the import will show on the CSV Upload Page.

image.png

All imported fields will now show in the Fields Table on the Fields Tab. If entries were included on the CSV upload, they will now be visible on the Manage Entries Page.

How To: Import Form Fields from a CSV File

To import form entries from a CSV, form fields must have already been created.

How To: Add a Field to a Form

To add a field to a form, go to the Home Page of the Forms Module. . Click the three-dot icon to the right of the form title that you want to add a field to opening the Form context menu. Select “Fields”.

image.png

This opens the Fields Tab for the specific form of interest.

There are two ways to add an individual field to the Fields Table from here. Click the “New Field” button opening the New Form Field Modal.

image.png

The creation of a new field will always require you to enter a field name. Include an input for the displayed label and select the field type from a dropdown menu. The inputs on the New Form Field Modal will vary based on the Field Type.

Possible field types in the Forms Module include Form Fields, Formatting Fields, Utility Fields, Account Fields, and Reference a Database Entry. For an explanation of field types and the formatting choices associated with each one, reference the Understanding Fields Section of the Forms Module in the User Manual.

A form field can only have on field type. If you need to utilize another (e.g., formatting purposes), you can set the displayed label to be the same but the field label must be unique.

Once you are finished inputting the information for the new field, select “Save” and the new database field will show in the Fields Table on the Fields Tab.

image.png

Fields can also be imported in bulk into a Form from a CSV file or PDF Field Import.

How To: Import Form Fields from a CSV File

To import form entries from a CSV, form fields must have already been created.

How To: Add a Field to a Form

{{@373}}

How To: Import Form Fields from a CSV File

{{@402}}

How To: Import Fields from a PDF Field Import

{{@400}}

To import form entries from a CSV, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form you wish to import entries into. Select “Manage Entries”.

image.png

This opens the Manage Entries for (FORM NAME) Page.

image.png

Click the “Import Entries” button beneath the page header. This opens the Upload CSV for (FORM NAME) Modal.

image.png

Click the “Download Template” link at the top of the modal and a CSV file will be downloaded to your personal device. Notes have been provided if you are using the downloadable template to Upload bulk CSV form entries.

Notes Regarding the Downloadable Template for Uploading CSV Files

The first row of the CSV file is for each of the form fields. If you download a CSV Template from the Upload CSV Modal, two additional column headers will show that are not form fields: Entry ID and Modify Existing Entry.

If you are importing form entries and no entries have been added to the form yet, leave these columns blank in your upload.

If form entries already exist in the database, the Entry ID column will contain the unique system generated ID for each pre-existing database entry. Leave this column blank if the row is to be imported as a new entry. The second column, Modify Existing Entry, should have a “Y” input if the existing entry is being modified and an “N” input if it has not been modified. Leave this column blank if the entry is new.

image.png

After creating your Forms Entries CSV file, save it as a CSV UTF-8 for importing. Click the “Choose File” button on the Upload CSV Modal and open the relevant file from your personal device.

image.png

Confirm that the correct CSV file now shows in the Upload CSV Modal.

image.png

Select the “Upload” button.

image.png

The entries imported from the CSV file will now show on the Upload CSV for (FORM NAME) Page.

The system automatically indicates to ignore the first row. Click “Import Now” if there are no errors.

A summary of the import will now show on the CSV Upload Page.

image.png

Click the “Entries for (FORM NAME)” link to see all imported entries on the Manage Entries Page.

How To: Import Fields from a PDF Field Import

Importing fields from a PDF Field Import has multiple purposes. Not only will the form fields be generated through this process, the PDF will also be saved by the system, so that future form entries can be downloaded into this PDF, allowing for customizable outputs.

A form must have already been created with no fields added for this method to work. If a field has already been added to the form, you are no longer able to bulk import form field names from a PDF Field Import. You are now required to enter each field name individually. Regardless, you can still upload a PDF Form that the system will use for future form entry downloads.

How To: Create a Form

{{@386}}

How To: Add a Field to a Form

{{@373}}

How To: Upload a PDF Form

{{@408}}

To import field names from a PDF file, go to the Home Page of the Forms Module.

Select the three-dot icon to the right of the Form Title opening the Form’s context menu. Select “Form”.

image.png

This opens the Fields Tab for a specific form. Select the “PDF Field Import” button.

image.png

This opens the PDF Field Import Modal.

image.png

To import fields using a PDF, use the “Prepare Form” tool in Adobe Acrobat Pro. Add the fields you wish to use for your form. Add a button on your document.

image.png

Within the button properties, click on the Actions Tab. On the “Mouse Down” trigger, add the “Submit a Form” Action.

image.png

Confirm that the Export Format is “PDF The complete document”.

image.png

Open the PDF and submit the form to generate the fields here.

You do not need to fill in any of the fields, and you must not sign it.

image.png

Select “Allow” and the PDF will confirm that the fields were added to the database.

image.png

Go to the Fields Table in the database Monday, and a warning now states that a PDF is associated with the form and that adding/editing or deleting fields may result in the PDF no longer being compatible.


How To: Import Form Fields from a CSV File

To import form entries from a CSV, form fields must have already been created.

How To: Add a Field to a Form

To add a field to a form, go to the Home Page of the Forms Module. . Click the three-dot icon to the right of the form title that you want to add a field to opening the Form context menu. Select “Fields”.

image.png

This opens the Fields Tab for the specific form of interest.

There are two ways to add an individual field to the Fields Table from here. Click the “New Field” button opening the New Form Field Modal.

image.png

The creation of a new field will always require you to enter a field name. Include an input for the displayed label and select the field type from a dropdown menu. The inputs on the New Form Field Modal will vary based on the Field Type.

Possible field types in the Forms Module include Form Fields, Formatting Fields, Utility Fields, Account Fields, and Reference a Database Entry. For an explanation of field types and the formatting choices associated with each one, reference the Understanding Fields Section of the Forms Module in the User Manual.

A form field can only have on field type. If you need to utilize another (e.g., formatting purposes), you can set the displayed label to be the same but the field label must be unique.

Once you are finished inputting the information for the new field, select “Save” and the new database field will show in the Fields Table on the Fields Tab.

image.png

Fields can also be imported in bulk into a Form from a CSV file or PDF Field Import.

How To: Import Form Fields from a CSV File

{{@402}}

How To: Import Fields from a PDF Field Import

{{@400}}


How To: Import Form Fields from a CSV File

To import form entries from a CSV, form fields must have already been created.

How To: Add a Field to a Form

{{@373}}

How To: Import Form Fields from a CSV File

{{@402}}

How To: Import Fields from a PDF Field Import

{{@400}}

To import form entries from a CSV, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form you wish to import entries into. Select “Manage Entries”.

image.png

This opens the Manage Entries for (FORM NAME) Page.

image.png

Click the “Import Entries” button beneath the page header. This opens the Upload CSV for (FORM NAME) Modal.

image.png

Click the “Download Template” link at the top of the modal and a CSV file will be downloaded to your personal device. Notes have been provided if you are using the downloadable template to Upload bulk CSV form entries.

Notes Regarding the Downloadable Template for Uploading CSV Files

The first row of the CSV file is for each of the form fields. If you download a CSV Template from the Upload CSV Modal, two additional column headers will show that are not form fields: Entry ID and Modify Existing Entry.

If you are importing form entries and no entries have been added to the form yet, leave these columns blank in your upload.

If form entries already exist in the database, the Entry ID column will contain the unique system generated ID for each pre-existing database entry. Leave this column blank if the row is to be imported as a new entry. The second column, Modify Existing Entry, should have a “Y” input if the existing entry is being modified and an “N” input if it has not been modified. Leave this column blank if the entry is new.

image.png

After creating your Forms Entries CSV file, save it as a CSV UTF-8 for importing. Click the “Choose File” button on the Upload CSV Modal and open the relevant file from your personal device.

image.png

Confirm that the correct CSV file now shows in the Upload CSV Modal.

image.png

Select the “Upload” button.

image.png

The entries imported from the CSV file will now show on the Upload CSV for (FORM NAME) Page.

The system automatically indicates to ignore the first row. Click “Import Now” if there are no errors.

A summary of the import will now show on the CSV Upload Page.

image.png

Click the “Entries for (FORM NAME)” link to see all imported entries on the Manage Entries Page.

How To: Import Fields from a PDF Field Import

Importing fields from a PDF Field Import has multiple purposes. Not only will the form fields be generated through this process, the PDF will also be saved by the system, so that future form entries can be downloaded into this PDF, allowing for customizable outputs.

A form must have already been created with no fields added for this method to work. If a field has already been added to the form, you are no longer able to bulk import form field names from a PDF Field Import. You are now required to enter each field name individually. Regardless, you can still upload a PDF Form that the system will use for future form entry downloads.

How To: Create a Form

{{@386}}

How To: Add a Field to a Form

{{@373}}

How To: Upload a PDF Form

{{@408}}

To import field names from a PDF file, go to the Home Page of the Forms Module.

Select the three-dot icon to the right of the Form Title opening the Form’s context menu. Select “Form”.

image.png

This opens the Fields Tab for a specific form. Select the “PDF Field Import” button.

image.png

This opens the PDF Field Import Modal.

image.png

To import fields using a PDF, use the “Prepare Form” tool in Adobe Acrobat Pro. Add the fields you wish to use for your form. Add a button on your document.

image.png

Within the button properties, click on the Actions Tab. On the “Mouse Down” trigger, add the “Submit a Form” Action.

image.png

Confirm that the Export Format is “PDF The complete document”.

image.png

Open the PDF and submit the form to generate the fields here.

You do not need to fill in any of the fields, and you must not sign it.

image.png

Select “Allow” and the PDF will confirm that the fields were added to the database.

image.png

Go to the Fields Table in the database Monday, and a warning now states that a PDF is associated with the form and that adding/editing or deleting fields may result in the PDF no longer being compatible.

To import form entries from a CSV, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form you wish to import entries into. Select “Manage Entries”.

image.png

This opens the Manage Entries for (FORM NAME) Page.

image.png

Click the “Import Entries” button beneath the page header. This opens the Upload CSV for (FORM NAME) Modal.

image.png

Click the “Download Template” link at the top of the modal and a CSV file will be downloaded to your personal device. Notes have been provided if you are using the downloadable template to Upload bulk CSV form entries.

Notes Regarding the Downloadable Template for Uploading CSV Files

The first row of the CSV file is for each of the form fields. If you download a CSV Template from the Upload CSV Modal, two additional column headers will show that are not form fields: Entry ID and Modify Existing Entry.

If you are importing form entries and no entries have been added to the form yet, leave these columns blank in your upload.

If form entries already exist in the database, the Entry ID column will contain the unique system generated ID for each pre-existing database entry. Leave this column blank if the row is to be imported as a new entry. The second column, Modify Existing Entry, should have a “Y” input if the existing entry is being modified and an “N” input if it has not been modified. Leave this column blank if the entry is new.

image.png

After creating your Forms Entries CSV file, save it as a CSV UTF-8 for importing. Click the “Choose File” button on the Upload CSV Modal and open the relevant file from your personal device.

image.png

Confirm that the correct CSV file now shows in the Upload CSV Modal.

image.png

Select the “Upload” button.

image.png

The entries imported from the CSV file will now show on the Upload CSV for (FORM NAME) Page.

The system automatically indicates to ignore the first row. Click “Import Now” if there are no errors.

A summary of the import will now show on the CSV Upload Page.

image.png

Click the “Entries for (FORM NAME)” link to see all imported entries on the Manage Entries Page.

How To: Import Fields from a PDF Field Import

Importing fields from a PDF Field Import has multiple purposes. Not only will the form fields be generated through this process, the PDF will also be saved by the system, so that future form entries can be downloaded into this PDF, allowing for customizable outputs.

A form must have already been created with no fields added for this method to work. If a field has already been added to the form, you are no longer able to bulk import form field names from a PDF Field Import. You are now required to enter each field name individually. Regardless, you can still upload a PDF Form that the system will use for future form entry downloads.

How To: Create a Form

To create a new form, open the Home Page in the Forms Module from the Main Menu and select the Create Form button beneath the page header.

image.png

This will open the New Form Modal.

image.png

Input the Form Title (a required field), form notes, and any open/permissive/restrictive tags to be associated with the form.

There are three additional sections to the New Form Modal that expand when clicked with additional options for customization. Modal images and explanations of each input are included below.

Basic Settings Section

image.png


New Form Modal: Basic Settings Section Explanation

Modal Input

Explanation

Group

A dropdown menu will list all existing form groups. The form will automatically be placed in the group selected.

Allow Public Entries Checkbox

If the checkbox is selected, public entries (individuals not registered with KAStrack) will be allowed to submit form entries.

URL Link

A URL Link is used to share the form publically. KAStrack will autofill the URL Link with the form title, but this can be customized if desired.


You cannot use spaces or symbols in the URL link. They will replaced with a hypen if used.

The next two checkboxes are specific to the PDF options for form entries that are not submitted via a PDF. To understand which option is better for this specific form, be sure to read about the relationship between PDFs and Forms.

Use KAStrack Generated PDF

If you have a PDF entry on file but do not want the downloaded form entry to utilize the customized PDF form, select this checkbox and KAStrack will use the generic PDF format.

Use the Appropriate Uploaded PDF Revision

If you have a PDF entry on file and want the downloaded form entry to utilize the customized PDF form, select this checkbox and KAStrack will use the most recent version of the PDF submitted.









Allow Integration With











Allow integrations with is a dropdown menu that lists all modules you can use a form for. Selecting a module here will enable this form to be visible in the modules selected. Possible uses are listed below.

Module

Purpose

Assets

Attach to Task

Attendance

Integrate with the Attendance Log Module

Datbase

Reference from Database

Dispatch

Include in a Dispatch

Documents

Add to Photo

Forms

Reference from a Form

Grid

Integrate with the Grid Module

Kanban

Integrate with the Kanban Module

People

Use as activity for certification

Advanced Settings Section

image.png


New Form Modal: Advanced Settings Section Explanation

Modal Inputs

Explanation

Allow Payment Checbox

(Expands when selected)

Payment Profile

Select “All Enabled Configurations” from the dropdown menu for payments to be allowed.

Payment Description

This description is what will show on a payment receipt.

Default Pattern for Entries

This textbox uses mail merge fields.



Allow the User to Save AS Draft Checkbox


(Expands when selected)


Allow Logged Out User to Save as a Draft

Selecting this checkbox will allow logged out users and public entries to save their response as a draft and come back to the form (on the same device).

Validate Fields when Saving as Draft

Fields with validation don’t validate on a draft, so inputting fields here tells the system to validate fields when the draft is saved.

Save Draft Button Text

The form creator can customize the text on the Save button.

Auto Save

When auto-save is enabled, any edits made to a field will automatically be saved. When auto-save is disabled, the information will only be saved when the save draft button is clicked.





Allow Default Access Checkbox





When Selected

The form will follow module level permissions in regards to what access an individual will have.

If allow default access is not selected, the additional form specific permissions are now required. The system will ignore module level distinctions for this form and will be guided by the form specific permissions listed below.

Admins

A checkbox allows for admins to be prohibited from viewing entries. Users or roles listed here will have admin level permissions for this form. This includes editing and deleting the form, managing the form fields and (unless prohibited) managing entries.

Manage Entry Permissions

Users or roles listed here have manage level permissions for this form. This includes adding, editing and deleting entries.

Manage Pending Approval Entry Permissions

Users or roles listed here can edit entries that are pending approval.

Show in the Dashboard Forms Widget

Users and certification roles selected here will show this form in the Dashboard Forms Module Summary Widget.

Form Styling Section

image.png


New Form Modal: Form Styling Section

Modal Inputs

Explanation

Save Button Text

Change the verbiage on the save button by inputting other text here.

Cancel Button Text

Change the verbiage on the cancel button by inputting other text here.

Submission Message

Change the verbiage on the form submission message by inputting other text here.

Show Green Checkmark Checkbox

Selecting the show green checkmark with submission message checkbox will show a green checkmark to the left of the submission message when a form is submitted.

Show the Form Title Checkbox

Select the Show the Form Title Checkbox will show the form title for a logged-out entry. This does not impact a system, modal based entry.



Apply Whole Form

SCSS to



Logged Out Only

Select “Logged Out Only” if the styling doesn’t correspond with a popup modal or the regular form page. This would result is SCSS styling only applies to public entries.

Logged In Only

Select “Logged In Only” if you only want to apply the SCSS formatting to the logged in, internal users.

Always

Selecting “Always” applies the SCSS formatting that has been established in both internal and external forms.

SCSS for Whole Form

This is the textbox where scripting language should be input, that allows for greater customization than what is generally available.

Select the Save button on the New Form Modal after customizing your form and the system will direct you to the form's Fields Tab where you can begin to input Form fields.

image.png

How To: Import Fields from a PDF Field Import

{{@400}}

How To: Import Form Fields from a CSV File

{{@402}}

How To: Upload a PDF Form

{{@408}}


How To: Add a Field to a Form

To add a field to a form, go to the Home Page of the Forms Module. . Click the three-dot icon to the right of the form title that you want to add a field to opening the Form context menu. Select “Fields”.

image.png

This opens the Fields Tab for the specific form of interest.

There are two ways to add an individual field to the Fields Table from here. Click the “New Field” button opening the New Form Field Modal.

image.png

The creation of a new field will always require you to enter a field name. Include an input for the displayed label and select the field type from a dropdown menu. The inputs on the New Form Field Modal will vary based on the Field Type.

Possible field types in the Forms Module include Form Fields, Formatting Fields, Utility Fields, Account Fields, and Reference a Database Entry. For an explanation of field types and the formatting choices associated with each one, reference the Understanding Fields Section of the Forms Module in the User Manual.

A form field can only have on field type. If you need to utilize another (e.g., formatting purposes), you can set the displayed label to be the same but the field label must be unique.

Once you are finished inputting the information for the new field, select “Save” and the new database field will show in the Fields Table on the Fields Tab.

image.png

Fields can also be imported in bulk into a Form from a CSV file or PDF Field Import.

How To: Import Form Fields from a CSV File

{{@402}}

How To: Import Fields from a PDF Field Import

{{@400}}


How To: Upload a PDF Form

Uploading a PDF allows an individual to create a customized output for form entries. In order to do so, the PDF must be created on Adobe Acrobat Pro (or comparable software) and have made use of form fields.

A PDF can be created and uploaded after a form is in use, however no additional fields can be created at this time.

To upload a PDF form to be used for form entry outputs, go to the Home Page of the Forms Module. Click the three-dot icon to the right of the form title opening the context menu and select “Upload PDF”.

image.png

This will open the Upload PDF Form Modal.

image.png

Select “Choose File” to retrieve the PDF from your personal device.

Input a title for the PDF or select the clickable “Use Filename” link to have the system use the filename as the title. The revision date will automatically show the current day, but can be altered. Select the appropriate checkbox if the document is to be public, or if it is a 360 degree photo.

You can select individuals or certification roles as the document owner(s).

Select “Save” and a confirmation modal will appear stating, “File was uploaded.”

image.png


To import field names from a PDF file, go to the Home Page of the Forms Module.

Select the three-dot icon to the right of the Form Title opening the Form’s context menu. Select “Form”.

image.png

This opens the Fields Tab for a specific form. Select the “PDF Field Import” button.

image.png

This opens the PDF Field Import Modal.

image.png

To import fields using a PDF, use the “Prepare Form” tool in Adobe Acrobat Pro. Add the fields you wish to use for your form. Add a button on your document.

image.png

Within the button properties, click on the Actions Tab. On the “Mouse Down” trigger, add the “Submit a Form” Action.

image.png

Confirm that the Export Format is “PDF The complete document”.

image.png

Open the PDF and submit the form to generate the fields here.

You do not need to fill in any of the fields, and you must not sign it.

image.png

Select “Allow” and the PDF will confirm that the fields were added to the database.

image.png

Go to the Fields Table in the database Monday, and a warning now states that a PDF is associated with the form and that adding/editing or deleting fields may result in the PDF no longer being compatible.

To import form entries from a CSV, go to the Home Page of the Forms Module and click the three-dot icon to the right of the form you wish to import entries into. Select “Manage Entries”.

image.png

This opens the Manage Entries for (FORM NAME) Page.

image.png

Click the “Import Entries” button beneath the page header. This opens the Upload CSV for (FORM NAME) Modal.

image.png

Click the “Download Template” link at the top of the modal and a CSV file will be downloaded to your personal device. Notes have been provided if you are using the downloadable template to Upload bulk CSV form entries.

Notes Regarding the Downloadable Template for Uploading CSV Files

The first row of the CSV file is for each of the form fields. If you download a CSV Template from the Upload CSV Modal, two additional column headers will show that are not form fields: Entry ID and Modify Existing Entry.

If you are importing form entries and no entries have been added to the form yet, leave these columns blank in your upload.

If form entries already exist in the database, the Entry ID column will contain the unique system generated ID for each pre-existing database entry. Leave this column blank if the row is to be imported as a new entry. The second column, Modify Existing Entry, should have a “Y” input if the existing entry is being modified and an “N” input if it has not been modified. Leave this column blank if the entry is new.

image.png

After creating your Forms Entries CSV file, save it as a CSV UTF-8 for importing. Click the “Choose File” button on the Upload CSV Modal and open the relevant file from your personal device.

image.png

Confirm that the correct CSV file now shows in the Upload CSV Modal.

image.png

Select the “Upload” button.

image.png

The entries imported from the CSV file will now show on the Upload CSV for (FORM NAME) Page.

The system automatically indicates to ignore the first row. Click “Import Now” if there are no errors.

A summary of the import will now show on the CSV Upload Page.

image.png

Click the “Entries for (FORM NAME)” link to see all imported entries on the Manage Entries Page.

How To: Integrate Another Module Into a Form

To integrate another module into a form, go to the Home Page in the Forms Module. Click the three-dot icon to the right of the form you wish to edit opening the specific form’s context menu. Select “Edit Form”.

image.png

This opens the “Edit Form Modal”.

image.png

Under the Basic Setting section, a dropdown menu follows “Allow integration With”. Select the modules you wish to integrate into the form.

Select “Save” and the form will now be visible within the modules selected.

How To: Make a Form Live

To change a Form Status from Preview Mode to Live, , go to the Home Page of the Forms Module and select the three-dot icon to the right of the form title you wish to make Live. This opens the Forms Table Context Menu.

Confirm that you have deleted any testing entries before you convert the form to Live status.

How To: Delete All Testing Entries

To delete all entries made while a form is in Preview Mode, go to the Home Page of the Forms Module and select the three dot icon to the right of the form title you wish to delete entries in.

A form must be in preview mode to bulk delete existing entries.

image.png

Select “Delete All Entries” from the context menu opening the Deletion Confirmation Modal.

image.png

The modal states, “Are you sure you wish to delete all entries from form (FORM NAME)? Any sequential number fields will be reset. Entries linked to object from other modules will also be deleted. This cannot be undone.”

Click the “OK” button and the Delete All Entries Modal stating “All entries have been deleted” appears.

image.png

Click the “Close” button and return to the Forms Module Home Page.

image.png

The Forms Table will now show that there are 0 entries associated with the Form.

image.png

Select “Make Form Live”. This opens the Update Status Modal which states, “This form is now live.”

image.png

Click the “Close” button to return to the Forms Table on the Home Page. The Form Status will now show as Live.

How To: Reject a Form Entry Pending Approval

To reject a form entry pending approval, go to the Home Page of the Forms Module.

image.png

Select “View Entry” from the Actions column of the Form Entries Pending Approval Table opening the view form entry modal.

image.png

Select the “Reject” button opening a Confirmation Modal that states, “Are you sure you want to reject this entry?

image.png

Select “Confirm” and a confirmation modal states, “Rejected”.

image.png

How To: Require Form Entry Approval

To require that form entries are approved, go to the Home Page of the Forms Module. Select the three-dot icon to the right of the specific form you want to require entry approvals for and select “Rules” from the context menu.

 image.png

This opens the form specific Rules Tab.

image.png

Select “New Rule” opening the New Form Rule Modal.

image.png

Input the name of the new rule and set the status as “Active”. The rule can be conditional, or it can always be run for the specific form.

Click the plus icon to the right of action, expanding the modal. Select the Workflow Category option “Require Approval”. 

This rule will apply for the initial entry submission.

Select who can grant approval: direct supervisors, all supervisors, or specific users.

A form entry will be approved as soon as any individual who can approve it does. Only one individual needs to approve the entry pending approval.

Requiring approval from an individual will give full access too all entries the individual needs to approve, even if the individual does not have access to the form itself.

Specify the number of days after a form entry is submitted when the pending approval will turn red.

Select “Save” to save the action, which will now show in the New Form Rule Modal.

image.png

Select “Save” at the bottom of the modal and the rule to require approval for form entries will now be active and shows on the form specific Rules Tab.

image.png

How To: Submit Entries Using a PDF

How To: Upload a PDF Form

Uploading a PDF allows an individual to create a customized output for form entries. In order to do so, the PDF must be created on Adobe Acrobat Pro (or comparable software) and have made use of form fields.

A PDF can be created and uploaded after a form is in use, however no additional fields can be created at this time.

To upload a PDF form to be used for form entry outputs, go to the Home Page of the Forms Module. Click the three-dot icon to the right of the form title opening the context menu and select “Upload PDF”.

image.png

This will open the Upload PDF Form Modal.

image.png

Select “Choose File” to retrieve the PDF from your personal device.

Input a title for the PDF or select the clickable “Use Filename” link to have the system use the filename as the title. The revision date will automatically show the current day, but can be altered. Select the appropriate checkbox if the document is to be public, or if it is a 360 degree photo.

You can select individuals or certification roles as the document owner(s).

Select “Save” and a confirmation modal will appear stating, “File was uploaded.”

image.png