@uipath/delegate-sdk 1.203.1 → 1.203.3
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 +729 -0
- package/dist/skills/business-analysis/as-is-capture.md +444 -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 +224 -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 +88 -0
- package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
- package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
- package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
- package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
- package/dist/skills/office-download/SKILL.md +161 -0
- package/dist/skills/outlook-365/SKILL.macos.md +331 -0
- package/dist/skills/outlook-365/SKILL.md +171 -0
- package/dist/skills/outlook-365/SKILL.windows.md +124 -0
- package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
- package/dist/skills/outlook-365/api/check-availability.md +87 -0
- package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
- package/dist/skills/outlook-365/api/download-attachments.md +149 -0
- package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
- package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
- package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
- package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
- package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
- package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
- package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
- package/dist/skills/outlook-365/api/send-email.md +396 -0
- package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
- package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
- package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
- package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
- package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
- package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
- package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
- package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
- package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
- package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
- package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
- package/dist/skills/outlook-365/uia/README.md +75 -0
- package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
- package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
- package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
- package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
- package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
- package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
- package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
- package/dist/skills/pdf-architect/SKILL.md +640 -0
- package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
- package/dist/skills/powerpoint-architect/SKILL.md +853 -0
- package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
- package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
- package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
- package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
- package/dist/skills/powerpoint-architect/images-guide.md +207 -0
- package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
- package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
- package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
- package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
- package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
- package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
- package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
- package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
- package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
- package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
- package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
- package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
- package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
- package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
- package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
- package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
- package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
- package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
- package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
- package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
- package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
- package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
- package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
- package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
- package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
- package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
- package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
- package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
- package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
- package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
- package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
- package/dist/skills/project-task-list/SKILL.md +174 -0
- package/dist/skills/slack-operation/SKILL.md +97 -0
- package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
- package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
- package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
- package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
- package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
- package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
- package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
- package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
- package/dist/skills/system-diagnostics/SKILL.md +263 -0
- package/dist/skills/teams-operation/SKILL.md +79 -0
- package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
- package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
- package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
- package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
- package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
- package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
- package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
- package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
- package/dist/skills/transcribe-media/SKILL.md +142 -0
- package/dist/skills/uipath-integrations/SKILL.md +370 -0
- package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
- package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
- package/dist/skills/uipath-integrations/reference/errors.md +211 -0
- package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
- package/dist/skills/uipath-integrations/reference/operations.md +297 -0
- package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
- package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
- package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
- package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
- package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
- package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
- package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
- package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
- package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
- package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
- package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
- package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
- package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
- package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
- package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
- package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
- package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
- package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
- package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
- package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
- package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
- package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
- package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
- package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
- package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
- package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
- package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
- package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
- package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
- package/dist/skills/word-architect/SKILL.macos.md +147 -0
- package/dist/skills/word-architect/SKILL.md +502 -0
- package/dist/skills/word-architect/SKILL.windows.md +55 -0
- package/dist/skills/word-architect/api/advanced.md +522 -0
- package/dist/skills/word-architect/api/basic.md +378 -0
- package/dist/skills/word-architect/api/expert.md +302 -0
- package/dist/skills/word-architect/generation.md +308 -0
- package/dist/skills/word-architect/layouts/01-professional.md +168 -0
- package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
- package/dist/skills/word-architect/layouts/03-academic.md +83 -0
- package/dist/skills/word-architect/layouts/04-creative.md +242 -0
- package/dist/skills/word-architect/layouts/05-operational.md +94 -0
- package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
- package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
- package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
- package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
- package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
- package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
- package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
- package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
- package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
- package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
- package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
- package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
- package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
- package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
- package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
- package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
- package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
- package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
- package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
- package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
- package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
- package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
- package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
- package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
- package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
- package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
- package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
- package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
- package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
- package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
- package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
- package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
- package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
- package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
- package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
- package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
- package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
- package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
- package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
- package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
- package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
- package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
- package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
- package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
- package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
- package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
- package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
- package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
- package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
- package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
- package/dist/skills/word-architect/reference/formatting.md +119 -0
- package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
- package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
- package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
- package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
- package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
- package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
- package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
- package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
- package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
- package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
- package/dist/skills/word-architect/reference/tables.md +62 -0
- package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
- package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
- package/dist/skills/word-architect/reference/visual-elements.md +82 -0
- package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
- package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
- package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
- package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
- package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
- package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
- package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
- package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
- package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
- package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
- package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
- package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
- package/package.json +5 -4
|
@@ -0,0 +1,337 @@
|
|
|
1
|
+
# Level 3: C# Scripting (Last Resort Only)
|
|
2
|
+
|
|
3
|
+
**⚠️ Use ONLY when Level 1 & 2 endpoints are insufficient!**
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## When to Use Scripts
|
|
8
|
+
|
|
9
|
+
✅ **Use for:**
|
|
10
|
+
- Conditional logic based on cell values
|
|
11
|
+
- Complex multi-condition formatting
|
|
12
|
+
- Operations requiring loops over cells
|
|
13
|
+
- Advanced chart customization
|
|
14
|
+
- Renaming sheets (no dedicated endpoint)
|
|
15
|
+
|
|
16
|
+
❌ **Don't use for (prefer endpoints):**
|
|
17
|
+
- Writing data → `write-range`
|
|
18
|
+
- Formulas → `write-formula` or `write-formulas-batch`
|
|
19
|
+
- Basic formatting → `format-range`
|
|
20
|
+
- Charts → `add-chart-from-range`
|
|
21
|
+
- Sorting → `sort-range`
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## Basic Usage
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
endpoint: "/excel/execute-script"
|
|
29
|
+
body: {
|
|
30
|
+
"filePath": "...",
|
|
31
|
+
"sheetName": "Sheet1",
|
|
32
|
+
"script": "// C# code here"
|
|
33
|
+
}
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
**Pre-defined Variables (NEVER reassign!):**
|
|
37
|
+
- `workbook` - Active workbook
|
|
38
|
+
- `worksheet` - Target worksheet
|
|
39
|
+
- `app` - Excel application
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## ⚠️ CRITICAL: Never Reassign Worksheet Global
|
|
44
|
+
|
|
45
|
+
```csharp
|
|
46
|
+
// ❌ WRONG: Reassigning worksheet global causes null reference errors!
|
|
47
|
+
dynamic sheet = worksheet; // DON'T DO THIS!
|
|
48
|
+
dynamic myRange = sheet.Range["A1:B10"]; // Will fail with null reference!
|
|
49
|
+
|
|
50
|
+
// ✅ CORRECT: Use worksheet global directly
|
|
51
|
+
dynamic myRange = worksheet.Range["A1:B10"]; // Works perfectly
|
|
52
|
+
myRange.Interior.Color = ColorTranslator.ToOle(Color.Yellow);
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## ⚠️ CRITICAL: Dynamic COM Limitations
|
|
58
|
+
|
|
59
|
+
**Code that looks correct may NOT compile!**
|
|
60
|
+
|
|
61
|
+
```csharp
|
|
62
|
+
// ❌ WILL NOT COMPILE - Cannot cast dynamic COM:
|
|
63
|
+
workbook.Sheets.Cast<Worksheet>().FirstOrDefault(...)
|
|
64
|
+
|
|
65
|
+
// ❌ WILL NOT COMPILE - No LINQ on COM collections:
|
|
66
|
+
workbook.Worksheets.Where(s => s.Name == "Data")
|
|
67
|
+
|
|
68
|
+
// ❌ WILL NOT COMPILE - Cannot enumerate COM with LINQ:
|
|
69
|
+
worksheet.Rows.Any(r => r.Hidden)
|
|
70
|
+
|
|
71
|
+
// ❌ WILL NOT COMPILE - Requires special handling:
|
|
72
|
+
dynamic col = worksheet.Columns["A"]; col.ColumnWidth = 20;
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
**Why?** `workbook`, `worksheet`, `range` are DYNAMIC COM objects. C# Roslyn compiler cannot apply extension methods (`.Cast`, `.Where`, `.Select`) to dynamic types.
|
|
76
|
+
|
|
77
|
+
**✅ USE INSTEAD:**
|
|
78
|
+
- Manual `foreach` loops with dynamic typing
|
|
79
|
+
- Direct property access without LINQ
|
|
80
|
+
- Store intermediate results in variables
|
|
81
|
+
- Use auto-fixer (it corrects many common errors automatically)
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## Manual Loop Instead of LINQ (Required for COM)
|
|
86
|
+
|
|
87
|
+
```csharp
|
|
88
|
+
// ❌ WRONG: LINQ on COM collections (will fail to compile)
|
|
89
|
+
var sheet = workbook.Sheets.Cast<Worksheet>().FirstOrDefault(s => s.Name == "Data");
|
|
90
|
+
|
|
91
|
+
// ✅ CORRECT: Manual loop instead
|
|
92
|
+
dynamic targetSheet = null;
|
|
93
|
+
foreach (var sheet in workbook.Sheets) {
|
|
94
|
+
if (sheet.Name == "Data") {
|
|
95
|
+
targetSheet = sheet;
|
|
96
|
+
break;
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## Safe Null/DBNull Handling (Complete Pattern)
|
|
104
|
+
|
|
105
|
+
```csharp
|
|
106
|
+
var data = worksheet.Range["A1:J" + worksheet.UsedRange.Rows.Count].Value;
|
|
107
|
+
for (int i = 2; i <= data.GetLength(0); i++) {
|
|
108
|
+
// STEP 1: Store cell values as objects first
|
|
109
|
+
object dateObj = data[i, 2];
|
|
110
|
+
object cityObj = data[i, 3];
|
|
111
|
+
object priceObj = data[i, 9];
|
|
112
|
+
|
|
113
|
+
// STEP 2: Check for null/DBNull using DBNull.Value.Equals()
|
|
114
|
+
if (dateObj == null || DBNull.Value.Equals(dateObj)) continue;
|
|
115
|
+
if (cityObj == null || DBNull.Value.Equals(cityObj)) continue;
|
|
116
|
+
if (priceObj == null || DBNull.Value.Equals(priceObj)) continue;
|
|
117
|
+
|
|
118
|
+
// STEP 3: Convert to strings and parse safely
|
|
119
|
+
string dateStr = dateObj.ToString();
|
|
120
|
+
string city = cityObj.ToString();
|
|
121
|
+
|
|
122
|
+
DateTime date;
|
|
123
|
+
if (!DateTime.TryParse(dateStr, out date)) continue;
|
|
124
|
+
|
|
125
|
+
double price;
|
|
126
|
+
if (!double.TryParse(priceObj.ToString(), out price)) continue;
|
|
127
|
+
|
|
128
|
+
// STEP 4: Now safe to use date, city, price
|
|
129
|
+
}
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
## Null-Safe Dictionary Pattern
|
|
135
|
+
|
|
136
|
+
```csharp
|
|
137
|
+
var data = worksheet.Range["A1:D" + worksheet.UsedRange.Rows.Count].Value;
|
|
138
|
+
var countryTotals = new Dictionary<string, double>();
|
|
139
|
+
|
|
140
|
+
for (int i = 2; i <= data.GetLength(0); i++) {
|
|
141
|
+
// STEP 1: Extract and validate key BEFORE using it
|
|
142
|
+
object keyObj = data[i, 1];
|
|
143
|
+
if (keyObj == null || DBNull.Value.Equals(keyObj)) continue;
|
|
144
|
+
|
|
145
|
+
string key = keyObj.ToString();
|
|
146
|
+
if (string.IsNullOrEmpty(key)) continue; // CRITICAL: Skip null/empty keys!
|
|
147
|
+
|
|
148
|
+
double value = Convert.ToDouble(data[i, 2] ?? 0);
|
|
149
|
+
|
|
150
|
+
// STEP 2: Safe to use in dictionary
|
|
151
|
+
if (countryTotals.ContainsKey(key)) {
|
|
152
|
+
countryTotals[key] += value;
|
|
153
|
+
} else {
|
|
154
|
+
countryTotals[key] = value;
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
**Common mistake:**
|
|
160
|
+
```csharp
|
|
161
|
+
// ❌ WRONG: Storing potentially null keys
|
|
162
|
+
allData.Add(new { Platform = inputData[r, 2], Value = x }); // Platform could be null!
|
|
163
|
+
string platform = rowData.Platform; // Now platform is null
|
|
164
|
+
myDict[platform]++; // ERROR: Value cannot be null (Parameter 'key')
|
|
165
|
+
|
|
166
|
+
// ✅ CORRECT: Validate BEFORE storing
|
|
167
|
+
object platformObj = inputData[r, 2];
|
|
168
|
+
if (platformObj == null || DBNull.Value.Equals(platformObj)) continue;
|
|
169
|
+
string platform = platformObj.ToString();
|
|
170
|
+
if (string.IsNullOrEmpty(platform)) continue; // Validate before storing
|
|
171
|
+
allData.Add(new { Platform = platform, Value = someValue });
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
---
|
|
175
|
+
|
|
176
|
+
## Writing Results to Cells (Not Context!)
|
|
177
|
+
|
|
178
|
+
```csharp
|
|
179
|
+
// ❌ WRONG: Using context or CustomProperties (doesn't exist!)
|
|
180
|
+
context.result = bestCity; // ERROR: 'context' doesn't exist
|
|
181
|
+
workbook.CustomProperties.Add("Result", value); // ERROR: Type mismatch
|
|
182
|
+
|
|
183
|
+
// ✅ CORRECT: Write results to cells to pass data between tool calls
|
|
184
|
+
dynamic answerSheet = workbook.Sheets["ANSWER"];
|
|
185
|
+
answerSheet.Cells[1, 1].Value = "Best City";
|
|
186
|
+
answerSheet.Cells[2, 1].Value = bestCity;
|
|
187
|
+
answerSheet.Cells[2, 2].Value = highestCAGR;
|
|
188
|
+
answerSheet.Cells[2, 2].NumberFormat = "0.00%"; // Format as percentage
|
|
189
|
+
// Then use ExcelReadRange in next tool call to read ANSWER!A2:B2
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
---
|
|
193
|
+
|
|
194
|
+
## Common Operations
|
|
195
|
+
|
|
196
|
+
### Conditional Coloring
|
|
197
|
+
```csharp
|
|
198
|
+
for (int i = 2; i <= lastRow; i++) {
|
|
199
|
+
dynamic cell = worksheet.Cells[i, 5];
|
|
200
|
+
var val = cell.Value?.ToString();
|
|
201
|
+
if (val == "High") cell.Interior.Color = ColorTranslator.ToOle(Color.Green);
|
|
202
|
+
else if (val == "Low") cell.Interior.Color = ColorTranslator.ToOle(Color.Red);
|
|
203
|
+
}
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
### Formula with Escaped Quotes
|
|
207
|
+
```csharp
|
|
208
|
+
worksheet.Cells[i, 5].Formula = $"=IF(D{i}>1000,\"High\",\"Low\")";
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
### Rename Sheet
|
|
212
|
+
```csharp
|
|
213
|
+
worksheet.Name = "Sales_Q1_2024";
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
### Freeze Panes
|
|
217
|
+
```csharp
|
|
218
|
+
worksheet.Application.ActiveWindow.SplitRow = 1;
|
|
219
|
+
worksheet.Application.ActiveWindow.FreezePanes = true;
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
### Data Validation Dropdown
|
|
223
|
+
```csharp
|
|
224
|
+
var validation = worksheet.Range["E2:E100"].Validation;
|
|
225
|
+
validation.Delete();
|
|
226
|
+
validation.Add(XlDVType.xlValidateList, XlDVAlertStyle.xlValidAlertStop,
|
|
227
|
+
XlFormulaCondition.xlBetween, "Low,Medium,High", Type.Missing);
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
### Chart Creation
|
|
231
|
+
```csharp
|
|
232
|
+
var chart = worksheet.ChartObjects().Add(400, 50, 500, 300).Chart;
|
|
233
|
+
chart.SetSourceData(worksheet.Range["B2:B11"], XlRowCol.xlColumns);
|
|
234
|
+
chart.ChartType = XlChartType.xlColumnClustered;
|
|
235
|
+
chart.HasTitle = true;
|
|
236
|
+
chart.ChartTitle.Text = "Sales by Month";
|
|
237
|
+
```
|
|
238
|
+
|
|
239
|
+
### Advanced Formatting
|
|
240
|
+
```csharp
|
|
241
|
+
var header = worksheet.Range["A1:E1"];
|
|
242
|
+
header.Font.Bold = true;
|
|
243
|
+
header.Interior.Color = ColorTranslator.ToOle(Color.LightBlue);
|
|
244
|
+
header.HorizontalAlignment = XlHAlign.xlHAlignCenter;
|
|
245
|
+
```
|
|
246
|
+
|
|
247
|
+
### Number Formats
|
|
248
|
+
```csharp
|
|
249
|
+
worksheet.Range["B2:B100"].NumberFormat = "$#,##0.00"; // Currency
|
|
250
|
+
worksheet.Range["C2:C100"].NumberFormat = "0.00%"; // Percentage
|
|
251
|
+
worksheet.Range["D2:D100"].NumberFormat = "mm/dd/yyyy"; // Date
|
|
252
|
+
```
|
|
253
|
+
|
|
254
|
+
### LINQ on Range (After Converting to Array)
|
|
255
|
+
```csharp
|
|
256
|
+
var values = new List<double>();
|
|
257
|
+
var usedRange = worksheet.Range["A2:A100"];
|
|
258
|
+
foreach (var cell in usedRange.Cells) {
|
|
259
|
+
if (cell.Value != null) {
|
|
260
|
+
values.Add(Convert.ToDouble(cell.Value));
|
|
261
|
+
}
|
|
262
|
+
}
|
|
263
|
+
var average = values.Count > 0 ? values.Average() : 0;
|
|
264
|
+
```
|
|
265
|
+
|
|
266
|
+
---
|
|
267
|
+
|
|
268
|
+
## Adding Shapes/Images (Overlap Detection)
|
|
269
|
+
|
|
270
|
+
```csharp
|
|
271
|
+
// When adding shapes, text boxes, or images, check for overlaps:
|
|
272
|
+
// 1. Get initial position from cell:
|
|
273
|
+
var cell = worksheet.Range["K2"];
|
|
274
|
+
double left = cell.Left;
|
|
275
|
+
double top = cell.Top;
|
|
276
|
+
|
|
277
|
+
// 2. Check existing shapes:
|
|
278
|
+
var shapes = worksheet.Shapes; // Iterate to check positions
|
|
279
|
+
|
|
280
|
+
// 3. Check existing charts:
|
|
281
|
+
var charts = worksheet.ChartObjects(); // Iterate to check positions
|
|
282
|
+
|
|
283
|
+
// 4. Check UsedRange - avoid overlapping data:
|
|
284
|
+
var usedRange = worksheet.UsedRange;
|
|
285
|
+
|
|
286
|
+
// 5. Adjust position if overlap detected (place to right or below)
|
|
287
|
+
|
|
288
|
+
// 🚨 MANDATORY: After adding ANY shape/text box/image,
|
|
289
|
+
// ALWAYS call ExcelGetStatus to verify no overlaps!
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
---
|
|
293
|
+
|
|
294
|
+
## Common Errors & Fixes
|
|
295
|
+
|
|
296
|
+
| Error | Cause | Fix |
|
|
297
|
+
|-------|-------|-----|
|
|
298
|
+
| `Cannot apply '==' to DateTime and DBNull` | Direct comparison | Use `DBNull.Value.Equals(obj)` |
|
|
299
|
+
| `The name 'context' does not exist` | Using `context.result` | Write to cells instead |
|
|
300
|
+
| `Value cannot be null (key)` | Null dictionary key | Validate: `if (string.IsNullOrEmpty(key)) continue;` |
|
|
301
|
+
| `ComObject has no definition for X` | Using `()` on property | Remove `()`: `workbook.PivotCaches.Create(...)` |
|
|
302
|
+
| LINQ compilation error | LINQ on COM collections | Use manual `foreach` loops |
|
|
303
|
+
| Null reference exception | Reassigned worksheet variable | Use `worksheet` directly, never reassign |
|
|
304
|
+
|
|
305
|
+
---
|
|
306
|
+
|
|
307
|
+
## Properties vs Methods
|
|
308
|
+
|
|
309
|
+
```csharp
|
|
310
|
+
// ✅ CORRECT (properties - no parentheses)
|
|
311
|
+
workbook.PivotCaches.Create(...)
|
|
312
|
+
workbook.Sheets["SheetName"]
|
|
313
|
+
worksheet.Cells[row, col]
|
|
314
|
+
|
|
315
|
+
// ❌ WRONG (adding parentheses to properties)
|
|
316
|
+
workbook.PivotCaches().Create(...)
|
|
317
|
+
```
|
|
318
|
+
|
|
319
|
+
---
|
|
320
|
+
|
|
321
|
+
## Rules
|
|
322
|
+
|
|
323
|
+
- **MAX 150 lines** per script
|
|
324
|
+
- **NO "Excel." prefix** on enums (use `XlChartType.xlColumnClustered` not `Excel.XlChartType...`)
|
|
325
|
+
- **Escape quotes:** `\"` in formulas
|
|
326
|
+
- **Check null AND DBNull** - both can appear in Excel data
|
|
327
|
+
- **Use foreach**, not LINQ on COM collections
|
|
328
|
+
- **Decompose:** Small scripts > giant scripts
|
|
329
|
+
- **Never reassign** `workbook`, `worksheet`, `app` variables
|
|
330
|
+
|
|
331
|
+
---
|
|
332
|
+
|
|
333
|
+
## 🚨 MANDATORY
|
|
334
|
+
|
|
335
|
+
**ALWAYS call `/excel/get-status` after EVERY script!**
|
|
336
|
+
|
|
337
|
+
Scripts can introduce hidden errors (#REF!, overlaps) that only GetStatus detects.
|