Skip to main content
summaryrefslogtreecommitdiffstats
blob: eb3be8d22fb87f4ad1d9138b6fd0a74cda9745f4 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
<?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="starting-web-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>Starting Web AUTs (HTML)</title>
  <anchor role="helpid" condition="autConfigSettingWizardPagePageContextId" xml:id="starting-web-auts.autConfigSettingWizardPagePageContextId" xreflabel="Configuring an AUT"/>
  <para>
    The AUT configuration dialog for HTML has three different levels
    of detail: basic, advanced and expert.
  </para>
  <para>
    See the sections below for information on the different levels.
  </para>
  <section xml:id="basic-html-aut-configuration">
    <title>Basic HTML AUT configuration</title>
    <para>
      Use the basic setting to specify the URL and Browser you wish
      to start this AUT configuration on.
    </para>
    <orderedlist>
      <listitem>
        <para>
          Enter the basic configuration details as described earlier
          (<xref linkend="basic-configuration-info"/>).
        </para>
      </listitem>
      <listitem>
        <para>
          You can optionally create a working directory to store
          files in (<xref linkend="using-working-dir-aut-config"/>).
        </para>
      </listitem>
      <listitem>
        <para>
          Enter the URL of your AUT.
        </para>
        <para role="warning">
          Relative paths to the
          URL cannot be used!
        </para>
      </listitem>
      <listitem>
        <para>
          Select the browser you want to start the AUT in.
        </para>
      </listitem>
    </orderedlist>
    <para>
      For information on the advanced properties for the AUT
      configuration, see the next
      <xref linkend="advanced-html-aut-config"/>.
    </para>
  </section>
  <section xml:id="advanced-html-aut-config">
    <title>Advanced HTML AUT configuration</title>
    <para>
      You can use the advanced dialog to enter the browser path for
      your browser. This lets you use a specific version of the
      browser (not available for Internet Explorer).
    </para>
    <para>
	Determine whether you want Selenium to use Webdriver technology
	during test execution. Keep in mind that this mode is experimental!
	If you want to use Webdriver technology, you also have to specify
	the path to the Webdriver on your machine, depending on your browser:
	<table>
		<title>
			References for specific Webdrivers
		</title>
		<tgroup cols="2">
			<colspec align="left" />
			<colspec align="left" />
			<thead>
				<row>
					<entry>
						<emphasis role="strong">Browser</emphasis>
					</entry>
					<entry>
						<emphasis role="strong">Driver</emphasis>
					</entry>
				</row>
			</thead>
			<tbody>
				<row>
					<entry>
						Internet Explorer
					</entry>
					<entry>
						Internet Explorer drivers are available <link xl:href="https://selenium-release.storage.googleapis.com/index.html">here</link>.
					</entry>
				</row>
				<row>
					<entry>
						Firefox Version 46 and below
					</entry>
					<entry>
						Firefox Version 46 and below provides an integrated driver.
					</entry>
				</row>
				<row>
					<entry>
						Firefox Version 47 and above
					</entry>
					<entry>
						Firefox Version 47 and above drivers are available <link xl:href="https://github.com/mozilla/geckodriver/releases">here</link>.
					</entry>
				</row>
				<row>
					<entry>
						Safari
					</entry>
					<entry>
						Safari provides an integrated driver.
					</entry>
				</row>
				<row>
					<entry>
						Chrome
					</entry>
					<entry>
						Chrome drivers are available <link xl:href="https://chromedriver.storage.googleapis.com/index.html">here</link>.
					</entry>
				</row>
			</tbody>
		</tgroup>
	</table>
	In Internet Explorer, you also have to disable the options
	"Display intranet sites in Compatibility View" and
	"Use Microsoft compatibility lists"
	in the Compatibility View Settings, and
	"Protected Mode" in the Internet Security Options.
    </para>
    <para>
      You can also specify whether you want to be able to use the
      multi-window support in your tests for this AUT. If your AUT
      has functions that open new windows, then deactivate the
      <emphasis>Single Window Mode</emphasis> checkbox. Any AUTs
      that are running in multi-window mode show the Selenium
      console as well as the AUT when the AUT is started. The Object
      Mapping Editor for multi-window AUTs has a button to allow
      switching between multiple open windows for mapping
      components, and there are actions in the HTML unbound modules
      to allow you to switch between windows during the test.
    </para>
    <para>
      Note that currently some webdrivers (notably Mozilla's geckodriver)
      has some issues with using multiple windows. Using these webdrivers
      may unexpectedly hang the tests, especially if popup windows are closed
      by user actions. In order to still be able to work with newer versions
      of Firefox, we introduced the action <emphasis>Close window</emphasis>.
    </para>
    <para>
      For information on the expert properties for the HTML AUT
      configuration, see the next
      <xref linkend="expert-html-aut-config"/>.
    </para>
  </section>
  <section xml:id="expert-html-aut-config">
    <title>Expert HTML AUT configuration</title>
    <para>
      You can use the expert dialog to enter an <emphasis>ID
      attribute name</emphasis> (<xref linkend="design-for-testability-html-auts"/>). If you have used a
      specific tag to name components in your application, enter the
      tag in the Expert Configuration area. This information is then
      used instead of the <emphasis>name attribute in the object
      recognition</emphasis>.
    </para>
    <para>
      You can also select an activation method for your AUT. See the
      section on AUT activation (<xref linkend="aut-activation"/>) for more
      details.
    </para>
  </section>
</section>

Back to the top