UserGuide

compared with
Key
This line was removed.
This word was removed. This word was added.
This line was added.

Changes (30)

View Page History
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!

!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

This screen can also be accessed by clicking on the flow type name in flow types list.
On this screen you can see: !worddav0a8514fd13c372e3192b3389d65b9cca.png|height=406,width=604! see:  !ViewFlowReferentialEn.png|thumbnail,border=1!
- Its General informations, namely its "Type" (non-editable) and name (editable, as long as it is an unique one).
- The Global functional fields of this flow type, associated to the steps in which they are defined.
\\

To configure an unknown step, click on it, for example the first one, to get the following screen: !CreateNewFlowRefStepEIPEmpty.png|thumbnail,border=1!

* The "Functional name" is mandatory, it's the human-readable name that you want yo give to your step. !worddav0bf5702dab5462bfcbc0cdd65ad70a10.png|height=303,width=597! step. 
* The "Interface name" field is mandatory, it has to be filled in with the name of the JBI interface name of your step. Here, it's been automatically filled in since informations were saved in the database. If you want to add a step from scratch, you'll have to fill it in.
* 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.
* What message will be displayed if step failed and returned an error. Default message will be used if the returned error code isn't referenced.

You can also modify an already configured step by clicking on its name in the table. !ViewFlowRefStepEIP.png|thumbnail,border=1!
\\ !worddave9064d22ff7694565ed7a76db54cad96.png|height=457,width=604!
On this screen, you can modify the general informations. Note that the associated parameters are numbered. If you see a 0, that means no parameters have been associated with the step in the database yet.
To add a functional field (parameter of the processus) click on "Add" button of the "Functional fields" table.
\\ !worddav68459aa542a33cc8bbd9f2101c8c884d.png|height=318,width=604!
\\ !AddParameterForEIP.png|thumbnail,border=1!

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.
\\
You can add custom error messages by click on "Add" button of error table.
\\ !worddav76b052b4164035a37a457855453641e9.png|height=318,width=604!
An error is an code (>0 integer), accompanied with informations on it, sent when a step fail. You can also modify an existing error message by clicking on its code in erorr tables. Finally you can delete error messages by ticking the checkboxes then click on "Delete" button.
\\ !AddParameterForEIP.png|thumbnail,border=1!

An error is an code (>0 integer), accompanied with informations on it, sent when a step fail. You can also modify an existing error message by clicking on its code in erorr tables. Finally you can delete error messages by ticking the checkboxes then click on "Delete" button.
h2. Delete a flow referential

\\
!ViewAllRef.png|thumbnail,border=1!\\
On this page, you can delete identified (configured) flow types by checking the corresponding boxes in the table then clicking on "Delete" button.

h2. Export a Referential

This feature allows you to export a referential an then import it in any Petals View instance. This is mainly useful to quickly set up a production environment by reusing configurations made on development instance.
To export a referential, just check the boxes of the one(s) you want to export then click on "Export" button. !ExportRef.png|thumbnail,border=1!
\\

h2. !worddavca91dbc456f2e1138116d66c65c9574f.png|height=318,width=604! Import a Referential

This feature allows you to import a referential that you previously exported. This screen is composed of two tabs:
Import data by URL: provide an absolute url.
Import data by file: browse your computer to select the adequate .xml file. !ImportRefEn.png|thumbnail,border=1!
\\

h1. Flow Supervision !worddav7921ffce3c379157e7d97bd7e4b3c092.png|height=319,width=604!
h1. Flow Supervision 

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.