You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ofbiz.apache.org by jl...@apache.org on 2009/11/23 14:15:09 UTC
svn commit: r883333 - in /ofbiz/trunk/framework/testtools:
data/helpdata/HELP_WEBTOOLS_selenium.xml
documents/OfbizSeleniumSetupHTTPS.xml
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>