App Forms

In App Forms you can:

Add a New App Form

To add a new app form:

  1. Click on the Add New App Form button and the Add Form: Step 1 – Basic Information screen will display:
720

Step 1 for adding a new app form (Basic Information)

  1. Add your form’s Unique ID, the form’s Name, a Description of what the form is for and where it will be used.
  2. If the form will be used right away, then you can leave the Active box checked; however, if it’s not to be used immediately or will be unavailable, then deselect that option (and it will become inactive).
  3. Click on the Save & Continue button when ready.
  4. You’ll now be taken to Step 2 - Build Form:
720

Step 2, this is where you'll build your form

Here you can:

Add New Form Field – this is where you can create your own customisable form fields.
Choose From Library – many objects in the CASSA system are reusable and if the field has already been created and added to the library then it’ll be in there.
Preview – the preview button allows you to see how your form will look

Add New Form Field

To add a new form field:
6. Click on the Add New Form Field button and the following will display:

400

The add app form field

  1. First, add your Unique ID, and then select the Field Type from the drop-down list:
400

The drop-down list displays the list of available fields

As you can see, you can select from the following field types:

  • Date Calendar – this inserts a date picker field which allows the user to select a date.
  • Heading/Category – this is used to insert labels into your form. This field is not editable by the user.
  • Multi Checkbox – use this to insert questions which have or require multiple answers.
  • Note – this inserts a free-text entry field where the user can add their own notes.
  • Signature – this is where your user can sign the form.
  • Single Select – for questions which require a single answer.
  • Textarea – this insert a free-text area where your user can enter text.
  1. Select your field type and then add the Question you want to ask or, if it’s an instruction rather than a question, the details for that field.

If you select a field type where there are different answer options, then you can add, modify, or delete the answers.

For example, if you select a Multi Checkbox field type, then you’ll be presented with the following:

379

The multi checkbox field type looks like this

If you want to keep the true, false, not applicable options, then there’s no need to make any changes. However, if you want to make changes:

a. Click on the red X to delete that option.

b. Click on the Click here to create link to present the following where you can add your own options:

430

Here's where you can create your own options

c. Add your value to the new field

d. Click on Add Options to add additional options and values

e. When the entire field is complete, including Question/Details, click on the Submit button. The dialog will close, and you’ll be taken to the form page where you can see all the fields on your form:

530

This is how your form may look when you've added the required items

If you want to add a new field, you can either:

  • Click on Add New Form Field and the dialog from before will open and you can select a new field type.
  • Click on Choose From Library – we cover this in App Fields, but all fields that are created in the app are added to the library for reuse. Click here to open the library where you can then select and insert an already created field.

You can click on the Preview button to see how your form currently looks.

How to Reorder Form Fields

To reorder forms fields, click, drag and drop the left icon to reposition the field:

388

Click, drag-and-drop to reorder form items

Assign Form Access Permissions

Once you’ve created your form, you now need to assign the Access Permissions. To do this:

  1. Click on the Roles Users drop-down link and the display will expand:
600

The assign form access permission where you can assign permission to roles and users

  1. Select the roles and people to whom you wish to grant access.
  2. Once you’ve completed all your changes, click on 1 of the following:
  • Save & Close – this will save the form, close the dialog, and take you to the List App Forms page.
  • Save and Add More – this will save the form and take you to a new form.
  • Cancel – will reject all changes, close the form, and return you to the List Register Forms page.

View Form Information

To view the information of an existing form:

  1. In the App forms main grid,click on the hyperlinked form Name.
392

The form name is hyperlinked

  1. The form’s information will display.

Note: the form can’t be edited here. To do that, you need to go back to the main App Forms grid and click on the Edit button.

Preview an App Form

You can also preview how a form will look from the App Form grid by clicking on the Preview link.

Edit an App Form

To edit a form, in the main App Form grid:

  1. Click on the Edit button for the form you wish to edit. The form will open for editing.

  2. You can now edit all areas of the form in the same manner as when you create a form

Delete an App Form

To delete a form, in the main App Form grid:

  1. Identify the form you no longer need and click on the trashcan (button.
  2. A confirmation dialog will appear asking you to confirm that you no longer need this form. Click on Yes to delete it.
  3. The form will be removed from the grid.

Note: this step is irreversible, so bear in mind that, once deleted, the form cannot be recovered.

The form grid can become quickly cluttered and can overflow into multiple pages, so often the quickest way to locate a form is to use the search field:

Search for an App Form

  1. Click in the search field and begin typing the name of the form you wish to locate:
720

Searching for an app form

  1. As soon as you start to enter your search term, the system will filter out all those records that don’t match your term, allowing you to quickly locate the one you require.

  2. Click on one of the form’s actions (view, edit, or delete), as required, or

  3. Click on the Copy button to copy the search results to the clipboard.

286

Clicking on the Copy button will copy the search results to the clipboard

  1. The search results will be copied to the clipboard and can then be pasted elsewhere.
199

The number of rows copied will be shown

Export an App Form

You can also export the App Form matrix in either the csv or the xlsx format:

  1. If you want to export the entire matrix, ensure that no search filter is in place (by deleting any text from the search field). If a search filter is in operation, only the filtered results will be saved to the downloadable file.
286
  • To export as csv, click on the csv button and the Save As dialog will open to allow you to save the file to your computer
  • To export as an Excel spreadsheet, click on the Excel button. Again, the Save As dialog will display and allow you to save the file to your pc.
296

Exporting your results

  1. You can now open the file in the normal manner.

Print an App Form

If you need to print the search results:

  1. Click on Print and the print window will open.

  2. You can now change print settings, such as Destination printer, the number of pages, page orientation, etc. The actual settings all depends on your own printer.

427

The print preview function. What you see may differ to this (depending on your printer)

  1. When ready, click on Print to send it to the printer.