ZenTao ManualBook Info
1 Introduction
1.1 About ZenTao
1.2 Introduction PPT
1.3 Technical Support
1.4 Follow Us
2 Installation
2.1 Choose the right installation
2.2 ZenTao Cloud
2.3 One-click Installation for Windows
2.4 One-click Installation for Linux
2.5 Installation with Lampp
2.6 Source Code Installation (for all Systems)
2.7 Set up Virtualbox for ZenTao
2.8 Softaculous service
2.9 Integrate Zdoo
2.10 Install Ioncube
3 Upgrade
3.1 Upgrade ZenTao
3.2 Upgrade by source code (for all systems)
3.3 Upgrade for one-click installation for Windows (xampp)
3.4 Upgrade for one-click installation package for Linux
4 Users and Groups
4.1 Company Structure
4.2 Add a User
4.3 Batch Manage Users
4.4 Groups and Privileges
5 Quick Start
5.1 Project and Task Management
5.2 Bug Tracking
5.3 Product Management
5.4 Individual Task Management
6 Basic Application
6.1 Basic Workflow
6.2 Agile and Scrum
6.3 ZenTao and Scrum
6.4 ZenTao Tutorial for Rookies
6.5 Create a Product
6.6 Create a Story
6.7 Create a Project
6.8 Confirm a Story
6.9 Task Breakdown
6.10 Report a Bug
6.11 Manage Contacts
6.12 Customization
6.13 Import Excel, CSV files
6.14 Document Management
6.15 Operation Mode
6.16 Points
6.17 Customize Required Field
6.18 Access Control
7 Advanced Application
7.1 Workflow
7.1.1 ZenTao Workflow
7.2 Personal management
7.2.1 My Todo
7.2.2 My Task, Story and Bug
7.2.3 My Profile
7.3 For Product Owner
7.3.1 Manage a Product
7.3.2 Manage a Product Line
7.3.3 Create and Review a Story
7.3.4 Change and Review a Story
7.3.5 Story Status
7.3.6 Notes for Writing a Story
7.3.7 Product Module
7.3.8 Release Plan
7.3.9 Create a Release
7.3.10 Roadmap
7.3.11 Documents
7.3.12 Planning Meetings
7.3.13 Daily Scrum, Review and Retrospective Meetings
7.3.14 Story Reports
7.4 For Project Manager
7.4.1 Create a Project
7.4.2 Set up a Team
7.4.3 Confirm a Story
7.4.4 Story Breakdown
7.4.5 Daily Standup Meetings
7.4.6 Check Project Progress via Burndown Chart
7.4.7 Check Project Progress via Lists
7.4.8 Review and Retrospective Meetings
7.4.9 Basic reports on tasks
7.5 For Development Team
7.5.1 Project planning meeting and task breakdown
7.5.2 Claim tasks and update efforts
7.5.3 Kanban and Tree Diagram
7.5.4 Build
7.5.5 Test Task
7.5.6 Resolve a Bug
7.5.7 Documents
7.5.8 Confirm Bugs
7.6 For QA Team
7.6.1 Defect Management
7.6.2 Report a Bug
7.6.3 Verify and Close a Bug
7.6.4 Activate a Bug
7.6.5 Find a Bug
7.6.6 Test Case
7.6.7 Create and Review Test Cases
7.6.8 Test Suites, Public Case Libs and Reports
7.6.9 Manage Test Tasks
7.6.10 Execute Cases and Report Bugs
7.6.11 Reports
8 Configuration
8.1 Maintain ZenTao
8.1.1 Initialize scripts
8.1.2 Back up ZenTao
8.1.3 Recover the Deleted
8.1.4 Update Burndown charts
8.1.5 ZenTao remote host
8.2 Deploy ZenTao
8.2.1 Guest Login
8.2.2 Email Notification
8.2.3 Set Super Admin
8.2.4 Static Access
8.2.5 Delete "zentao" from URL
8.2.6 Integrate ZenTao with SVN
8.2.7 Integrate ZenTao with Git
8.2.8 Integrate webhook
8.2.9 Integrate Xuan.im
8.2.10 Integrate Zdoo
9 Customization
9.1 ZenTao customization
9.2 ZenTao Directory
9.3 Locate and Change Files
9.4 ZenTao Database Structure
9.5 Common Modules
9.6 Add Features to Menu
9.7 Set Privileges to Modules
9.8 Examples: modify language prompt
9.9 Examples: set priority when creating bugs
9.10 Web Editor
9.11 ZenTao Packaging Standards 1.1
10 Relevant Issues
10.1 About third-party code
10.2 Support ZenTao
10.3 ZenTao Commercial Service
10.4 Acknowledgement

