ActiveCollab 2

You can import tasks from your ActiveCollab2 instance using the activecollab2 service name.

Instructions

You can obtain your user ID and API url by logging into ActiveCollab and clicking on “Profile” and then “API Settings”. When on that page, look at the URL. The integer that appears after “/user/” is your user ID.

Projects should be entered in a comma-separated list, with the project id as the key and the name you’d like to use for the project in Taskwarrior entered as the value. For example, if the project ID is 8 and the project’s name in ActiveCollab is “Amazing Website” then you might enter 8:amazing_website

Note that due to limitations in the ActiveCollab API, there is no simple way to get a list of all tasks you are responsible for in AC. Instead you need to look at each ticket that you are subscribed to and check to see if your user ID is responsible for the ticket/task. What this means is that if you have 5 projects you want to query and each project has 20 tickets, you’ll make 100 API requests each time you run bugwarrior pull.

Example Service

Here’s an example of an activecollab2 target. Note that this will only work with ActiveCollab 2.x - see above for 3.x and greater.

[my_bug_tracker]
service = activecollab2
activecollab2.url = http://ac.example.org/api.php
activecollab2.key = your-api-key
activecollab2.user_id = 15
activecollab2.projects = 1:first_project, 5:another_project
[my_bug_tracker]
service = "activecollab2"
url = "http://ac.example.org/api.php"
key = "your-api-key"
user_id = 15
projects = "1:first_project, 5:another_project"

The above example is the minimum required to import issues from ActiveCollab 2. You can also feel free to use any of the configuration options described in Common Service Configuration Options.

Provided UDA Fields

Field Name

Description

Type

ac2body

ActiveCollab2 Body

Text (string)

ac2createdbyid

ActiveCollab2 Created By

Text (string)

ac2createdon

ActiveCollab2 Created On

Date & Time (date)

ac2name

ActiveCollab2 Name

Text (string)

ac2permalink

ActiveCollab2 Permalink

Text (string)

ac2projectid

ActiveCollab2 Project ID

Text (string)

ac2ticketid

ActiveCollab2 Ticket ID

Text (string)

ac2type

ActiveCollab2 Task Type

Text (string)