Skip to content
KiweelyKiweelyKiweely

Turn a requirements note into a Workday business process

A business requirements document is your paper. Workday delivers business process types and lets you define definitions: steps, security groups, and timing. Deployment Agent can explain and inspect a non-Production definition; as documented, you edit it and activate security yourself.

  • Checked against Workday on
  • Applies to Workday Extend
  • 7 min read
  • Published
  • By Kiweely
On this page

A business requirements document is not a Workday object. Workday has not published a “BRD import.” What it has published is the business process framework: a delivered business process type, one business process security policy for that type, and one or more definitions that say which steps run, which security groups act, and when.

Deployment Agent with Ask can inspect definitions, condition rules, and reports in Implementation, Sandbox, Preview, and Customer Central, and can help explain why a rule did not fire. The concept topic describes that inspection as read-only. Workday says that with Configuration Cloud, in opt-in early access for Workday partners since 18 November 2026, Deployment Agent can carry out changes once approved. The design becomes real when someone edits the definition and activates security policy changes.

Translate one requirement into Workday’s three questions

The HCM core course states a business process as what, who, and when.

Line in the requirements note Workday object Constraint Workday documents
Line in the requirements noteWhat must happen Workday objectA step on a definition: action, approval, to do, subprocess, or another delivered step type Constraint Workday documentsYou do not invent a new business process type. You configure a delivered type. The payroll course says the same: you cannot create a brand-new business process; you create versions for organizations.
Line in the requirements noteWho does it Workday objectA security group on the step, and that group on the business process security policy Constraint Workday documentsThe policy secures initiate, approve, delegate, cancel, and the other actions for every definition of that type. A group on the step must be allowed by the policy. To do steps are the exception: they can be assigned to any active security group, but a task on that to do still requires the group to be able to open the task.
Line in the requirements noteWhen it happens Workday objectOrder, due date, delay, and a condition Constraint Workday documentsEntry conditions decide whether a step runs. Validation conditions, on initiation and action steps, stop the process when they are true. Exit conditions complete an approval chain or integration step. While-running conditions apply to approval chains.

Functional areas such as Staffing and Core Compensation contain both domains and business processes. Customers cannot change a delivered domain or the items secured to it. They grant security groups on the policy.

Inheritance before you copy a definition

Workday recommends a default definition. Copy or link an organization-specific definition only when the steps really differ. Maintenance is harder when every copy shares the same steps, and testing “the” definition is harder when several exist.

When someone starts the process, Workday looks for a definition on that organization, then on superiors, then the default. A definition with errors, or an inactive one, is skipped and inheritance continues. Effective date matters: a future-dated definition is not the one running today.

The setup topic adds the routing ingredients: organizations, roles, hierarchies, and locations. Business process security policies, not domain policies, decide who may participate and which actions they may take. Each step still names a security group. Workday also says to limit the number of steps for performance. Rule-based definitions can pick a path from the goal of the process, the initiator’s role, or another condition. You can copy and modify a large library of preconfigured processes; the setup topic says “over 550.”

A practical pass from the note to the definition

Do this in an Implementation tenant, or in Sandbox if you are changing a copy of Production. One requirement per pass.

  1. Name the delivered type. Hire, Change Job, and Propose Compensation for Hire are the HCM course’s common examples. Period Close Event is the course’s example of an accounting manager closing ledgers for operational transactions. If you cannot name the type, you are not ready to edit a definition.
  2. Open Business Process Configuration Options for that type and the security policy. The course tells you to use both.
  3. Ask Deployment Agent, in a new chat, with the tenant named:

I am a Workday administrator. In my tenant, which business process definition runs for [type] on [supervisory organization]? List the steps, the security group on each step, and any entry condition. If a default and an organization-specific definition both exist, say which inheritance will use.

