Working with Attributes

In This Section:

Process for Creating Attributes

Understanding Attributes

Understanding Attribute Dimensions

Designing Attribute Dimensions

Building Attribute Dimensions

Setting Member Names in Attribute Dimensions

Calculating Attribute Data

Attributes describe characteristics of data such as the size and color of products. Through attributes you can group and analyze members of dimensions based on their characteristics. This chapter describes how to create and manage attributes in an Essbase Server outline.

Note:

The information in this chapter is designed for block storage databases. Some of the information is not relevant to aggregate storage databases. For detailed information on the differences between aggregate and block storage, see Comparison of Aggregate and Block Storage. For information on creating aggregate storage applications, see Aggregate Storage Applications, Databases, and Outlines.

You can find other information about attributes in relevant sections of this book.

Information Needed

More Information

Defining attributes through dimension build

Building Attribute Dimensions and Associating Attributes

Using attributes in partitions

Using attributes in Report Writer

Developing Report Scripts

Process for Creating Attributes

When working with attributes in Outline Editor perform the following tasks:

  1. Create a dimension. See Adding Dimensions and Members to an Outline. In the outline, position the attribute dimensions after all standard dimensions.

  2. Tag the dimension as an attribute dimension and set attribute dimension type as text, numeric, Boolean, or date. See Creating Attribute Dimensions.

  3. Add members to the attribute dimension. See Adding Dimensions and Members to an Outline.

  4. Associate a base dimension with the attribute dimension. See Understanding the Rules for Attribute Dimension Association.

  5. Associate members of the base dimension with members of the attribute dimension. See Understanding the Rules for Attribute Member Association.

  6. If necessary, set up the attribute calculations. See Calculating Attribute Data.

Understanding Attributes

You can use the Essbase attribute feature to retrieve and analyze data not only from the perspective of dimensions, but also in terms of characteristics, or attributes, of those dimensions. For example, you can analyze product profitability based on size or packaging, and you can make more effective conclusions by incorporating into the analysis market attributes such as the population size of each market region.

Such an analysis could tell you that decaffeinated drinks sold in cans in small (less than 6,000,000-population) markets are less profitable than you anticipated. For more details, you can filter the analysis by specific attribute criteria, including minimum or maximum sales and profits of different products in similar market segments.

Here are a few ways analysis by attribute provides depth and perspective, supporting better-informed decisions:

  • You can select, aggregate, and report on data based on common features (attributes).

  • By defining attributes as having a text, numeric, Boolean, or date type, you can filter (select) data using type-related functions such as AND, OR, and NOT operators and <, >, and = comparisons.

  • You can use the numeric attribute type to group statistical values by attribute ranges; for example, population groupings such as <500,000, 500,000–1,000,000, and >1,000,000.

  • Through the Attribute Calculations dimension automatically created by Essbase, you can view sums, counts, minimum or maximum values, and average values of attribute data. For example, when you enter Avg and Bottle into a spreadsheet, Essbase retrieves calculated values for average sales in bottles for all the column and row intersections on the sheet.

  • You can perform calculations using numeric attribute values in calculation scripts and member formulas; for example, to determine profitability by ounce for products sized by the ounce.

  • You can create crosstabs of attribute data for the same dimension, and you can pivot and drill down for detail data in spreadsheets.

    An attribute crosstab is a report or spreadsheet showing data consolidations across attributes of the same dimension. The crosstab example below displays product packaging as columns and the product size in ounces as rows. At their intersections, you see the profit for each combination of package type and size.

    From this information, you can see which size-packaging combinations were most profitable in the Florida market.

                Product Year Florida Profit Actual
    
                     Bottle        Can           Pkg Type
                     =========     =========     =========
      32               946            N/A             946
      20               791            N/A             791
      16               714            N/A             714
      12               241          2,383           2,624
    Ounces           2,692          2,383           5,075

Understanding Attribute Dimensions

In the Sample Basic database, products have attributes that are characteristics of the products. For example, products have an attribute that describes their packaging. In the outline, you see these characteristics as two dimensions, the Products dimension, and the Pkg Type attribute dimension that is associated with it. An attribute dimension has the word Attribute next to its name in the outline.

Figure 37, Outline Showing Base and Attribute Dimensions shows part of the Sample Basic outline featuring the Product dimension and three attribute dimensions, Caffeinated, Ounces, and Pkg Type.

Figure 37. Outline Showing Base and Attribute Dimensions

Outline Showing Base and Attribute Dimensions

