A Workspace is a grouping of related workflows that encapsulates multiple Environments for different sets of users and applications that are integrated. Workspaces are an important way to allow OneCloud to be deployed for different purposes.

In this exercise, we will create setup the Workspace needed for the exercises in this quick-start guide.

Primary Learning Objective

This exercise is designed to reinforce the concept of Workspaces.

Secondary Learning Objectives



A OneCloud tenant.

Supporting Template


📓 The sample screenshots and videos may deviate from what is seen in a user's OneCloud tenant.

Step 1: Create a Workspace

Login to your OneCloud tenant and select Workspaces from the left-side navigation panel. Edit the Workspace with the following changes:

  • Click the blue (+) plus circle.

  • Under Basic Info, name the Workspace "Sample Workspace for Transformations".

    • Users may opt to add variables at this point. However, these steps have been broken apart for edification purposes.

  • Save the change.

📓 To Edit an Existing Workspace, click the blue "Edit" rectangle to the right of the Workspace and make the desired changes.

Step 2: Add Variables

If Variables weren't added when the Workspace was created, go back and add some. Variables hold values that are reusable in various areas of the Workspace.

  • Click the "Edit" button on the right side of the Workspace.

  • The default includes one space for a Variable

    • Select the blue (+) button to the right of the Variables section header to add others.

  • The new Variable will appear below (in the section namesake).

  • For this example, set the Name to "data-type".

  • Save the change.

Step 3: Create an Environment

Add a new Environment that will be dedicated to run production-only operations.

  • Click the blue (+) button to the right of the existing Environment.

  • Under Basic Info, set the Name to "PROD".

  • If desired, click the color box to assign a different color.

  • Save the change.

📓 Different Environments may be assigned the same color.

Step 4: Update the Environment Variables

This is an area where you can override Variables and set the proper value based on the Environment.

  • To edit an Environment, click the ✏️ icon within the Environment's box.

  • Inside the “DEV” Environment, the Variables are listed towards the bottom.

  • Set the “data-type” variable to “dev-data”.

  • Save the change.

  • Edit the “PROD” Environment, altering the “data-type” variable to “prod-data”.

  • Save the edit.

Step 5: Switch between Environments

Use the Environment-switcher to quickly switch between Environments.

  • When in one Environment (Ex. DEV):

    • Near the upper-right corner, select the 🔽 to toggle between Environments.

📚 Additional topics in this article:

Workspace Setup

Workspace Variable Configuration

Environment Setup



Transformations Quick-Start Overview

Configure a Connection

Did this answer your question?