Welcome Guest! Log in
Stambia versions 2.x, 3.x, S17, S18, S19 and S20 are reaching End of Support January, 15th, 2024. Please consider upgrading to the supported Semarchy xDI versions. See Global Policy Support and the Semarchy Documentation.

The Stambia User Community is moving to Semarchy! All the applicable resources have already been moved or are currently being moved to their new location. Read more…


This tutorial provides a quick explanation on "using SVN in the Stambia Designer".

Stambia's advice is to use the internal svn (subversion) plugin rather than external tools like Tortoise svn.

If you are using Tortoise SVN, this tutorial is not for you !


Share a project

To share a project, go to the Team menu and choose "Share Project".

 

You will have a choice between CVS and SVN (and perhaps other versionning systems).

You can use all of them. But for this tutorial, choose SVN !

Then type the URL of your SVN repository (ask your SVN administrator if you don't know it).

 

Sometimes, in the following steps, you will be prompted to enter your user name and password.

 

Then, if you are prompted in order to open the "Team Synchonizing perspective", choose "Yes" !

The perspective will always show you the differences between your project and the one that is on the server.

The first time you do this, you will have to publish (commit) all your project.

 

When committing, you can choose the files and type a comment. You should always type a comment in order to retrieve information on the reasons you were committing something.

 

 

When completed (it can take some time...), you can return to the classical "Stambia Perspective" :

 

A few icons appear in the tree. When you make modifications in your developments, the icons will change and may warn you to commit your job.

If many persons are working on the same project, you should commit frequently, and always update (retrieve modifications made by your colleagues) before starting to work on your developments.

 

Main SVN (subversion) functionalities

Commit (from your workspace to the repository)

You don't have to go in theTeam perspective to commit.

 

You can simply commit in the "Team" menu :

You will be prompted to add a comment (like in the Team perspective)

 

 

The « Synchronize » view

If you want to know exactly the differences between your project and the project on the server, you should open the "Team Perspective" through the "Synchronize with repository" menu :

 

Type "Yes" when prompted for the Team Synchonizing perspective.

 

Update (from the repository to your repository)

Then, in this perspective, you can update (retrieve modifications from the server to your local workspace)

You can notice that the direction of the arrow (in the icon) gives you the direction of the modifications.

A "right to left" arrow means "modifications to apply to your project"

A "left to right arrow" means "modification to apply from your workspace to the server".

 

Conflicts management

Sometimes, you will encounter problems when committing or updating.

This may occur if two (or more) persons do modifications on the same version of objects.

 

Then you will have to resolve conflicts, deciding which modification is the good modification.

 

Mark as merged

If your version is the right one, go to the "Team synchronizing perspective" :

You will see the conflicts with a "double red arrow" :

To resolve the conflict in your favor, choose "Mark as merged" :

Then you will be able to commit your work.

Your colleague should then do the opposite action as explained further on.

 

Override and Udpate

If your version is not the right one, you should update.

To do that, choose "Override and Update" :

 

 

 

Frequent merging problems

SVN has created merging files

Sometimes, you will have problems due to conflicts.

This is because SVN tries to merge your version with the other versions.

SVN will create 4 files :

The ".mine" file is your version.

The two others files ".rxx" and ".ryy" are the version on the server and your previous local version.

The original file for Stambia is corrupted.

So, you will have to choose if you want to commit your own version or get the version from the server.

You want to override and update

If you want get the server version, it's very simple. Choose "Override and Udapte".

 

You want to commit your own file

Il you want commit your version, choose the "Mark Resolved" menu

A box will be opened, helping you to resolve your problem.

Choose one of the three last options (never the first with Stambia objects).

If you want to commit your version, choose "using my version of the file"

Then you will be able to commit :

 

Articles

Suggest a new Article!