This is the end-user documentation for the new Wizard container built in to the AddOns v2014.01.15 package for SPEasyForms. I’ll follow up quickly with another post explaining the implementation details for developers.
The Wizard container is kind of a special case. Unlike Tabs or Accordion, I really only see the wizard container as useful if most, or ideally all, of the fields are on it. It allows you to paginate a form so users can step through it. To demonstrate, I’m going to start with a list that has a new form that looks like:
And I’m going to configure the wizard container to have one page for each question, after which the SPEasyForms settings page looks like:
Just like any other container, you can put as many fields on a page as you like. I just didn’t have a lot of fields so one per page works. Now when a user opens the new form, they see:
If they hit the next button and they’ll see:
If they keep hitting next until they get to the end they’ll see:
For the most part that’s it; it’s just a basic wizard or survey. Keep in mind that the user can submit at any time, they don’t have to get to the end in order to submit. If there are validation errors on a page upon submit, the form will switch to the first page with a validation error displaying the error message.
One other thing you might want to take advantage of is that just like any other container that hides fields, the Wizard container will skip pages if all of the fields on the page have been hidden using conditional visibility rules. This allows you to create branching logic, so if I add the following rules to my SPEasyForms configuration:
The form appears to change from a four page wizard to a three page wizard, with the last question being either ‘What is your favorite color?’ or ‘What is the capital of Assyria?’ depending on how you answered the question ‘What is your quest?’.
That does it for the wizard container, hope you find it useful.