Create and use parameterized selectors
This topic was updated due to the 2.0.2 MFTF release.
Use the following examples to create and use parameterized selectors in the MFTF.
Set up a selector in section
Create a new <element/> in a <section></section>, :
<section name="SampleSection">
<element name="" type="" selector=""/>
</section>
Add the attribute parameterized="true" to the <element/>:
<section name="SampleSection">
<element name="" type="" selector="" parameterized="true"/>
</section>
Add your selector in the selector="" attribute:
<section name="SampleSection">
<element name="" type="" selector="#element" parameterized="true"/>
</section>
Selector with single variable
For the parameterized part of the selector, add {{var1}} to represent the first piece of data that you want to replace:
<section name="SampleSection">
<element name="" type="" selector="#element .{{var1}}" parameterized="true"/>
</section>
Add a descriptive name in the name="" attribute:
<section name="SampleSection">
<element name="oneParamElement" type="" selector="#element .{{var1}}" parameterized="true"/>
</section>
Add the type of UI element that the <element/> represents in type:
<section name="SampleSection">
<element name="oneParamElement" type="text" selector="#element .{{var1}}" parameterized="true"/>
</section>
Selector with multiple variables
For the parameterized part of the selector, add {{var1}}, {{var2}}, ..., {{varN}} for each parameter that you need to pass in:
<section name="SampleSection">
<element name="threeParamElement" type="text" selector="#element .{{var1}} .{{var2}}" parameterized="true"/>
</section>
<section name="SampleSection">
<element name="threeParamElement" type="text" selector="#element .{{var1}} .{{var2}}-{{var3}}" parameterized="true"/>
</section>
There is no need to use sequential variables like {{var1}}, {{var2}}. Parameterized replacement reads variables and maps them to the test call of the element sequentially from left to right, meaning you can use a selector like #element .{{categoryId}} .{{productId}}.”
Use a parameterized selector in a test
Create a new test:
<test name="SampleTest">
</test>
Add an action:
<test name="SampleTest">
<click selector="" stepKey="click1"/>
</test>
Enter "{{}}" in the selector="" attribute:
<test name="SampleTest">
<click selector="{{}}" stepKey="click1"/>
</test>
Make a reference to the section that the element is assigned to inside the {{}}:
<test name="SampleTest">
<click selector="{{SampleSection}}" stepKey="click1"/>
</test>
Add name of a parameterized element, separated by ".", inside the {{}}:
<test name="SampleTest">
<click selector="{{SampleSection.threeParamElement}}" stepKey="click1"/>
</test>
Add a set of "()" following the parameterized element inside the {{}}:
<test name="SampleTest">
<click selector="{{SampleSection.threeParamElement()}}" stepKey="click1"/>
</test>
Add the first parameter, that you would like to pass to the selector, inside of the ():
<test name="SampleTest">
<click selector="{{SampleSection.threeParamElement(_defaultCategory.is_active)}}" stepKey="click1"/>
</test>
Add the second or third parameters, that you’d like to pass to the selector, separated by , :
<test name="SampleTest">
<click selector="{{SampleSection.threeParamElement(_defaultCategory.is_active,'StringLiteral',$createDataKey.id$)}}" stepKey="click1"/>
</test>
Any data can be used in parameterized elements, as well as entered in test actions:
_defaultCategory.is_activeis a reference to<data key="is_active">in<entity name="_defaultCategory" ... ></entity>in the corresponding.../Data/*.xml.'StringLiteral'is a literal.$createDataKey.id$is a reference to persisted data created in theSampleTest1within thestepKey="createDataKey"action.{$variable}is a reference to data returned by a test action, like<grabValueFrom>.