In the outline, to the right of the Product dimension, the terms Caffeinated, Ounces, and Pkg Type show that these attribute dimensions are associated with the Product dimension.

A standard dimension is any dimension that is not an attribute dimension. When an attribute dimension is associated with a standard dimension, the standard dimension is the base dimension for that attribute dimension. In the outline in Figure 37, Outline Showing Base and Attribute Dimensions, the Product dimension is the base dimension for the Caffeinated, Ounces, and Pkg Type attribute dimensions.

Note:

Attribute dimensions and members are Dynamic Calc, so Essbase calculates attribute information at retrieval time. Attribute data is not stored in the database.

Understanding Members of Attribute Dimensions

Members of an attribute dimension are potential attributes of the members of the associated base dimension. After you associate a base dimension with an attribute dimension, you associate members of the base dimension with members of the associated attribute dimension. The Market dimension member Connecticut is associated with the 6000000 member of the Population attribute dimension. That makes 6000000 an attribute of Connecticut.

In the outline, the information next to a base dimension member shows the attributes of that member. In Figure 37, Outline Showing Base and Attribute Dimensions, next to product “100-10, Caffeinated:True, Ounces:12, Pkg Type:Can” shows that product 100-10 has three attributes—product 100-10 has caffeine, it is sold in 12-ounce containers, and the containers are cans.

Understanding the Rules for Base and Attribute Dimensions and Members

There are several important rules regarding members of attribute dimensions and their base dimensions.

  • You can tag only sparse dimensions as attribute dimensions.

  • Before you can save an outline to the server, each attribute dimension must be associated with a standard, sparse dimension as its base dimension.

  • Attribute dimensions must be the last dimensions in the outline.

  • Attribute dimensions have a type setting—text, numeric, Boolean, or date. Text is the default setting. Although assigned at the dimension level, the type applies only to the level 0 members of the dimension. For more information, see Understanding Attribute Types.

  • If you remove the attribute tag from a dimension, Essbase removes prefixes or suffixes from its member names. Prefixes and suffixes are not visible in the outline. For more information, see Setting Prefix and Suffix Formats for Member Names of Attribute Dimensions.

  • A base dimension member can have many attributes, but only one attribute from each particular attribute dimension.

    For example, product 100-10 can have size and packaging attributes, but only one size and only one type of packaging.

  • You cannot associate an attribute with an implied shared member the child of which is tagged as shared.

  • Essbase does not support attributes for Hybrid Analysis-enabled members.

You can use attribute values in calculations in the following comparisons:

  • > (greater than)

  • >= (greater than or equal to)

  • < (less than)

  • <= (less than or equal to)

  • = = (equal to)

  • <> or != (not equal to)

  • IN

Understanding the Rules for Attribute Dimension Association

When you associate an attribute dimension with a standard dimension, the standard dimension is known as the base dimension for that attribute dimension.

  • An attribute dimension must be associated with a sparse standard dimension.

  • A standard dimension can be a base dimension for more than one attribute dimension.

  • An attribute dimension can be associated with only one base dimension.

    For example, you might have a Size attribute dimension with members Small, Medium, and Large. If you associate the Size attribute dimension with the Product dimension, you cannot also associate the Size attribute dimension with the Market dimension. Tracking size-related information for the Market dimension requires another attribute dimension with a different name, for example, MarketSize, with the MarketSize attribute dimension associated with the Market dimension.

Understanding the Rules for Attribute Member Association

When you associate a member of an attribute dimension with a member of a base dimension, follow these rules:

  • You cannot associate multiple members from the same attribute dimension with the same base dimension member. For example, the Bottle and Can package types cannot both be associated with the product 100-30.

  • You can associate members from different attribute dimensions with the same member of a base dimension. For example, a decaffeinated cola product (100-30) sold in 16 ounce bottles has three attributes—Caffeinated:False; Ounces:16; and Pkg Type:Bottle.

  • After attributes are associated with base dimension members, if you cut or copy and paste base dimension members to another location in the outline, the attribute associations are lost.

  • Essbase does not require that each member of a base dimension be associated with a member of an attribute dimension.

  • All base dimension members associated with members of a particular attribute dimension must be at the same level.

    For example, in Figure 38, Association of Attributes with the Same Level Members of the Market Dimension, all Market dimension members that have Population attributes are at level 0. You cannot associate East, which is a level 1 member, with a Population attribute since the other members of the Market dimension that have Population attributes are level 0 members.

    Figure 38. Association of Attributes with the Same Level Members of the Market Dimension

    Association of Attributes with the Same Level Members of the Market Dimension
  • The level 0 members of attribute dimensions are the only members that you can associate with base dimension members.

    For example, in the Population attribute dimension, you can associate only level 0 members such as 3000000, 6000000, and 9000000, with members of the Market dimension. You cannot associate a level 1 member such as Small.

    The name of the level 0 member of an attribute dimension is the attribute value. The only members of attribute dimensions that have attribute values are level 0 members.

    You can use the higher-level members of attribute dimensions to select and group data. For example, you can use Small, the level 1 member of the Population attribute dimension, to retrieve sales in both the 3000000 and 6000000 population categories.

