New Button

Note

The New Button option is fully supported for Recruit forms only. Using it with HCM forms requires you to edit the form definition in the XML editor.

The New Button option adds a custom button to the currently selected page. Buttons can perform additional actions such as skipping an irrelevant section.

By default, each form page already has navigation buttons (Previous, Next, Save, and Submit). These are displayed at both the bottom and top of pages within multi-page forms. Navigation buttons are not displayed in the visual editor. Navigation buttons can be toggled on and off for a page using the Navigation checkbox in advanced editing mode.

The New Button element has the following fields.

Field Description
Name The name of the button element, shown in the form structure panel.
Prompt The text that appears on the button.
Action

As well as the standard navigation options, custom button actions are:

  • Goto: navigates the user to a specific page in the form.

  • Complete: submits the form. If a "Completed" message exists for the form, the user is forwarded to the message. You can forward to another page on form completion by specifying a Target Page for the Complete button.

  • Print: opens a print view of the page in your browser.

Target Page

For the Goto action, this is the page that the button will take you to. For Complete action, the button forwards the user to the specified page after submitting the form.

Enter the ID of the destination page.

Tip A tooltip for the button that appears on mouse hover.
ID A unique ID for the button element.
Disabled When checked, the button appears on the page, but is disabled.
Conditions The conditions that must be met for the button to be displayed.
Image URL External URL of an image to use as the button background. By default, the button resizes to match the dimensions of the image. If you specify a button image, the Prompt text is not displayed on the button.
Confirm message (not used) Text to display in a confirmation dialog. Not used.

 

New Button with HCM forms

You can access the New Button in the Advanced Mode when editing an HCM form, but instead of the options for Action you see for Recruit forms the Action field displays [object Object]. If you save the form definition with the new button and then view the form definition in the XML editor, you can see the button action defaults to "previous". If you need a button for going to the next page or for submitting the form, you need to edit the button action manually.

For example, if you want to manually add a Submit button to a form you are sending by email rather than hosting in WX and want to ensure the button text displays the translation you want, follow these steps:

  1. Add the new button with these details:

    • Name: Submit

    • Prompt: The text you want the form users to see.

  2. Save the form definition.

  3. On the HCM Form Definition page select XML Edit.

  4. In the Form Definition Details, find the button details similar to the following example: 

    Copy

    Button element in the XML editor

    <button name="Submit" prompt="Senden" action="previous"></button>
  5. Change the text of the action to from "previous" to "complete".

  6. Select Save.