Contents

Popular
 Contents

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.

Prerequisites

  1. Close eStudio if opened. Open eStudio.ini file present in <FioranoInstaller>/eStudio folder.
  2. Take a backup of value stored in “-Djavax.net.ssl.trustStore” and replace the value with cacerts in java folder.
    1. Windows:
      • 32-bit system: <FioranoInstaller>\jre1.8.0_92_32\lib\security\cacerts
      • 64-bit system: <FioranoInstaller>\jre1.8.0_92_64\lib\security\cacerts
    2. Linux: <JAVA_HOME>/jre/lib/security/cacerts

  3. Open terminal in <FioranoInstaller>/eStudio folder and start eStudio using the following command:

  4. Follow the Downloading and Integrating SVN into eStudio section below for SVN installation.

  5. After successful svn installation, Close eStudio and replace the value for -Djavax.net.ssl.trustStore with the default value:

  6. Open terminal in <FioranoInstaller>/eStudio folder and start eStudio using the following command:

Downloading and Integrating SVN into eStudio

To download and integrate SVN, perform the following actions:

  1. In the eStudio application, go to the Help menu and click Install New Software to open the Install New Software wizard.

  2. Click the Add button and provide the URL "http://download.eclipse.org/releases/mars/" in the Add Repository dialog box and click OK.

  3. Select the Eclipse Plug-in Development Environment option under the General Purpose Tools name and click Next twice.
  4. Accept the License Agreement and click Finish.
  5. When the installation is done, restart eStudio as it prompts so.
  6. 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.


  7. Click Next twice, agree to the License Agreement, click Finish, and restart eStudio upon prompting.
  8. 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.

  9. In the Install Connectors dialog box, select the following option containing the list of compatible connectors and click Finish.


  10. A wizard with the list of plugins to be installed. gets opened. Select All and click Next. Accept the License Agreement and click Finish.
  11. During installation, a Security Warning dialog box appears, asking for confirmation to proceed. Click OK to continue with the installation.


  12. Once the installation is done, restart eStudio as it prompts so.

Adding Event Process to SVN Repository

  1. In Server Explorer view, open the Event Process which is desired to be shared in the SVN Repository.
  2. Right-click the opened event process from the Server Explorer Panel, go to Team and click the Share Project option.

  3. Specify the SVN URL location where the project needs to be stored/shared and corresponding svn details and click Next and then Finish.

  4. Enter the commit message in the Commit dialog box, select all the files related to the event process to be added in the repository and click OK.

  5. Right-click the Event Process Repository node and click Refresh. Details of SVN Repository and event process name will be displayed beside the Event Process name.

Modifying Event Process in SVN Repository

  1. To commit new changes to SVN Repository, open Event process and right-click the Event Process node that is already shared with SVN Repository. Go to Team and click Commit.

  2. Enter the commit message, select all the files related to the event process to be added in the repository and click OK.

Checking out Event Process from SVN Repository

  1. Click the Open Perspective icon on the upper right part of screen. Select the SVN Repository Exlporing option from the list and click OK.

  2. To add a new SVN repository location apart from the existing one, click on the New Repository Location icon.

  3. Add details of SVN Repository and svn credentials in the wizard and click Finish.

  4. Right-click on the Event Process to be checkout and click the Find/Check Out As option. In the Check Out As dialog box, click Next.



  5. Provide location till Applications in the following format and click Finish.

    Icon

    <FioranoInstaller>runtimedata\eStudio\workspace\.repositories\Online\<EnterpriseServerName>\Applications 

  6. Navigate to Online Perspective and refresh the Event Process Repository to see the checked out event process in the 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.

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.

After choosing the Update to HEAD option, the Event Process is shown as out of sync as shown in the below figure.

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.

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:

  1. Go to Window menu and click Preferences.


     
  2. 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}]


     
  3. The Event Process in the Server Explorer panel appears in the format as applied.


     
  4. 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.
Adaptavist ThemeBuilder EngineAtlassian Confluence