@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,381 @@
|
|
|
1
|
+
# Advanced Operations
|
|
2
|
+
|
|
3
|
+
Less-routine formatting, charts, pivot tables. Routine formatting (`format-range`, `auto-fit-columns`, `freeze-panes`) and data analysis (`sort-range`, `filter-range`) live in `reference/api/basic.md`.
|
|
4
|
+
|
|
5
|
+
**Contents:**
|
|
6
|
+
1. [Formatting](#formatting) — hide-rows, conditional-formatting, data-validation, merge-cells
|
|
7
|
+
2. [Charts](#charts) — add-chart-from-range (types, cross-sheet, positioning), delete-chart
|
|
8
|
+
3. [Pivot Tables](#pivot-tables) — create-pivot-table (multiple pivots, date grouping, showAs)
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## Formatting
|
|
13
|
+
|
|
14
|
+
### /excel/hide-rows (Windows only)
|
|
15
|
+
|
|
16
|
+
Hides or unhides specific rows. Use `hidden: false` to unhide. Errors on macOS.
|
|
17
|
+
|
|
18
|
+
| Parameter | Type | Required | Default | Description |
|
|
19
|
+
|-----------|------|----------|---------|-------------|
|
|
20
|
+
| sheetName | string | Yes | - | Sheet name |
|
|
21
|
+
| rows | number[] | Yes | - | Row numbers to hide/unhide (1-based) |
|
|
22
|
+
| hidden | boolean | No | true | `true` to hide, `false` to unhide |
|
|
23
|
+
|
|
24
|
+
**Example — Hide rows 3, 6, 8:**
|
|
25
|
+
```json
|
|
26
|
+
{"sheetName": "Sheet1", "rows": [3, 6, 8], "hidden": true}
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
**Example — Unhide rows:**
|
|
30
|
+
```json
|
|
31
|
+
{"sheetName": "Sheet1", "rows": [3, 6, 8], "hidden": false}
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
### /excel/conditional-formatting
|
|
37
|
+
|
|
38
|
+
| Parameter | Type | Required | Description |
|
|
39
|
+
|-----------|------|----------|-------------|
|
|
40
|
+
| sheetName | string | Yes | Sheet name |
|
|
41
|
+
| range | string | Yes | Range to format |
|
|
42
|
+
| ruleType | string | Yes | See below |
|
|
43
|
+
|
|
44
|
+
**CellValue** - Format based on cell value:
|
|
45
|
+
| Parameter | Description |
|
|
46
|
+
|-----------|-------------|
|
|
47
|
+
| operator | `GreaterThan`, `LessThan`, `Between`, `Equal` |
|
|
48
|
+
| value1 | First value |
|
|
49
|
+
| value2 | Second value (Between only) |
|
|
50
|
+
| backgroundColor | Fill color (#RRGGBB) |
|
|
51
|
+
| fontColor | Font color (#RRGGBB) |
|
|
52
|
+
| bold | Bold text |
|
|
53
|
+
|
|
54
|
+
**ColorScale** - Gradient (auto-configured):
|
|
55
|
+
- `colorScaleType`: "TwoColor" or "ThreeColor" — **Windows only**; macOS ignores it (always three-color)
|
|
56
|
+
|
|
57
|
+
**DataBar** - Bar visualization (auto-configured):
|
|
58
|
+
- `dataBarColor`: Bar color (#RRGGBB) — **Windows only**; macOS ignores it (default bar color)
|
|
59
|
+
|
|
60
|
+
**Expression** - Formula-based formatting:
|
|
61
|
+
| Parameter | Description |
|
|
62
|
+
|-----------|-------------|
|
|
63
|
+
| value1 | Formula expression (e.g., "=MOD(ROW(),2)=0" for alternating rows) |
|
|
64
|
+
| backgroundColor | Fill color (#RRGGBB) — also accepts `interiorColorHtml` |
|
|
65
|
+
| fontColor | Font color (#RRGGBB) |
|
|
66
|
+
| bold | Bold text |
|
|
67
|
+
|
|
68
|
+
⚠️ **backgroundColor is required** — without it the rule runs but shows no color. Do NOT use `interiorColorHtml` (use `backgroundColor`).
|
|
69
|
+
|
|
70
|
+
**Example — Highlight weekends red:**
|
|
71
|
+
```json
|
|
72
|
+
{"sheetName": "Sheet1", "range": "A1:F100", "ruleType": "Expression", "value1": "=OR(WEEKDAY(A1)=1,WEEKDAY(A1)=7)", "backgroundColor": "#FF0000"}
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
**Example — Alternating row stripes:**
|
|
76
|
+
```json
|
|
77
|
+
{"sheetName": "Sheet1", "range": "A1:F100", "ruleType": "Expression", "value1": "=MOD(ROW(),2)=0", "backgroundColor": "#EBF3FB"}
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
**Simple Rules:** `AboveAverage`, `UniqueValues`, `DuplicateValues` — on macOS these require `range` (each cell is compared against the whole applied range).
|
|
81
|
+
|
|
82
|
+
**Batch mode** — apply multiple conditional formatting rules in one call using the `conditionalFormatting` array. Each entry uses the same flat properties as a single call. `sheetName` and `range` from the parent are inherited when not specified in each child:
|
|
83
|
+
|
|
84
|
+
```json
|
|
85
|
+
{
|
|
86
|
+
"sheetName": "Sheet1",
|
|
87
|
+
"range": "D2:D20",
|
|
88
|
+
"conditionalFormatting": [
|
|
89
|
+
{"ruleType": "CellValue", "operator": "GreaterThan", "value1": "0", "backgroundColor": "#C6EFCE"},
|
|
90
|
+
{"ruleType": "CellValue", "operator": "LessThan", "value1": "0", "backgroundColor": "#FFC7CE"},
|
|
91
|
+
{"ruleType": "ColorScale", "range": "E2:E20", "colorScaleType": "ThreeColor"}
|
|
92
|
+
]
|
|
93
|
+
}
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
### /excel/add-data-validation
|
|
99
|
+
|
|
100
|
+
| Parameter | Type | Required | Default | Description |
|
|
101
|
+
|-----------|------|----------|---------|-------------|
|
|
102
|
+
| workbookId | number | No | - | Workbook ID |
|
|
103
|
+
| filePath | string | No | - | OR file path |
|
|
104
|
+
| sheetName | string | Yes | - | Sheet name |
|
|
105
|
+
| range | string | Yes | - | Range to validate (e.g., `"D2:D29"`) |
|
|
106
|
+
| validationType | string | No | "list" | Type: `"list"`, `"whole"`, `"decimal"`, `"date"`, `"textLength"`, `"custom"`. `"time"` is **macOS only** — Windows has no branch for it and reports success without adding any validation, so avoid it in cross-platform flows. |
|
|
107
|
+
| formula1 | string | No | - | Validation rule (see table below) |
|
|
108
|
+
| errorMessage | string | No | - | Error text shown on invalid input |
|
|
109
|
+
|
|
110
|
+
**Types & formula1:**
|
|
111
|
+
| Type | formula1 Format | Example |
|
|
112
|
+
|------|-----------------|---------|
|
|
113
|
+
| list | Comma-separated values | `"Pass,Fail,Held"` |
|
|
114
|
+
| list | Cell reference | `"=$D$1:$D$5"` |
|
|
115
|
+
| whole | operator,value(s) | `"between,1,100"` |
|
|
116
|
+
| decimal | operator,value(s) | `"greaterThan,0"` |
|
|
117
|
+
| custom | Formula | `"=AND(A1>0,A1<100)"` |
|
|
118
|
+
|
|
119
|
+
**Example — Dropdown list:**
|
|
120
|
+
```json
|
|
121
|
+
{"workbookId": 123, "sheetName": "Sheet1", "range": "D2:D29", "validationType": "list", "formula1": "Pass,Fail,Held"}
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
---
|
|
125
|
+
|
|
126
|
+
### /excel/merge-cells
|
|
127
|
+
|
|
128
|
+
| Parameter | Type | Required | Default | Description |
|
|
129
|
+
|-----------|------|----------|---------|-------------|
|
|
130
|
+
| sheetName | string | No | Active | Sheet name |
|
|
131
|
+
| range | string | Yes | - | Range to merge (e.g., "A1:C1") |
|
|
132
|
+
| action | string | No | "merge" | "merge" or "unmerge" |
|
|
133
|
+
|
|
134
|
+
**Batch mode** — merge/unmerge multiple ranges in one call:
|
|
135
|
+
|
|
136
|
+
| Parameter | Type | Required | Description |
|
|
137
|
+
|-----------|------|----------|-------------|
|
|
138
|
+
| batch | array | Yes | Array of `{range, action?, sheetName?}` objects |
|
|
139
|
+
|
|
140
|
+
```json
|
|
141
|
+
{"batch": [
|
|
142
|
+
{"range": "A1:C1", "action": "merge", "sheetName": "Sheet1"},
|
|
143
|
+
{"range": "A5:C5", "action": "merge", "sheetName": "Sheet1"}
|
|
144
|
+
]}
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
149
|
+
## Charts
|
|
150
|
+
|
|
151
|
+
### /excel/add-chart-from-range
|
|
152
|
+
|
|
153
|
+
| Parameter | Type | Required | Default | Description |
|
|
154
|
+
|-----------|------|----------|---------|-------------|
|
|
155
|
+
| sheetName | string | Yes | - | Sheet where the chart will be placed |
|
|
156
|
+
| sourceSheetName | string | No | sheetName | Sheet where the data lives (use when chart goes on a different sheet than data) |
|
|
157
|
+
| valueRange | string | Yes | - | Y-axis data (e.g., "B2:C11" for two series). Supports cross-sheet syntax "Sheet1!B2:C11" |
|
|
158
|
+
| xLabelRange | string | No | - | X-axis labels (e.g., "A2:A11"). Supports cross-sheet syntax "Sheet1!A2:A11" |
|
|
159
|
+
| categoryRange | string | No | - | Alias for `xLabelRange` — same behavior, alternative name |
|
|
160
|
+
| legendRange | string | No | - | Series/legend names (e.g., "B1:D1" for headers, or "I2" for single series). Without this, legend shows "Series 1", "Series 2", etc. |
|
|
161
|
+
| seriesNameRange | string | No | - | Alias for `legendRange` — same behavior, alternative name |
|
|
162
|
+
| chartType | string | No | xlColumnClustered | Chart type |
|
|
163
|
+
| title | string | No | - | Chart title |
|
|
164
|
+
| topLeftCell | string | No | "F2" | Cell where the top-left corner of the chart is placed (e.g., "F2") |
|
|
165
|
+
| position | string | No | "F2" | Alias for `topLeftCell` — same behavior, alternative name |
|
|
166
|
+
| width | number | No | 500 | Width (100-1000) |
|
|
167
|
+
| height | number | No | 300 | Height (100-800) |
|
|
168
|
+
| autoPosition | boolean | No | true | Avoid overlaps |
|
|
169
|
+
|
|
170
|
+
**Cross-sheet charts:** When the chart should be on a different sheet than the data, either:
|
|
171
|
+
- Use `sourceSheetName`: `{"sheetName": "Sheet2", "sourceSheetName": "Sheet1", "valueRange": "B2:C11"}`
|
|
172
|
+
- Or use cross-sheet syntax in ranges: `{"sheetName": "Sheet2", "valueRange": "Sheet1!B2:C11"}`
|
|
173
|
+
|
|
174
|
+
**Chart Types:**
|
|
175
|
+
| Type | Description |
|
|
176
|
+
|------|-------------|
|
|
177
|
+
| xlColumnClustered | Vertical bars (default) |
|
|
178
|
+
| xlColumnStacked | Stacked vertical bars |
|
|
179
|
+
| xlColumnStacked100 | 100% stacked vertical bars |
|
|
180
|
+
| xl3DColumn | 3D column |
|
|
181
|
+
| xl3DColumnClustered | 3D clustered column |
|
|
182
|
+
| xlBarClustered | Horizontal bars |
|
|
183
|
+
| xlBarStacked | Stacked horizontal bars |
|
|
184
|
+
| xlLine | Line chart |
|
|
185
|
+
| xlLineStacked | Stacked line chart |
|
|
186
|
+
| xlLineStacked100 | 100% stacked line chart |
|
|
187
|
+
| xlLineMarkers | Line with markers |
|
|
188
|
+
| xlLineMarkersStacked | Stacked line with markers |
|
|
189
|
+
| xlPie | Pie chart |
|
|
190
|
+
| xl3DPie | 3D pie chart |
|
|
191
|
+
| xlPieExploded | Exploded pie chart |
|
|
192
|
+
| xlDoughnut | Doughnut chart |
|
|
193
|
+
| xlXYScatter | Scatter plot |
|
|
194
|
+
| xlXYScatterLines | Scatter with lines |
|
|
195
|
+
| xlXYScatterSmooth | Scatter with smooth lines |
|
|
196
|
+
| xlArea | Area chart |
|
|
197
|
+
| xlAreaStacked | Stacked area chart |
|
|
198
|
+
| xlRadar | Radar chart |
|
|
199
|
+
| xlBubble | Bubble chart |
|
|
200
|
+
| xlSurface | Surface chart |
|
|
201
|
+
| xlStockHLC | High-Low-Close stock chart |
|
|
202
|
+
| xlStockOHLC | Open-High-Low-Close stock chart |
|
|
203
|
+
|
|
204
|
+
**macOS supports a subset**: `xlColumnClustered`, `xlColumnStacked`, `xlColumnStacked100`, `xlBarClustered`, `xlBarStacked`, `xlLine`, `xlLineStacked`, `xlLineStacked100`, `xlLineMarkers`, `xlPie`, `xlPieExploded`, `xlXYScatter`, `xlXYScatterLines`, `xlArea`, `xlAreaStacked`. The 3D, doughnut, radar, bubble, surface, stock, smooth-scatter, and stacked-marker types error on macOS — pick a supported type.
|
|
205
|
+
|
|
206
|
+
**Axis titles are not settable via this endpoint** on any platform — only the chart `title`. On macOS, don't attempt raw AppleScript for axis titles: Excel-for-Mac blocks chart-axis access (-1723/-50). If the task requires axis titles, report the limitation instead of retrying.
|
|
207
|
+
|
|
208
|
+
⚠️ **ALWAYS** call `get-status` after creating charts!
|
|
209
|
+
|
|
210
|
+
### Pie & Doughnut Charts — Special Rules
|
|
211
|
+
|
|
212
|
+
Pie and doughnut charts display **only ONE data series**. Multi-column `valueRange` creates multiple series, but only the first is visible — the rest are silently ignored.
|
|
213
|
+
|
|
214
|
+
**Correct pie chart example:**
|
|
215
|
+
```json
|
|
216
|
+
{
|
|
217
|
+
"sheetName": "Dashboard",
|
|
218
|
+
"sourceSheetName": "Portfolio",
|
|
219
|
+
"valueRange": "F2:F5",
|
|
220
|
+
"xLabelRange": "A2:A5",
|
|
221
|
+
"chartType": "pie",
|
|
222
|
+
"title": "Portfolio Allocation"
|
|
223
|
+
}
|
|
224
|
+
```
|
|
225
|
+
Here `F2:F5` is a SINGLE column of values (e.g., portfolio value per asset class), and `A2:A5` has the category labels.
|
|
226
|
+
|
|
227
|
+
**Wrong — multi-column valueRange for pie:**
|
|
228
|
+
```json
|
|
229
|
+
{"valueRange": "B2:D5", "chartType": "pie"}
|
|
230
|
+
```
|
|
231
|
+
This creates 3 series (B, C, D columns) but only column B is displayed.
|
|
232
|
+
|
|
233
|
+
**Wrong — scattered individual cells for pie:**
|
|
234
|
+
```json
|
|
235
|
+
{"valueRange": "B4,B8,B12", "chartType": "pie"}
|
|
236
|
+
```
|
|
237
|
+
Excel computes a bounding box (B4:B12) that includes empty rows — chart shows zeros.
|
|
238
|
+
|
|
239
|
+
**For pie charts from non-contiguous data:** Build a contiguous summary column first:
|
|
240
|
+
1. Add a small 2-column summary table (Label + Value) on the same sheet or a helper area
|
|
241
|
+
2. Use formulas to reference the scattered source cells (e.g., `=Portfolio!B17`)
|
|
242
|
+
3. Chart from the summary table's contiguous range
|
|
243
|
+
|
|
244
|
+
**Chart data validation:** The API automatically validates chart data after creation and includes WARNING messages in the response if:
|
|
245
|
+
- Any series has all-zero or all-empty values (source data is missing or formulas not yet written)
|
|
246
|
+
- A pie/doughnut chart has multiple series (only the first is displayed)
|
|
247
|
+
|
|
248
|
+
Always check the response for warnings. If warnings appear, fix the source data and recreate the chart.
|
|
249
|
+
|
|
250
|
+
**Automatic warnings are Windows-only.** On macOS the response never contains WARNING messages — their absence means nothing; verify with `read-range` before creating the chart and `get-status` after.
|
|
251
|
+
|
|
252
|
+
### Chart Data Verification (MANDATORY before creating any chart)
|
|
253
|
+
|
|
254
|
+
1. **Read the valueRange** — call `read-range` on the range you plan to chart
|
|
255
|
+
2. **Check for empty/zero cells** — if a column should have formulas (e.g., "Value" = Shares × Price) but shows 0 or empty, the formulas are missing. Write them first.
|
|
256
|
+
3. **Check for contiguous data** — ensure the range doesn't include blank rows or unrelated data
|
|
257
|
+
4. **Only then create the chart** — after confirming data is populated and correct
|
|
258
|
+
5. **After creating**, check the API response for WARNING messages. If any series has all-zero values, the chart is broken — fix source data and recreate.
|
|
259
|
+
|
|
260
|
+
**Non-contiguous data (e.g., subtotal rows 6, 10, 14, 18):** `valueRange` multi-range works for contiguous rows across different columns (e.g., `B2:B15,F2:F15`). For scattered rows, write a small contiguous summary table, then chart from that.
|
|
261
|
+
|
|
262
|
+
### /excel/delete-chart
|
|
263
|
+
|
|
264
|
+
Deletes one or all charts from a worksheet. Use this to remove broken charts before recreating them. Available on all platforms (on macOS `workbookId` is ignored — use `filePath`).
|
|
265
|
+
|
|
266
|
+
| Parameter | Type | Required | Description |
|
|
267
|
+
|-----------|------|----------|-------------|
|
|
268
|
+
| workbookId | long | Yes* | Workbook ID (or use filePath) |
|
|
269
|
+
| filePath | string | Yes* | File path (or use workbookId) |
|
|
270
|
+
| sheetName | string | Yes | Sheet containing the chart(s) |
|
|
271
|
+
| chartName | string | No | Name of a specific chart (e.g., "Chart 1"). If omitted, ALL charts on the sheet are deleted. |
|
|
272
|
+
|
|
273
|
+
**Response:**
|
|
274
|
+
| Field | Type | Description |
|
|
275
|
+
|-------|------|-------------|
|
|
276
|
+
| success | boolean | Whether deletion succeeded |
|
|
277
|
+
| chartsDeleted | number | Number of charts removed |
|
|
278
|
+
| deletedChartNames | string[] | Names of the deleted charts |
|
|
279
|
+
|
|
280
|
+
**When to use:**
|
|
281
|
+
- Chart is empty or shows wrong data and fixing the source data didn't help
|
|
282
|
+
- Chart was created before formulas were written — delete and recreate AFTER writing formulas
|
|
283
|
+
- Chart uses wrong type or wrong data range — delete and recreate with correct parameters
|
|
284
|
+
- Multiple overlapping charts from failed creation attempts — delete all, recreate once
|
|
285
|
+
|
|
286
|
+
**Example — delete a specific broken chart:**
|
|
287
|
+
```json
|
|
288
|
+
{
|
|
289
|
+
"workbookId": 12345,
|
|
290
|
+
"sheetName": "Dashboard",
|
|
291
|
+
"chartName": "Chart 1"
|
|
292
|
+
}
|
|
293
|
+
```
|
|
294
|
+
|
|
295
|
+
**Example — delete all charts on a sheet and start fresh:**
|
|
296
|
+
```json
|
|
297
|
+
{
|
|
298
|
+
"workbookId": 12345,
|
|
299
|
+
"sheetName": "Portfolio"
|
|
300
|
+
}
|
|
301
|
+
```
|
|
302
|
+
|
|
303
|
+
---
|
|
304
|
+
|
|
305
|
+
## Pivot Tables
|
|
306
|
+
|
|
307
|
+
### /excel/create-pivot-table
|
|
308
|
+
|
|
309
|
+
🚨 **MULTIPLE PIVOT TABLES IN SAME SHEET:**
|
|
310
|
+
When user asks for multiple pivot tables, put them ALL in ONE sheet:
|
|
311
|
+
1. Use SAME `targetSheetName` for all pivot tables (e.g., "PivotAnalysis")
|
|
312
|
+
2. Use DIFFERENT `targetCell` with **VERTICAL spacing** (e.g., "A1", "A15", "A30")
|
|
313
|
+
3. Estimate ~12-15 rows per pivot table for spacing
|
|
314
|
+
|
|
315
|
+
⛔ **WRONG - Horizontal placement causes overlap:**
|
|
316
|
+
```json
|
|
317
|
+
{"targetCell": "A1", ...} // First pivot
|
|
318
|
+
{"targetCell": "D1", ...} // WRONG! D1 is same row, will overlap!
|
|
319
|
+
```
|
|
320
|
+
|
|
321
|
+
✅ **CORRECT - Vertical placement:**
|
|
322
|
+
```json
|
|
323
|
+
{"targetCell": "A1", ...} // First pivot
|
|
324
|
+
{"targetCell": "A15", ...} // CORRECT! 15 rows below
|
|
325
|
+
{"targetCell": "A30", ...} // Third pivot, 15 more rows below
|
|
326
|
+
```
|
|
327
|
+
|
|
328
|
+
**Example - Two pivots in one sheet:**
|
|
329
|
+
```json
|
|
330
|
+
// FIRST pivot at A1
|
|
331
|
+
{"sourceSheetName": "Sheet1", "sourceRange": "A1:G100", "targetSheetName": "Summary", "targetCell": "A1", "rowFields": ["Product"], "dataFields": [{"field": "Revenue", "function": "Sum"}]}
|
|
332
|
+
// SECOND pivot at A15 (same sheet, VERTICAL spacing!)
|
|
333
|
+
{"sourceSheetName": "Sheet1", "sourceRange": "A1:G100", "targetSheetName": "Summary", "targetCell": "A15", "rowFields": ["Sales Channel"], "dataFields": [{"field": "Revenue", "function": "Sum"}]}
|
|
334
|
+
```
|
|
335
|
+
|
|
336
|
+
| Parameter | Type | Required | Default | Description |
|
|
337
|
+
|-----------|------|----------|---------|-------------|
|
|
338
|
+
| sourceSheetName | string | Yes | - | Data sheet name (e.g., "Sheet1"). ⚠️ NOT `sheetName` — that field does NOT exist! |
|
|
339
|
+
| sourceRange | string | Yes | - | Data range WITH headers (e.g., "A1:E100"). Do NOT include sheet name! |
|
|
340
|
+
| targetSheetName | string | **Required if task names a sheet** | New sheet | Use EXACT sheet name from the task (e.g., "Sheet2"). 🚨 For multiple pivots in SAME sheet, use SAME name for all |
|
|
341
|
+
| targetCell | string | No | "A3" | 🚨 VERTICAL spacing required: "A1", "A15", "A30" (NOT "A1", "D1"!) |
|
|
342
|
+
| rowFields | array | No | - | Row grouping columns |
|
|
343
|
+
| columnFields | array | No | - | Column grouping |
|
|
344
|
+
| dataFields | array | Yes | - | Aggregations (see format below) |
|
|
345
|
+
| filterFields | array | No | - | Filter columns |
|
|
346
|
+
| dateGrouping | string | No | - | **Windows only.** Group date fields by time period. Values: `"Year"`, `"Month"`, `"Quarter"`, `"Day"`, or combinations like `"Year,Month"`. When set, date-type fields in rowFields/columnFields are automatically grouped. Errors on macOS — add a helper column (e.g. `=YEAR(A2)` or `=TEXT(A2,"yyyy-mm")`) to `sourceRange` and group on that column. |
|
|
347
|
+
|
|
348
|
+
**dataFields Schema (EXACT FORMAT REQUIRED):**
|
|
349
|
+
```
|
|
350
|
+
dataFields: [
|
|
351
|
+
{ "field": "Sales", "function": "Sum" },
|
|
352
|
+
{ "field": "Quantity", "function": "Count" },
|
|
353
|
+
{ "field": "Sales", "function": "Sum", "showAs": "percentOfTotal" }
|
|
354
|
+
]
|
|
355
|
+
```
|
|
356
|
+
⚠️ **MUST use "field" property** - NOT "sourceColumn", NOT "column", NOT "name"!
|
|
357
|
+
|
|
358
|
+
**Functions:** `Sum`, `Count`, `Average`, `Max`, `Min`
|
|
359
|
+
|
|
360
|
+
**showAs** (optional): Display values as percentages instead of raw numbers:
|
|
361
|
+
- `"percentOfTotal"` — % of Grand Total
|
|
362
|
+
- `"percentOfColumn"` — % of Column Total
|
|
363
|
+
- `"percentOfRow"` — % of Row Total
|
|
364
|
+
- Omit or use `"normal"` for raw values (default)
|
|
365
|
+
|
|
366
|
+
⚠️ **CRITICAL:** Field names must EXACTLY match column headers (case-sensitive)!
|
|
367
|
+
|
|
368
|
+
**Date Grouping Example:**
|
|
369
|
+
```json
|
|
370
|
+
{
|
|
371
|
+
"sourceSheetName": "Sales",
|
|
372
|
+
"sourceRange": "A1:D500",
|
|
373
|
+
"targetSheetName": "Summary",
|
|
374
|
+
"targetCell": "A1",
|
|
375
|
+
"rowFields": ["Product"],
|
|
376
|
+
"columnFields": ["OrderDate"],
|
|
377
|
+
"dataFields": [{"field": "Revenue", "function": "Sum"}],
|
|
378
|
+
"dateGrouping": "Year"
|
|
379
|
+
}
|
|
380
|
+
```
|
|
381
|
+
This groups the OrderDate column by year (2023, 2024, etc.) instead of showing individual dates.
|