> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Workfront Connector

## Intro

Workfront (formerly called AtTask) develops web-based work management and project management software . Use Domo's Workfront connector to retrieve data for a selected Workfront object. To learn more about the Workfront API, visit their page ([https://support.workfront.com/hc/en-us/articles/220633507-API-Explorer](https://support.workfront.com/hc/en-us/articles/220633507-API-Explorer) ).

The Workfront connector is a "Cloud App" connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the connector page for this and other Cloud App connectors by clicking **Cloud App** in the toolbar at the top of the window.

You connect to your Workfront account in the Data Center . This topic discusses the fields and menus that are specific to the Workfront connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

<table class="mt-responsive-table" data-aura-rendered-by="33:196;a"><tbody><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Use Cases </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> Use this connector to pull data about the status of projects and the individual tasks that apply to those projects. </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Metrics </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><ul><li><p> Project status </p></li><li><p> Start and complete dates </p></li><li><p> Hours per project </p></li><li><p> User hours </p></li><li><p> Resources </p></li><li><p> Common issues </p></li></ul></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Company Roles </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><ul><li><p> Project manager </p></li><li><p> Operations </p></li></ul></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Average Implementation Time </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> 5-10 hours for basic implementation </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Ease of Use (on a 1-to-10 scale with 1 being easiest) </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> 5 </p></td></tr></tbody></table>

## Best Practices

* Reports should typically be run using "Replace." Users are limited to 10 concurrent running reports, so you should avoid having 10 or more DataSets scheduled to run at the same time.
* You will need to have a good understanding of the data in your Workfront account to get useful data from the connector.

## Prerequisites

To connect to your Workfront account and create a DataSet, you must have the following:

* The username and password or the API key associated with your Workfront account. You must update the API key in your connector when it expires.
* The URL for your Workfront server (for example, `https://yourcompany.workfront.com` ).
* You also need to select the API version.

Note that some users may have `attask` domains, while others may have `workfront` domains.

## Connecting to Your Workfront Account

This section enumerates the options in the **Credentials**, **Details**, and **Advanced** panes in the Workfront Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

### Credentials Pane

This pane contains fields for entering credentials to connect to your Workfront account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:196;a"><thead><tr><th colspan="1" rowspan="1"><p> Field </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Username </p></td><td colspan="1" rowspan="1"><p> Enter the username to log into your Workfront account. You must provide a username and password OR an API Key. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Password </p></td><td colspan="1" rowspan="1"><p> Enter the password to log into your Workfront account. You must provide a username and password OR an API Key. </p></td></tr><tr><td colspan="1" rowspan="1"> API Key </td><td colspan="1" rowspan="1"> Enter your Workfront API key. You must update the API key in the connector connection when it expires. You must provide a username and password OR an API Key. </td></tr><tr><td colspan="1" rowspan="1"> URL </td><td colspan="1" rowspan="1"> Enter the URL for your AtTask/Workfront server (for example, <a href="https://yourcompany.attask-ondemand.com" target="_blank"> [https://yourcompany.attask-ondemand.com](https://yourcompany.attask-ondemand.com) </a> >). </td></tr><tr><td colspan="1" rowspan="1"> API Version </td><td colspan="1" rowspan="1"> Choose the API version to connect to. </td></tr></tbody></table>

Once you have entered valid Workfront credentials, you can use the same account any time you go to create a new Workfront DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center . For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

### Details Pane

