integrate domino designer with cvs source control

Integrate Domino Designer with CVS Source Control

Frank van der Linden

Frank van der Linden & e-office

nl.linkedin.com/in/flinden68

http://www.domino-weblog.nl

fli@e-office.com

@flinden68

Roadmap

• What is Source Control• Install CVS connectors• Setup connection to CVS• Connect the database to Source Control• Submit new changes to Source Control• Get data out Source Control• Beyond the basics• Usefull links

What is Source Control

What is Source Control

• For teams and individuals• Central location to store code• Version files• Branching: Release and feature

management• 2 types of Source control

– Centralized– Distributed

Centralized source control

• CVS

• Subversion

• IBM Rational Team Concert

Distributed source control

• Mercurial

• Git

Source Control and Domino Designer

• Compatible with Lotus Notes 8.5.3 and higher• The Standard Configuration, the eclipse

based version

Install CVS connectors

Install the Source Control connectors

• Goto install in the Domino Designer

Install the Source Control connectors

• Specify the Ganymede update site• Add Remote location

Install the Source Control connectors

• Select under Collaboration tools the CVS connectors

• To get all the depending connectors, click the button ‘Select Required’

• Click Next.

Install the Source Control connectors

• You need to accept the license of the connectors

• Click Next

Install the Source Control connectors

• You get an overview of all the plugins to be installed

• Click Finish• The connectors are being installed, can take

some time• Restart Lotus Notes

Setup connection to CVS

Set up connection to CVS

• Open the CVS Repository Exploring perspective

Set up connection to CVS

• Click CVS icon on top of perspective• In the popup add the host and respository path

of Source Control (CVS)• If Authentication is required, provide Username

and Password.• Click Finish

Set up connection to CVS

• If connections is correct, the root of the Source Control System will be displayed.

Connect the database to Source Control

Connect the database to Source Control

• Create a on-disk project

Connect the database to Source Control

• You will get an Helper panel, with some information about the setup.

• If you don’t want this in the future, tick the checkbox at the bottom

Connect the database to Source Control

• Fill in the project name• Use default location in the data\workspace

directory or specify a custom location to store the on-disk project.

Connect the database to Source Control

• Open the Navigator view, Window --> Show Eclipse Views

• There is the new on-disk project

Connect the database to Source Control

• Next share the on-disk project with Source Control

Connect the database to Source Control

• Select the Respository type, CVS

• Use the newly created repository location

• Or create a new one

Connect the database to Source Control

• Select the location on the Source Control server

• Let Check box ‘Use project.....’ selected.

Connect the database to Source Control

• An overview will be presented of all the design elements who will be committed

• Leave the ‘Launch the Commit wizard’ checkbox selected.

Connect the database to Source Control

• Commit the files.• Enter comment for the

Commit operation• This should be a

meaning full description of this commit operation.

• Click Finish and the commit operation will start directly.

Connect the database to Source Control

• In the CVS Repository exploring perspective you can see if everything went well.

Submit new changes to Source Control

Submit new changes to Source Control

• Make changes to the database.

• Sync data with on-disk project

Submit new changes to Source Control

• Switch to the Navigator view, Window > Show Eclipse Views

• The arrow before the On-Disk Project indicates there are changes to commit

Submit new changes to Source Control

• Right mouse click on project• Select Team > Synchronize with Repository

Submit new changes to Source Control

• A warning of switching perspectives will be presented

• If don’t want this warning in the future, select the checkbox ‘Remember my decision’

Submit new changes to Source Control

• The Team Synchronizing perspective opens.• It gives an overview of all the changes.• Right click on project name and select

‘Commit’

Submit new changes to Source Control

• The commit window will popup, to give a meaningfull description of this commit operation.

• Click Finish

Submit new changes to Source Control

• After Commit operation, the changes will disappere from the perspective

Get data out Source Control

Get data out Source Control

• Open the CVS Repository perspective• Right click the project• Check Out as..

Get data out Source Control

• It will be associated to on On-Disk Project• If there is no On-Disk Project you can also

choose the New Project Wizard.• Click Finish

Get data out Source Control

• If existing On-Disk project, there will be a warning about overwriting the On-Disk Project

• Choose Yes or No

Get data out Source Control

• Switch back to the Domino Designer perspective

• Right click on the database

• Select > Team Development > Associate with Existing On-disk project

Get data out Source Control

• Select the On-Disk project to associate the database with.

• Click Finish

Beyond the basics

Beyond the basics - branches

• Create a branch of the project• For example with customer specific design

elements

• Sync database with On-Disk Project

Beyond the basics - branches

• Switch to the Navigator perspective• Right click project• Select Team → Branch

Beyond the basics - branches

• Switch to the Navigator perspective• Right click project• Select Team → Branch

Beyond the basics - branches

• Fill in a Branch Name• And a Version Name• Click OK

Beyond the basics - branches

• In the CVS Repository perspective the branch has been created

• The new changes are not present yet

Beyond the basics - branches

• Switch to the Team Synchronizing perspective

• Commit the new changes to the branch, by right click the project name

Beyond the basics - branches

• Comment the commit operation

• Click Finish

Beyond the basics - merging

• Branches can also be merged together• Switch to the Navigator view.• Right click mouse on Ondisk Project > Team

> Merge

Beyond the basics - merging

• Select branch to be merged

• The Synchornize perspective will open

• It shows the modification who will commit to the base.

Beyond the basics - merging

• Right click > Merge• The branch will be merged to the base

version.

Beyond the basics – other actions

• Tag as Version• Can switch to a other version or branch

Questions

Usefull links

• CVS connectors– http://download.eclipse.org/releases/ganymede/

• SVN connectors– http://www.openntf.org/internal/home.nsf/project.xsp?actio

n=openDocument&name=Subversion%20UpdateSite%20for%20Domino%20Designer

• Github Connectors– http://

www.openntf.org/internal/home.nsf/project.xsp?action=openDocument&documentId=D1668ED7018AA0858625786300624B6F

• CVS help– http://help.eclipse.org/helios/index.jsp?topic=%2Forg.eclipse

.platform.doc.user%2Ftasks%2Ftasks-100b.htm

Contact details

nl.linkedin.com/in/flinden68

http://www.domino-weblog.nl

fli@e-office.com

@flinden68