Understanding Attribute Types

Attribute dimensions have a text, numeric, Boolean, or date type that enables different functions for grouping, selecting, or calculating data. Although assigned at the dimension level, the attribute type applies only to level 0 members of the attribute dimension.

  • The default attribute type is text. Text attributes enable the basic attribute member selection and attribute comparisons in calculations. When you perform such comparisons, Essbase compares characters. For example, the package type Bottle is less than the package type Can because B precedes C in the alphabet. In Sample Basic, Pkg Type is an example of a text attribute dimension.

  • The names of level 0 members of numeric attribute dimensions are numeric values. You can include the names (values) of numeric attribute dimension members in calculations. For example, you can use the number of ounces specified in the Ounces attribute to calculate profit per ounce for each product.

    You can also associate numeric attributes with ranges of base dimension values; for example, to analyze product sales by market population groupings—states with 3,000,000 population or less in one group, states with a population between 3,000,001 and 6 million in another group, and so on. See Setting Up Member Names Representing Ranges of Values.

  • All Boolean attribute dimensions in a database contain only two members. The member names must match the settings for the database; for example, True and False. If there is more than one Boolean attribute dimension, specify a prefix or suffix member name format to ensure unique member names; for example, Caffeinated_True and Caffeinated_False. For a discussion of how to change Boolean names, see Setting Boolean Attribute Member Names.

  • You can use date attributes to specify the date format—month-day-year or day-month-year—and to sequence information accordingly. For a discussion of how to change date formats, see Changing the Member Names in Date Attribute Dimensions. You can use date attributes in calculations. For example, you can compare dates in a calculation that selects product sales from markets established since 10-12-1999.

    Essbase supports date attributes from January 1, 1970 through January 1, 2038.

Comparing Attribute and Standard Dimensions

In general, attribute dimensions and their members are similar to standard dimensions and members. You can provide aliases and member comments for attributes. Attribute dimensions can include hierarchies and you can name generations and levels. You can perform the same spreadsheet operations on attribute dimensions and members as you can on standard dimensions and members; for example, to analyze data from different perspectives, you can retrieve, pivot, and drill down in the spreadsheet.

Table 12 describes major differences between attribute and standard dimensions and their members.

Table 12. Differences Between Attribute and Standard Dimensions  

Attribute Dimensions

Standard Dimensions

Storage

Sparse. Their base dimensions must also be sparse.

Can be dense or sparse

Storage property

Dynamic Calc only, therefore not stored in the database. The outline does not display this property.

Can be Store Data, Dynamic Calc and Store, Dynamic Calc, Never Share, or Label Only

Position in outline

Must be the last dimensions in the outline

Must be ahead of all attribute dimensions in the outline

Partitions

Cannot be defined along attribute dimensions, but you can use attributes to define a partition on a base dimension.

Can be defined along standard dimensions.

Formulas (on members)

Cannot be associated

Can be associated

Shared members

Not allowed

Allowed

Two-pass calculation member property

Not available

Available

Two-pass calculation with run-time formula

If a member formula contains a run-time dependent function associated with an attribute member name, and the member with the formula is tagged as two-pass, calculation skips the member and issues a warning message. Run-time dependent functions include the following: @CURRMBR, @PARENT, @PARENTVAL, @SPARENTVAL, @MDPARENTVAL, @ANCEST, @ANCESTVAL, @SANCESTVAL, and @MDANCESTVAL.

Calculation is performed on standard members with run-time formulas and tagged two-pass.

Two-pass, multiple dimensions: Calculation order

Order of calculation of members tagged two-pass depends on order in outline. The last dimension is calculated last.

Calculation result is not dependent on outline order for members tagged two-pass in more than one dimension.

Two-pass calculation with no member formula

Calculation skipped, warning message issued. Thus member intersection of two-pass tagged members and upper level members may return different results from calculation on standard dimensions.

Available

Dense Dynamic Calc members in non-existing stored blocks

