---
title: "Document Workday Configuration and Business Processes"
description: "Use Workday's own reports to document business process definitions, security, tenant setup and integrations, then turn them into a design workbook and test…"
url: https://kiweely.com/guides/document-workday-configuration-and-business-processes
---

# How do I document Workday configuration and business processes from a live tenant?

Pull the document from the tenant itself: the business process definition, its security policy, the security reports, the exception audits and the tenant setup tasks. Then lay it out as a design workbook and a test script.

-   **Checked** against Workday on November 16
-   Applies to **Workday business processes, security and tenant configuration**
-   7 min read
-   Published November 16
-   By Kiweely

Document a Workday tenant by reading it, not by retyping screens. Every business process, security policy, tenant setting and integration system can be opened in a report or task Workday ships, and the output is the first draft of a design workbook. A test script is written from the same rows.

## Which Workday reports document a business process?

Workday’s Business Process Framework course describes the business process definition as the main record. Its header shows the effective date, the security groups allowed to initiate the process, and a button for a visual of the process flow. The body has tabs, each of which is a section of your document.

| Definition tab | What to record |
| --- | --- |
| Business Process Steps | The order of steps. Steps can run in sequence or in parallel. |
| Notifications | System and custom notifications, and what triggers each one. |
| Allowed Actions by Role | The actions allowed in the process, such as review and subprocesses. |
| Allowed Services | Services allowed in the process, such as creating or resetting Workday accounts. |
| Related Links | External links on the process. |
| Available Rules & Fields | The condition rules and fields that can be used in conditional logic. |

Workday says the initiation date of a transaction decides which version of the definition runs. To document a definition as it stood on another date, use View Definition from the related actions menu of the definition. Record the effective date next to every definition you capture.

The reports to start from:

| Report or task | Use it to document | Source |
| --- | --- | --- |
| Business Process Definitions | The business processes in the tenant, including the ones Workday delivers | Setup Considerations: Business Processes |
| Business Process Configuration Options | Which steps and actions can be attached to a process | Setup Considerations: Business Processes |
| Business Process Exception Audit | Definitions with critical errors, with warnings optional | FAQ: Business Processes |
| Find Events, Business Process Cycle Times | Real events and the average days per process type and step | Setup Considerations: Business Processes |

The Business Process Exception Audit is part of documentation, not only repair. A definition with a critical error cannot run, so the document should say whether each one is clean.

## How do I document business process security?

