Configure friendly names and OLAP export settings

Introduction

Configure an existing analytical table so that its display names, inclusion, visibility, and column presentation match the needs of report users. In AnalyticsCreator, OLAP settings describe how tables and columns are used in the generated analytical model.

This how-to takes you from finding the table to saving and checking its settings in your Data Warehouse (DWH) project. Generating and deploying the analytical model are separate tasks.

The screenshots illustrate one project. Use your own table, column names, categories, and display requirements; the pictured selections are examples.

Applicability

Use this workflow for existing tables in the Data Mart Layer (DM). The table export settings and the column OLAP settings described here apply to datamart objects. The 2-sided setting applies only to tabular OLAP models.

The workflow uses the AnalyticsCreator desktop interface. The product version is not identified in the captures.

Prerequisites

3.1. An open Data Warehouse (DWH) project with an existing datamart table available for editing.

3.2. The table's schema and technical name, and an understanding of the data represented by each column you intend to configure.

3.3. The intended analytical model type, table and column inclusion and visibility requirements, and display names. For any aggregation, format, or category you intend to change, a configuration supported by that target model.

3.4. Existing column references if you intend to select an OLAP Reference. Creating a reference is covered in Define OLAP table references and many-to-many cardinality.

Steps

Expand Layers

In the navigation tree of the intended Data Warehouse (DWH) project, expand Layers.

Expand Layers in the navigation tree. The diagram contains existing example objects.
Navigation tree with Layers expanded and the project layers visible.

Expand the datamart schema

Expand Datamart layer, then expand the schema containing the table you want to configure. A schema groups the project's table definitions. STAR is the schema used in the example.

Expand the intended schema under Datamart layer; STAR is the example shown.
Datamart layer with the STAR schema expanded to show its folders.

Open the Tables context menu

Right-click the Tables folder under that schema.

Right-click Tables. This capture locates the folder before the context menu opens.
Pointer over the Tables folder under the STAR schema.

List the tables

Click List tables in the context menu. The table list opens for the selected schema.

Click List tables in the Tables context menu.
Tables context menu with List tables highlighted.

Open the intended table

In the list, identify the table by the Table Schema and Table Name columns. Review Table Type to confirm its role, then double-click the required row to open the table definition.

The selected DIM_CustomerCustomerDemo row is an example. Select the table whose analytical presentation you need to change.

Match the schema and technical table name before opening the required row.
Table list showing Table Schema, Table Name, and Table Type, with an example table selected.

Enter the table's friendly name

In the table definition, confirm Table Name and Table Schema. The upper area contains table settings; the Columns tab below contains settings for individual columns.

Enter the intended display label in Friendly name. A friendly name can be used instead of the technical name in the diagram and generated OLAP content. Keep the technical Table Name unchanged when your task is only to change its display label.

Naming example: Customer_Star is the friendly name entered in the capture. It is a literal display label, not a required naming pattern.

Friendly names can also pass to dependent objects through inheritance rules. If a name must follow an upstream object, retain the intended inheritance rule rather than treating the current label as independent.

Enter the table display label in Friendly name. Customer_Star is an illustrative value.
Table definition with the Friendly name field being edited and the Columns tab below.

Select a table category when needed

If the analytical model requires a table category, select it in OLAP Category. This setting classifies the table as a whole. Choose a category that describes what the table represents: for example, Customers for customer data or Products for product data. Do not copy Customers merely because it appears in the capture.

If no table category is required, leave the setting unassigned. If a category is already assigned, check that it still describes the table before keeping it. Column categories are configured separately in Configure the required columns.

OLAP Category offers table categories. Customers is selected in this example.
Open OLAP Category list showing categories including Customers, Geography, and Products.

Set table inclusion and visibility

Use the two table settings for distinct decisions:

  1. Export to OLAP — Select this checkbox when the table should be included as a fact or dimension during analytical model generation. Clear it when the table should be excluded.
  2. Hidden in OLAP — For a table being exported, select this checkbox when the generated fact or dimension should be hidden from normal browsing. Clear it when the object should be visible. Hiding an object is different from excluding it from generation.

Check the final checkbox states against your inclusion and visibility requirements. Selecting Export to OLAP configures inclusion; it does not itself generate or deploy a model.

Set Export to OLAP and Hidden in OLAP. The pointer obscures the export checkbox in this intermediate capture; verify the final state in your project.
Pointer over Export to OLAP, with Hidden in OLAP and OLAP Category below it.

Configure the required columns

Select the Columns tab. Identify each intended row by Column name and check its Data Type before changing its analytical settings. Use the horizontal scrollbar to reach settings farther to the right, keeping track of the row being edited.

Enter the column's display label in FriendlyName when report users need a different label from its technical name. This setting can be used in transformations and generated OLAP content, and can be inherited by dependent objects.