Calculations skip dense dimensions if they are on non-existing stored blocks. To identify non-existing stored blocks, export the database or run query to find out whether block has any data.

Available

UDAs on members

Not allowed

Allowed

Consolidations

For all members, calculated through the Attribute Calculations dimension members: Sum, Count, Min, Max, and Avg. Consolidation operators in the outline are ignored during attribute calculations.

Consolidation operation indicated by assigning the desired consolidation symbol to each member

Member selection facilitated by Level 0 member typing

Available types include text, numeric, Boolean, and date.

All members treated as text.

Associations

Must be associated with a base dimension

N/A

Spreadsheet drill-downs

List the base dimension data associated with the selected attribute. For example, drilling down on the attribute Glass displays sales for each product packaged in glass, where Product is the base dimension for the Pkg Type attribute dimension.

List lower or sibling levels of detail in the standard dimensions. For example, drilling down on QTR1 displays a list of products and their sales for that quarter.

Comparing Attributes and UDAs

Attributes and UDAs both enable analysis based on characteristics of the data. Attributes provide much more capability than UDAs. Table 13 compares them. Checkmarks indicate the feature supports the corresponding capability.

Table 13. Comparing Attributes and UDAs  

Capability

Attributes Feature

UDAs Feature

Data Storage

You can associate with sparse dimensions.

You can associate with dense dimensions.

 

Data Retrieval

You can group and retrieve consolidated totals by attribute or UDA value. For example, associate the value High Focus Item to various members of the Product dimension and use that term to retrieve totals and details for just those members.

Simple

More difficult to implement, requiring additional calculation scripts or commands

You can categorize attributes in a hierarchy and retrieve consolidated totals by higher levels in the attribute hierarchy; for example, if each product has a specific size attribute such as 8, 12, 16, or 32, and the sizes are categorized as small, medium, and large. You can view the total sales of small products.

More difficult to implement

You can create crosstab views displaying aggregate totals of attributes associated with the same base dimension.

You can show a crosstab of all values of each attribute dimension.

You can only retrieve totals based on specific UDA values.

You can use Boolean operators AND, OR, and NOT with attribute and UDA values to further refine a query. For example, you can select decaffeinated drinks from the 100 product group.

Because attributes have a text, Boolean, date, or numeric type, you can use appropriate operators and functions to work with and display attribute data. For example, you can view sales totals of all products introduced after a specific date.

 

You can group numeric attributes into ranges of values and let the dimension building process automatically associate the base member with the appropriate range. For example, you can group sales in various regions based on ranges of their populations—less than 3 million, between 3 and 6 million, and so on.

 

Through the Attribute Calculations dimension, you can view aggregations of attribute values as sums, counts, minimums, maximums, and averages.

 

You can use an attribute in a calculation that defines a member. For example, you can use the weight of a product in ounces to define the profit per ounce member of the Measures dimension.

 

You can retrieve specific base members using attribute-related information.

Powerful conditional and value-based selections

Limited to text string matches only

Data Conversion

Based on the value of a UDA, you can change the sign of the data as it is loaded into the database. For example, you can reverse the sign of all members with the UDA Debit.

 

Calculation Scripts

You can perform calculations on a member if its attribute or UDA value matches a specific value. For example, you can increase the price by 10% of all products with the attribute or UDA of Bottle.

You can perform calculations on base members whose attribute value satisfies conditions that you specify. For example, you can calculate the Profit per Ounce of each base member.

 

Designing Attribute Dimensions

Essbase provides more than one way to design attribute information into a database. Most often, defining characteristics of the data through attribute dimensions and their members is the best approach. The following sections discuss when to use attribute dimensions, when to use other features, and how to optimize performance when using attributes.

Using Attribute Dimensions

For the most flexibility and functionality, use attribute dimensions to define attribute data. Using attribute dimensions provides the following features:

  • Sophisticated, flexible data retrieval

    You can view attribute data only when you want to, you can create meaningful summaries through crosstabs, and using type-based comparisons, you can selectively view just the data you want to see.

  • Additional calculation functionality

    Not only can you perform calculations on the names of members of attribute dimensions to define members of standard dimensions, you can also access five different types of consolidations of attribute data—sums, counts, averages, minimums, and maximums.

  • Economy and simplicity

    Because attribute dimensions are sparse, Dynamic Calc, they are not stored as data. Compared to using shared members, outlines using attribute dimensions contain fewer members and are easier to read.

For more information about attribute features, see Understanding Attributes.

Using Alternative Design Approaches

