Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
stylenone

Bulk Job

Use the Bulk Jobs functionality to pull data from Tempo (using their API) or Jira Worklogs (using JQL) and push to target web services systems (e.g. Workday Timesheet, UKG, etc).

Here’s how you can define a bulk job. OnLink keeps track of last time the job ran, so you can use smart values like {last_successful_rundate} or {last_successful_runtime} in your JQL. OnLink will automatically replace these values with actual date or date-time values are run time.

...

To define a Bulk Job, select “Bulk Jobs” menu in OnLink and click on Add New. Then select the source data - you use select Tempo if you’re using that app or simply JQL to define the JQL that pulls worklogs.

...

Tempo Timesheets

OnLink pulls approved timesheets for selected teams and periods from Tempo. Users can optionally supplement Tempo timesheet data with data in JSM Assets or Jira issue data before pushing timesheets to target systems like Workday Time Tracking.

Here are the steps to configure Tempo source.

...

Attribute

Description

config:teams=all

Set to pull teams from Tempo, set it to “all” to pull all teams from Tempo

Can also be set to a comma separated string to pull a few specific teams e.g. config:teams=9283,9230

config:periods=previous_month

Set to pull periods to process. Set it to keywords previous_month or previous_week to automatically pull relevant periods.

Can also be set to a specific period e.g. config:periods=2024-01-01,2024-01-07 where 2024-01-01 is from date and 2024-01-07 is end date.

config:worker_aql=workspace id|object name|filter attribute

The “worker_aql” can optionally be used to pull any data attributes from JSM Assets. This pulls data based on Jira user filter. Set three attributes for this configuration:

  1. workspace id - use the link in help text to get the workspace ID

  2. object name - name of your assets object

  3. attribute - name of object attribute of type Atlassian user, used as filter condition

filter:timesheet_approval_status=APPROVED

Set this to filter Tempo timesheets - in this example, only APPROVED timesheets will be processed

filter:worklog_attributes_key=activity|development,design

Set this to filter worklogs - in this example, only those worklogs that have the “activity” attribute set to development or design will be processed

{WorkerAssetsData/asset attribute}

Use this syntax in the target message mapping to map object attribute.

{worklogIssueFields/customfield_10134}

Use this syntax in the target message mapping to map issue fields.

Jira Worklogs - JQL

Here’s the configuration for JQL.

You can use a JQL to return all issues that have worklogs you want to process. A couple of examples:

...