Jameleon - Jiffie Plug-in - Syntax Reference

Available Tags

This is a list of available tags for Jiffie Plug-in. This list of tags is also available in the Jameleon GUI. You can get there by selecting the "Functional Points" tab on the lower-left. All tags, including custom tags and other enabled plug-ins' tags, show up in the GUI.

Jiffie Plug-in Tags

Tag	Short Description
<ie-attribute/>	An extension of the {@link ParamTag} specific to the Jiffie plug-in.
<ie-attribute-name/>	Specifies the name of the element attribute.
<ie-attribute-value/>	Specifies the value of the element attribute.
<ie-click-button/>	Clicks a provided button.
<ie-click-html-element/>	Clicks a provided html element.
<ie-click-link/>	Clicks on a given link.
<ie-close-window/>	Closes the current browser window.
<ie-execute-javascript/>	A Tag that executes a body of javascript in the context of IE.
<ie-fire-event/>	Fires event methtods in a provided HTML element.
<ie-get-matching-text/>	Gets the matching text against the currently active IE and sets it in the context.
<ie-go-back/>	Clicks the browser's back button.
<ie-go-forward/>	Clicks the browser's forward button.
<ie-is-text-present/>	Check whether the given text exists on the current page.
<ie-navigate/>	Navigates directly to the given URL.
<ie-send-keys/>	Sends the provided keys to the screen.
<ie-session/>	This is a Jiffie implementation of the @see SessionTag.
<ie-set-checkbox/>	This action point checks any checkbox in a form or not.
<ie-set-hidden-field/>	This action point sets the value of any hidden field.
<ie-set-password-field/>	This action point sets the value of any password field in form or not.
<ie-set-radiobutton/>	This action point sets the value of any radio button.
<ie-set-select-field/>	Sets the value(s) of any select field.
<ie-set-text-area/>	This action point sets the value of any text area.
<ie-set-text-field/>	This action point sets the value of any text field.
<ie-set-window-focus/>	Sets focus on an opened IE window with the provided title or index.
<ie-snap-shot/>	Takes a snapshot of the currently displayed page.
<ie-validate/>	Validates the title, text and links on the page.
<ie-validate-checkbox/>	Checks the value of any checkbox field in the form or not.
<ie-validate-password-field/>	Verifies the value of any password field.
<ie-validate-radiobutton/>	Verifies that a radio button has been set to a given value.
<ie-validate-select-field/>	Validates the currently selected value(s) of the provided select field.
<ie-validate-text/>	Validates text or a regular expression can be found in the current HTML document.
<ie-validate-text-area/>	Verifies the value of any text area.
<ie-validate-text-field/>	Verifies the value of any text field.
<ie-validate-title/>	Validates the title in several different ways.
<ie-validate-xpath/>	Validates the given xpath ( see: http://www.

ie-attribute

An extension of the {@link ParamTag} specific to the Jiffie plug-in. This tag is currently used for the ie-click-html-element tag. Please see the documentation on that tag for an example usage.

    <ie-attribute>
<ie-attribute-name>name</ie-attribute-name>
<ie-attribute-value>submit</ie-attribute-value>
</ie-attribute>

Take a look at this tag's API docs and source code for more information.

ie-attribute-name

Specifies the name of the element attribute. For example, <input type="submit">, would have an attribute named type.

    <ie-attribute>
<ie-attribute-name>type</ie-attribute-name>
<ie-attribute-value>submit</ie-attribute-value>
</ie-attribute>

Take a look at this tag's API docs and source code for more information.

ie-attribute-value

Specifies the value of the element attribute. For example, <input type="submit">, would have an attribute named type with a value submit.

    <ie-attribute>
<ie-attribute-name>type</ie-attribute-name>
<ie-attribute-value>submit</ie-attribute-value>
</ie-attribute>

Take a look at this tag's API docs and source code for more information.

ie-click-button

Clicks a provided button. Some example uses might be: Clicking on <input type="image" src="jameleon.jpg"> for the 3rd form on the page.

    <ie-click-button functionId="Click an image button with the src ending in jameleon.jpg"
identifier="jameleon.jpg"
form="2"/>

Clicking on <input type="image" alt="alt text"> for the 3rd form on the page.

    <ie-click-button functionId="Click on a image button with the alt text set"
identifier="alt text"
form="2"/>

Clicking on <input type="submit" value="some value"> for the form with the name "button" on the page.

    <ie-click-button functionId="Click on a image button with the provided value"
value="some value"
form="button"/>

Clicking on <input type="submit" name="some name"> for the form with the name "button" on the page.

    <ie-click-button functionId="Click on a image button with the provided name"
name="some name"
form="button"/>

Clicking on <input type="submit" name="some name" value="some value"> for the form with the name "button" on the page.

    <ie-click-button functionId="Click on a image button with the provided name and value"
name="some name"
value="some value"
form="button"/>

NOTE: The ie-attribute tags and the xpath element can also be used to find desired submit button.

Take a look at this tag's API docs and source code for more information.

Attribute Name	Context Name	Description	Default	Required	Type
identifier	ieClickButtonIdentifier	Best if used for input type=image or button. For image input types, it will try to match it with the src or alt attribute. For submit and button types, it will try to match it with the value attribute. If this attribute is set, then name and value will be ignored.		false	java.lang.String
name	ieClickButtonName	The name of the button's name attribute.		false	java.lang.String
value	ieClickButtonValue	The value of the button's vakue attribute.		false	java.lang.String
form	ieClickButtonForm	The name, id or index of the form with the button to click. This attribute is required if neither the nested ie-attribute element nor the xpath attribute is not used.		false	java.lang.String
htmlElement		The html element type to click on. For example, for <input type="submit" > this would be set to input. Either htmlElement or xpath must be set.		false	java.lang.String
xpath		The XPath used to indentify the desired object. Either use this or the name and value tags. Either htmlElement or xpath must be set.		false	java.lang.String
eventToFire		The name of the javascript event to fire on the form element.		false	java.lang.String
WAIT		Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement		Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName		The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId		The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc		The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId		The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint		Tells the GUI to stop at this functional point		false	boolean
precondition		Specifies this is a precondition		false	boolean
postcondition		Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure		Specifies a failure is expected.		false	boolean
expectException		Specifies an exception is expected.		false	boolean
functionDelay		The delay time to use at the end of each functional point	-1	false	long

ie-click-html-element

Clicks a provided html element. This element can be anything that can be clicked like a link, a button, an image, or even just some element like a text field. Some example uses might be: Clicking on <input type="image" src="jameleon.jpg">

    <ie-click-html-element functionId="Click an image button with the src ending in jameleon.jpg"
htmlElement="input">
<ie-attribute>
<ie-attribute-name>type</ie-attribute-name>
<ie-attribute-value>image</ie-attribute-value>
</ie-attribute>
<ie-attribute>
<ie-attribute-name>src</ie-attribute-name>
<ie-attribute-value>jameleon.jpg</ie-attribute-value>
</ie-attribute>
</ie-click-html-element>

Clicking on <input type="image" src="jameleon.jpg" alt="jameleon image" > based on the alt text alone

    <ie-click-html-element functionId="Click an image button with the alt text"
htmlElement="input">
<ie-attribute>
<ie-attribute-name>type</ie-attribute-name>
<ie-attribute-value>image</ie-attribute-value>
</ie-attribute>
<ie-attribute>
<ie-attribute-name>alt</ie-attribute-name>
<ie-attribute-value>jamaleon image</ie-attribute-value>
</ie-attribute>
</ie-click-html-element>

Clicking on <input type="image" src="jameleon.jpg" alt="jameleon image" > with both alt text and image src

    <ie-click-html-element functionId="Click an image button with the alt text"
htmlElement="input">
<ie-attribute>
<ie-attribute-name>type</ie-attribute-name>
<ie-attribute-value>image</ie-attribute-value>
</ie-attribute>
<ie-attribute>
<ie-attribute-name>alt</ie-attribute-name>
<ie-attribute-value>jamaleon image</ie-attribute-value>
</ie-attribute>
<ie-attribute>
<ie-attribute-name>src</ie-attribute-name>
<ie-attribute-value>jameleon.jpg</ie-attribute-value>
</ie-attribute>
</ie-click-html-element>

Clicking on <a href="http://sf.net" id="sf link" >

    <ie-click-html-element functionId="Click an anchor tag"
htmlElement="a">
<ie-attribute>
<ie-attribute-name>id</ie-attribute-name>
<ie-attribute-value>sf link</ie-attribute-value>
</ie-attribute>
</ie-click-html-element>

Take a look at this tag's API docs and source code for more information.

Attribute Name	Description	Default	Required	Type
htmlElement	The html element type to click on. For example, for <input type="submit" > this would be set to input. Either htmlElement or xpath must be set.		false	java.lang.String
xpath	The XPath used to indentify the desired object. Either use this or the name and value tags. Either htmlElement or xpath must be set.		false	java.lang.String
eventToFire	The name of the javascript event to fire on the form element.		false	java.lang.String
WAIT	Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement	Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName	The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId	The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc	The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

ie-click-link

Clicks on a given link. Some example uses might be: Clicking on <a href="http://sf.net">link text</a>

    <ie-click-link functionId="Click an link with the text underlined"
link="link text"/>

Clicking on <a href="http://sf.net" id="link id">link text</a>

    <ie-click-link functionId="Click an link with the id"
link="link id"/>

Clicking on <a href="http://sf.net" name="link name">link text</a>

    <ie-click-link functionId="Click an link with the name"
link="link name"/>

Clicking on <a href="http://sf.net"><img src="jameleon.jpg"></a>

    <ie-click-link functionId="Click an link with the img src"
link="jameleon.jpg"/>

Clicking on <a href="http://sf.net"><img src="jameleon.jpg" alt="img alt"></a>

    <ie-click-link functionId="Click an link with the img alt text"
link="img alt"/>

Take a look at this tag's API docs and source code for more information.

Attribute Name	Context Name	Description	Default	Required	Type
link	ieClickLink	Link (link text, id, alt, name or img src) in page to be clicked.		false	java.lang.String
ignoreTarget	ieClickLinkIgnoreTarget	Ignore target If set to 'true', will not open link in new window (if the link has a target).	false	false	boolean
href	ieClickLinkHref	Link (link text, id, alt, name, regex or img src) in the page to be clicked.		false	java.lang.String
WAIT		Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement		Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName		The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId		The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc		The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId		The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint		Tells the GUI to stop at this functional point		false	boolean
precondition		Specifies this is a precondition		false	boolean
postcondition		Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure		Specifies a failure is expected.		false	boolean
expectException		Specifies an exception is expected.		false	boolean
functionDelay		The delay time to use at the end of each functional point	-1	false	long

ie-close-window

Closes the current browser window.

Take a look at this tag's API docs and source code for more information.

Attribute Name	Description	Default	Required	Type
WAIT	Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement	Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName	The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId	The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc	The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

ie-execute-javascript

A Tag that executes a body of javascript in the context of IE. Please see the Jiffie javadocs on net.sf.jiffie.JiffieUtility.executeScript for more information. Some example uses might be: Setting the text field value defined by <input type="text" name="textField1"</a> inside a form named 'lastForm'

    <ie-execute-javascript functionId="Set a value of the text field to 'some value'"
script="document.forms.lastForm.textField1.value = 'some value'"/>

In other words, you make up your own complete JavaScript, whether it be one or fifty lines and send it to the browser.

Take a look at this tag's API docs and source code for more information.

Attribute Name	Description	Default	Required	Type
script	The Javascript body to execute.		true	java.lang.String
WAIT	Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement	Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName	The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId	The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc	The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

ie-fire-event

Fires event methtods in a provided HTML element. This element can be anything that can hold an onxxx call like a a button, an image, or even just some element like a text field. Some example uses might be: Firing a onmouseover event from <input type="image" onmouseover="mouseOver('largeLizard.jpg')" onmouseout="mouseOut('smallLizard.jpg')" src="smallLizard.jpg">

    <ie-fire-event functionId="Call the onmouseover event in the image button with the src ending in smallLizard.jpg"
eventToFire="onmouseover"
htmlElement="input">
<ie-attribute>
<ie-attribute-name>type</ie-attribute-name>
<ie-attribute-value>image</ie-attribute-value>
</ie-attribute>
<ie-attribute>
<ie-attribute-name>src</ie-attribute-name>
<ie-attribute-value>smallLizard.jpg</ie-attribute-value>
</ie-attribute>
</ie-fire-event>

Fires the onclick event on <a href="/some/path/helloWorld.html" onclick="alert('somemessage')"> based on the href text alone

    <ie-fire-event functionId="Click a url with the href ending in helloWorld.html"
eventToFire="onclick"
htmlElement="a">
<ie-attribute>
<ie-attribute-name>href</ie-attribute-name>
<ie-attribute-value>helloWorld.html</ie-attribute-value>
</ie-attribute>
</ie-fire-event>

Fires the onchange event on a text field <input type="text" name="textname" id="text_id" > with a name and an id

    <ie-fire-event functionId="Fire onchange event on a text field with a name, and an id"
htmlElement="input"
eventToFire="onchange">
<ie-attribute>
<ie-attribute-name>type</ie-attribute-name>
<ie-attribute-value>text</ie-attribute-value>
</ie-attribute>
<ie-attribute>
<ie-attribute-name>name</ie-attribute-name>
<ie-attribute-value>textname</ie-attribute-value>
</ie-attribute>
<ie-attribute>
<ie-attribute-name>id</ie-attribute-name>
<ie-attribute-value>text_id</ie-attribute-value>
</ie-attribute>
</ie-fire-event>

Use XPath to fire the onchange event a text field in a form:

    <form name="formname" action="dosomething.php" method="post">
First Name: <input type="text" name="first_name" >
</form>

    <ie-fire-event functionId="Fire onchange event on a text field with a name"
xpath="//FORM[@name='formname']/INPUT[@type='text' and @name='first_name']"/>

Take a look at this tag's API docs and source code for more information.

Attribute Name	Description	Default	Required	Type
htmlElement	The html element type to click on. For example, for <input type="submit" > this would be set to input. Either htmlElement or xpath must be set.		false	java.lang.String
xpath	The XPath used to indentify the desired object. Either use this or the name and value tags. Either htmlElement or xpath must be set.		false	java.lang.String
eventToFire	The name of the javascript event to fire on the form element.		false	java.lang.String
WAIT	Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement	Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName	The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId	The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc	The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

ie-get-matching-text

Gets the matching text against the currently active IE and sets it in the context.

Take a look at this tag's API docs and source code for more information.

Attribute Name	Context Name	Description	Default	Required	Type
varName	ieGetMatchinTextVarName	The name by which a context variable will be created		false	java.lang.String
regex	ieGetMatchinTextRegex	The pattern which is to be used to extract the data from the repsonse		false	java.lang.String
regexGroup	ieGetMatchinTextRegexGroup	The group number (based on parenthesis) to extract the data from. For example, the following regex has two different groups: (Some text ([\\d]+)) The first group would be the entire expression. The second group would be only the matching numbers.		false	int
WAIT		Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement		Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName		The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId		The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc		The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId		The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint		Tells the GUI to stop at this functional point		false	boolean
precondition		Specifies this is a precondition		false	boolean
postcondition		Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure		Specifies a failure is expected.		false	boolean
expectException		Specifies an exception is expected.		false	boolean
functionDelay		The delay time to use at the end of each functional point	-1	false	long

ie-go-back

Clicks the browser's back button.

Take a look at this tag's API docs and source code for more information.

Attribute Name	Description	Default	Required	Type
WAIT	Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement	Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName	The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId	The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc	The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

ie-go-forward

Clicks the browser's forward button.

Take a look at this tag's API docs and source code for more information.

Attribute Name	Description	Default	Required	Type
WAIT	Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement	Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName	The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId	The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc	The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId	The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint	Tells the GUI to stop at this functional point		false	boolean
precondition	Specifies this is a precondition		false	boolean
postcondition	Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure	Specifies a failure is expected.		false	boolean
expectException	Specifies an exception is expected.		false	boolean
functionDelay	The delay time to use at the end of each functional point	-1	false	long

ie-is-text-present

Check whether the given text exists on the current page. It then stores the results in the provided context variable for later validation. This is most useful for doing a fork (via Jelly's if tag) in the script, depending on this outcome. Some example uses might be: Validating that 'Link 1 was clicked' is on the page. This is of course, a pretty useless example since the same could be done in ie-validate-text.

    <ie-is-text-present functionId="Check for 'Link 1 was clicked' on the current page and store the outcome in 'textPresent' context name"
varName="textPresent"
text="Link 1 was clicked"/>
<ju-assert-true functionId="verify that the text was found!"
test="${textPresent}"/>

Take a look at this tag's API docs and source code for more information.

Attribute Name	Context Name	Description	Default	Required	Type
text	ieIsTextPresentText	The text to verify existence of.		true	java.lang.String
varName	ieIsTextPresentVarName	The variable to store the Boolean result to		true	java.lang.String
WAIT		Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement		Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName		The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId		The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc		The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId		The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint		Tells the GUI to stop at this functional point		false	boolean
precondition		Specifies this is a precondition		false	boolean
postcondition		Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure		Specifies a failure is expected.		false	boolean
expectException		Specifies an exception is expected.		false	boolean
functionDelay		The delay time to use at the end of each functional point	-1	false	long

ie-navigate

Navigates directly to the given URL. Some example uses might be: To go the jameleon sourceforge site.

    <ie-navigate functionId="Go to jameleon's sourceforge site"
url="http://jameleon.sourceforge.net"/>

Take a look at this tag's API docs and source code for more information.

Attribute Name	Context Name	Description	Default	Required	Type
url	ieNavigateUrl	URL to navigate to		true	java.lang.String
username	ieNavigateUsername	Username for pages that require basic authentication.		false	java.lang.String
password	ieNavigatePassword	Password for pages that require basic authentication.		false	java.lang.String
WAIT		Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement		Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName		The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId		The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc		The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId		The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint		Tells the GUI to stop at this functional point		false	boolean
precondition		Specifies this is a precondition		false	boolean
postcondition		Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure		Specifies a failure is expected.		false	boolean
expectException		Specifies an exception is expected.		false	boolean
functionDelay		The delay time to use at the end of each functional point	-1	false	long

ie-send-keys

Sends the provided keys to the screen. Please see IE SendKeys method docs for specs on how to represent keys. NOTE: the windowTitle is the text that appears on the top left of the actual window. For example, the Calculator application has a title of "Calculator".

Take a look at this tag's API docs and source code for more information.

Attribute Name	Context Name	Description	Default	Required	Type
windowTitle	ieSendKeysWindowTitle	The title of the window to send keys to.		true	java.lang.String
keys	ieSendKeysKeys	The keys to send to the screen		true	java.lang.String
maxWaitTime	ieSendKeysMaxWaitTime	The maximum number of seconds to wait before failing.	30	true	int
failOnWindowNotFound	ieSendKeysFailOnWindowNoFound	The maximum number of seconds to wait before failing.	true	false	boolean
WAIT		Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement		Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName		The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId		The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc		The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId		The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint		Tells the GUI to stop at this functional point		false	boolean
precondition		Specifies this is a precondition		false	boolean
postcondition		Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure		Specifies a failure is expected.		false	boolean
expectException		Specifies an exception is expected.		false	boolean
functionDelay		The delay time to use at the end of each functional point	-1	false	long

ie-session

This is a Jiffie implementation of the @see SessionTag. It basically starts the application in the state provided by the baseUrl and beginAt variables and creates a new session for the function points to share. An example of its use might:

    <testcase xmlns="jelly:jameleon">
<ie-session baseUrl="http://www.google.com" beginSession="true">
<ie-validate
functionId="Check that title is Google."
title="Google"/>
</ie-session>
</testcase>

Take a look at this tag's API docs and source code for more information.

Attribute Name	Context Name	Description	Default	Required	Type
visible		If set to true, then Internet Explorer will be visible.		false	boolean
baseUrl	baseUrl	Used when the beginSession is set to true. This is the url, including protocol http://		false	java.lang.String
beginAt	beginAt	Used when the beginSession attribute is set to true. This the path to navigate to. It is recommended to only use baseUrl, including the entire path and not use this.		false	java.lang.String
closeIEOnExit		If set to true, then any browsers opened by the session will be closed. Set this attribute to false to keep the browsers open.	true	false	boolean
clickYesOnSecurityAlert		Click yes on the Security Alert dialog box if one appears after the session is started.	false	false	boolean
clickNoOnSecurityAlert		Click no on the Security Alert dialog box if one appears after the session is started.	false	false	boolean
enableJacobAutoGc		Turn on com.jacob.autogc	true	false	boolean
application		The name of the application being run according to the *-TestCaseTag.properties file		false	java.lang.String
organization		The organization (affiliate or company name) this application will be tested against.		false	java.lang.String
postcondition				false	boolean
sessionDelay		Sets the tag to delay x milliseconds before anything else is executed.	0	false	long
beginSession		Starts the applicattion and gets it to the state defined in the $testEnviroment-Applications.properties. DEFAULTS to `false`		false	boolean

ie-set-checkbox

This action point checks any checkbox in a form or not. Some example uses might be: Checking <input type="checkbox" name="checkBox1" value="one"</a>

    <ie-set-checkbox functionId="Set a checkbox in a given form to checked"
name="checkBox1"
checked="true"
form="testForm"/>

Checking <input type="checkbox" name="checkBox1" value="one"</a> that doesn't exist in a form

    <ie-set-checkbox functionId="Set a checkbox in a given form to checked"
name="checkBox1"
checked="true"/>

Unchecking <input type="checkbox" name="checkBox3"</a>

    <ie-set-checkbox functionId="Uncheck a given checkbox"
name="checkBox3"
checked="false"
form="testForm"/>

Checking a checkbox with the same name, but different value: <input type="checkbox" name="cb1" value="1"</a><input type="checkbox" name="cb1" value="2"</a>

    <ie-set-checkbox functionId="Ckeck a checkbox 'cb1' with the value '1'. Notice that two checkboxes have the same name."
name="cb1"
value="1"
checked="true"
form="testForm"/>

NOTE: This tag does not currently support the xpath attribute nor the nested ie-attribute tags.

Take a look at this tag's API docs and source code for more information.

Attribute Name	Context Name	Description	Default	Required	Type
name	ieSetCheckboxName	The name of the checkbox field		true	java.lang.String
value	ieSetCheckboxValue	The value of the checkbox field. If set, then the name and value are used to identify the checkbox to check or uncheck		false	java.lang.String
checked	ieSetCheckboxValue	Check the checkbox if set to true; uncheck the checkbox if set to false.		true	boolean
form	ieSetCheckboxForm	The name, id or index of the field		false	java.lang.String
htmlElement		The html element type to click on. For example, for <input type="submit" > this would be set to input. Either htmlElement or xpath must be set.		false	java.lang.String
xpath		The XPath used to indentify the desired object. Either use this or the name and value tags. Either htmlElement or xpath must be set.		false	java.lang.String
eventToFire		The name of the javascript event to fire on the form element.		false	java.lang.String
WAIT		Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement		Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName		The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId		The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc		The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId		The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint		Tells the GUI to stop at this functional point		false	boolean
precondition		Specifies this is a precondition		false	boolean
postcondition		Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure		Specifies a failure is expected.		false	boolean
expectException		Specifies an exception is expected.		false	boolean
functionDelay		The delay time to use at the end of each functional point	-1	false	long

ie-set-hidden-field

This action point sets the value of any hidden field. Some example uses might be: Setting the text field defined by <input type="hidden" name="hiddenField1"</a>

    <ie-set-hidden-field functionId="Set a value of the hidden field to 'some value'"
name="hiddenField1"
value="some value"
form="testForm"/>

Take a look at this tag's API docs and source code for more information.

Attribute Name	Context Name	Description	Default	Required	Type
name	ieSetHiddenFieldName	The name of the hidden field		true	java.lang.String
value	ieSetHiddenFieldValue	The value to set the hidden field to		true	java.lang.String
form	ieSetHiddenFieldForm	The name, id or index of the form		false	java.lang.String
WAIT		Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement		Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName		The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId		The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc		The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId		The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint		Tells the GUI to stop at this functional point		false	boolean
precondition		Specifies this is a precondition		false	boolean
postcondition		Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure		Specifies a failure is expected.		false	boolean
expectException		Specifies an exception is expected.		false	boolean
functionDelay		The delay time to use at the end of each functional point	-1	false	long

ie-set-password-field

This action point sets the value of any password field in form or not. Some example uses might be: Setting the value of <input type="password" name="passwordField1"</a>

    <ie-set-password-field functionId="Set a password field in a given form to 'joe'"
name="passwordField1"
value="joe"
form="testForm"/>

NOTE: This tag does not currently support the xpath attribute nor the nested ie-attribute tags.

Take a look at this tag's API docs and source code for more information.

Attribute Name	Context Name	Description	Default	Required	Type
name	ieSetPasswordFieldName	The name of the text field		true	java.lang.String
value	ieSetPasswordFieldValue	The value to set the text field to		true	java.lang.String
form	ieSetPasswordFieldForm	The name, id or index of the field		false	java.lang.String
htmlElement		The html element type to click on. For example, for <input type="submit" > this would be set to input. Either htmlElement or xpath must be set.		false	java.lang.String
xpath		The XPath used to indentify the desired object. Either use this or the name and value tags. Either htmlElement or xpath must be set.		false	java.lang.String
eventToFire		The name of the javascript event to fire on the form element.		false	java.lang.String
WAIT		Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement		Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName		The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId		The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc		The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId		The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint		Tells the GUI to stop at this functional point		false	boolean
precondition		Specifies this is a precondition		false	boolean
postcondition		Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure		Specifies a failure is expected.		false	boolean
expectException		Specifies an exception is expected.		false	boolean
functionDelay		The delay time to use at the end of each functional point	-1	false	long

ie-set-radiobutton

This action point sets the value of any radio button. Some example uses might be: Selecting a radio button <input type="radio" name="radioButton" value="radio1"><input type="radio" name="radioButton" value="radio2">

    <ie-set-radiobutton functionId="Check the second radio button"
name="radioButton"
value="radio2"
form="testForm"/>

NOTE: This tag does not currently support the xpath attribute nor the nested ie-attribute tags.

Take a look at this tag's API docs and source code for more information.

Attribute Name	Context Name	Description	Default	Required	Type
name	ieSetRadiobuttonName	The name of the radio button		true	java.lang.String
value	ieSetRadiobuttonValue	Check the radio button with given value.		true	java.lang.String
form	ieSetRadiobuttonForm	The name, id or index of the field		false	java.lang.String
htmlElement		The html element type to click on. For example, for <input type="submit" > this would be set to input. Either htmlElement or xpath must be set.		false	java.lang.String
xpath		The XPath used to indentify the desired object. Either use this or the name and value tags. Either htmlElement or xpath must be set.		false	java.lang.String
eventToFire		The name of the javascript event to fire on the form element.		false	java.lang.String
WAIT		Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement		Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName		The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId		The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc		The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId		The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint		Tells the GUI to stop at this functional point		false	boolean
precondition		Specifies this is a precondition		false	boolean
postcondition		Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.		false	boolean
expectFailure		Specifies a failure is expected.		false	boolean
expectException		Specifies an exception is expected.		false	boolean
functionDelay		The delay time to use at the end of each functional point	-1	false	long

ie-set-select-field

Sets the value(s) of any select field. Only one of optionText, optionValue, or optionIndex can set. In other words, they can't be used in conjunction with one another. Some example uses might be: Selecting

    <select name="selectField">
<option value="1">one</option>
<option value="2">two</option>
<option value="3">three</option>
<option value="4">four</option>
</select>

    <ie-set-select-field functionId="Set the select field not in a form to the value displayed as 'two'"
name="selectField"
optionText="two"/>

Selecting multiple values from:

    <select name="selectField" mulitple>
<option value="1">one</option>
<option value="2">two</option>
<option value="3">three</option>
<option value="4">four</option>
</select>

    <map-variable toVariable="fieldValues" variableType="List">
<variable-value>1</variable-value>
<variable-value>4</variable-value>
</map-variable>
<ie-set-select-field functionId="Set mulitple values in the the select field via the value '1' and '4'"
name="selectField"
optionValue="${fieldValues}"/>

    <ie-set-select-field functionId="Set the select field to the value displayed as 'two'"
name="selectField"
optionText="two"
form="testForm"/>

    <ie-set-select-field functionId="Set the select field to the value '3' as defined by its value attribute"
name="selectField"
optionValue="3"
form="testForm"/>

    <ie-set-select-field functionId="Set the select field to the fourth selection"
name="selectField"
optionIndex="3"
form="testForm"/>

NOTE: This tag does not currently support the xpath attribute nor the nested ie-attribute tags.

Take a look at this tag's API docs and source code for more information.

Attribute Name	Context Name	Description	Default	Required	Type
name	ieSetSelectFieldName	The name of the text field		true	java.lang.String
optionText	ieSetSelectFieldOptionText	The displayed text of the option to select. This attribute can have multiple values. In which case each one will be validated.		false	java.util.List
optionValue	ieSetSelectFieldOptionValue	The value attribute of the option tag to select. This attribute can have multiple values. In which case each one will be validated. NOTE: This is not the text that appears in the drop-down list. Instead it is the value attribute of the option tag which should be nested inside the select tag.		false	java.util.List
optionIndex	ieSetSelectFieldOptionIndex	The index of the option to select. For example, to select the 2nd option, pass in 1 This attribute can have multiple values. In which case each one will be validated.		false	java.util.List
form	ieSetSelectFieldForm	The name, id or index of the field		false	java.lang.String
htmlElement		The html element type to click on. For example, for <input type="submit" > this would be set to input. Either htmlElement or xpath must be set.		false	java.lang.String
xpath		The XPath used to indentify the desired object. Either use this or the name and value tags. Either htmlElement or xpath must be set.		false	java.lang.String
eventToFire		The name of the javascript event to fire on the form element.		false	java.lang.String
WAIT		Whether or not to wait for a response. Use this attribute if you need to click on something that brings up a prompt window. Just remember that this setting is for the entire duration of the tag. Which means if you click on a link and then try to validate something within the same tag, then it will likely fail. Use with care!	true	false	boolean
highlightActiveElement		Whether or not to highlight the currently active HTML element. This attribute can be set in jameleon.conf via jiffie-plugin.highlightActiveElement	true	false	boolean
frameName		The name attribute of the frame or iframe to act upon. This can also be a comma-separated list of names.		false	java.lang.String
frameId		The id attribute of the frame or iframe to act upon. This can also be a comma-separated list of ids.		false	java.lang.String
frameSrc		The src attribute of the frame or iframe to act upon. This can also be a comma-separated list of src attributes.		false	java.lang.String
functionId		The id of this function. This is used in the macro as a short description of the function		true	java.lang.String
breakPoint		Tells the GUI to stop at this functional point		false	boolean
precondition		Specifies this is a precondition		false	boolean
postcondition		Specifies this is a postcondition and will therefore get executed even if a previous functional point or session tag failed.

Jiffie Plug-in

Getting Started

Technical Documents

Project Documentation

Available Tags

Jiffie Plug-in Tags

ie-attribute

ie-attribute-name

ie-attribute-value

ie-click-button

ie-click-html-element

ie-click-link

ie-close-window

ie-execute-javascript

ie-fire-event

ie-get-matching-text

ie-go-back

ie-go-forward

ie-is-text-present

ie-navigate

ie-send-keys

ie-session

ie-set-checkbox

ie-set-hidden-field

ie-set-password-field

ie-set-radiobutton

ie-set-select-field