In some situations, consider one of the following approaches:

  • UDAs. Although UDAs provide less flexibility than attributes, you can use them to group and retrieve data based on its characteristics. See Comparing Attributes and UDAs.

  • Shared members. For example, to include a seasonal analysis in the Year dimension, repeat the months as shared members under the appropriate season; Winter: Jan (shared member), Feb (shared member), and so on. A major disadvantage of using shared members is that the outline becomes very large if the categories repeat a lot of members.

  • Standard dimensions and members. Additional standard dimensions provide flexibility, but they add storage requirements and complexity to a database. For guidelines on evaluating the impact of additional dimensions, see Analyzing and Planning.

Table 14 describes situations where you might consider one of these alternative approaches for managing attribute data in a database.

Table 14. Considering Alternatives to Attribute Dimensions  

Situation

Alternative to Consider

Analyze attributes of dense dimensions

UDAs or shared members.

Perform batch calculation of data

Shared members or members of separate, standard dimensions.

Define the name of a member of an attribute dimension as a value that results from a formula

Shared members or members of separate, standard dimensions

Define attributes that vary over time

Members of separate, standard dimensions. For example, to track product maintenance costs over a period of time, the age of the product at the time of maintenance is important. However, using the attribute feature you could associate only one age with the product. You need multiple members in a separate dimension for each time period that you want to track.

Minimize retrieval time with large numbers of base-dimension members

Batch calculation with shared members or members of separate, standard dimensions.

Optimizing Outline Performance

Outline layout and content can affect attribute calculation and query performance. For general outline design guidelines, see Designing an Outline to Optimize Performance.

To optimize attribute query performance, consider the following design tips:

  • Ensure that attribute dimensions are the only sparse Dynamic Calc dimensions in the outline.

  • Locate sparse dimensions after dense dimensions in the outline. Place the most-queried dimensions at the beginning of the sparse dimensions and attribute dimensions at the end of the outline. In most situations, the base dimensions are the most queried dimensions.

For information on optimizing calculation of outlines containing attributes, see Optimizing Calculation and Retrieval Performance.

Building Attribute Dimensions

To build an attribute dimension, first tag the dimension as attribute and assign the dimension a type. Then associate the attribute dimension with a base dimension. Finally, associate each level 0 member of the attribute dimension with a member of the associated base dimension.

