×îв©²ÊÍøÕ¾

Integration with ×îв©²ÊÍøÕ¾ Projects

Purpose

With the help of ×îв©²ÊÍøÕ¾ People's integration with ×îв©²ÊÍøÕ¾ Projects, you can achieve the following:

  • Import your Projects, Tasks, and Timesheets from ×îв©²ÊÍøÕ¾ Projects to ×îв©²ÊÍøÕ¾ People manually or automatically.
  • Push approved time logs from ×îв©²ÊÍøÕ¾ People to ×îв©²ÊÍøÕ¾ Projects.

Integrating with ×îв©²ÊÍøÕ¾ Projects

Only the administrator of ×îв©²ÊÍøÕ¾ People who is also the administrator in ×îв©²ÊÍøÕ¾ Projects for the portal can enable the integration.

To integrate with ×îв©²ÊÍøÕ¾ Projects,

  • From your home page, go to Settings > Integration > ×îв©²ÊÍøÕ¾.
  • Click View Details under ×îв©²ÊÍøÕ¾ Projects.
  • Choose the portal to integrate.
  • If required enable Import projects, tasks, and time logs from ×îв©²ÊÍøÕ¾ Projects automatically.
  • If required enable Push time logs automatically when a timesheet is approved.  

  • Click Enable

​If automatic import is enabled, Projects, Tasks, and Timesheets will be imported from ×îв©²ÊÍøÕ¾ Projects to ×îв©²ÊÍøÕ¾ People as soon as the integration is active. 

Importing from ×îв©²ÊÍøÕ¾ Projects

You can pull the list of projects, tasks, and timesheets from ×îв©²ÊÍøÕ¾ Projects to ×îв©²ÊÍøÕ¾ People manually or automatically,

Manual Method

To import the projects and corresponding tasks from ×îв©²ÊÍøÕ¾ Projects,

  • From your home page, go to Timesheet > Projects/Jobs > Projects.
  • Click on the ellipsis icon and select Import from ×îв©²ÊÍøÕ¾ Projects.

  • Select your desired projects and click Import.

 

Note: 

  1. Only the projects and the corresponding tasks will be imported. Timesheets will not be imported.
  2. By default, owners of the tasks become assignees of the Jobs.
  3. Those users who are made as Administrators of the Timesheet module under 'Admin Operations' will also be able to do this import from ×îв©²ÊÍøÕ¾ Projects. Click here to know more about Admin Operations.
  4. Once the timesheet data is imported into ×îв©²ÊÍøÕ¾ People, the user access permissions defined in the ×îв©²ÊÍøÕ¾ People timesheet service will apply to the imported records. Users with the necessary permissions can edit the imported data, such as jobs, projects, and timesheets. To configure user permissions, refer to Configuring Permissions for a Role.

Automatic Method

Using the automatic method, Projects, tasks, and timelogs can be imported from ×îв©²ÊÍøÕ¾ Projects to ×îв©²ÊÍøÕ¾ People automatically, with no manual effort. You can set up a frequency for the sync to occur periodically or use the manual sync when you want projects, tasks and timelogs to be updated instantly, from ×îв©²ÊÍøÕ¾ Projects.

To enable this,

  • From your homepage, go to Settings > Integrations > ×îв©²ÊÍøÕ¾.
  • Click View Details under ×îв©²ÊÍøÕ¾ Projects.
  • Details of the configured portal will be visible here.
  • Enable Import projects, tasks, and time logs from ×îв©²ÊÍøÕ¾ Projects automatically.

​

  • Setup a frequency for the sync.
  • Any changes that you make in ×îв©²ÊÍøÕ¾ Projects can be updated instantly in ×îв©²ÊÍøÕ¾ People using the Sync now button.

​

Now, all Projects, tasks and timelogs from ×îв©²ÊÍøÕ¾ Projects will be imported to ×îв©²ÊÍøÕ¾ People, automatically based on the frequency set.

Entity Mapping

  • Projects in ×îв©²ÊÍøÕ¾ Projects will be imported as Projects in ×îв©²ÊÍøÕ¾ People.
  • Tasks in ×îв©²ÊÍøÕ¾ Projects will be imported as Jobs in ×îв©²ÊÍøÕ¾ People.
  • Timesheets in ×îв©²ÊÍøÕ¾ Projects will be imported as Time logs in ×îв©²ÊÍøÕ¾ People.

Limitations:

