*Petals View : User Guide*
\\
\\
Petals View 's main menu (leftpanel) is composed of three main sections:
* Flow Supervision: allows monitoring of ongoing or finished flows, either on a global view of all flows, or a more detailed view of one flow type (pre-requires referential import).
* Referential: this section's menus are used to define the flows in their different levels: steps, parameters, success/error messages, referential import/export.
* Administration: allows to define application's users and roles.

On first launch of the application, you must use login: admin and password: admin



!Welcom.png|thumbnail,border=1!


h1. Administration

h2. Roles management

Petals View is provided with an out-of-the-box role: ''admin''. This role is omnipotent, and cannot be renamed or changed. Only its access rights can be modified.

\\ !ListOfRoles.png|thumbnail,border=1!\\

To create a new role, click on the "create role" button to get the following screen:

\\ !CreateNewRole.png|thumbnail,border=1!

Here you have to  :
* Type in your new role's name
* Choose its access rights:
          Managing flow supervision: with this checked, the role can access all of the Flow Supervision menu.
          Managing Referential: with this checked, the role can access all of the Referential menu: view, create, modify, import and export referentials.
          Managing Users: with this checked, role can consult, create and modify Petals View's roles and users.

  !CreateNewRoleFull.png|thumbnail,border=1!

* Clicking on the "Submit" button will save the new role and automatically get you to its view/modification screen (you can also access this screen by clicking on the referential name when viewing list of roles).

!ViewEditRole.png|thumbnail,border=1!\\

Role viewing/edition screen is composed of two tabs:
* Identity card: here you'll find all information provided during role creation. You can change its by clicking on "Modify".
* Users list: you can define here which users will be associated with this role. To add a user, click on "Add". To delete one, click on "Delete".

h2. Manage users

One user is provided out-of-the-box: ''admin''. This user has the "admin" role by default so it has full access to the application. He cannot be renamed nor deleted, but you can modify its password and roles.

\\ !ListOfUsers.png|thumbnail,border=1!


To create a new user, click on "Create user" and you'll get on the following screen:

!CreateNewUser.png|thumbnail,border=1!


Here define its login id and password.

\\ !CreateNewUserFull.png|thumbnail,border=1!


Clicking on "Submit" will save the new user and take you to its View/Edition screen. You can later access this page by clicking on the user's name in the users list.

!ViewEditUser.png|thumbnail,border=1!


This user's viewing/edition screen is composed of two tabs:
* Identity card: here are listed all informations provided during user's creation. To modify its, just click on "Change password" (to change login password) or "Modify" (to change other information).
* List of roles: you can define here what are the roles associated with that user. To add a role, click on "Add", to delete one, click on "Delete".

h1. Referential management

The Referential section is the place to define the flow types: steps, parameters, error/success messages... And to import/export referentials.
For this part, we'll suppose you already have generated a flow, that was saved in the database, by following the tutorial example.

h2. Creation of a new flow type

Clicking on "Referential management" item of the "Referential menu" opens a screen showing, in a table, all the flow types detected in the application. If no flow has been saved in database yet, you'll see the following screen:

!ViewAllRefWithoutUnknownFlow.png|thumbnail,border=1!


Here you can click on "ADD" to create a new flow type by following further instructions of this user guide.
If flows have been already saved in the database, without associated referentials, you'll get the following screen:

\\ !ViewListFlowRefWithUnknownFlow.png|thumbnail,border=1!


Here we don't have any yet, only one "Unknown" type. Click on it to get this screen:

!CreateReferentialByUnknownFlow.png|thumbnail,border=1!


With this method, the "Type" field is automatically filled in to match the flow in the database. You can't therefore change it. (If you created a referential "from scratch", you'd have to fill in the field yourself, and ensure the number you type doesn't interfere with another flow type).
The "Name" field is manatory, fill it in (preferably with a human-readable name) to be able to create the referential.

\\ !CreateFlowRefbyUnknowFlowFull.png|thumbnail,border=1!


Click on "Create" to save the new flow type and automatically get the screen to further configure/modify it.

h2. Viewing/Edition of a flow type

- The list of "unknown" steps associated to our flow (NB: if you create a flow type "from scratch", you won't get this table).
- The Steps that you already configured. Click on "Add" to create new steps to add steps not yet saved in the database, or if you had created the referential "from scratch". 
- Flows deletion rules : Here, you must configure the number of days from which you want to remove flows. If you don't specify the number of days, and you click delete from view by type of flow, you will delete all flows of this type.

* The "Service Name" is also mandatory, and has to be filled in with your step's JBI Service Name. Here, it has also been automatically filled in, except if you created a new step from scratch.
* The "Start flow?" and "End flow" boxes let you define whether this step is the first one and/or the last one of a processus.
* What message will be displayed when step is successfully finished

By default, to avoid interference with already defined parameters, the "Index" field of this screen will have a value defined by adding 1 to the last existing one. For example, if four functional fields were already defined (index 0, 1, 2, 3), the filled in value will be 4 (first available value).
If the user deliberately fills in a value already used, the new functional field will be inserted with this number, while all subsequents fields will see their values incremented by one, to avoid interference.
Another field is the "Global" checkbox. If you check it, this parameter will be viewable in step view as well as in general view of a flow type's instance.
\\
You can also modify a functional field's name by clicking on it, or suppress some by ticking their checkboxes then click on "Delete".

This part of Petals View allows visualization of daily flows instances, either ongoing or finished. You can see them either from a global view (all flows from all flow types) or from a view focused on one flow type.
When clicking on "Global View", a screen appears with a list of all ongoing/finished flows.
\\ !worddav8767e286467e1301ca0697ed3f47c2c0.png|height=316,width=604!
Default behaviour only lists daily flows (if their starting date is identified).
You can filter the view by selecting a period of time applying on starting date ("after the" and/or "before the").
You can also filter the view by flow status or flow type, thanks to the dropdown menus located in table header.
"See all flows" buttons makes Petals View displays any and all flows, including the unknown ones, without any time limitation
"Refresh" button allows to update the table to check latest flows.
"Export" button exports the table you see on the screen in CSV (the separation of the results is ";").
"Delete" button will remove the flow of a type which the number of days has been configured in the referential.
Warning, if you have a large quantity of flows in your database that you want to delete, this operation can take several minutes.
\\

To analyse a flow in detail, click on its instance identifier (the number) in the table.
!worddav28e4fe1f606db66064f95f2d3866a4da.png|height=358,width=604!
A new screen arrives, displaying, in addition to general information of the flow, the different steps and their status. This allows easy diagnosis of the causes of a processus failure. Global functional fields and their values are also displayed.
"Refresh" button updates this screen with latest infos.
Clicking on a step brings you a detailed dynamic view of this step:
\\
Finally, you can display all flows of a chosen type by clicking on its name in the "Flow supervision" menu of left panel. !worddav236448af4bc34b8a3e6c47ea75919c32.png|height=348,width=604!\\ !worddavaf9a7ce14dc64e964b06970785c3fb9a.png|height=317,width=604!

All editing, filtering refreshing and exporting features are the same as in Global view, with added possibility to filter view by a parameter.
Here, you have a button for more: "Delete" button will remove the flow of a type which the number of days has been configured in the referential.
Warning, if you have a large quantity of flows in your database that you want to delete, this operation can take several minutes.

Two methods, which allow to find all referentials (getAllFlowReferentialType()) and delete the flows(removeOldFlow(int type)) are exposed webservice.