Jenzabar Campus Portal Features Help Hub

Defining a Form's Settings

Each form has Form Settings that govern the behavior of the form. The available settings for the currently selected form are displayed at the top left portion of the Form Builder: Name of your form screen.

Note

Not all of the settings described here are available for all form types. Only the setting types that are appropriate for the form being edited will have a link displayed.

Additionally, not all of the settings available in a particular form screen are applicable to all form types. In these cases, the specific settings will be hidden on the screen.

Each form is required to have at least a form name; however, there may be other basic form settings that are available for the form you are editing. Another option for specifying basic form settings is to import the settings from another existing form.

Create New Settings
  1. Open the form for editing.

  2. Click the Edit basic form settings link, which displays the Basic Form Settings screen.

  3. Do any of the following, as appropriate and available for the type of form you are editing:

    1. Use the Form Name field to change the name of the form (required).

      Note

      The names of the Donor Profiles forms can not be modified since they are tied to a particular data category.

    2. Use the Short Description field to change the description of the form. This description may or may not be displayed to the user filling out the form, depending upon the feature with which the form is associated.

    3. Use the Contact E-mail field to indicate to which e-mail address(es) an error message should be submitted.

    4. If you wish to allow a user to save their entered data to be completed at a later time, check the Show the "Save for Later" button checkbox.

    5. If there are any files you wish to have available on the form as a link for the user to download, use the fields in the Supplementary Files portion of the screen to browse to a File and add the file using the specified Label.

  4. Click Save to save your edits and return to the Form Builder: Name of your form screen.

Import Existing Settings
  1. Click the Import the "Basic Form Settings" from an existing form link at the top of the Basic Form Settings screen, which displays the Import Settings screen.

  2. Select the radio button option for the form you wish to use, and click the Import Selected button.

    You return to the Form Builder: Name of your form screen, having imported the data from the selected form.

If the Set up payment options link is available for the form you are editing, you have the ability to specify that a payment may be required in order to submit the form. Another option for specifying payment options is to import the Payment Options settings from another form.

Note

By default, the form is defined to not require a payment.

Create New Payment Options
  1. Open the form for editing.

  2. Click the Set up payment options link, which displays the Payment Options screen.

  3. Do any of the following, as appropriate:

    1. Use the Charge a Fee radio button options to indicate whether or not the form does not require a fee, requires a fee, or if a fee is optional.

    2. Update the Payment Waiver Codes.

    3. Use the FEE Amount ($) field to change the fee amount.

    4. Use the Transaction Code field to define the code to use for submitting the payment information to a third-party processor.

    5. Use the Payment Authorization radio button options to show whether the payment should be processed offline or online.

    6. Enter an email address into the E-mail address for failed payments field if desired.

    7. If payments should be allowed to be in an e-check form, check the Allow payment via e-check checkbox.

    8. Use the Payment Selection Text to define the text that will be displayed to the user as they select a payment type.

    9. Use the Make a Payment Text to change the text that will be shown to the user as they make a payment.

  4. Click Save to save your edits and return to the Form Builder: Name of your form screen.

Import Existing Payment Options
  1. Click the Import the "Payment Options" from an existing form link at the top of the Payment Options screen to display the Import Settings with a list of defined forms.

  2. Select the radio button option for the form you wish to use, and click the Import Selected button.

    You return to the Form Builder: Name of your form screen, having imported the data from the selected form.

If you wish to make use of waiver codes to allow users to submit a form without entering the required payment info, you need to define one or more waiver codes through the Payment Options screen. Waiver codes are only applicable if the form is defined to require a payment or if the form has the optional payment option selected. If waiver codes are defined for a form, the user filling out the form will have the option of entering in a waiver code on the Review and Submit screen.

Use the following steps to create, edit, and delete waiver codes for a form:

  1. Click the View and manage your codes link for the Payment Waiver Codes option on the Payment Options screen. The Payment Waiver Codes screen is displayed.

  2. To create a new waiver code:

    1. Click the Add a new waiver code link. An editable field is displayed in the Code and Note (optional) columns.

    2. The Code column will have a system-generated unique code displayed. Leave the generated code as is, or change it to your own code value.

    3. Enter note text if desired.

    4. Click Save. The new waiver code is saved and displayed along with any other existing waiver codes.

  3. To edit an existing waiver code:

    1. Click on the pencil icon (Edit Icon) to the right of the waiver code. The Code and Note (optional) fields become editable for the selected waiver code.

    2. Edit the code and/or note text as you wish.

    3. Click Save. The updated waiver code is displayed with any other waiver codes.

  4. To delete an existing waiver code:

    1. Click on the trashcan icon (Delete Icon) to the right of the waiver code.

    2. The “Are you sure you want to delete this Waiver Code?" prompt is displayed.

    3. Click OK. The selected waiver code is deleted from the list of waiver codes.

  5. Click the Back to Payment Options link to return to the Payment Options screen.

    The number of defined waiver codes is updated accordingly.

Note

Remember, if you wish for a user to be able to enter a waiver code for a form, you need to supply the user with an appropriate waiver code prior to the user submitting the form.

If you wish to define a text message to be displayed to the user and/or an e-mail message to be sent to the user upon a successful or unsuccessful submission, then you need to set up the completion messages. Another option for setting up completion messages is to import the the Completion Messages from another form.

Note

By default, no completion messages are defined for a form.

Create New Completion Messages
  1. Open the form for editing.

  2. Click on the Set up completion messages link, which displays the Completion Messages screen.

  3. In the Successful Submission portion of the screen, edit any of the following, as appropriate:

    1. Use the On screen message field to enter any text to display to the user on the screen upon a successful submission.

    2. Select the desired option from the After a successful submission drop-down menu. Available options are Always Send an E-mail, Ask the User, and Never Send an E-mail. The default option is Always Send an E-mail.

    3. If either the Always Send an E-mail or the Ask the User option is selected, you need to enter values into the following fields:

      1. From

      2. Subject

      3. Message

      4. Body

        You can include details and information from the form [see Personalizing Completion Messages].

    4. The remaining fields are optional.

  4. In the Unsuccessful Submission portion of the screen, edit any of the following, as appropriate:

    1. Use the On screen message field to enter any text to display to the user on the screen upon an unsuccessful submission.

    2. Select the desired option from the After an unsuccessful submission drop-down menu. Available options are Always Send an E-mail, Ask the User, and Never Send an E-mail.

      Note

      The default option is Always Send an E-mail.

    3. If either the Always Send an E-mail or the Ask the User option is selected, you need to enter values into the following fields:

      1. From

      2. Subject

      3. Message

      4. Body

        You can include details and information from the form [see Personalizing Completion Messages].

    4. The remaining fields are optional.

  5. Click Save to save your edits and return to the Form Builder: Name of your form screen.

Import Existing Completion Messages
  1. Click the Import the "Completion Messages" from an existing form link at the top of the screen to display the Import Settings with a list of defined forms.

  2. Only forms that have completion messages already defined have a radio button option available. Select the radio button option for the form you wish to use, and click the Import Selected button.

    You return to the Form Builder: Name of your form screen, having imported the data from the selected form.