Versioning Sets of Files as Fusions 

Use

You can use the Design Time Repository (DTR) to version sets of files as fusions. A fusion is a set of files in DTR that is treated as one versioned unit. Fusions are used to group related files in a logical and strict order under version control. A fusion has only one version graph, so that when you edit a file, the entire fusion is checked out from the DTR. You cannot edit a fusion concurrently with another user, even though the changes might affect different files of the fusion.

Fusions are also used in model-based development. In such types of projects, the fusions are handled by the SAP NetWeaver Developer Studio automatically. This is implemented for Web Dynpro Java in SAP NetWeaver Composition Environment (CE) Developer Studio.

Fusions are a unit of change propagation. Only entire fusions can be added to an activity, integrated into other workspaces or exported to the file system. The following figure provides an overview of this fusions mechanism:

 

Fusion Mechanism Overview

The fusion functionality provides better collision detection and enhanced support to correctly interpret the inner structure of a project.

Prerequisites

●      You must use SAP NetWeaver CE’s Developer Studio.

●      SAP NetWeaver Development Infrastructure (NWDI) server version is at least SAP NetWeaver 7.0 SP13.

Procedure

There are several ways to create a fusion. The following procedure describes how to group closely-related files of a Java development component (DC) into a fusion.

Fusions can be created and handled by the Developer Studio either automatically or manually.
If you create a Web Dynpro component or application within a Web Dynpro project, for example this is added to a fusion automatically.

Manually Creating a Fusion

...

       1.      To create a new fusion, you have to create a folder in your project.

To do that, open the Navigator view of the Resource perspective. From the context menu of the project, choose New ® Folder. In the folder include the files that must be part of the fusion.

       2.      On the confirmation dialog for checking in files, choose Cancel.

Files checked in the DTR or checked out to create an activity cannot be added to a fusion at the same time. They need to be locally stored.

       3.      Open the Repository Browser view, and navigate to the folder in which you want to create a fusion.

       4.      From the context menu of the folder, choose one of the following:

○       Add ® Fusion to check in the folder and to add objects to the folder later on.

○       Add ® Fusion with Members to add the folder and its entire content to the new fusion.

       5.      To add to the fusion new files or folders that were created in the fusion folder but have not yet been checked in, check out the fusion (if needed), and from the context menu of the Repository Browser view, choose Add.

Example

One example is model-based development in the SAP NetWeaver Developer Studio. With the meta model-based tools, the developer is working on logical objects such as Web Dynpro components or service definitions. Changes are stored in different files. In the case of versioning, conflict detection and change propagation, it is important that you always work on the entire logical object. The solution to this problem is to declare a DTR fusion that contains all the files that belong to one logical development object (such as Web Dynpro). For more information: The Web Dynpro Project in the NWDI.

Example on manual creation of a fusion

...

       1.      Start with a folder in the Web Module DC of track CD301.

       2.      Open the J2EE perspective and from the menu path, choose Window ® Open Perspective  ® Other… ® J2EE.

       3.      Create the fusion itself:

When adding folder and files that shall belong to the fusion to the folder, do not add them to an activity.

                            a.      In the context menu of the Web Module DC, choose New ® Package and call the package org.example.fusion.

                            b.      Create two class files Class1 and Class2:

In the context menu of the fusion folder, choose New ® Class.

                            c.      Navigate to the Design Time Repository perspective ® Repository Browser.

                            d.      To create a fusion of objects, choose the folder containing objects for the fusion, and from its context menu, choose Add Fusion with Members.

                            e.      Choose or create an activity. Check in the activity.

                              f.      Include a note to indicate that this should be done only if there is a specific reason to do so.