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 Update
3.1 Update ZenTao
3.2 Update by source code (for all systems)
3.3 Update for one-click installation for Windows (xampp)
3.4 Update 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 Todo 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 Individual 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 Status and stage
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
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 Data Backup
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 SVN
8.2.7 Integrate Git
8.2.8 Integrate webhook
8.2.9 Integrate Xuan.im
8.2.10 Integrate Zdoo
8.2.11 Integrate Third-Party Application
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 MIsc
10.1 About third-party code
10.2 Support ZenTao
10.3 ZenTao Commercial Service
10.4 Acknowledgement

Integrate Third-Party Application

2019-03-11 13:36:03
Renee
25
Last edited by Renee on 2019-03-13 15:24:50

With ZenTao 9.6+, you can integrate third-party applications in ZenTao, so to share your data. The third-party application can access ZenTao in the way of GET, and ZenTao will return the data in .json format. 


1. Configure

Log in ZenTao as the super-Admin, and go to Admin->Develop->Entry and Click Add Application.


Then enter the information of the application that you want to add to ZenTao.

  • Name: The name of the application
  • Code: The alias of the application
  • Key: Key is generated automatically in ZenTao
  • IP: This is a whitelist of IP. Check All means there is no limit to any IP.


2. API Authentication

API authentication is required when the third-party applications request data from ZenTao. The format is /api.php?m=moduleName&f=methodName& params=params &code=code&token=token


  • m=moduleName&f=methodName& params=params is the parameters that the data request, and you should set it according to your own situation.
  • code is the alias of the application and should be the same as that is in ZenTao.
  • token is the digital authentication, and its algorithm is to remove the md5 and add the key, then md5 again.

For example, the code of the application is myApp and the key is 427c579384224abf9570779d82969d1e, so the algorithm of the token is as shown below,


$key   = '427c579384224abf9570779d82969d1e';
$query = 'm=project&f=view&id=1&code=myApp';
$token = md5(md5($query) . $key);


3. Error Code

300001 No code parameter. Check whether the requested API contains the code.

300002 No token parameter. Check whether the requested API contains the token.

310001 Application does not exist. Check whether the requested application exists in ZenTao or deleted.

310002 Application has no key set up. Check whether the requested application has a key set up.

320001  IP is restricted. Check the IP setting of this requested application in ZenTao.

330001  Invalid token parameters. 


If a redirection happens when requesting, ZenTao should check the session to authenticate whether the request after the redirection is valid.  For example, when requesting the index method in the index module,  it will redirect to the index method in the my module.  

340001  No session code. Check whether $_SESSION['ENTRY_CODE'] is correct after the redirection.

340002  Session authentication failed. Check the authentication logic of the session, as well as whether $_SERVER['REMOTE_ADDR'] is correct after the redirection.




    Write a Comment
    Comment will be posted once reviewed.