Developer Tools in AIA FP 2.3 - Part 1

We wanted to emphasize on the new features and functionalities added to FP 2.3. As part of the same we would be writing a 3 part series covering new tools/features added to FP 2.3. In this part we cover XSLT Document Generator and the common pitfalls and workarounds for the same.

XLST Document Generator
1) What is the tool?
The tool helps in generating documentation relating to the mapping information in the XSL file in HTML format. The tool comes handy in creation/updating contents of design document or creating/updation of test cases. The tool provides source column, target column, DVM and Cross reference details in tabular format

2) Where to find?
The tool can be found under AIA_HOME\Developer Tools\XSLDocGen

3) How to Execute?
a) Set the environment variables by running aiaenv.sh (if not done already). aiaenv.bat can be found under "AIA_HOME\bin" folder
b) Create input folder (say D:\inDir) and place the XSL file in the folder for which you want to generate the documentation
c) Create output folder (say D:\outDir)
b) Go to "AIA_HOME\Developer Tools\XSLDocGen\bin" folder
c) Execute generateMappingDoc batch file as shown below
generateMappingDoc inputDir=D:\inDir\(name of XSL file) outputFormat=html outputDir=D:\outdir
d) The tool will generate 2 files with the extensions XML and HTML in the output directory

4) Common pitfalls
1) Batch file (generateMappingDoc) might return an error saying "AIA Home not set correctly" in which case try changing the first line of the BATCH file from
set AIA_HOME=@AIA_HOME@
to the following
set AIA_HOME=%AIA_HOME%
2) XSL file and the related files should be placed in the input directory. For instance, BillOfMaterialsListEBMToCreateBOM.xsl and BillOfMaterialsListEBMToCreateBOM_Custom.xsl should both be placed in the input directory or else you will get an error
3) Not running aiaenv batch file also will return errors

Ramesh Chandra Revuru & Srinivas Mengerthi