Version Control System is essential for any form of distributed/collaborative development to enable software versioning and revision control. The Event Processes developed in Fiorano Environment can be shared with the Version Control System using eStudio application. Version Control System acts as a repository where every change made to the source can be tracked along with details such as the person who made the change, the date when it was changed, and why it was done.
Fiorano supports SVN, CVS, and VSS Version Control Systems.
The sections below illustrate how to configure and use SVN version control in eStudio.
Downloading and Integrating SVN into eStudio
To download and integrate SVN, perform the following actions:
- In the eStudio application, go to the Help menu and click Install New Software to open the Install New Software wizard.
- Click the Add button and provide the URL "http://download.eclipse.org/releases/mars/" in the Add Repository dialog box and click OK.
- Select the Eclipse Plug-in Development Environment option under the General Purpose Tools name and click Next twice.
- Accept the License Agreement and click Finish.
- When the installation is done, restart eStudio as it prompts so.
- Open the Install New Software wizard and add "http://download.Eclipse.org/technology/subversive/4.0/update-site/". Select the values from the list as shown in the figure below.
- Click Next twice, agree to the License Agreement, click Finish, and restart eStudio upon prompting.
- Now it's time to install SVN Connectors. After restarting eStudio, navigate to Window > Preferences. In the window shown, navigate to Team > SVN. Open SVN Connector Tab. click the Get Connectors button.
- In the Install Connectors dialog box, select the following option containing the list of compatible connectors and click Finish.
- A wizard with the list of plugins to be installed. gets opened. Select All and click Next. Accept the License Agreement and click Finish.
- During installation, a 'Security Warning' appears, asking for confirmation to proceed. Click OK to continue with the installation.
- Once the installation is done, restart eStudio as it prompts so.
Adding Event Process to SVN Repository
- In 'Server Explorer' view, open the Event Process which is desired to be shared in the SVN Repository.
- Right-click the opened event process from the 'Server Explorer' Panel, point to 'Team' option and select 'Share Project' option.
- Specify the SVN URL location where the project needs to be stored/shared and corresponding svn details and click 'Next' and then 'Finish'.
- A commit dialog will be prompted. Enter the commit message, select all the files related to the event process to be added in repository and click 'Ok'.
- Right-click on 'Event Process Repository', click on 'Refresh'. Details of SVN Repository and event process name will be displayed beside 'Event Process'.
Modifying Event Process in SVN Repository.
- If we need to commit new changes to SVN Repository, Open Event process and right-click on the Event Process that is already shared with SVN Repository. Point to Team → Commit.
- Enter the commit message, select all the files related to the event process to be added in repository and click 'Ok'.
Checking out Event Process from SVN Repository.
- Click on 'Open Perspective' Button on the upper right part of screen. Select 'SVN Repository Exlporing' from the list, click 'Ok'.
- Click on 'New Repository Location' button, if you want to add a new SVN repository location apart from existing as below.
- Add details of SVN Repository and svn credentials in the wizard and click 'Finish'.
- Right-click on the Event Process to be checkout and click on 'Find/Check Out As'. Click Next.
- In 'Checkout As' wizard, provide location till Applications <FioranoInstaller>runtimedata\eStudio\workspace\.repositories\Online\<EnterpriseServerName>\Applications and click 'Finish'.
- Navigate to Online Perspective and Refresh 'Event Process Repository' to see checked out event process in 'Server Explorer' view.
Some Useful Features
Below-mentioned are a few useful options to work with the shared Event Process, which are available in its context menu (Team option in the right-click menu of the Event Process):
- Synchronize with Repository: When Event process has changes to be committed or checked out, use this Option to open Synchronize View either in the same perspective or in Team Synchronizing Perspective. The Synchronize view shows the changes to be committed or Checked Out.
- Update to HEAD: Used to update the event process to its current revision in the SVN repository. The changes that are made can be identified by a Dirty Flag that can be set using Label Decorations in Preferences refer section below.
- Update to Version: Used to update the event process to a particular revision from SVN repository.
- Show History: Shows the history of the Event Process commits.
- Revert: Used to Revert the changes made to Event Process. Note: The other options like Update to Revision, Revert and other options which change the contents of the Event process project will display 'out of sync' in the title of the EP. Just click on the Orchestration Editor of the Event process to sync.
Figure 32: Useful options for the project to integrate with SVN
Update to HEAD
As briefed earlier, this Option is used to update the event process to its current revision in the SVN repository. As shown in the below figure the Event Process2 has some local changes, which can be identified by the Dirty Flag.
Figure 33: Dirty Flag indicating changes happened to the checked out project
After choosing the Update to HEAD option, the Event Process is shown as out of sync as shown in the below figure.
Figure 34: EP Title showing 'Out of sync' indicating after updating to Head
Click inside the Event process's Orchestration Editor so that the UI gets updated and the Event process gets in Sync with updated project; "Out of Sync" text disappears from the title.
Figure 35: 'Out of sync' removed by clicking in the Orchestrator
SVN Label Decorations
The Label of the Event Process Project Name which is shared in SVN Repository can be customized to include/exclude various attributes such as Dirty flag, Revision Info, author, date, URL.
For example, to show the revision number (which helps in identifying revision from the Server Explorer itself) of an Event Process project next to its name in the Server Explorer View, perform the following actions:
- Go to Window menu and click Preferences.
Figure 36: Navigating to Preferences
- In the Preferences window, navigate to Team > SVN > Label Decorations.Under Text tab in the Label Decorations section, change the value of Project Format to the following and click Apply:
{dirty_flag}{name} [revision {revision}]
Figure 37: Changing Project Format values in Label Decorations section
- The Event Process in the Server Explorer panel appears in the format as applied.
Figure 38: EP name with the label changed
- Some useful variables that can be used to display in Event Process name by amending Project Format values are:
- {author} for the author of the revision.
- {url_short} for the URL of the project in SVN repository (File_transfer-1.0@EnterpriseServer as it was appearing previously in the example).
- {date} for the modification date and time of the revision.
---------------------------Snagit Editor---------------------------Out of memory.---------------------------OK ---------------------------