MQE-364:[Data Input] Metadata nest jsonObject not working as expected.

    - add method for parsing nested jsonObjects
    - add method for root level jsonObjects

Author: imeron2433

src/Magento/FunctionalTestingFramework/DataGenerator/Api/ApiExecutor.php

@@ -161,8 +161,10 @@ private function convertJsonArray($entityObject, $jsonArrayMetadata)
 
         foreach ($jsonArrayMetadata as $jsonElement) {
             if ($jsonElement->getType() == JsonObjectExtractor::JSON_OBJECT_OBJ_NAME) {
+                $entityObj = $this->resolveJsonObjectAndEntityData($entityObject, $jsonElement->getValue());
                 $jsonArray[$jsonElement->getValue()] =
-                    $this->convertJsonArray($entityObject, $jsonElement->getNestedMetadata());
+                    $this->convertJsonArray($entityObj, $jsonElement->getNestedMetadata());
+                continue;
             }
 
             $jsonElementType = $jsonElement->getValue();
@@ -222,6 +224,25 @@ private function convertJsonArray($entityObject, $jsonArrayMetadata)
         return $jsonArray;
     }
 
+    /**
+     * This function does a comparison of the entity object being matched to the json element. If there is a mismatch in
+     * type we attempt to use a nested entity, if the entities are properly matched, we simply return the object.
+     *
+     * @param EntityDataObject $entityObject
+     * @param string $jsonElementValue
+     * @return EntityDataObject|null
+     */
+    private function resolveJsonObjectAndEntityData($entityObject, $jsonElementValue)
+    {
+        if ($jsonElementValue != $entityObject->getType()) {
+            // if we have a mismatch attempt to retrieve linked data and return just the first linkage
+            $linkName = $entityObject->getLinkedEntitiesOfType($jsonElementValue)[0];
+            return DataObjectHandler::getInstance()->getObject($linkName);
+        }
+
+        return $entityObject;
+    }
+
     /**
      * Resolves JsonObjects and pre-defined metadata (in other operation.xml file) referenced by the json metadata
      *
@@ -233,6 +254,7 @@ private function resolveNonPrimitiveElement($entityName, $jsonElement)
     {
         $linkedEntityObj = $this->resolveLinkedEntityObject($entityName);
 
+        // in array case
         if (!empty($jsonElement->getNestedJsonElement($jsonElement->getValue()))
             && $jsonElement->getType() == 'array'
         ) {

src/Magento/FunctionalTestingFramework/DataGenerator/Util/JsonObjectExtractor.php

@@ -58,7 +58,7 @@ public function extractJsonObject($jsonObjectArray)
         if (array_key_exists(JsonObjectExtractor::JSON_OBJECT_OBJ_NAME, $jsonObjectArray)) {
             foreach ($jsonObjectArray[JsonObjectExtractor::JSON_OBJECT_OBJ_NAME] as $jsonObject) {
                 $nestedJsonElement = $this->extractJsonObject($jsonObject);
-                $nestedJsonElements[$nestedJsonElement->getKey()] = $nestedJsonElement;
+                $jsonMetadata[] = $nestedJsonElement;
             }
         }