Each business process type has one business process security policy that covers every definition of that type. Workday’s course lists the permissions it secures, including initiating, approving, delegating and cancelling. A definition can route steps to different security groups as long as those groups are in the policy for the type. That is why a step table that names a group is incomplete without the policy beside it. See [domain versus business process security](https://kiweely.com/guides/workday-domain-vs-business-process-security-policies) for how the two layers differ.

The Security for Administrators course maps questions to reports. These cover the tenant security that a workbook usually needs:

| Question the document must answer | Report |
| --- | --- |
| What can a security group do? | View Security Group, Security Analysis for Security Group, Action Summary for Security Group |
| Which policy secures a given item? | View Security for Securable Item |
| Which groups is a worker in? | View Security Groups for User |
| What is the current security for a functional area? | Domain Security Policies for Functional Area, Business Process Security Policies for Functional Area |
| Which policy edits are waiting for activation? | Domain Security Policies with Pending Changes, Business Process Security Policies with Pending Changes |
| Who changed security, and when? | Business Process Security Policy History, Domain Security Policy History, Audit Trail - Security |
| Is the configuration broken? | Security Exception Audit |

To view the policy for a business process from its definition, use Business Process Policy, View from the related actions menu. Workday states that policy edits do not take effect until Activate Pending Security Policy Changes runs, and that it activates every pending change in the tenant, whoever made it. So record the activation state before you write that a role can do something.

## How do I document tenant setup and integrations?

Workday groups tenant-wide options under the Tenant Setup report and a set of tasks such as Edit Tenant Setup - System, Edit Tenant Setup - HCM and Edit Tenant Setup - Business Processes. Open the report, view each task for the areas in scope, and copy the values that change behaviour. The Setup Considerations page for business processes names the Edit Tenant Setup - Business Processes task and the domains that secure it: Business Process Administration, Manage: Business Process Definitions and Set Up: Tenant Setup - BP and Notifications.

For integrations, Workday describes an integration system as the framework it uses to launch and track an integration with an external system or a Workday endpoint, and says every integration is represented as one. Each integration system is therefore one row of the integration inventory. A business process can reach one through an Integration step, so record that link on the process row. Workday also provides a Touchpoints Kit on Workday Community with resources for understanding configuration relationships in a tenant.

Workday lists the Calculated Field Exception Audit and Integration Exception Audit alongside the business process and security audits. Run all four and file the results with the workbook.

## What does a design workbook contain?

Workday’s methodology for the Architect and Configure stage names configuration workbooks among its design artifacts, next to an integrations tracker and a reporting tracker, and describes the stage as aiming for a common understanding of the business needs and a prototype configuration. The tab layout below is ours, built from the objects above, not a Workday template. One tab per area works:

1.  Scope and version: tenant, date captured, effective dates of each definition, who captured it.
2.  Business processes: one row per definition, with initiators, steps in order, step type, responsible group, condition rules and notifications.
3.  Security: the business process security policy per type and the domain policies that matter, with pending-activation state.
4.  Tenant setup: each setting, its value, and the task it came from.
5.  Integrations: integration system, the process that launches it.
6.  Exceptions: output of the four exception audits, with an owner for each item.
7.  Decisions: why each non-default choice was made. Reports cannot supply this one; ask the consultant who built it.

## What does a test script contain?

Workday’s [methodology page for the Architect and Configure stage](https://community-content.workday.com/en-us/public/learn/resources/customer-deployment/workday-methodology-overview-student-customer-deployment-guide/architect-and-configure-student.html) says the customer creates customer-specific test scenarios for unit and lifecycle testing, and that consultants review them for missing cases. Write each scenario as rows tied to the workbook:

| Column | Content |
| --- | --- |
| Scenario | The case, for example a Change Job that triggers the extra approval |
| Workbook ref | The row it proves |
| Test data | The worker or record, and why it meets the entry condition |
| Step | One action |
| Run as | The person or role performing it |
| Expected | The route, the awaiting person, the saved data |
| Actual and result | Filled in during the run |

After each step, open the Full Process Record. Workday documents its Process tab (steps, due dates, who completed each) and All Actions tab (the actions that ran). Those two tabs are the evidence column. The [end-to-end testing guide](https://kiweely.com/guides/workday-end-to-end-testing) covers running the script, and the [test data guide](https://kiweely.com/guides/workday-test-data-sandbox) covers building the cases.

## Worked example: documenting a Hire process

In Workday’s Global Modern Services demo tenant, the Hire definition would be documented like this.

1.  Run Business Process Definitions, open Hire, and note the effective date and the groups allowed to initiate it.
2.  Copy the Business Process Steps tab into the process tab, one row per step, and the Notifications tab into its own rows.
3.  Open Business Process Policy, View on the definition and copy the groups per action into the security tab. Check Business Process Security Policies with Pending Changes is empty.
4.  Run Business Process Exception Audit with warnings shown. Record “no critical errors” or each finding.
5.  Write one test row per branch: one worker who meets a condition rule and one who does not, then a send back. Tie each to the step rows in step 2.

When someone changes the definition during testing, rerun steps 1 to 4 and compare. That comparison is the drift check. Our post on [generating the workbook and test script from the live tenant](https://kiweely.com/blog/workday-design-workbooks-and-test-scripts-from-live-tenant) covers the drift problem in more detail, and [moving configuration between tenants](https://kiweely.com/guides/workday-configuration-between-tenants) is a separate task.

Kiweely Vine reads a client’s tenant with consent and keeps each project’s Deliverables folder as its record, so a workbook and test script like these can be kept current from what is actually configured.

## Frequently asked questions

### Is there one Workday report that documents all configuration?

No. Workday documents the pieces as separate reports: the Business Process Definitions report for processes, the security reports for who can do what, the Tenant Setup report for tenant-wide options, and the exception audits for problems. A configuration document is these outputs put in one place.

### How do I show who can initiate and approve a business process?

Open the definition and read the header, which lists the security groups allowed to initiate the process. For the full set of actions, open the business process security policy from the related actions menu with Business Process Policy, View.

### How do I see what changed in security since the design was written?

Run the Business Process Security Policy History and Domain Security Policy History reports, or the Changed within Time Range versions of them. Workday lists them as the audit trail for security policy changes.

### What is the difference between a design workbook and a test script?

The design workbook records what is configured and why. The test script records the steps to run, as which person, and the result to expect. Each test row should point back to one row in the design workbook.

## Sources checked

-   [Workday Education, HCM Core for Administrators: Business Process Framework](https://doc.workday.com/workday-education/en-us/course-manuals/hcm-core-for-administrators/business-process-framework.html)
-   [Workday Education, Security for Administrators: Choosing the Right Security Group Type](https://doc.workday.com/workday-education/en-us/course-manuals/security-for-administrators/choosing-the-right-security-group-type.html)
-   [Workday Education, Security for Administrators: Report Security](https://doc.workday.com/workday-education/en-us/course-manuals/security-for-administrators/report-security.html)
-   [Workday Administrator Guide: Concept: Exception Audit Reports](https://doc.workday.com/admin-guide/en-us/manage-workday/tenant-configuration/auditing/dan1370797846981.html)
-   [Workday Administrator Guide: Setup Considerations: Business Processes](https://doc.workday.com/admin-guide/en-us/manage-workday/business-processes/business-process-framework-concepts/khy1593557050505.html)
-   [Workday Administrator Guide: Concept: View Business Process Details](https://doc.workday.com/admin-guide/en-us/manage-workday/business-processes/business-process-framework-concepts/dan1370797847910.html)
-   [Workday Administrator Guide: Concept: Integration Systems and Events](https://doc.workday.com/admin-guide/en-us/workday-studio/studio-fundamentals/uxa1532597056528.html)

## Related guides

[All guides](https://kiweely.com/guides)

-   [### Workday Domain Security vs. Business Process Security Policies: Which Controls What A domain security policy controls View/Modify (and Get/Put) access to reports, report fields, setup tasks and web services. A business process security policy controls who can start, approve, cancel, rescind or view a transaction. Both need activation.](https://kiweely.com/guides/workday-domain-vs-business-process-security-policies)
-   [### Workday Test Data: How to Build Realistic Data in a Sandbox or Implementation Tenant Workday has no test data generator. You get test data from a copy of Production, from loads you run yourself, or from demonstration tenants. This guide shows what survives a refresh and what does not.](https://kiweely.com/guides/workday-test-data-sandbox)
-   [### How do I plan end-to-end and regression testing in Workday, and what does a test scenario cover? An end-to-end Workday test follows one transaction through every role, integration and record it touches. Regression testing repeats the same scenarios after a weekly service update or a twice-yearly feature release, first in Sandbox Preview.](https://kiweely.com/guides/workday-end-to-end-testing)
-   [### What is the safest way to copy Workday configuration from one tenant to another? Use Object Transporter, launched from the object or from Customer Central, and read its error check, prerequisite check and diff report before migrating. Use Configuration Change Tracker for project work and extracts only for different billing IDs.](https://kiweely.com/guides/workday-configuration-between-tenants)

### More guides on Business processes and security

[All 27 guides](https://kiweely.com/guides#business-processes)

-   [How to Run Role-Boundary Security Tests Across Employee, Manager, and HR Partner Personas](https://kiweely.com/guides/workday-role-boundary-testing-employee-manager-hr-partner)
-   [Aligning Workday Session Timeouts with External OAuth Access Token Lifetimes](https://kiweely.com/guides/workday-anonymous-vs-authenticated-session-timeout-oauth)
-   [How Workday Terminations and Job Transfers Affect Active OAuth Grants](https://kiweely.com/guides/workday-revoke-oauth-tokens-terminated-transferred-workers)
-   [Configuring Workday Pre-Hire Security So New Employees Can Complete Tasks Before Day One](https://kiweely.com/guides/workday-pre-hire-onboarding-access-before-day-one-security)
-   [Tuning Workday Business Process Notifications When Using External Mobile or Chat Approvals](https://kiweely.com/guides/workday-notification-delivery-settings-suppressing-duplicate-emails)
-   [Workday Time Off vs. Leave of Absence: Helping Employees Pick the Right Request Type](https://kiweely.com/guides/workday-leave-of-absence-vs-time-off-employee-request-routing)
-   [How to Trace Who Approves a Leave or Expense Request in a Workday Supervisory Org](https://kiweely.com/guides/workday-find-approver-chain-supervisory-org-business-process)
-   [Validating Country-Specific Address and Emergency Contact Formats in Workday Self-Service](https://kiweely.com/guides/workday-emergency-contact-home-address-change-validation-rules)

### From the blog on Business processes and security

[All posts](https://kiweely.com/blog)

-   [Two Phone Apps, Two Jobs: Kiweely Companion for Admins vs. Kiweely Leaf for Employees](https://kiweely.com/blog/kiweely-phone-app-vs-kiweely-leaf-phone-app-explained)
-   [The CISO Checklist for Connecting Claude, ChatGPT, or Gemini to Workday](https://kiweely.com/blog/ciso-security-review-checklist-connecting-llms-to-workday)
-   [Using Face ID and Fingerprint Unlock with Workday Single Sign-On for Deskless Workers](https://kiweely.com/blog/biometric-face-id-fingerprint-reauth-for-workday-mobile-apps)

## Let Workday check the work.

Kiweely writes WQL and builds orchestrations in your own tenant, and Workday, not Kiweely, says whether they passed.

[Start for free](https://kiweely.com/download) [See how it works](https://kiweely.com/vine/how-it-works)

## Get the next guide in your inbox.

One email a month with new guides and one Extend tip. Nothing else.
