@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,433 @@
|
|
|
1
|
+
# Excel Styling, Features & Advanced Operations Reference
|
|
2
|
+
|
|
3
|
+
This file contains UI Automation tips, keyboard shortcuts, number formats, Big Four/McKinsey style guide, complete styling workflows, pivot tables, and chart best practices. **Read this before formatting, creating pivots/charts, or using UI Automation.**
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## UI Automation Tips (CRITICAL)
|
|
8
|
+
|
|
9
|
+
### Zoom Level for Cell Targeting (Both Platforms)
|
|
10
|
+
|
|
11
|
+
If you have difficulty clicking on specific cells or small UI elements, **increase zoom to 125%**:
|
|
12
|
+
- View → Zoom → 125%
|
|
13
|
+
- Or use Cmd+scroll (macOS) / Ctrl+scroll (Windows) to zoom in
|
|
14
|
+
- Higher zoom makes cells larger and easier to target accurately
|
|
15
|
+
- **Recommended**: Set zoom to 125% at the start of any Excel styling task
|
|
16
|
+
|
|
17
|
+
### Color Picker Behavior
|
|
18
|
+
|
|
19
|
+
**macOS:** The color picker opens in a **SEPARATE Excel window** (often titled "Font Color"):
|
|
20
|
+
1. Select cells in main workbook
|
|
21
|
+
2. Click Fill Color dropdown arrow in ribbon
|
|
22
|
+
3. Check AvailableApplicationWindows for new Excel window
|
|
23
|
+
4. **Switch to that color picker window** (AppAct with that window identifier)
|
|
24
|
+
5. Use keyboard navigation: `[k(down)][k(right)][k(right)][k(right)][k(enter)]`
|
|
25
|
+
6. Window auto-closes, color is applied
|
|
26
|
+
|
|
27
|
+
**CRITICAL:** Never try keyboard on main workbook when color picker is open—it will navigate cells!
|
|
28
|
+
|
|
29
|
+
**Windows:** The color picker stays in the same window, but keyboard navigation is still recommended over clicking small color squares.
|
|
30
|
+
|
|
31
|
+
### Shift Key Issues with Formula Entry
|
|
32
|
+
|
|
33
|
+
When typing formulas with absolute references like `$F$5`:
|
|
34
|
+
|
|
35
|
+
| Problem | Cause | Solution |
|
|
36
|
+
|---------|-------|----------|
|
|
37
|
+
| `$F%5` instead of `$F$5` | Shift held for `$` catches the `5` | Release Shift before typing numbers |
|
|
38
|
+
| `$F^6` instead of `$F$6` | Shift+6 = `^` | Release Shift before typing `6` |
|
|
39
|
+
| `#NAME?` errors | Invalid characters in formula | Check for `%` or `^` typos |
|
|
40
|
+
|
|
41
|
+
**Correct technique**: Type `$`, release Shift, type `F`, type `$`, release Shift, type `5`
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## Keyboard Shortcuts (Both Platforms)
|
|
46
|
+
|
|
47
|
+
### Navigation
|
|
48
|
+
| Action | macOS | Windows |
|
|
49
|
+
|--------|-------|---------|
|
|
50
|
+
| Go to cell A1 | `Cmd+Home` or `Ctrl+Fn+Left` | `Ctrl+Home` |
|
|
51
|
+
| Go to last cell | `Cmd+End` or `Ctrl+Fn+Right` | `Ctrl+End` |
|
|
52
|
+
| Jump to data edge | `Cmd+Arrow` | `Ctrl+Arrow` |
|
|
53
|
+
| Go to specific cell | Click Name Box → type ref → Enter | Same |
|
|
54
|
+
| Switch worksheets | `Ctrl+Page Up/Down` or `Fn+Ctrl+Up/Down` | `Ctrl+Page Up/Down` |
|
|
55
|
+
|
|
56
|
+
### Selection
|
|
57
|
+
| Action | macOS | Windows |
|
|
58
|
+
|--------|-------|---------|
|
|
59
|
+
| Select entire column | `Ctrl+Space` | `Ctrl+Space` |
|
|
60
|
+
| Select entire row | `Shift+Space` | `Shift+Space` |
|
|
61
|
+
| Extend to data edge | `Cmd+Shift+Arrow` | `Ctrl+Shift+Arrow` |
|
|
62
|
+
| Select current region | `Cmd+Shift+*` | `Ctrl+Shift+*` |
|
|
63
|
+
|
|
64
|
+
### Editing
|
|
65
|
+
| Action | macOS | Windows |
|
|
66
|
+
|--------|-------|---------|
|
|
67
|
+
| Edit cell | `F2` | `F2` |
|
|
68
|
+
| New line in cell | `Option+Enter` | `Alt+Enter` |
|
|
69
|
+
| AutoSum | `Cmd+Shift+T` | `Alt+=` |
|
|
70
|
+
| Fill down | `Cmd+D` | `Ctrl+D` |
|
|
71
|
+
| Fill right | `Cmd+R` | `Ctrl+R` |
|
|
72
|
+
| Toggle absolute ref | `F4` (while editing) | `F4` |
|
|
73
|
+
|
|
74
|
+
### Formatting
|
|
75
|
+
| Action | macOS | Windows |
|
|
76
|
+
|--------|-------|---------|
|
|
77
|
+
| Format Cells dialog | `Cmd+1` | `Ctrl+1` |
|
|
78
|
+
| Bold | `Cmd+B` | `Ctrl+B` |
|
|
79
|
+
| Currency format | `Ctrl+Shift+$` | `Ctrl+Shift+$` |
|
|
80
|
+
| Percentage format | `Ctrl+Shift+%` | `Ctrl+Shift+%` |
|
|
81
|
+
| Create table | `Cmd+T` | `Ctrl+T` |
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## UIA Fallback Guidance
|
|
86
|
+
|
|
87
|
+
**UIA needs Excel on screen.** Everything in the `/excel/*` API works with Excel hidden, which is the default — but UI Automation drives the actual window, so re-open with `"visible": true` before any of the following, and tell the user why Excel is appearing.
|
|
88
|
+
|
|
89
|
+
Use UI Automation (AppAct) when:
|
|
90
|
+
|
|
91
|
+
1. **Ribbon Operations** - Format Painter, Conditional Formatting dialogs, Advanced features
|
|
92
|
+
2. **Color Picker** - Custom colors not in API palette
|
|
93
|
+
3. **Dialogs** - Print Preview, Page Setup, Import wizards
|
|
94
|
+
4. **Add-ins** - Third-party add-in interactions
|
|
95
|
+
5. **Visual Verification** - Screenshot to confirm result
|
|
96
|
+
6. **API Failure** - As fallback when native API fails
|
|
97
|
+
|
|
98
|
+
Reach for 1–4 only when the API genuinely cannot do it. For 5, prefer `get-status` and `read-range`: they inspect the workbook itself, need no window, and tell you what the data actually is rather than what it looks like.
|
|
99
|
+
|
|
100
|
+
**UIA Best Practices:**
|
|
101
|
+
- Always target specific elements, not coordinates
|
|
102
|
+
- Wait for dialogs to fully load before interacting
|
|
103
|
+
- Use keyboard shortcuts when possible (Ctrl+B for bold)
|
|
104
|
+
- Take screenshot after for verification if uncertain
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
## Navigation via Name Box
|
|
109
|
+
|
|
110
|
+
```json
|
|
111
|
+
{
|
|
112
|
+
"actions": [
|
|
113
|
+
{"type": "click", "payload": {"elementDescription": "Name Box showing cell reference"}},
|
|
114
|
+
{"type": "text_type", "payload": {"value": "B15"}},
|
|
115
|
+
{"type": "key_press", "payload": {"keys": "[k(enter)]"}}
|
|
116
|
+
]
|
|
117
|
+
}
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
## Number Format Codes
|
|
123
|
+
|
|
124
|
+
| Format | Code | Example Result |
|
|
125
|
+
|--------|------|----------------|
|
|
126
|
+
| Currency | `$#,##0.00` | $1,234.56 |
|
|
127
|
+
| Percentage | `0.00%` | 12.34% |
|
|
128
|
+
| Accounting | `_($* #,##0.00_)` | $ 1,234.56 |
|
|
129
|
+
| Date | `mm/dd/yyyy` | 01/15/2024 |
|
|
130
|
+
| Date (Long) | `mmmm d, yyyy` | January 15, 2024 |
|
|
131
|
+
| Number | `#,##0` | 1,234 |
|
|
132
|
+
| Decimal | `0.00` | 1234.56 |
|
|
133
|
+
|
|
134
|
+
---
|
|
135
|
+
|
|
136
|
+
## Big Four / McKinsey Style Guide
|
|
137
|
+
|
|
138
|
+
Professional consulting-style formatting:
|
|
139
|
+
|
|
140
|
+
### Color-Coding Convention (Industry Standard)
|
|
141
|
+
| Cell Type | Font Color | Background | Purpose |
|
|
142
|
+
|-----------|------------|------------|---------|
|
|
143
|
+
| Hard-coded inputs | **Blue (#0000FF)** | White/Light Yellow | Manual entry, assumptions — numbers users will change for scenarios |
|
|
144
|
+
| Formulas (same sheet) | **Black (#000000)** | White | ALL formulas and calculations |
|
|
145
|
+
| Links to other sheets | **Green (#008000)** | White | Cross-sheet references within same workbook |
|
|
146
|
+
| External links | **Red (#FF0000)** | White | Links to other files |
|
|
147
|
+
| Key assumptions | Black | **Yellow (#FFFF00)** | Cells needing attention or update |
|
|
148
|
+
| Output/Results | Black (Bold) | Light Gray (#D9D9D9) | Summary cells |
|
|
149
|
+
| Headers | White (Bold) | Dark Blue (#4472C4) | Section headers |
|
|
150
|
+
|
|
151
|
+
Use the `financial` theme in the Generator to get these conventions automatically (negatives in parentheses, zeros as "-", standard fonts).
|
|
152
|
+
|
|
153
|
+
### Number Formatting Standards
|
|
154
|
+
| Data Type | Format | Example |
|
|
155
|
+
|-----------|--------|---------|
|
|
156
|
+
| **Years** | Text (not number) | "2024" not "2,024" |
|
|
157
|
+
| **Currency** | `$#,##0;($#,##0);"-"` — units in headers | "Revenue ($mm)" |
|
|
158
|
+
| **Zeros** | Dash "-" for all zero values | `-` not `0` or `$0` |
|
|
159
|
+
| **Percentages** | `0.0%` — one decimal | 12.5% |
|
|
160
|
+
| **Multiples** | `0.0x` | 8.5x (EV/EBITDA, P/E) |
|
|
161
|
+
| **Negative numbers** | Parentheses | (123) not -123 |
|
|
162
|
+
|
|
163
|
+
### Documentation Requirements for Hardcoded Values
|
|
164
|
+
When the workbook contains hardcoded data, add cell comments citing the source:
|
|
165
|
+
|
|
166
|
+
**Format:** `Source: [System/Document], [Date], [Specific Reference], [URL if applicable]`
|
|
167
|
+
|
|
168
|
+
**Examples:**
|
|
169
|
+
- `Source: Company 10-K, FY2024, Page 45, Revenue Note`
|
|
170
|
+
- `Source: Bloomberg Terminal, 2025-08-15, AAPL US Equity`
|
|
171
|
+
- `Source: FactSet, 2025-08-20, Consensus Estimates Screen`
|
|
172
|
+
|
|
173
|
+
Use the `comment` field on formatted cells or add a "Sources" column in data tables.
|
|
174
|
+
|
|
175
|
+
### Visual Standards
|
|
176
|
+
| Element | Style |
|
|
177
|
+
|---------|-------|
|
|
178
|
+
| **Headers** | Dark blue bg (#4472C4), white bold text, centered |
|
|
179
|
+
| **Data Rows** | Alternating white/light gray, left-aligned |
|
|
180
|
+
| **Numbers** | Right-aligned, appropriate decimal places |
|
|
181
|
+
| **Currency** | Accounting format with $ symbol |
|
|
182
|
+
| **Borders** | Thin gray, headers have bottom border |
|
|
183
|
+
| **Fonts** | Calibri 10-11pt for data, 12pt for headers |
|
|
184
|
+
|
|
185
|
+
### Layout Standards
|
|
186
|
+
|
|
187
|
+
**Sheet Organization:**
|
|
188
|
+
```
|
|
189
|
+
Sheet 1: Cover/Summary Dashboard
|
|
190
|
+
Sheet 2: Inputs & Assumptions (Blue font)
|
|
191
|
+
Sheet 3: Model/Calculations (Black font)
|
|
192
|
+
Sheet 4: Outputs/Results (Bold)
|
|
193
|
+
Sheet 5: Charts
|
|
194
|
+
Sheet 6: Raw Data/Appendix
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
**Section Structure:**
|
|
198
|
+
```
|
|
199
|
+
Row 1-2: Title and Subtitle (Bold, larger font)
|
|
200
|
+
Row 3: Blank (breathing room)
|
|
201
|
+
Row 4: Column Headers (Bold, Bottom Border, Dark Fill)
|
|
202
|
+
Row 5+: Data rows
|
|
203
|
+
[Blank row between sections]
|
|
204
|
+
Last row: Totals (Bold, Top Border)
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
### Big Four Color Palette
|
|
208
|
+
|
|
209
|
+
| Color Name | Hex | RGB | Use Case |
|
|
210
|
+
|------------|-----|-----|----------|
|
|
211
|
+
| `header` | #4472C4 | (68, 114, 196) | Header rows |
|
|
212
|
+
| `input` | #FFFF99 | (255, 255, 153) | Input/assumption cells |
|
|
213
|
+
| `output` | #D9D9D9 | (217, 217, 217) | Output/result cells |
|
|
214
|
+
| `accent` | #BDD7EE | (189, 215, 238) | Accent/highlight |
|
|
215
|
+
| `error` | #FFC7CE | (255, 199, 206) | Error highlighting |
|
|
216
|
+
|
|
217
|
+
---
|
|
218
|
+
|
|
219
|
+
## Complete Styling Workflows
|
|
220
|
+
|
|
221
|
+
### Workflow 1: Create Professional Dashboard
|
|
222
|
+
|
|
223
|
+
**Goal:** Build a sales dashboard with proper styling
|
|
224
|
+
|
|
225
|
+
```
|
|
226
|
+
Phase 1: Structure (Native API/paste_content)
|
|
227
|
+
─────────────────────────────────────────────
|
|
228
|
+
1. Create/open workbook
|
|
229
|
+
2. Paste data structure with formulas:
|
|
230
|
+
- Headers with bold (font-weight:bold)
|
|
231
|
+
- Input data with blue font (color:#0000FF)
|
|
232
|
+
- Formula columns: =SUM(B{row}:D{row})
|
|
233
|
+
|
|
234
|
+
Phase 2: Formatting (API or Scripts)
|
|
235
|
+
──────────────────────────────────────
|
|
236
|
+
3. Apply header style (dark blue bg #4472C4, white text)
|
|
237
|
+
4. Apply borders to data range
|
|
238
|
+
5. Format currency columns
|
|
239
|
+
6. Auto-fit all columns
|
|
240
|
+
7. Freeze header row (row 1)
|
|
241
|
+
|
|
242
|
+
Phase 3: Visual Polish (UIA if needed)
|
|
243
|
+
────────────────────────────────────────
|
|
244
|
+
8. Apply conditional formatting for highlights
|
|
245
|
+
9. Add chart with proper X-axis labels
|
|
246
|
+
10. Position chart to avoid overlaps
|
|
247
|
+
|
|
248
|
+
Phase 4: Validation
|
|
249
|
+
────────────────────
|
|
250
|
+
11. Health check for errors
|
|
251
|
+
12. Verify with get-status / read-range (no window needed; a screenshot would
|
|
252
|
+
require making Excel visible, so only do that if the user asked to see it)
|
|
253
|
+
13. Save workbook
|
|
254
|
+
```
|
|
255
|
+
|
|
256
|
+
### Workflow 2: Monthly Budget with Big Four Style
|
|
257
|
+
|
|
258
|
+
**Goal:** Professional budget tracker with consulting standards
|
|
259
|
+
|
|
260
|
+
```
|
|
261
|
+
Phase 1: Data Entry (paste_content with styling)
|
|
262
|
+
──────────────────────────────────────────────────
|
|
263
|
+
<table>
|
|
264
|
+
<tr><th style="font-weight:bold;">Category</th><th style="font-weight:bold;">Budget</th><th style="font-weight:bold;">Actual</th><th style="font-weight:bold;">Variance</th></tr>
|
|
265
|
+
<tr><td>Housing</td><td style="color:#0000FF;">2000</td><td style="color:#0000FF;">1950</td><td>=C2-B2</td></tr>
|
|
266
|
+
<tr><td>Utilities</td><td style="color:#0000FF;">300</td><td style="color:#0000FF;">325</td><td>=C3-B3</td></tr>
|
|
267
|
+
<tr><td style="font-weight:bold;">Total</td><td>=SUM(B2:B4)</td><td>=SUM(C2:C4)</td><td>=SUM(D2:D4)</td></tr>
|
|
268
|
+
</table>
|
|
269
|
+
|
|
270
|
+
Phase 2: Apply Big Four Styling
|
|
271
|
+
──────────────────────────────────
|
|
272
|
+
1. Select A1:D1 → Apply header style (dark blue bg, white text)
|
|
273
|
+
2. Select all data → Apply borders
|
|
274
|
+
3. Select B2:D5 → Format as currency
|
|
275
|
+
4. Auto-fit columns
|
|
276
|
+
5. Freeze row 1
|
|
277
|
+
|
|
278
|
+
Phase 3: Validation
|
|
279
|
+
─────────────────────
|
|
280
|
+
1. Change a Budget value → verify Variance updates (formulas work!)
|
|
281
|
+
2. Verify totals are correct
|
|
282
|
+
3. Health check
|
|
283
|
+
4. Save
|
|
284
|
+
```
|
|
285
|
+
|
|
286
|
+
### Workflow 3: API + UIA Synergy Pattern
|
|
287
|
+
|
|
288
|
+
**When to use each approach:**
|
|
289
|
+
|
|
290
|
+
```
|
|
291
|
+
API/Script First (90% of tasks):
|
|
292
|
+
────────────────────────────────
|
|
293
|
+
✅ Write data (write-range, write-ranges-batch, write-formulas-batch)
|
|
294
|
+
✅ Basic formatting (format-range, auto-fit)
|
|
295
|
+
✅ Charts with data ranges
|
|
296
|
+
✅ Formulas and calculations
|
|
297
|
+
✅ Conditional formatting (ContainsText, CellValue)
|
|
298
|
+
|
|
299
|
+
UIA Fallback (10% of tasks):
|
|
300
|
+
──────────────────────────────
|
|
301
|
+
✅ Ribbon interactions (Format Painter, advanced features)
|
|
302
|
+
✅ Custom color picker (not in API palette)
|
|
303
|
+
✅ Complex dialogs (Page Setup, Print Preview)
|
|
304
|
+
✅ Visual verification (screenshot after operations)
|
|
305
|
+
✅ When API fails or feature not available
|
|
306
|
+
```
|
|
307
|
+
|
|
308
|
+
**Example: Column Chart with Proper Labels**
|
|
309
|
+
```json
|
|
310
|
+
{
|
|
311
|
+
"endpoint": "/excel/add-chart-from-range",
|
|
312
|
+
"body": {
|
|
313
|
+
"sheetName": "Dashboard",
|
|
314
|
+
"valueRange": "B2:D5",
|
|
315
|
+
"xLabelRange": "A2:A5",
|
|
316
|
+
"chartType": "xlColumnClustered",
|
|
317
|
+
"title": "Q4 Sales by Region",
|
|
318
|
+
"width": 550,
|
|
319
|
+
"height": 350
|
|
320
|
+
}
|
|
321
|
+
}
|
|
322
|
+
```
|
|
323
|
+
|
|
324
|
+
---
|
|
325
|
+
|
|
326
|
+
## Pivot Tables
|
|
327
|
+
|
|
328
|
+
**When the user asks for a "pivot table", ALWAYS create an actual Excel PivotTable using the `/excel/create-pivot-table` endpoint.** Do NOT manually compute values and write them as a static table — that defeats the purpose of a pivot table (dynamic, interactive, auto-updating).
|
|
329
|
+
|
|
330
|
+
### When to Use Pivot Tables
|
|
331
|
+
- User explicitly says "pivot table"
|
|
332
|
+
- User wants to summarize/aggregate data by categories (e.g., "show sales by department")
|
|
333
|
+
- User wants percentage breakdowns, counts, averages grouped by fields
|
|
334
|
+
- User wants cross-tabulation (rows x columns)
|
|
335
|
+
|
|
336
|
+
### Endpoint: `/excel/create-pivot-table`
|
|
337
|
+
|
|
338
|
+
```json
|
|
339
|
+
{
|
|
340
|
+
"endpoint": "/excel/create-pivot-table",
|
|
341
|
+
"body": {
|
|
342
|
+
"sourceSheetName": "Data",
|
|
343
|
+
"sourceRange": "A1:E100",
|
|
344
|
+
"pivotSheetName": "PivotAnalysis",
|
|
345
|
+
"pivotTableName": "SalesPivot",
|
|
346
|
+
"rowFields": ["Department"],
|
|
347
|
+
"columnFields": ["Region"],
|
|
348
|
+
"dataFields": [
|
|
349
|
+
{"field": "Revenue", "function": "sum"},
|
|
350
|
+
{"field": "Units", "function": "average"}
|
|
351
|
+
],
|
|
352
|
+
"filterFields": ["Year"]
|
|
353
|
+
}
|
|
354
|
+
}
|
|
355
|
+
```
|
|
356
|
+
|
|
357
|
+
### Parameters
|
|
358
|
+
| Parameter | Required | Description |
|
|
359
|
+
|-----------|----------|-------------|
|
|
360
|
+
| `sourceSheetName` | Yes | Sheet containing the source data |
|
|
361
|
+
| `sourceRange` | Yes | A1-style range including headers (e.g., `A1:E100`) |
|
|
362
|
+
| `pivotSheetName` | No | Destination sheet name (auto-created if not exists, defaults to "PivotSheet") |
|
|
363
|
+
| `pivotTableName` | No | Name for the pivot table (auto-generated if omitted) |
|
|
364
|
+
| `rowFields` | No | Array of column header names for row labels |
|
|
365
|
+
| `columnFields` | No | Array of column header names for column labels |
|
|
366
|
+
| `dataFields` | Yes | Array of `{field, function, showAs}` — the values to aggregate |
|
|
367
|
+
| `filterFields` | No | Array of column header names for page/filter area |
|
|
368
|
+
|
|
369
|
+
### Aggregation Functions
|
|
370
|
+
`sum` (default), `count`, `average`, `max`, `min`
|
|
371
|
+
|
|
372
|
+
### Show Values As (Percentages)
|
|
373
|
+
Each data field object can include a `showAs` property to display values as percentages instead of raw numbers:
|
|
374
|
+
- `"percentOfTotal"` — % of Grand Total (most common for distribution/demographic tables)
|
|
375
|
+
- `"percentOfColumn"` — % of Column Total
|
|
376
|
+
- `"percentOfRow"` — % of Row Total
|
|
377
|
+
- `"normal"` (default) — raw aggregated values
|
|
378
|
+
|
|
379
|
+
**Example**: To show Sex distribution as percentages:
|
|
380
|
+
```json
|
|
381
|
+
"dataFields": [{"field": "Sex", "function": "count", "showAs": "percentOfTotal"}]
|
|
382
|
+
```
|
|
383
|
+
This eliminates the need for manual percentage conversion or UI automation.
|
|
384
|
+
|
|
385
|
+
### Important: Destination Sheet
|
|
386
|
+
- **Use a dedicated sheet** for pivot tables (e.g., `pivotSheetName: "PivotAnalysis"`). The endpoint auto-creates the sheet if it doesn't exist.
|
|
387
|
+
- **Merged cells are automatically unmerged** on the destination sheet before pivot creation (merged cells cause errors). Cell content is preserved.
|
|
388
|
+
- You can place pivot tables on sheets that already have headers or data — pivots are auto-placed below existing content.
|
|
389
|
+
|
|
390
|
+
### Multiple Pivot Tables
|
|
391
|
+
To create multiple pivot tables on the same sheet, call the endpoint multiple times with different `pivotTableName` values. Each pivot is automatically stacked below existing content with a gap row. Do NOT specify `topLeftCell` — let the auto-placement handle positioning.
|
|
392
|
+
|
|
393
|
+
### Example: Demographic Profile with Percentage Pivot Tables
|
|
394
|
+
```
|
|
395
|
+
1. Read source data sheet to get column names and data range
|
|
396
|
+
2. Create pivot table for Sex:
|
|
397
|
+
- rowFields: ["Sex"]
|
|
398
|
+
- dataFields: [{"field": "Sex", "function": "count"}]
|
|
399
|
+
3. Create pivot table for Civil Status:
|
|
400
|
+
- rowFields: ["Civil Status"]
|
|
401
|
+
- dataFields: [{"field": "Civil Status", "function": "count"}]
|
|
402
|
+
4. Format percentage columns after pivot creation
|
|
403
|
+
```
|
|
404
|
+
|
|
405
|
+
---
|
|
406
|
+
|
|
407
|
+
## Chart Best Practices
|
|
408
|
+
|
|
409
|
+
### Always Provide X-Axis Labels!
|
|
410
|
+
|
|
411
|
+
**Problem:** Charts show "1, 2, 3, 4" instead of category names
|
|
412
|
+
|
|
413
|
+
**Solution:** Use `xLabelRange` parameter
|
|
414
|
+
|
|
415
|
+
```json
|
|
416
|
+
{
|
|
417
|
+
"valueRange": "B2:E5",
|
|
418
|
+
"xLabelRange": "A2:A5",
|
|
419
|
+
"chartType": "xlColumnClustered"
|
|
420
|
+
}
|
|
421
|
+
```
|
|
422
|
+
|
|
423
|
+
Also accepts `categoryRange` as an alias for `xLabelRange`.
|
|
424
|
+
|
|
425
|
+
### Chart Types
|
|
426
|
+
|
|
427
|
+
| Type | When to Use | Example |
|
|
428
|
+
|------|-------------|---------|
|
|
429
|
+
| `xlColumnClustered` | Compare categories | Regional sales comparison |
|
|
430
|
+
| `xlLine` | Show trends over time | Monthly revenue trend |
|
|
431
|
+
| `xlPie` | Show parts of whole | Market share by product |
|
|
432
|
+
| `xlBarClustered` | Long category names | Employee performance by department |
|
|
433
|
+
| `xlArea` | Cumulative totals | Stacked budget allocation |
|