pptb-standard-sample-tool 1.5.2 → 1.7.0

package/README.md

@@ -120,7 +120,7 @@ html-sample/
 - FetchXML query to retrieve top 10 accounts
 - Display results with formatting
 - If a FetchXML is saved in Tool Settings, the Query button will use that instead of the default
-- This sample supports multi-connection: try the "Secondary" buttons to run the same queries against the secondary connection
+- This sample supports up to three connections: use the Primary, Secondary, and Third query buttons to test slots 0, 1, and 2
 
 **CRUD Operations:**
 

package/dist/app.js

@@ -19,6 +19,7 @@ const powerplatform = window.powerplatformAPI;
 // Application state
 let currentConnection = null;
 let secondaryConnection = null;
+let thirdConnection = null;
 let currentTerminal = null;
 let createdId = null;
 let currentLaunchContext = null;
@@ -137,7 +138,8 @@ async function identifyLaunchContext() {
 async function refreshConnection() {
     try {
         currentConnection = await toolbox.connections.getActiveConnection();
-        secondaryConnection = await toolbox.connections.getSecondaryConnection();
+        secondaryConnection = await toolbox.connections.getConnection("secondary");
+        thirdConnection = await toolbox.connections.getConnection(2);
         const connectionInfo = document.getElementById("connection-info");
         if (!connectionInfo)
             return;
@@ -207,6 +209,39 @@ async function refreshConnection() {
             secondaryInfo.innerHTML = "<p><strong>⚠️ No secondary connection</strong><br>Please connect to a secondary Dataverse environment to use this tool.</p>";
             log("No secondary connection found", "warning");
         }
+        const thirdInfo = document.getElementById("third-connection-info");
+        if (!thirdInfo)
+            return;
+        if (thirdConnection) {
+            const envClass = thirdConnection.environment.toLowerCase();
+            thirdInfo.className = "info-box success";
+            thirdInfo.innerHTML = `
+                <div class="connection-details">
+                    <div class="connection-item">
+                        <strong>Name:</strong>
+                        <span>${thirdConnection.name}</span>
+                    </div>
+                    <div class="connection-item">
+                        <strong>URL:</strong>
+                        <span>${thirdConnection.url}</span>
+                    </div>
+                    <div class="connection-item">
+                        <strong>Environment:</strong>
+                        <span class="env-badge ${envClass}">${thirdConnection.environment}</span>
+                    </div>
+                    <div class="connection-item">
+                        <strong>ID:</strong>
+                        <span>${thirdConnection.id}</span>
+                    </div>
+                </div>
+            `;
+            log(`Third connection: ${thirdConnection.name}`, "success");
+        }
+        else {
+            thirdInfo.className = "info-box warning";
+            thirdInfo.innerHTML = "<p><strong>⚠️ No third connection</strong><br>Please connect a third Dataverse environment to use this tool.</p>";
+            log("No third connection found", "warning");
+        }
     }
     catch (error) {
         log(`Error refreshing connection: ${error.message}`, "error");
@@ -273,6 +308,7 @@ function setupEventHandlers() {
     // Dataverse query button
     document.getElementById("query-accounts-btn")?.addEventListener("click", queryAccounts);
     document.getElementById("query-accounts-secondary-btn")?.addEventListener("click", queryAccountsSecondary);
+    document.getElementById("query-accounts-third-btn")?.addEventListener("click", queryAccountsThird);
     document.getElementById("query-contacts-querydata-btn")?.addEventListener("click", queryContactQueryData);
     // CRUD buttons
     document.getElementById("create-contact-btn")?.addEventListener("click", createContact);
@@ -284,6 +320,9 @@ function setupEventHandlers() {
     document.getElementById("get-metadata-allentities")?.addEventListener("click", getAllEntities);
     //Execute buttons
     document.getElementById("whoami-btn")?.addEventListener("click", executeWhoAmI);
+    document.getElementById("query-with-headers-btn")?.addEventListener("click", queryAccountsWithHeaders);
+    document.getElementById("execute-batch-btn")?.addEventListener("click", executeReadBatch);
+    document.getElementById("execute-transaction-btn")?.addEventListener("click", executeAtomicTransaction);
     // Power Platform API buttons
     document.getElementById("list-apps-btn")?.addEventListener("click", listPowerApps);
     document.getElementById("list-flows-btn")?.addEventListener("click", listPowerAutomateFlows);
@@ -642,6 +681,53 @@ async function queryAccountsSecondary() {
         log(`Error querying accounts (secondary): ${error.message}`, "error");
     }
 }
+/**
+ * Query accounts from Dataverse using the third connection slot (FetchXML)
+ */
+async function queryAccountsThird() {
+    if (!thirdConnection) {
+        await showNotification("No Third Connection", "Please configure a third Dataverse connection", "warning");
+        return;
+    }
+    const output = document.getElementById("query-output-third");
+    try {
+        if (output)
+            output.textContent = "Querying accounts using third connection...\n";
+        const saved = await getSetting("demo.fetchxml");
+        const fetchXml = saved && saved.trim().length > 0
+            ? saved
+            : `
+<fetch top="10">
+    <entity name="account">
+        <attribute name="name" />
+        <attribute name="accountid" />
+        <attribute name="emailaddress1" />
+        <attribute name="telephone1" />
+        <order attribute="name" />
+    </entity>
+</fetch>
+        `.trim();
+        const result = await dataverse.fetchXmlQuery(fetchXml, 2);
+        if (output) {
+            output.textContent = `Found ${result.value.length} account(s) on third connection:\n\n`;
+            result.value.forEach((account, index) => {
+                output.textContent += `${index + 1}. ${account.name}\n`;
+                output.textContent += `   ID: ${account.accountid}\n`;
+                if (account.emailaddress1)
+                    output.textContent += `   Email: ${account.emailaddress1}\n`;
+                if (account.telephone1)
+                    output.textContent += `   Phone: ${account.telephone1}\n`;
+                output.textContent += "\n";
+            });
+        }
+        log(`Queried ${result.value.length} accounts on third connection`, "success");
+    }
+    catch (error) {
+        if (output)
+            output.textContent = `Error (third connection): ${error.message}`;
+        log(`Error querying accounts (third connection): ${error.message}`, "error");
+    }
+}
 /**
  * Create a new account
  */
@@ -854,6 +940,98 @@ async function executeWhoAmI() {
         log(`Error executing WhoAmI: ${error.message}`, "error");
     }
 }
+function getAdditionalHeaders() {
+    const input = document.getElementById("dataverse-headers");
+    const parsed = JSON.parse(input?.value || "{}");
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("Additional headers must be a JSON object");
+    }
+    const headers = {};
+    for (const [name, value] of Object.entries(parsed)) {
+        if (typeof value !== "string") {
+            throw new Error(`Header value for '${name}' must be a string`);
+        }
+        headers[name] = value;
+    }
+    return headers;
+}
+async function queryAccountsWithHeaders() {
+    if (!currentConnection) {
+        await showNotification("No Connection", "Please connect to a Dataverse environment", "warning");
+        return;
+    }
+    const output = document.getElementById("headers-output");
+    try {
+        const headers = getAdditionalHeaders();
+        if (output)
+            output.textContent = "Querying accounts with additional headers...\n";
+        const result = await dataverse.queryData("accounts?$select=name,accountid&$top=5", "primary", headers);
+        if (output) {
+            output.textContent = `Found ${result.value.length} account(s):\n\n`;
+            output.textContent += JSON.stringify(result.value, null, 2);
+        }
+        log(`Queried ${result.value.length} accounts with additional headers`, "success");
+    }
+    catch (error) {
+        if (output)
+            output.textContent = `Error: ${error.message}`;
+        log(`Error querying accounts with headers: ${error.message}`, "error");
+    }
+}
+async function executeReadBatch() {
+    if (!currentConnection) {
+        await showNotification("No Connection", "Please connect to a Dataverse environment", "warning");
+        return;
+    }
+    const output = document.getElementById("batch-output");
+    try {
+        const headers = getAdditionalHeaders();
+        if (output)
+            output.textContent = "Executing read batch...\n";
+        const results = await dataverse.executeBatch([
+            { method: "GET", url: "accounts?$select=name,accountid&$top=3" },
+            { method: "GET", url: "contacts?$select=fullname,contactid&$top=3" },
+        ], "primary", headers);
+        if (output)
+            output.textContent = `Batch returned ${results.length} result(s):\n\n${JSON.stringify(results, null, 2)}`;
+        log(`Read batch completed with ${results.length} result(s)`, "success");
+    }
+    catch (error) {
+        if (output)
+            output.textContent = `Error: ${error.message}`;
+        log(`Error executing read batch: ${error.message}`, "error");
+    }
+}
+async function executeAtomicTransaction() {
+    if (!currentConnection) {
+        await showNotification("No Connection", "Please connect to a Dataverse environment", "warning");
+        return;
+    }
+    const output = document.getElementById("batch-output");
+    try {
+        const headers = getAdditionalHeaders();
+        const suffix = new Date().toISOString();
+        if (output)
+            output.textContent = `Executing atomic transaction (creating an account and contact - ${`HTML Sample ${suffix}`} )...\n`;
+        const results = await dataverse.executeTransaction([
+            { method: "POST", url: "accounts", contentId: "account", body: { name: `HTML Sample ${suffix}` } },
+            {
+                method: "POST",
+                url: "contacts",
+                contentId: "contact",
+                body: { firstname: "HTML", lastname: `Sample ${suffix}` },
+            },
+        ], "primary", headers);
+        if (output)
+            output.textContent = `Transaction returned ${results.length} result(s):\n\n${JSON.stringify(results, null, 2)}`;
+        log(`Atomic transaction completed with ${results.length} result(s)`, "success");
+    }
+    catch (error) {
+        if (output)
+            output.textContent = `Error: ${error.message}`;
+        log(`Error executing atomic transaction: ${error.message}`, "error");
+    }
+}
 /**
  * Apply current theme
  */

package/dist/index.html

@@ -29,6 +29,13 @@
                 </div>
             </section>
 
+            <section class="card">
+                <h2>🔗 Third Connection Status</h2>
+                <div id="third-connection-info" class="info-box">
+                    <div class="loading">Checking connection...</div>
+                </div>
+            </section>
+
             <!-- ToolBox API Examples -->
             <section class="card">
                 <h2>🛠️ ToolBox API Examples</h2>
@@ -146,10 +153,12 @@
                     <div class="button-group">
                         <button id="query-accounts-btn" class="btn btn-primary">Query Top 10 Accounts (Primary)</button>
                         <button id="query-accounts-secondary-btn" class="btn">Query Top 10 Accounts (Secondary)</button>
+                        <button id="query-accounts-third-btn" class="btn">Query Top 10 Accounts (Third)</button>
                         <button id="query-contacts-querydata-btn" class="btn">Query Top 10 Contacts (Primary)</button>
                     </div>
                     <div id="query-output" class="output"></div>
                     <div id="query-output-secondary" class="output"></div>
+                    <div id="query-output-third" class="output"></div>
                 </div>
 
                 <div class="example-group">
@@ -183,6 +192,38 @@
                     <button id="whoami-btn" class="btn">Execute WhoAmI</button>
                     <div id="execute-output" class="output"></div>
                 </div>
+
+                <div class="example-group">
+                    <h3>Additional Headers</h3>
+                    <p style="margin: 4px 0 10px; font-size: 12px; opacity: 0.85">
+                        Headers are shown for consent before the request is sent. Use valid Dataverse header names and string values.
+                    </p>
+                    <div class="input-group">
+                        <label for="dataverse-headers">Additional Headers (JSON):</label>
+                        <textarea
+                            id="dataverse-headers"
+                            style="width: 100%; min-height: 90px; padding: 10px; border: 2px solid #e0e0e0; border-radius: 6px; font-family: monospace; font-size: 12px; line-height: 1.4"
+                        >{
+  "Prefer": "odata.include-annotations=\"*\""
+}</textarea>
+                    </div>
+                    <div class="button-group">
+                        <button id="query-with-headers-btn" class="btn btn-primary">Query Accounts with Headers</button>
+                    </div>
+                    <div id="headers-output" class="output"></div>
+                </div>
+
+                <div class="example-group">
+                    <h3>Batch Operations</h3>
+                    <p style="margin: 4px 0 10px; font-size: 12px; opacity: 0.85">
+                        Runs independent reads in one <code>$batch</code> request or creates an account and contact in one atomic transaction.
+                    </p>
+                    <div class="button-group">
+                        <button id="execute-batch-btn" class="btn btn-primary">Execute Read Batch</button>
+                        <button id="execute-transaction-btn" class="btn btn-warning">Execute Atomic Transaction</button>
+                    </div>
+                    <div id="batch-output" class="output"></div>
+                </div>
             </section>
 
             <!-- Power Platform API Examples -->

package/npm-shrinkwrap.json

@@ -1,15 +1,15 @@
 {
     "name": "pptb-standard-sample-tool",
-    "version": "1.5.1",
+    "version": "1.7.0",
     "lockfileVersion": 3,
     "requires": true,
     "packages": {
         "": {
             "name": "pptb-standard-sample-tool",
-            "version": "1.5.1",
+            "version": "1.7.0",
             "license": "GPL-3.0",
             "devDependencies": {
-                "@pptb/types": "^1.2.6-beta.2",
+                "@pptb/types": "^1.2.7-beta.4",
                 "shx": "^0.4.0",
                 "typescript": "^5.0.0"
             },
@@ -69,26 +69,26 @@
             }
         },
         "node_modules/@pptb/types": {
-            "version": "1.2.6-beta.2",
-            "resolved": "https://registry.npmjs.org/@pptb/types/-/types-1.2.6-beta.2.tgz",
-            "integrity": "sha512-k6Ov2Jfl3c2Et4h86fiKPZK2E0i/hIMGDNnXsXZgREAwU4tMtBmcqrQNr6YfFJOIRzM2fSbQDqW9bGecup5i2Q==",
+            "version": "1.2.7-beta.4",
+            "resolved": "https://registry.npmjs.org/@pptb/types/-/types-1.2.7-beta.4.tgz",
+            "integrity": "sha512-i/bkvXuplSbOHgekfQglmuGDc2PrBs+3uX/rFdNOl1RhyAf1st4SbseA/YeA2eWQN2Mm32YAXhuGqB7BS0yxdw==",
             "dev": true,
             "license": "GPL-3.0",
             "dependencies": {
-                "@pptb/validate": "1.0.2"
+                "@pptb/validate": "1.0.4"
             },
             "bin": {
                 "pptb-validate": "bin/pptb-validate.js"
             }
         },
         "node_modules/@pptb/validate": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/@pptb/validate/-/validate-1.0.2.tgz",
-            "integrity": "sha512-D6bfEa1a7p9ju7BUY2l/jJ8tK7s5SEtpvNriBRfasazP91mJ6eL5mLqOGwwjQ9aPyRJoeFyVmdF4gRyFMCcG7Q==",
+            "version": "1.0.4",
+            "resolved": "https://registry.npmjs.org/@pptb/validate/-/validate-1.0.4.tgz",
+            "integrity": "sha512-Xew21gUgwrdstVpu6EB8b8vDaWNE4OOiPqr1Xk61Ao2EKN4ioCVg/cG6uFRFBhLaLqSjublVYczJ01KAUbBsvw==",
             "dev": true,
             "license": "GPL-3.0",
             "dependencies": {
-                "tar": "^7.5.16"
+                "tar": "^7.5.21"
             },
             "bin": {
                 "pptb-validate": "dist/cli.js"

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pptb-standard-sample-tool",
-    "version": "1.5.2",
+    "version": "1.7.0",
     "displayName": "HTML Sample Tool",
     "description": "A sample Power Platform ToolBox tool built with HTML, CSS, and TypeScript",
     "main": "index.html",
@@ -27,10 +27,12 @@
         "readmeUrl": "https://raw.githubusercontent.com/PowerPlatformToolBox/sample-tools/refs/heads/main/new/html-sample/README.md"
     },
     "features": {
-        "minAPI": "1.2.6",
-        "multiConnection": "optional",
+        "minAPI": "1.2.7",
         "enabledForPowerPlatformAPI": true,
-        "connectionRequirement": "optional"
+        "connections": {
+            "min": 0,
+            "max": 3
+        }
     },
     "cspExceptions": {
         "style-src": [
@@ -79,7 +81,7 @@
         "validate": "pptb-validate"
     },
     "devDependencies": {
-        "@pptb/types": "^1.2.6-beta.2",
+        "@pptb/types": "^1.2.7-beta.4",
         "shx": "^0.4.0",
         "typescript": "^5.0.0"
     },