QA (eng)

Documents generator

It’s not a secret that there are a lot of common features in a huge amount of different applications. That’s why it will be very useful to collect all this documents in one repository and make it open for everyone. At this repository analysts will be able to  collect their specifications, voting for other specifications and searching the best of them (according to previous votes of all users) for reuse.

Solving this task I see a lot of difficulties:

  1. All of my documents are confident and a have no opportunity to share them. But I have some documentation, which were created for my own ideas, and, of course, I can share them (they got only one minus – they were wrote at my native language and it’s not English).
  2. Not all of analysts ready to share their documents, because it’s the same like teaching your competitors.
  3. It could be quite hard to understand, what was wrote in each document, because each company have their own standard (in Russia everyone tries to prove, that they are working according RUP, IEEE, K. Wiegers books,…, but, as a saw, that is not true).
  4. And the last one – people are too lazy to post something, which, furthermore, connected with their job.

I decided that the first step should solve the problem of creating standardized specifications and the easiest way is to create application, which will not allow describing window/web frames in different ways (that is why I decline the idea of describing fields in Excel or Word documents).

At this point I was inspired by IBM Web Content Manager (WCM). It took about one hour to understand – how should I create web forms with amount of fields and their properties (as type, length and so on). I don’t know if it will be correct to add print screens here, but, hover, it will be easy for you to find them. So, according to WCM work process, it will be enough for analyst to specify – how/where fields should be displayed at GUI and their properties. After that, developer’s work will be decreased 2-3 times, but this is not a first step for me, and, furthermore:

  1. WCM cannot generate all of specifications, what we need at our projects.
  2. It’s too expensive while we are working only on non-portal solutions.
  3. It could work only with web frames, can’t include tables and so on.

Why I decided to made another one application on this theme

I’m educating some students (private courses) and they should understand next important things, which are easy to show on working application, which could be immediately modified:

  1. How to collect requirements
  2. How to provide impact analysis
  3. How to improve usability and make application user friendly
  4. How to work with non-functional requirements
  5. What attributes each field or table should have
  6. How to prepare a test plan for application

 Domain model

After my primary analysis of the problem – I’ll enumerate primary features for application, which will be able to generate such kind of specifications:

  1. Creating GUI description
  2. Adding fields and table parts
  3. Adding checks for input data
  4. Adding formulas for calculated fields
  5. Generating text description

This generator should be available from web or user should have an opportunity to install it on his PC without configuring database procedures. That is why it is appropriate to save all necessary data at xml-files.

Domain model:


In fact, I want to see many frames/GUI at project and I want to reuse one frame in other project. Then, I want each frame consist of fields (with opportunity of copying field and field’s property to another frame) and tables. Tables should consist of many frames and have their own attributes (for example, are they editable or not). And all of the verification procedures should be cross project entities.

Version 0.1

Today I made my first version, which, of course, not ready to use at my department. Nevertheless, application already has an export to XLS function and it is quite easy to understand how to work with it.



Day by day I’m planning to improve it quality and amount of useful features. I will add
description of my Frames for business analysts, rewrite dropdown lists, to make already added frames and field excluded. I have been working as analyst and QA for 6 years, so I have a complicated view on my program and all of the processes, which I’m planning to automate.

However, you will be able to download my application soon. It consists of executable JAR file and a BAT file. BAT file will help you to start my application. I didn’t want to made users install any additional software or database engines, that’s why application uses only XML files for storing information.


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.