Zoho Projects integration
No matter how many projects you have on your list to coordinate, managing everything in the right way matters the most. Project management methodologies are many, and every business is bound to follow a standard process. That's why moving to a different process remains herculean task for teams.
Teams across a project, either follow the waterfall or the agile model to manage their work. Not all the processes in the team find the usual model effective. Some teams may require the standard process and other teams require an iterative model to deliver the tasks. Managing teams by implementing both the models is the real success.
Integrating Zoho Sprints with Zoho Projects will create a standard process that offers a flexible, productive, and iterative workflow. Let's start with the technical steps to work with this integration.
Example
Helen Collins is the managing director of 'Marks and Michalle' an e-commerce website that is famous for textiles in New York (NY). She has a team of 500 employees working from client servicing to delivery sectors. As the team grows she finds it difficult to manage an d monitor the working style and process of all the sectors.
Now, she uses Zoho Projects where all the employees in her company are added as users with different roles. All the deliverables are met successfully with a long-term project management technique.
However, here comes the challenge when the customers raise something like this:
Case 1: "As a user, I want to be a part of the development process and try out your features before you take it up for the final release".
Bringing the end user into the development and review process is possible if Helen's team starts working Agile - Develop, Review, Iterate, and then Deliver. Now, she can push her development team to follow the agile process to succeed the above user story.
Helen's development team now finds it easy to manage the customer request by integrating with Zoho Sprints. The other teams can use Zoho Projects for:
Configure workspace
Configuration of workspace has to be implemented from the Zoho Projects platform.
- Navigate to Settings in Zoho Projects. .
- Select Zoho Apps under Marketplace section.
- Click Configure under Zoho Sprints .
- Choose the Zoho Sprints team from the drop-down. (Incase, if you don't hold a Zoho Sprints workspace, click Create Zoho Sprints Account and create a new workspace in Zoho Sprints.)
- Click Map Workspace . (Your workspace will be configured.)
- Click Sprints Info to navigate to Zoho Sprints. (or) Click Back to Integrations and select Access Zoho Sprints.
Ensure whether API access is enabled in Zoho Sprints settings to initiate this integration.Once you click Access Zoho Sprints you will be redirected to your Zoho Sprints team. The actual work starts now.
- Only workspace owners can integrate Zoho Sprints with Zoho Projects.
- This integration is accessible only for the users who have an admin role in Zoho Projects.
- If you don't have a workspace (i.e., portal) in Zoho Sprints, you can create a new workspace and then map it to your Zoho Projects portal.
- You cannot disable the integration once it is enabled.
Projects sync
You can only map projects from Zoho Projects to Zoho Sprints. Learn more on how to map the projects.
- Field sync: Project Name, Description, Project Owner, Start Date, and End Date
- You can add new or existing projects from Zoho Projects to Zoho Sprints and vice versa.
- Deleting the mapped project in Zoho Sprints will remove the mapping with Zoho Projects. Once deleted, you cannot retrieve the mapping.
- Archiving the mapped project in Zoho Sprints will disable the upcoming modifications made in Zoho Projects. Once the project is moved to active, the users can resume the sync.
- Trashing a mapped project in Zoho Projects will remove the mapping with Zoho Sprints. Once trashed, you cannot perform any operation between the applications. Mapping will be enabled if you recover the project from trash.
- You cannot sync a project that is enabled with a Task Roll up option in Zoho Projects.
Project Template Sync
Project templates from Zoho Projects can now be synced with projects in Zoho Sprints. When you have to execute work items that are quite similar to your tasks in Zoho Projects, instead of manually recreating it in Zoho Sprints every time, you can simply sync the template.
Note: If you sync a project with an integrated template, work items that are common to both the products remain integrated. The stand alone work items and tasks will be cloned in Zoho Sprints and Zoho Projects respectively.
Case for strict project
In Zoho Projects, you can set a project as 'Strict' and define a start and end date. When a project is strict the users cannot defy the dates while working with the tasks. The same rule gets applied when a strict project is added to Zoho Sprints. There are a few restrictions to keep in mind when you're trying to sync a strict project.
Strict project restriction
- Strict projects will carry the same date range while mapped with Zoho Sprints.
- You can modify the date range for a strict project in Zoho Sprints.
- While modifying the date range ensure that all the work items are eligible for a date change.
- For example, if a strict project's date range is Aug 1, 2019 - Aug 31, 2019 and you have a work item with a start and end date as Aug 30, 2019 - Aug 31, 2019.
- When you try to modify the date range of the project from Aug 1, 2019 - Aug 28, 2019 in Zoho Sprints, you cannot update the new date range since you have a work item exceeding this date range.
- In this case, you have to stick on to the existing date range or change the work item's date range to modify the project's start and end date.
This is a two-way sync where you can add work items from Zoho Sprints as tasks to Zoho Projects and tasks as different work item types from Zoho Projects to Zoho Sprints.
Learn more on how to add a work item from Zoho Projects.
Add work items from Zoho Sprints to Zoho Projects
- Navigate to Backlog.
- Choose Create and select Create Items.
- Enter the item details.
- In Add to Other apps dropdown at the bottom panel, Zoho Projects will be selected by default.
- Click Create.
- Field sync: Work item title, Description, Start Date, End Date, Duration, Assignees, Comments, Attachments.
Add existing items from Zoho Sprints to Zoho Projects
- Go to Backlog module.
- Select the work item from Project Backlog or Sprint Backlog.
- Click (+) icon in the right side of the details page and select Zoho Projects Task .
- Fill up the mandatory custom fields. (These fields are marked as mandatory in Zoho Projects. User can add the item to Zoho Projects only if they fill up these fields).
- Click Create.
- You can view the details of the tasks added from Zoho Projects as section in your item details. Click View in Zoho Projects or the Zoho Projects icon in the right corner to navigate to Zoho Projects.
- All the custom fields marked as Mandatory in Zoho Projects are listed here.
- You can also add work items in bulk to Zoho Projects. You will be able to add a maximum of 25 work items from the Backlog page.
- Two-way sync for new and existing work items.
- Work items will be added as Tasks in Zoho Projects.
- Mandatory custom fields are listed in both the applications when syncing work items.
- Attachments from Zoho Projects will be displayed in Zoho Sprints.
- If the project is a 'Strict project' in Zoho Projects, you have to update the work items within the strict project's date range.
- Moving work items across the projects will remove the sync with Zoho Projects.
- Deleting the work item from either of the applications will only remove the sync.
Add Bugs from Zoho Sprints to Zoho Projects
- Navigate to the Backlog.
- Choose Create and select + Work Items .
- Enter the item name and choose the Item Type as Bug. The Zoho Projects option will be enabled by default. You can disable if you don't want to add that item in Zoho Projects.
- Click Create.
The Bug Tracker module will list all the integrated bugs. This will be visible as long as your account is integrated with Zoho Projects. The bug you raised in Zoho Sprints will be added under the section where bugs get filed in Zoho Projects.
- Custom fields pertaining to Story/Task/Bug will appear in Zoho Sprints based on the Item Type you choose.
- If a Business rule gets updated in Zoho Projects, it will automatically get updated here for the fields that are synced.
- If you create custom work items with the base item type as Bug, they too will be synced
- While syncing work items, if the existing bugs contain more than one user, one of the users will be assigned to the bug and the rest will be added as followers i n Zoho Projects.
- You can sync 25 bugs at a time from Zoho Sprints to Zoho Projects.
- Sync is available for the following fields: Subject, Description, Due Date, Assignee, Comments, Log hours, and Attachments
- Integrated work items with item type as Task and Story cannot be converted to bugs in Zoho Sprints and vice versa.
- Bug sync will not be available in templates .
- If a task or a bug is associated to a team, users of that team alone can be assigned to them.
- If an item or a sprint contains invoiced log hours, they cannot be deleted or moved to another project.
Status Sync
You can sync the status of your tasks from Zoho Projects with the status of the work items in Zoho Sprints.
- Go to your Zoho Projects account and click Setup.
- Select Zoho Sprints Settings.
- Go to the respective Item Status and click the dropdown.
- Click Add Status. You can either map it to an existing status or add a new status and map to it.
- Edit the Status Name and Status Type and click Add followed by Update .
- Items added or updated after the mapping will automatically get synced between Zoho Sprints and Zoho Projects.
Note:
- The status sync works only for items in the backlog, current and running sprint.
- If there's any restriction in Zoho Projects, the integrated items will not be updated in Zoho Sprints.
Errors:
- Status update failed for some items due to a restriction in Zoho Project
- This item has been added in its Zoho Projects status due to a restriction in Zoho Projects.
Reason:
The restriction might be due to a blueprint or workflow in Zoho Projects.
If Blueprint is enabled for a project, default status will be updated for those items in Zoho Projects. If that status is mapped with Zoho Sprints, those items will be updated with the same status in Zoho Sprints.
Priority Sync
The default priority levels low, medium, and high are synced between the integrated items of Zoho Projects and Zoho Sprints.
Assign Epic
You can assign the epics defined in Sprints while adding tasks in Zoho Projects. Create a new task and select the epic to which the task needs to be associated.
When you access the item in Sprints, the epic will reflect in the work item.
General FAQs
How to remove the sync of work items from Zoho Sprints to Zoho Projects?
You can delete the work item in Zoho Projects to remove the sync. The deleted work item will appear in Zoho Sprints and users can carry out operations but there will not be any sync to Zoho Projects.
Why can't I delete the attachment for a synced work item?
Attachments are specific to each application. You cannot delete the attachments that are uploaded in Zoho Projects. You can view or download the same instead.
What happens when I move a synced work item to a different project?
Moving a mapped work item to a different project will remove its sync with the current mapped project. You cannot remap the work item. Instead, you can add a new work item and sync it to the other application.
How are subitems synced from Zoho Sprints to Zoho Projects?
Subitems are added an individual task in Zoho Projects and vice-versa.
Log hours sync
It is a two-way sync and users can log hours for the synced work items. You can use this log hour sync to generate invoice for your team members.
- Field sync: Title, Duration, Description, Log Hours, Billing Status, Assignee
Adding log hours in Zoho Sprints
- Select the required work item.
- Navigate to Log Hours.
- Fill in the required details in the Log Hours form.
- Click Add.
You can also check how you can add time logs in Zoho Projects here. Check out the timelog settings in Zoho Projects .
|
Time log settings in Zoho Sprints
|
Time log Settings in Zoho Projects
|
Log Hours Behavior
|
|
Approved
|
Submit with Approval
|
|
| Pending |
Submit with Approval
|
|
| Pending |
Submit without Approval
|
|
|
Approved
|
Submit without Approval |
|
- Two-way sync for log hours. You can log hours for all the synced work items in both the applications.
- The status of the log hours is based on the timelog settings predefined in both the applications.
- Log hour status (Approve, Reject, Pending) will be synced to Zoho Projects if you have enabled the 'Submit with Approval' status in timesheet settings in Zoho Projects.
- Rejected hours for the synced items will be deleted in Zoho Projects if you have enabled the 'Submit without Approval' status in timesheet settings in Zoho Projects.
- Two-way sync is enabled for edit and delete log hours.
- In Zoho Projects, if the timesheet settings are restricted to past or future dates:
- You can add log hours for the synced work items in Zoho Sprints.
- You cannot logged hours in the past or future dates that doesn't fall under the defined settings in both Zoho Projects and Zoho Sprints.
- Zoho Sprints allows timers to run beyond 24 hours. But if the time logged is beyond 24 hours, it will not be recorded in both Zoho Sprints and Zoho Projects due to the restriction limit in Zoho Projects.
- Any restriction in Zoho Projects will not allow the log hours to get recorded in both Zoho Projects and Zoho Sprints.
- Loghours should have the same billing type as Zoho Projects.
- The log hours get added in Zoho Sprints only if it is successfully added in Zoho Projects.
-
The log hours get updated in Zoho Sprints only if it is successfully updated in Zoho Projects.
-
All log hour restrictions in Zoho Projects applies to Zoho Sprints as well.
-
If integrated items contain standalone log hours that have valid approval and no restrictions from Zoho Projects, they will be added to Zoho Projects whenever a field gets updated in Zoho Sprints.
-
Whenever there are bulk-add actions in Zoho Sprints, the log hours remain recorded in Zoho Sprints despite the restriction in Zoho Projects.
-
Adding and updating log hours in Zoho Projects will not be synced in work items of "completed sprints" in Zoho Sprints.
General FAQs
Why log hours are not getting synced to Zoho Projects?
Zoho Projects restricts log hours to 24 hours per day. In Zoho Sprints, we do not hold any limit for log hours. You might have logged more than 24 hours in a day. In this case, the log hours will be added to Zoho Sprints and will not be synced to Zoho Projects.
Note: You can also customize the log hour restrictions in Zoho Projects. If the hours logged exceed the customized limit, then the log hours will not be synced to Zoho Projects. Also, a user's log hours will be added to Zoho Projects only if she/her is a confirmed user.When I try to log hours in past dates it gets added in Zoho Sprints but it is not synced to Zoho Projects, how to work out this sync?
Zoho Sprints will restrict log hours to future dates. Based on the time log settings defined in Zoho Projects, the log hours are synced from Zoho Sprints to Zoho Projects. But, even if the future is "Allow" in Zoho Projects, the log hours will not be synced to Zoho Sprints.
User sync
User sync is one of the main component in this integration as it helps coordination between the team members to work both in the waterfall and agile model.
Adding user
All the users from Zoho Projects will be added to Zoho Sprints but will be under 'Inactive' state. Only the Admin can activate the user in Zoho Sprints. And only after the user confirms the invitation email they can carry out the further operations. Learn more on how to activate users.
Before the user confirms or if the user is in 'Inactive' state in Zoho Sprints, then they:
- Can perform allowed operations from Zoho Projects to Zoho Sprints.
- Cannot view the operations in Zoho Sprints.
How are user roles mapped?
|
Zoho Sprints
|
Zoho Projects
|
|
Team Owner
|
Portal Admin
|
|
Member
|
Admin, Manager, Employee, Contractor, Client User
|
- When you add a new user (and client user) in the mapped project from Zoho Projects, the user will be added to Zoho Sprints. But at a team level, the user will be added only if they are part of any mapped project.
1 User is synced from Zoho Projects. This user has been moved to Active Status in Zoho Sprints and the user has confirmed the email invite. After the user has confirmed, the role is changed as Manager in Zoho Sprints.
2 User is synced from Zoho Projects. By default, the user has been added to 'Inactive' Status. Only after the confirmation the user will be shown as 'Active'
3 The client user in Zoho Projects should be added to Zoho One to integrate with Zoho Sprints.
Editing user
When you modify the user details from Zoho Projects it gets automatically updated in Zoho Sprints. When you modify the project details and add it as a Zoho Sprints project, all the users will be synced to Zoho Sprints.
Deleting user
You cannot delete a Zoho Projects user from Zoho Sprints. Alternatively, you can delete them at a team level but the user will only be moved to 'Inactive' status and will not be deleted. You have to delete the user from Zoho Projects to remove them from Zoho Sprints.
Deactivating users
Deactivating synced users from both the applications will hold the user as an active user and they can perform all the operations.
General FAQs
What happens if I don't activate the synced Zoho Projects user in Zoho Sprints?
The user remains in the 'Inactive' status and the user will not be able to add work items, log hours, and perform further operations. You can assign the users to the work items but they can neither view nor perform any actions until the user gets activated in Zoho Sprints.
How do I know that the user is confirmed in Zoho Sprints?
Once you activate the Zoho Projects user, they will receive an invitation email to confirm their account. Only if the user confirms the email they can start working with Zoho Sprints.
Can I sync a new user added from Zoho Sprints to Zoho Projects?
No, you cannot sync a new user from Zoho Sprints to Zoho Projects. But a new user added from Zoho Projects will be synced to Zoho Sprints. But, the user will remain in the 'Inactive' state.
Can I delete a Zoho Projects user from Zoho Sprints?
No, you cannot delete a user added synced from Zoho Projects. The user should be deleted in Zoho Projects and only then they can be deleted from Zoho Sprints.
How does work item status differ in Zoho Sprints and Zoho Projects?
When you integrate Zoho Projects with your Zoho Sprints account, you can sync your work items. However, the status updates will be different for both the products.
For instance, when you add an item in Zoho Sprints and Zoho Projects, the work item in Zoho Sprints will be added with the status ' To Do ' and in Zoho Projects it will be added with ' Open '.
Can I sync Client and Vendor users from Zoho Sprints end?
Client and Vendor users are not supported in Zoho Sprints projects that are integrated with Zoho Projects. If you navigate to the Users module, only Team user option will be available in the integrated projects. If you enable Zoho Projects integration for an existing Sprints project that has Client and Vendor users, you will get an error stating that the project cannot be synced due to the presence of Client/Vendor users.
However, Client user is supported from Zoho Projects end. You can integrate a Zoho Projects project with Client user, but the user will be added as a team user in Zoho Sprints.
User group sync
User group sync enables you to bridge the user groups in Zoho Sprints and teams in Zoho Projects. It allows you to create user groups in either sprints workspace or projects portal and have it synced to the other. The verification process for the email alias is also unified. Learn how to verify email alias while creating user groups.
User group sync behaviour
- New user groups created in Zoho Sprints will automatically be created as teams in Zoho Projects.
- Similarly, new teams created in Zoho Projects will automatically be created as user groups in Zoho Sprints.
- Existing user groups in Zoho Sprints will be synced to Zoho Projects when integration is enabled and vice versa.
- Users associated with the user groups in Zoho Sprints will automatically be added as users in Zoho Projects portal following the sync. However, they will be inactive users in the projects portal and will not have access until activated by the portal owner.
- Similarly, users associated with the teams in Zoho Projects will automatically be added as users in Zoho Sprints workspace. These users will be inactive in the workspace and will not have access until activated by the workspace owner.
-
Modifying user group name, owner, email alias (will require you to perform the email verification for the new alias), users, and projects in Zoho Sprints will automatically reflect in Zoho Projects and vice versa.
Note: The email verification process for the alias will be triggered from both the Zoho Sprints and Zoho Projects. However, it is sufficient to verify from any one of those two applications. -
Deleting the user groups in Zoho Sprints will reflect in Zoho Projects and vice versa. However, the users associated with those groups will not be deleted from Sprints workspace or Projects portal.
Activate users
To activate users:
- Click the gear icon and open settings page.
- Select Workspace Users under Manage Users section. The listing page with the users will appear.
- Click the ellipsis icon at the top. A dropdown will appear.
- Select Activate Users. The users listing will appear.
- Click the toggle button to activate the required users.
Error and troubleshoot
|
Error Message
|
Reason |
Troubleshoot
|
| Start and end dates cannot be empty for projects marked as 'Strict' in Zoho Projects. |
In Zoho Projects, if the project is marked as Strict they do not allow the users to clear or modify the dates.
|
You can modify the strict project to a normal project in Zoho Projects.
|
|
1. Modify the dates within the 'Strict project' date range to update the work item in Zoho Projects.
2. Modify the dates within the 'Strict project' date range to add the work item in Zoho Projects.
|
Work items cannot be updated with a different date range in the mapped projects that are defined as 'Strict' in Zoho Projects.
|
Add or update the start and end dates within the date range mentioned in Zoho Projects.
After modification, add the work item to Zoho Projects.
|
|
This user is mapped with Zoho Projects. You cannot delete this user from Zoho Sprints.
|
When you try deleting the user who is mapped with Zoho Projects.
|
Delete the user from Zoho Projects and then try deleting the user from Zoho Sprints.
|
|
Your Zoho Projects portal is in the free plan. Upgrade to sync log hours added in Zoho Sprints.
|
Timesheet is available only in the paid plan in Zoho Projects.
|
You have to upgrade your Zoho Projects portal to a paid plan to access timesheets.
|
|
You cannot log hours for closed item in Zoho Projects.
|
Logging hours is restricted for a work item that is moved to a closed status.
|
You have to reopen the work item in Zoho Projects and then try adding log hours in Zoho Sprints.
|
|
You cannot modify the details of an approved log hours in Zoho Projects.
|
Once after the log hour is approved, users will not be able to do any modification since it may affect the actual logged hours
|
Create a new work item, sync it to Zoho Projects, and new log hours.
|
|
You cannot log hours for the selected date in Zoho Projects.
|
If the time log settings in Zoho Projects is restricted to past or future dates and the date that you specify does not fall under the specific date.
|
|
|
There is a log hour restriction. The log hours will not be updated in Zoho Projects.
|
The maximum log hour limit per day in Zoho Project is either customized by the user or is set by default to 24 hours. You will not be able to add more than 24 hours or the defined limit.
|
|
|
Billing status cannot be modified for log hours already having a task billing type in Zoho Projects
|
If a task in Zoho Projects is either billable or non billable type, you cannot edit the billing status of its log hours in Zoho Sprints. |
Change the billing type to 'none' in Zoho Projects and then edit it.
|
Delete Integration
- The data sync between Zoho Projects and Zoho Sprints cannot be recovered after deleting the integration.
- Reestablishing the integration between the two applications, after deleting, will lead to duplication of tasks in Zoho Projects and duplication of work items in Zoho Sprints. The duplication occurs only when you try to sync items that were previously synced before deleting the integration.
To delete the integration between Zoho Sprints and Zoho Projects:
- Navigate to your Zoho Projects portal's Setup page.
- Click on Marketplace.
- Select Zoho Apps. The app listing page will appear.
- Click the Update button on the Zoho Sprints tile. The configuration page will appear.
- Click the Delete Integration button. A confirmation pop-up will appear.
- Select the checkbox and click the Delete button. The integration will be removed and sync between the two applications will be stopped.
Note:
- Only a user who is both a portal owner in Zoho Projects and a team owner in Zoho Sprints will be able to delete the integration.
- Deleting the integration will remove the sync between projects, items, comments, and timesheets in the two applications.
- Deleting the integration is supported only in Zoho Projects.
Common FAQs
Will the mapping resume when a mapped project is moved to archive?
- When you move a mapped project to archive in Zoho Sprints, mapping will be removed even though the project is active in Zoho Projects.
- When you move a mapped project to archive in Zoho Projects, mapping will not be removed. Only if the project is deleted from the archives in Zoho Projects, the entire mapping will be removed.
Access your files securely from anywhere
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Zoho DataPrep Resources
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
Zoho Projects
Here are some common questions you might have while integrating Zoho Sprints and Zoho Projects. These are segmented based on the project, work item, log hours, and user sync to guide you better. If your questions are not answered here, you can always ...What is the difference between Zoho Sprints and Zoho Projects?
While both, Zoho Sprints and Zoho Projects, are software project management tools that helps businesses manage work efficiently, they are unique in how projects are run in them. Zoho Projects offers conventional project management techniques with the ...Zoho Analytics integration
One can oversee the course of a business and forecast its future with a wide range of detailed reports. Besides the inbuilt reports, you can now generate customized reports by integrating Zoho Sprints account with Zoho Analytics. Enable the ...About projects
A project within Zoho Sprints is an entity that encompasses certain goals to be achieved. A product or business can have multiple streams and various sets of goals ahead. These goals can be grouped into projects with each having a definite or ...Can I view archived projects?
Yes, you can view all the archived projects in the your workspace in a single folder. To view archived projects: Navigate to the All Projects tab. Select Archive folder. The projects in that folder will be listed. Click here to learn all about ...
New to Zoho LandingPage?
Zoho LandingPage Resources