Manage workspaces

Workspaces are individual work areas. Each workspace represents a project or product managed on the same ALM Octane site. This topic discusses how to manage workspaces.

About workspaces

Workspaces are individual work areas, each representing a project or product managed on the same ALM Octane site.

Workspaces are associated with spaces. For details on workspaces, see Manage spaces.

Enterprise Edition: Workspaces can be organized into categories called programs. For details on programs, see Organize workspaces into programs (Enterprise Edition).

Every space has at least one active workspace. the default workspace. The original name of this workspace is default_workspace. It can be renamed but it cannot be deleted.

Who manages workspaces? 

  • Space admins create, rename, modify and delete workspaces. For details on the space admin's capabilities, see Space admin.

  • Admins for workspaces can manage the workspace contents. For details on the admin's capabilities, see Workspace admin*.

    Note: Roles can be customized. Roles and their permissions might be different for your organization.

What data do workspaces contain? 

Workspaces can contain data such as the backlog, application modules, tests, defects, customization settings, and so on.

Enterprise Edition: Workspaces can be organized into categories called programs. Backlog items can be associated with programs. Regardless of being associated with a program, you can rank, filter and analyze backlog items in the same workspace.

Can workspaces share data?

Spaces that are shared Spaces that are isolated

Enterprise Edition: 

Workspaces associated with shared spaces can share items, such as releases, rules, and so on. These items are called shared entities.

To share data, define the entity for the associated shared space, and not for any specific workspace. For a list of entities that can be shared, see Shared spaces.

Define these entities in a specific workspace if you want them available only in that workspace.

You can define some entities, such as rules and forms, both for an individual workspace and for all workspaces associated with a shared space. Space admins can define these entities for the shared space, and the admins for workspaces can define these entities for individual workspaces.

Backlog items in workspaces can be associated with programs.

Workspaces associated with isolated spaces do not share data.

Workspaces associated with isolated spaces do not share data.

Enterprise Edition: Backlog items in workspaces can be associated with programs.

Tip: For strategies for setting up your spaces and workspaces, see Best practices for setting up spaces and workspaces.

Back to top

Create a workspace

The space admin creates workspaces. For details, see Create workspaces.

Back to top

Edit workspace settings

Admins with access to the workspace Settings area can edit the settings on the workspace-level.

  1. In Settings > Spaces, select a workspace.

  2. Edit the workspace settings by changing the workspace name, adding or editing releases, teams, DevOps settings*, rules, user-defined fields (UDFs), forms, and workflow phases.

    *DevOps settings include CI servers, Testing Tools, test assignment rules, settings for SCM integration, and Slack integration.

    Note: If some of these workspace settings are not available, they are probably shared across multiple workspaces. Your space admin can make these updates for you on the corresponding shared space.

Back to top

Manage users

From the spaces pane, a workspace admin can manage users for a workspace.

Organize workspaces into programs (Enterprise Edition)

Admins with access to the workspace Settings area can organize workspaces into virtual categories called programs. This is particularly useful for SAFe Large Solution configuration support.

A program represents some kind of dev mission. For example, in a private banking workspace, you might create programs called DirectPay, MyAccount Mobile, MyAccount Web, Services, and Back Office.

Programs are not actual entities. They facilitate filtering, ranking, and reporting within a workspace.

You can associate backlog items (features, user stories, quality stories, and defects) with programs, and then filter the Backlog module grid accordingly. You can also filter tests whose covered content is associated with a program.

To create programs:

  1. In Settings > Spaces, select a workspace.

  2. Click Programs.

  3. Click + to add and name a program.

Back to top

Disable workspaces

The space admin can disable workspaces temporarily, and then enable them. For details, see Disable and enable workspaces.

Back to top

Delete workspaces

The space admin deletes workspaces. For details, see Delete workspaces.

Back to top

Manage workspace storage

Available workspace storage is set on the space level, and not per workspace. This means the amount of total available workspace storage is shared between the workspaces in the space.

On-premises: Site admins can set the maximum size for storage per space with the STORAGE_MAX_SIZE configuration parameter. For details, see the information about setting the maximum size for storage (STORAGE_MAX_SIZE) in the ALM Octane Installation Guide.

Back to top

Next steps: