2003 TextMaestro Technologies
Example 18: Make Report
You can make report in two distinct ways:
In a nutshell, (1) is used to dump the names and attributes of files found in a basket, while (2) is used to compare the contents of two or more baskets.
(1) Report on a set of files: Top
Launch TextMaestro. Suppose the current basket has the following files. We would like to make a report on them.
Often we work on a set of files and at the end of the day we want to tell the co-workers what we have worked on. Immediately we wonder, "How can I get the names of a group of files quickly?"
Sure, we can go to the corresponding directories and scrap off the name from cmd console or Windows Rename feature. But that's the hard way. There is an easier way with TextMaestro.
Select the files of interest and click on Report button (Ctrl+R). The dialog shown below will appear.
Note various fields in the list such as Local directory, Remote directory, File name, etc. You can move them up and down using Move up and Move down buttons. Use the check box before the field to include it for report. Also, note Gutter amount for each field, which you can modify using Modify button. Hit Reset to obtain default (shown above). Hit Report button seen on the dialog. The report will be displayed on the Input window. (See below).
If you check on Copy report to the clip-board, then the report placed on the Input window is also placed on the Windows clip-board. Therefore, your previous clip-board contents will be lost, and report will be available for next paste operation.
Report displayed on Input window:
Consider the following set up on Report dialog
for which the report is the following:
You get the idea. With more fields included in the report you will get more columns of text with or without gutters.
(2) Report on a set of baskets: Top
Suppose you have three versions of a package and you want an analysis of what happened from version to version. In particular, we care for the following things for two successive versions:
As an example, we have placed three versions of ias package in three different areas as follows:
TextMaestro can readily make a report on this information. Here are the steps.
Open TextMaestro. Add (F8) a new session if you choose to, or simply stay with the default session. Add (F7) three new baskets on top list namely:
as shown below.
Now we will propagate these three baskets with files from three packages residing in three different areas in your local system.
Below is the look after the files are added to Version 1 basket.
After files from
are populated into basket Version 1, repeat the process for the remaining two ias directories using Version 2 and Version 3 baskets.
Now that all three baskets are loaded with corresponding version of files, we are ready to proceed with the analysis.
Select all three baskets as shown here.
Then select Report button. Report dialog will appear, and select Baskets tab in that dialog as shown below
Accept default values as shown above. While most of the controls here are self explanatory, the control Compare Baskets by examining Local directory tree structure needs some elaboration. By selecting this option, you basically dictate that the files are in local area, and their local path should be used to construct the history on file addition and deletion. (See Technical 16: Report for details).
Hit Report button seen on the dialog. The report will be displayed on the Input window as shown below:
Here is the report in text form: