WorkspaceUpsert

Use this node to create or update a Tableau Next workspace.

Asset Type Name for Rules

workspace

Example Definition in chain.json

1{
2  "name": "create_workspace",
3  "label": "Creates Workspace",
4  "dominoVariant": "sfdc_internal__UnifiedAnalyticsDominoVariant",
5  "parameters": {},
6  "definition": {
7    "nodes": {
8      "upsert_workspace1": {
9        "graphNodeType": {
10          "name": "WorkspaceUpsert"
11        },
12        "parameters": {
13          "name": "myworkspace",
14          "label": "My Workspace",
15          "file": "workspaces/workspace.json",
16          "assets": {
17            "name": "MySemanticModel",
18            "assetType": "SemanticModel",
19            "usageType": "Referenced"
20          }
21        },
22        "sources": [],
23        "runAs": "CurrentUser"
24      }
25    }
26  }
27}

Parameters

Parameter	Definition
`name`	(Required) The developer name for the workspace.
`label`	(Required) The label for the workspace. This is the label that appears in app logs and app install history.
`file`	(Required) The path to the JSON file that contains the workspace input representation.
`condition`	(Optional) An EL expression, evaluated at runtime, that determines whether to create or upgrade this workspace or not.
`assets`	(Optional) An array describing which assets are contained in or referenced by this workspace.
`assets.name`	(Required) The developer name of the asset.
`assets.assetType`	(Required) The asset type.
`assets.usageType`	(Required) The asset usage type. Valid usage type values are `Created` and `Referenced`.

Set runAs to CurrentUser so that this node runs with the permissions of the user installing the app. If you omit runAs, the node runs as AutoProc, a system user.

Note

App Context Values

Workspaces created from a template get an entry in the App Context if they are successful. These entries are keyed off of the template specific asset name and contain information about the instance that was created.

App Context Value	Definition
`App.Workspaces.<template specific asset name>.Id`	The ID of the created workspace.
`App.Workspaces.<template specific asset name>.Name`	The developer name of the created workspace.
`App.Workspaces.<template specific asset name>.Label`	The label of the created workspace.

On Failure

If this task fails, it returns a FAIL_TERMINAL status. The chain stops and no downstream nodes run.

See Also

Orchestrate Templated App Assets with Chains