Merge eSpaces

In a multi-developer environment, developers have different copies (versions) of the same eSpace (An application or a part of an application that implements a set of services, gathered in a single project. Each service can be presented in a different flow.). These are obtained through download, save as ..., clone or simply by duplicating the oml (Stands for: OutSystems Markup Language) file. In Service Studio, the Merge operation will allow them to integrate their work.

You can also use the merge operation to copy specific data and logic that is implemented in a different eSpace. The Merge operation will copy elements from one eSpace to another, creating them in the destination eSpace.

How to Merge eSpaces:

Open the destination - Local - eSpace and select Compare and Merge... from the File menu or from the Toolbar.

A pop up window asks you to save changes prior to merging. If you have been working on the Local eSpace prior to this, answer Yes.

Select the oml (Stands for: OutSystems Markup Language) file of the eSpace from which you want to copy/merge elements - Foreign.

Analyze the differences presented in the Differences to Merge window and, in the Foreign eSpace tree, check the checkbox of any elements that you want to copy/merge.

Inspect the expected merge results in the Local eSpace Tree.

When you're ready, click Merge.

During the merge, Service Studio resolves any name clashing that might occur. For example, each eSpace has an action with the same name, that is not the same element: MyAction. After the merge, a new local action will exist called MyActionx, where x is an integer.

Fix any problems that might have arisen as a consequence of the TrueChangeTM .

If you want to use another eSpace functionality without copying it into your eSpace, consider adding it as an eSpace reference (Is an element exposed by a Producer eSpace or extension that, when referenced by a Consumer eSpace, is called an eSpace reference in its context. Once an eSpace reference, e.g. an action or entity, is added, you can use it anywhere in the Consumer eSpace but you cannot change its definition.).