2.4.135 BrtBeginPCDFGroup

The BrtBeginPCDFGroup record specifies the relation of this cache field (section 2.2.5.2.2) and other cache fields with respect to grouping (section 2.2.5.2.4). This record specifies the beginning of a collection of records as defined by the PivotCache Definition (section 2.1.7.38) part ABNF. If this cache field is a parent of another grouping cache field as specified in grouping, then the collection of records MUST NOT be empty.

If this collection includes a BrtBeginPCDFGRange (section 2.4.134) or BrtBeginPCDFGDiscrete (section 2.4.132) record, a collection beginning with a BrtBeginPCDFGItems (section 2.4.133) record MUST immediately follow, and it MUST contain at least one item.


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

ifdbParent

ifdbBase

ifdbParent (4 bytes):  A signed integer that specifies the cache field that is the grouping parent for the cache field containing this record. Each cache item (section 2.2.5.2.3) in the grouping parent cache field corresponds to a group of cache items in the cache field containing this record. This value MUST be a value from the following table.

Value

Meaning

-1

The cache field containing this record has no grouping parent cache field.

0+

Specifies a cache field index. The referenced instance of the sequence of records that conforms to the PCDFIELD rule (defined in section 2.1.7) specifies the grouping parent cache field for the cache field containing this record. The value of ifdbParent MUST be less than the count of elements in the BrtBeginPCDFields (section 2.4.137) collection that contains the referenced instance of the PCDFIELD rule.

If this collection contains a BrtBeginPCDFGRange record, the BrtBeginPCDField (section 2.4.136) record in the instance of the PCDFIELD rule specified by this value MUST be followed by a BrtBeginPCDFGroup record, and the collection beginning with that BrtBeginPCDFGroup record MUST contain a BrtBeginPCDFGRange record; the value in the ifdbBase field of that BrtBeginPCDFGroup record MUST be equal to ifdbBase. If the iByType field of the BrtBeginPCDFGRange record is 0, ifdbParent MUST be -1.

If this collection contains a BrtBeginPCDFGDiscrete record, the BrtBeginPCDField record in the instance of the PCDFIELD rule specified by this value MUST be followed by a BrtBeginPCDFGroup record, and the collection beginning with that BrtBeginPCDFGroup record MUST contain a BrtBeginPCDFGDiscrete record; the value in the ifdbBase field of that BrtBeginPCDFGroup record MUST be equal to ifdbBase.

If this cache field has fSrcField field in the BrtBeginPCDField record equal to 1 and the BrtBeginPCDField record in the instance of the PCDFIELD rule specified by this value is followed by BrtBeginPCDFGDiscrete record, the value in the ifdbBase field of the BrtBeginPCDFGroup record preceding that BrtBeginPCDFGDiscrete record MUST be equal to this cache field index, as specified by Cache Fields.

ifdbBase (4 bytes):  A signed integer that specifies the cache field that is the grouping base for the cache field containing this record. Each cache item in the PCDFGITEMS (defined in section 2.1.7.38) collection of this record corresponds to a group of cache items in the PCDFATBL (defined in section 2.1.7.38) collection of the grouping base cache field. This value MUST be a value from the following table.

Value

Meaning

-1

The cache field containing this record has no grouping base cache field.

0+

Specifies a cache field index. The referenced instance of the PCDFIELD rule specifies the grouping base cache field for the cache field containing this record. The value of ifdbBase MUST be less than the count of elements in the BrtBeginPCDFields collection that contains the referenced instance of the PCDFIELD rule. The fSrcField field in the BrtBeginPCDField record of the referenced instance of the PCDFIELD rule MUST be equal to 1.