Edit FriendlyName on the intended column row. The capture also shows OLAP Reference, 2-sided, In OLAP, and Default aggregate; the display folder, format, and category settings are farther to the right.
Columns grid with a FriendlyName cell selected and adjacent OLAP settings visible.

For each column, review the following settings and change those required by your analytical design:

  1. OLAP Reference — Select an existing column reference when the relationship is required in the analytical model. Confirm that the reference points to the intended table and column. If a required reference does not yet exist, define it using Define OLAP table references and many-to-many cardinality before selecting it here. Leave the setting unassigned for a column that does not require an analytical relationship.
  2. 2-sided — For a tabular OLAP model, select this checkbox only when the selected relationship is intended to be two-sided. Clear it when that behavior is not required. This setting is not a substitute for defining many-to-many cardinality.
  3. In OLAP — Controls column transfer and visibility in the analytical model. Review it separately from the table's Export to OLAP setting. The capture shows Transfer; use that choice for a column intended for transfer, and retain an existing hidden or excluded configuration when that is the intended design.
  4. Default aggregate — Select the default aggregation rule required for the column. Base the decision on what its values mean: an amount intended to be added across rows has different requirements from an identifier, date, or rate. Use the rule established for that column in the target model; do not infer it from a numeric data type alone.
  5. DisplayFolder — Enter a folder name when fields need to be grouped in the analytical model. Use the same folder name for fields intended to appear together. Leave this setting empty when no folder grouping is required.
  6. FormatString — Enter a display format supported by the target analytical model when values need a particular presentation, such as a date, amount, or percentage. Check the column's data type and the meaning of its stored values before entering the format. Leave this setting empty when no explicit format is required. A display format does not correct an incorrect underlying data type.
  7. DataCategory — Assign a column category when the analytical model needs to interpret the field's meaning. Choose a supported category that matches the actual values, not the table's name or its OLAP Category. Leave this setting unassigned when no semantic category is required.
  8. Inheritance — Rules can pass friendly names, descriptions, and display folders to dependent objects. Before relying on a local name or folder, check whether its intended behavior is to inherit only when empty, to inherit always, or not to inherit. For column-to-column friendly name and display folder inheritance, the project parameters use 0 for inherit if empty, 1 for always, and 2 for never. Their exact names are listed in Table.

Check every changed row before saving. The screenshot's column names, Transfer selections, and blank aggregation cells are examples, not defaults for all columns.

Save and check the table settings

Review the table's friendly name, category, inclusion, and visibility, then review the column settings changed in Configure the required columns. Click Save at the bottom of the table definition.

Click Save at the bottom of the table definition after reviewing the settings.
Save button highlighted below the Columns grid.

Use List tables again as described in Open the Tables context menu and reopen the same table. Compare its saved settings with the intended configuration using the checks in Expected Results.

Expected Results

The table definition retains the intended analytical settings after saving and reopening it.

5.1. Confirm the technical table name and schema, then compare Friendly name, OLAP Category, Export to OLAP, and Hidden in OLAP with your intended values.

5.2. On Columns, compare every changed row's display label, relationship, transfer and visibility choice, aggregation rule, folder, format, and category. If a name or folder differs, check its inheritance rules.

5.3. After your separate model generation and deployment workflow, verify object inclusion and visibility, display names, folders, and representative formatted and aggregated values in the analytical model. Saving this definition alone does not demonstrate those generated results.

Decisions and variations

6.1. Inclusion and visibility. Use Export to OLAP for table inclusion and Hidden in OLAP for the visibility of an exported table. Review column transfer and visibility through In OLAP. See Set table inclusion and visibility and Configure the required columns.

6.2. Table and column categories. OLAP Category classifies a table; DataCategory describes a column. Assign each only when required by the analytical design. Neither a friendly name nor a format changes the meaning of the source values.

6.3. Model type and inheritance. Apply 2-sided only to tabular OLAP relationships that require it. When names or folders should follow upstream objects, account for the inheritance rules before relying on local settings. See Configure the required columns and Table.

Troubleshooting

  1. Required object is missing — Confirm the Data Warehouse (DWH) project and schema, then reopen List tables. If Search criteria contains an unintended restriction, remove it and click Search. Match the schema and technical table name before opening a row.
  2. Save is unavailable or fails — Read any displayed validation message and correct the setting it identifies. If Locked by identifies another editor, coordinate the edit with that person before continuing. Reopen the table after saving to confirm which values were retained.
  3. Saved definition differs from the intended result — Compare the reopened table and column settings with the intended design. For an unexpected name or folder, review inheritance. For a missing or hidden analytical object, check table inclusion, table visibility, and column transfer settings separately, then verify the generated model through your model generation and deployment workflow.