@uipath/delegate-sdk 1.203.1 → 1.203.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +41 -3
- package/dist/index.mjs +2 -2
- package/dist/skills/business-analysis/SKILL.md +722 -0
- package/dist/skills/business-analysis/as-is-capture.md +440 -0
- package/dist/skills/business-analysis/assets/progress.yaml +19 -0
- package/dist/skills/business-analysis/assets/task-list.md +34 -0
- package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
- package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
- package/dist/skills/business-analysis/case-to-be-design.md +223 -0
- package/dist/skills/business-analysis/diagram-authoring.md +215 -0
- package/dist/skills/business-analysis/industry-gaps.md +134 -0
- package/dist/skills/business-analysis/interview-spine.md +297 -0
- package/dist/skills/business-analysis/locales/de.json +54 -0
- package/dist/skills/business-analysis/locales/en.json +54 -0
- package/dist/skills/business-analysis/locales/es-MX.json +54 -0
- package/dist/skills/business-analysis/locales/es.json +54 -0
- package/dist/skills/business-analysis/locales/fr.json +54 -0
- package/dist/skills/business-analysis/locales/ja.json +54 -0
- package/dist/skills/business-analysis/locales/ko.json +54 -0
- package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
- package/dist/skills/business-analysis/locales/pt.json +54 -0
- package/dist/skills/business-analysis/locales/ro.json +54 -0
- package/dist/skills/business-analysis/locales/tr.json +54 -0
- package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
- package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
- package/dist/skills/business-analysis/pdd-generation.md +204 -0
- package/dist/skills/business-analysis/pdd-template.md +562 -0
- package/dist/skills/business-analysis/progress-presentation.json +13 -0
- package/dist/skills/business-analysis/recording-first.md +19 -0
- package/dist/skills/business-analysis/recording-processing.md +152 -0
- package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
- package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
- package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
- package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
- package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
- package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
- package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
- package/dist/skills/business-analysis/research-offer.md +104 -0
- package/dist/skills/business-analysis/research-pass.md +149 -0
- package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
- package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
- package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
- package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
- package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
- package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
- package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
- package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
- package/dist/skills/business-analysis/to-be-design.md +199 -0
- package/dist/skills/confluence/SKILL.md +386 -0
- package/dist/skills/doc-coauthoring/SKILL.md +295 -0
- package/dist/skills/excel-architect/SKILL.macos.md +161 -0
- package/dist/skills/excel-architect/SKILL.md +180 -0
- package/dist/skills/excel-architect/SKILL.windows.md +61 -0
- package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
- package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
- package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
- package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
- package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
- package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
- package/dist/skills/excel-architect/building.md +279 -0
- package/dist/skills/excel-architect/create.md +64 -0
- package/dist/skills/excel-architect/data-and-formulas.md +186 -0
- package/dist/skills/excel-architect/generator.md +272 -0
- package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
- package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
- package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
- package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
- package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
- package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
- package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
- package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
- package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
- package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
- package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
- package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
- package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
- package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
- package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
- package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
- package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
- package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
- package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
- package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
- package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
- package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
- package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
- package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
- package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
- package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
- package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
- package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
- package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
- package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
- package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
- package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
- package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
- package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
- package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
- package/dist/skills/excel-architect/reference/api/basic.md +747 -0
- package/dist/skills/excel-architect/reference/guides.md +348 -0
- package/dist/skills/excel-architect/reference/repair.md +174 -0
- package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
- package/dist/skills/excel-architect/scripting.md +266 -0
- package/dist/skills/excel-architect/styling-and-features.md +433 -0
- package/dist/skills/excel-architect/windows/api/composites.md +337 -0
- package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
- package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
- package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
- package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
- package/dist/skills/github/SKILL.md +446 -0
- package/dist/skills/github/recipes/add-comment.md +85 -0
- package/dist/skills/github/recipes/check-pr-status.md +122 -0
- package/dist/skills/github/recipes/compare-branches.md +79 -0
- package/dist/skills/github/recipes/create-issue.md +103 -0
- package/dist/skills/github/recipes/create-pr.md +97 -0
- package/dist/skills/github/recipes/get-file-contents.md +76 -0
- package/dist/skills/github/recipes/get-last-commit.md +128 -0
- package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
- package/dist/skills/github/recipes/list-recent-commits.md +84 -0
- package/dist/skills/github/recipes/search-issues.md +115 -0
- package/dist/skills/google-workspace/SKILL.md +217 -0
- package/dist/skills/google-workspace/services/calendar.md +311 -0
- package/dist/skills/google-workspace/services/docs.md +426 -0
- package/dist/skills/google-workspace/services/drive.md +504 -0
- package/dist/skills/google-workspace/services/gmail.md +466 -0
- package/dist/skills/google-workspace/services/sheets.md +370 -0
- package/dist/skills/internal-comms/SKILL.md +35 -0
- package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
- package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
- package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
- package/dist/skills/internal-comms/examples/general-comms.md +15 -0
- package/dist/skills/jira/SKILL.md +397 -0
- package/dist/skills/jira/recipes/add-comment.md +123 -0
- package/dist/skills/jira/recipes/assign-issue.md +157 -0
- package/dist/skills/jira/recipes/create-issue.md +274 -0
- package/dist/skills/jira/recipes/get-issue-details.md +154 -0
- package/dist/skills/jira/recipes/list-projects.md +151 -0
- package/dist/skills/jira/recipes/my-issues.md +180 -0
- package/dist/skills/jira/recipes/search-issues.md +215 -0
- package/dist/skills/jira/recipes/transition-issue.md +154 -0
- package/dist/skills/jira/recipes/troubleshooting.md +387 -0
- package/dist/skills/knowledge-base/SKILL.md +289 -0
- package/dist/skills/media-tools/SKILL.md +204 -0
- package/dist/skills/media-tools/references/encode-runbook.md +24 -0
- package/dist/skills/media-tools/references/resolve-binaries.md +81 -0
- package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
- package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
- package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
- package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
- package/dist/skills/office-download/SKILL.md +161 -0
- package/dist/skills/outlook-365/SKILL.macos.md +331 -0
- package/dist/skills/outlook-365/SKILL.md +171 -0
- package/dist/skills/outlook-365/SKILL.windows.md +124 -0
- package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
- package/dist/skills/outlook-365/api/check-availability.md +87 -0
- package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
- package/dist/skills/outlook-365/api/download-attachments.md +149 -0
- package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
- package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
- package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
- package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
- package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
- package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
- package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
- package/dist/skills/outlook-365/api/send-email.md +396 -0
- package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
- package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
- package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
- package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
- package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
- package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
- package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
- package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
- package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
- package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
- package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
- package/dist/skills/outlook-365/uia/README.md +75 -0
- package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
- package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
- package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
- package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
- package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
- package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
- package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
- package/dist/skills/pdf-architect/SKILL.md +640 -0
- package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
- package/dist/skills/powerpoint-architect/SKILL.md +853 -0
- package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
- package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
- package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
- package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
- package/dist/skills/powerpoint-architect/images-guide.md +207 -0
- package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
- package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
- package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
- package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
- package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
- package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
- package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
- package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
- package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
- package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
- package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
- package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
- package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
- package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
- package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
- package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
- package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
- package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
- package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
- package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
- package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
- package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
- package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
- package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
- package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
- package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
- package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
- package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
- package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
- package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
- package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
- package/dist/skills/project-task-list/SKILL.md +174 -0
- package/dist/skills/slack-operation/SKILL.md +97 -0
- package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
- package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
- package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
- package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
- package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
- package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
- package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
- package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
- package/dist/skills/system-diagnostics/SKILL.md +263 -0
- package/dist/skills/teams-operation/SKILL.md +79 -0
- package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
- package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
- package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
- package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
- package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
- package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
- package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
- package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
- package/dist/skills/transcribe-media/SKILL.md +142 -0
- package/dist/skills/uipath-integrations/SKILL.md +370 -0
- package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
- package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
- package/dist/skills/uipath-integrations/reference/errors.md +211 -0
- package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
- package/dist/skills/uipath-integrations/reference/operations.md +297 -0
- package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
- package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
- package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
- package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
- package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
- package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
- package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
- package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
- package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
- package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
- package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
- package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
- package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
- package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
- package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
- package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
- package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
- package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
- package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
- package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
- package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
- package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
- package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
- package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
- package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
- package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
- package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
- package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
- package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
- package/dist/skills/word-architect/SKILL.macos.md +147 -0
- package/dist/skills/word-architect/SKILL.md +502 -0
- package/dist/skills/word-architect/SKILL.windows.md +55 -0
- package/dist/skills/word-architect/api/advanced.md +522 -0
- package/dist/skills/word-architect/api/basic.md +378 -0
- package/dist/skills/word-architect/api/expert.md +302 -0
- package/dist/skills/word-architect/generation.md +308 -0
- package/dist/skills/word-architect/layouts/01-professional.md +168 -0
- package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
- package/dist/skills/word-architect/layouts/03-academic.md +83 -0
- package/dist/skills/word-architect/layouts/04-creative.md +242 -0
- package/dist/skills/word-architect/layouts/05-operational.md +94 -0
- package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
- package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
- package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
- package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
- package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
- package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
- package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
- package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
- package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
- package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
- package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
- package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
- package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
- package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
- package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
- package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
- package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
- package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
- package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
- package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
- package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
- package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
- package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
- package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
- package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
- package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
- package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
- package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
- package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
- package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
- package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
- package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
- package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
- package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
- package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
- package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
- package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
- package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
- package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
- package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
- package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
- package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
- package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
- package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
- package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
- package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
- package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
- package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
- package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
- package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
- package/dist/skills/word-architect/reference/formatting.md +119 -0
- package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
- package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
- package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
- package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
- package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
- package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
- package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
- package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
- package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
- package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
- package/dist/skills/word-architect/reference/tables.md +62 -0
- package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
- package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
- package/dist/skills/word-architect/reference/visual-elements.md +82 -0
- package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
- package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
- package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
- package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
- package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
- package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
- package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
- package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
- package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
- package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
- package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
- package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
- package/package.json +5 -4
|
@@ -0,0 +1,337 @@
|
|
|
1
|
+
# Composite Endpoints — Full Schema Reference
|
|
2
|
+
|
|
3
|
+
Complete JSON schemas, field tables, and validation rules for `build-workbook` and `build-sheet`.
|
|
4
|
+
Load this file when constructing composite endpoint payloads.
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## /excel/build-workbook — Full Schema
|
|
9
|
+
|
|
10
|
+
```json
|
|
11
|
+
{
|
|
12
|
+
"filePath": "C:\\Users\\user\\Documents\\Report.xlsx",
|
|
13
|
+
"createDirectories": true,
|
|
14
|
+
"deleteDefaultSheet": true,
|
|
15
|
+
"saveAfterBuild": true,
|
|
16
|
+
"sheets": [
|
|
17
|
+
{
|
|
18
|
+
"sheetName": "Data",
|
|
19
|
+
"data": {
|
|
20
|
+
"range": "A1",
|
|
21
|
+
"rows": [
|
|
22
|
+
{"values": ["Name", "Q1", "Q2", "Total"]},
|
|
23
|
+
{"values": ["North", 1000, 1200, "=SUM(B2:C2)"]},
|
|
24
|
+
{"values": ["South", 800, 950, "=SUM(B3:C3)"]}
|
|
25
|
+
],
|
|
26
|
+
"firstRowIsHeader": true
|
|
27
|
+
},
|
|
28
|
+
"formulas": {
|
|
29
|
+
"startRow": 2, "rowCount": 2,
|
|
30
|
+
"columns": [
|
|
31
|
+
{"column": "E", "template": "=D{row}/B{row}*100"}
|
|
32
|
+
]
|
|
33
|
+
},
|
|
34
|
+
"formatting": [
|
|
35
|
+
{"range": "A1:E1", "bold": true, "interiorColorHtml": "#4472C4", "fontColorHtml": "#FFFFFF"},
|
|
36
|
+
{"range": "B2:C3", "numberFormat": "#,##0"},
|
|
37
|
+
{"range": "D2:D3", "numberFormat": "#,##0", "bold": true},
|
|
38
|
+
{"range": "E2:E3", "numberFormat": "0.0%"}
|
|
39
|
+
],
|
|
40
|
+
"conditionalFormatting": [
|
|
41
|
+
{"range": "D2:D3", "ruleType": "CellValue", "operator": "GreaterThan", "value1": "0", "interiorColorHtml": "#C6EFCE"},
|
|
42
|
+
{"range": "D2:D3", "ruleType": "CellValue", "operator": "LessThan", "value1": "0", "interiorColorHtml": "#FFC7CE"}
|
|
43
|
+
],
|
|
44
|
+
"freeze": {"rows": 1},
|
|
45
|
+
"charts": [
|
|
46
|
+
{
|
|
47
|
+
"valueRange": "B1:C3",
|
|
48
|
+
"xLabelRange": "A2:A3",
|
|
49
|
+
"chartType": "column",
|
|
50
|
+
"title": "Quarterly Sales",
|
|
51
|
+
"position": "F2"
|
|
52
|
+
}
|
|
53
|
+
]
|
|
54
|
+
}
|
|
55
|
+
]
|
|
56
|
+
}
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
### Request Fields
|
|
60
|
+
|
|
61
|
+
| Field | Type | Default | Purpose |
|
|
62
|
+
|-------|------|---------|---------|
|
|
63
|
+
| `filePath` | string | — | Full path for new workbook (required for creation) |
|
|
64
|
+
| `workbookId` | long | — | Workbook ID for existing workbook (alternative to filePath) |
|
|
65
|
+
| `createDirectories` | bool | true | Create parent directories if missing |
|
|
66
|
+
| `deleteDefaultSheet` | bool | true | Delete "Sheet1" if not in sheets list |
|
|
67
|
+
| `saveAfterBuild` | bool | true | Save workbook after building all sheets |
|
|
68
|
+
| `sheets` | array | [] | Sheet definitions (see Sheet Fields below) |
|
|
69
|
+
|
|
70
|
+
### Response Fields
|
|
71
|
+
|
|
72
|
+
| Field | Type | Description |
|
|
73
|
+
|-------|------|-------------|
|
|
74
|
+
| `success` | bool | Overall operation success |
|
|
75
|
+
| `workbookId` | long | Workbook ID for subsequent operations |
|
|
76
|
+
| `filePath` | string | File path of the workbook |
|
|
77
|
+
| `sheetsBuilt` | int | Total sheets successfully built |
|
|
78
|
+
| `sheetResults` | array | Per-sheet results with `rowsWritten`, `formatRangesApplied`, `chartCreated`, `warnings` |
|
|
79
|
+
| `formulaErrors` | array | Formula errors from health check — null if healthy. Each: `{ sheetName, cell, errorType, formula }`. Note: `sheetName` is always null (not populated by the API); use `sheetResults` order or `sheetLayouts` to identify which sheet an error belongs to. |
|
|
80
|
+
| `saved` | bool | Whether workbook was saved |
|
|
81
|
+
| `warnings` | array | Non-fatal warnings — null if none |
|
|
82
|
+
| `sheetLayouts` | object | Row layout maps (only when errors detected) — maps sheet → {row: "label"} to help find correct rows |
|
|
83
|
+
|
|
84
|
+
**WARNING: `success: true` does NOT mean zero errors.** `build-workbook` returns success when sheets are built, even if formulas fail silently. **Always check ALL THREE error channels:**
|
|
85
|
+
|
|
86
|
+
1. **`formulaErrors`** — formula-level issues (`#REF!`, `#NAME?`, `#DIV/0!`). Often null even when sheets fail to build.
|
|
87
|
+
2. **`sheetResults[].error`** — **structural** failures per sheet (e.g., `"Could not write data table starting with A1"` from conflicting `formulas` field + `data.rows` formulas, or label-references in data rows). This is where you find the real reason a sheet didn't build. Iterate every entry, not just the first.
|
|
88
|
+
3. **`warnings`** — non-fatal anomalies (chart placement, missing legend ranges, etc.).
|
|
89
|
+
|
|
90
|
+
If ANY of the three is non-empty, fix and rebuild before proceeding.
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## /excel/build-sheet
|
|
95
|
+
|
|
96
|
+
Builds a single sheet on an already-open workbook. Same schema as one `sheets[]` entry, plus `workbookId` or `filePath`.
|
|
97
|
+
|
|
98
|
+
**Use when:** Adding sheets to an existing workbook, building sheets 4+ of a large workbook (after initial `build-workbook` batch), or falling back from a failed `build-workbook`.
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## Sheet Fields
|
|
103
|
+
|
|
104
|
+
| Field | Type | Default | Purpose |
|
|
105
|
+
|-------|------|---------|---------|
|
|
106
|
+
| `sheetName` | string | **required** | Sheet name (created if missing) |
|
|
107
|
+
| `data` | object | null | Data block (see below) |
|
|
108
|
+
| `formulas` | object | null | Repeating formulas (see below) |
|
|
109
|
+
| `formatting` | array | null | Format specs (see below) |
|
|
110
|
+
| `conditionalFormatting` | array | null | CF rules — same schema as `/excel/conditional-formatting` |
|
|
111
|
+
| `charts` | array or object | null | Chart(s) (see below) |
|
|
112
|
+
| `freeze` | object | null | Freeze panes: `{ "rows": 1, "columns": 0 }` |
|
|
113
|
+
| `autoFitColumns` | bool | true | Auto-fit after writing |
|
|
114
|
+
|
|
115
|
+
### Data Fields
|
|
116
|
+
|
|
117
|
+
| Field | Type | Default | Purpose |
|
|
118
|
+
|-------|------|---------|---------|
|
|
119
|
+
| `range` | string | "A1" | Starting cell |
|
|
120
|
+
| `rows` | array | [] | Array of `{ "values": [...] }` objects |
|
|
121
|
+
| `firstRowIsHeader` | bool | true | The first row of `rows` holds the column names, so `formulas` can target columns by header name (`formatting` takes ranges only, not header names). It lands at `range` (default `A1`, so row 1 — but `range: "A5"` puts it on row 5) and is written either way. Applies no styling; use `formatting` for bold |
|
|
122
|
+
| `forceText` | bool | false | Write **every** value as literal text — numbers included. Use it only for columns that must stay literal (leading zeros, phone numbers), never for numbers you will compute over: `SUM`/`COUNT`/`MAX`/`AVERAGE` skip text cells and return **0** with no error (measured). Arithmetic operators do coerce, so `=B2*2` gives 24 while `=SUM(B2:B3)` gives 0. A `=...` value inside `rows` is also stored as text and `B[Label]` is not resolved — put formulas in the sheet-level `formulas` field, keeping the target column's header and blank cells in `rows` so `{Header}` can resolve. Mixing literal and computed columns? Write them in two calls, `forceText` on only the literal one |
|
|
123
|
+
|
|
124
|
+
#### Row Label References in Formulas (RECOMMENDED — eliminates row-counting errors)
|
|
125
|
+
|
|
126
|
+
Formulas in data rows can reference other rows **by their column A label** instead of hardcoding row numbers. The server resolves labels to row numbers automatically.
|
|
127
|
+
|
|
128
|
+
```json
|
|
129
|
+
"rows": [
|
|
130
|
+
{"values": ["Metric", "Value"]},
|
|
131
|
+
{"values": ["Revenue", 500000]},
|
|
132
|
+
{"values": ["Expenses", 320000]},
|
|
133
|
+
{"values": ["Net Income", "=B[Revenue]-B[Expenses]"]}
|
|
134
|
+
]
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
`B[Revenue]` → `B2`, `B[Expenses]` → `B3`. The model never counts rows.
|
|
138
|
+
|
|
139
|
+
**Syntax:** `COLUMN[Label]` — e.g., `B[Cash Flow]`, `$C$[Total Revenue]`. Case-insensitive. Labels match column A values exactly.
|
|
140
|
+
|
|
141
|
+
**Why use this:** The #1 cause of formula bugs is wrong row numbers. The model writes `=B10/B12` when it should be `=B10/B11` because it miscounted rows in the JSON array. Label references eliminate this entirely.
|
|
142
|
+
|
|
143
|
+
**Requires `forceText` off.** `forceText` stores every value verbatim, so a `B[Label]` formula lands as text and is never resolved. The write warns you when it suppresses formulas this way.
|
|
144
|
+
|
|
145
|
+
### Formula Fields
|
|
146
|
+
|
|
147
|
+
| Field | Type | Default | Purpose |
|
|
148
|
+
|-------|------|---------|---------|
|
|
149
|
+
| `startRow` | int | 2 | First row for formulas (after header) |
|
|
150
|
+
| `rowCount` | int | 1 | Number of rows to fill |
|
|
151
|
+
| `columns` | array | [] | Array of `{ "column": "D", "template": "=SUM(B{row}:C{row})" }` |
|
|
152
|
+
|
|
153
|
+
The `column` field accepts both **column letters** (`"D"`) and **header names** (`"Total"`) — header-name resolution is automatic when `firstRowIsHeader: true`. Case-insensitive.
|
|
154
|
+
|
|
155
|
+
### Format Fields
|
|
156
|
+
|
|
157
|
+
Each entry in the `formatting` array:
|
|
158
|
+
|
|
159
|
+
| Field | Type | Description |
|
|
160
|
+
|-------|------|-------------|
|
|
161
|
+
| `range` | string | Range to format (e.g., "A1:D1") |
|
|
162
|
+
| `bold` | bool | Bold text |
|
|
163
|
+
| `italic` | bool | Italic text |
|
|
164
|
+
| `numberFormat` | string | Number format string (e.g., "#,##0", "0.0%") |
|
|
165
|
+
| `horizontalAlignment` | string | "left", "center", "right" |
|
|
166
|
+
| `applyThinBorders` | bool | Apply thin borders |
|
|
167
|
+
| `interiorColorHtml` | string | Background color (#RRGGBB) |
|
|
168
|
+
| `fontColorHtml` | string | Font color (#RRGGBB) |
|
|
169
|
+
| `fontSize` | int | Font size in points |
|
|
170
|
+
| `fontName` | string | Font name (e.g., "Aptos", "Calibri") |
|
|
171
|
+
| `wrapText` | bool | Wrap text |
|
|
172
|
+
|
|
173
|
+
### Chart Fields
|
|
174
|
+
|
|
175
|
+
Each entry in the `charts` array (or a single object):
|
|
176
|
+
|
|
177
|
+
| Field | Type | Default | Description |
|
|
178
|
+
|-------|------|---------|-------------|
|
|
179
|
+
| `valueRange` | string | **required** | Data range (e.g., "B1:D10"). Supports comma-separated multi-ranges (e.g., `"C2:C15,F2:F15"`) |
|
|
180
|
+
| `xLabelRange` | string | null | Category labels (e.g., "A2:A10") — **always include** for meaningful axis |
|
|
181
|
+
| `legendRange` | string | null | Series names (e.g., "B1:D1"). Without this, shows "Series 1", "Series 2" |
|
|
182
|
+
| `chartType` | string | "column" | Chart type (see table below) |
|
|
183
|
+
| `title` | string | null | Chart title |
|
|
184
|
+
| `position` (or `topLeftCell`) | string | auto | Top-left cell for placement |
|
|
185
|
+
| `width` | int | 500 | Width in pixels |
|
|
186
|
+
| `height` | int | 300 | Height in pixels |
|
|
187
|
+
|
|
188
|
+
### Conditional Formatting Rule Types
|
|
189
|
+
|
|
190
|
+
| Rule Type | Parameters | Description |
|
|
191
|
+
|-----------|-----------|-------------|
|
|
192
|
+
| `CellValue` | `operator` (GreaterThan, LessThan, Between, Equal), `value1`, `value2`, `interiorColorHtml`, `fontColorHtml` | Format based on value |
|
|
193
|
+
| `ColorScale` | `colorScaleType` (TwoColor, ThreeColor) | Gradient coloring |
|
|
194
|
+
| `DataBar` | `dataBarColor` (#RRGGBB) | Bar visualization |
|
|
195
|
+
| `Expression` | `value1` (formula), `backgroundColor`, `fontColor`, `bold` | Formula-based formatting |
|
|
196
|
+
|
|
197
|
+
### Chart Types
|
|
198
|
+
|
|
199
|
+
| Short Name | Excel Constant | Description |
|
|
200
|
+
|-----------|---------------|-------------|
|
|
201
|
+
| `column` | xlColumnClustered | Vertical bars (default) |
|
|
202
|
+
| `line` | xlLine | Line chart |
|
|
203
|
+
| `pie` | xlPie | Pie chart (**single-column valueRange only**) |
|
|
204
|
+
| `bar` | xlBarClustered | Horizontal bars |
|
|
205
|
+
| `area` | xlArea | Area chart |
|
|
206
|
+
| `doughnut` | xlDoughnut | Ring chart (**single-column only**) |
|
|
207
|
+
| `xlLineMarkers` | xlLineMarkers | Line with markers |
|
|
208
|
+
| `xlColumnStacked` | xlColumnStacked | Stacked columns |
|
|
209
|
+
| `xlColumnStacked100` | xlColumnStacked100 | 100% stacked columns |
|
|
210
|
+
| `xlBarStacked` | xlBarStacked | Stacked horizontal bars |
|
|
211
|
+
| `xlPieExploded` | xlPieExploded | Exploded pie |
|
|
212
|
+
| `xl3DPie` | xl3DPie | 3D pie |
|
|
213
|
+
| `xlXYScatter` | xlXYScatter | Scatter plot |
|
|
214
|
+
| `xlRadar` | xlRadar | Radar chart |
|
|
215
|
+
|
|
216
|
+
**Pie/doughnut:** `valueRange` MUST be a single column (e.g., `"C2:C10"`). Multi-column creates hidden series. For pie from non-contiguous data, build a contiguous summary column first.
|
|
217
|
+
|
|
218
|
+
### Chart Validation
|
|
219
|
+
|
|
220
|
+
The API validates chart data after creation and returns WARNINGs in the response if:
|
|
221
|
+
- Any series has all-zero or all-empty values (source data missing)
|
|
222
|
+
- A pie/doughnut chart has multiple series (only first is shown)
|
|
223
|
+
|
|
224
|
+
Always check `warnings` in the response and fix issues.
|
|
225
|
+
|
|
226
|
+
---
|
|
227
|
+
|
|
228
|
+
## Build Guidance (how-to)
|
|
229
|
+
|
|
230
|
+
### Choosing build strategy
|
|
231
|
+
|
|
232
|
+
| Workbook complexity | Strategy | Why |
|
|
233
|
+
|---------------------|----------|-----|
|
|
234
|
+
| **Simple** (1-3 sheets, no cross-sheet refs) | `build-workbook` with all sheets in ONE call | Fast, everything in one shot |
|
|
235
|
+
| **Complex** (4+ sheets, cross-sheet formulas) | `build-workbook` with 2-3 foundation sheets → `build-sheet` one at a time for computed/dashboard | Batch independent sheets, verify before dependent ones |
|
|
236
|
+
|
|
237
|
+
**Batching rule:** Foundation sheets (no cross-sheet refs) CAN be batched in one `build-workbook` call (e.g., Settings + Budget + Debt). Computed sheets that reference other sheets → build one at a time with verification between each.
|
|
238
|
+
|
|
239
|
+
**Every call must be COMPREHENSIVE** — each sheet spec includes ALL of: `data` (headers + rows + total rows with formulas), `formulas` (every derived column), `formatting`, `conditionalFormatting`, `charts`, `freeze`. Do NOT build a bare sheet and format later. Each sheet takes 10-30s via COM.
|
|
240
|
+
|
|
241
|
+
### Minimal example (copy this structure)
|
|
242
|
+
|
|
243
|
+
```json
|
|
244
|
+
{
|
|
245
|
+
"filePath": "C:\\Users\\user\\Documents\\MyWorkbook.xlsx",
|
|
246
|
+
"sheets": [
|
|
247
|
+
{
|
|
248
|
+
"sheetName": "Sheet1",
|
|
249
|
+
"data": {
|
|
250
|
+
"rows": [
|
|
251
|
+
{"values": ["Name", "Jan", "Feb", "Total"]},
|
|
252
|
+
{"values": ["Rent", 1500, 1500, "=SUM(B2:C2)"]},
|
|
253
|
+
{"values": ["Total", "=SUM(B[Rent]:B[Rent])", "=SUM(C[Rent]:C[Rent])", "=SUM(D[Rent]:D[Rent])"]}
|
|
254
|
+
],
|
|
255
|
+
"firstRowIsHeader": true
|
|
256
|
+
},
|
|
257
|
+
"formatting": [
|
|
258
|
+
{"range": "A1:D1", "bold": true, "interiorColorHtml": "#4472C4", "fontColorHtml": "#FFFFFF"}
|
|
259
|
+
],
|
|
260
|
+
"freeze": {"rows": 1}
|
|
261
|
+
}
|
|
262
|
+
]
|
|
263
|
+
}
|
|
264
|
+
```
|
|
265
|
+
|
|
266
|
+
**Common mistakes (WRONG → RIGHT):**
|
|
267
|
+
- ❌ `"name"` → ✅ `"sheetName"`
|
|
268
|
+
- ❌ `"filename"` → ✅ `"filePath"` (full absolute path)
|
|
269
|
+
- ❌ `"rows": [["a","b"]]` → ✅ `"rows": [{"values": ["a","b"]}]`
|
|
270
|
+
- ❌ `"type": "cellValue"` → ✅ `"ruleType": "CellValue"` (PascalCase value)
|
|
271
|
+
- ❌ chart `"position": {"top":50,"left":350}` → ✅ `"position": "F2"` (cell ref string)
|
|
272
|
+
- ❌ chart without `legendRange` → ✅ always include `"legendRange"` (else "Series1, Series2")
|
|
273
|
+
- ❌ `"=B10/B11"` (hardcoded rows) → ✅ `"=B[Cash Flow]/B[Cash Invested]"` (row-label refs)
|
|
274
|
+
- ❌ AppAct to click sheet tabs → ✅ `/excel/select-sheet`
|
|
275
|
+
|
|
276
|
+
### Do NOT waste calls — these are built into build-workbook/build-sheet
|
|
277
|
+
|
|
278
|
+
| DO NOT call separately | Use instead |
|
|
279
|
+
|------------------------|-------------|
|
|
280
|
+
| `/excel/auto-fit-columns` | default `autoFitColumns: true` |
|
|
281
|
+
| `/excel/save-workbook` | default `saveAfterBuild: true` |
|
|
282
|
+
| `/excel/get-status` | skip only immediately after `build-workbook` when you inspected `formulaErrors[]`; still call after each `build-sheet` because `build-sheet` does not return `formulaErrors[]` |
|
|
283
|
+
| `/excel/add-chart-from-range` | `charts` field |
|
|
284
|
+
| `/excel/conditional-formatting` | `conditionalFormatting` field |
|
|
285
|
+
| `/excel/freeze-panes` | `freeze` field |
|
|
286
|
+
| `/excel/format-range` | `formatting` array |
|
|
287
|
+
|
|
288
|
+
Applies INSIDE a build call only. OUTSIDE, use these APIs normally — and ALWAYS use `/excel/select-sheet` to switch sheets, never UIA.
|
|
289
|
+
|
|
290
|
+
**`/excel/close-workbook` is the exception — NOT built in, and you do need it** (see "Release the file when you're done"). Call it last, after the final `build-sheet` and its `get-status`, with the `workbookId` from `build-workbook` — `build-sheet` responses do not carry one. A confirmed close drops the id, so never close between build calls.
|
|
291
|
+
|
|
292
|
+
### Header-name formulas (eliminates column-counting errors)
|
|
293
|
+
|
|
294
|
+
Use header names in `formulas` templates; the server resolves them to column letters.
|
|
295
|
+
|
|
296
|
+
```json
|
|
297
|
+
"formulas": {
|
|
298
|
+
"startRow": 2, "rowCount": 2,
|
|
299
|
+
"columns": [
|
|
300
|
+
{"column": "Local Value", "template": "={Shares}*{Price}"},
|
|
301
|
+
{"column": "USD Value", "template": "=IF({Currency}=\"USD\",{Local Value},{Local Value}/Settings!$B$2)"}
|
|
302
|
+
]
|
|
303
|
+
}
|
|
304
|
+
```
|
|
305
|
+
|
|
306
|
+
`{Shares}` → `C{row}`. The `column` field also accepts header names. Row offsets: `{row-1}`, `{row+1}`. Case-insensitive.
|
|
307
|
+
|
|
308
|
+
**🚨 Header-name refs (`{Header}`) work in `build-workbook`/`build-sheet` `formulas` ONLY.** They do NOT work in `/excel/write-formula` or `/excel/write-formulas-batch` — those pass templates verbatim to Excel COM, which throws a misleading "Insufficient memory to continue" error (actually a parse failure). For standalone formula writes use explicit letters: `=D{row}*0.1`.
|
|
309
|
+
|
|
310
|
+
### Formula completeness checklist
|
|
311
|
+
|
|
312
|
+
Before submitting, verify every derived column has a formula: multiplication columns, SUM/TOTAL rows, percentage columns, conditional calcs, cross-sheet summary cells. **Total-row ordering:** if a column divides by a total row (`Weight % = Value / Total`), write the total's SUM FIRST (put it in `data.rows` or before dependent columns). A header implying a calculation with `""` or a hardcoded number = bug.
|
|
313
|
+
|
|
314
|
+
### Label-based cross-sheet references (eliminates row-counting errors)
|
|
315
|
+
|
|
316
|
+
`=@SheetName[Row Label]` or `=@SheetName[Row Label,Column]` — the server finds the row by matching column A text.
|
|
317
|
+
|
|
318
|
+
```json
|
|
319
|
+
"rows": [
|
|
320
|
+
{"values": ["Portfolio Value", "=@Portfolio[TOTAL PORTFOLIO]"]},
|
|
321
|
+
{"values": ["China Stocks (USD)", "=@Portfolio[Total China Value (CNY),D]"]},
|
|
322
|
+
{"values": ["Net Worth", "=@Net Worth[Current Net Worth]"]}
|
|
323
|
+
]
|
|
324
|
+
```
|
|
325
|
+
|
|
326
|
+
`=@Portfolio[TOTAL PORTFOLIO]` → finds the column-A match, returns column B (add `,D` for another column). Sheet names with spaces auto-quoted. Case-insensitive. **Work in `build-workbook`/`build-sheet` ONLY** (in `build-sheet`, the referenced sheet must already exist). For non-composite endpoints, use explicit refs (`='Portfolio'!B24`).
|
|
327
|
+
|
|
328
|
+
### Composite vs individual
|
|
329
|
+
|
|
330
|
+
**Composite** (`build-workbook`/`build-sheet`): new workbooks/sheets. **Individual** (`write-range`, `write-formula`, `write-formulas-batch`): editing existing data, formula columns, pivots. Prefer `write-formulas-batch` for repeated formula fills, even one column.
|
|
331
|
+
|
|
332
|
+
### Notes
|
|
333
|
+
|
|
334
|
+
- **get-status limits:** one sheet at a time, cells A1:AE1000, 10s timeout. Verify beyond row 1000 with `read-range`.
|
|
335
|
+
- **Sheet names:** call `get-workbook-info` before any cross-sheet formula; use only returned names.
|
|
336
|
+
- **Never fabricate values:** `read-range` key cells before reporting.
|
|
337
|
+
- **Recovery:** for COM error recovery, `build-sheet` fallback, write verification, raw-data protection, spillover prevention, read `reference/repair.md`.
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
# Scripting & Health
|
|
2
|
+
|
|
3
|
+
Health checks, undo, and C# scripting (last resort).
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Health Check
|
|
8
|
+
|
|
9
|
+
### /excel/get-status
|
|
10
|
+
|
|
11
|
+
**REQUIRED after scripts/charts!** Detects errors and overlaps.
|
|
12
|
+
|
|
13
|
+
| Parameter | Type | Required | Description |
|
|
14
|
+
|-----------|------|----------|-------------|
|
|
15
|
+
| sheetName | string | No | Check specific sheet (all if omitted) |
|
|
16
|
+
|
|
17
|
+
**Detects:**
|
|
18
|
+
- Formula errors: `#REF!`, `#DIV/0!`, `#VALUE!`, `#NAME?`, `#N/A`, `#####`
|
|
19
|
+
- Chart overlaps with data or other charts
|
|
20
|
+
- Broken references
|
|
21
|
+
|
|
22
|
+
**Response:**
|
|
23
|
+
- `hasErrors` (boolean)
|
|
24
|
+
- `errors[]` - Array with `cell`, `errorType`, `sheet`
|
|
25
|
+
- `hasOverlaps` (boolean)
|
|
26
|
+
- `overlaps[]` - Overlap details
|
|
27
|
+
|
|
28
|
+
**When to call:**
|
|
29
|
+
- After any `/excel/execute-script` (MANDATORY!)
|
|
30
|
+
- After adding charts
|
|
31
|
+
- After complex formula operations
|
|
32
|
+
- Before saving workbook
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
### /excel/rearrange-overlaps
|
|
37
|
+
|
|
38
|
+
Automatically reposition overlapping charts/shapes.
|
|
39
|
+
|
|
40
|
+
| Parameter | Type | Required | Description |
|
|
41
|
+
|-----------|------|----------|-------------|
|
|
42
|
+
| sheetName | string | No | Sheet (all sheets if omitted) |
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
### /excel/undo
|
|
47
|
+
|
|
48
|
+
| Parameter | Type | Required | Default | Description |
|
|
49
|
+
|-----------|------|----------|---------|-------------|
|
|
50
|
+
| steps | number | No | 1 | Steps to undo |
|
|
51
|
+
|
|
52
|
+
⚠️ Not all operations are undoable (e.g., VBA/script changes may not undo cleanly)
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## C# Scripting
|
|
57
|
+
|
|
58
|
+
### /excel/execute-script
|
|
59
|
+
|
|
60
|
+
**LAST RESORT** - Use only when API endpoints are insufficient.
|
|
61
|
+
|
|
62
|
+
| Parameter | Type | Required | Description |
|
|
63
|
+
|-----------|------|----------|-------------|
|
|
64
|
+
| sheetName | string | Yes | Target sheet |
|
|
65
|
+
| script | string | Yes | C# code |
|
|
66
|
+
|
|
67
|
+
**Pre-defined Variables:**
|
|
68
|
+
- `workbook` - Excel.Workbook object
|
|
69
|
+
- `worksheet` - Excel.Worksheet object (target sheet)
|
|
70
|
+
- `app` - Excel.Application object
|
|
71
|
+
|
|
72
|
+
**Script Rules:**
|
|
73
|
+
1. Use semicolons after statements
|
|
74
|
+
2. Access cells: `worksheet.Range["A1"].Value = 123;`
|
|
75
|
+
3. Access other sheets: `workbook.Worksheets["Sheet2"]`
|
|
76
|
+
4. Return values: Last expression is returned
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
### Example - Alternating Row Colors
|
|
81
|
+
|
|
82
|
+
```csharp
|
|
83
|
+
var usedRange = worksheet.UsedRange;
|
|
84
|
+
for (int row = 2; row <= usedRange.Rows.Count; row++)
|
|
85
|
+
{
|
|
86
|
+
var rowRange = worksheet.Range[
|
|
87
|
+
worksheet.Cells[row, 1],
|
|
88
|
+
worksheet.Cells[row, usedRange.Columns.Count]
|
|
89
|
+
];
|
|
90
|
+
if (row % 2 == 0)
|
|
91
|
+
{
|
|
92
|
+
rowRange.Interior.Color = System.Drawing.ColorTranslator.ToOle(
|
|
93
|
+
System.Drawing.Color.FromArgb(240, 240, 240)
|
|
94
|
+
);
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
### Example - Sum Column with Condition
|
|
102
|
+
|
|
103
|
+
```csharp
|
|
104
|
+
double sum = 0;
|
|
105
|
+
var lastRow = worksheet.Cells[worksheet.Rows.Count, 1]
|
|
106
|
+
.End[Excel.XlDirection.xlUp].Row;
|
|
107
|
+
for (int i = 2; i <= lastRow; i++)
|
|
108
|
+
{
|
|
109
|
+
var status = worksheet.Cells[i, 5].Value?.ToString();
|
|
110
|
+
if (status == "Active")
|
|
111
|
+
{
|
|
112
|
+
sum += Convert.ToDouble(worksheet.Cells[i, 3].Value ?? 0);
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
worksheet.Cells[lastRow + 1, 3].Value = sum;
|
|
116
|
+
worksheet.Cells[lastRow + 1, 3].Font.Bold = true;
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
### Common Pitfalls
|
|
122
|
+
|
|
123
|
+
| Error | Cause | Fix |
|
|
124
|
+
|-------|-------|-----|
|
|
125
|
+
| `Cannot apply '==' to DateTime and DBNull` | Direct comparison | Use `DBNull.Value.Equals(obj)` |
|
|
126
|
+
| `Value cannot be null (key)` | Null dictionary key | `if (string.IsNullOrEmpty(key)) continue;` |
|
|
127
|
+
| LINQ compilation error | LINQ on COM collections | Use manual `foreach` loops |
|
|
128
|
+
| Null reference | Reassigned worksheet variable | Use `worksheet` directly |
|
|
129
|
+
|
|
130
|
+
**Rules:**
|
|
131
|
+
- **MAX 150 lines** per script
|
|
132
|
+
- **NO "Excel." prefix** on enums
|
|
133
|
+
- **Escape quotes:** `\"` in formulas
|
|
134
|
+
- **Check null AND DBNull** - both can appear
|
|
135
|
+
- **Use foreach**, not LINQ on COM collections
|
|
136
|
+
|
|
137
|
+
⚠️ **ALWAYS run `/excel/get-status` after scripts!**
|
|
138
|
+
|
|
139
|
+
**See `windows/examples/level-3-scripting.md` for more patterns.**
|