Input testing data

This topic was updated due to the 2.0.2 MFTF release.

Tests require data to function properly.

The MFTF allows you to specify and use <data> entities defined in XML. Default <data> entities are provided for use and as templates for entity creation and manipulation.

The following diagram shows the XML structure of an MFTF data object:

image/svg+xml 0..∞ data 0..∞ var 0..∞ requiredEntity 0..∞ item 0..∞ array 1..∞ entity 0..∞ entities

Supply data to test by reference to a data entity

Test steps requiring <data> input in an action, like filling a field with a string, may reference an attribute from a data entity:


In this example:

  • SimpleSubCategory is an entity name.
  • name is a <data> key of the entity. The corresponding value will be assigned to userInput as a result.


In this example:

  • _ENV is a reference to the dev/tests/acceptance/.env file, where basic environment variables are set.
  • MAGENTO_ADMIN_USERNAME is a name of an environment variable. The corresponding value will be assigned to userInput as a result.

Persist a data entity as a prerequisite of a test

A test can specify an entity which should be persisted (created in the database) so that the test actions can operate on existing known data.

If <data> has been persisted in <test>:


If <data> has been persisted in <before> or <after>:


In this example:

  • customer is a stepKey of the corresponding test step, where an entity is created.
  • email is a dataKey of the entity. The corresponding value will be assigned to userInput as a result.

This is a side effect of PHP outputting. Even though both are nested, in PHP they end up being different methods inside a class.

Since _before() is a function outside a myTest() test method, it creates a variable in the class scope instead of the method scope ($this->persistedData vs $persistedData).

As they are relevant to test:

  • $persistedData.field$ turns into $persistedData.getData('field').
  • $$persistedData.field$$ turns into $this->persistedData.getData('field').

Use data returned by test actions

A test can also reference data that was returned as a result of test actions, like the action <grabValueFrom selector="someSelector" stepKey="grabStepKey>.

Further in the test, the data grabbed by the someSelector selector can be referenced using the stepKey value. In this case, it is grabStepKey.

The following example shows the usage of grabValueFrom in testing, where the returned value is used by action’s stepKey:

<grabValueFrom selector="someSelector" stepKey="grabStepKey"/>
<fillField selector=".functionalTestSelector" userInput="{$grabStepKey}" stepKey="fillFieldKey1"/>

Hard-coded data input

The data to operate against can be included as literals in a test. Hard-coded data input can be useful in assertions.

See also Actions.

userInput="We'll email you an order confirmation with details and tracking info."


The format of <data> is:

<?xml version="1.0" encoding="UTF-8"?>

<entities xmlns:xsi=""
    <entity name="" type="">
        <data key=""></data>
    <entity name="" type="">
        <data key="" unique=""></data>
        <var key="" entityType="" entityKey=""/>


The following conventions apply to MFTF <data>:

  • A <data> file may contain multiple data entities.
  • Camel case is used for <data> elements. The name represents the <data> type. For example, a file with customer data is CustomerData.xml. A file for simple product would be SimpleProductData.xml.
  • Camel case is used for the entity name.


Example (.../Catalog/Data/CategoryData.xml file):

<?xml version="1.0" encoding="UTF-8"?>

<entities xmlns:xsi=""
    <entity name="_defaultCategory" type="category">
        <data key="name" unique="suffix">simpleCategory</data>
        <data key="name_lwr" unique="suffix">simplecategory</data>
        <data key="is_active">true</data>
    <entity name="SimpleSubCategory" type="category">
        <data key="name" unique="suffix">SimpleSubCategory</data>
        <data key="name_lwr" unique="suffix">simplesubcategory</data>
        <data key="is_active">true</data>
        <data key="include_in_menu">true</data>

This example declares two <data> entities: _defaultCategory and SimpleSubCategory. They set the data required for category creation.

All entities that have the same name will be merged during test generation. Both entities are of the category type.

_defaultCategory sets three data fields:

  • name defines the category name as simpleCategory with a unique suffix. Example: simpleCategory598742365.
  • name_lwr defines the category name in lowercase format with a unique suffix. Example: simplecategory697543215.
  • is_active sets the enable category to true.

SimpleSubCategory sets four data fields:

  • name that defines the category name with a unique suffix. Example: SimpleSubCategory458712365.
  • name_lwr that defines the category name in lowercase format with a unique suffix. Example: simplesubcategory753698741.
  • is_active sets the enable category to true.
  • include_in_menu that sets the include in the menu to true.

The following is an example of a call in test:

<fillField selector="{{AdminCategoryBasicFieldSection.categoryNameInput}}" userInput="{{}}" stepKey="enterCategoryName"/>

This action inputs data from the name of the _defaultCategory entity (for example, simpleCategory598742365) into the field with the locator defined in the selector of the categoryNameInput element of the AdminCategoryBasicFieldSection.



<entities> is an element that contains all <entity> elements.


<entity> is an element that contains <data> elements.

Attributes Type Use Description
name string optional Name of the <entity>.
type string optional Node containing the exact name of <entity> type. Used later to find specific Persistence Layer Model class. type in <data> can be whatever the user wants; There are no constraints. It is important when persisting data, depending on the type given, as it will try to match a metadata definition with the operation being done. Example: A myCustomer entity with type="customer", calling <createData entity="myCustomer"/>, will try to find a metadata entry with the following attributes: <operation dataType="customer" type="create">.

<entity> may contain one or more <data>, <var>, <required-entities>, or <array> elements in any sequence.


<data> is an element containing a data/value pair.

Attributes Type Use Description
key string optional Key attribute of data/value pair.
unique enum: "prefix", "suffix" optional Add suite or test wide unique sequence as “prefix” or “suffix” to the data value if specified.


<var> is an element that can be used to grab a key value from another entity. For example, when creating a customer with the <createData> action, the server responds with the auto-incremented ID of that customer. Use <var> to access that ID and use it in another data entity.

Attributes Type Use Description
key string optional Key attribute of this entity to assign a value to.
entityType string optional Type attribute of referenced entity.
entityKey string optional Key attribute of the referenced entity from which to get a value.
unique This attribute hasn’t been implemented yet.


<requiredEntity> is an element that specifies the parent/child relationship between complex types.

Example: You have customer address info. To specify that relationship:

<entity name="CustomerEntity" type="customer">
    <requiredEntity type="address">AddressEntity</requiredEntity>
Attributes Type Use Description
type string optional Type attribute of <requiredEntity>.


<array> is an element that contains a reference to an array of values.


<entity name="AddressEntity" type="address">
    <array key="street">
        <item>7700 W Parmer Ln</item>
        <item>Bld D</item>
Attributes Type Use Description
key string required Key attribute of this entity in which to assign a value.

<array> may contain <item> elements.


<item> is an individual piece of data to be passed in as part of the parent <array> type.