Check two steps in the definition before you trust the list. Ask has no on-screen “inspection on” badge.

  1. Write the delta in the project record: step to add or remove, group, condition, effective date. Do not leave it in the chat. History lasts 14 days.
  2. Edit the business process security policy first if the new group is not allowed to act. Use Business Process Policy > Edit, then Activate Pending Security Policy Changes. Only then Business Process > Edit Definition.
  3. Add conditions with Create Condition Rule (the rule goes into the library) and Maintain Step Conditions (the rule is applied to the step). The course’s fields are And/Or, the source field or rule, the operator, and the comparison value.
  4. After a real event exists, use Business Process > Test Rule from that event. You need the Business Process Administration domain. Some entry conditions are delivered and cannot be edited; yours are evaluated as well, and the step runs only if all of them pass.

Worked example: “Managers must approve a title change”

The HCM course already uses Change Business Title as a pattern: the manager reviews the title, then the HR partner approves. Your note should say which supervisory organizations use that path. If only one organization differs, copy a definition for that organization rather than loading the default with exceptions. If the difference is a condition (“only when the worker is in this location”), keep the default and add an entry condition. The course says complex conditions on one definition can slow processing; organization-specific copies are easier to read and perform better, and they cost more to maintain.

Ask can explain the concept in lay terms first, using the knowledge-discovery capability, so the room agrees what an approval chain is. An approval chain walks a hierarchy until the top or an exit condition. A common exit is “only two managers.” That is course material to confirm in your definition, not a default you should assume is already configured.

Where security requirements hide

A requirements line such as “payroll specialists can see the bonus override” is not a business process step. It is a domain policy. Workday’s Ask example for that field is: which domain controls Bonus Plan Override, which groups have View, and how to update it. In Workday’s illustration the domain is Worker Data: Compensation Explicit and the role is missing View. Your tenant may differ. Edit the domain policy and activate it. The business process definition will not grant that view.

What the agent will get wrong if you let it design alone

Failure What to do
FailureIt proposes a new business process type What to doReject it. Configure a delivered type.
FailureIt names a security group that is not on the policy What to doThe step cannot use that group for a secured action. Edit the policy first.
FailureIt ignores a superior organization’s definition What to doWalk inheritance: organization, then superior, then default. Skip definitions that are in error or inactive.
FailureIt designs in Production chat What to doDeployment Agent is not a conversational assistant in Production. Design in Implementation or Sandbox.
FailureIt cites a condition you cannot find What to doOpen Maintain Step Conditions. Delivered entry conditions are not all editable.
FailureThe workshop treats the chat as the signed design What to doCopy the definition name, effective date, and step list into the project record the same day.

BP Optimize Agent is a separate Workday-built agent. The catalog says it analyzes current processes and recommends improvements with steps. It is not Deployment Agent, and this guide does not describe its setup. Do not assume it is active because Ask is.

Frequently asked questions

Can I paste a requirements document into Deployment Agent and get a definition?

You can paste one requirement and ask for the delivered type, the steps, and the groups, with “in my tenant.” As documented, you still edit the definition. A long document in one thread will be summarized. Split it.

Do domain security and business process security do the same job?

No. Domains secure tasks, reports, and data. The business process security policy secures actions on that process type. Both have to allow the person you named in the requirements note.

Should every country get its own definition?

Only when the steps differ. Otherwise use the default, or a rule-based definition, and keep one copy to test. The course warns that the right definition is easy to miss when many copies exist.

When is the design “done”?

When the definition you expect is the one inheritance selects, the groups are on the policy, pending security changes are activated, a test event fires the conditions you care about, and the project record names the definition and its effective date. An Ask answer is not that moment.

Sources checked

Public Workday course and admin-guide topics listed above, fetched 2026-11-16. Workday does not publish a business-requirements-document object on those pages.

Sources checked

Related guides

All guides

Let Workday check the work.

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

Get the next guide in your inbox.

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

We’ll email you once to confirm. Unsubscribe in one click from any issue.