
add-excel
โ Officialโ 413by microsoft ยท part of microsoft/power-platform-skills
Adds Excel Online (Business) connector to a Power Apps code app. Use when reading or writing Excel workbook data from OneDrive or SharePoint.
This is the playbook your agent receives when the skill activates โ you don't need to read it to use the skill, but it's here to audit before installing.
๐ Shared Instructions: shared-instructions.md - Cross-cutting concerns.
Add Excel Online
Workflow
- Check Memory Bank โ 2. Gather โ 3. Add Connector โ 4. Configure โ 5. Build โ 6. Update Memory Bank
Step 1: Check Memory Bank
Check for memory-bank.md per shared-instructions.md.
Step 2: Gather
Ask the user:
- Where is the workbook? (OneDrive or SharePoint)
- Workbook file name
- Which table(s) in the workbook to access
Step 3: Add Connector
First, find the connection ID (see connector-reference.md):
Run the /list-connections skill. Find the Excel Online (Business) connection in the output. If none exists, direct the user to create one using the environment-specific Connections URL โ construct it from the active environment ID in context (from power.config.json or a prior step): https://make.powerapps.com/environments/<environment-id>/connections โ + New connection โ search for the connector โ Create.
Excel Online is a tabular datasource -- requires -c (connection ID), -d (drive), and --table (table name in workbook):
# OneDrive workbook
pa app add data-source --connector excelonlinebusiness -c <connection-id> -d 'me' --table 'Table1'
# SharePoint workbook -- dataset is the document library path
pa app add data-source --connector excelonlinebusiness -c <connection-id> -d 'sites/your-site' --table 'Table1'Run for each table the user needs.
Step 4: Configure
AddRowIntoTable -- adds a row to an Excel table:
// OneDrive workbook
await ExcelOnlineBusinessService.AddRowIntoTable({
source: "me",
drive: "me",
file: "MyWorkbook.xlsx",
table: "Table1",
body: { column1: "value1", column2: "value2" } // Flat object, NO "items" wrapper
});
// SharePoint workbook
await ExcelOnlineBusinessService.AddRowIntoTable({
source: "sites/your-site",
drive: "drive-id",
file: "SharedWorkbook.xlsx",
table: "Table1",
body: { column1: "value1", column2: "value2" }
});Key points:
source: "me"anddrive: "me"for OneDrive personal files- For SharePoint, use the site path and drive ID
- The
bodyis a flat key-value object matching column headers -- do NOT wrap in{ items: ... }
Use Grep to find specific methods in src/generated/services/ExcelOnlineBusinessService.ts (generated files can be very large -- see connector-reference.md).
Step 5: Build
npm run buildFix TypeScript errors before proceeding. Do NOT deploy yet.
Step 6: Update Memory Bank
Update memory-bank.md with: connector added, workbook/table configured, build status.
npx skills add microsoft/power-platform-skills --skill "add-excel" --full-depthRun this in your project โ your agent picks the skill up automatically.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITโ you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub โ