From 75a0536f57333ab67769f065237117596b43a9f9 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 4 Jul 2025 11:25:14 +0000
Subject: [PATCH 1/2] Initial plan


From 0ee361c00ffbab9a4c51059f98b68bccef48ca22 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 4 Jul 2025 11:33:47 +0000
Subject: [PATCH 2/2] Changes before error encountered

Co-authored-by: silvath <2657156+silvath@users.noreply.github.com>
---
 .../GetExternalFrameMessage/description.html  |  1 +
 .../GetExternalFrameMessage/parameters.json   | 27 +++++++++++++++
 .../samples/001/content.html                  | 34 +++++++++++++++++++
 .../samples/001/description.html              |  1 +
 4 files changed, 63 insertions(+)
 create mode 100644 src/WebDocs/wwwroot/app/functions/GetExternalFrameMessage/description.html
 create mode 100644 src/WebDocs/wwwroot/app/functions/GetExternalFrameMessage/parameters.json
 create mode 100644 src/WebDocs/wwwroot/app/functions/GetExternalFrameMessage/samples/001/content.html
 create mode 100644 src/WebDocs/wwwroot/app/functions/GetExternalFrameMessage/samples/001/description.html

diff --git a/src/WebDocs/wwwroot/app/functions/GetExternalFrameMessage/description.html b/src/WebDocs/wwwroot/app/functions/GetExternalFrameMessage/description.html
new file mode 100644
index 00000000..c648da44
--- /dev/null
+++ b/src/WebDocs/wwwroot/app/functions/GetExternalFrameMessage/description.html
@@ -0,0 +1 @@
+<p>The GetExternalFrameMessage function is used to retrieve data from an external iframe using the postMessage API. This function sends a message to the specified iframe and waits for a response, then stores the received data in the specified data key. It enables secure communication between the parent window and child iframe content.</p>
\ No newline at end of file
diff --git a/src/WebDocs/wwwroot/app/functions/GetExternalFrameMessage/parameters.json b/src/WebDocs/wwwroot/app/functions/GetExternalFrameMessage/parameters.json
new file mode 100644
index 00000000..5b8ae7ca
--- /dev/null
+++ b/src/WebDocs/wwwroot/app/functions/GetExternalFrameMessage/parameters.json
@@ -0,0 +1,27 @@
+[
+  {
+    "Name": "frameID",
+    "Description": "The ID of the iframe element to communicate with",
+    "Types": [ "text", "mustache" ],
+    "Optional": false
+  },
+  {
+    "Name": "externalFunction",
+    "Description": "The tag or function name to be used in the message for identification purposes",
+    "Types": [ "text", "mustache" ],
+    "Optional": false
+  },
+  {
+    "Name": "dataKey",
+    "Description": "The data key where the response data will be stored",
+    "Types": [ "datakey" ],
+    "Optional": false
+  },
+  {
+    "Name": "isClone",
+    "Description": "Whether to clone the received data before storing it",
+    "Types": [ "boolean" ],
+    "Optional": true,
+    "DefaultValue": "false"
+  }
+]
\ No newline at end of file
diff --git a/src/WebDocs/wwwroot/app/functions/GetExternalFrameMessage/samples/001/content.html b/src/WebDocs/wwwroot/app/functions/GetExternalFrameMessage/samples/001/content.html
new file mode 100644
index 00000000..af5f7831
--- /dev/null
+++ b/src/WebDocs/wwwroot/app/functions/GetExternalFrameMessage/samples/001/content.html
@@ -0,0 +1,34 @@
+<div d-dataKey="externalData" d-dataType="array"></div>
+<div d-dataKey="responseMessage" d-dataType="value"></div>
+
+<h3>GetExternalFrameMessage Example</h3>
+<p>This example demonstrates how to get data from an external iframe using postMessage communication.</p>
+
+<div style="margin: 10px 0;">
+    <input type="button" value="Get Data from Frame" d-on-click="GetExternalFrameMessage(sampleFrame,GetUserData,externalData,true)" />
+    <span d-model="{{responseMessage}}"></span>
+</div>
+
+<h4>Received Data:</h4>
+<div d-for="item in externalData">
+    <div style="border: 1px solid #ccc; padding: 5px; margin: 2px;">
+        <strong>{{item.name}}</strong> - {{item.email}}
+    </div>
+</div>
+
+<h4>Sample iframe (simulated):</h4>
+<iframe id="sampleFrame" 
+        src="data:text/html,<html><body><script>
+        window.addEventListener('message', function(event) {
+            if (event.data && event.data.Action === 'get' && event.data.Tag === 'GetUserData') {
+                const sampleData = [
+                    {name: 'John Doe', email: 'john@example.com'},
+                    {name: 'Jane Smith', email: 'jane@example.com'}
+                ];
+                event.source.postMessage({_data: sampleData}, '*');
+            }
+        });
+        </script>
+        <p>Sample iframe content - this would normally be an external page</p>
+        </body></html>"
+        style="width: 100%; height: 100px; border: 1px solid #ddd;"></iframe>
\ No newline at end of file
diff --git a/src/WebDocs/wwwroot/app/functions/GetExternalFrameMessage/samples/001/description.html b/src/WebDocs/wwwroot/app/functions/GetExternalFrameMessage/samples/001/description.html
new file mode 100644
index 00000000..9875d214
--- /dev/null
+++ b/src/WebDocs/wwwroot/app/functions/GetExternalFrameMessage/samples/001/description.html
@@ -0,0 +1 @@
+<p>A sample that demonstrates GetExternalFrameMessage to retrieve data from an iframe. The example shows how to communicate with an external frame to get user data and store it in a data key.</p>
\ No newline at end of file