IBM Cloud Authors: Liz McMillan, Yeshim Deniz, Pat Romanski, Elizabeth White, Karthick Viswanathan

Related Topics: IBM Cloud

IBM Cloud: Article

Strategies for Software Development Project Success – Part One of a Two-Part Series

Best Practices for Improving Project Success: The Importance of Synchronization

Unless you understood the specific needs of these two user groups when you were designing your application, you would risk creating a system that would not satisfy the requirements of either one.

Business use cases versus system use cases
Depending on the system in question, there may be a significant difference between business and system use cases. One depicts a user's business and the other a user's interaction with the system. However, the difference between these two types of use cases can become blurry. For example, in a software development business, the system IS the business. While you are developing and testing a specific system feature, it is easy to forget that the final user may not use the system the same way you do - or even have the same needs.

To understand the distinction between a business use case and a system use case, imagine that a software team has been charged with developing a software application that must perform equally well in different local environments around the globe. To ensure that the application meets these requirements, the team must comply with a set of minimum globalization rules.1 These rules are hard-coded in a set of specifications that cannot be modified at will. The development team needs to audit the code against these rules, and currently they must do this manually. A programmer (auditor) must open each source file and find any inconsistencies with the specified rules.

Here is an example of the business use case. It is one of the business use cases for reviewing some aspect of code quality, often a time consuming manual activity. For each source file in the workspace:

  1. Open the source file.
  2. Read the code line by line (note: requires deep coding knowledge).
  3. If you find a suspicious method, consult the Web page containing the rules (note: very time consuming).
  4. Resolve the problem by fixing the code, if possible (business use case for the developer).
    a. Alternative flow for the tester role: If you cannot fix the problem right away, document the finding in a Word document and submit it to the developer.
  5. Open the next source file and repeat the steps.
As you can see, this is a tedious process - some steps in the use case are manual and prone to user errors and therefore good candidates for automation to speed the process up. The focus of the business use case is the process with, or without any tools.

On the other hand the system use case focuses on the interactions of the user with the system - in our example a tool for automated validation of source code.

Example system use case

Precondition: Globalization rules are enabled in the code review feature of the IDE.

  1. Open the code review tool in the IDE.
    a. (Steps for opening the tool).
  2. Run code review.
    a. Main flow -- click on the button "Run."
    b. (List of alternative flows described in detail in a new section).
  3. Review the results of the automated review (findings).
  4. For each finding, resolve the finding:
    a. Main flow: Submit a defect.
    b. (List of alternative flows described in detail in a new section).
  5. If you cannot fix the code right away, submit a defect.
    a. (Steps for defect submission).
Often a system use case has a purpose of improving the business scenarios through the introduction of tools and automation that help improving the effectives of the user's business. A good system use case fits well in the user's business scenarios and use cases and improves them. The comparison of the two also provides an insight into the return of the investment (ROI) of the planned system.

The value of system use cases
Once you define the user's "as is" process and goals, you can specify what portion of the user's activities an automated system can supply. A short document with steps such as the ones described above would provide plenty of information to the reader on what the final product should look like, how it would help the customers with their business, and so forth -- even if this information is not explicitly spelled out.

Here are some obvious benefits of having a system use case for code reviews:

  • Even without having a line of code classified as "code review ready for testing," a tester can go ahead and create a test plan for the functionality described above.
  • In addition, at this point, a documentation person could go ahead and create and/or append the structure of the documentation for the code review.
  • The development manager could then optimize the development schedule, so that the first development build would satisfy at least the main flow of this use case.
Use cases accelerate the development project and engage all team members right at the beginning of the project. If you don't already focus your work around use cases, give them a try. The effort is well worth it.

Getting the right level of detail for system use cases
How much information should you include in each use case step?

My preference is to derive and group the system use cases around the business use cases and also group a number of user interactions under one group of steps. The group of steps explains the purpose of the step and is likely to remain unchanged if some detail in the implementation changes. This approach helps to make the document more readable, it connects the system use case with the business use case, and it allows the use case to be easily modified if the product implementation changes.

For example, the simple steps in our system use case above, "Run code review," convey a wealth of information to the careful reader, including:

  • Code review is integrated in the IDE.
  • Code review must be engaged, or "run."
  • Code review provides a list of findings about deviations from the set of validated standards.
  • Some of the findings have quick fixes.
  • Code review will have quick fixes.
3. Ensuring effective testing
Once the use cases are set in place and the team has agreed that they represent the right way to go, the use cases become the foundation for the rest of the plan. In fact, this is the only way to take advantage of the benefits they offer.

