Merging

This topic was updated due to the 2.3.0 MFTF release.

The MFTF allows you to merge test components defined in XML files, such as tests, pages, sections, and data. You can create, delete, or update the component. It is useful for supporting rapid test creation for extensions and customizations.

You can specify needed changes to an existing file and merge them to produce a modification of the original that incorporates the specified changes (the “delta”).

Merging operates at the XML tag level, triggered by our parser when there are two (or more) entities with the same name. Your update (XML node with changes) must have the same attribute name as its base node (the target object to be changed).

For example:

  • All tests with <test name="SampleTest> will be merged into one.
  • All pages with <page name="SamplePage> will be merged into one.
  • All sections with <section name="SampleAction"> will be merged into one.
  • All data entities with <entity name="sampleData" type="sample"> will be merged into one.

Although a file name doesn’t influence merging, we recommend using the same file names in merging updates. This makes it easier to search later on.

Add a test

You cannot add another <test> using merging functionality. To add a <test>, create a new *Test.xml file or add a <test> node to an existing *Test.xml file.

Remove a test

Tests cannot be removed while merging. If a <test> must be skipped due to a module completely invalidating a function, you can add the test to the skip group.

Learn more about running tests with different options using mftf or codecept commands.

Example

Skip the AdminLoginTest test in the .../Backend/Test/AdminLoginTest.xml file while merging with the .../Foo/Test/AdminLoginTest.xml file:

<tests ...>
    <test name="AdminLoginTest">
            <annotations>
                <features value="Admin Login"/>
                <stories value="Login on the Admin Login page"/>
                <title value="You should be able to log into the Magento Admin backend."/>
                <description value="You should be able to log into the Magento Admin backend."/>
                <severity value="CRITICAL"/>
                <testCaseId value="MAGETWO-71572"/>
                <group value="example"/>
                <group value="login"/>
            </annotations>
        <amOnPage url="" stepKey="amOnAdminLoginPage"/>
        <fillField selector="" userInput="" stepKey="fillUsername"/>
        <fillField selector="" userInput="" stepKey="fillPassword"/>
        <click selector="" stepKey="clickOnSignIn"/>
        <closeAdminNotification stepKey="closeAdminNotification"/>
        <seeInCurrentUrl url="" stepKey="seeAdminLoginUrl"/>
    </test>
</tests>

Create the .../Foo/Test/AdminLoginTest.xml file:

<tests ...>
    <test name="AdminLoginTest">
            <annotations>
                <skip>
                    <issueId value="Issue#"/>
                </skip>
            </annotations>
    </test>
</tests>

The AdminLoginTest result corresponds to:

<test name="AdminLoginTest">
        <annotations>
            <features value="Admin Login"/>
            <stories value="Login on the Admin Login page"/>
            <title value="You should be able to log into the Magento Admin backend."/>
            <description value="You should be able to log into the Magento Admin backend."/>
            <severity value="CRITICAL"/>
            <testCaseId value="MAGETWO-71572"/>
            <group value="example"/>
            <group value="login"/>
            <skip>
                <issueId value="Issue#"/>
            </skip>
        </annotations>
    <amOnPage url="" stepKey="amOnAdminLoginPage"/>
    <fillField selector="" userInput="" stepKey="fillUsername"/>
    <fillField selector="" userInput="" stepKey="fillPassword"/>
    <click selector="" stepKey="clickOnSignIn"/>
    <closeAdminNotification stepKey="closeAdminNotification"/>
    <seeInCurrentUrl url="" stepKey="seeAdminLoginUrl"/>
</test>

Update a test

Any change must include information about where it should be inserted relative to other test steps in the scope of the test.

This is done using the before or after element. See the previous examples.

Add a test step

Use case: Add checkOption before click (stepKey="clickLogin") and add seeInCurrentUrl after the click in the LogInAsAdminTest test (in the .../Backend/Test/LogInAsAdminTest.xml file) while merging with the .../Foo/Test/LogInAsAdminTest.xml file:

