Skip to main content

ThreeSixty Dashboard

What is a ThreeSixty Dashboard​

The ThreeSixty Dashboard resource is a wrapper resource that contains references to the Source Map, Field Set, and Container that constitute the Dashboard in your EX Project.

If you would like to join the early access program for XM Solution Plugins, then please let us know by taking this survey.

Not generally available

This feature is in Early Access and is not yet generally available. Functionality, APIs, and documentation may change before general availability.

Context​

The ThreeSixty Dashboard resource will generate two fields:

  • dashboardId
  • fieldSetId

The dashboardId will be the id of your Container and can be accessed with <step.id>.dashboardId. The fieldSetId will be the id of the Field Set associated with this Dashboard and can be accessed with <step.id>.fieldSetId.

How to import it into an XM Solution​

Using the XM Solution CLI​

You can import a ThreeSixty Dashboard resource along with its associated Container, Source Map, and Field Set using the CLI import command.

Start by running the following command:

solution import

Next, select EXProject from the list of project types.

1. survey
2. CXDashboard
3. EXProject

Then, select one of the following EX Project types to view all EX Projects of that type to import:

1. EmployeeAdHoc
2. EmployeeEngagement
3. EmployeeLifecycle
4. ThreeSixtyProject

A list of EX Projects will be displayed, and you can select one to import:

1. [EmployeeAdHoc] proj1
2. [EmployeeAdHoc] proj2
3. [EmployeeAdHoc] proj3
4...

Now you should have your EX Project and all of its dependencies downloaded into a src/Resources_**** folder of your solution plugin. This will include any ThreeSixty Dashboard resources that are attached to your EX Project.

How to import a ThreeSixty Dashboard resource into an XM Solution​

Using the XM Solution CLI​

You can import a ThreeSixty Dashboard resource along with its associated EX Project resources using the CLI import command.

To do this, follow these directions to import an EX Project.

Now you should have your EX Project and all of its dependencies downloaded into a src/Resources_**** folder of your solution plugin. This will include a ThreeSixty Dashboard resource if the EX Project has a Dashboard.

Solution Execution​

ThreeSixty Dashboard resources are created using a "Create" step or updated using an "Update" step in the Solution Execution file.

{
  "id": "ThreeSixtyDashboard",
  "type": "Create",
  "dependencies": [
    "Container",
    "EXProject",
    "Fieldset",
    "Sourcemap"
  ],
  "config": {
    "apiVersion": "threesixtydashboard.v1",
    "templateFilePath": "Resources/ThreeSixtyDashboard.json",
    "transformationFilePath": "Resources/interpolate.js"
  }
}

The current apiVersion for ThreeSixty Dashboard resources is "threesixtydashboard.v1".

Common / Required changes​

ThreeSixty Dashboard resources will need their containerId, fieldSetId, sourceMapId, and threeSixtyID fields replaced with "{{ $.containerStep.id }}", "{{ $.fieldsetStep.id }}", "{{ $.sourceMapStep.id }}", and "{{ $.EXProjectStep.id }}" respectively where containerStep, fieldsetStep, sourceMapStep, and EXProjectStep are the ids of the Container, Field Set, Source Map, and EX Project steps that this ThreeSixty Dashboard depends on.