@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,397 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: Jira
|
|
3
|
+
version: 1.0.0
|
|
4
|
+
description: Jira projects, issues, sprints, comments, and transitions via Integration Service API.
|
|
5
|
+
icon: jira
|
|
6
|
+
color: 0052CC
|
|
7
|
+
type: skill
|
|
8
|
+
assets:
|
|
9
|
+
integration_services:
|
|
10
|
+
key: uipath-atlassian-jira
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# Jira Integration
|
|
14
|
+
|
|
15
|
+
Execute Jira operations through UiPath Integration Service.
|
|
16
|
+
|
|
17
|
+
## 🔌 Connection Details
|
|
18
|
+
|
|
19
|
+
{ConnectionDetails}
|
|
20
|
+
|
|
21
|
+
## ⚠️ CRITICAL SAFETY RULE
|
|
22
|
+
|
|
23
|
+
> **NEVER execute write operations (POST/PUT/DELETE) without explicit user permission!**
|
|
24
|
+
|
|
25
|
+
Write operations will create real issues, comments, or modify actual Jira data.
|
|
26
|
+
|
|
27
|
+
**Safe (no permission needed):** GET requests - listing projects, issues, comments, searching
|
|
28
|
+
|
|
29
|
+
**Requires explicit permission:** Creating/updating issues, adding comments, transitioning issues, modifying fields
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## Tool
|
|
34
|
+
|
|
35
|
+
Use `SendUiPathRequest` to execute all Jira API calls.
|
|
36
|
+
|
|
37
|
+
**API usage:**
|
|
38
|
+
elementInstanceId can be founded in 'Connection Details' section.
|
|
39
|
+
Top is high priority id, use others only if unable to use top one.
|
|
40
|
+
|
|
41
|
+
```
|
|
42
|
+
elements_/v3/element/instances/{{elementInstanceId}}/http-request
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
**No connection id or all fails**
|
|
48
|
+
Note: use only as a last resort:
|
|
49
|
+
```
|
|
50
|
+
GET connections_/api/v1/Connectors/uipath-atlassian-jira/connection
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
## How It Works
|
|
54
|
+
|
|
55
|
+
Integration Service acts as an **authenticated proxy** to Jira's REST API. It:
|
|
56
|
+
1. Handles OAuth authentication automatically
|
|
57
|
+
2. Forwards your request to Jira's API **in Jira's native format**
|
|
58
|
+
3. Returns Jira's response directly
|
|
59
|
+
|
|
60
|
+
## ⚠️ CRITICAL: Issue Links Shown to Users
|
|
61
|
+
|
|
62
|
+
**NEVER present `api.atlassian.com/ex/jira/...` links to users.** These are internal API URLs returned in response bodies (e.g. `issue.self`). They are not human-browsable.
|
|
63
|
+
|
|
64
|
+
**ALWAYS construct browse links using the instance's `baseUrl`:**
|
|
65
|
+
```
|
|
66
|
+
{baseUrl}/browse/{issueKey}
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
**Example:**
|
|
70
|
+
- ❌ `https://api.atlassian.com/ex/jira/2e10c12a-.../rest/api/2/issue/3024715` (internal API URL — never show this)
|
|
71
|
+
- ✅ `https://uipath.atlassian.net/browse/PILOT-3763` (human-friendly browse URL — always use this)
|
|
72
|
+
|
|
73
|
+
To get the `baseUrl` for the connected instance, call `GET /serverInfo` — the `baseUrl` field contains the correct hostname (e.g. `https://uipath.atlassian.net`).
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
## ⚠️ CRITICAL: URL Path Rules
|
|
78
|
+
|
|
79
|
+
**TOP PRIORITY - Always follow this rule:**
|
|
80
|
+
|
|
81
|
+
**When using UiPath connector via `http-request`:**
|
|
82
|
+
- ✅ OMIT `/rest/api/3` prefix
|
|
83
|
+
- Use paths like: `/project`, `/issue/{key}`, `/search/jql`
|
|
84
|
+
- Integration Service automatically adds the API prefix
|
|
85
|
+
|
|
86
|
+
|
|
87
|
+
### Examples
|
|
88
|
+
|
|
89
|
+
**✅ CORRECT (UiPath connector):**
|
|
90
|
+
```json
|
|
91
|
+
{
|
|
92
|
+
"url": "/project",
|
|
93
|
+
"url": "/issue/PROJ-123",
|
|
94
|
+
"url": "/search/jql"
|
|
95
|
+
}
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
**❌ WRONG (UiPath connector):**
|
|
99
|
+
```json
|
|
100
|
+
{
|
|
101
|
+
"url": "/rest/api/3/project", // DON'T include prefix
|
|
102
|
+
"url": "/rest/api/3/issue/PROJ-123", // Will cause 200 OK with 401 error
|
|
103
|
+
"url": "/rest/api/3/search/jql" // Integration Service adds this
|
|
104
|
+
}
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
**Use Jira's REST API format** for:
|
|
108
|
+
- Endpoints: `/project`, `/issue/{issueIdOrKey}`, `/search/jql`
|
|
109
|
+
- Query parameters: `?jql=project=PROJ&maxResults=50`
|
|
110
|
+
- Request body: Jira's JSON schema
|
|
111
|
+
|
|
112
|
+
⚠️ **Important:** The legacy `/search` endpoint is deprecated (replaced by `/search/jql` after August 1, 2025). Always use `/search/jql` for JQL queries.
|
|
113
|
+
|
|
114
|
+
📖 **References:**
|
|
115
|
+
- [Jira Cloud REST API v3 Docs](https://developer.atlassian.com/cloud/jira/platform/rest/v3/)
|
|
116
|
+
- [JQL Cheat Sheet](https://www.atlassian.com/software/jira/guides/jql/cheat-sheet#advanced-search) - For JQL syntax and troubleshooting
|
|
117
|
+
- For Integration Service details, see the **UiPath Integrations** skill
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## Quick Reference
|
|
122
|
+
|
|
123
|
+
| Task | Endpoint | Type |
|
|
124
|
+
|------|----------|------|
|
|
125
|
+
| List projects | `/project` | GET |
|
|
126
|
+
| Get project | `/project/{projectIdOrKey}` | GET |
|
|
127
|
+
| Search issues (JQL) | `/search/jql` | GET/POST |
|
|
128
|
+
| Get issue | `/issue/{issueIdOrKey}` | GET |
|
|
129
|
+
| Create issue | `/issue` | POST ⚠️ |
|
|
130
|
+
| Update issue | `/issue/{issueIdOrKey}` | PUT ⚠️ |
|
|
131
|
+
| Delete issue | `/issue/{issueIdOrKey}` | DELETE ⚠️ |
|
|
132
|
+
| Get issue comments | `/issue/{issueIdOrKey}/comment` | GET |
|
|
133
|
+
| Add comment | `/issue/{issueIdOrKey}/comment` | POST ⚠️ |
|
|
134
|
+
| Get transitions | `/issue/{issueIdOrKey}/transitions` | GET |
|
|
135
|
+
| Transition issue | `/issue/{issueIdOrKey}/transitions` | POST ⚠️ |
|
|
136
|
+
| Assign issue | `/issue/{issueIdOrKey}/assignee` | PUT ⚠️ |
|
|
137
|
+
| Get myself | `/myself` | GET |
|
|
138
|
+
| Search users | `/user/search` | GET |
|
|
139
|
+
| Get issue types | `/issuetype` | GET |
|
|
140
|
+
| Get priorities | `/priority` | GET |
|
|
141
|
+
| Get statuses | `/status` | GET |
|
|
142
|
+
| Get fields | `/field` | GET |
|
|
143
|
+
| Get boards (Agile) | `/board` | GET |
|
|
144
|
+
| Get sprints | `/board/{boardId}/sprint` | GET |
|
|
145
|
+
| Get issue create metadata | `/issue/createmeta` | GET |
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
149
|
+
## Executing API Calls
|
|
150
|
+
|
|
151
|
+
Use `SendUiPathRequest` with the following structure:
|
|
152
|
+
|
|
153
|
+
```typescript
|
|
154
|
+
SendUiPathRequest({
|
|
155
|
+
method: "POST",
|
|
156
|
+
path: "elements_/v3/element/instances/{{elementInstanceId}}/http-request",
|
|
157
|
+
body: {
|
|
158
|
+
method: "GET", // Jira HTTP method
|
|
159
|
+
url: "/project", // Jira endpoint
|
|
160
|
+
query: { ... }, // Query params (optional)
|
|
161
|
+
body: "..." // Request body as string (optional)
|
|
162
|
+
}
|
|
163
|
+
})
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
**Request Body Fields:**
|
|
167
|
+
- `method`: HTTP method for Jira (GET, POST, PUT, DELETE)
|
|
168
|
+
- `url`: Jira API endpoint (e.g., `/project`, `/issue/PROJ-123`, `/search/jql`)
|
|
169
|
+
- `query`: Query parameters as key-value pairs (all values must be strings)
|
|
170
|
+
- `body`: Request body as JSON (for POST/PUT)
|
|
171
|
+
|
|
172
|
+
**Important Notes:**
|
|
173
|
+
- Query parameter values MUST be strings: `{"maxResults": "50"}` not `{"maxResults": 50}`
|
|
174
|
+
|
|
175
|
+
---
|
|
176
|
+
|
|
177
|
+
## Common Request Patterns
|
|
178
|
+
|
|
179
|
+
### Read Operations (Safe)
|
|
180
|
+
```json
|
|
181
|
+
{
|
|
182
|
+
"method": "GET",
|
|
183
|
+
"url": "/search/jql",
|
|
184
|
+
"query": {
|
|
185
|
+
"jql": "project = PROJ AND status = 'In Progress'",
|
|
186
|
+
"maxResults": "50",
|
|
187
|
+
"fields": "summary,status,assignee"
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
**Note:** Empty JQL queries cause 400 errors. Always specify valid JQL.
|
|
193
|
+
|
|
194
|
+
### Create Issue ⚠️
|
|
195
|
+
```json
|
|
196
|
+
{
|
|
197
|
+
"method": "POST",
|
|
198
|
+
"url": "/issue",
|
|
199
|
+
"body": "{\"fields\": {\"project\": {\"key\": \"PROJ\"}, \"summary\": \"Title\", \"description\": {\"type\": \"doc\", \"version\": 1, \"content\": [{\"type\": \"paragraph\", \"content\": [{\"type\": \"text\", \"text\": \"Description\"}]}]}, \"issuetype\": {\"name\": \"Bug\"}}}"
|
|
200
|
+
}
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
### Update Issue ⚠️
|
|
204
|
+
```json
|
|
205
|
+
{
|
|
206
|
+
"method": "PUT",
|
|
207
|
+
"url": "/issue/{issueKey}",
|
|
208
|
+
"body": "{\"fields\": {\"summary\": \"New title\"}}"
|
|
209
|
+
}
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
### Add Comment ⚠️
|
|
213
|
+
```json
|
|
214
|
+
{
|
|
215
|
+
"method": "POST",
|
|
216
|
+
"url": "/issue/{issueKey}/comment",
|
|
217
|
+
"body": "{\"body\": {\"type\": \"doc\", \"version\": 1, \"content\": [{\"type\": \"paragraph\", \"content\": [{\"type\": \"text\", \"text\": \"Comment text\"}]}]}}"
|
|
218
|
+
}
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
**For detailed examples, see the `recipes/` folder.**
|
|
222
|
+
|
|
223
|
+
---
|
|
224
|
+
|
|
225
|
+
## JQL Quick Reference
|
|
226
|
+
|
|
227
|
+
| Query | Description |
|
|
228
|
+
|-------|-------------|
|
|
229
|
+
| `project = PROJ` | Issues in project |
|
|
230
|
+
| `assignee = currentUser()` | Assigned to me |
|
|
231
|
+
| `status = "In Progress"` | Specific status (quote multi-word values) |
|
|
232
|
+
| `status in (Open, Done)` | Multiple statuses |
|
|
233
|
+
| `priority = High` | Priority filter |
|
|
234
|
+
| `created >= -7d` | Last 7 days |
|
|
235
|
+
| `sprint in openSprints()` | Open sprints |
|
|
236
|
+
| `type = Bug` | Issue type |
|
|
237
|
+
| `text ~ "keyword"` | Full-text search |
|
|
238
|
+
| `ORDER BY created DESC` | Sorting |
|
|
239
|
+
|
|
240
|
+
**Combine:** `project = PROJ AND status = "In Progress" AND assignee = currentUser()`
|
|
241
|
+
|
|
242
|
+
**📖 [JQL Cheat Sheet](https://www.atlassian.com/software/jira/guides/jql/cheat-sheet#advanced-search)** - For syntax and troubleshooting
|
|
243
|
+
|
|
244
|
+
|
|
245
|
+
## Query Parameters
|
|
246
|
+
|
|
247
|
+
| Parameter | Description |
|
|
248
|
+
|-----------|-------------|
|
|
249
|
+
| `jql` | JQL query (required, non-empty). Example: `"project=PROJ"` |
|
|
250
|
+
| `maxResults` | Max results (default 50). Example: `"100"` |
|
|
251
|
+
| `nextPageToken` | Pagination for `/search/jql` (from previous response) |
|
|
252
|
+
| `startAt` | Pagination for legacy endpoints. Example: `"0"` |
|
|
253
|
+
| `fields` | Comma-separated fields. Example: `"summary,status,assignee"` |
|
|
254
|
+
| `expand` | Additional data. Example: `"changelog"` |
|
|
255
|
+
|
|
256
|
+
---
|
|
257
|
+
|
|
258
|
+
## Atlassian Document Format (ADF)
|
|
259
|
+
|
|
260
|
+
Jira Cloud uses ADF for rich text fields (description, comments):
|
|
261
|
+
|
|
262
|
+
```json
|
|
263
|
+
{
|
|
264
|
+
"type": "doc",
|
|
265
|
+
"version": 1,
|
|
266
|
+
"content": [
|
|
267
|
+
{
|
|
268
|
+
"type": "paragraph",
|
|
269
|
+
"content": [
|
|
270
|
+
{"type": "text", "text": "Plain text here"}
|
|
271
|
+
]
|
|
272
|
+
}
|
|
273
|
+
]
|
|
274
|
+
}
|
|
275
|
+
```
|
|
276
|
+
|
|
277
|
+
## ⚠️ CRITICAL: Description and Comments Are Plain Strings (API v2)
|
|
278
|
+
|
|
279
|
+
The UiPath IS connector uses **Jira API v2**, where `description` and comment `body` are **plain strings**, NOT Atlassian Document Format (ADF) objects.
|
|
280
|
+
|
|
281
|
+
**❌ WRONG — ADF object** (causes `"Operation value must be a string"` 400 error):
|
|
282
|
+
```json
|
|
283
|
+
{
|
|
284
|
+
"body": "{\"fields\": {\"description\": {\"type\": \"doc\", \"version\": 1, \"content\": [...]}}}"
|
|
285
|
+
}
|
|
286
|
+
```
|
|
287
|
+
|
|
288
|
+
**✅ CORRECT — Plain string with newlines for formatting:**
|
|
289
|
+
```json
|
|
290
|
+
{
|
|
291
|
+
"body": "{\"fields\": {\"description\": \"First paragraph.\\n\\n- Bullet one\\n- Bullet two\\n- Bullet three\"}}"
|
|
292
|
+
}
|
|
293
|
+
```
|
|
294
|
+
|
|
295
|
+
**Formatting in plain text (API v2 wiki markup):**
|
|
296
|
+
- Newline: `\n`
|
|
297
|
+
- Blank line / paragraph break: `\n\n`
|
|
298
|
+
- Bullet list item: `- item` (preceded by `\n`)
|
|
299
|
+
- Bold: `*text*`
|
|
300
|
+
- Code: `{{text}}`
|
|
301
|
+
- Heading: `h1. Title`, `h2. Subtitle`
|
|
302
|
+
|
|
303
|
+
**Note:** ADF (Atlassian Document Format) is only used with the **direct Jira REST API v3** — not via the UiPath IS connector.
|
|
304
|
+
|
|
305
|
+
**For formatting examples, see recipes.**
|
|
306
|
+
|
|
307
|
+
---
|
|
308
|
+
|
|
309
|
+
## Error Handling & Retry Strategy
|
|
310
|
+
|
|
311
|
+
| Status | Meaning | Retry? | Action |
|
|
312
|
+
|--------|---------|--------|--------|
|
|
313
|
+
| 200/201 | Success | N/A | Process response |
|
|
314
|
+
| 400 | Bad Request | No | Check JQL syntax ([JQL Cheat Sheet](https://www.atlassian.com/software/jira/guides/jql/cheat-sheet#advanced-search)) or body format |
|
|
315
|
+
| 401 | Unauthorized | No | Connection needs re-auth - inform user |
|
|
316
|
+
| 403 | Forbidden | No | User lacks permissions - inform user |
|
|
317
|
+
| 404 | Not Found | No | Verify project/issue key exists |
|
|
318
|
+
| 429 | Rate Limited | Yes (3x) | Wait `Retry-After` header seconds (default 60s), retry |
|
|
319
|
+
| 5xx | Server Error | Yes (3x) | Exponential backoff: 1s, 2s, 4s |
|
|
320
|
+
|
|
321
|
+
### ⚠️ CRITICAL: 200 OK with 401 Error
|
|
322
|
+
|
|
323
|
+
`http-request` may return **200 OK** with **401 in response body** - this means **wrong URL path** (included `/rest/api/3` when using UiPath connector). Fix: Remove `/rest/api/3` prefix and retry.
|
|
324
|
+
|
|
325
|
+
---
|
|
326
|
+
|
|
327
|
+
## Rate Limits
|
|
328
|
+
|
|
329
|
+
Jira Cloud API has rate limits:
|
|
330
|
+
- Varies by plan and usage
|
|
331
|
+
- Check `X-RateLimit-Remaining` header in responses
|
|
332
|
+
- Typically allows thousands of requests per minute
|
|
333
|
+
- **Best Practice:** Check headers: `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`
|
|
334
|
+
|
|
335
|
+
---
|
|
336
|
+
|
|
337
|
+
## Common Mistakes
|
|
338
|
+
|
|
339
|
+
| Mistake | Fix |
|
|
340
|
+
|---------|-----|
|
|
341
|
+
| **⚠️ Including `/rest/api/3` in URL** | **OMIT for UiPath connector** (causes 200 OK with 401 error) |
|
|
342
|
+
| Integer query params | Use strings: `"maxResults": "50"` not `50` |
|
|
343
|
+
| Missing JQL quotes | Use `'In Progress'` not `In Progress` ([JQL Cheat Sheet](https://www.atlassian.com/software/jira/guides/jql/cheat-sheet#advanced-search)) |
|
|
344
|
+
| Empty JQL | Always provide valid JQL (causes 400 error) |
|
|
345
|
+
| Plain text description | Use ADF format with `type`, `version`, `content` |
|
|
346
|
+
| Body as object | Stringify JSON: `"body": "{...}"` not `"body": {...}` |
|
|
347
|
+
| **⚠️ ADF object as description** | **The IS connector uses API v2 — description and comment body are plain strings, NOT ADF objects.** Use `"description": "plain text with \\n for newlines"`. ADF objects cause `"Operation value must be a string"` (400). |
|
|
348
|
+
| Using `/search` | Use `/search/jql` (legacy endpoint deprecated) |
|
|
349
|
+
|
|
350
|
+
---
|
|
351
|
+
|
|
352
|
+
## Performance Best Practices
|
|
353
|
+
|
|
354
|
+
**Use field filtering:** `"fields": "key,summary,status"` reduces response size by 70%
|
|
355
|
+
|
|
356
|
+
**Batch operations:** Use `/search/jql` with `key in (PROJ-1, PROJ-2)` instead of multiple `/issue/{key}` calls
|
|
357
|
+
|
|
358
|
+
**Parallel requests:** Same connection supports concurrent operations
|
|
359
|
+
|
|
360
|
+
---
|
|
361
|
+
|
|
362
|
+
## 📁 Recipes
|
|
363
|
+
|
|
364
|
+
For step-by-step guides to common Jira tasks, see the **`recipes/`** folder:
|
|
365
|
+
|
|
366
|
+
### Core Operations
|
|
367
|
+
|
|
368
|
+
| Recipe | Description | Safety |
|
|
369
|
+
|--------|-------------|--------|
|
|
370
|
+
| `search-issues.md` | Search issues with JQL | ✅ Safe (read-only) |
|
|
371
|
+
| `get-issue-details.md` | Get full issue details | ✅ Safe (read-only) |
|
|
372
|
+
| `my-issues.md` | List issues assigned to current user | ✅ Safe (read-only) |
|
|
373
|
+
| `list-projects.md` | List available projects | ✅ Safe (read-only) |
|
|
374
|
+
|
|
375
|
+
### Write Operations
|
|
376
|
+
|
|
377
|
+
| Recipe | Description | Safety |
|
|
378
|
+
|--------|-------------|--------|
|
|
379
|
+
| `create-issue.md` | Create a new issue | ⚠️ **Requires user confirmation** |
|
|
380
|
+
| `add-comment.md` | Add comment to an issue | ⚠️ **Requires user confirmation** |
|
|
381
|
+
| `transition-issue.md` | Change issue status | ⚠️ **Requires user confirmation** |
|
|
382
|
+
| `assign-issue.md` | Assign issue to a user | ⚠️ **Requires user confirmation** |
|
|
383
|
+
|
|
384
|
+
### Troubleshooting
|
|
385
|
+
|
|
386
|
+
| Recipe | Description |
|
|
387
|
+
|--------|-------------|
|
|
388
|
+
| `troubleshooting.md` | Debug common Jira API issues, error patterns, and recovery strategies |
|
|
389
|
+
|
|
390
|
+
Each recipe includes:
|
|
391
|
+
- **When to use** - Trigger phrases and scenarios
|
|
392
|
+
- **Step-by-step workflow** - Exact API calls with validation
|
|
393
|
+
- **Example output** - How to present results to users
|
|
394
|
+
- **Error handling** - Common errors and solutions
|
|
395
|
+
- **Key learnings** - Gotchas, tips, and best practices
|
|
396
|
+
|
|
397
|
+
⚠️ = Write operation (requires explicit user permission before execution)
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
# Recipe: Add Comment to Issue
|
|
2
|
+
|
|
3
|
+
## When to Use
|
|
4
|
+
User asks: "Comment on PROJ-123", "Add a note to the ticket", "Reply to the issue", "Post an update"
|
|
5
|
+
|
|
6
|
+
## ⚠️ Safety Warning
|
|
7
|
+
This is a **write operation** that posts a real comment. Always confirm with the user before executing.
|
|
8
|
+
|
|
9
|
+
## Workflow
|
|
10
|
+
|
|
11
|
+
### Step 1: Get Jira Connection
|
|
12
|
+
```
|
|
13
|
+
GET connections_/api/v1/Connectors/uipath-atlassian-jira/connection
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Extract from response:
|
|
17
|
+
- `connectionId` = `response.id`
|
|
18
|
+
- `elementInstanceId` = `response.elementInstanceId`
|
|
19
|
+
|
|
20
|
+
### Step 2: Add Comment
|
|
21
|
+
```
|
|
22
|
+
POST elements_/v3/element/instances/{elementInstanceId}/http-request
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
**Body Format:** Use plain text or markdown (API v2):
|
|
26
|
+
```json
|
|
27
|
+
{
|
|
28
|
+
"authentication": "connector",
|
|
29
|
+
"targetConnector": "uipath-atlassian-jira",
|
|
30
|
+
"connection": "{connectionId}",
|
|
31
|
+
"method": "POST",
|
|
32
|
+
"url": "/issue/{issueKey}/comment",
|
|
33
|
+
"headers": {},
|
|
34
|
+
"query": {},
|
|
35
|
+
"body": "{\"body\": \"Your comment text here\"}"
|
|
36
|
+
}
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Parse response (status code 201 = Created successfully):
|
|
40
|
+
- `comment` = `response.body`
|
|
41
|
+
- `comment.id` - Comment ID
|
|
42
|
+
- `comment.author.displayName` - Author name
|
|
43
|
+
- `comment.body` - Comment body
|
|
44
|
+
- `comment.created` - ISO timestamp
|
|
45
|
+
- `comment.updated` - ISO timestamp
|
|
46
|
+
- `comment.self` - API URL to comment
|
|
47
|
+
|
|
48
|
+
## Example Output
|
|
49
|
+
|
|
50
|
+
✅ **Comment added!**
|
|
51
|
+
|
|
52
|
+
| Field | Value |
|
|
53
|
+
|-------|-------|
|
|
54
|
+
| **Issue** | PROJ-123 |
|
|
55
|
+
| **Comment ID** | 10042 |
|
|
56
|
+
| **Author** | John Doe |
|
|
57
|
+
| **Time** | Jan 27, 2026 at 4:15 PM |
|
|
58
|
+
|
|
59
|
+
## Variations
|
|
60
|
+
|
|
61
|
+
### Comment with Markdown Formatting
|
|
62
|
+
The UiPath connector (API v2) supports basic markdown in plain text:
|
|
63
|
+
```json
|
|
64
|
+
{
|
|
65
|
+
"body": "{\"body\": \"*Status update:*\\n- Fixed the timeout issue\\n- Added error logging\\n\\nSee {code}config.js{code} for details.\"}"
|
|
66
|
+
}
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### Comment with Mention
|
|
70
|
+
To mention a user, use the `[~accountId:xxx]` format:
|
|
71
|
+
```json
|
|
72
|
+
{
|
|
73
|
+
"body": "{\"body\": \"[~accountId:5b10ac8d82e05b22cc7d4ef5] please review this.\"}"
|
|
74
|
+
}
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
### Internal Comment (Restrict Visibility)
|
|
78
|
+
```json
|
|
79
|
+
{
|
|
80
|
+
"body": "{\"body\": \"Internal note - not visible to customers\", \"visibility\": {\"type\": \"role\", \"value\": \"Administrators\"}}"
|
|
81
|
+
}
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### Rich Text with ADF (API v3 - Direct API Only)
|
|
85
|
+
The UiPath IS connector uses **Jira API v2** — comment `body` is a **plain string**, not ADF.
|
|
86
|
+
|
|
87
|
+
✅ **CORRECT — Plain string with wiki markup:**
|
|
88
|
+
```json
|
|
89
|
+
{
|
|
90
|
+
"body": "{\"body\": \"*Status update:*\\n- Fixed the timeout issue\\n- Added error logging\\n\\nSee {{config.js}} for details.\"}"
|
|
91
|
+
}
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
❌ **WRONG — ADF object** (causes `"body: Operation value must be a string"` 400 error):
|
|
95
|
+
```json
|
|
96
|
+
{
|
|
97
|
+
"body": "{\"body\": {\"type\": \"doc\", \"version\": 1, \"content\": [...]}}"
|
|
98
|
+
}
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
ADF is only supported when calling the **direct Jira REST API v3** — not via the UiPath IS connector.
|
|
102
|
+
|
|
103
|
+
## Get Existing Comments
|
|
104
|
+
|
|
105
|
+
To read comments before adding:
|
|
106
|
+
```json
|
|
107
|
+
{
|
|
108
|
+
"method": "GET",
|
|
109
|
+
"url": "/issue/{issueKey}/comment",
|
|
110
|
+
"query": {"orderBy": "-created", "maxResults": "10"}
|
|
111
|
+
}
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
## Key Learnings
|
|
115
|
+
|
|
116
|
+
1. **Plain text works** - UiPath connector uses API v2; simple `{"body": "text"}` is sufficient
|
|
117
|
+
2. **No ADF required** - Unlike API v3, the connector doesn't require Atlassian Document Format
|
|
118
|
+
3. **Markdown supported** - Basic markdown like `*bold*`, `-` lists, `{code}` blocks work
|
|
119
|
+
4. **201 = success** - Response code 201 (Created) indicates success
|
|
120
|
+
5. **Mentions format** - Use `[~accountId:xxx]` syntax for mentions in plain text
|
|
121
|
+
6. **Comments are public** - Unless you specify visibility restrictions
|
|
122
|
+
7. **Edit vs new** - To edit, use PUT to `/issue/{key}/comment/{commentId}`
|
|
123
|
+
8. **Always ask permission** - This posts a real comment; get user confirmation first
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
# Recipe: Assign Issue
|
|
2
|
+
|
|
3
|
+
## When to Use
|
|
4
|
+
User asks: "Assign PROJ-123 to John", "Take ownership of the ticket", "Assign to me", "Reassign the issue"
|
|
5
|
+
|
|
6
|
+
## ⚠️ Safety Warning
|
|
7
|
+
This is a **write operation** that changes the issue assignee. Always confirm with the user before executing.
|
|
8
|
+
|
|
9
|
+
## Workflow
|
|
10
|
+
|
|
11
|
+
### Step 1: Get Jira Connection
|
|
12
|
+
```
|
|
13
|
+
GET connections_/api/v1/Connectors/uipath-atlassian-jira/connection
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Extract from response:
|
|
17
|
+
- `connectionId` = `response.id`
|
|
18
|
+
- `elementInstanceId` = `response.elementInstanceId`
|
|
19
|
+
|
|
20
|
+
### Step 2: (If needed) Find User Account ID
|
|
21
|
+
|
|
22
|
+
If assigning to someone other than yourself, search for the user:
|
|
23
|
+
|
|
24
|
+
```
|
|
25
|
+
POST elements_/v3/element/instances/{elementInstanceId}/http-request
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
```json
|
|
29
|
+
{
|
|
30
|
+
"authentication": "connector",
|
|
31
|
+
"targetConnector": "uipath-atlassian-jira",
|
|
32
|
+
"connection": "{connectionId}",
|
|
33
|
+
"method": "GET",
|
|
34
|
+
"url": "/user/search",
|
|
35
|
+
"headers": {},
|
|
36
|
+
"query": {"query": "john"},
|
|
37
|
+
"body": ""
|
|
38
|
+
}
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Parse response:
|
|
42
|
+
- `users` = `response.body` (array of user objects)
|
|
43
|
+
|
|
44
|
+
**Each user contains:**
|
|
45
|
+
- `accountId` - "5b10ac8d82e05b22cc7d4ef5" (required for assignment)
|
|
46
|
+
- `displayName` - "John Doe"
|
|
47
|
+
- `emailAddress` - "john.doe@example.com" (may be hidden)
|
|
48
|
+
- `active` - true/false
|
|
49
|
+
|
|
50
|
+
### Step 3: Assign the Issue
|
|
51
|
+
```
|
|
52
|
+
POST elements_/v3/element/instances/{elementInstanceId}/http-request
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
```json
|
|
56
|
+
{
|
|
57
|
+
"authentication": "connector",
|
|
58
|
+
"targetConnector": "uipath-atlassian-jira",
|
|
59
|
+
"connection": "{connectionId}",
|
|
60
|
+
"method": "PUT",
|
|
61
|
+
"url": "/issue/{issueKey}/assignee",
|
|
62
|
+
"headers": {},
|
|
63
|
+
"query": {},
|
|
64
|
+
"body": "{\"accountId\": \"5b10ac8d82e05b22cc7d4ef5\"}"
|
|
65
|
+
}
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
Parse response:
|
|
69
|
+
- Status code 204 = Success (No Content)
|
|
70
|
+
- Issue has been assigned
|
|
71
|
+
|
|
72
|
+
## Example Output
|
|
73
|
+
|
|
74
|
+
✅ **Issue assigned!**
|
|
75
|
+
|
|
76
|
+
| Field | Value |
|
|
77
|
+
|-------|-------|
|
|
78
|
+
| **Issue** | PROJ-123 |
|
|
79
|
+
| **Assignee** | John Doe |
|
|
80
|
+
|
|
81
|
+
## Variations
|
|
82
|
+
|
|
83
|
+
### Assign to Current User
|
|
84
|
+
First get current user's accountId:
|
|
85
|
+
|
|
86
|
+
```json
|
|
87
|
+
{
|
|
88
|
+
"method": "GET",
|
|
89
|
+
"url": "/myself",
|
|
90
|
+
"query": {}
|
|
91
|
+
}
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Then use that accountId to assign:
|
|
95
|
+
```json
|
|
96
|
+
{
|
|
97
|
+
"method": "PUT",
|
|
98
|
+
"url": "/issue/{issueKey}/assignee",
|
|
99
|
+
"body": "{\"accountId\": \"{myAccountId}\"}"
|
|
100
|
+
}
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### Unassign (Remove Assignee)
|
|
104
|
+
```json
|
|
105
|
+
{
|
|
106
|
+
"method": "PUT",
|
|
107
|
+
"url": "/issue/{issueKey}/assignee",
|
|
108
|
+
"body": "{\"accountId\": null}"
|
|
109
|
+
}
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Assign via Issue Update
|
|
113
|
+
Alternative method using issue update:
|
|
114
|
+
```json
|
|
115
|
+
{
|
|
116
|
+
"method": "PUT",
|
|
117
|
+
"url": "/issue/{issueKey}",
|
|
118
|
+
"body": "{\"fields\": {\"assignee\": {\"accountId\": \"5b10ac8d82e05b22cc7d4ef5\"}}}"
|
|
119
|
+
}
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
### Assign with Default Assignee
|
|
123
|
+
Some projects have automatic assignment rules. To trigger:
|
|
124
|
+
```json
|
|
125
|
+
{
|
|
126
|
+
"method": "PUT",
|
|
127
|
+
"url": "/issue/{issueKey}/assignee",
|
|
128
|
+
"body": "{\"accountId\": \"-1\"}"
|
|
129
|
+
}
|
|
130
|
+
```
|
|
131
|
+
This sets to project default or component lead.
|
|
132
|
+
|
|
133
|
+
## Finding Assignable Users
|
|
134
|
+
|
|
135
|
+
Get users who can be assigned to an issue in a specific project:
|
|
136
|
+
|
|
137
|
+
```json
|
|
138
|
+
{
|
|
139
|
+
"method": "GET",
|
|
140
|
+
"url": "/user/assignable/search",
|
|
141
|
+
"query": {
|
|
142
|
+
"project": "PROJ",
|
|
143
|
+
"query": "john"
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
## Key Learnings
|
|
149
|
+
|
|
150
|
+
1. **accountId required** - Cannot assign by email or display name
|
|
151
|
+
2. **Get accountId first** - Use `/user/search` or `/myself` to get accountId
|
|
152
|
+
3. **204 = success** - Response code 204 (No Content) indicates success
|
|
153
|
+
4. **null = unassign** - Set accountId to null to remove assignee
|
|
154
|
+
5. **-1 = default** - Set accountId to "-1" to use project/component default
|
|
155
|
+
6. **Permission required** - User must have permission to assign issues
|
|
156
|
+
7. **Always confirm** - This changes real issue assignment; get user permission first
|
|
157
|
+
|