ACTIVATE command

Concept Information

Using workspaces to share field definitions

Adds field definitions stored in an Analytics workspace to the existing set of field definitions in an Analytics table layout.

Syntax

ACTIVATE <WORKSPACE> workspace_name <OK>

Parameters

Name Description
WORKSPACE workspace_name

The name of the workspace to activate.

OK

optional

Deletes or overwrites items without asking you to confirm the action.

If there is a field in the table with an identical name to one in the activated workspace, it will be overwritten without confirmation. You cannot replace any field that is referenced by a computed field.

Examples

Activating a workspace in your Analytics project

You activate the ComplexFormulas workspace:

ACTIVATE WORKSPACE ComplexFormulas OK

Activating a workspace saved as a file (.wsp) in the same folder as your Analytics project

You activate the ComplexFormulas workspace that was saved to a .wsp file:

ACTIVATE WORKSPACE ComplexFormulas.WSP OK

Remarks

How it works

ACTIVATE makes workspace field definitions available to the active table. Once you activate a workspace, its fields remain available for use with the active table until you close the table.

Editing table layouts

The workspace fields are permanently added to the table layout if:

  • you edit the table layout after you activate a workspace
  • you make a change that causes the table layout to be saved

Once the workspace fields are saved in the table layout, you can:

  1. Use the DEFINE COLUMN command to add the fields to a view.
  2. Use the SAVE command to save your changes.