[ms-xlsx]: Excel (. xlsx) Extensions to the Office Open xml spreadsheetml file Format

measuresSet: A Boolean ([XMLSCHEMA2] section 3.2.2) attribute that specifies whether this PivotTable ([ISO/IEC29500-1:2011] section 18.10) named set contains one or more PivotTable ([ISO/IEC29500-1:2011] section 18.10) measure cache hierarchies. MUST be "false" if ignore is "true".

ignore	measureSet	Meaning
"true"	"false"	The ancestor cacheHierarchy element of type CT_CacheHierarchy ([ISO/IEC29500-4:2011] section A.2) of this PivotTable ([ISO/IEC29500-1:2011] section 18.10) named set is discarded.
"false"	"false"	The PivotTable ([ISO/IEC29500-1:2011] section 18.10) named set does not contain PivotTable ([ISO/IEC29500-1:2011] section 18.10) measure cache hierarchies.
"false"	"true"	The PivotTable ([ISO/IEC29500-1:2011] section 18.10) named set contains PivotTable ([ISO/IEC29500-1:2011] section 18.10) measure cache hierarchies.

hierarchizeDistinct: A Boolean ([XMLSCHEMA2] section 3.2.2) attribute that specifies whether to automatically order and remove duplicates from this PivotTable ([ISO/IEC29500-1:2011] section 18.10) named set. MUST be "false" if ignore is "true". If a CT_CalculatedMember element that corresponds to the PivotTable ([ISO/IEC29500-1:2011] section 18.10) named set exists, this attribute MUST be equal to hierarchizeDistinct attribute of the CT_CalculatedMember element.

ignore	hierarchizeDistinct	Meaning
"true"	"false"	The ancestor cacheHierarchy element of type CT_CacheHierarchy ([ISO/IEC29500-4:2011] section A.2) of this PivotTable ([ISO/IEC29500-1:2011] section 18.10) named set is discarded.
"false"	"false"	Do not automatically order and remove duplicates from this PivotTable ([ISO/IEC29500-1:2011] section 18.10) named set.
"false"	"true"	Automatically order and remove duplicates from this PivotTable ([ISO/IEC29500-1:2011] section 18.10) named set.

ignore: A Boolean ([XMLSCHEMA2] section 3.2.2) attribute that specifies whether the ancestor cacheHierarchy element of type CT_CacheHierarchy ([ISO/IEC29500-4:2011] section A.2) SHOULD<9> be discarded. If ignore is "true", the ancestor cacheHierarchy element of type CT_CacheHierarchy ([ISO/IEC29500-4:2011] section A.2) MUST have the following attribute values:

Field	Value
measure	"true"
set	"false"
attribute	"false"
measures	"false"
oneField	"false"
time	"false"
keyAttribute	"false"
memberValueDatatype	MUST NOT be specified.
unbalanced	MUST NOT be specified.
unbalancedGroup	MUST NOT be specified.
hidden	"false"
count	"0"
parentSet	MUST NOT be specified.
dimensionUniqueName	MUST NOT be specified.
defaultMemberUniqueName	MUST NOT be specified.
allUniqueName	MUST NOT be specified.
allCaption	MUST NOT be specified.
displayFolder	MUST NOT be specified.
measureGroup	MUST NOT be specified.
uniqueName	"DummyN", where N is the text string representing in decimal form the zero-based index of the ancestor CT_CacheHierarchy ([ISO/IEC29500-4:2011] section A.2) element within the group of CT_CacheHierarchy ([ISO/IEC29500-4:2011] section A.2) elements that have a descendent CT_CacheHierarchy element with the ignore attribute equal to "true".

Within the CT_CacheHierarchies ([ISO/IEC29500-4:2011] section A.2) element, all CT_CacheHierarchy ([ISO/IEC29500-4:2011] section A.2) elements that have a descendant CT_CacheHierarchy element with the ignore attribute equal to "true" MUST follow all other CT_CacheHierarchy ([ISO/IEC29500-4:2011] section A.2) elements without a descendent CT_CacheHierarchy element or with a descendent CT_CacheHierarchy element with the ignore attribute equal to "false".

If this attribute is "true", there MUST exist a CT_DataField ([ISO/IEC29500-4:2011] section A.2) element with an fld attribute equal to the zero-based index of a CT_CacheField ([ISO/IEC29500-4:2011] section A.2) element in the list of CT_CacheField ([ISO/IEC29500-4:2011] section A.2) elements specified by CT_CacheFields ([ISO/IEC29500-4:2011] section A.2) with a hierarchy attribute that specifies the ancestor CT_CacheHierarchy ([ISO/IEC29500-4:2011] section A.2). Additionally, that CT_DataField ([ISO/IEC29500-4:2011] section A.2) element MUST have a descendant CT_DataField element with a sourceField attribute specified.