The engineering team builds a development plan that includes, at the very least, a list of components to be built and a timeframe for each of them. It is very important to create clear traceability between features needed for the main use cases and the components necessary for the features to work.

Identifying these core components and defining their use cases are crucial steps that allow early testing of the application functionality. If the core components are delivered early in the development cycle, then the tester can start writing test scripts for the basic set of rules and validate that the tool functions properly.

In our example, the system use case "Run code review" enabled the tester to make a test plan for this core functionality even before the code was written and also to create a set of manual test scripts for both the main flow and alternative options.

Types of testing
The simplest form of testing -- and a very effective one -- is to assemble a number of educated users to exercise various features of the application under test and report issues (findings, defects) to the code development team. The metrics for this form of validation are simple: The more users you have, the more defects you'll detect. Different user groups will use the tool in different ways and further improve the number of detected problems. However, there are some issues related to this. By the time the software is ready for user consumption, there may not be enough time to launch an extensive test program. Different users may be on different product builds. Even more important, depending entirely on human beings is very expensive and very unreliable.

More Stories By Goran Begic

Goran Begic is a Senior IT Specialist with IBM.

Comments (0)

Share your thoughts on this story.

Add your comment
You must be signed in to add a comment. Sign-in | Register

In accordance with our Comment Policy, we encourage comments that are on topic, relevant and to-the-point. We will remove comments that include profanity, personal attacks, racial slurs, threats of violence, or other inappropriate material that violates our Terms and Conditions, and will block users who make repeated violations. We ask all readers to expect diversity of opinion and to treat one another with dignity and respect.

