Let's move up to the top half of the window and start creating some wizard questions.
Select a variable from the list on the left.
You should select them in the order you want the questions presented to the end-user.
Remember, that when you select a variable, the question, description, values and settings are for that variable!
If you select "radius" and then type the question "Number of Loops?" the end-user will think they are entering the number of loops but the engine is placing the value in "radius".
Once you have selected a variable, click the Add Variable button under the list.
You'll notice that the right-hand side of the window will enable, allowing you to enter data.
For our example, let's select the "radius" variable first.
Remember the first word in this, "Brief Description."
When entering this, be as brief and simple as possible.
You will only get perhaps 64 to 96 characters to display on the Wizard Question window the end-users see.
So be short, simple, to the point or basically... Brief!
For radius, let's just make this value:
Radius of Corkscrew
Next is the detailed description.
Even though you have much more space to work with here, you can not write a book.
You still need to keep it short, but can give a bit more detail about how the variable will effect the element.
You can probably get away with 160 to 256 characters here, but you should keep it simple.
For this variable, let's just simply say what it will do:
The radius determines the overall size (width and height) of the corkscrew.
And now we will move on to the values that can be entered by the end-user.
We also need to put in a default value for our variable.
The default value we used in the formula for radius was 5.
But we want the end-user to be able to adjust this to their needs.
So let's give it a Minumum value of 1 and a Maximum value of 20.
And go ahead and put in our default value of 5.
Notice that by default the check-box Allow Decimal Values is checked.
This means that the end-user can enter a value with a decimal point.
So the end-user could enter a value of 7.5 if they wanted to.
Next to this, you'll notice the check-box Allow Value of Zero is unchecked.
In this example there is no way that the end-user could enter a value of zero because the minimum value is 1.
This is a setting for when the minimum value is less than 0 and the maximum is greater than zero.
For example, minimum is -5 and maximum is 5.
Zero is clearly between those values, however, many calculations will fail with a 0 in them.
With the default setting the end-user could enter a value from -5 to -0.000001 and from 0.000001 to 5 but could not enter a value of 0 (zero).
If your formula can handle a 0, then go ahead and put a check in the check-box to allow the end-user to enter 0.
At this point, the top half of the window should look similar to this:
A quick double-check of all your settings and descriptions is a good idea.
Notice at the very top of this area is a space labeled Internal Variable.
This will display the variable that will be filled in by the answer to this question.
So this is a good time to make sure you entered the correct question, description and values for this variable.
Then click the Add to Wizard button.
The top half of the window will disable again, and this question will be formatted to the wizard style and added to the wizard.
You can see it listed on the bottom half of the window.
It will look similar to this:
Repeat these steps for the next variables you want to add to the formula.
In this example, we don't want the end-user to be able to modify the "lc" variable.
So we will not create a wizard question for it.
Select the variable "stretch" and click Add Variable.
Fill in the following information:
Brief Description
Stretch of the Corkscrew?
Detailed Description
The stretch determines the overall length of the corkscrew. Each value is approximately 30 meters.
Minimum Value = 1
Maximum Value = 10
Default Value = 1
Allow Decimal Values = YES
Allow Value of Zero = NO
Press the Add to Wizard button.
Repeat for "loops" and enter the information:
Brief Description
Number of Corkscrews in a Row?
Detailed Description
The number of corkscrews in a row to build.
Minimum Value = 1
Maximum Value = 4
Default Value = 1
Allow Decimal Values = YES
Allow Value of Zero = NO
After adding this variable to the wizard, the bottom half of the window should be similar to this:
Notice that we did not include the "lc" variable.
This is because we do not want the end-user to be able to modify that variable from the wizard.
|