*  To build an attribute dimension, see “Defining Attributes” in the Essbase Administration Services Online Help.

    *  To view the dimension, attribute value and attribute type of a specific attribute member, use a tool:

    Tool

    Topic

    Location

    Administration Services

    Viewing Attribute Information in Outlines

    Essbase Administration Services Online Help

    MaxL

    query database

    Essbase Technical Reference

    ESSCMD

    GETATTRINFO

    Essbase Technical Reference

      Setting Member Names in Attribute Dimensions

      When you use the attribute feature, Essbase establishes some default member names; for example, the system-defined True and False would preclude other member names of True and False. You can change these system-defined names for the database. Date attributes and numeric attributes can also be duplicated. To avoid duplicate name confusion, you can establish settings for qualifying member names in attribute dimensions The outline does not show the fully qualified attribute names, but you can see the full attribute names anywhere you select specific members, such as when you define partitions or select information to be retrieved.

      Define the member name settings before you define or build the attribute dimensions. Changing the settings after the attribute dimensions and members are defined could result in invalid member names.

      The following sections describe how to work with the names of members of attribute dimensions:

      Setting Prefix and Suffix Formats for Member Names of Attribute Dimensions

      The information in this section does not apply to duplicate member attribute dimensions.

      The names of members of Boolean, date, and numeric attribute dimensions are values. It is possible to encounter duplicate attribute values in different attribute dimensions.

      • Boolean example

        If you have more than one Boolean attribute dimension in an outline, the two members of each of those dimensions have the same names, by default, True and False.

      • Date example

        If you have more than one date attribute dimension, some member names in both dimensions could be the same. For example, the date that a store opens in a certain market could be the same as the date a product was introduced.

      • Numeric example

        12 can be the attribute value for the size of a product and 12 could also be the value for the number of packing units for a product. This example results in two members with the same name—12.

      You can define unique names by attaching a prefix or suffix to member names in Boolean, date, and numeric attribute dimensions in the outline. As the prefix or suffix you can choose to affix the dimension, parent, grandparent, or all ancestors to the attribute name. For example, by setting member names of attribute dimensions to include the dimension name as the suffix, attached by an underscore, the member value 12 in the Ounces attribute dimension assumes the unique, full attribute member name, 12_Ounces.

      By default, Essbase assumes that no prefix or suffix is attached to the names of members of attribute dimensions.

      The convention that you select applies to the level 0 member names of all numeric, Boolean, and date attribute dimensions in the outline. You can define aliases for these names if you wish to display shorter names in retrievals.

      *  To define prefix and suffix formats, see “Defining a Prefix or Suffix Format for Members of Attribute Dimensions” in the Essbase Administration Services Online Help.

        Setting Boolean Attribute Member Names

        When you set the dimension type of an attribute dimension as Boolean, Essbase automatically creates two level 0 members with the names specified for the Boolean attribute settings. The initial Boolean member names in a database are set as True and False. To change these default names, for example, to Yes and No, define the member names for Boolean attribute dimensions before you create Boolean attribute dimensions in the database.

        Before you can set an attribute dimension type as Boolean, you must delete all existing members in the dimension.

        *  To define the database setting for the names of members of Boolean attribute dimensions, see “Setting Member Names for Boolean Attribute Dimensions” in the Essbase Administration Services Online Help.

          Changing the Member Names in Date Attribute Dimensions

          You can change the format of members of date attribute dimensions. For example, you can use the following date formats:

          • mm-dd-yyyy displays the month before the day; for example, October 18, 2004 is displayed as 10-18-2004.

          • dd-mm-yyyy displays the day before the month; for example, October 18, 1999 is displayed as 18-10-2004.

          If you change the date member name format, the names of existing members of date attribute dimensions may be invalid. For example, if the 10-18-2004 member exists and you change the format to dd-mm-2004, outline verification will find this member invalid. If you change the date format, you must rebuild the date attribute dimensions.

          *  To change member names in date attribute dimensions, see “Setting the Member Name Format of Date Attribute Dimensions” in the Essbase Administration Services Online Help.

            Setting Up Member Names Representing Ranges of Values

            Members of numeric attribute dimensions can represent single numeric values or ranges of values:

            • Single value example: the member 12 in the Ounces attribute dimension represents the single numeric value 12; you associate this attribute with all 12-ounce products. The outline includes a separate member for each size; for example, 16, 20, and 32.

            • Range of values example: the Population attribute dimension, as shown:

              Figure 39. Population Attribute Dimension and Members

              Population Attribute Dimension and Members

              In this outline, the members of the Population attribute dimension represent ranges of population values in the associated Market dimension. The 3000000 member represents populations from zero through 3,000,000; the 6000000 member represents populations from 3,000,001 through 6,000,000; and so on. Each range includes values greater than the name of the preceding member up to and including the member value itself. A setting for the outline establishes that each numeric member represents the top of its range.

              You can also define this outline setting so that members of numeric attribute dimensions are the bottoms of the ranges that they represent. For example, if numeric members are set to define the bottoms of the ranges, the 3000000 member represents populations from 3,000,000 through 5,999,999 and the 6000000 member represents populations from 6,000,000 through 8,999,999.

            When you build the base dimension, Essbase automatically associates members of the base dimension with the appropriate attribute range. For example, if numeric members represent the tops of ranges, Essbase automatically associates the Connecticut market, with a population of 3,269,858, with the 6000000 member of the Population attribute dimension.

            In the dimension build rules file, specify the size of the range for each member of the numeric attribute dimension. In the above example, each attribute represents a range of 3,000,000.

            *  To define ranges in numeric attribute dimensions, see “Assigning Member Names to Ranges of Values” in the Essbase Administration Services Online Help.

              Note:

              Numeric attribute dimension member names are recommended to contain no more than six decimal positions. Otherwise, because of precision adjustments, an outline may not pass verification.

              Changing the Member Names of the Attribute Calculations Dimension

              To avoid duplicating names in an outline, you may need to change the name of the Attribute Calculations dimension or its members. See Understanding the Attribute Calculations Dimension.

              Regardless of the name that you use for a member, its function remains the same. For example, the second (Count) member always counts, no matter what you name it.

              *  To change member names in the Attribute Calculations dimension, see “Changing Member Names of Attribute Calculations Dimensions” in the Essbase Administration Services Online Help.

                Calculating Attribute Data

                Essbase calculates attribute data dynamically at retrieval time, using members from a system-defined dimension created specifically by Essbase. Using this dimension, you can apply different calculation functions, such as a sum or an average, to the same attribute. You can also perform specific calculations on members of attribute dimensions; for example, to determine profitability by ounce for products sized by the ounce.

                The following information assumes that you understand the concepts of attribute dimensions and Essbase calculations, including dynamic calculations. See these topics:

                Understanding the Attribute Calculations Dimension

                When you create the first attribute dimension in the outline, Essbase also creates the Attribute Calculations dimension comprising five members with the default names Sum, Count, Min (minimum), Max (maximum), and Avg (average). You can use these members in spreadsheets or in reports to dynamically calculate and report on attribute data, such as the average yearly sales of 12-ounce bottles of cola in the West.

                The Attribute Calculations dimension is not visible in the outline. You can see it wherever you select dimension members, such as in the Essbase Spreadsheet Add-in for Excel.

                The attribute calculation dimension has the following properties:

                • System-defined. When you create the first attribute dimension in an application, Essbase creates the Attribute Calculations dimension and its members (Sum, Count, Min, Max, and Avg). Each member represents a type of calculation to be performed for attributes. For a discussion of calculation types, see Understanding the Default Attribute Calculations Members.

                • Label only. Like all label only dimensions, the Attribute Calculations dimension shares the value of its first child, Sum. For more information on the label only dimension property, see Member Storage Properties.

                • Dynamic Calc. The data in the Attribute Calculations dimension is calculated when a user requests it and is then discarded. You cannot store calculated attribute data in a database. See Dynamically Calculating Data Values.

                • Not displayed in Outline Editor. The Attribute Calculations dimension is not displayed in Outline Editor. Members from this dimension can be viewed in spreadsheets and in reports.

                There is no consolidation along attribute dimensions. You cannot tag members from attribute dimensions with consolidation symbols (for example, + or -) or with member formulas in order to calculate attribute data. As Dynamic Calc members, attribute calculations do not affect the batch calculation in terms of time or calculation order. To calculate attribute data at retrieval time, Essbase performs the following tasks:

                1. Finds the base-dimension members that are associated with the specified attribute-dimension members present in the current query

                2. Dynamically calculates the sum, count, minimum, maximum, or average for the attribute-member combination for the current query

                3. Displays the results in the spreadsheet or report

                4. Discards the calculated values—that is, the values are not stored in the database

                  Note:

                  Essbase excludes #MISSING values when calculating attribute data.

                For example, as shown in Figure 40, Retrieving an Attribute Calculations Member, a spreadsheet user specifies two members of attribute dimensions (Ounces_16 and Bottle) and an Attribute Calculations member (Avg) in a spreadsheet report. Upon retrieval, Essbase dynamically calculates the average sales values of all products associated with these attributes for the current member combination (Actual -> Sales -> East -> Qtr1):

                Figure 40.  Retrieving an Attribute Calculations Member

                Retrieving an Attribute Calculations Member

                For information on accessing calculated attribute data, see Accessing Attribute Calculations Members Using the Spreadsheet.

                Understanding the Default Attribute Calculations Members

                The Attribute Calculations dimension contains five members used to calculate and report attribute data. These members are as follows:

                • Sum calculates a sum, or total, of the values for a member with an attribute or combination of attributes.

                • Count calculates the number of members with the specified attribute or combination of attributes, for which a data value exists. Count includes only those members that have data blocks in existence. To calculate a count of all members with certain attributes, regardless of whether or not they have data values, use the @COUNT function in combination with the @ATTRIBUTE function. For more information, see the Essbase Technical Reference.

                • Avg calculates a mathematical mean, or average, of the non-missing values for an specified attribute or combination of attributes (Sum divided by Count).

                • Min calculates the minimum data value for a specified attribute or combination of attributes.

                • Max calculates the maximum data value for a specified attribute or combination of attributes.

                  Note:

                  Each of these calculations excludes #MISSING values.

                You can change these default member names, subject to the same naming conventions as standard members. For a discussion of Attribute Calculations member names, see Changing the Member Names of the Attribute Calculations Dimension.

                Viewing an Attribute Calculation Example

                As an example of how Essbase calculates attribute data, consider the following yearly sales data for the East:

                Table 15. Sample Attribute Data

                Base-Dimension Member

                Associated Attributes

                Sales Value for Attribute-Member Combination

                Cola

                Ounces_12, Can

                23205

                Diet Cola

                Ounces_12, Can

                3068

                Diet Cream

                Ounces_12, Can

                1074

                Grape

                Ounces_32, Bottle

                6398

                Orange

                Ounces_32, Bottle

                3183

                Strawberry

                Ounces_32, Bottle

                5664

                A spreadsheet report showing calculated attribute data might look like the following illustration:

                Figure 41. Sample Spreadsheet with Attribute Data

                Sample Spreadsheet with Attribute Data

                As shown in the figure above, you can retrieve multiple Attribute Calculations members for attributes. For example, you can calculate Sum, Count, Avg, Min, and Max for 32-ounce bottles and cans.

                Accessing Attribute Calculations Members Using the Spreadsheet

                You can access members from the Attribute Calculations dimension in Essbase Spreadsheet Add-in for Excel. From the spreadsheet, users can view Attribute Calculations dimension members using any of the following methods:

                • Entering members directly into a sheet

                • Selecting members from the Query Designer

                • Entering members as an EssCell parameter

                For more information on accessing calculated attribute data from the spreadsheet, see the Essbase Spreadsheet Add-in for Excel User's Guide.

                Optimizing Calculation and Retrieval Performance

                To optimize attribute calculation and retrieval performance, consider the following considerations:

                • The calculation order for attribute calculations is the same as the order for dynamic calculations. For an outline of calculation order, see Calculation Order for Dynamic Calculation.

                • Since Essbase calculates attribute data dynamically at retrieval time, attribute calculations do not affect the performance of the overall (batch) database calculation.

                • Tagging base-dimension members as Dynamic Calc may increase retrieval time.

                • When a query includes the Sum member and an attribute-dimension member whose associated base-member is tagged as two-pass, retrieval time may be slow.

                • To maximize attribute retrieval performance, use any of the following techniques:

                  • Configure the outline using the tips in Optimizing Outline Performance.

                  • Drill down to the lowest level of base dimensions before retrieving data. For example, in Essbase Spreadsheet Add-in for Excel, turn on the Navigate Without Data feature, drill down to the lowest level of the base dimensions included in the report, and then retrieve data.

                  • When the members of a base dimension are associated with several attribute dimensions, consider grouping the members of the base dimension according to their attributes. For example, in the Sample Basic database, you could group all 8-ounce products. Grouping members by attribute may decrease retrieval time.

                Using Attributes in Calculation Formulas

                In addition to using the Attribute Calculations dimension to calculate attribute data, you can also use calculation formulas on members of standard or base dimensions to perform specific calculations on members of attribute dimensions; for example, to determine profitability by ounce for products sized by the ounce.

                You cannot associate formulas with members of attribute dimensions.

                Note:

                Some restrictions apply when using attributes in formulas associated with two-pass members. See the rows about two-pass calculations in Table 12, Differences Between Attribute and Standard Dimensions   .

                You can use the following functions to perform specific calculations on attributes:

                Type of Calculation

                Function to Use

                Generate a list of all base members with a specific attribute. For example, you can generate a list of members that have the Bottle attribute, and then increase the price for those members.

                @ATTRIBUTE

                Return the value of the level 0 attribute member that is associated with the base member being calculated.

                • From a numeric or date attribute dimension (using @ATTRIBUTEVAL)

                • From a Boolean attribute dimension (using @ATTRIBUTEBVAL)

                • From a text attribute dimension (using @ATTRIBUTESVAL)

                For example, you can return the numeric value of a size attribute (for example, 12 for the member 12 under Ounces) for the base member being calculated (for example, Cola).

                @ATTRIBUTEVAL

                @ATTRIBUTEBVAL

                @ATTRIBUTESVAL

                Convert a date string to numbers for a calculation. For example, you can use @TODATE in combination with the @ATTRIBUTEVAL function to increase overhead costs for stores opened after a certain date.

                @TODATE

                Generate a list of all base dimension members associated with attributes that satisfy the conditions that you specify. For example, you can generate a list of products that are greater than or equal to 20 ounces, and then increase the price for those products.

                @WITHATTR

                Note:

                For syntax information and examples for these functions, see the Essbase Technical Reference. For an additional example using @ATTRIBUTEVAL in a formula, see Calculating an Attribute Formula.

                Understanding Attribute Calculation and Shared Members

                Attribute calculations start at level 0 and stop at the first stored member. Therefore, if your outline has placed a stored member in between two shared members in a an outline hierarchy, the calculation results may not include the higher shared member.

                For example:

                Member 1 (stored)
                     Member A (stored)
                          Member 2 (shared)
                Member B (stored)
                     Member 1 (shared member whose stored member is Member 1 above)
                

                In this example, when an attribute calculation is performed, the calculation starts with level 0 Member 2, and stops when it encounters the first stored member, Member A. Therefore, Member 1 would not be included in the calculation.

                Avoid mixing shared and stored members to avoid unexpected results with attribute calculation. For this example, if Member 2 were not shared, or Member 1 did not have a corresponding shared member elsewhere in the outline, calculation results would be as expected.