Skip to main content
summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
Diffstat (limited to 'org.eclipse.jubula.documentation/userManual/en/docbook/toolkit')
-rw-r--r--org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/chapter.xml1
-rw-r--r--org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/webAUT/content.xml34
-rw-r--r--org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/webAUT/sectionDesignForTestabilityInHTMLAUTs.xml42
-rw-r--r--org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/webAUT/sectionIntroHTMLAUT.xml26
-rw-r--r--org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/webAUT/sectionSupportedHTMLAUTs.xml142
5 files changed, 0 insertions, 245 deletions
diff --git a/org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/chapter.xml b/org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/chapter.xml
index a4c912ae3..e41e60e8d 100644
--- a/org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/chapter.xml
+++ b/org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/chapter.xml
@@ -18,6 +18,5 @@
<xi:include href="rcpAUT/content.xml"/>
<xi:include href="gefTest/content.xml"/>
<xi:include href="javaFX/content.xml"/>
- <xi:include href="webAUT/content.xml"/>
</chapter> \ No newline at end of file
diff --git a/org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/webAUT/content.xml b/org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/webAUT/content.xml
deleted file mode 100644
index 4fbadc7e7..000000000
--- a/org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/webAUT/content.xml
+++ /dev/null
@@ -1,34 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
- Copyright (c) 2014 BREDEX GmbH.
- All rights reserved. This program and the accompanying materials
- are made available under the terms of the Eclipse Public License v1.0
- which accompanies this distribution, and is available at
- http://www.eclipse.org/legal/epl-v10.html
--->
-
-<section xml:id="webaut" version="5.0" xmlns="http://docbook.org/ns/docbook"
- xmlns:xi="http://www.w3.org/2001/XInclude"
- xmlns:xl="http://www.w3.org/1999/xlink" >
-
- <title>Testing HTML AUTs</title>
- <anchor role="helpid" condition="projectWizardContextId" xml:id="webaut.projectWizardContextId" xreflabel="Creating a Project"/>
- <anchor role="helpid" condition="autConfigSettingWizardPagePageContextId" xml:id="webaut.autConfigSettingWizardPagePageContextId" xreflabel="Configuring an AUT"/>
- <anchor role="helpid" condition="autConfigPropDialogContextId" xml:id="webaut.autConfigPropDialogContextId" xreflabel="Adding/editing AUT configurations"/>
- <para>
- HTML AUTs are supported for testing. To be able to test HTML
- applications, select the <emphasis>HTML</emphasis> toolkit in the Project
- properties.
- </para>
- <para>
- When you select HTML as the Project toolkit, the library
- Projects <emphasis>unbound_modules_concrete</emphasis> and
- <emphasis>unbound_modules_html</emphasis> are automatically reused in your
- Project. The actions in these libraries are described in the
- reference manual.
- </para>
-
- <xi:include href="sectionSupportedHTMLAUTs.xml"/>
- <xi:include href="sectionDesignForTestabilityInHTMLAUTs.xml"/>
-
-</section> \ No newline at end of file
diff --git a/org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/webAUT/sectionDesignForTestabilityInHTMLAUTs.xml b/org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/webAUT/sectionDesignForTestabilityInHTMLAUTs.xml
deleted file mode 100644
index c3b58c8ca..000000000
--- a/org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/webAUT/sectionDesignForTestabilityInHTMLAUTs.xml
+++ /dev/null
@@ -1,42 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
- Copyright (c) 2014 BREDEX GmbH.
- All rights reserved. This program and the accompanying materials
- are made available under the terms of the Eclipse Public License v1.0
- which accompanies this distribution, and is available at
- http://www.eclipse.org/legal/epl-v10.html
--->
-
-<section xml:id="design-for-testability-html-auts" version="5.0" xmlns="http://docbook.org/ns/docbook"
- xmlns:xi="http://www.w3.org/2001/XInclude"
- xmlns:xl="http://www.w3.org/1999/xlink" >
- <title>Design for testability in HTML AUTs</title>
- <para>
- Although it is not obligatory to name components in your AUT,
- you neverthless make your AUT more testable by doing so.
- </para>
- <itemizedlist>
- <listitem>
- <para>
- Each supported component in HTML AUTs can have its own
- attribute used to identify it during test execution.
- </para>
- </listitem>
- <listitem>
- <para>
- In your AUT configuration (<xref linkend="autconfigbasic"/>) , you can
- define an attribute name which should be used as an
- identifier for components.
- </para>
- </listitem>
- <listitem>
- <para>
- For example if your attribute name is <emphasis role="input">testid</emphasis>
- (e.g.
- <emphasis role="input">&lt;div testid=''Username''&gt;&lt;/div&gt;</emphasis>)
- then you would enter <emphasis>testid</emphasis> in the AUT
- configuration.
- </para>
- </listitem>
- </itemizedlist>
-</section> \ No newline at end of file
diff --git a/org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/webAUT/sectionIntroHTMLAUT.xml b/org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/webAUT/sectionIntroHTMLAUT.xml
deleted file mode 100644
index 8ef2ee164..000000000
--- a/org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/webAUT/sectionIntroHTMLAUT.xml
+++ /dev/null
@@ -1,26 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
- Copyright (c) 2014 BREDEX GmbH.
- All rights reserved. This program and the accompanying materials
- are made available under the terms of the Eclipse Public License v1.0
- which accompanies this distribution, and is available at
- http://www.eclipse.org/legal/epl-v10.html
--->
-
-<section xml:id="intro-html-aut" version="5.0" xmlns="http://docbook.org/ns/docbook"
- xmlns:xi="http://www.w3.org/2001/XInclude"
- xmlns:xl="http://www.w3.org/1999/xlink" >
- <title>Introduction to writing tests for HTML AUTs</title>
- <para>
- HTML AUTs are supported for testing. To be able to test HTML
- applications, select the <emphasis>HTML</emphasis> toolkit in the Project
- properties.
- </para>
- <para>
- When you select HTML as the Project toolkit, the library
- Projects <emphasis>unbound_modules_concrete</emphasis> and
- <emphasis>unbound_modules_html</emphasis> are automatically reused in your
- Project. The actions in these libraries are described in the
- reference manual.
- </para>
-</section> \ No newline at end of file
diff --git a/org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/webAUT/sectionSupportedHTMLAUTs.xml b/org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/webAUT/sectionSupportedHTMLAUTs.xml
deleted file mode 100644
index bee056045..000000000
--- a/org.eclipse.jubula.documentation/userManual/en/docbook/toolkit/webAUT/sectionSupportedHTMLAUTs.xml
+++ /dev/null
@@ -1,142 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
- Copyright (c) 2014 BREDEX GmbH.
- All rights reserved. This program and the accompanying materials
- are made available under the terms of the Eclipse Public License v1.0
- which accompanies this distribution, and is available at
- http://www.eclipse.org/legal/epl-v10.html
--->
-
-<section xml:id="supported-html-auts" version="5.0" xmlns="http://docbook.org/ns/docbook"
- xmlns:xi="http://www.w3.org/2001/XInclude"
- xmlns:xl="http://www.w3.org/1999/xlink" >
- <title>Supported HTML AUTs</title>
- <para>
- AUTs written with the HTML GUI toolkit are supported according
- to the following points:
- </para>
- <itemizedlist>
- <listitem>
- <para>
- The HTML tests are driven by Selenium. We document which
- version of Selenium we are currently using as a driver in
- the release notes. Check the release notes for the current
- Selenium version and check the Selenium documentation for
- supported browsers.
- </para>
- </listitem>
- <listitem>
- <para>
- We strongly recommend writing HTML AUTs so that they are
- conform to the <emphasis>W3C</emphasis> standard. You can
- check whether your AUT is <emphasis>W3C</emphasis> conform
- using an online validator: http://validator.w3.org
- </para>
- </listitem>
- <listitem>
- <para>
- We recommend disabling the protected mode in Internet
- Explorer when testing HTML AUTs. This may be required in
- Windows 8+ when performing key combinations as a part of the
- test, but may also be required for other versions and other
- actions.
- </para>
- </listitem>
- <listitem>
- <para>
- Some of the actions in the <emphasis>concrete</emphasis>
- toolkit (i.e. which are theoretically valid for all AUT
- types) may not (yet) be supported. In some cases, this is
- because the component doesn’t exist as such in HTML AUTs
- (menu bars for example). In other cases, text components
- such as tables or lists do not have a concept for dealing
- with selection as they do in e.g. Swing.
- </para>
- </listitem>
- <listitem>
- <para>
- The <emphasis>autrun</emphasis> option to start AUTs
- (<xref linkend="starting-java-with-the-command"/>) cannot be used for HTML AUTs.
- </para>
- </listitem>
- <listitem>
- <para>
- There is a minor difference in the way that clicks are
- performed in HTML compared to other supported toolkits. In
- other toolkits such as Swing, an API is used to simulate
- actions at the OS level so that the the computer itself
- can’t distinguish whether it came from a tool or a keyboard.
- A normal click by a user in a browser would go via the mouse
- through various layers to the webserver, resulting in a
- request to that webserver. The clicks in the HTML toolkit
- are performed by firing DOM events using Javascript
- therefore bypassing the mouse level. So, although the
- computer can tell the difference, the webserver can’t.
- </para>
- </listitem>
- <listitem>
- <para>
- HTML AUTs can be tested in single-window or multi-window
- mode. If your AUT has functions that cause new windows to
- open, then you should specify this in the AUT configuration.
- You can then map components from different windows, and also
- use specific actions to switch windows during your test.
- Multi-window mode on Internet Explorer is considerably
- slower than on Firefox – this is a known issue registered at
- Selenium. There are known issues with AUT starting in
- multi-window mode on OSX systems for Firefox and on Safari –
- we do not test these combinations.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis role="strong">Closing HTML AUTs via the close
- button</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- If you close a HTML AUT by closing the browser, the ITE will
- correctly notice the closure after 5 seconds (configurable)
- and will remove the AUT from the running AUTs view.
- </para>
- </listitem>
- <listitem>
- <para>
- The mechanism works by polling the AUT, and if it is no
- longer there after the configured time, the AUT is
- considered to be stopped.
- </para>
- </listitem>
- <listitem>
- <para>
- If your AUT may sometimes be unreachable for longer than the default 5 seconds, you can change this time by using a process or system property:
- </para>
-
- <para>
- <emphasis role="input">TEST_MAX_AUT_RESPONSE_TIME=&lt;timeInMs&gt;</emphasis>.
- </para>
- </listitem>
- <listitem>
- <para>
- Further information on this is available in this issue:
- </para>
-
- <para>
- <link xl:href="http://bugzilla.bredex.de/1391">http://bugzilla.bredex.de/1391</link>.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- <emphasis role="strong">Overwriting launcher options now
- possible</emphasis>
- </para>
- <itemizedlist>
- <listitem>
- <para>
- You can now manually overwrite launcher options for the
- launchers for autrun, testexec and dbtool.
- </para>
- </listitem>
- </itemizedlist>
-</section> \ No newline at end of file

Back to the top