Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Excerpt
hiddentrue

 learn how to link Projector time cards to JIRA and Zendesk, Zendesk, ServiceNow, and any third party platform


Info

Projector offers the ability to link JIRA and Zendesk , Zendesk, ServiceNow, and any generic third party platform with Projector time cards. This guide teaches users how to do just that. This help document assumes that you have already configured JIRA or Zendesk to connect with Projectoran external connector.

To start, the first thing you should understand is how the integration works. Projector provides two modes of operation.

  1. Link Projector time card to a JIRA/Zendesk/ServiceNow/Generic issue - this allows you to click a link from a time card and view the issue in JIRA/Zendeskthe third party platform. It does not automatically update any data between the two systems. For example, if you change the hours in Projector the JIRA/Zendesk issue does not update.
  2. Import JIRA/Zendesk/ServiceNow/Generic data - this allows you to search your JIRA/Zendesk database for tickets and create Projector time cards based on the metadata therein. This is a one-time pull of data. If you update a ticket in JIRA/Zendeskon your platform, the associated Projector time card will not automatically update. In addition, if you were to re-import time cards for the same dataset, the existing time cards will not automatically update, they will be left intact and new time cards created. This is a one-way data pull. If you update Projector time cards, JIRA/Zendesk your third party will not update.

Your installation may have one or both of of these options available to you. We'll discuss each in turn for this help article.

...

  1. Go to Time Entry at https://app.projectorpsa.com/timesheet
  2. Click Import at the bottom center of your screen
     
  3. Choose your JIRA/Zendesk integration from the dropdown list and the time period you are interested in:
  4. Map Projector fields to JIRA/Zendesk fields. The left column contains Projector time card fields. The right column shows your available JIRA/Zendesk fields. 
     
  5. Click Review Time
  6. Map any fields in red that don't have a mapping yet. Then tick the checkbox  to flag it for import.
  7. Click Import or Import and Close


JIRA

...

The following metadata can be imported from JIRA into Projector.

FieldDescription
Issue ID
Issue Key
Issue Summary
Issue Description
Work Date
Issue Type Id
Issue Type Description
Issue Type Name
Project ID

Product Key


Project Name
Issue Resolution Id
Issue Resolution Name
Issue Resolution Description
Issue Resolution Date
Work Hours
Work Comment
Custom FieldsAny custom fields added in the External Connector configuration.

Zendesk

When you import Zendesk time cards, you'll get one time card for each time the ticket was updated. Ten ticket updates will result in ten time cards. There is the potential for the sum of time cards to shift away from the sum of time spent in Zendesk. This happens because Zendesk tracks time at the seconds level. Projector only goes down to the 3 minute level. Because of that, rounding will take place. The net of that rounding can result in disparities between the two systems.

...

When you import from Zendesk, it does on a whole day basis. So you should only import from Zendesk when you are sure no more tickets updates will be made for the day. Otherwise you can end up with duplicate data. For example, if I import at lunch time and again at dinner time, the tickets from before lunch will be imported twice.


The following metadata can be imported from Zendesk into Projector:

...