Getting Started Guide

Github Integration (Online Version Control System)

Git is an extremely fast, efficient, distributed version control system ideal for the collaborative development of software. So now you can view all the changes made in your GitHub repository in Zoho Projects.

 

1. Create a repository in Github for Zoho Projects

Login into GitHub with your login credentials. Click New Repository link

New Repository

This opens a create repository form. Here typein your project name, description and home page url (if any). Click Create Repository link to create a new repository in GitHub.

Create a repository

2. Set service hooks for a project in Zoho Projects

To access the changesets in Zoho Projects for a repository in GitHub you need to update the service hooks. For this go to Settings tab and click Service Hooks option

Project Hooks

 

This loads the service hooks page here copy the Project ID and Token which is required for the configuration in Zoho Projects.

Project ID

 

Login to GitHub with your login credentials. Click the Admin link. This opens the admin panel.

Admin link

Copy the Project ID and Token which is required for the configuration in Zoho Projects.

ZP Service Hooks

Here click Service Hooks link and all the services which use GitHub repository gets displayed. In this select Zoho Projects and this displays service hooks panel for Zoho Projects.

Admin link

Paste the Project ID and Token copied from Zoho Projects here. Before copying make sure to check the Active checkbox as this allows the changes to get automatically updated and click Update Settings will save the changes.

Project ID and Token

3. View changesets for repository changes in Zoho Projects

Go to Bugs tab. Click Changesets link. This opens the changesets page and displays all changesets from the repository.

Changesets link

This displays the source commits made to the files of the selected project sorted by date.

All changesets

Click on a particular log message. This displays the file details page with entire details like Author, Date, Branch, Home page Url, log messages and file changepath.

File details

 

In addition, if you specify a bug ID while commiting changes in the GitHub repository. The commit message automatically gets linked to that particular bug in BugTracker.

To associate changeset(s) with bug(s) in Zoho BugTracker you will need to give the BUG ID in your commit message.
Syntax: OPEN SQUARE BRACKET #BUGID CLOSE SQUARE BRACKET followed by commit message
Example: [#EPI19] fixed the memory leak issue. This will associate the changeset with bug with ID EPI19.

 

For more than one bugs, provide the BUG IDS separated by comma.
Example: [#EPI19,#EPI20] changed the db name.

Bug Changesets

4. Source code commits in GitHub repository

Go to Bugs tab. Click changesets. This displays all changesets of a project with link to the github commit.

Commit Link

Click on the commit link. This redirects to github respository and you can find the actual changes done in the source code compared to the previous version of the code.

Source Diff

Click Source link and see the list of files checked into this respository.

Files List

Click Commit link and you can find the commit history of your project repository.

Github Commits

Top