|
|
| (16 intermediate revisions by 5 users not shown) |
| Line 1: |
Line 1: |
| − | MoDisco workflow provides a mechanism to initialize and launch a workflow of discoverers, generators and model transformations. This project uses mainly two existing components in eclipse platform: LaunchConfiguration and MWE (Model Workflow Engine).
| + | #REDIRECT [[MoDisco/Components/Workflow]] |
| − | | + | |
| − | ==Requirements==
| + | |
| − | To use the plug-in you need:
| + | |
| − | * JDK 1.5 or above
| + | |
| − | * Eclipse Modeling Ganymede SR2 (Version: 3.4.2) because it incorporates JET, QVTo and ATL.
| + | |
| − | | + | |
| − | ==Install MoDiscoWorkflow==
| + | |
| − | | + | |
| − | ===Install===
| + | |
| − | Follow these various steps:
| + | |
| − | * Open Eclipse platform
| + | |
| − | * Click on the "Help" menu of Eclipse
| + | |
| − | * Click on the "Software Updates" menu
| + | |
| − | * Click on the "Available software" thumbnail
| + | |
| − | * Click on the "Add site" button
| + | |
| − | * Enter this address: http://... (soon in MoDisco)
| + | |
| − | * Click on the "Ok" button.
| + | |
| − | * Choose your drivers and select "Plug-in MoDiscoWorkflow".
| + | |
| − | * Click on the "Install..." button
| + | |
| − | | + | |
| − | ===Dependencies errors===
| + | |
| − | After you clicked on the "Install..." button, you could have any dependencies errors. In that case, you must install the missing packages at the origin of the errors. Then restart the operation.
| + | |
| − | | + | |
| − | [[Image:-MoDiscoWorkflow-ErrorDependency.png|320x340px|center|thumb|Example of dependencies errors]] | + | |
| − | | + | |
| − | If you didn't have dependencies errors, click on the "Finish" button. The installation of the MoDiscoWorkflow plug-in and his selected drivers is finished. Congratulation!
| + | |
| − | | + | |
| − | ==Build your MoDiscoWorkflow==
| + | |
| − | | + | |
| − | ===The user interface of MoDiscoWorkflow===
| + | |
| − | | + | |
| − | To reach MoDiscoWorkflow plug-in user interface, you have to click on this button [[image:-MoDiscoWorkflow-Execution.png]] and then click on the “Run Configuration” menu.
| + | |
| − | | + | |
| − | [[Image:-MoDiscoWorkflow-PluginCentral.png|400x283px|center|thumb|User interface of MoDiscoWorkflow]]
| + | |
| − | | + | |
| − | You can now build your MoDiscoWorkflow. Various properties are proposed to you:
| + | |
| − | * Add a MoDiscoWork in the MoDiscoWorkflow from the “New…” button
| + | |
| − | * Edit a MoDiscoWork from the button “Edit…”
| + | |
| − | * Remove a MoDiscoWork from the button “Remove”
| + | |
| − | * Up a MoDiscoWork in the MoDiscoWorkflow from the “Up” button
| + | |
| − | * Down a MoDiscoWork in the MoDiscoWorkflow from the “Down” button
| + | |
| − | * Load a MoDiscoWork in the MoDiscoWorkflow from the “Load…” button
| + | |
| − | | + | |
| − | ===Create a MoDiscoWork===
| + | |
| − | | + | |
| − | After having clicked on the "New.." button, you must choose the type of transformation you want to add. According to the installed drivers, you have more or less choice.
| + | |
| − | | + | |
| − | [[Image:-MoDiscoWorkflow-New.png|200x200px|center|thumb|Choice of transformation type]]
| + | |
| − | | + | |
| − | After choosing the type of MoDiscoWork, click on the "Next" button to configure your transformation. For the example, we have chosen "Transformation Java". Now, you can configure your MoDiscoWork of java type.
| + | |
| − | | + | |
| − | [[Image:-MoDiscoWorkflow-AddMoDiscoWorkJava.png|368x300px|center|thumb|Add a MoDiscoWork of java type]]
| + | |
| − | | + | |
| − | ===Edit a MoDiscoWork===
| + | |
| − | To edit a MoDiscoWork, click on the “Edit…” button after selecting the desired MoDiscoWork. A new wizard opens to configure the selected MoDiscoWork.
| + | |
| − | | + | |
| − | ===Remove a MoDiscoWork===
| + | |
| − | | + | |
| − | [[Image:-MoDiscoWorkflow-RemoveMoDiscoWorkflow.png|center|thumb|400x270px|Remove a MoDiscoWork in the MoDiscoWorkflow]]
| + | |
| − | | + | |
| − | To remove a MoDiscoWork, you must select a MoDiscoWork in the MoDiscoWorkflow and click on the "Delete" button. A new window opens proposing these various choices:
| + | |
| − | * "Delete from launcher": To delete the MoDiscoWork selected in the MoDiscoWorkflow and its associated launcher.
| + | |
| − | * "Delete from workflow" To delete the MoDiscoWork selected in the MoDiscoWorkflow
| + | |
| − | * Cancel : To cancel
| + | |
| − | | + | |
| − | ===Load a MoDiscoWork===
| + | |
| − | | + | |
| − | [[Image:-MoDiscoWorkflow-Load.png|200x200px|center|thumb|Load a MoDiscoWork]]
| + | |
| − | | + | |
| − | When you want to load a launcher (MoDiscoWork) in the MoDiscoWorkflow, click on the "Load…" button. A new window opens proposing every launchers present in the workspace which have a driver defined for the type of launcher. To load a MoDisocoWork, select a launcher and click on the “Finish” button.
| + | |
| − | | + | |
| − | ===Run your MoDiscoWorkflow===
| + | |
| − | When you finished building your MoDiscoWorkflow, click on the “Run” button. An error window opens if one or more MoDiscoWork are not valid. Every MoDiscoWork must be valid to run MoDiscoWorkflow.
| + | |
| − | | + | |
| − | ==Create a driver for MoDiscoWorkflow==
| + | |
| − | | + | |
| − | ==="driver" extension point===
| + | |
| − | | + | |
| − | [[Image:-MoDiscoWorkflow-ArchiPointExtensionDriver.png|center|thumb|"driver" extension point architecture]]
| + | |
| − | | + | |
| − | The MoDiscoWorkflow plug-in proposes an extension point named "driver". This extension point contains a sequence one..one of "driverUI" extension point and "execution" extension point. ''' The "id" field is required'''. It allows binding both extension points.
| + | |
| − | | + | |
| − | ===="driverUI" extension point===="
| + | |
| − | This extension point defines:
| + | |
| − | * A field name: This name will be used to the list of transformation types.
| + | |
| − | * A field icon: It’s driver icon path.
| + | |
| − | * A field class: The class has to implement this interface "org.eclipse.gmt.modisco.workflow.DriverInterface".
| + | |
| − | | + | |
| − | ===="execution" extension point====
| + | |
| − | This extension point defines:
| + | |
| − | * A field class: The class has to implement this interface "org.eclipse.gmt.modisco.workflow.ExecutionInterface"
| + | |
| − | | + | |
| − | ===Papyrus driver example===
| + | |
| − | In this example, we are creating a new driver for launcher of papyrus. Follow these steps:
| + | |
| − | * Create a new plug-in project
| + | |
| − | * Name this project "org.eclipse.gmt.modisco.driver.papyrus"
| + | |
| − | * Add the "com.cea.papyrus.extensionpoints.transformation" plug-in to the list of plug-ins required for the operation of this plug-in (dependencies)
| + | |
| − | * Create a class ("LaunchDriverPapyrus.java") whish implements the interface "org.eclipse.gmt.modisco.workflow.DriverInterface" (below).
| + | |
| − | * Create a class ("TransformationExecute.java") whish implements the interface "org.eclipse.gmt.modisco.workflow.ExecutionInterface" (below).
| + | |
| − | * Add a new extension named "org.eclipse.gmt.driver"
| + | |
| − | * Name the "id" field of extension point "idPapyrus"
| + | |
| − | * For the "driverUI" point extension:
| + | |
| − | ** Name the "name" field "Papyrus Generation"
| + | |
| − | ** Indicate the icon papyrus path in the plug-in
| + | |
| − | ** Indicate the class which implements the interface "org.eclipse.gmt.modisco.workflow.DriverInterface"
| + | |
| − | * For the "execution" point extension:
| + | |
| − | ** Indicate the class which implements the interface "org.eclipse.gmt.modisco.workflow.ExecutionInterface"
| + | |
| − | | + | |
| − | [[Image:-MoDiscoWorkflow-DriverUIExtensionPoint.png|center|thumb|627x147px|Driver Papyrus example ("driverUI" extension point)]]
| + | |
| − | | + | |
| − | [[Image:-MoDiscoWorkflow-ExtensionExtensionPoint.png|center|thumb|627x147px|Driver Papyrus example ("extension" extension point)]]
| + | |
| − | | + | |
| − | | + | |
| − | <source lang="java">
| + | |
| − | package org.eclipse.gmt.modisco.workflow.driver.papyrus.ui;
| + | |
| − | | + | |
| − | import java.util.List;
| + | |
| − | | + | |
| − | import org.eclipse.gmt.modisco.workflow.DriverInterface;
| + | |
| − | import org.eclipse.gmt.modisco.workflow.driver.papyrus.Constant;
| + | |
| − | import org.eclipse.gmt.modisco.workflow.ui.common.MoDiscoWorkParameter;
| + | |
| − | | + | |
| − | public class LaunchDriverPapyrus implements DriverInterface {
| + | |
| − |
| + | |
| − | @Override
| + | |
| − | public String getTypeLaunchConfig() {
| + | |
| − | return "com.cea.papyrus.extensionpoints.transformation.launchConfigurationType";
| + | |
| − | }
| + | |
| − | }
| + | |
| − | </source>
| + | |
| − | | + | |
| − | The "com.cea.papyrus.extensionpoints.transformation.launchConfigurationType" string is the papyrus launcher type. The launcher type is present in the ".launch" file. This file is created during the creation of a new launcher of this type
| + | |
| − | | + | |
| − | <source lang="java">
| + | |
| − | package org.eclipse.gmt.modisco.workflow.driver.papyrus.execution;
| + | |
| − | | + | |
| − | import org.eclipse.core.runtime.CoreException;
| + | |
| − | import org.eclipse.core.runtime.NullProgressMonitor;
| + | |
| − | import org.eclipse.debug.core.ILaunch;
| + | |
| − | import org.eclipse.debug.core.ILaunchConfigurationWorkingCopy;
| + | |
| − | import org.eclipse.debug.core.ILaunchManager;
| + | |
| − | import org.eclipse.gmt.modisco.workflow.ExecutionInterface;
| + | |
| − | import com.cea.papyrus.extensionpoints.transformation.launch.LaunchTransformationDelegate;
| + | |
| − | | + | |
| − | | + | |
| − | public class TransformationExecute implements ExecutionInterface {
| + | |
| − | | + | |
| − | @Override
| + | |
| − | public void launch(ILaunchConfigurationWorkingCopy configuration, ILaunch launch) {
| + | |
| − | try {
| + | |
| − | LaunchTransformationDelegate delegate = new LaunchTransformationDelegate();
| + | |
| − | delegate.launch(configuration,ILaunchManager.RUN_MODE, launch,new NullProgressMonitor());
| + | |
| − | } catch (CoreException e) {
| + | |
| − | e.printStackTrace();
| + | |
| − | }
| + | |
| − | }
| + | |
| − | }
| + | |
| − | </source>
| + | |
| − | | + | |
| − | It is necessary to use the delegate to execute the configuration.
| + | |
| − | | + | |
| − | ==Team==
| + | |
| − | Nicolas Payneau ([http://www.mia-software.com Mia-Software])
| + | |
| − | | + | |
| − | Gabriel Barbier ([http://www.mia-software.com Mia-Software])
| + | |
| − | | + | |
| − | ==Current limitations==
| + | |
| − | Right now, it's not possible to bind the parameters between components. Furthermore, the workflow is executed in a sequential way.
| + | |
