Translation Scripts

Overview

gmStudio makes extensive use of XML scripts to direct the translation process.

Translation Scripts

A Translation Script is a text file in XML format that contains a collection of migration commands.  

Every migration task in your migration project can be assigned a different translation script template to direct its unique process. Typically, all of the tasks in a migration project use the same template script.

One of the standard templates (Interoped-Externals Template for VB6 Migrations) is annotated below:

<gmBasic>
<!-- create a storage area for the semantic model -->
 
<Storage Action="Create" Identifier="%JobId%" />
 
<!-- set translation options -->
 
<Select Progress="1" />
<Select DevEnv="%DevEnv%" />
<Select Dialect="%Dialect%" />
 
<!-- set directories for deployment and external assemblies -->
 
<Select DeployLocation="%NetProjFolder%" />
<Select Library="%InteropFolder%" />
 
<!-- set directories for IDF file and other config files -->
 
<select Target="%UserFolder%" />
<Select Local="%IdfFromCodeFolder%" />
<Select System="%IdfFromIdlFolder%" />
 
<!-- compile code and build initial semantic model -->
 
<Compile Project="%SrcPath%" />
 
<!-- analyse/transform semantic model -->
 
<Analyse />
 
<!-- set output file path and author target code -->
 
<Output Status="New" Filename="%BndPath%" />
 
<Author />
 
<!-- close and save the semantic model file -->
 
<Storage Action="Close" />
 
</gmBasic>

Translation Script Parameters

Before gmStudio runs the translation, it edits a number of parameter place holders in the script. The use of parameters generalizes the scripts for use with multiple migration units. These parameters are described in the table below:

Default Script Templates

gmStudio ships with four default Translation Script templates:

• tran.vbp_std.xml: For VB6 Migrations using the Interoped Externals Strategy 
• tran.vbp_bld.xml: For VB6 Migrations using the Prototype Externals Strategy 
• tran.asp_std.xml: For ASP Migrations using the Interoped Externals Strategy  
• tran.asp_bld.xml: For ASP Migrations using the Prototype Externals Strategy

The standard templates are small XML files located in the [INSTALLDIR]\support\settings folder.

You may modify the standard templates or create your own.

The names of the default scripts are specified in the application config file.

When you create a migration project, gmStudio creates a copy of the appropriate script template and places it in the workspace\usr folder. This copy will be associated with the migration tasks and used going forward.

You can change the script associated with a migration task by editing the TScript field on the task record. 

Standard Script Templates Compared

As a brief introduction to Translation Scripting, let us compare these standard scripts.

COM Interop vs. COM Stub Prototypes

Comparing the following files:

• tran.vbp_std.xml: For VB6 Migrations using the Interoped Externals Strategy  
• tran.vbp_bld.xml: For VB6 Migrations using the Prototype Externals Strategy

shows differences in three sections

<if lang="csh">
   <Registry type="guid" source="Project" target="{7EE74E01-07B7-4C4F-B053-895BB67A3A51}" />
   <Registry type="guid" source="ProjectType1" target="{349C5851-65DF-11DA-9384-00065B846F21}" />
   <Registry type="guid" source="ProjectType2" target="{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}" />
   <Registry type="guid" source="Flavor" target="{349C5851-65DF-11DA-9384-00065B846F21}" />
</if>
<if lang="vbn">
   <Registry type="guid" source="Project" target="{CE8BB43C-9A4F-4900-AFD0-A4C18D1C30B1}" />
   <Registry type="guid" source="ProjectType1" target="{349C5851-65DF-11DA-9384-00065B846F21}" />
   <Registry type="guid" source="ProjectType2" target="{F184B08F-C81C-45F6-A57F-5ABD9991F28F}" />
   <Registry type="guid" source="Flavor" target="{349C5851-65DF-11DA-9384-00065B846F21}" />
</if>

Preparing an ASP solution

1) Prepare to do the first translation: generate IDFS, setup registry-libname, etc.

2) Work through the pages one at a time: add registry-fixtype and PostEdits to the Page Template Script, and compile refactors and fixes to GlobalSettings.xml. You may also develop cross-page artifacts such as custom IDFs, refactor files, and script includes. Step 2 produces the solo page solution: a Page Template Script and supporting files that can be used to generated the "one page site" for each page that builds.

For ASP, PreEdits and Compile\Refactors are mainly done at the file level in usr\GlobalSettings.xml PostEdits are added to the Author block in the template -- unfortunately this means that all of Page Actual Scripts contain PosdtEdits all pages, not ideal, but generally not harmful. Also, for ASP, many of the PostEdits will apply to many of the pages, so "all for all" is probably more appropriate than trying to minimize the set of PostEdits for each page.

3) Generate the Site Template Script from the Page Template Script (Report\Utilities\Multi-Unit Script)  in theory the only difference is that the Site Template Script has Compile PageSlices for all pages explicitly while the Page Template Script has just one parameterized Compile, <Compile PageSlice="%SrcPath%">.

4) Work through any Site translations issues and make adjustments to the Site Template Script until the web application for the entire site builds.