Skip to content

Workday Extended Topics docs fix/update - #184

Open
Surendra Goutham (is-goutham) wants to merge 2 commits into
mainfrom
docs/extended-readme-accuracy
Open

Workday Extended Topics docs fix/update#184
Surendra Goutham (is-goutham) wants to merge 2 commits into
mainfrom
docs/extended-readme-accuracy

Conversation

@is-goutham

Copy link
Copy Markdown
Contributor

Description

Docs only. Corrects the  WorkdayCustomEngineAgent/Extended  README so it matches the shipped topics: documents that samples use the base namespace (with the  TransferEmployee  HR-namespace  WorkdayManagerCheck  exception), adds the missing  WorkdayManagerCheck  prerequisite, fixes the  WorkdayRESTExecution  flow instruction, clarifies the record-limit maximum, and documents key customization points (employee-ID binding, RequestFeedback expiry/sharing, TransferEmployee effective date and team move).

Type of change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update
  • Refactor / cleanup

…customization notes

- Clarify topics ship on the base namespace (msdyn_copilotforemployeeselfservice.topic.)
  and call out the TransferEmployee HR-namespace WorkdayManagerCheck reference; reframe
  it/hr guidance as a manual update rather than automatic resolution
- Add missing WorkdayManagerCheck prerequisite for TransferEmployee and fix the
  WorkdayRESTExecution flow instruction (the flow runs inside the system topic)
- Explain the Adjustable limits maximum as the Workday API per-call limit
- Document customization points: employee identity binding, RequestFeedback expiry and
  sharing mapping, TransferEmployee effective date and moveManagersTeam

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown

Samples static validation

Validation
- YAML parse: N-A
- AdaptiveDialog kind: N-A
- XML parse: N-A
- Filename convention (new): N-A
- Folder convention (new, incl. README.md): N-A
- Diff scope (samples/ only): FAIL
    - solutions/ess-maker-skills/mydocs/provision/provision3/_check_solutions.py: outside samples/
    - solutions/ess-maker-skills/mydocs/provision/provision3/config.json: outside samples/
    - solutions/ess-maker-skills/mydocs/provision/provision3/tasks.md: outside samples/
    - solutions/ess-maker-skills/mydocs/provision/test-traces/probe_connectivity_api.py: outside samples/
    - solutions/ess-maker-skills/mydocs/provision/test-traces/test-run2-details.md: outside samples/
    - solutions/ess-maker-skills/mydocs/provision/test-traces/test-run3-details.md: outside samples/
    - solutions/ess-maker-skills/mydocs/provision/test-traces/test-run4-details.md: outside samples/
    - solutions/ess-maker-skills/mydocs/provision/test-traces/test-run5-details.md: outside samples/
    - solutions/ess-maker-skills/mydocs/provision/test-traces/test-run6-details.md: outside samples/
    - solutions/ess-maker-skills/mydocs/provision/test-traces/token.md: outside samples/
- Secrets / internal URLs: PASS

Runtime validation in Power Platform is a manual follow-up. See tools/validate_samples/README.md.

@is-goutham Surendra Goutham (is-goutham) changed the title docs(samples): correct Extended README namespace, prerequisites, and … Workday Extended Topics docs fix/update Jul 8, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Workday extended-scenarios sample documentation (samples/WorkdayCustomEngineAgent/Extended) to better match the shipped topic YAML and to document key prerequisites and customization options.

Changes:

  • Clarifies prerequisite topics/flows (including the WorkdayManagerCheck dependency for TransferEmployee.yaml) and corrects the WorkdayRESTExecution flow navigation guidance.
  • Documents the shipped namespace expectations (base namespace with an HR-namespace exception for WorkdayManagerCheck) and adds post-paste validation guidance for dialog: references.
  • Expands guidance on adjustable record limits and highlights common customization points (employee-ID binding, feedback expiration/sharing, transfer effective date/team move).

Comment on lines +16 to +22
1. In Copilot Studio, go to **Topics** and confirm **WorkdaySystemGetRESTExecution** is present and turned on. Every topic here calls it to reach the Workday REST API.

2. In this topic, go to the node where the flow is configured as **WorkdayRESTExecution** and navigate to this flow (Power Automate page) and confirm its status is **On**. If it is off, open it and turn it on. You may be asked to authorize the Workday connection.
2. `WorkdaySystemGetRESTExecution` invokes the **WorkdayRESTExecution** flow internally. Open that flow on its Power Automate page and confirm its status is **On**. If it is off, turn it on. You may be asked to authorize the Workday connection.

If either is missing, import the latest EssITWorkdayHCM or EssHRWorkdayHCM solution first.
3. **`TransferEmployee.yaml` only** — it also calls **WorkdayManagerCheck** as its first action (to confirm the caller is a manager). Confirm that topic is present and turned on before adding `TransferEmployee.yaml`.

If any of these is missing, import the latest EssITWorkdayHCM or EssHRWorkdayHCM solution first.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants