Subprojects setup (case study)

Take a look at your generic project (integration testing) now.

You will see the new directory "netKu" created under "Ku" folder.
The only entry in this directory is the NET#V5.6.6A - your NET project that is now included as a subproject into GEN#int_v80.01.

Note the project releases:
GEN#int_v80.01 release is G80.01 and
NET#V5.2.6A release is NET_V5.6.6A.

Now take a look at the reconfigure properties of the GEN#v80.01 project.
In the Java GUI this is called Project "Process Rule Properties".

You will notice the new folder has been added:
Folder 5347925: Automatic Tasks for Integration Testing projects for release NET_V5.6.6A
This folder is not created automatically, I've made it today.

This folder contains two automatic tasks for release NET_V5.6.6A:
Task 4179555: Integration Testing projects for release NET_V5.6.6A and
Task 4179556: Integration Testing products for release NET_V5.6.6A.

Having this folder in your prep project reconfigure properties ensures that you get the subproject updated properly upon update (a.k.a reconfigure) run.

Next, let's look at the NET#V5.6.6A properties.
In the "Work Area" tab you will see that currently the project does not have a work area. And so all the Work Area options are off.

Should you ever decide to build from the prep project (that you should do), you will switch the Work Area ON.
Once you do this, you will see the second "Path" option seen as a check box "Place work area relative to parent project's".

By default this is not checked, and all the projects are located in your default work area directory, all on the same directory level.

If you would rather have the subproject located in the relevant directory, just like you now see it in the Synergy interface, you should check the box. This will create the subproject directory inside the parent project tree.

Collaborative Development projects

In order to have the newly set hierarchy for the working projects as well, the following has to be done (I believe you have already done this, so the steps are for your people):

1. Check in all the files and directories currently checked out for both projects (parent and sub).
2. Delete working projects you currently have for releases G80.01 and NET_V5.6.6A.
3. Locate and show the Integration Testing project GEN#v80.01.
4. Copy project (right click the project name and select "Copy Project" option). New window will open with several fields to fill up.

Leave the first two with the default values.
In the third field "Subprojects:" select the "Copy all subprojects" value from the list.

In the fourth field "Versions:" type in the new project versions you want to assign.
Click the button with the double arrow on the right.
Note that as you now have two projects to copy you will have two fields for separate values for the parent project version and the subproject version.

Fill in the new project versions as you see fit and click OK to close the window.

The system will now create your personal copies of the both prep projects:
parent GEN#80.01 and subproject NET#V5.6.6A.

You should now see the hierarchy in your own collaborative development projects.

5. Next step is to set up the work area options for the subproject.

Locate the project and open its properties window. On the Work Area tab you will see the second "Path" option as a check box "Place work area relative to parent project's".

By default this is not checked, and all the projects are located in your default work area directory, all on the same directory level.

If you would rather have the subproject located in the relevant directory, just like you now see it in the Synergy interface, you should check the box.

This will create the subproject directory inside the parent project tree.

This will complete your setup.

Command line changes

Remember to update your subproject together with the update (reconfigure) you run for your parent project. Use "-r" flag with the "update" command.

The update command will look like this:

"ccm update –r –p GEN#userV80.01"

Note: in order to have collaborative development projects updated with the subproject properly there is an additional folder template "Collaborative automatic tasks for user %owner and release NET_V5.6.6A".