Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Expand
titleOn This Page
Table of Contents

...

This page covers editing the fields that make up the form.

Editing form details is explained in Editing User Defined Forms. Completing individual UDF instances is explained in Editing User Defined Form Values.

Selecting Add Questions in the /wiki/spaces/POH/pages/1669988399 tab in the User Defined Form Summary will open the user defined form builder. Here you can add the necessary question fields to the form. If another PICSWeb user is currently editing a form in the form builder, it will be locked for any other users.

Once you have made the necessary changes to the field, select Save to confirm them.

...

Form Details

The following details are available to edit above the form template:

...

Title

...

Description

...

Status – Here you can choose whether the form is Live or Dormant.

...

Form For – Here you can specify which record types you want the form to be available for.

...

Extra User Type – If you are using this UDF for Remote Review Signing, you can specify here if you want the UDF to be available to Learners and Contacts.

...

Adding Fields

The right-hand side of the form builder displays the different question fields you can add to the form. With any field, you can either drag-and-drop the field onto the form or select it to add it to the form, underneath any questions that have already been added. Once you have added a field, you can customise the field options and formatting as explained below. The following fields are available to add:

...

  • URL – This field can be used to display a URL.

  • Long Label – This field can be used to display a block of text.

  • Group – This field can be used as a heading to group fields.

  • Header – This field can be used to display a smaller header than the Group field.

Field Options

Once you have added a field, selecting the Et icon will open a window where you can edit various details relating to the field. Once you have made any changes, select Done to save the field.

...

Editing Fields

Hovering over a question will show the following options:

  • Edit – This will open the edit window for the question as explained below.

  • Copy – This will add a copy of the question field to the bottom of the form.

  • Delete – You will be prompted to confirm before a question is deleted.

You can also drag and drop questions to rearrange them in the form.

...

Editing a question will open the window shown below, where you can amend the following details for the question. Once you are finished, select Done to confirm your changes.

  • Title – This is the question that will appear when the form is being completed.

  • Required Field – If this is ticked, the user will need to complete this field before the form can be saved against a record.

  • Required Message – If you have set the field as Required, here you can enter a custom error message if the form cannot be saved due to the field being left blank.

  • Minimum – Here you can specify the minimum value for numerical or date/time fields. For text fields, a Minimum Length is available to specify here.

  • Minimum Message – Here you can enter a custom error message if the form cannot be saved due to the answer not reaching the minimum value.

  • Maximum – Here you can specify the maximum value for numerical or date/time fields. For text fields, a Maximum Length is available to specify here.

  • Maximum Message – Here you can enter a custom error message if the form cannot be saved due to the answer exceeding the maximum value.

  • Import Field Name

  • Unique Field Name – If you are Importing UDF Fields, this name will serve as the API key to link fields in the import document to the UDF field in the relevant records. This name is also used to Include UDF Fields in Reports.

...

Please do not use spaces or slashes within Unique Field Names

...