pptb-standard-sample-tool 1.0.7 → 1.0.9

package/README.md

@@ -18,6 +18,7 @@ This sample demonstrates:
 
 - ✅ **Dataverse API Usage**
   - FetchXML queries
+    - Multi-connection queries (primary and secondary)
   - CRUD operations (Create, Read, Update, Delete)
   - Entity metadata retrieval
   - Error handling
@@ -102,6 +103,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
 
 **CRUD Operations:**
 - Create new account records
@@ -230,6 +232,22 @@ const result = await dataverse.fetchXmlQuery(`
     </fetch>
 `);
 
+// Query with FetchXML targeting the secondary connection
+const secondaryResult = await dataverse.fetchXmlQuery(`
+    <fetch top="5">
+        <entity name="account">
+            <attribute name="name" />
+            <order attribute="name" />
+        </entity>
+    </fetch>
+`, 'secondary');
+
+// Query via OData (secondary)
+const odataResult = await (dataverse as any).queryData(
+    '$select=name,accountid&$filter=statecode eq 0&$orderby=name&$top=5',
+    'secondary'
+);
+
 // Create record
 const account = await dataverse.create('account', {
     name: 'Contoso Ltd',
@@ -246,6 +264,9 @@ await dataverse.delete('account', accountId);
 
 // Get metadata
 const metadata = await dataverse.getEntityMetadata('account');
+
+// Get metadata on secondary
+const metadataSecondary = await dataverse.getEntityMetadata('account', true, ['LogicalName'], 'secondary');
 ```
 
 ## Troubleshooting

package/dist/app.js

@@ -15,6 +15,7 @@ const toolbox = window.toolboxAPI;
 const dataverse = window.dataverseAPI;
 // Application state
 let currentConnection = null;
+let secondaryConnection = null;
 let currentTerminal = null;
 let createdId = null;
 /**
@@ -45,6 +46,7 @@ async function initialize() {
 async function refreshConnection() {
     try {
         currentConnection = await toolbox.connections.getActiveConnection();
+        secondaryConnection = await toolbox.connections.getSecondaryConnection();
         const connectionInfo = document.getElementById('connection-info');
         if (!connectionInfo)
             return;
@@ -78,6 +80,42 @@ async function refreshConnection() {
             connectionInfo.innerHTML = '<p><strong>⚠️ No active connection</strong><br>Please connect to a Dataverse environment to use this tool.</p>';
             log('No active connection found', 'warning');
         }
+        if (secondaryConnection) {
+            const secondaryInfo = document.getElementById('secondary-connection-info');
+            if (!secondaryInfo)
+                return;
+            const envClass = secondaryConnection.environment.toLowerCase();
+            secondaryInfo.className = 'info-box success';
+            secondaryInfo.innerHTML = `
+                <div class="connection-details">
+                    <div class="connection-item">
+                        <strong>Name:</strong>
+                        <span>${secondaryConnection.name}</span>
+                    </div>
+                    <div class="connection-item">
+                        <strong>URL:</strong>
+                        <span>${secondaryConnection.url}</span>
+                    </div>
+                    <div class="connection-item">
+                        <strong>Environment:</strong>
+                        <span class="env-badge ${envClass}">${secondaryConnection.environment}</span>
+                    </div>
+                    <div class="connection-item">
+                        <strong>ID:</strong>
+                        <span>${secondaryConnection.id}</span>
+                    </div>
+                </div>
+            `;
+            log(`Secondary connection: ${secondaryConnection.name}`, 'success');
+        }
+        else {
+            const secondaryInfo = document.getElementById('secondary-connection-info');
+            if (!secondaryInfo)
+                return;
+            secondaryInfo.className = 'info-box warning';
+            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');
+        }
     }
     catch (error) {
         log(`Error refreshing connection: ${error.message}`, 'error');
@@ -129,6 +167,9 @@ function setupEventHandlers() {
     document.getElementById('close-terminal-btn')?.addEventListener('click', closeTerminal);
     // Dataverse query button
     document.getElementById('query-accounts-btn')?.addEventListener('click', queryAccounts);
+    document.getElementById('query-odata-btn')?.addEventListener('click', queryODataAccounts);
+    document.getElementById('query-accounts-secondary-btn')?.addEventListener('click', queryAccountsSecondary);
+    document.getElementById('query-odata-secondary-btn')?.addEventListener('click', queryODataSecondary);
     // CRUD buttons
     document.getElementById('create-contact-btn')?.addEventListener('click', createContact);
     document.getElementById('update-contact-btn')?.addEventListener('click', updateContact);
@@ -358,6 +399,126 @@ async function queryAccounts() {
         log(`Error querying accounts: ${error.message}`, 'error');
     }
 }
+/**
+ * Query accounts from Dataverse using OData
+ */
+async function queryODataAccounts() {
+    if (!currentConnection) {
+        await showNotification('No Connection', 'Please connect to a Dataverse environment', 'warning');
+        return;
+    }
+    try {
+        const output = document.getElementById('query-odata-output');
+        if (output)
+            output.textContent = 'Querying accounts via OData...\n';
+        // Example OData query: top 5 active accounts with basic fields
+        const odata = `$select=name,accountid,emailaddress1,telephone1&$filter=statecode eq 0&$orderby=name&$top=5`;
+        const result = await dataverse.queryData(odata);
+        if (output) {
+            output.textContent = `Found ${result.value.length} active account(s) (OData):\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 via OData`, 'success');
+    }
+    catch (error) {
+        const output = document.getElementById('query-odata-output');
+        if (output)
+            output.textContent = `Error (OData): ${error.message}`;
+        log(`Error OData querying accounts: ${error.message}`, 'error');
+    }
+}
+/**
+ * Query accounts from Dataverse using the secondary connection (FetchXML)
+ */
+async function queryAccountsSecondary() {
+    if (!secondaryConnection) {
+        await showNotification('No Secondary Connection', 'Please configure a secondary Dataverse connection', 'warning');
+        return;
+    }
+    try {
+        const output = document.getElementById('query-output-secondary');
+        if (output)
+            output.textContent = 'Querying accounts using secondary connection...\n';
+        // Use saved FetchXML if present, otherwise default
+        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();
+        // Pass 'secondary' to target the secondary connection
+        const result = await dataverse.fetchXmlQuery(fetchXml, 'secondary');
+        if (output) {
+            output.textContent = `Found ${result.value.length} account(s) on secondary:\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 secondary`, 'success');
+    }
+    catch (error) {
+        const output = document.getElementById('query-output-secondary');
+        if (output)
+            output.textContent = `Error (secondary): ${error.message}`;
+        log(`Error querying accounts (secondary): ${error.message}`, 'error');
+    }
+}
+/**
+ * Query accounts from Dataverse using OData against the secondary connection
+ */
+async function queryODataSecondary() {
+    if (!secondaryConnection) {
+        await showNotification('No Secondary Connection', 'Please configure a secondary Dataverse connection', 'warning');
+        return;
+    }
+    try {
+        const output = document.getElementById('query-odata-secondary-output');
+        if (output)
+            output.textContent = 'Querying accounts via OData on secondary...\n';
+        // Example OData query: top 5 active accounts with basic fields
+        const odata = `$select=name,accountid,emailaddress1,telephone1&$filter=statecode eq 0&$orderby=name&$top=5`;
+        const result = await dataverse.queryData(odata, 'secondary');
+        if (output) {
+            output.textContent = `Found ${result.value.length} active account(s) on secondary (OData):\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 via OData on secondary`, 'success');
+    }
+    catch (error) {
+        const output = document.getElementById('query-odata-secondary-output');
+        if (output)
+            output.textContent = `Error (OData secondary): ${error.message}`;
+        log(`Error OData querying accounts (secondary): ${error.message}`, 'error');
+    }
+}
 /**
  * Create a new account
  */

package/dist/index.html

@@ -15,12 +15,19 @@
 
         <!-- Connection Status -->
         <section class="card">
-            <h2>🔗 Connection Status</h2>
+            <h2>🔗 Primary Connection Status</h2>
             <div id="connection-info" class="info-box">
                 <div class="loading">Checking connection...</div>
             </div>
         </section>
 
+        <section class="card">
+            <h2>🔗 Secondary Connection Status</h2>
+            <div id="secondary-connection-info" class="info-box">
+                <div class="loading">Checking connection...</div>
+            </div>
+        </section>
+
         <!-- ToolBox API Examples -->
         <section class="card">
             <h2>🛠️ ToolBox API Examples</h2>
@@ -85,8 +92,16 @@
             
             <div class="example-group">
                 <h3>Query Records</h3>
-                <button id="query-accounts-btn" class="btn btn-primary">Query Top 10 Accounts</button>
+                <div class="button-group">
+                    <button id="query-accounts-btn" class="btn btn-primary">Query Top 10 Accounts (Primary)</button>
+                    <button id="query-odata-btn" class="btn btn-primary">Query Active Accounts via OData (Primary)</button>
+                    <button id="query-accounts-secondary-btn" class="btn">Query Top 10 Accounts (Secondary)</button>
+                    <button id="query-odata-secondary-btn" class="btn">Query Active Accounts via OData (Secondary)</button>
+                </div>
                 <div id="query-output" class="output"></div>
+                <div id="query-odata-output" class="output"></div>
+                <div id="query-output-secondary" class="output"></div>
+                <div id="query-odata-secondary-output" class="output"></div>
             </div>
 
             <div class="example-group">

package/npm-shrinkwrap.json

@@ -1,15 +1,15 @@
 {
     "name": "pptb-standard-sample-tool",
-    "version": "1.0.4",
+    "version": "1.0.8",
     "lockfileVersion": 3,
     "requires": true,
     "packages": {
         "": {
             "name": "pptb-standard-sample-tool",
-            "version": "1.0.4",
+            "version": "1.0.8",
             "license": "GPL-3.0",
             "devDependencies": {
-                "@pptb/types": "^1.0.8",
+                "@pptb/types": "^1.0.11",
                 "shx": "^0.4.0",
                 "typescript": "^5.0.0"
             },
@@ -56,9 +56,9 @@
             }
         },
         "node_modules/@pptb/types": {
-            "version": "1.0.8",
-            "resolved": "https://registry.npmjs.org/@pptb/types/-/types-1.0.8.tgz",
-            "integrity": "sha512-qGjif4qCFvGsHFB4Ly0xcvfTMkr+IB9WXh2/Zn0/C//orX6IBpnlSXn2D3xUjj69a9hAiqjVMhNJ1fpJJNqO7g==",
+            "version": "1.0.11",
+            "resolved": "https://registry.npmjs.org/@pptb/types/-/types-1.0.11.tgz",
+            "integrity": "sha512-Sgzl4az106T7GmDuobZUy35NccGTXXOGY250AI2rSEz6soYTXdO7azxzdfKyVUwEhoprlfhfdAdhpjU0ruo8rg==",
             "dev": true,
             "license": "GPL-3.0"
         },

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pptb-standard-sample-tool",
-    "version": "1.0.7",
+    "version": "1.0.9",
     "displayName": "HTML Sample Tool",
     "description": "A sample Power Platform Tool Box tool built with HTML, CSS, and TypeScript",
     "main": "index.html",
@@ -14,6 +14,21 @@
         "html"
     ],
     "license": "GPL-3.0",
+    "contributors": [
+        {
+            "name": "Power Platform Tool Box",
+            "url": "https://github.com/PowerPlatform-ToolBox"
+        }
+    ],
+    "configurations": {
+        "repository": "https://github.com/PowerPlatform-ToolBox/html-sample",
+        "website": "https://powerplatformtoolbox.com",
+        "iconUrl": "https://raw.githubusercontent.com/PowerPlatformToolBox/sample-tools/refs/heads/main/new/html-sample/icon/sample-icon.png",
+        "readmeUrl": "https://raw.githubusercontent.com/PowerPlatformToolBox/sample-tools/refs/heads/main/new/html-sample/README.md"
+    },
+    "features": {
+        "multi-connection": true
+    },
     "repository": {
         "type": "git",
         "url": "https://github.com/PowerPlatform-ToolBox/desktop-app.git",
@@ -30,7 +45,7 @@
         "watch": "tsc --watch"
     },
     "devDependencies": {
-        "@pptb/types": "^1.0.8",
+        "@pptb/types": "^1.0.11",
         "typescript": "^5.0.0",
         "shx": "^0.4.0"
     },