In Projects/Tasks:

  • If the person performing the import is an admin in ×îв©²ÊÍøÕ¾ Projects then all the Projects and tasks belonging to that portal will get imported and if that person is a non-admin in ×îв©²ÊÍøÕ¾ Projects, only the projects in which they are a part of will get imported, with its corresponding tasks.
  • Deleting a Job(Task)/Project in ×îв©²ÊÍøÕ¾ Projects does not reflect in ×îв©²ÊÍøÕ¾ People.
  • The task list and sub-tasks in ×îв©²ÊÍøÕ¾ Projects will not get imported.
  • Changes that were made on imported Projects(and associated Jobs) in ×îв©²ÊÍøÕ¾ People will be reset if the User re-imports them.

In Timesheets:

  • All the timesheets in ×îв©²ÊÍøÕ¾ Projects will be imported as unapproved and unbilled time logs in ×îв©²ÊÍøÕ¾ People.
  • The changes made to the Timesheets in ×îв©²ÊÍøÕ¾ Projects will reflect only if they are editable in ×îв©²ÊÍøÕ¾ People.
  • In ×îв©²ÊÍøÕ¾ Projects, the time logs of User A can be changed to User B, which is not possible in ×îв©²ÊÍøÕ¾ People. Such updates in ×îв©²ÊÍøÕ¾ Projects will not be reflected in ×îв©²ÊÍøÕ¾ People.
  • Time logs imported from ×îв©²ÊÍøÕ¾ Projects cannot be pushed back to ×îв©²ÊÍøÕ¾ Projects.

Pushing Approved Time Logs to ×îв©²ÊÍøÕ¾ Projects

You can push the approved time logs from ×îв©²ÊÍøÕ¾ People to ×îв©²ÊÍøÕ¾ Projects. Time logs which are approved, associated with a Project and with log hours between 0 to 24 hours can only be pushed. Time logs in ×îв©²ÊÍøÕ¾ People will be pushed as Timesheets in ×îв©²ÊÍøÕ¾ Projects.

To push the approved time logs to ×îв©²ÊÍøÕ¾ Projects, 

  1. From the homepage, go to Timesheet > Reports > Integration Reports.
  2. From the drop down select ×îв©²ÊÍøÕ¾ Projects.
  3. Filter the time logs to be pushed based on Users/Clients/Projects.
  4. Click ×îв©²ÊÍøÕ¾ Projects under Push To.

  1. The approved time logs of the chosen timesheets will be pushed to ×îв©²ÊÍøÕ¾ Projects.

While pushing time logs, if the corresponding project is not available in ×îв©²ÊÍøÕ¾ Projects, then upon confirmation a new project will be created in ×îв©²ÊÍøÕ¾ Projects and the mapping will be done as follows: 

  • Employees (Users) who have a valid email id in ×îв©²ÊÍøÕ¾ People will be pushed as Employees in ×îв©²ÊÍøÕ¾ Projects.
  • Projects in ×îв©²ÊÍøÕ¾ People will be pushed as Projects in ×îв©²ÊÍøÕ¾ Projects.
  • Jobs in ×îв©²ÊÍøÕ¾ People will be pushed as Tasks in ×îв©²ÊÍøÕ¾ Projects.

Push time logs automatically: If you have enabled Push time logs automatically when a timesheet is approved, then the approved time logs will be pushed automatically as soon as a timesheet is approved. 

Note: Disabling the integration will not affect the data that has already been pushed.

Limitations:

  • Time logs once pushed cannot be re-pushed.
  • Any changes made in ×îв©²ÊÍøÕ¾ People to the already pushed time logs will not have any impact on ×îв©²ÊÍøÕ¾ Projects.
  • Time logs which fail ×îв©²ÊÍøÕ¾ Projects validation alone will be skipped, rest of the time logs will be pushed.
  • Only the administrator of the account/ location-based administrator of the account(if any) (configured under User Access Control > Roles) and location-based administrator for Timesheet module (if any) (Configured under User Access Control > Permissions > Admin Operations) can push time logs to ×îв©²ÊÍøÕ¾ Projects.

Disabling integration with ×îв©²ÊÍøÕ¾ Projects:

Only the administrator of the ×îв©²ÊÍøÕ¾ People organization can disable the integration. 

To disable the integration,

  1. From your homepage go to Settings > Integrations > ×îв©²ÊÍøÕ¾.
  2. Click View Details under ×îв©²ÊÍøÕ¾ Projects.

Details of the configured portal will be visible here.

  1. Click Disable

Note: ×îв©²ÊÍøÕ¾ Projects is integrated with ×îв©²ÊÍøÕ¾ People's leave module.