Create a Custom Dimension

Learn how to create and configure a custom dimension.

Overview

Custom dimensions are based on other dimensions to make unique data groups for non-numeric data. To modify the structure of a custom dimension, such as its groups and the dimension it uses, you can customize the custom dimension. Customization is done before configuration because it defines the custom dimension's schema. After you define the custom dimension's associated dimension and ranges, you can then configure the members in each custom group.

Create a custom dimension

Note: For a tutorial that walks you through creating a new dimension, see Create New Employee Attributes and Metrics.

You can create a dimension in the Dimensions room or by selecting a specific analytic object on which to create the dimension.

Model > Dimensions steps

In this workflow, select the dimension type to create its associated analytic objects.

  1. In a project, on the navigation bar, click Model > Dimensions.
  2. Click Create Dimension.
  3. Select Custom.
  4. Type a display name and description.
  5. Select an analytic object.
  6. Optional: To add tags to the dimension, click Add Tags. For more information about tags, see Create and Assign Tags to Content.
  7. Optional: To create additional dimensions, in the left panel, click Create. Repeat steps 4 to 6.
  8. When finished, click Done.

    Result: The dimension is created and can now be customized and configured.

Model > Analytic Object steps

In this workflow, select the dimension type to create. You can create many dimensions at once.

  1. In a project, on the navigation bar, click Model > Analytic Objects.
  2. Select an analytic object.
  3. In the Attributes tab, click Add Attribute > Dimension.
  4. Select Custom.
  5. Type a display name and description.
  6. Optional: To add tags to the dimension, click Add Tags. For more information about tags, see Create and Assign Tags to Content.
  7. Optional: To create additional dimensions, in the left panel, click Create. Repeat steps 4 to 6.
  8. When finished, click Done.

    Result: The dimension is created and can now be customized and configured.

Customize a custom dimension

Pick a dimension and create groups related to it.

Example: Let's say your organization wants to simplify your performance ratings into 3 subgroups: High Performer, Solid Performer, and Needs Development. In your Custom Performance Grouping dimension, in the Customize tab, you can select the Performance Rating dimension and then create the three groups. After you're done, you can configure the dimension to select performance rating members for each of the groups.

To customize a custom dimension:

  1. In a project, on the navigation bar, click Model > Dimensions.

  2. Select a custom dimension.
  3. Navigate to Customize.

  4. Click Select Dimension and choose one dimension from the list.
  5. Click Select.
  6. To add groups, click Create Group.
  7. Type a display name and description.

  8. Optional: Click Create Another to make multiple groups.
  9. When finished, click Done.
  10. Optional: Use Reorder to change the order of the dimension's groups.

Tip:  

  • To change the custom dimension's selected dimension, click Edit and then select a different dimension.
  • To change a group's display name and description, click a group to open the Info panel. In the Info panel, type a new display name or description.

Configure a custom dimension

Select dimension members for each group in the dimension to define a custom dimension.

Member selection maps individual member values from a dimension, such as performance levels. The members of the dimension are available for configuration in each group.

Example: Let's say your organization wants to simplify your performance ratings into 3 subgroups: High Performer, Solid Performer, and Needs Development. In your Custom Performance Grouping dimension, in the Configure tab, you can select the performance rating members that should belong to the custom groups High Performer, Solid Performer, and Needs Development, such as selecting Level 6 for High Performer, Levels 4 and 5 for Solid Performer, and Levels 1, 2, and 3 for Needs Development.

To configure a custom dimension:

  1. In a project, on the navigation bar, click Model > Dimensions.

  2. Select a custom dimension and navigate to the Configure tab.
  3. Recommended: To make sure you don't map the same member to multiple groups, turn on Highlight duplicates. This highlights any members that are in more than one group so that you can identify and remove duplicates where necessary.
  4. Expand the group you want to configure.
  5. Do any of the following:
    • To add members to the group, select the appropriate members.
    • To change the group's display name or description, click Edit Basic Information.
  6. Map members to each group until finished.

    Note: All dimension members must be included in a group.

Troubleshoot "Data is not available"

You may see a "Data is not available" note in the Customize tab. To investigate data availability, check:

  • The Data Transfers room in the global workspace. There must be a data file that contains data for the object.

  • The Sources room in the global workspace. The data file containing your object data must be connected to a source. For more information, see Sources.
  • The Mappings room in a project. The source that contains your object data must be mapped to the associated property. For more information, see Mappings.
  • The data version. After mapping your source data to a property in Visier, you must generate a new data version. For more information, see Data Categories and Run a Job.

Publish your changes

When finished configuring and customizing the dimension, publish the project to production. For more information, see Publish Project Changes.

To see your changes, run a data version in production or wait until your next scheduled data load to make the data available to users. For more information, see Data Versions.