How to integrate Primetric with Teamwork?

Table of contents

• Integration with the Primetric - how it works?
• Before start - important info
• Integration instruction
• Syncing work logs from Teamwork
• Additional questions

Integration with Primetric - how it works?

The integration allows you to sync work logs inputted in the Teamwork software to the Primetric. You can easily connect chosen projects in Teamwork with projects in the Primetric and sync work logs based on email addresses of your teammates provided in the Primetric.

Before start - important info

• To integrate Primetric with Teamwork software you need to have Administrator access on both platforms
• To sync work logs of the specific person you need to add it as a Manager or Employee and provide the same e-mail address as in Teamwork

Integration instruction

1. Log in to the Primetric and go to the Integrations tab in the Administrator role
2. Find the Teamwork logo and click the Install button on the right side of the screen
3. Follow the instruction displayed after clicking the Install button:
   
   1. Configure Teamwork app:
      1. If you are not signed, please sign in
      2. Copy its URL, e.g. mycompany.teamwork.com, and paste it into a new tab
      3. If you have never created any OAuth connection, fill in the entry form
      4. Click the Create your first app button
      5. Copy and paste Name, Redirect URLs from Primetric to Teamwork
      6. Choose the Teamwork product
      7. Click the Create App button
      8. Go to the Credentials tab
   2. Configure Primetric:
      1. Copy Client ID and Client secret from Teamwork
      2. Paste it in Primetric and click the Authorize button
      3. Log to the Teamwork one more time, and click the Allow button
      4. Click the Authorize button one more time
      5. After that, you should see the information that integration is properly installed

Syncing work logs from Teamwork

The last step to properly sync work logs from Teamwork is to add projects in the Primetric and sync them with the projects in Teamwork. To do it:

1. Switch to the Manager role
2. Add new project or open existing one
3. Find Integration settings placed on the right side of the screen (on the Project's Page) and click on it
4. Find Teamwork logo and select checkbox
5. In the Select projects, field provide name/-s of the project/-s that you want to integrate with
6. Choose from when work logs should be synced and click Reset and sync all work logs
7. Wait until all work logs will be synchronized. If someone will be missing Primetric will tell you which of a team member is missing. In this case, you should add a missing person to the Primetric as a Manager or Employee and provide his e-mail address.

Voile'a! Your integration is fully enabled. Now tracking work logs in the Primetric is a piece of cake :)

Additional questions

Can I sync multiple projects in Primetric?

Yes! You can choose as many projects as you want to sync them in one project in Primetric. To do it choose many projects in the Select Projects field in Integration settings. 

I don't see the project's structure that I have in Teamwork - why?

Primetric is syncing only work logs. We don't synchronize a project's tasks, phases, issues, or other project structures. If you want to have a more advanced project's structure you need to create it in Primetric.

What "prevent new assignment creation" means?

Prevent new assignment creation means that Primetric will not sync work logs of people which you didn't add to a specific project. 

Example

Let's assume that Bobby and Sam log their work in Teamworkin Project A. We created Project A in Primetric as well and add to it Bobby without Sam. If we select "prevent new assignment creation" and we will sync work logs Primetric will add only Bobby's work logs. Because we didn't add Sam to Project A in Primetric, his work logs won't be synchronized.

What "trim assignments to work logs" means?

Trim assignments to work logs means that our system will crop assignment duration only to the duration of the first and last work log that has been synced. Normally, Primetric is creating assignment as long as duration of the project.

Example

Let's assume that Bobby was working on Project A from 1st February to 19th March. In Primetric Project A lasts from 1st January to 22nd September. If you don't select the "trim assignment to work logs" after syncing Bobby's work logs Primetric will create an assignment as long as the duration of Project A. 

BUT, if you select the "trim assignment to work logs" checkbox, Primetric will create an assignment from 1st February to 19th March. 

HINT: If Bobby logged work only on 1st February and 19th March, Primetric will not create two assignments, but one assignment which lasts from 1st Feb to 19th March.

What "clear data" means?

Deleting all synced work logs. 

Do I need to manually sync new work logs? How often work logs are synchronized?

No, you don't! Primetric automatically syncs work logs every 24h, so you can be sure that work logs are always up to date.