Author: jleroux
Date: Mon Nov 23 13:15:09 2009 New Revision: 883333 URL: http://svn.apache.org/viewvc?rev=883333&view=rev Log: Some other fixes in help files Modified: ofbiz/trunk/framework/testtools/data/helpdata/HELP_WEBTOOLS_selenium.xml ofbiz/trunk/framework/testtools/documents/OfbizSeleniumSetupHTTPS.xml Modified: ofbiz/trunk/framework/testtools/data/helpdata/HELP_WEBTOOLS_selenium.xml URL: http://svn.apache.org/viewvc/ofbiz/trunk/framework/testtools/data/helpdata/HELP_WEBTOOLS_selenium.xml?rev=883333&r1=883332&r2=883333&view=diff ============================================================================== --- ofbiz/trunk/framework/testtools/data/helpdata/HELP_WEBTOOLS_selenium.xml (original) +++ ofbiz/trunk/framework/testtools/data/helpdata/HELP_WEBTOOLS_selenium.xml Mon Nov 23 13:15:09 2009 @@ -17,33 +17,27 @@ specific language governing permissions and limitations under the License. --> -<section xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" - xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" +<section xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://docbook.org/ns/docbook ../../../../applications/content/dtd/docbook.xsd"> <title>OFBiz SeleniumXml</title> - <para> This is a short document to help you get started using SeleniumXml to test your OFBiz - application. Here is a <link - xl:href="http://us.apachecon.com/presentation/materials/118/ApacheCon2008_SeleniumXml.pdf" - >copy of the presentation</link> that was given at the ApacheCon2008 OFBiz Conference - that describes more about the project. </para> + <para> This is a short document to help you get started using SeleniumXml to test your OFBiz application. Here is a <link + xl:href="http://us.apachecon.com/presentation/materials/118/ApacheCon2008_SeleniumXml.pdf">copy of the presentation</link> that was given + at the ApacheCon2008 OFBiz Conference that describes more about the project. </para> <section> <title>Installing SeleniumXml</title> <para> <orderedlist> <listitem> - <para>From the ofbiz directory run the following ant command to download the - needed selenium- server.jar file.</para> + <para>From the ofbiz directory run the following ant command to download the needed selenium- server.jar file.</para> </listitem> <listitem> <para>ant download-selenium</para> </listitem> <listitem> - <para>ant run-install-extseed (For run install help data and example - test)</para> + <para>ant run-install-extseed (For run install help data and example test)</para> </listitem> <listitem> - <para>Build the source by running "ant" in the testtools directory or your - OFBIZ_HOME</para> + <para>Build the source by running "ant" in the testtools directory or your OFBIZ_HOME</para> </listitem> </orderedlist> </para> @@ -51,44 +45,37 @@ </section> <section> <title>Running the Example Test</title> - <para>SeleniumXml requires the selenium server to be running. The selenium server uses a - default proxy port of 4444. The default port can be changed when you start the server. - Selenium tries to automatically change the proxy settings in the testing browser. If you - are getting communication errors with the server you may have to manually change your - proxy settings in your browser.</para> + <para>SeleniumXml requires the selenium server to be running. The selenium server uses a default proxy port of 4444. The default port can be + changed when you start the server. Selenium tries to automatically change the proxy settings in the testing browser. If you are getting + communication errors with the server you may have to manually change your proxy settings in your browser.</para> <section> <title>1. Start ofbiz as normal.</title> - <para>Note: Before run ofbiz with selenium should changes ofbiz to use HTTP as the - default at file (framework/webapp/config/url.properties) . Instead everything just - works through port 8080. Selenium supports https but it is more complicated so for - this introduction I have turned https off.</para> + <para>Note: Before run ofbiz with selenium should changes ofbiz to use HTTP as the default at file + (framework/webapp/config/url.properties) . Instead everything just works through port 8080. Selenium supports https but it is more + complicated so for this introduction I have turned https off.</para> </section> <section> <title>2. Start the selenium server:</title> <para>runSeleniumServer.bat / runSeleniumServer.sh </para> </section> <section> - <title>3. Change the configuration for your preferred browser in the - testtools/config/seleniumxml.properties file. The default is firefox (e.g. - browser=*firefox) but you can change it to any of the selenium supported - browsers.</title> + <title>3. Change the configuration for your preferred browser</title> + <para>In the testtools/config/seleniumxml.properties file: the default is firefox (e.g. browser=*firefox) but you can change it to any of + the selenium supported browsers.</para> <para> - <link xl:href="http://seleniumhq.org/about/platforms.html#browsers">Selenium - supported browsers you can find here</link> + <link xl:href="http://seleniumhq.org/about/platforms.html#browsers">Selenium supported browsers you can find here</link> </para> </section> <section> <title>4. Run the Example test</title> <section> <title>4.1 run the Example test .bat/.sh file</title> - <para>runSeleniumXml.bat / runSeleniumXml.sh - testdef/seleniumxml/example/example_testsuite.xml</para> - <para>The above test combines three different tests into a single test suite. Data - is passed from one test to another to allow you to share generated data.</para> + <para>runSeleniumXml.bat / runSeleniumXml.sh testdef/seleniumxml/example/example_testsuite.xml</para> + <para>The above test combines three different tests into a single test suite. Data is passed from one test to another to allow you to + share generated data.</para> <para>You will get an assertion (or other exception) if the test fails.</para> - <para>The test uses a .5 second delay for demo purposes. (see example_testsuite.xml - and the setSpeed value="500" command). You can remove this at the start of the - test if you don't want the delay</para> + <para>The test uses a .5 second delay for demo purposes. (see example_testsuite.xml and the setSpeed value="500" command). You can + remove this at the start of the test if you don't want the delay</para> <para>- Here are some screen shots of what you should be seeing.</para> <!--para> <graphic fileref="/images/seleniums/ofbizSeleniumSetup1.jpeg" height="150" width="400"></graphic> @@ -99,37 +86,30 @@ </section> <section> <title>4.2 run the Example test webtools/Run Selenium</title> - <para> First you need to open the file example_testsuite.xml and comment out first - part.. and enable the bottom one Here is another way to run the selenium test - suite and you can create new test suite for your web application. Scroll up on - this page then you will see the link "Run Selenium" next to "Selenium Intro" - click on that link. On that page you will see the list of available test suites. - So you can click on "Run" to run the test suite you want but please remember - that the Selenium server should be started before you "run" any test. You can - also create new test suite by fill in the information to the form and put the - directory location of your test suite in the field "Test Suite Path" then - submit. If you want to know how the test is created you can take a look at the - file example_testsuite.xml for more info. </para> + <para> First you need to open the file example_testsuite.xml and comment out first part.. and enable the bottom one Here is another + way to run the selenium test suite and you can create new test suite for your web application. Scroll up on this page then you + will see the link "Run Selenium" next to "Selenium Intro" click on that link. On that page you will see the list of available test + suites. So you can click on "Run" to run the test suite you want but please remember that the Selenium server should be started + before you "run" any test. You can also create new test suite by fill in the information to the form and put the directory + location of your test suite in the field "Test Suite Path" then submit. If you want to know how the test is created you can take a + look at the file example_testsuite.xml for more info. </para> </section> </section> </section> <section> <title>Creating New Tests :</title> - <para>The easiest way to create a new test is to use the Selenium IDE plugin for Firefox. - This allows you to records your own Selenium tests. You can then save the test and - convert it to a seleniumXml test easily.</para> + <para>The easiest way to create a new test is to use the Selenium IDE plugin for Firefox. This allows you to records your own Selenium tests. + You can then save the test and convert it to a seleniumXml test easily.</para> <para> <orderedlist> <listitem> - <para>Install <link xl:href="http://seleniumhq.org/projects/ide/">the latest - plugin</link></para> + <para>Install <link xl:href="http://seleniumhq.org/projects/ide/">the latest plugin</link></para> </listitem> <listitem> <para>Record your steps as you run through your ofbiz application.</para> </listitem> <listitem> - <para>Then convert the saved XML file using the convertSeleniumIDE.bat - script.</para> + <para>Then convert the saved XML file using the convertSeleniumIDE.bat script.</para> </listitem> </orderedlist> </para> @@ -139,8 +119,7 @@ <para> <orderedlist> <listitem> - <para>convertSeleniumIDE.bat - testdef/seleniumxml/example/recorded/AjaxExample.html + <para>convertSeleniumIDE.bat testdef/seleniumxml/example/recorded/AjaxExample.html testdef/seleniumxml/example/recorded/AjaxExample.xml</para> </listitem> <listitem> Modified: ofbiz/trunk/framework/testtools/documents/OfbizSeleniumSetupHTTPS.xml URL: http://svn.apache.org/viewvc/ofbiz/trunk/framework/testtools/documents/OfbizSeleniumSetupHTTPS.xml?rev=883333&r1=883332&r2=883333&view=diff ============================================================================== --- ofbiz/trunk/framework/testtools/documents/OfbizSeleniumSetupHTTPS.xml (original) +++ ofbiz/trunk/framework/testtools/documents/OfbizSeleniumSetupHTTPS.xml Mon Nov 23 13:15:09 2009 @@ -17,25 +17,28 @@ specific language governing permissions and limitations under the License. --> -<section xmlns="http://docbook.org/ns/docbook" - xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" +<section xmlns="http://docbook.org/ns/docbook" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://docbook.org/ns/docbook ../../../applications/content/dtd/docbook.xsd"> <section> <title>OFBiz SeleniumXml Introduction with HTTPS</title> <para>How to setup in firefox browser?</para> - <para> - The problem for https is that the seleniumÂRC 1.0 and later will be runs in a separate profile - automatically when the Selenium test is opening a new session for the Firefox browser the browser will - need a security certificate every time. When this occurs the browser displays security pop up, and these - pop up cannot be closed using SeleniumÂRC . So how to solve this? - </para> - <para> - Create a separate Firefox profile for your tests ( adding a https certificate or install some addÂons) - </para> + <para> The problem for https is that the seleniumÂRC 1.0 and later will be runs in a separate profile automatically when the Selenium test is + opening a new session for the Firefox browser the browser will need a security certificate every time. When this occurs the browser + displays security pop up, and these pop up cannot be closed using SeleniumÂRC . So how to solve this? </para> + <para> Create a separate Firefox profile for your tests ( adding a https certificate or install some addÂons) </para> <section> <title>For Ubuntu Linux : </title> - <para> - Make sure all your Firefox instances are closed .</para> - <para> - Open a new Terminal and type the command firefox -p -no-remote in the terminal then press enter. The pop up window will appear.</para> + <para> + <orderedlist> + <listitem> + <para>Make sure all your Firefox instances are closed .</para> + </listitem> + <listitem> + <para>Open a new Terminal and type the command firefox -p -no-remote in the terminal then press enter. The pop up window will + appear.</para> + </listitem> + </orderedlist> + </para> <!--screenshot> <graphic fileref="/images/seleniums/profile1.png" width="300" height="300"></graphic> <caption> @@ -47,22 +50,14 @@ <!--screenshot> <graphic fileref="/images/seleniums/profile3.png" width="400"></graphic> <caption--> - <para> - After that click âStart Firefoxâ and configure settings based on suggestion below - </para> - <section> - <title>warrning*</title> - <para> - Be sure to put your profile in a new folder separate from the default!!! - </para> - <para> - The Firefox profile manager tool will delete all files in a folder if you delete - </para> - <para> - a profile, regardless of whether they are profile files or not. - </para> - </section> - <!--/caption> + <para>After that click âStart Firefoxâ and configure settings based on suggestion below </para> + <section> + <title>warrning*</title> + <para> Be sure to put your profile in a new folder separate from the default!!! </para> + <para> The Firefox profile manager tool will delete all files in a folder if you delete a profile, regardless of whether they are + profile files or not. </para> + </section> + <!--/caption> </screenshot--> </section> <section> @@ -72,36 +67,67 @@ <para>Remove âGoogle searchâ by dragging it to the âCustomize Toolbarâ window </para> <para>From the âCustomize Toolbarâ window, click âUse Small Iconsâ check box then hit âDoneâ</para> <para>Click âEdit\Preferencesâ then set the following:</para> - <section> - <title>âMainâ tab</title> - <para>- set Home Page to âabout:blankâ</para> - <para>- uncheck âShow the Downloads..â option</para> - </section> - <section> - <title>âTabsâ tab</title> - <para>- Select âa new windowâ for new pages</para> - <para>- Uncheck all warning options</para> - </section> - <section> - <title>âContentâ tab</title> - <para>- uncheck âBlock pop-upâ windows option</para> - </section> - <section> - <title> âPrivacyâ tab</title> - <para>- uncheck all âHistoryâ options</para> - </section> - <section> - <title>âSecurityâ tab</title> - <para>- uncheck all âSecurityâ options</para> - <para>- click âSettingsâ and uncheck all warning options</para> - </section> - <section> - <title>âAdvancedâ tab</title> - <para>- Uncheck âautoscrollingâ option from âGeneralâ tab</para> - <para>- uncheck âwarn me â¦â and âSsearch Enginesâoption from âUpdateâ tab </para> - </section> - - <!--listitem>1.From âTools\Add-onsâ install the following: + <section> + <title>âMainâ tab</title> + <para> + <orderedlist> + <listitem> + <para>set Home Page to âabout:blankâ</para> + </listitem> + <listitem> + <para>uncheck âShow the Downloads..â option</para> + </listitem> + </orderedlist> + </para> + </section> + <section> + <title>âTabsâ tab</title> + <para> + <orderedlist> + <listitem> + <para>Select âa new windowâ for new pages</para> + </listitem> + <listitem> + <para>Uncheck all warning options</para> + </listitem> + </orderedlist> + </para> + </section> + <section> + <title>âContentâ tab</title> + <para>uncheck âBlock pop-upâ windows option</para> + </section> + <section> + <title> âPrivacyâ tab</title> + <para>uncheck all âHistoryâ options</para> + </section> + <section> + <title>âSecurityâ tab</title> + <para> + <orderedlist> + <listitem> + <para>uncheck all âSecurityâ options</para> + </listitem> + <listitem> + <para>click âSettingsâ and uncheck all warning options</para> + </listitem> + </orderedlist> + </para> + </section> + <section> + <title>âAdvancedâ tab</title> + <para> + <orderedlist> + <listitem> + <para>Uncheck âautoscrollingâ option from âGeneralâ tab</para> + </listitem> + <listitem> + <para>uncheck âwarn me â¦â and âSsearch Enginesâoption from âUpdateâ tab </para> + </listitem> + </orderedlist> + </para> + </section> + <!--listitem>1.From âTools\Add-onsâ install the following: <para>- Firebug: allows you to edit, debug, and monitor CSS, HTML, and JavaScript on your application under test</para> <para>- Selenium IDE: allows you to record, edit, and debug Selenium tests</para> <para>- ScreenGrab: saves entire webpages as images. </para> @@ -113,11 +139,10 @@ </orderedlist--> </section> - </section> <section> - <title></title> - <para></para> + <title/> + <para/> <!--para> Set certificate for your firefox profile type and enter <ulink type="http" url="https://localhost:8443/"></ulink> (* An url you want to get certificate.) then add an exception @@ -128,27 +153,44 @@ </screenshot--> </section> <section> - <title></title> - <para>At the file âseleniumXml.propertiesâ.</para> - <para>Change browser=*firefox</para> - <para>To browser=*firefox /usr/lib/firefox-3.0.8/firefox</para> + <title/> + <para> + <orderedlist> + <listitem> + <para>At the file âseleniumXml.propertiesâ.</para> + </listitem> + <listitem> + <para>Change browser=*firefox</para> + </listitem> + <listitem> + <para>To browser=*firefox /usr/lib/firefox-3.0.8/firefox</para> + </listitem> + </orderedlist> + </para> <para>(*** firefox path)</para> </section> <section> - <title></title> - <para>At the file ârunSeleniumServer.shâ </para> - <para>"$JAVA" -jar ../../framework/testtools/lib/selenium-server.jar </para> - <para>-firefoxProfileTemplate "put path to the profile dir" </para> - <para>-trustAllSSLCertificates -singleWindow -timeout 240 + <title/> + <para> + <orderedlist> + <listitem> + <para>At the file ârunSeleniumServer.shâ </para> + </listitem> + <listitem> + <para>"$JAVA" -jar ../../framework/testtools/lib/selenium-server.jar </para> + </listitem> + <listitem> + <para>firefoxProfileTemplate "put path to the profile dir" </para> + </listitem> + <listitem> + <para>trustAllSSLCertificates -singleWindow -timeout 240 </para> + </listitem> + </orderedlist> </para> </section> <section> <title>Note : Please follows the link</title> - <para> - <!--ulink> http://docs.ofbiz.org/display/OFBIZ/Ant+Script+to+build+new+ofbiz+self+cert </ulink--> - </para> - <para> - if your found the problem âofbiz.org cert is expired causes peer not authenticatedâ. - </para> + <para><!--ulink> http://docs.ofbiz.org/display/OFBIZ/Ant+Script+to+build+new+ofbiz+self+cert </ulink--></para> + <para> if your found the problem âofbiz.org cert is expired causes peer not authenticatedâ. </para> </section> -</section> \ No newline at end of file +</section> |
Free forum by Nabble | Edit this page |