Create a Leveled Dimension

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, start by selecting the dimension type to create and then select its associated analytic object.

1. In a project, on the navigation bar, click Model > Dimensions.
2. Click Create Dimension.
3. Selected Leveled, and then click Next.

   Note: If you are a Visier Cloud Administrator creating a leveled dimension, there are additional steps. For more information, see Create a leveled dimension as a Visier Cloud Administrator.

4. Select an analytic object and then click Next.

   This is the object associated with the dimension; for example, if you're creating a dimension for your employees' hair color, the analytic object is Employee.

5. Type a display name and description.
6. When finished, click Create.

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

Model > Analytic Object steps

In this workflow, start by selecting the analytic object and then select the dimension type to create.

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 Leveled, and then click Next.

   Note: If you are a Visier Cloud Administrator creating a leveled dimension, there are additional steps. For more information, see Create a leveled dimension as a Visier Cloud Administrator.

5. Type a display name and description.
6. When finished, click Create.

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

Create a leveled dimension as a Visier Cloud Administrator

You can create a leveled dimension if you want to group and filter the column values from your data files. This is useful for augmenting existing data, for example, if you have a new column in your data and want to create a dimension so that users can group and filter by the new column.

Step One: Select the dimension type and analytic object

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

   Note: If you already know the analytic object you want to create a dimension for, you can alternatively select the object in Model > Analytic Objects and then click Add Attribute > Dimension.

2. In the New dimension dialog, select Leveled.

   Recommended: Select Make dimension shared. This allows you to optionally associate the dimension with multiple data objects, such as both Employee and Applicant.

3. Click Next.
4. Select an analytic object. If the dimension is shared, you can select additional analytic objects after you create the dimension.

   This is the object associated with the dimension; for example, if you're creating a dimension for open requisitions, the analytic object is Requisition.

   Note: If you started from Model > Analytic Objects, this step is skipped.

5. Click Next.

Step Two: Connect data to the dimension

You have three options to connect data to your new dimension. The following diagram illustrates each option with the example of connecting data to Employee.

Option 1: Use existing data (connected to the analytic object)

1. In the Select data source dialog, click Select Source.
2. Select a source from the list.
3. Select a source column. This is the column in your data file to associate with the dimension.
4. Click Next.

Option 2: Use existing data (not connected to the analytic object)

1. In the Select data source dialog, click Select Other Source.
2. In the Select other source dialog, click Select a source.

3. Select a source from the list.

   Note:  

   • The platform creates a new mapping for the dimension's analytic object with the selected source. Because there's a new mapping, future data files for the source must be a full history restatement. With administrator-created leveled dimensions, if a new source or mapping is created, Visier overrides all previously-uploaded files after a new file is loaded to allow you to easily add, remove, and update records across all time.
   • This list only displays sources that aren't connected to any analytic objects. If you want to use a source that's connected to a different analytic object, try uploading a new data file with a unique filename. For more information, see Option 3: Upload new data.
4. Optional: If there are unconnected properties, in the Connect data dialog, select the correct column for each unconnected property.
5. Click Next.

Option 3: Upload new data

1. In the Select data source dialog, click Use Other Source.
2. In the Use Other Source dialog, click Select a file > Upload Data.

3. After you select a file, click Upload File.

   Note: If the new data matches an existing source, the data is connected to the existing source. If the new data doesn't match an existing source, a new source is created. For more information about sources, see Sources.

4. Optional: If there are unconnected properties, in the Connect data dialog, select the correct column for each unconnected property.
5. When finished, click Done.

Step Three: Create the dimension

1. Type a display name and description.
2. Click Create.

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

Errors

The following table lists possible errors and how to resolve them during dimension creation.

Error	Description	Resolution
Can't connect data to analytic object	After you select an analytic object for the dimension and try to connect data (Step Two, Option 2 or 3), Visier can't connect data to the analytic object.	The analytic object doesn't have an existing regular mapping, likely because there is no data for the analytic object. The analytic object must have existing data and mappings to create a new leveled dimension. Contact Visier Technical Support to load data for the analytic object.
No sources available	While selecting a source (Step Two, Option 1), you can't find a specific source that you're looking for in the list even though you know it exists in your Visier solution.	The source may have multiple mappings, so the platform doesn't know which mapping to surface. Contact Visier Technical Support to fix the source configuration.
The source already exists and is connected to a different analytic object	After you upload a data file (Step Two, Option 3), Visier finds a matching source for the file that already has a mapping to a different analytic object.	The data file matches the regex of an existing source, but that source is connected to a different analytic object than the one you selected for the dimension. Change the name of your data file so that it doesn't match the regex of the existing source.

Customize a leveled dimension

In the Customize tab, you can change the dimension's structure by adding additional levels to the dimension, changing the level display names, and changing the level data types.

Edit analytic objects

If the dimension is shared, you can optionally edit the list of analytic objects that the dimension is associated with,

• To change the analytic objects for the dimension, in Analytic objects, click Edit.

Add dimension levels

Each leveled dimension has one level by default. That level starts with the same name as the dimension. You can add additional levels allow to indicate relationships within the data. Each additional level is a branch below the level above it. For example, the Location dimension has specific levels that follow the order they should appear in (region, country, state, city).

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

2. Select a leveled dimension.

   Note: You must select an administrator-created leveled dimension. Visier-created leveled dimensions cannot be customized.

3. In the Customize tab, click Add Level.

4. Select a data type from the list.

5. Type a display name and description.

6. Click Add.
7. Repeat steps 3 to 6 for all levels.
8. Optional: Use Reorder to change the dimension level order.
9. When finished adding new levels, run a job to generate a data version in the project. The new data version contains the new dimension levels, allowing you to preview your changes. For more information about running a job, see Run a Job.

Change a level's display name

Each level has a display name to identify it. You can change the level display name in a project.

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

2. Select a leveled dimension.

   Note: You must select an administrator-created leveled dimension. Visier-created leveled dimensions cannot be customized.

3. In the Customize tab, in Levels, select a level.
4. In the Info panel under Display name, type a new display name.

Change a level's data type

Each level has a data type to define the data it can use. You can change the data type of any level if the dimension doesn't have data loaded already.

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

2. Select a leveled dimension.

   Note: You must select an administrator-created leveled dimension. Visier-created leveled dimensions cannot be customized.

3. In the Customize tab, select a level.
4. In the Info panel under Settings, select a different data type.

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.