2.4.143 BrtBeginPCDHGLGroup

The BrtBeginPCDHGLGroup record specifies an OLAP group, as specified in OLAP Grouping (section 2.2.5.2.8), and specifies the beginning of a collection as defined by the PivotCache Definition (section 2.1.7.38) part ABNF. The collection of records specifies the OLAP members that make up the group specified by this record.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

iGrpNum

A

reserved

stName (variable)

...

stUniqueName (variable)

...

stCaption (variable)

...

stParentUniqueName (variable)

...

iGrpNum (4 bytes):  A signed integer that specifies the unique identifier of this group within the level of the OLAP hierarchy. This value MUST be greater than zero.

A - fLoadParent (1 bit):  A bit that specifies whether stParentUniqueName exists after the fixed-size portion of the record.

reserved (7 bits):  This value MUST be 0, and MUST be ignored.

stName (variable): An XLWideString (section 2.5.169) that specifies the name of this group. The length of this string MUST be greater than zero. If the bVerCacheCreated field of the preceding BrtBeginPivotCacheDef (section 2.4.168) record is greater than or equal to 3, then the length of this string MUST be less than 32,768 characters; otherwise it MUST be less than 256 characters.

stUniqueName (variable): An XLWideString that specifies the MDX unique name of the OLAP member in the parent grouping level, as specified in OLAP Grouping, associated with the group specified by this record. The length of this string MUST be greater than zero. If the bVerCacheCreated field of the preceding BrtBeginPivotCacheDef record is greater than or equal to 3, then the length of this string MUST be less than 32,768 characters; otherwise it MUST be less than 256 characters.

stCaption (variable): An XLWideString that specifies the caption of this group. The length of this string MUST be greater than zero. If the bVerCacheCreated field of the preceding BrtBeginPivotCacheDef record is greater than or equal to 3, then the length of this string MUST be less than 32,768 characters, otherwise it MUST be less than 256 characters.

stParentUniqueName (variable):  An optional XLWideString that specifies an MDX unique name of the OLAP member that is the parent of the members of this group in the OLAP cube. If the bVerCacheCreated field of the preceding BrtBeginPivotCacheDef record is greater than or equal to 3, then the length of this string MUST be less than 32,768 characters; otherwise it MUST be less than 256 characters. MUST exist if and only if fLoadParent is 1. If this value is not specified, it means that the members of this group have no parent in the OLAP cube.