Directions
Table of Contents
Start by navigating to the Roll page (http://nadaka.us/DiceBox/Roll.aspx).
Three groups of fields appear, Optional Fields, Roll Dice Expression and Roll Classic Dice.
You can tell we are logged in because the User Management Menu displays the username "secondtest" instead of the word "Welcome".
The Optional Fields are optional.
You can leave them blank if you want to, but in this example we are going to enter an Alias and Comment.
Alias represents a name you are making the roll under, anyone can use any alias.
If you want to ensure your identity as the maker of the roll, make sure you are logged in under your user name;
Merely specifying an Alias will not be sufficient indication of identity.
Groups are not currently implemented.
Comments allow you to annote your roll with a bit of descriptive text.
Note that the Group and Comment fields will not appear if you are not logged in.
The Roll Dice Expression fields allow you to enter simple or complex dice expressions using the grammar on the info page (http://nadaka.us/DiceBox/Info.aspx).
You can create lists of values using the list operators '*' and ','.
You can use perens '(' and ')' to override order of operation.
You can roll die with the 'd' operator and roll exploding dice with the 'x' operator.
You can add/subtract numbers or dice with the '+' and '-' operators.
After constructing a dice expression, you can submit it with the Submit Expression button.
If the expression is invalid, an error message will appear, otherwise you will be redirected to the View page for your new roll.
The Roll Classic Dice fields allow you to enter a set of integers to roll a simple dice expression in the form of XdY+Z.
This is a simpler and less flexible alternative to entering a Dice Expression above and you can submit a roll either way.
The first field is the number of dice to roll.
The second field, following the 'd', is the size of the dice to roll.
The final number, after the '+', is a number to add to the roll either positive or negative.
After entering numbers in at least the first two fields, you can submit it with the Submit Classic button.
If the numbers invalid, an error will appear, otherwise you will be redirected to the View page for your new roll.
The View page (http://nadaka.us/DiceBox/View.aspx) allows you to view detailed information a single roll.
You can use the Roll Id field and the Lookup button to view a specific roll, or the Roll Id can be encoded in the page url.
The User field displays the User Name and Id if applicable and links to the search page for rolls under that user.
The Alias field displays the Alias Name and Id if applicable and links to the search page for rolls under that alias.
The Created field displays the exact time this roll was made.
The Expression field displays the expression used (a classic roll is displayed as an expression).
The Total field displays the total value of all values generated by the roll.
The Values field displays a comma separated list of all the values generated by the roll.
The Comments area displays all comments for the roll, a RollComment is the comment made when the roll was originally produced.
If you are logged in, below the comments list a comment field and submit button will allow you to leave a comment.
To do so, enter text in the text field and click the Leave Comment button.
The new comment will be displayed with a type of RollResponse.
Any logged in user can leave a RollResponse.
Only the original roller can leave a RollComment, and then only before he knows the result of the roll.
Now lets use the search feature. Start by navigating to the Search page (http://nadaka.us/DiceBox/Search.aspx).
On the search page you can search for rolls by an extensive variety of parameters.
These can be entered in the provided fields or can be entered via the url.
Currently, you can only use one parameter and value at a time to search.
The drop down menu allows you to select a specific search filter.
Filters ending in "Like" take a string parameter with allowed wildcard characters '_' and '%' that match 1 and 0 or more characters respectively.
Filters beginning with Created expect a value in a valid DateTime format.
All other filters expect numeric (integer) values.
The NoFilter filter effectively ignores any value and displays a list of all rolls.
After selecting a filter and entering a value, click the Search button to find the specified rolls.
After a filter has been selected In this case we choose the UserNameLike filter and enter a value that will match the username used previously in these directions.
The results of the search display below the search fields.
If this search had returned enough rolls, only the first 20 would be displayed.
The rest could be viewed through the paging navigation links in the Results area.
Unlike the View page, a limited number of fields are displayed for each roll.
You can view the rest of the fields by clicking the View link in the Action column.
