Windows

A window holds HTML, XML or other content in a robot. One or more windows are always open, and one window is the current window, i.e. the window containing the page that a step-action works on. In Design Studio, each window is displayed in a tab, and the current window is marked with a yellow arrow.

Windows allow you to handle multiple pages simultaneously. Note, however, that a step can only work on a single page at a time, so you need to change the current window whenever you want to work on another page than the current one.

Using the appropriate step actions, you can:

In Design Studio, an easy way to insert a Set Current Window step is to right-click on the window's tab and choose Set as Current Window.

When loading a page that loads other pages (e.g. a page containing a <frameset>-tag), each page will automatically be loaded into a separate window.

Each window can have one or more named tags or ranges. Note that each named tag or range belongs to a specific window.

Identifying a Window

Some step actions (for example the ones mentioned above) are configured to operate on a particular window. The window may be identified in three ways:

The name is the more stable of the two alternatives in face of robot changes, and also (most subtly) when a step may be reached via different paths that open different windows. Thus the name is the preferred way to identify a window. Matching does not work on windows showing variables, because the names of these are fixed.

In some cases, however, the name is not the same every time the robot is run. For example, some Web sites are based on frames but name these frames differently each time (while keeping the structure of the frame set). Because the window name is derived from the frame's name, the window name is not much use in such a case, and the windows must be referenced by their numbers. In these situations, it is important to make sure that every path through the robot that can lead to the step action in question results in the same window structure and window numbers.

There are two alternative ways of identifying a window:

In both cases, the pattern must be precise enough that only the name of a single window matches it.