examples/AMW_HOT_MantisBugzilla/AMW_HOT_MantisBugzilla_doc.php

<?php  																														require_once($_SERVER['DOCUMENT_ROOT'] . "/eclipse.org-common/system/app.class.php");	require_once($_SERVER['DOCUMENT_ROOT'] . "/eclipse.org-common/system/nav.class.php"); 	require_once($_SERVER['DOCUMENT_ROOT'] . "/eclipse.org-common/system/menu.class.php"); 	$App 	= new App();	$Nav	= new Nav();	$Menu 	= new Menu();		include($App->getProjectCommon());    # All on the same line to unclutter the user's desktop'

	#*****************************************************************************
	#
	# AMW_HOT_MantisBugzilla_doc.php
	#
	# Author: 		Marcos Didonet Del Fabro
	# Date:			2005-07-15
	#
	# Description: Type your page comments here - these are not sent to the browser
	#
	#
	#****************************************************************************
	
	#
	# Begin: page-specific settings.  Change these. 
	$pageTitle 		= "Translating Mantis to Bugzilla using AMW and ATL";
	$pageKeywords	= "";
	$pageAuthor		= "Marcos Didonet Del Fabro";
	
	# Paste your HTML content between the EOHTML markers!	
	$html = <<<EOHTML

<!-- Main part -->
	<div id="midcolumn">
		<table width="100%">
			<tr>
				<td width="50%">
					<h1>$pageTitle</h1>
				</td>
			</tr>
		</table>

		<p>        
			This example is a complete scenario that uses the weaving model from the example 
			"Weaving Mantis
			and Bugzilla bug trackers" to generate an ATL transformation.
			This transformation translates a model 
			conforming to the Mantis.ecore metamodel into a model conforming to the Bugzilla.ecore metamodel.
			<p/>
		<h2>Instructions</h2>
	
		<h4>Loading the weaving model into AMW:</h4>
		The weaving model (models/mw_mantis_bug.ecore) can be loaded by double-clicking on the
		file (if using the latest release). 
		<br/> 
			
		<h4>Executing the transformations</h4>
		
		<p/>
			There is an Ant Script (scripts/executeAll.xml) that takes the models/mantis_model.ecore file, 
			and automatically produces a Bugzilla_model.ecore file. 
			It executes the following actions:
		<ul class="midlist">

		<li>
			the weaving model (models/mw_mantis_bug.ecore) contains links between the 
			metamodels/Mantis.ecore metamodel and
			the metamodels/Bugzilla.ecore metamodel,
		</li>			
		<li>
		    executes the ATL HOT (hot/AMWtoATLMantisBug_.atl) that takes the weaving model mw_mantis_bug.ecore as input
		    and produces the ATL model (output/Mantis2Bug.ecore) conforming to the ATL metamodel,
		</li>
		<li>
			extracts the ATL model into an ATL file (output/Mantis2Bug.atl),
	    </li>
		<li>
			executes the ATL transformation (Mantis2Bug.atl). This transformation takes the mantis_model.ecore model as input
			and produces the Bugzilla model (output/Bugzilla_model.ecore) as output,
		</li>

		</ul>
		
		<p/>
		<b>Remarks:</b></br>		
		<ul class="midlist">
		<li>
			The HOT and the Mantis2Bug transformations can be executed separatedly as well. 
			Each transformartion has a predefined "launch configuration" file. <br/>
		</li>
		<li>
			There is one Ant scripts to execute the 
			the extraction of ATL models(ATLExtractor.xml). 
			The files in the scripts/ folder are mandatory
			files to execute the Ant Scripts.			
		</li>
		<li>
			When the ATL model is extracted into Mantis2Bug.atl, the Mantis2Bug.asm file is generated by the
			ATL engine. It is possible that the executeAll.xml script tries to execute the transformation
			before it is extracted (in the first time the script is executed),
			causing an error. To solve this issue the script needs to be executed a second time.
		</li>
		</ul>
		<p/>

	</div>
	
EOHTML;


	# Generate the web page
	$App->generatePage($theme, $Menu, $Nav, $pageAuthor, $pageKeywords, $pageTitle, $html);
?>