<tests ...>
    <test name="LogInAsAdminTest">
        <amOnPage url="" stepKey="navigateToAdmin"/>
        <fillField selector="" userInput="admin" stepKey="fillUsername"/>
        <fillField selector="" userInput="password" stepKey="fillPassword"/>
        <click selector="" stepKey="clickLogin"/>
        <see userInput="Lifetime Sales" stepKey="seeLifetimeSales"/>
    </test>
</tests>

Create the .../Foo/Test/LogInAsAdminTest.xml file:

<tests ...>
    <test name="LogInAsAdminTest">
        <checkOption selector="" stepKey="checkRememberMe" before="clickLogin"/>
        <seeInCurrentUrl url="admin/admin/dashboard/" stepKey="seeAdminUrl" after="clickLogin"/>
    </test>
</tests>

The LogInAsAdminTest result corresponds to:

<test name="LogInAsAdminTest">
    <amOnPage url="" stepKey="navigateToAdmin"/>
    <fillField selector="" userInput="admin" stepKey="fillUsername"/>
    <fillField selector="" userInput="password" stepKey="fillPassword"/>
    <checkOption selector="" stepKey="checkRememberMe"/>
    <click selector="" stepKey="clickLogin"/>
    <seeInCurrentUrl url="admin/admin/dashboard/" stepKey="seeAdminUrl"/>
    <see userInput="Lifetime Sales" stepKey="seeLifetimeSales"/>
</test>

Remove a test step

Use case: Remove see (stepKey="seeLifetimeSales") from the LogInAsAdminTest test (in the .../Backend/Test/LogInAsAdminTest.xml file) while merging with the .../Foo/Test/LogInAsAdminTest.xml file:

<tests ...>
    <test name="LogInAsAdminTest">
        <amOnPage url="" stepKey="navigateToAdmin"/>
        <fillField selector="" userInput="admin" stepKey="fillUsername"/>
        <fillField selector="" userInput="password" stepKey="fillPassword"/>
        <click selector="" stepKey="clickLogin"/>
        <see userInput="Lifetime Sales" stepKey="seeLifetimeSales"/>
    </test>
</tests>

Create the .../Foo/Test/LogInAsAdminTest.xml file:

<tests ...>
    <test name="LogInAsAdminTest">
        <remove keyForRemoval="seeLifetimeSales"/>
    </test>
</tests>

The LogInAsAdminTest result corresponds to:

<test name="LogInAsAdminTest">
    <amOnPage url="" stepKey="navigateToAdmin"/>
    <fillField selector="" userInput="admin" stepKey="fillUsername"/>
    <fillField selector="" userInput="password" stepKey="fillPassword"/>
    <click selector="" stepKey="clickLogin"/>
</test>

Update a test step

Use case: Change selector in fillField (stepKey="fillPassword") of the LogInAsAdminTest test (in the .../Backend/Test/LogInAsAdminTest.xml file) while merging with the .../Foo/Test/LogInAsAdminTest.xml file:

<tests ...>
    <test name="LogInAsAdminTest">
        <amOnPage url="" stepKey="navigateToAdmin"/>
        <fillField selector="" userInput="admin" stepKey="fillUsername"/>
        <fillField selector="" userInput="password" stepKey="fillPassword"/>
        <click selector="" stepKey="clickLogin"/>
        <see userInput="Lifetime Sales" stepKey="seeLifetimeSales"/>
    </test>
</tests>

Create the .../Foo/Test/LogInAsAdminTest.xml file:

<tests ...>
    <test name="LogInAsAdminTest">
        <fillField selector="" userInput="password" stepKey="fillPassword"/>
    </test>
</tests>

The LogInAsAdminTest result corresponds to:

<test name="LogInAsAdminTest">
    <amOnPage url="" stepKey="navigateToAdmin"/>
    <fillField selector="" userInput="admin" stepKey="fillUsername"/>
    <fillField selector="" userInput="password" stepKey="fillPassword"/>
    <click selector="" stepKey="clickLogin"/>
    <see userInput="Lifetime Sales" stepKey="seeLifetimeSales"/>
</test>

Add several test steps

