Triquetrum/ICE

Part of the Triquetrum Project is to interface with ICE. This page describes how to set up ICE and Triquetrum.

This work is very speculative and is for reference by Triquetrum developers. It probably won't be of much use for other people.

Exporting Features from Triquetrum

ICE requires features from Triquetrum. Eventually, we will have a P2 site for these features, but in the near term, we export the features by hand

1. See Building From Sources for how to build Triquetrum in Eclipse.
2. File -> Export
3. In the Export window:
   1. Plug-in Development -> Deployable features
   2. Click Next
4. In the Deployable Features window:
   1. Click on "Select All"
   2. In "Directory", browse to a directory, which will be used in the ICE RCP in the next section
   3. Click Finish

Setting up ICE

Below are instructions on how to set up the ICE plugin that will run Triquetrum workflows.

This is based on a fork of the main ICE repo.

This is very likely to change or otherwise not work in the future.

This was done by using the ICE project generator. A more sustainable way would be to leverage upcoming changes to the ICE workflow engine which makes it possible to compose workflow engines.

1. Create an empty workspace
2. Get the fork from https://github.com/jayjaybillings/ice-triquetrum
3. Switch to the next branch and import all the projects.
4. Go to "org.eclipse.ice.target.mars" and set "mars.target" as your target (unless you are doing this with ICE, which already has all of the required bundles set).
5. Go to the "org.eclipse.ice.repository" project and right-click and run the launch configuration product.* for your OS. If you are using Windows or Mac, you will need to add org.eclipse.ice.triquetrum to that configuration.
6. Go to the ICE perspective and in the ItemViewer at the left create the Triquetrum Item by clicking on the green plus button. The Triquetrum Item is currently at the bottom of the list that appears with an ugly name at the moment.

Telling ICE about the Triquetrum Features

The next step is to tell the ICE projects about the Triquetrum features.

1. Go to "org.eclipse.ice.target.mars" and click on "mars.target"
2. In the mars.target Target Definition tab under the list of Locations, click on the location "file:/C:/temp/triquetrum/features-for-ice", then click on Edit
3. In the Edit window, click on Add and then Local, then browse to the Triquetrum Features exported above. Click on Open, then OK.
4. In the Edit Content window, under Names will appear "There are no categorized items". The fix is to un-check "Group by Category", which will show all the Triquetrum features. Click on Select All, and then Finish.
5. In the bottom right of the ICE Eclipse window a message about "Resolving Target Definition" will appear.
6. After a few minutes, the resolution will end.
7. In the mars.target pane, click on "Set as Target Platform". The rebuild will occur. You may see errors about org.eclipse.eavp, which may be ignored.
8. Go to the "org.eclipse.ice.repository" project and right-click and run the launch configuration product.* for your OS and select Run -> Run Configuration.
9. In the Run Configurations window:
   1. Click on the Plug-ins tab and find the triquetrum features by typing "triquetrum" into the text entry widget at the top of the list of features.
   2. Click on the check box next to each triquetrum feature
   3. Click on Apply, then Run
10. If the "Errors in Workspace" dialog pops up, click proceed.