Overview of moving objects between Workfront environments (Environment promotion)
The highlighted information on this page refers to functionality not yet generally available. It is available only in the Preview Sandbox environment.
The environment promotion capability allows you to move objects from one Workfront environment to another. For example, you can create a template and configure it in your sandbox environment, knowing that any testing you do will not affect your organization’s actual data. After the template is configured and tested, you can move it to your production environment, ready to use.
This process is referred to as “environment promotion.”
You can perform this process in Workfront by creating a package of objects to move, and then installing that package in the new environment.
-
For specific instructions on performing this process within Workfront, see:
-
For instructions on performing this process through the Workfront API, see Move objects between Workfront environments using the Workfront API.
Supported objects for environment promotion
The environment promotion capability is intended to provide the ability to move configuration-related object from one environment to another. These are objects that can be configured, such as projects, teams, or custom forms.
Because environment promotion deals with object configuration, transactional objects (objects that change frequently or that are highly dependent on use case) are not included. Examples of transactional objects include documents, issues, requests, updates, and and proof decisions.
Work objects
Task
Assignment
Predecessor
Company
Override Rate
Group
Role
Team
Approval Process
Approval Path
Approval Step
Step Approver
Schedule
Non Work Day
Queue Definition
Queue Topic Group
Queue Topic
Routing Rule
Milestone Path
Milestone
Hour Type
Resource Pool
Category
Category Parameter
Parameter
Parameter Group
Parameter Option
Category Display Logic
Template Task
Template Task Assignment
Template Task Predecessor
Company
Override Rate
Group
Role
Team
Approval Process
Approval Path
Approval Step
Step Approver
Schedule
Non Work Day
Queue Definition
Queue Topic Group
Queue Topic
Routing Rule
Milestone Path
Milestone
Hour Type
Resource Pool
Category
Category Parameter
Parameter
Parameter Group
Parameter Option
Category Display Logic
Reporting objects
Dashboard
Calendar
Calendar Section
External Page
Report
Filter
Grouping
View
Parameter
Group
Calendar
Calendar Section
External Page
Report
Filter
Grouping
View
Parameter
Calendar Section
Filter
Grouping
View
Parameter
Parameter
Parameter
Parameter
Custom data objects
Category Parameter
Parameter
Parameter Group
Parameter Option
Category Display Logic
Group
Parameter Option
Organization objects
Sub-groups (up to 5 levels) *
Category
Category Parameter
Parameter
Parameter Group
Parameter Option
Category Display Logic
Group
Override Rate
Category
Category Parameter
Parameter
Parameter Group
Parameter
Category Display Logic
Group
Program
Group
Category
Category Parameter
Parameter
Parameter Group
Parameter Option
Category Display Logic
Portfolio
Group
Category
Category Parameter
Parameter
Parameter Group
Parameter Option
Category Display Logic
Other configuration objects
Approval Path
Approval Step
Step Approver
Role
Team
Group
Non Work Day
Group
Milestone
Hour Type
* Not currently available
Environment promotion statuses
Environment promotion packages proceed through several statuses as they are created and prepared to move between environments. You can see these statuses in your list of packages inside Workfront, or in the API responses if you are using the Workfront API.
These statuses include the following:
Resources
- For FAQs regarding environment promotion, see Environment promotion FAQ
- For troubleshooting recommendations, see Environment promotion troubleshooting