Use case: Add several actions after the click (stepKey="clickLogin") in the LogInAsAdminTest test (in the .../Backend/Test/LogInAsAdminTest.xml file) while merging with the .../Foo/Test/LogInAsAdminTest.xml file:

<tests ...>
    <test name="LogInAsAdminTest">
        <amOnPage url="" stepKey="navigateToAdmin"/>
        <fillField selector="" userInput="admin" stepKey="fillUsername"/>
        <fillField selector="" userInput="password" stepKey="fillPassword"/>
        <click selector="" stepKey="clickLogin"/>
        <see userInput="Lifetime Sales" stepKey="seeLifetimeSales"/>
    </test>
</tests>

Create the .../Foo/Test/LogInAsAdminTest.xml file:

<tests ...>
    <test name="LogInAsAdminTest" insertAfter="clickLogin">
        <checkOption selector="" stepKey="checkRememberMe"/>
        <seeInCurrentUrl url="admin/admin/dashboard/" stepKey="seeAdminUrl"/>
    </test>
</tests>

The LogInAsAdminTest result corresponds to:

<test name="LogInAsAdminTest">
        <amOnPage url="" stepKey="navigateToAdmin"/>
        <fillField selector="" userInput="admin" stepKey="fillUsername"/>
        <fillField selector="" userInput="password" stepKey="fillPassword"/>
        <click selector="" stepKey="clickLogin"/>
        <checkOption selector="" stepKey="checkRememberMe"/>
        <seeInCurrentUrl url="admin/admin/dashboard/" stepKey="seeAdminUrl"/>
        <see userInput="Lifetime Sales" stepKey="seeLifetimeSales"/>
</test>

Merge pages

Use page merging to add or remove sections in your module.

To merge pages, the page name must be the same as in the base module. page name is set in the module attribute.

Add a section

Use case: The FooBackend module extends the Backend module and requires use of two new sections that must be covered with tests. Add BaseBackendSection and AnotherBackendSection to the BaseBackendPage (.../Backend/Page/BaseBackendPage.xml file):

<pages ...>
    <page name="BaseBackendPage" url="admin" area="admin" module="Magento_Backend">
        <section name="BaseBackendSection"/>
        <section name="AnotherBackendSection"/>
    </page>
</pages>

Create the .../FooBackend/Page/BaseBackendPage.xml file:

<pages ...>
    <page name="BaseBackendPage" url="admin" area="admin" module="Magento_Backend">
        <section name="NewExtensionSection"/>
    </page>
</pages>

The BaseBackendPage result corresponds to:

<page name="BaseBackendPage" url="admin" area="admin" module="Magento_Backend">
    <section name="BaseBackendSection"/>    
    <section name="AnotherBackendSection"/>
    <section name="NewExtensionSection"/>
</page>

Remove a section

Use case: The FooBackend module extends the Backend module and requires deletion of the AnotherBackendSection section (the .../Backend/Page/BaseBackendPage.xml file):

<page name="BaseBackendPage" url="admin" area="admin" module="Magento_Backend">
    <section name="BaseBackendSection"/>    
    <section name="AnotherBackendSection"/>
</page>

Create the .../FooBackend/Page/BaseBackendPage.xml file:

<page name="BaseBackendPage" url="admin" area="admin" module="Magento_Backend">
    <section name="AnotherBackendSection" remove="true"/>
</page>

The BaseBackendPage result corresponds to:

<page name="BaseBackendPage" url="admin" area="admin" module="Magento_Backend">
    <section name="BaseBackendSection"/>
</page>

Merge sections

Use merging to add, remove, or update elements in sections.

All sections with the same file name, section name, and element name are merged during test generation.

Add an element

Use case: The FooBackend module extends the Backend module and requires a new mergeElement element in the AdminLoginFormSection. Add mergeElement to the AdminLoginFormSection:

<sections ...>
    <section name="AdminLoginFormSection">
        <element name="username" type="input" selector="#username"/>
        <element name="password" type="input" selector="#login"/>
        <element name="signIn" type="button" selector=".actions .action-primary" timeout="30"/>
    </section>
</sections>

Create the .../FooBackend/Section/AdminLoginFormSection.xml file:

<sections ...>
    <section name="AdminLoginFormSection">
        <element name="mergeElement" type="input" selector="#selector"/>
    </section>
</sections>

The AdminLoginFormSection result corresponds to:

<section name="AdminLoginFormSection">
    <element name="username" type="input" selector="#username"/>
    <element name="password" type="input" selector="#login"/>
    <element name="signIn" type="button" selector=".actions .action-primary" timeout="30"/>
    <element name="mergeElement" type="input" selector="#selector"/>
</section>

Remove an element

Use case: The FooBackend module extends the Backend module and requires deletion of username in the AdminLoginFormSection. Remove username from the AdminLoginFormSection:

<sections ...>
    <section name="AdminLoginFormSection">
        <element name="username" type="input" selector="#username"/>
        <element name="password" type="input" selector="#login"/>
        <element name="signIn" type="button" selector=".actions .action-primary" timeout="30"/>
    </section>
</sections>

Create the .../FooBackend/Section/AdminLoginFormSection.xml file:

<sections ...>
    <section name="AdminLoginFormSection">
        <element name="username" type="input" remove="true"/>
    </section>
</sections>

The AdminLoginFormSection result corresponds to:

<section name="AdminLoginFormSection">
    <element name="password" type="input" selector="#login"/>
    <element name="signIn" type="button" selector=".actions .action-primary" timeout="30"/>
</section>

Update an element

Use case: The FooBackend module extends the Backend module and requires change of a selector in username in the AdminLoginFormSection. Update username in the AdminLoginFormSection (the .../Backend/Section/AdminLoginFormSection.xml file):

<sections ...>
    <section name="AdminLoginFormSection">
        <element name="username" type="input" selector="#username"/>
        <element name="password" type="input" selector="#login"/>
        <element name="signIn" type="button" selector=".actions .action-primary" timeout="30"/>
    </section>
</sections>

Create the .../FooBackend/Section/AdminLoginFormSection.xml file:

<sections ...>
    <section name="AdminLoginFormSection">
        <element name="username" type="input" selector="#newSelector"/>
    </section>
</sections>

The AdminLoginFormSection result corresponds to:

<section name="AdminLoginFormSection">
    <element name="username" type="input" selector="#newSelector"/>
    <element name="password" type="input" selector="#login"/>
    <element name="signIn" type="button" selector=".actions .action-primary" timeout="30"/>
</section>

Merge data

You can add or update <data> elements within an <entity>. Removal of individual <data> tags is not supported.

Entities and data with the same file name, entity name and type, and data key are merged during test generation.

Add data

Use case: The FooSample module extends the Sample module and requires a new data item thirdField in the _defaultSample entity. Add <data key="thirdField">field3</data> to the _defaultSample (the .../Sample/Data/SampleData.xml file):

<entities ...>
    <entity name="_defaultSample" type="testData">
        <data key="firstField">field1</data>
        <data key="secondField">field2</data>
    </entity>
</entities>

Create the .../FooSample/Data/SampleData.xml file:

<entities ...>
    <entity name="sampleData" type="testData">
        <data key="thirdField">field3</data>
    </entity>
</entities>

The _defaultSample result corresponds to:

<entity name="_defaultSample" type="testData">
    <data key="firstField">field1</data>
    <data key="secondField">field2</data>
    <data key="thirdField">field3</data>
</entity>

Update data

Use case: The FooSample module extends the Sample module and requires changing the firstField data item in the _defaultSample entity. Change firstField to <data key="firstField">overrideField</data> in the _defaultSample (the .../Sample/Data/SampleData.xml file):

<entities ...>
    <entity name="_defaultSample" type="testData">
        <data key="firstField">field1</data>
        <data key="secondField">field2</data>
    </entity>
</entity>

Create the .../FooSample/Data/SampleData.xml file:

<entities ...>
    <entity name="_defaultSample" type="testData">
        <data key="firstField">overrideField</data>
    </entity>
</entity>

The _defaultSample results corresponds to:

<entity name="_defaultSample" type="testData">
    <data key="firstField">overrideField</data>
    <data key="secondField">field2</data>
</entity>