For more details, see CT_DataField.

The following W3C XML Schema ([XMLSCHEMA1] section 2.1) fragment specifies the contents of this complex type.

See section 5.4 for the full W3C XML Schema ([XMLSCHEMA1] section 2.1).

2.6.25 CT_DataField

Target namespace: http://schemas.microsoft.com/office/spreadsheetml/2009/9/main

Referenced by: dataField

This complex type specifies extended information about a PivotTable ([ISO/IEC29500-1:2011] section 18.10) data field (1) item ([ISO/IEC29500-1:2011] section 18.10.1.22).

Attributes:

pivotShowAs: An ST_PivotShowAs attribute that specifies the data display format for this PivotTable ([ISO/IEC29500-1:2011] section 18.10) data field (1) item. If this attribute is specified, the showDataAs attribute of the ancestor CT_DataField ([ISO/IEC29500-4:2011] section A.2) element MUST NOT be specified. If this attribute is equal to "percentOfParent", "percentOfRunningTotal", "rankAscending", or "rankDescending", the baseField attribute of the ancestor CT_DataField ([ISO/IEC29500-4:2011] section A.2) element MUST be greater than or equal to 0.

sourceField: An unsignedInt ([XMLSCHEMA2] section 3.3.22) attribute that specifies the zero-based index of the CT_PivotField ([ISO/IEC29500-4:2011] section A.2) element in the list of CT_PivotField ([ISO/IEC29500-4:2011] section A.2) elements specified by the CT_PivotFields ([ISO/IEC29500-4:2011] section A.2) element that this data item summarizes.

If an OLAP measure is summarized in a PivotTable ([ISO/IEC29500-1:2011] section 18.10) as a data field (1) item ([ISO/IEC29500-1:2011] section 18.10.1.22) more than one time, data field (1) items ([ISO/IEC29500-1:2011] section 18.10.1.22) that specify that OLAP measure after the first data field (1) item ([ISO/IEC29500-1:2011] section 18.10.1.22) that specifies that OLAP measure MUST have a descendant CT_DataField element with a sourceField specified.

If this attribute is specified, the CT_PivotField ([ISO/IEC29500-4:2011] section A.2) element specified by the fld attribute of the ancestor CT_DataField ([ISO/IEC29500-4:2011] section A.2) element MUST have a descendant CT_PivotField element with an ignore attribute equal to "true".

If this attribute is specified, the CT_CacheField ([ISO/IEC29500-4:2011] section A.2) element with a zero-based index in the list of CT_CacheField ([ISO/IEC29500-4:2011] section A.2) elements specified by the CT_CacheFields ([ISO/IEC29500-4:2011] section A.2) element equal to the fld attribute of the ancestor CT_DataField ([ISO/IEC29500-4:2011] section A.2) element that exists in the Pivot Table Cache Definition part ([ISO/IEC29500-1:2011] section 12.3.12) specified by the cacheId attribute of the CT_PivotTableDefinition ([ISO/IEC29500-4:2011] section A.2) element that is the ancestor of this element MUST have a descendant CT_CacheField element. The CT_CacheHierarchy ([ISO/IEC29500-4:2011] section A.2) element specified by the hierarchy attribute of that CT_CacheField ([ISO/IEC29500-4:2011] section A.2) element MUST have a descendent CT_CacheHierarchy element with an ignore attribute equal to "true". The CT_PivotHierarchy ([ISO/IEC29500-4:2011] section A.2) element with a zero-based index in the list of CT_PivotHierarchy ([ISO/IEC29500-4:2011] section A.2) elements specified by the CT_PivotHierarchies ([ISO/IEC29500-4:2011] section A.2) element in this part that is equal to the zero-based index of that CT_CacheHierarchy ([ISO/IEC29500-4:2011] section A.2) element in the list of CT_CacheHierarchy ([ISO/IEC29500-4:2011] section A.2) elements specified by the CT_CacheHierarchies ([ISO/IEC29500-4:2011] section A.2) element MUST have a descendant CT_PivotHierarchy element.

If this attribute is specified, the fld attribute of the ancestor CT_DataField ([ISO/IEC29500-4:2011] section A.2) element SHOULD<10> be ignored.

This attribute MUST NOT be specified for non-OLAP PivotTables ([ISO/IEC29500-1:2011] section 18.10).