MQE-1886: Ability to use grab data between ActionGroups

added functional test.

Author: soumyau

dev/tests/functional/tests/MFTF/DevDocs/ActionGroup/ReturnValueActionGroup.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ /**
+  * Copyright © Magento, Inc. All rights reserved.
+  * See COPYING.txt for license details.
+  */
+-->
+<actionGroups xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+              xsi:noNamespaceSchemaLocation="urn:magento:mftf:Test/etc/actionGroupSchema.xsd">
+    <actionGroup name="ReturnValueActionGroup">
+        <comment userInput="Action group to demonstrate returning values." stepKey="comment"/>
+        <executeJS function="return 'test'" stepKey="testVariable"/>
+        <return value="{$testVariable}" stepKey="returnVar"/>
+    </actionGroup>
+</actionGroups>

dev/tests/functional/tests/MFTF/DevDocs/Test/DevDocsTest.xml

@@ -46,10 +46,15 @@
             <argument name="test" value="{{HelperData.entityField}}" />
             <argument name="entityTest" value="HelperData" />
         </actionGroup>
-
         <assertEqualsCanonicalizing stepKey="assertMergedArray">
             <actualResult type="array">{{ExtendedMessageData.numbers}}</actualResult>
             <expectedResult type="array">["Something New", "0", "1", "2", "3", "TESTING CASE"]</expectedResult>
         </assertEqualsCanonicalizing>
+
+        <actionGroup ref="ReturnValueActionGroup" stepKey="actionGroupValue"/>
+        <assertEquals stepKey="assertActionGroupValue">
+            <expectedResult type="variable">actionGroupValue</expectedResult>
+            <actualResult type="string">test</actualResult>
+        </assertEquals>
     </test>
 </tests>

dev/tests/verification/Tests/ActionGroupGenerationTest.php

@@ -228,15 +228,4 @@ public function testActionGroupWithActionStepKeyReferencesInSelectors()
     {
         $this->generateAndCompareTest('ActionGroupWithParameterizedElementsWithStepKeyReferences');
     }
-
-    /**
-     * Test generation of a test referencing an action group that returns a value.
-     *
-     * @throws \Exception
-     * @throws \Magento\FunctionalTestingFramework\Exceptions\TestReferenceException
-     */
-    public function testActionGroupReturningValue()
-    {
-        $this->generateAndCompareTest('ActionGroupReturningValueTest');
-    }
 }

src/Magento/FunctionalTestingFramework/Test/etc/Actions/customActions.xsd

@@ -363,7 +363,7 @@
                 <xs:attribute name="value" use="required" type="xs:string">
                     <xs:annotation>
                         <xs:documentation>
-                            Value to be returned.
+                            Value or variable to be returned.
                         </xs:documentation>
                     </xs:annotation>
                 </xs:attribute>