VisualizationUpsert

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

Asset Type Name for Rules

visualization

Example Definition in chain.json

1{
2  "name": "create_visualization",
3  "label": "Creates Visualization",
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        },
17        "sources": [],
18        "runAs": "CurrentUser"
19      },
20      "upsert_sdm1": {
21        "graphNodeType": {
22          "name": "SemanticModelUpsert"
23        },
24        "parameters": {
25          "name": "Test_Sample",
26          "label": "Test Sample",
27          "file": "sdms/sdm.json"
28        },
29        "sources": ["upsert_workspace1"],
30        "runAs": "CurrentUser"
31      },
32      "upsert_visualization1": {
33        "graphNodeType": {
34          "name": "VisualizationUpsert"
35        },
36        "parameters": {
37          "name": "myvisualization",
38          "label": "My Visualization",
39          "file": "visualizations/visualization1.json"
40        },
41        "sources": ["upsert_sdm1"],
42        "runAs": "CurrentUser"
43      }
44    }
45  }
46}

Parameters

Parameter	Definition
`name`	(Required) The developer name for the visualization.
`label`	(Required) The label for the visualization. This is the label that appears in app logs and app install history.
`file`	(Required) The path to the JSON file that contains the visualization representation.
`condition`	(Optional) An EL expression, evaluated at runtime, that determines whether to create or upgrade this visualization or not.

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

Visualizations 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.Visualizations.<template specific asset name>.Id`	The ID of the created visualization.
`App.Visualizations.<template specific asset name>.Name`	The developer name of the created visualization.
`App.Visualizations.<template specific asset name>.Label`	The label of the created visualization.

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