github-asana-action's Introduction

Github-Asana action

This action integrates asana with github.

Prerequisites

Asana account with the permission on the particular project you want to integrate with.
Must provide the task url in the PR description.

Inputs

`asana-pat`

Required Your public access token of asana, you can find it in asana docs.

`trigger-phrase`

Required Prefix before the task i.e ASANA TASK: https://app.asana.com/1/2/3/. For special characters in the trigger phrase refer to the examples.

`task-comment`

Optional If any comment is provided, the action will add a comment to the specified asana task with the text & pull request link.

`targets`

Optional JSON array of objects having project and section where to move current task. Move task only if it exists in target project. e.g

targets: '[{"project": "Backlog", "section": "Development Done"}, {"project": "Current Sprint", "section": "In Review"}]'

if you don't want to move task omit targets.

Sample PR Description

**Asana Task:** [Task Name](https://app.asana.com/0/1/2)

Examples

Without special characters:

uses: insurify/[email protected]
with:
  asana-pat: 'Your PAT'
  task-comment: 'View Pull Request Here: '
  trigger-phrase: 'Asana Task:'
  targets: '[{"project": "Backlog", "section": "Development Done"}, {"project": "Current Sprint", "section": "In Review"}]'

With special characters:

uses: insurify/[email protected]
with:
  asana-pat: 'Your PAT'
  task-comment: 'View Pull Request Here: '
  trigger-phrase: "\\*\\*Asana Task:\\*\\*"
  targets: '[{"project": "Backlog", "section": "Development Done"}, {"project": "Current Sprint", "section": "In Review"}]'

Recommend Projects