May 2017 Newsletter

May Already

Since our last newsletter: We sincerely hope that those of you who celebrate Easter had a nice break and are not too full of Easter Eggs!   We’ve also had an Activity Diagram to celebrate St. George’s day and tried to conquer the Universe on Star Wars Day with some Functional Modelling. That aside development continues on Cradle 7.3.

New Voices

We’ve expanded the writing team to include authors from elsewhere in the 3SL team. Because this is a blog, there is more emphasis on people’s personal insights into the Cradle product. This should make the style and tone more varied and hopefully more interesting to read.

As you may have already seen the 3SL-Blog is groaning full of new articles. These are mainly “Hints and Tips” and longer RM/SE articles. Increasingly we’ve found that some of the support questions that arrive here in 3SL towers are very similar. To that end we’re publishing them under the FAQ section.

If you have a burning question and would like to see an article covering a particular topic, drop us a line at social-customer@threesl.com and we’ll see what we can do. On the other hand, if you have a novel use of Cradle that you’re happy to share with us, drop us a line with the article, screen shots and accreditation details and we may feature it.

Non Graphic Interfaces

There is widespread understanding of the WorkBench and even Web Access interaction with Cradle. It is, after all the main way we interact with the data. However, there are many occasions when we want some of the data from Cradle but don’t want to or can’t use a screen to interact. This month we’re highlighting c_table.

c_table

This command line utility can be used to produce Reports, Matrices, Metrics, Graphs or Queries in a tabular form. This can be an HTML, RTF, CSV or SVG output. If every morning you need to go into a meeting, or stand at your ‘toolbox talk’ with a printed report detailing the number of ‘Issues’ with a category of ‘Raised’ you can do this by running one command. Creating a desktop short cut to run the command / batch file you need not start WorkBench just to run the query and publish the result. Even more cunningly a script could be triggered at 8:00am every morning to create the document for you.  Our blog article “Batch File Reporting in Cradle” adds more detail.

CompeteFor

If you are working or bidding on large infrastructure projects,  Cradle is now available through the CompeteFor procurement portal. Whatever the size of your Requirements Management or Systems Engineering task, Cradle is there from Concept to Creation.

Social Media

Twitter

May Day 2017 Madness Giveaway. Thanks to all those who re-Tweeted and followed @threesl, during our Twitter #FreebieFriday giveaway and congratulations to @baguettio, who won a copy of Cradle RM Desktop. It was really great to see re-Tweets from around the globe.

Hints of the Month

Here are some links to helpful topics since our last newsletter, they should improve your Cradle experience:

When working in large teams or over a long period an item’s edit history is very useful. See the LinkedIn discussion Who Changed That? When? Why?

When you have many items to submit all in one go, selecting them on the screen and submitting them is not practical. This article Configuration Management – Submit by Query discusses the alternative.

You can read Hints & Tips in the 3SL Blog.

Batch File Reporting in Cradle

Publishing Reports

Do you want to run your reports faster or wish you could run them overnight or at weekends so they are ready when you arrive at work in the morning? With batch file reports, you can do this quickly and easily.

What is a Batch File?

A batch file contains a series of DOS commands, and is commonly written to automate frequently performed tasks including publishing reports and documents. Instead of typing the same commands over and over in a Command Prompt, you can simply double-click the batch file or use Windows Task Scheduler to set it running during down times e.g. over night or weekends which then creates all the reports you require.

The following report will show you how to create a batch file for these reports.

How to Write a Batch File for Reporting

Using a plain text application like Notepad, you need to first set the folder the application to be used is in. In this case, it is in the same place all Cradle applications are held, the command does need to be surrounded by quotes

“%CRADLEHOME%\bin\exe\windows\c_table.exe”

You then need the login information to the project that you would normally would when using a Command Prompt.

-login admin,ADMIN,demo or -login reqman,REQMAN,demo

After these 2 necessary parts, you need the options for the report; you can find these options in our online Help System for c_table. If you are already in the Command Prompt in the correct location then just type in c_table and you will see the Information popup.

Information on command options for c_table to use in batch file reporting
C_Table Command Options

Once you have finished writing you batch file, the command should look something like this:

"%CRADLEHOME%\bin\exe\windows\c_table.exe" -login reqman,REQMAN,demo -file "C:\Temp\Project_Setup_Demo.rtf" -report Project_Setup -rloc project -format rtf

You can use c_table to publish data from a matrix:

"%CRADLEHOME%\bin\exe\windows\c_table.exe" -login reqman,REQMAN,demo -file "C:\Temp\Coverage.htm" -matrix "Requirement Coverage" -mloc project -format html

Metrics can be published in the same way:

"%CRADLEHOME%\bin\exe\windows\c_table.exe" -login reqman,REQMAN,demo -file "C:\Temp\Project Analysis.htm" -metric "Project Analysis" -metloc project -format html

Graphs can be displayed in html, rtf or svg

"%CRADLEHOME%\bin\exe\windows\c_table.exe" -login reqman,REQMAN,demo -file "C:\TempVerified Requirements.htm" -graph "Verified requirements" -gloc project -gprint batch -gprloc project -format html

You can publish queries using different views:

"%CRADLEHOME%\bin\exe\windows\c_table.exe" -login reqman,REQMAN,demo -file "C:\Temp\Requirements All.rtf" -query "Requirements - All" -qloc project -view "Requirement - Complete" -vloc project -format rtf

You can also publish comma separated data into a csv file:

"%CRADLEHOME%\bin\exe\windows\c_table.exe" -login reqman,REQMAN,demo -file "C:\Temp\Requirememts_All.csv" -query "Requirements - All" -qloc project -view "Requirement - Complete" -vloc project -format csv

Remember to put quotes around any options with spaces in them e.g. “Requirements – All”

Save this file using the DOS extension of .bat e.g. batch file reports.bat

How to Run a Batch File for Reports

Running a batch file is simple, as long as all the options in the commands are correct; just double click on the .bat file. You will see a Command Prompt open and as each report finished, the next will begin.

Command prompt with some of the command lines used in the Batch File Reports
Command Lines for Batch File Reporting
Showing some of the reports from the batch files within the set folder. The folder in this case is the Temp folder on the C drive
Reports in the Temp Folder

As you will see running batch file reports is quicker and easier. You can also then add any reports you require to the file. The newly added reports are then also published the next time you run the batch file.

If you wish to use Task Scheduler for out of hour’s usage, you can find information here on the Microsoft website.

You can also use batch files for import and exporting through the c_io, publishing documents through Document Publisher  and converting CSV information into a Cradle import/export file for loading into a Cradle PDB using the CSV Converter Utility.