Integrate ZenTao with SVN

2015-09-14 11:29:35
azalea
3959
Last edited by Renee on 2018-11-16 14:02:43

Note:

It is complicated to configure SVN. We will try to describe how to configure it in our manual. If you cannot do it, think about our paid service and contact us at Renee@cnezsoft.com to know more about technical support =)


SVN has been integrated to ZenTao 2.2+, which links ZenTao and codes, and makes it convenient for users to view codes. The followings will show you how to integrate SVN in ZenTao.


1. Subversion integration

The basic mechanism for Subversion integration is to


Analyze code comments submitted => Get related story, task, and bug IDs => Write IDs to ZenTao database.


There are two ways to do it. One is to use the hook built in SVN. When codes being submitted, a hook script is triggered. It will analyzes the coomments and get the IDs of the related stories, tasks, and bugs, and then call ZenTao api and recored it in the database. The other way is to use LOG command at SVN client to get all the submitted records and analyzes it to get the IDs, and then record it in the database.


Both ways have their own pros and cons. We choose the second one, because it is easier to debug and more convenient to deploy. Besides, it can also analyze all the previous records with more flexibility.


2. Deploy SVN command-line client on machines installed ZenTao

SVN command line refers to commands built-in SVN. It is svn.exe in Windows and svn in Linux. The client installed ZenTao can be separated from that installed subversion. They don’t have to be installed on the same machine.


2.1 Install svn for Linux machines. Subversion can be installed for rhel and centos via yum, and apt-get in Debian.
2.2 The latest Windows one-click installation package has built-in svn.exe in the directory of \xampp\silksvn

2.3 If you install SVN in Windows, download slilksvn and then install it.


3. Configure SVN parameters in ZenTao

3.1 Code locations
The Configuration file of SVN is saved in zentao/module/svn/config.php. You can modify it and save the modified to svn/ext/config/svn.php. So later it will not be overridden, if updated.


3.2 Configuration

As for setting subversion parameters, there are some concepts involved as follows.
  • locations of the SVN commands
  • repo: multiple repos can be set.
  • User names and parameters of repos
Now let’s explain this with specific examples


3.2.1 Find the location labeled with a red box in the image below


3.2.2 modify the code

Write codes as the examples show below,

$config->svn->client   the path to save svn.exe, the client executable files

$config->svn->repos[$i]['path']  the path to save SVN code
$config->svn->repos[$i]['username']  the path to save SVN login user name; Leave it blank if you don’t need to log in.
$config->svn->repos[$i]['password']  the path to save SVN login password


3.3 Set multiple repos
3.3.1 Find the following code in the same file.


3.3.2 Modify the codes

  • Delete “/*”and”*/“ from the code and modify it as mentioned above. Notes: $i ++ cannot be changed.
  • For any svn repos, copy the code and configure it in the same way.


4. The format of code comment

When submitting to SVN, developers need to specify relevant stories, tasks or bug IDs of changes in the comments. Please follow the format below.


bug#123,234, 1234 or bug: 123,234 1234; comma or space can be used as space holders among IDs; 

story#123; task#123.

Bugs, stories, and tasks must be labeled.


5. Execute commands to synchronize SVN

5.1 Refer to 8.1.1 Initialize Scripts to initialize all the scripts of command lines.
5.2 Enter the directory of zentao/bin/ and execute syncsvn.bat or syncsvn.sh.

5.3 The screenshot of executed the programs is as below.


5.4 Check the related bugs.

5.5  FAQ

The following problems are often seen in source code installation.


Run the script to synchronize SVN, and the error is shown


Run the command as shown in the notice manually, and the excution is done.


Solutions: In php.ini, cancel shell_exec() of disable_functions. Restart php-fpm and WebSever.

6. Deploy the cron

When all the commands are deployed, add the commands to the cron. For example, execute the tasks every 5 minutes.


Solution 1: Login ZenTao in the browser. Go to Admin->Cron and switch it on. Click Activate to synchronize SVN scripts. After you change the parameter, follow the steps below: Go to Admin->Cron and click Cancel=> Restart Apache=> Go to Admin->Cron and click Start.


Solution 2: Use the cron feature in your system. Go to Control Panel->Cron in Windows or use crontab in Linux.


7. Notes

It is not recommended use to https or ssh, because it involves verification and integration for https and ssh certificates, which can be quite complicated.
    Write a Comment
    Comment will be posted once reviewed.