@ThingsExpo Stories
Digital Transformation and Disruption, Amazon Style - What You Can Learn. Chris Kocher is a co-founder of Grey Heron, a management and strategic marketing consulting firm. He has 25+ years in both strategic and hands-on operating experience helping executives and investors build revenues and shareholder value. He has consulted with over 130 companies on innovating with new business models, product strategies and monetization. Chris has held management positions at HP and Symantec in addition to ...
Cloud-enabled transformation has evolved from cost saving measure to business innovation strategy -- one that combines the cloud with cognitive capabilities to drive market disruption. Learn how you can achieve the insight and agility you need to gain a competitive advantage. Industry-acclaimed CTO and cloud expert, Shankar Kalyana presents. Only the most exceptional IBMers are appointed with the rare distinction of IBM Fellow, the highest technical honor in the company. Shankar has also receive...
Enterprises have taken advantage of IoT to achieve important revenue and cost advantages. What is less apparent is how incumbent enterprises operating at scale have, following success with IoT, built analytic, operations management and software development capabilities - ranging from autonomous vehicles to manageable robotics installations. They have embraced these capabilities as if they were Silicon Valley startups.
Poor data quality and analytics drive down business value. In fact, Gartner estimated that the average financial impact of poor data quality on organizations is $9.7 million per year. But bad data is much more than a cost center. By eroding trust in information, analytics and the business decisions based on these, it is a serious impediment to digital transformation.
The standardization of container runtimes and images has sparked the creation of an almost overwhelming number of new open source projects that build on and otherwise work with these specifications. Of course, there's Kubernetes, which orchestrates and manages collections of containers. It was one of the first and best-known examples of projects that make containers truly useful for production use. However, more recently, the container ecosystem has truly exploded. A service mesh like Istio addr...
Predicting the future has never been more challenging - not because of the lack of data but because of the flood of ungoverned and risk laden information. Microsoft states that 2.5 exabytes of data are created every day. Expectations and reliance on data are being pushed to the limits, as demands around hybrid options continue to grow.
As IoT continues to increase momentum, so does the associated risk. Secure Device Lifecycle Management (DLM) is ranked as one of the most important technology areas of IoT. Driving this trend is the realization that secure support for IoT devices provides companies the ability to deliver high-quality, reliable, secure offerings faster, create new revenue streams, and reduce support costs, all while building a competitive advantage in their markets. In this session, we will use customer use cases...
Business professionals no longer wonder if they'll migrate to the cloud; it's now a matter of when. The cloud environment has proved to be a major force in transitioning to an agile business model that enables quick decisions and fast implementation that solidify customer relationships. And when the cloud is combined with the power of cognitive computing, it drives innovation and transformation that achieves astounding competitive advantage.
Digital Transformation: Preparing Cloud & IoT Security for the Age of Artificial Intelligence. As automation and artificial intelligence (AI) power solution development and delivery, many businesses need to build backend cloud capabilities. Well-poised organizations, marketing smart devices with AI and BlockChain capabilities prepare to refine compliance and regulatory capabilities in 2018. Volumes of health, financial, technical and privacy data, along with tightening compliance requirements by...
DevOpsSummit New York 2018, colocated with CloudEXPO | DXWorldEXPO New York 2018 will be held November 11-13, 2018, in New York City. Digital Transformation (DX) is a major focus with the introduction of DXWorldEXPO within the program. Successful transformation requires a laser focus on being data-driven and on using all the tools available that enable transformation if they plan to survive over the long term. A total of 88% of Fortune 500 companies from a generation ago are now out of bus...
With 10 simultaneous tracks, keynotes, general sessions and targeted breakout classes, @CloudEXPO and DXWorldEXPO are two of the most important technology events of the year. Since its launch over eight years ago, @CloudEXPO and DXWorldEXPO have presented a rock star faculty as well as showcased hundreds of sponsors and exhibitors! In this blog post, we provide 7 tips on how, as part of our world-class faculty, you can deliver one of the most popular sessions at our events. But before reading...
DXWordEXPO New York 2018, colocated with CloudEXPO New York 2018 will be held November 11-13, 2018, in New York City and will bring together Cloud Computing, FinTech and Blockchain, Digital Transformation, Big Data, Internet of Things, DevOps, AI, Machine Learning and WebRTC to one location.
DXWorldEXPO LLC announced today that ICOHOLDER named "Media Sponsor" of Miami Blockchain Event by FinTechEXPO. ICOHOLDER give you detailed information and help the community to invest in the trusty projects. Miami Blockchain Event by FinTechEXPO has opened its Call for Papers. The two-day event will present 20 top Blockchain experts. All speaking inquiries which covers the following information can be submitted by email to info@dxworldexpo.com. Miami Blockchain Event by FinTechEXPO also offers s...
DXWorldEXPO | CloudEXPO are the world's most influential, independent events where Cloud Computing was coined and where technology buyers and vendors meet to experience and discuss the big picture of Digital Transformation and all of the strategies, tactics, and tools they need to realize their goals. Sponsors of DXWorldEXPO | CloudEXPO benefit from unmatched branding, profile building and lead generation opportunities.
Dion Hinchcliffe is an internationally recognized digital expert, bestselling book author, frequent keynote speaker, analyst, futurist, and transformation expert based in Washington, DC. He is currently Chief Strategy Officer at the industry-leading digital strategy and online community solutions firm, 7Summits.
The best way to leverage your Cloud Expo presence as a sponsor and exhibitor is to plan your news announcements around our events. The press covering Cloud Expo and @ThingsExpo will have access to these releases and will amplify your news announcements. More than two dozen Cloud companies either set deals at our shows or have announced their mergers and acquisitions at Cloud Expo. Product announcements during our show provide your company with the most reach through our targeted audiences.
The IoT Will Grow: In what might be the most obvious prediction of the decade, the IoT will continue to expand next year, with more and more devices coming online every single day. What isn’t so obvious about this prediction: where that growth will occur. The retail, healthcare, and industrial/supply chain industries will likely see the greatest growth. Forrester Research has predicted the IoT will become “the backbone” of customer value as it continues to grow. It is no surprise that retail is ...
Andrew Keys is Co-Founder of ConsenSys Enterprise. He comes to ConsenSys Enterprise with capital markets, technology and entrepreneurial experience. Previously, he worked for UBS investment bank in equities analysis. Later, he was responsible for the creation and distribution of life settlement products to hedge funds and investment banks. After, he co-founded a revenue cycle management company where he learned about Bitcoin and eventually Ethereal. Andrew's role at ConsenSys Enterprise is a mul...
DXWorldEXPO LLC announced today that "Miami Blockchain Event by FinTechEXPO" has announced that its Call for Papers is now open. The two-day event will present 20 top Blockchain experts. All speaking inquiries which covers the following information can be submitted by email to info@dxworldexpo.com. Financial enterprises in New York City, London, Singapore, and other world financial capitals are embracing a new generation of smart, automated FinTech that eliminates many cumbersome, slow, and expe...
Cloud Expo | DXWorld Expo have announced the conference tracks for Cloud Expo 2018. Cloud Expo will be held June 5-7, 2018, at the Javits Center in New York City, and November 6-8, 2018, at the Santa Clara Convention Center, Santa Clara, CA. Digital Transformation (DX) is a major focus with the introduction of DX Expo within the program. Successful transformation requires a laser focus on being data-driven and on using all the tools available that enable transformation if they plan to survive ov...