Eight Steps to Crafting a Business Rule (Part 1)

Kristen   Seer
Kristen Seer Senior Consultant, Business Rule Solutions, LLC Read Author Bio || Read All Articles by Kristen Seer

In this series of articles, I will describe eight steps to crafting a business rule.  I use the term 'crafting' intentionally because I believe that writing an accurate, complete, and comprehensible business rule is more art than science.  It takes a certain skill, discipline, and (dare I say) craftsmanship.

However, I also believe that there are certain techniques you can use to help you achieve the goal of writing business rules in a consistent fashion.

This eight-step approach arose out of training that I developed for a client based on the RuleSpeak® technique developed by Ron Ross and Gladys Lam (who are both very familiar to readers of these pages).  It originally started out as six steps, but then Gladys and Ron did their magic with it and — presto chango! — it became eight steps.

The approach is intended as a practical guide that any Business Analyst (BA) can use when tasked with writing business rules.

The eight steps are:

  1. Extract the business rule.
  2. Determine whether the business rule already exists.
  3. Determine whether the business rule computes or derives something.
  4. Start with the subject.
  5. Choose the form of the business rule keyword.
  6. Say something about the subject.
  7. Add the condition(s).
  8. Make sure the business rules all fit together.

This month's article will focus on Step 1.

Step 1:  Extract the Business Rule.

There are numerous sources for a business rule, so the first decision is to determine what is the best (sometimes called "trusted") source for the set of business rules within your scope.

The most common sources are:

  1. Subject Matter Experts (SMEs).
  2. Documents (both business and technical).

Source:  Subject Matter Experts

If you are dealing with SMEs, whether in an interview or a facilitated session, the important thing is to know what questions to ask to elicit the information you need.  You don't need to know the ins and outs of the business area — that's the SME's job.  You just need to provide the structure and techniques to drive out the business rules.

As there is already lots of material on interviewing and facilitation techniques, I won't go into that here.  Just make sure you have the right people in the room, are fully prepared, and know what you want to get out of each session.

The outcome of the interview or facilitated session should be a set of business rules in draft form.  Sometimes it is possible to be very close to the final form of the business rule, but, more often, you come out of the session with a very rough draft.

Source:  Documents

Whether you're dealing with business or technical documents, it is important to understand two things:

  1. The purpose of the document.
  2. The intended audience.

Documents always have a specific purpose.  The purpose drives the way the document is structured as well as the vocabulary used in the document.  For example, a document describing a product or service that is handed out to customers might follow the way a customer would ask questions about the topic.  The document might also use very basic language rather than industry-speak.

The intended audience has an impact on the perspective and tone of the document.  For example, a customer-facing website might use "you" as the perspective to make the customer feel comfortable.  It would likely be written in a very friendly tone.  Legislation, however, tends to be targeted to a broad audience and is often formal in tone.

Understanding the purpose and intended audience of your source documents will help to identify what you need to focus on and what you can ignore.

Once you understand the purpose and audience, read the document (or relevant sections) from end-to-end without thinking about the rules.  If, after the first read-through, you're totally confused and have no idea how you're going to extract the rules, don't panic!  It happens to me all the time.  Re-read the document a few more times to get comfortable with the language, the structure, and what it's trying to say.

Now you're ready to roll up your sleeves and extract the rules:

  • Using a pencil or highlighter, go through the document and highlight the business terms (aka nouns) that keep cropping up in the document.

  • Look for rule-ish words that indicate some kind of constraint, restriction, or limitation such as 'must', 'should', 'will', 'have to', 'shall', 'only' or 'may'.  Also look for statements that must be true or false.

  • Look for words that might indicate a computation.  This includes words like 'total', 'sum', 'add', 'subtract', 'multiply', 'divide', 'is calculated as', and any kind of number.

  • Look for anything that indicates a derivation.  This usually involves giving something a special name or qualifying it in some way (e.g., "overdue invoice") and providing conditions for determining whether it is true or false (e.g., "An overdue invoice is an invoice that hasn't been paid more 30 days from the invoice date.").

As you go through the document, always keep scope in mind.  There is often a lot of "fluff" or irrelevant information that you can ignore.  Understanding your scope helps you focus on the important parts.

A few times in my career, I have been asked to extract business rules from program code.  It's very difficult to do and doesn't always produce the desired results.  If you're in that situation, make sure to team up with a developer who can guide you through the code.  And try not to get bogged down in the system rules — look for true business rules.

Now that you are comfortable with the source material, you are ready to systematically go through the next six steps with each potential business rule you've highlighted.  The last step involves checking that the whole set of rules works together.

Next month, I'll talk about Step 2 — determining whether the business rule already exists.

References

Ronald G. Ross with Gladys S.W. Lam, Building Business Solutions:  Business Analysis with Business Rules, An IIBA® Sponsored Handbook.  Business Rule Solutions, LLC (October 2011), 304 pp.  URL:  http://www.brsolutions.com/bbs

Gladys S. W. Lam, "Family Reunion... Facilitated Session… Having the Right People Doing the Right Things," Business Rules Journal, Vol. 5, No. 6 (June 2004), URL:  http://www.BRCommunity.com/a2004/b194.html

For more information on the RuleSpeak® technique, visit http://www.rulespeak.com

# # #

Standard citation for this article:


citations icon
Kristen Seer, "Eight Steps to Crafting a Business Rule (Part 1)" Business Rules Journal, Vol. 13, No. 7, (Jul. 2012)
URL: http://www.brcommunity.com/a2012/b658.html

About our Contributor:


Kristen   Seer
Kristen Seer Senior Consultant, Business Rule Solutions, LLC

Kristen Seer is a Senior Consultant with Business Rule Solutions, LLC. She has worked as a business analyst in industries such as retail, pharmaceuticals, insurance, finance, energy and government.

Her practice focuses on helping clients introduce the business rules approach, including setting up centers of excellence, conducting training in the IPSpeak™ Business Rules Methodology, mentoring business analysts, facilitating sessions to capture business rules, harvesting rules from source documents, redesigning business processes, and analyzing decisions.

Her thirty-year career has encompassed roles as business analyst, rule analyst, data analyst, and project manager. Kristen is a regular speaker at the annual Building Business Capability conference (www.buildingbusinesscapability.com) and has written several articles published in the Business Rule Journal (www.brcommunity.com).

Read All Articles by Kristen Seer
Subscribe to the eBRJ Newsletter
CONTRIBUTOR ARCHIVES
The Perfect Rule Management Tool (Part 2)
The Perfect Rule Management Tool (Part 1)
The Perfect Deliverable
The Perfect Methodology (Part 2)
The Perfect Methodology (Part 1)
In The Spotlight
 John A. Zachman
';
The Issue Is THE ENTERPRISE By John A. Zachman Jan. 2017 | Vol. 18, Iss. 1
 Silvie  Spreeuwenberg
The BRSolutions Professional Training Suite

BRSolutions Professional Training Suite

All About Concepts, Policies, Rules, Decisions & Requirements
We want to share some insights with you that will positively rock your world. They will absolutely change the way you think and go about your work. We would like to give you high-leverage opportunities to add value to your initiatives, and give you innovative new techniques for developing great business solutions.