ÃÛ¶¹ÊÓÆµ

Kick-Starts scenario: company, group, role, and user Kick-Starts preparation

When you begin implementing ÃÛ¶¹ÊÓÆµ Workfront, rather than manually inputting data, you can import your customer list, internal departments, job roles, and user information.

Access requirements

Expand to view access requirements for the functionality in this article.

You must have the following access to perform the steps in this article:

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
ÃÛ¶¹ÊÓÆµ Workfront plan Any
ÃÛ¶¹ÊÓÆµ Workfront license

New: Standard

or

Current: Plan

Access level configurations System Administrator

For more detail about the information in this table, see Access requirements in Workfront documentation.

What you can import

The following table displays the companies, groups, and roles to import:

Companies
Groups
Roles

Acme, Co

Workfront, Inc.

Your Company

XYZ, Inc.

Finance

IT

Marketing

Sales

Business Analyst

Controller Creative

Designer

Resource Manager

Scrum Master

Technical Writer

Web Developer

Role names must be unique. Existing job roles cannot be imported.

The following tables display the users to import and several user attributes for each:

User 1

Attribute
Value
First Name
Chris
Last Name
Manning
Username/Email
mailto:cmanning@foo.com
Password
updateMe
Access
Team Member
Company
<Your Company>
Home Group
Marketing
Job Role
Business Analyst

User 2

Attribute
Value
First Name
Jennifer
Last Name
Campbell
Username/Email
jcampbell@foo.com
Password
updateMe
Access
Project Manager
Company
<Your Company>
Home Group
Marketing
Job Role
Project Manager

User 3

Attribute
Value
First Name
Jill
Last Name
Sullivan
Username/Email
jsullivan@foo.com
Password
updateMe
Access
Help Desk
Company
<Your Company>
Home Group
Sales
Job Role
Sales Rep

User 4

Attribute
Value
First Name
Marc
Last Name
Lewis
Username/Email
mlewis@foo.com
Password
updateMe
Access
Portfolio Manager
Company
<Your Company>
Home Group
Finance
Job Role
Controller

User 5

Attribute
Value
First Name
Pam
Last Name
Reynolds
Username/Email
preynolds@foo.com
Password
updateMe
Access
Project Manager
Company
Your Company>
Home Group
Marketing
Job Role
IT

User 6

Attribute
Value
First Name
Ray
Last Name
Andrews
Username/Email
randrews@foo.com
Password
updateMe
Access
Administrator
Company
Your Company>
Home Group
Resource Manager
Job Role
none

Download a Kick-Start Template

  1. Click the Main Menu icon Main Menu in the upper-right corner of ÃÛ¶¹ÊÓÆµ Workfront, or (if available), click the Main Menu icon Main Menu in the upper-left corner, then click Setup Setup icon .

  2. Click System > Kick-Starts > Import Data.

  3. Click More Options to see the full list of import options.

  4. Select the Access Level, Company, Group, Job Role, and User objects that you want to import.

  5. Click Download.

Input company information

  1. Open the Workfront.xlsx file you just downloaded.

    note tip
    TIP
    When working with very wide data sheets, you may want to use your spreadsheet editor’s Freeze Pane (or equivalent) tool to make the spreadsheet easier to work with.
  2. Go to the CMPY Company sheet.

    It should be empty unless companies are already in the system.

    Company sheet Company ID

  3. Enter TRUE in the isNew column.

    Repeat this action for each company being added. (In this example, complete this action for rows 3-6, because four companies are being added.)

    Company is new

  4. Enter a unique ID.

    You must enter an ID for each row. Integers starting at 1 work well when creating new records.

    Company is new

  5. Enter the names of each customer in the setName column.

    Company ID

  6. Go to the GROUP Group sheet.

    Unless you have already created groups in Workfront, this sheet should display only the Default Group provisioned with every account of Workfront.

    Group sheet Empty group sheet

  7. Enter TRUE in the isNew column.

    According to the scenario, 4 groups will be imported, so enter TRUE in the isNew column for rows 4 through 7.

  8. Enter a unique ID.

    You must enter an ID for each row. Integers starting at 1 work well when creating new records.

    Group IDs

  9. Enter the names of each department in the setName column.

    Group names

  10. Go to the ROLE Role sheet.

    Unless you have already created or deleted roles in your account, this sheet should display 8 roles that are provisioned with every account of Workfront.

    Group names

  11. Enter TRUE in the isNew column.

    According to the scenario, 7 Job Roles will be imported, so enter TRUE in the isNew column for rows 12 through 18.

    Role is new

  12. Enter a unique ID.

    You must enter an ID for each row. Integers starting at 1 work well when creating new records.

    Role is new

  13. Enter a name for each role in the setName column.

    Role is new

  14. Provide additional details as needed.

    Include billing rates, cost rates, and descriptions for the Roles you are creating, as needed.

  15. Go to the USER User sheet.

    Unless you have already created users in your account, this sheet should display only the Admin User that is provisioned with every account of Workfront.

    User sheet Empty user sheet

  16. Enter TRUE in the isNew column.

    According to the scenario, 6 users will be imported, so enter TRUE in the isNew column for rows 4 through 9.

    User is new

  17. Enter a unique ID.

    You must enter an ID for each row. Integers starting at 1 work well when creating new records.

    User is new

  18. Enter the names of each user in the setFirstName and setLastName columns.

    Usernames

  19. Set detail values by entering values in the setEmail, setPassword, and setUsername columns.

    User credentials

  20. Specify Access Level values.

    For example, Chris Manning is a Team Member. Look up the ID on the ACSLVL Access Level sheet for the Team Member access level. Copy the ID, and on the USER User sheet paste it in the setAccessLevelID column on that user’s row.

    Repeat this step for each user and access level.

    Copy access level ID Paste access elevel ID

  21. Enter the user’s Home Group details.

    According to the scenario, Chris Manning belongs to the Marketing group. On the GROUP Group sheet, locate the ID for the Marketing group, copy it, and on the USER User sheet paste it in the setHomeGroupID column on the user’s row. ​Repeat this step for each user and group assignment.

    Copy group ID Paste group ID

  22. Enter the user’s Company details.

    All of the users in this scenario belong to the same company. On the CMPY Company sheet, locate the ID for the Your Own Company company, copy the ID, and on the USER User tab, paste this value into each row of the setCompanyID ³¦´Ç±ô³Ü³¾²Ô.​

    Repeat this step for each user and group assignment.

    Company ID Paste company ID

  23. Enter the user’s Job Role details.

    According to the scenario, Chris Manning will have the Business Analyst role. On the ROLE Role sheet, locate the ID for the Business Analyst role, copy it, and on the USER User sheet paste it in the setRoleID column on the user’s row. ​Repeat this step for each user and group assignment.

    Copy role ID Paste role ID

  24. Fill in other user details, as needed, then save the file.

  25. Import the Excel File.

    Follow the directions provided in Import data into ÃÛ¶¹ÊÓÆµ Workfront using a Kick-Start template.

NOTE
Users imported to Workfront are created in a Deactivated and Pending Approval status.
If your organization has been migrated to the ÃÛ¶¹ÊÓÆµ Admin Console, and a user does not move out of Deactivated and Pending Approval status within a few minutes, you can add the batch of users to the ÃÛ¶¹ÊÓÆµ Admin Console directly.
For instructions, see in the ÃÛ¶¹ÊÓÆµ documentation.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43