###################### action #######################
-syncDatabase :restores the original  : 
      <action name="syncDatabase" />
-syncCatalog : the oracle retrieves the catalog from the ps _database (might take some time) : 
      <action name="syncCatalog" />
-scan : scan the barcode given in the "barcode" param : 
    <action name="scan" barcode="1234567890123" />
-clearCart : empties the current cart :
     <action name="clearCart" />
-defaultPage : makes the navigator go to the default page (Catalog tab>Catalog BrowseMode> Home) :
  <action name="defaultPage" />

####################### config ########################
-randomPriceMax : configures the max random price that can be given to a free product
  <config var="randomPriceMax" value="1000" />
-browseMode : configures the browseMode when looking 
  <config var="randomPriceMax" value="1000" />


##################### unitTests ######################


        ####### addToCart #######
possibles parameters  : 
-None : simply add a random product to the cart.
-idProduct (integer)/idProductAttribute (integer) : will browse the catalog and look for the given product. If no idProductAttribute is given
then if the product has variations, we'll pick a random variation.
-category (integer)/ position(integer) will go to the given category and position and pick the article. The method will fail if no item corresponds to the given parameters.
  is found. if category <0, a random category will be chosen (the first non empty one), if position <0, a random position will be chosen. 
-type (free/withVariations/std) : will look for all the products of the given variety and pick a random one among these (needs to be called after syncCatalog)

Available options : 
browseMode : "quick" or "catalog"
<param name="browseMode" value="quick" />


** Possible ways to add an item to the cart : **

1°) with categoryIndex and productIndex
will go to the given category and product position and pick the article. The method will fail if no item corresponds to the given parameters.
if categoryIndex <0  or is not provided, a random category will be chosen (which might be empty. In this case, no item will be added),
CategoryIndex might be 0 (the programm will browse the catalog's homePage on which there are both categories and product 
 if productIndex  <0 or is undefined , a random one will be chosen. 
eg :
	<test id="cart22" descr="Add random article in the 3rd category" skip="true">
		<unitTest category="cart" name="addToCart" times="1">
			<param name="categoryIndex" value="3" />
			<param name="productIndex" value="3" />
			<param name="browseMode" value="quick" />
		</unitTest>
	</test>
will select the 3rd item in the 3rd category in the "quick" view.


	<test id="cart23" descr="Add random article in the 3rd category" >
		<unitTest category="cart" name="addToCart" times="1">
			<param name="categoryIndex" value="3" />
			<param name="browseMode" value="catalog" />
		</unitTest>
	</test>
will select a random item in the 3rd category in the "catalog" view

	<test id="cart24" descr="Add random article in the 3rd category" >
		<unitTest category="cart" name="addToCart" times="1">
			<param name="productIndex" value="3" />
		</unitTest>
	</test>
will select the 3rd item in a random category -------> might fail

	<test id="cart25" descr="Add random article in the 3rd category" >
		<unitTest category="cart" name="addToCart" times="1">
		</unitTest>
	</test>
will select a random article in a random category. If the category is empty. No item will be added and the test wont fail

2°)Using product id : 

	<test id="Cart1" descr="Adding menu (Barcelone+Brioche+Coca zero) and Paris to cart" skip="true">
		<unitTest category="cart" name="addToCart" times="1">
			<param name="idProduct" value="13" />
			<param name="idProductAttribute" value="1600" />
		</unitTest>
	</test> 
will pick an item with the  idProduct 13 and idProductAttribute 1600 (if it exist and fail otherwise)

	<test id="Cart1.1" descr="Adding menu freeProduct" >
		<unitTest category="cart" name="addToCart" times="1">
			<param name="idProduct" value="134" />
			<param name="freePrice" value="51" />
		</unitTest>
	</test> 
will pick an item with the idProduct 134 and if it is a free price product, it will give it the price 51

	<test id="Cart2"  descr="Adding a random STD article" skip="false">
		<action name="syncCatalog" />
		<unitTest category="cart" name="addToCart" times="3">
			<param name="type" value="std" />
		</unitTest>
	</test>
Will pick a random STD article in the catalog (hence the synCatalog) and add it to the cart (3 times in a row)


	<test id="Cart3"  descr="Adding a random Free price product" skip="false">
		<action name="syncCatalog" />
		<unitTest category="cart" name="addToCart" >
			<param name="type" value="free" />
		</unitTest>
	</test>
Will pick a random Free price product in the catalog and add it to the cart (with a random price). A catalog synchronization must be performed before this test.

	<test id="Cart4"  descr="Adding a random product with variations" skip="false">
		<action name="syncCatalog" />
		<unitTest category="cart" name="addToCart" >
			<param name="type" value="withVariations" />
		</unitTest>
	</test>
Will pick a random variation of a random product with variations



// Browse with categoryIndex and productIndex.
<unitTest category="cart" name="addToCart" >
<param name="type" value="withVariations"/>
</unitTest>


//Examples 

<unitTest category="cart" name="addToCart" >
<param name="type" value="withVariations"/>
</unitTest>



<unitTest category="cart" name="addToCart" >
<param name="type" value="free"/>
</unitTest>


<action name="syncCatalog" />
<unitTest category="cart" name="addToCart" >
<param name="type" value="withVariations"/>
</unitTest>



checkCart : 
compares the html Cart,  with the expected one (described in xml)

possibles parameters  : 
useId (default true) : Set to true to take into account the id (id_product_attribute,id_product, reduc_id) during the comparison
usePosition (default false) Set to true to take into account the position of the items during the comparison
expected description : 
 cart : 
a list of cartItem and reduc
  * cartItem :  can be described with the attributes : 
    -idProduct: default is a  negative integer (unique in the cart)
    -idProductAttribute : default is 0
    -pos: default is 0 
    -cumulativePrice : mandatory
    -n : number of times the item has been added to the cart. Mandatory
  * reduc :  can be described with the attributes : 
    -id: default is a  negative integer (unique in the cart)
    -pos: position in cart relative to the others reduc, default is 0
    -amount : a negative float (mandatory)

//Example : 
<descr name="cart">
  <cartItem idProduct="23" idProductAttribute="55" pos="2" cumulativePrice="53" n="1"/>
  <cartItem idProduct="1" idProductAttribute="0" pos="1" cumulativePrice="3.7" n="1"/>
</descr>


##################### causes possibles d'échecs de tests ######################
erreurs d'arrondi (côté java).
L'interface html a changé.