This pane contains options for selecting a Workfront object and configuring filter fields, date range, etc.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:196;a"><thead><tr><th colspan="1" rowspan="1"><p> Parameter </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select the Workfornt report you want to run. The following reports are available: </p><table><tbody><tr><td colspan="1" rowspan="1"><b> Report </b></td><td colspan="1" rowspan="1"><b> Description </b></td></tr><tr><td colspan="1" rowspan="1"> Approval </td><td colspan="1" rowspan="1"> Returns a list of approvals for the account. </td></tr><tr><td colspan="1" rowspan="1"> Assignment </td><td colspan="1" rowspan="1"> Returns a list of assignments, including assigner and assignee, average work per day, project, and current status. </td></tr><tr><td colspan="1" rowspan="1"> Baseline </td><td colspan="1" rowspan="1"> Returns a list of project baselines, including project ID, start and completion dates, customer ID, budget, and planned hours. </td></tr><tr><td colspan="1" rowspan="1"> Category </td><td colspan="1" rowspan="1"> Returns a list of categories (custom data forms). </td></tr><tr><td colspan="1" rowspan="1"> Group </td><td colspan="1" rowspan="1"> Returns a list of groups, including group ID, customer ID, and description. </td></tr><tr><td colspan="1" rowspan="1"> Hour </td><td colspan="1" rowspan="1"> Returns the number of hours entered for users in the account. </td></tr><tr><td colspan="1" rowspan="1"> Hour Type </td><td colspan="1" rowspan="1"> Returns a list of hour types used in the account, with name, description. </td></tr><tr><td colspan="1" rowspan="1"> Issue </td><td colspan="1" rowspan="1"> Returns a list of issues, including start date, assignee, current status, description, planned hours, and responsible team. </td></tr><tr><td colspan="1" rowspan="1"> Job Role </td><td colspan="1" rowspan="1"> Returns a list of job roles used in the account, with name, description, and cost per hour. </td></tr><tr><td colspan="1" rowspan="1"> Milestone </td><td colspan="1" rowspan="1"> Returns a list of milestones, including name, description, customer ID. </td></tr><tr><td colspan="1" rowspan="1"> Milestone Path </td><td colspan="1" rowspan="1"> Returns a list of milestone paths, including name, description, and customer ID. </td></tr><tr><td colspan="1" rowspan="1"> Note </td><td colspan="1" rowspan="1"> Returns a list of notes, including note subject, note text, project, and owner. </td></tr><tr><td colspan="1" rowspan="1"> Parameter </td><td colspan="1" rowspan="1"> Returns a list of parameters (fields in custom data forms). </td></tr><tr><td colspan="1" rowspan="1"> Portfolio </td><td colspan="1" rowspan="1"> Returns a list of portfolios, including name, customer, and entry date. </td></tr><tr><td colspan="1" rowspan="1"> Program </td><td colspan="1" rowspan="1"> Returns a list of programs, including name, owner, description. </td></tr><tr><td colspan="1" rowspan="1"> Project </td><td colspan="1" rowspan="1"> Returns a list of projects, including name, budget, actual costs, hours worked, status, and owner. </td></tr><tr><td colspan="1" rowspan="1"> Project User </td><td colspan="1" rowspan="1"> Returns a list of project users, including customer ID, project ID, and user ID. </td></tr><tr><td colspan="1" rowspan="1"> Resource Allocation </td><td colspan="1" rowspan="1"> Returns information about resource allocation for given projects and customers, including scheduled hours, budgeted hours. </td></tr><tr><td colspan="1" rowspan="1"> Resource Pool </td><td colspan="1" rowspan="1"> Returns a list of available resource pools, including customer ID and description. </td></tr><tr><td colspan="1" rowspan="1"> Schedule </td><td colspan="1" rowspan="1"> Returns a list of schedules in the account. </td></tr><tr><td colspan="1" rowspan="1"> Task </td><td colspan="1" rowspan="1"> Returns a list of tasks, including start date, assignee, current status, description, planned hours, and responsible team. </td></tr><tr><td colspan="1" rowspan="1"> Team </td><td colspan="1" rowspan="1"> Returns a list of teams in the account. </td></tr><tr><td colspan="1" rowspan="1"> Templates </td><td colspan="1" rowspan="1"> Returns a list of templates in the account. </td></tr><tr><td colspan="1" rowspan="1"> Timesheet </td><td colspan="1" rowspan="1"> Returns timesheet information for all users in the account. </td></tr><tr><td colspan="1" rowspan="1"> Users </td><td colspan="1" rowspan="1"> Returns information for all users in the account, including name, title, email address, billing information. </td></tr><tr><td colspan="1" rowspan="1"> Work </td><td colspan="1" rowspan="1"> Returns information about work done, including expense and labor cost, duration, and revenue. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Custom Fields </p></td><td colspan="1" rowspan="1"><p> Enter the custom fields for your report, separated by commas </p></td></tr><tr><td colspan="1" rowspan="1"><p> Reference Fields </p></td><td colspan="1" rowspan="1"><p> Enter the reference fields for your report as a comma-separated list. </p><p> Format: <code> reference object:reference field </code></p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274).

## FAQs

<AccordionGroup>
  <Accordion title="Can I use the same account to create multiple DataSets?">
    Yes.
  </Accordion>

  <Accordion title="How often can the data be updated?">
    DataSets can be updated as often as once an hour.
  </Accordion>

  <Accordion title="Are there any API limits I should be aware of?">
    Workfront is limited to 10 concurrent DataSets.
  </Accordion>

  <Accordion title="Why do I need to add DE: as a prefix for custom fields?">
    To learn about adding prefixes for custom fields, see the following: [https://support.workfront.com/hc/en-...ng-custom-data](https://support.workfront.com/hc/en-us/articles/115003574147-API-Basics#retrieving-custom-data "https://support.workfront.com/hc/en-us/articles/115003574147-API-Basics#retrieving-custom-data").
  </Accordion>
</AccordionGroup>
