@uipath/delegate-sdk 1.203.0 → 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,126 @@
|
|
|
1
|
+
# UiPath Project Structure
|
|
2
|
+
|
|
3
|
+
## Directory Layout
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
MyProject/
|
|
7
|
+
├── project.json # Project manifest (name, dependencies, settings)
|
|
8
|
+
├── Main.cs # Default entry point
|
|
9
|
+
├── *.cs # Coded workflows, test cases, and source files
|
|
10
|
+
├── *.cs.json # Auto-generated by Studio — do not create manually
|
|
11
|
+
├── .codedworkflows/ # Auto-generated coded workflow support files (ConnectionsFactory.cs, ConnectionsManager.cs, ISConnections.cs, etc.)
|
|
12
|
+
├── .entities/ # Data Fabric entity manifest — EntitiesStore.json. Committed; source of truth for which entities are bound to the project. Managed via uip rpa data-fabric-entities install.
|
|
13
|
+
├── .local/ # Local cache (package restore, compiled artifacts)
|
|
14
|
+
│ ├── install/ # Restored NuGet packages
|
|
15
|
+
│ ├── docs/ # Auto-generated activity documentation
|
|
16
|
+
│ │ └── packages/ # Per-package doc folders
|
|
17
|
+
│ ├── .codedworkflows/ # Auto-generated (CodedWorkflow.cs, WorkflowRunnerService.cs)
|
|
18
|
+
│ └── .entities/ # Compiled Data Fabric entity assemblies (DataService.<Namespace>.dll) per install signature. Regenerated on demand — do not edit.
|
|
19
|
+
├── .project/ # Project metadata
|
|
20
|
+
│ ├── JitCustomTypesSchema.json # JIT-compiled custom type definitions
|
|
21
|
+
│ └── PackageBindingsMetadata.json
|
|
22
|
+
├── .screenshots/ # Activity screenshots (auto-generated)
|
|
23
|
+
├── .settings/ # Project-level settings
|
|
24
|
+
├── .autopilot/ # Autopilot service specific files
|
|
25
|
+
│ └── skills/ # Project-specific Autopilot skills
|
|
26
|
+
└── .storage/ # Activity resource storage (bucket-organized)
|
|
27
|
+
├── .design/ # Design-time only resources (NOT packed into published package)
|
|
28
|
+
│ └── <bucket>/ # Named bucket to prevent conflicts
|
|
29
|
+
└── .runtime/ # Runtime resources (packed into published NuPkg)
|
|
30
|
+
└── <bucket>/ # Named bucket with resource files
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
### Coded-Only Elements
|
|
34
|
+
|
|
35
|
+
- `.cs` files with `[Workflow]`/`[TestCase]` attributes — executable coded automations
|
|
36
|
+
- `.cs.json` metadata files — auto-generated by Studio for each coded workflow/test case (do not create manually)
|
|
37
|
+
- `.codedworkflows/` — auto-generated support files (only when project has `.cs` files)
|
|
38
|
+
- `.local/.codedworkflows/` — auto-generated `CodedWorkflow.cs`, etc.
|
|
39
|
+
- `.variations/` — data-driven test parameters (Tests projects only)
|
|
40
|
+
|
|
41
|
+
## project.json Key Fields
|
|
42
|
+
|
|
43
|
+
```json
|
|
44
|
+
{
|
|
45
|
+
"name": "MyProject",
|
|
46
|
+
"description": "",
|
|
47
|
+
"main": "Main.cs",
|
|
48
|
+
"dependencies": {
|
|
49
|
+
"UiPath.System.Activities": "[24.12.1]"
|
|
50
|
+
},
|
|
51
|
+
"schemaVersion": "4.0",
|
|
52
|
+
"studioVersion": "25.0.0.0",
|
|
53
|
+
"projectVersion": "1.0.0",
|
|
54
|
+
"runtimeOptions": {
|
|
55
|
+
"autoDispose": false,
|
|
56
|
+
"netFramework": { "targetFramework": "net6.0" },
|
|
57
|
+
"isPausable": true,
|
|
58
|
+
"isAttended": false,
|
|
59
|
+
"requiresUserInteraction": false
|
|
60
|
+
},
|
|
61
|
+
"designOptions": {
|
|
62
|
+
"projectProfile": "Developement",
|
|
63
|
+
"outputType": "Process",
|
|
64
|
+
"libraryOptions": {
|
|
65
|
+
"privateWorkflows": []
|
|
66
|
+
}
|
|
67
|
+
},
|
|
68
|
+
"expressionLanguage": "VisualBasic",
|
|
69
|
+
"entryPoints": [
|
|
70
|
+
{
|
|
71
|
+
"filePath": "Main.cs",
|
|
72
|
+
"uniqueId": "2f510550-3882-4340-9239-53a24d0717f6",
|
|
73
|
+
"input": [],
|
|
74
|
+
"output": []
|
|
75
|
+
}
|
|
76
|
+
],
|
|
77
|
+
"targetFramework": "Portable"
|
|
78
|
+
}
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
### Important Fields
|
|
82
|
+
|
|
83
|
+
| Field | Description |
|
|
84
|
+
|-------|-------------|
|
|
85
|
+
| `name` | Project name (used in package output) |
|
|
86
|
+
| `main` | Entry point workflow file (relative path) |
|
|
87
|
+
| `dependencies` | NuGet package dependencies with version constraints |
|
|
88
|
+
| `expressionLanguage` | `CSharp` or `VisualBasic` — determines expression syntax. Default `VisualBasic`. Immutable after creation (decide at init) |
|
|
89
|
+
| `designOptions.outputType` | `Process`, `Library`, or `Tests` |
|
|
90
|
+
| `targetFramework` | `Portable` (Cross-platform .NET 6+, the default for new projects), `Windows` (.NET 6 Windows-only — only for a demonstrated Windows-only need), or `Legacy` (Windows - Legacy, .NET Framework 4.6.1). Set explicitly at init; omitting `--target-framework` silently yields `Windows`, so always pass it |
|
|
91
|
+
| `entryPoints` | Per-workflow metadata: filePath, uniqueId, input/output definitions (**Process projects only** — Tests and Library projects use empty `[]`) |
|
|
92
|
+
|
|
93
|
+
## Rules
|
|
94
|
+
|
|
95
|
+
1. **Use CLI for dependencies**: Always use `uip rpa packages install` to add/update dependencies. Do not manually edit `dependencies` in `project.json`.
|
|
96
|
+
2. **Do not edit `.local/`**: This is a cache directory managed by the build system.
|
|
97
|
+
3. **`main` entry point**: The default entrypoint that gets run if not specified otherwise. `entryPoints` array is only populated for **Process** projects — Tests and Library projects leave it empty (`[]`).
|
|
98
|
+
4. **`--project-dir` awareness**: All `uip rpa` commands default to the current working directory. If the CWD is not the project root, pass `--project-dir "{projectRoot}"` explicitly.
|
|
99
|
+
5. **Creating new projects**: Use `uip rpa init`. See [environment-setup.md](environment-setup.md).
|
|
100
|
+
|
|
101
|
+
## Common Activity Packages
|
|
102
|
+
|
|
103
|
+
| Package ID | Description | Key Activities |
|
|
104
|
+
|------------|-------------|----------------|
|
|
105
|
+
| `UiPath.System.Activities` | Core system activities | Assign, If, ForEach, While, Invoke Workflow, Log Message, Delay |
|
|
106
|
+
| `UiPath.UIAutomation.Activities` | UI interaction | Click, Type Into, Get Text, Open Browser, Use Application/Browser |
|
|
107
|
+
| `UiPath.Excel.Activities` | Excel automation | Read Range, Write Range, Read Cell, Write Cell, Format Range |
|
|
108
|
+
| `UiPath.Mail.Activities` | Email operations | Send Mail, Get Mail, Save Attachments, Forward Mail |
|
|
109
|
+
| `UiPath.Database.Activities` | Database operations | Execute Query, Execute Non Query, Connect, Disconnect |
|
|
110
|
+
| `UiPath.WebAPI.Activities` | HTTP/REST calls | HTTP Request, Deserialize JSON, Serialize JSON |
|
|
111
|
+
| `UiPath.PDF.Activities` | PDF processing | Read PDF Text, Read PDF with OCR, Extract Data From PDF |
|
|
112
|
+
| `UiPath.Word.Activities` | Word automation | Read Text, Replace Text, Insert Image, Export to PDF |
|
|
113
|
+
| `UiPath.Testing.Activities` | Testing and assertions | Verify Expression, Verify Are Equal, Generate Test Data |
|
|
114
|
+
| `UiPath.Presentations.Activities` | PowerPoint automation | Add Slide, Replace Text, Insert Image |
|
|
115
|
+
| `UiPath.IntegrationService.Activities` | Integration Service connector runtime | Generic connector activities for Salesforce, ServiceNow, HubSpot, etc. |
|
|
116
|
+
| `UiPath.Cryptography.Activities` | Encryption/hashing | Encrypt Text, Decrypt Text, Hash File |
|
|
117
|
+
|
|
118
|
+
## Version Constraints
|
|
119
|
+
|
|
120
|
+
Dependencies use NuGet version constraint syntax:
|
|
121
|
+
|
|
122
|
+
| Syntax | Meaning |
|
|
123
|
+
|--------|---------|
|
|
124
|
+
| `[1.0.0]` | Exact version 1.0.0 |
|
|
125
|
+
| `[1.0.0, )` | Version 1.0.0 or higher |
|
|
126
|
+
| `[1.0.0, 2.0.0)` | Between 1.0.0 (inclusive) and 2.0.0 (exclusive) |
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
# UI Elements Interaction Guide
|
|
2
|
+
|
|
3
|
+
How to *drive* a captured UI element correctly — type-specific handling that selector capture alone does not cover.
|
|
4
|
+
|
|
5
|
+
This guide assumes the target's selector is already captured; it covers interaction technique, not capture.
|
|
6
|
+
|
|
7
|
+
Patterns are grouped by scope: technology-specific controls first (web), then cross-technology patterns.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## Web Controls (`webctrl`)
|
|
12
|
+
|
|
13
|
+
Applies to browser elements — elements whose captured selector uses the `webctrl` tag.
|
|
14
|
+
|
|
15
|
+
### Date and formatted date-time inputs
|
|
16
|
+
|
|
17
|
+
Date / formatted date-time inputs must be driven with a **key-event input method**, so the value typed must match the field's **displayed** format. Detect that format, format the value to match, then type it. Try typing WITHOUT emptying the field first; keep emptying as a fallback.
|
|
18
|
+
|
|
19
|
+
1. **Use a key-event input method — type the displayed format, not the ISO `value`.** In scope: native `<input type="date">` inputs, and framework date-time pickers that *look* like a date field but are built from a more complex structure (divs/spans or several `<input>` parts). Their displayed format and canonical `value` are frequently **different**: a native `<input type="date">` stores `2026-06-19` but renders `06/19/2026` (en-US locale). Drive them with **Chromium API (`DebuggerApi`)** (preferred for browsers) or **Hardware Events** — these dispatch real key events into the control's segmented / composite UI, so the typed string must match the **rendered** format (e.g. en-US native date input → `MM/DD/YYYY`), NOT the ISO value. You must therefore detect how the field is actually printed — step 2.
|
|
20
|
+
|
|
21
|
+
**Do NOT use Simulate for date inputs.** Simulate only sets the element's underlying value; it does not dispatch the `input` / `change` events the control's validation and framework data-binding depend on, so the date often fails to register or commit.
|
|
22
|
+
|
|
23
|
+
2. **Detect the displayed format at design time — never assume, and never trust `value`.** Resolve it *while authoring* — during capture, when the snapshot's element refs (`e5`, …) are live — and bake the result into the workflow. Do not add a runtime read for a format fixed for the target app. This read determines the value to type; it is NOT selector construction (that stays the selector-capture step's job).
|
|
24
|
+
|
|
25
|
+
Read from the live element with one of three strategies — **stop at the first that yields the displayed format**. Ordered by typical web reliability; the raw attribute is **last** because `value` reports the canonical/ISO form, which often does not match what is rendered:
|
|
26
|
+
|
|
27
|
+
| # | Strategy | Use when | Trade-off |
|
|
28
|
+
|---|----------|----------|-----------|
|
|
29
|
+
| 1 | **Inject JavaScript** — interact CLI browser-eval verb, element-scoped (`(el) => …`). Read `type`, `placeholder`, a framework picker's sub-input values / internal state, shadow DOM. For a **native date input** the rendered segments are not in the DOM (`value` is ISO) and a locale guess (`navigator.language` / `Intl`) only reflects the *content-language* preference — which can differ from the browser/OS **UI locale** that actually renders the picker — so treat it as a hint and confirm with strategy 2. | Reliable for framework pickers whose format is exposed in the DOM (`placeholder` / sub-input values). | Web only; fragile to page changes. Locale guess may not match a native date picker. |
|
|
30
|
+
| 2 | **Screenshot** — interact CLI screenshot verb on the element/window; read the rendered placeholder/value visually. | JS cannot derive it (canvas-rendered, opaque widget), or to read/confirm the rendered order for a **native date input** (the reliable read — strategy 1's locale guess can diverge). | Non-deterministic (visual interpretation). |
|
|
31
|
+
| 3 | **Read the attribute** — interact CLI attribute-read verbs (`get <ref> <attribute>` for one; `get-all <ref>` to dump all). A `placeholder` (e.g. `MM/DD/YYYY`) is a good explicit hint **when present**. | A `placeholder` / explicit format attribute exists. | Deterministic, but `value` and the accessibility value are the **canonical/ISO** form — they may NOT match the displayed format. Never infer the typing format from `value` alone for a native date input. |
|
|
32
|
+
|
|
33
|
+
**Validate the command before running it.** Verb names, positional-argument order, and flags are owned by the package — confirm each against `{PROJECT_DIR}/.local/docs/packages/UiPath.UIAutomation.Activities/references/cli-reference.md` before use. Do NOT author these commands from memory; names and argument order may differ from this table.
|
|
34
|
+
|
|
35
|
+
3. **Format the date string to match** the resolved displayed format before typing — e.g. for an en-US native date input, convert ISO `2026-07-01` → `07/01/2026`.
|
|
36
|
+
4. **Type the formatted value — try WITHOUT emptying the field first** (`NTypeInto` property `EmptyField` left false). Emptying is not forbidden: if the field keeps stale/residual content or the value is not replaced cleanly, retry with the field emptied (`EmptyField=true`). Confirm the exact property name/default in `{PROJECT_DIR}/.local/docs/packages/UiPath.UIAutomation.Activities/activities/NTypeInto.md`.
|
|
37
|
+
|
|
38
|
+
Why try without emptying first: native date inputs and framework date-time pickers maintain a segmented / internal value. Clearing (`EmptyField`, or `Ctrl+A`+`Delete`) can leave the control in a partial state or trip its validation, so typing the correctly-formatted value over the field usually lets the control's own input handling replace the content cleanly. If it does not — stale value remains, or the input rejects the overlaid text — empty the field and type again.
|
|
39
|
+
|
|
40
|
+
```xml
|
|
41
|
+
<uix:NTypeInto DisplayName="Type Invoice Date"
|
|
42
|
+
Text="[formattedDate]"
|
|
43
|
+
EmptyField="False"
|
|
44
|
+
sap2010:WorkflowViewState.IdRef="NTypeInto_1" />
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
> Every selector reaches an activity through `Target.FromSelector(...)`. A bare string
|
|
48
|
+
> hits the `string`-typed overload, which reads it as an **Object Repository name** and
|
|
49
|
+
> throws `NodeNotFoundException` at run time — see the cheat sheet's § Targets.
|
|
50
|
+
|
|
51
|
+
```csharp
|
|
52
|
+
// First attempt: EmptyField false → field is not cleared before typing.
|
|
53
|
+
// Fallback if content isn't replaced cleanly: set EmptyField true.
|
|
54
|
+
formScreen.TypeInto(Target.FromSelector("<webctrl id='invoiceDate' tag='INPUT' />"), formattedDate);
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## All UI Technologies
|
|
60
|
+
|
|
61
|
+
Patterns that apply to any captured control regardless of UI stack (web, desktop, Java, etc.).
|
|
62
|
+
|
|
63
|
+
### Dropdowns, lists, and comboboxes
|
|
64
|
+
|
|
65
|
+
Whether `SelectItem` (`NSelectItem`) can drive a control does **not** depend on its UI technology,
|
|
66
|
+
tag, or role — a native HTML `<select>`, a WinForms/WPF combo box, a Java list, a SAP dropdown, and
|
|
67
|
+
a div/ARIA combobox are all candidates. **Don't classify it from the captured selector — query the
|
|
68
|
+
control's `items` attribute for its selectable options** (the read verb is in
|
|
69
|
+
`{PROJECT_DIR}/.local/docs/packages/UiPath.UIAutomation.Activities/references/cli-reference.md`):
|
|
70
|
+
|
|
71
|
+
- **`items` lists options** → the control is selectable; `SelectItem` will drive it — pass one of the
|
|
72
|
+
listed values. No need to capture the individual option elements or open the list first.
|
|
73
|
+
- **`items` empty/absent** → not a real option-list control. Fall back to click-to-open + click the
|
|
74
|
+
option (capture both as OR targets), or `TypeInto` for type-ahead / filter combos.
|
|
75
|
+
|
|
76
|
+
Read the `items` attribute to learn the valid values, and the `selecteditem` / `selecteditems`
|
|
77
|
+
attribute to confirm the result after selecting (the cli-reference above shows how to read them).
|
|
78
|
+
|
|
79
|
+
The rule is general: verified against a control with no native `<select>` (a Lightning picklist
|
|
80
|
+
rendered as a `role="combobox"` button) and applies identically to desktop, Java, and SAP option
|
|
81
|
+
lists — so an option-list control needs **no option-element capture at all**.
|
|
82
|
+
|
|
83
|
+
### Buttons disabled during async operations
|
|
84
|
+
|
|
85
|
+
A button can be present and matched by its selector yet `disabled` while the application validates a form, loads, or refreshes data.
|
|
86
|
+
|
|
87
|
+
This is distinct from a late-appearing target (one that *appears* after a delay): the UIA activity's target-finding retry already handles appearance. Retry does NOT cover enabled state — the activity finds the disabled button immediately and clicks a dead control. Check App State does not help either: it waits for an element to appear/disappear, not to become enabled.
|
|
88
|
+
|
|
89
|
+
Mitigation (XAML): the `NClick` activity exposes `DelayBefore`/`DelayAfter` directly.
|
|
90
|
+
|
|
91
|
+
- Use `DelayBefore` only when the button has an observable disabled→enabled transition driven by validation / load / refresh.
|
|
92
|
+
- Keep it as small as reliably works — it is a fixed wait that runs on every execution. It raises the odds the button is enabled at click time; it is not a guarantee.
|
|
93
|
+
|
|
94
|
+
```xml
|
|
95
|
+
<uix:NClick DisplayName="Click Submit (form validates first)"
|
|
96
|
+
DelayBefore="1"
|
|
97
|
+
sap2010:WorkflowViewState.IdRef="NClick_1" />
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
**Coded API: `ClickOptions` has no `DelayBefore`/`DelayAfter`** — verified against a real generated `coded-api.md` (26.10.x); only `TargetOptions` (read-only ops) and `VerifyOptions` carry those fields, `ClickOptions`/`TypeIntoOptions` do not. Use `ClickOptions.VerifyOptions` instead — the platform's built-in verify-and-retry (`Mode`/`Retry`/`Timeout`), which retries the click itself rather than gambling on a fixed pre-delay:
|
|
101
|
+
|
|
102
|
+
```csharp
|
|
103
|
+
app.Click(Target.FromSelector("<webctrl tag='BUTTON' aria-label='Submit' />"), new ClickOptions
|
|
104
|
+
{
|
|
105
|
+
VerifyOptions = new VerifyOptions { Target = confirmationAnchor, Mode = NVerifyMode.Appears, Retry = true, Timeout = 10 }
|
|
106
|
+
});
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
See `../reliability-guide.md` § 2. Confirm property names, defaults, and time units against the installed `coded/coded-api.md` — do not author UIA property surfaces from memory (SKILL.md Rule 21).
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
# Validation & Fixing Guide
|
|
2
|
+
|
|
3
|
+
Fix-one-thing discipline, the validation iteration loop, smoke test procedure, and RPA-specific fix procedures.
|
|
4
|
+
|
|
5
|
+
## On demand: List Analyzer Rules
|
|
6
|
+
|
|
7
|
+
`validate` and `build` already enforce the project's enabled Workflow Analyzer rules — violations come back with the rule ID, severity, and recommendation, so the normal authoring loop needs **no** rule pre-fetch. Do NOT run `analyzer-rules list` as an authoring prerequisite: the unscoped call enumerates every rule across every package and can take a minute or more, and most of its output never affects the code you write.
|
|
8
|
+
|
|
9
|
+
Run it **only on demand**:
|
|
10
|
+
|
|
11
|
+
1. The **user asks** about the project's best-practice / analyzer rules ("what rules does this project enforce?", "list the analyzer rules", "why is UI-REL-001 firing?").
|
|
12
|
+
2. **Repeated violations of the same rule family** across `validate`/`build` iterations — reading the full rule set (scoped, see below) lets you author against it instead of fixing violations one by one.
|
|
13
|
+
|
|
14
|
+
```bash
|
|
15
|
+
uip rpa analyzer-rules list --project-dir "<PROJECT_DIR>" --scope "<Activity|Workflow|Coded Workflow|Project>" --output json
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
Prefer a `--scope` matching what you're authoring — scoped calls return in seconds; unscoped can take a minute+. Apply `error` and `warning` rules; `info` rules are advisory. If you do consult the rules and then add or update a NuGet package, the package-shipped (`MA-*`) rules may have changed with the dependency set.
|
|
19
|
+
|
|
20
|
+
For coded (`.cs`) workflow files, the four built-in `Coded Workflow`-scope rules (ST-NMG-017, ST-DBP-010, ST-REL-001, ST-USG-017) are all Error severity and enforced by `analyze`, `build`, and `pack` — triggers and fixes: [coded/coding-guidelines.md § Coded Workflow Analyzer Rules](coded/coding-guidelines.md#coded-workflow-analyzer-rules).
|
|
21
|
+
|
|
22
|
+
Rule prefixes and full schema: [cli-reference.md § analyzer-rules list](cli-reference.md).
|
|
23
|
+
|
|
24
|
+
## Fix One Thing at a Time
|
|
25
|
+
|
|
26
|
+
When an error occurs, identify the root cause, fix **only** that one thing, and re-run.
|
|
27
|
+
|
|
28
|
+
- Never bundle a speculative improvement with the actual fix.
|
|
29
|
+
- Changing two things at once makes it impossible to verify which change resolved the issue or whether the extra change introduced a new one.
|
|
30
|
+
- One fix per iteration, re-run, verify.
|
|
31
|
+
|
|
32
|
+
## Validation Iteration Loop
|
|
33
|
+
|
|
34
|
+
Phase 0 — one `build` before any `validate`, if the project has never been built. Phase 1 — per-file `validate` while converging on a failure. Phase 2 — one project-level `build` per edit session.
|
|
35
|
+
|
|
36
|
+
**Default to writing the whole file and building once.** `build` is the slow step and the compiler names the offending file and line, so a single build over a complete file beats a build per activity. Per-file `validate` earns its place as the fast iterator *after* something fails, not as a gate between every edit on the green path. Fall back to adding one activity at a time only when two consecutive fixes fail to move the error — that is debugging, and it is worth the round-trips only then.
|
|
37
|
+
|
|
38
|
+
```
|
|
39
|
+
PHASE 0 — seed the generated partial (only if .local/.codedworkflows/CodedWorkflow.cs is absent):
|
|
40
|
+
1. uip rpa build "<PROJECT_DIR>" --log-level Warn --output json
|
|
41
|
+
# Generates .local/.codedworkflows/CodedWorkflow.cs. Until it exists, `validate`
|
|
42
|
+
# compiles without it and reports the base class and its members as missing.
|
|
43
|
+
2. Treat compile errors here as real; treat the Phase 0 symbols below as false positives
|
|
44
|
+
ONLY before this build has run.
|
|
45
|
+
|
|
46
|
+
PHASE 1 — validate-clean (per-file):
|
|
47
|
+
FOR each file created or edited in this session:
|
|
48
|
+
REPEAT:
|
|
49
|
+
1. uip rpa validate --file-path "<FILE>" --project-dir "<PROJECT_DIR>" --output json
|
|
50
|
+
2. IF validate has errors -> fix one root cause, GOTO 1
|
|
51
|
+
3. EXIT inner loop when validate is clean
|
|
52
|
+
|
|
53
|
+
PHASE 2 — build-clean (per-project, once per edit session):
|
|
54
|
+
REPEAT:
|
|
55
|
+
1. uip rpa build "<PROJECT_DIR>" --log-level Warn --output json
|
|
56
|
+
2. IF build has errors -> identify offending file from build output
|
|
57
|
+
a. uip rpa validate --file-path "<OFFENDER>" --project-dir "<PROJECT_DIR>" --output json # cheap targeted re-check
|
|
58
|
+
b. fix one root cause, GOTO 1
|
|
59
|
+
3. EXIT to Smoke Test
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
**Never "fix" a missing `CodedWorkflow`, `Log`, `Delay`, or `uiAutomation`.** None of them exist in your source: `build` generates them into the `.local/.codedworkflows/CodedWorkflow.cs` partial. Run `validate` on a project that has not been built and it compiles without that partial, so all of them resolve to nothing and the errors cascade (`CodedWorkflow` not found, `Log` not found, `Cannot infer var (…) = await`). The file is correct — the validator is missing half the compilation. Run Phase 0 and re-check before touching the code. The tempting "fixes" here all make it worse: adding usings for symbols that are not in any package, or deleting the `: CodedWorkflow` base class, which breaks a file that would have built cleanly.
|
|
63
|
+
|
|
64
|
+
**Why both phases.** `validate` is static analysis: catches missing references, analyzer rules, schema violations. `build` is the compiler: catches **unknown member names**, **invalid enum values**, and **member resolution failures**. `validate` returns "no diagnostics found" for these; `build` flags them at compile time. Per-file `validate` plus one end-of-session `build` covers both error classes — trusting only `validate` ships broken workflows.
|
|
65
|
+
|
|
66
|
+
**Target the specific file:** `validate --file-path` validates only the file you changed (faster than whole-project). `build` is project-scoped (no `--file-path`); when it errors, the output names the offending file — re-run `validate --file-path` on it as part of Phase 2's fix loop.
|
|
67
|
+
|
|
68
|
+
**5-attempt cap per loop** — 5 attempts for each file's Phase 1 `validate` loop; a separate 5 attempts for the Phase 2 `build` loop. After a loop exhausts its budget, present the remaining errors to the user. They may require domain knowledge or environment-specific fixes. Each loop's counter resets when you start a new loop (e.g., new file, new user prompt, or resuming after user input).
|
|
69
|
+
|
|
70
|
+
### Rules
|
|
71
|
+
|
|
72
|
+
1. DO NOT stop until all errors are resolved (or cannot be resolved automatically).
|
|
73
|
+
2. DO NOT obsess on one error -- if it cannot be resolved, skip it, continue, and defer to the user through an informative, step-by-step message at the end.
|
|
74
|
+
3. DO NOT skip validation steps.
|
|
75
|
+
4. DO NOT assume edits worked without checking.
|
|
76
|
+
5. DO NOT bundle multiple fixes in one iteration. Fix the root cause, re-run, verify. Never add a speculative change alongside the actual fix -- changing two things at once makes it impossible to tell which one resolved the issue or whether the extra change introduced a new problem.
|
|
77
|
+
|
|
78
|
+
See [cli-reference.md](cli-reference.md) for full `validate` and `run` command documentation.
|
|
79
|
+
|
|
80
|
+
## Project Build Verification (Required Before Returning a Project)
|
|
81
|
+
|
|
82
|
+
Every project returned to the user must compile. Phase 2 of the iteration loop above is this gate — when Phase 2 exits clean, the gate is satisfied. The standalone command below also satisfies it (for example, when re-verifying after a small fix outside an iteration loop):
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
uip rpa build "<PROJECT_DIR>" --log-level Warn --output json
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
`validate` is static analysis and misses compile-time failures: unknown member names, invalid enum values, member resolution failures. If `build` fails, apply the Phase 2 fix loop (fix one root cause, re-run, cap at 5 attempts). A successful `run` smoke test substitutes for `build` — `run` compiles internally. Prefer the `run --skip-build` form when `build` has just passed (see Smoke Test below).
|
|
89
|
+
|
|
90
|
+
When you see "no diagnostics found" from `validate`, you have not validated the file. Run `build` next.
|
|
91
|
+
|
|
92
|
+
## Smoke Test
|
|
93
|
+
|
|
94
|
+
`validate` (static analysis) and `run` (runtime compilation) use different validation paths. Some errors -- such as invalid enum values on activity properties -- pass static validation but fail at runtime. Always treat the smoke test as a critical validation step, not just an optional extra.
|
|
95
|
+
|
|
96
|
+
After reaching 0 validation errors AND a clean project-level build (Phase 2), run the workflow to catch runtime errors (wrong credentials, missing files, logic bugs) that static validation cannot detect. Use `--skip-build` because the project has just been built clean — default `run` re-validates and re-builds internally, repeating ~10s of compilation:
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
# Run with default arguments (post-build, skip the redundant rebuild):
|
|
100
|
+
uip rpa run --file-path "<FILE>" --skip-build --output json
|
|
101
|
+
# Run with input arguments (repeat --input-arguments per key; = string, := raw JSON):
|
|
102
|
+
uip rpa run --file-path "<FILE>" --skip-build --input-arguments key=value --output json
|
|
103
|
+
# Run with verbose logging for debugging:
|
|
104
|
+
uip rpa run --file-path "<FILE>" --skip-build --log-level Verbose --output json
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
Use bare `run` (without `--skip-build`) whenever the build artifact may be stale: **(a)** no recent project-level `build` has been performed, OR **(b)** any file has been edited between the last successful `build` and this `run`. `--skip-build` executes the existing compiled artifact, so any post-build edit is silently ignored until a fresh `build` runs.
|
|
108
|
+
|
|
109
|
+
**When to run:**
|
|
110
|
+
1. Workflow has no compilation errors but you want to verify runtime behavior
|
|
111
|
+
2. Workflow involves file I/O, API calls, or data transformations that could fail at runtime
|
|
112
|
+
3. User specifically asks to test the workflow
|
|
113
|
+
|
|
114
|
+
**When NOT to run:**
|
|
115
|
+
1. Workflow has side effects (sends emails, modifies databases, calls external APIs) -- warn the user first
|
|
116
|
+
2. Workflow requires interactive input (UI automation, attended triggers)
|
|
117
|
+
3. Compilation errors still exist (fix those first)
|
|
118
|
+
|
|
119
|
+
**If runtime errors occur:** Analyze the output, apply the fix-one-thing rule, and loop back to fix. Stop after 2 failed runtime retry attempts and present the user with error details, a suggested fix, and options:
|
|
120
|
+
|
|
121
|
+
```
|
|
122
|
+
Workflow execution failed after 2 retry attempts.
|
|
123
|
+
|
|
124
|
+
**Error Details:** <specific error message and location>
|
|
125
|
+
**Suggested Fix:** <analysis of what went wrong>
|
|
126
|
+
**Next Steps:** Would you like me to:
|
|
127
|
+
A) <recommended fix approach>
|
|
128
|
+
B) <alternative approach>
|
|
129
|
+
C) <user-driven approach>
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
## RPA-Specific Fix Procedures
|
|
135
|
+
|
|
136
|
+
### Package Error Resolution
|
|
137
|
+
|
|
138
|
+
```
|
|
139
|
+
Read: file_path="{projectRoot}/project.json" -> check current dependencies
|
|
140
|
+
|
|
141
|
+
Bash: uip rpa packages install --packages id=UiPath.Excel.Activities```
|
|
142
|
+
|
|
143
|
+
Omit `version` to automatically resolve the latest compatible version (preferred — gets newest docs and features). Only pin a specific version when you have a reason to (e.g., known compatibility constraint).
|
|
144
|
+
|
|
145
|
+
**If `packages install` fails:**
|
|
146
|
+
- **Package not found**: Verify the exact package ID — check spelling, use `uip rpa activities find` to discover the correct package name from an activity's assembly
|
|
147
|
+
- **Network/feed error**: The user may need to check their NuGet feed configuration in Studio settings
|