Creating a New Data Source for an XWiki Table

*USE CASE: Create a New Data Source for an XWiki Table*

*Primary Actor: User

*Scope: XWiki

*Level: User goal

*Stakeholders and Interests:
User: Wants to create a new data source for an XWiki table.
Creation Wizard: Gathers and validates all the necessary information for creating a data source.
Server: Serves processing requests made by the creation wizard.

*Precondition: The user has logged into her XWiki account and has permission to modify the current page

*Minimal guarantee: All the mandatory information is entered by the user (i.e. the XWiki page and the XWiki table) and is valid.
Success guarantee: The server receives the data source creation request, creates a data source object, successfully includes it into the current page and acknowledges success to the user.
Trigger: User selects the "Create Data Source" option from the XWiki menu

*Main success scenario:
1.User selects the "More Actions - Edit - Create Data Source" option from the XWiki menu.
2.An XWiki page entitled " Data Source Creation Wizard" containing an HTML form is presented to the user.
3.The user selects "XWiki Table" as the data source type.
4.The data source creation wizard processes the input and presents the next choice.
5.The user fills in an edit-box with the full name of the page that contains the table. Initially the edit-box is filled with the full name of the current page, and as the user types something in, the edit-box presents possible options to the user (auto completion). This auto completion happens one dot-separated component at a time.
6.The data source creation wizard processes the input and presents the next choice.
7.The user in presented with a graphical representation of all the XWiki tables in the selected page.
8.The user selects with the mouse either a table as a whole, or a range in a table.
9.The data source creation wizard processes the input and presents the next choice.
10.The user may select other optional parameters of the data source (e.g., filtering).
11.The user selects the "Finish" button and the new data source is created.
12.The data source creation wizard assures that user input is valid and sends it to the server.
13.The server adds the data source to the current page and acknowledges success to the data source creation wizard.
14.The data source creation wizard terminates and the current XWiki page is refreshed in order to show the chart.

*Extensions:
1a. When the user does not have permission to modify the current page the whole "Edit" section will not be displayed in the "More Actions" menu, so the user cannot create a new data source.
4a. 6a. If the user input is not valid the user is presented with an explicative dialog and it is not allowed to go to the next step of the wizard.
12a. If the user input is not valid the user is presented with an explicative dialog.
13a. If an error occurs at this step the data source creation wizard will be notified of the failure, and will in turn notify the user by displaying an explicative dialog.