[Table of Contents] [docx version]

SpreadsheetML Reference Material - Table of Contents

pivotCacheDefinition (PivotCache Definition)

Represents the pivotCacheDefinition part. This part defines each field in the source data, including the name, the string resources of the instance data (for shared items), and information about the type of data that appears in the field.

[Example:

<pivotCacheDefinition xmlns="…" xmlns:r="…" r:id="rId1" refreshedBy="AnonUser"
refreshedDate="2006-05-22T10:07:16" createdVersion="3" refreshedVersion="3"
minRefreshableVersion="3" recordCount="182">

<cacheSource type="worksheet">
<worksheetSource name="Table1"/>
</cacheSource>

<cacheFields count="28">
<cacheField name="Customer Name" numFmtId="0">
<cacheField name="Postal Code" numFmtId="0">
<sharedItems/>
</cacheField>

<cacheField name="Product Category" numFmtId="0">
<sharedItems count="1">
<s v="Bikes"/>
</sharedItems>
</cacheField>

<cacheField name="Year" numFmtId="0">
<sharedItems count="1">
<s v="2001"/>
</sharedItems>
</cacheField>

<cacheField name="Quarter" numFmtId="0">
<sharedItems containsSemiMixedTypes="0" containsString="0"
containsNumber="1" containsInteger="1" minValue="3" maxValue="3"
count="1">
<n v="3"/>
</sharedItems>
</cacheField>
</cacheFields>
</pivotCacheDefinition>

end example]

Parent Elements

Root element of SpreadsheetML Pivot Table Cache Definition part

 

Child Elements

Subclause

cacheFields (PivotCache Fields)

§3.10.1.4

cacheHierarchies (PivotCache Hierarchies)

§3.10.1.5

cacheSource (PivotCache Source Description)

§3.10.1.7

calculatedItems (Calculated Items)

§3.10.1.9

calculatedMembers (Calculated Members)

§3.10.1.11

dimensions (OLAP Dimensions)

§3.10.1.25

extLst (Future Feature Data Storage Area)

§3.2.10

kpis (OLAP KPIs)

§3.10.1.48

maps (OLAP Measure Group)

§3.10.1.52

measureGroups (OLAP Measure Groups)

§3.10.1.54

tupleCache (Tuple Cache)

§3.10.1.94

 

Attributes

Description

backgroundQuery (Background Query)

Specifies a boolean value that indicates whether the application should query and retrieve records asynchronously from the cache.

 

A value of on, 1, or true indicates the application will retrieve records asynchronously from the cache.

 

A value of off, 0, or false indicates the application will retrieve records synchronously.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

createdVersion (PivotCache Created Version)

Specifies the version of the application that created the cache. This attribute is application-dependent.

 

The possible values for this attribute are defined by the XML Schema unsignedByte datatype.

enableRefresh (Enable PivotCache Refresh)

Specifies a boolean value that indicates whether the end-user can refresh the cache. This attribute depends on whether the application exposes a method for allowing end-users control over refreshing the cache via the user interface.

 

A value of on, 1, or true indicates the end-user can refresh the cache.

 

A value of off, 0, or false indicates the end-user cannot refresh the cache.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

id (Relationship Identifier)

 

Namespace: .../officeDocument/2006/relationships

Specifies the unique identifier that corresponds to the related pivotCacheRecords part. See (§3.10.1.68) for more information.

 

The possible values for this attribute are defined by the ST_RelationshipId simple type (§7.8.2.1).

invalid (Invalid Cache)

Specifies a boolean value that indicates whether the cache is invalid and needs to be refreshed.

 

A value of on, 1, or true indicates the cache is invalid and needs to be refreshed.

 

A value of off, 0, or false indicates the cache does not need to be refreshed.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

minRefreshableVersion (Minimum Version Required for Refresh)

Specifies the earliest version of the application that is required to refresh the cache. This attribute is application-dependent.

 

The possible values for this attribute are defined by the XML Schema unsignedByte datatype.

missingItemsLimit (Missing Items Limit)

Specifies the number of unused items to allow before discarding unused items. This attribute is application-dependent. The application must specify a threshold for unused items.

 

The possible values for this attribute are defined by the XML Schema unsignedInt datatype.

optimizeMemory (Optimize Cache for Memory)

Specifies a boolean value that indicates whether the application will apply optimizations to the cache to reduce memory usage. This attribute is application-dependent. This application must define its own cache optimization methods. The application must also decide whether to expose cache optimization status via the user interface or an object model.

 

A value of on, 1, or true indicates the application will apply optimizations to the cache.

 

A value of off, 0, or false indicates the application will not apply optimizations to the cache.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

recordCount (PivotCache Record Count)

Specifies the number of records in the cache.

 

The possible values for this attribute are defined by the XML Schema unsignedInt datatype.

refreshedBy (Last Refreshed By)

Specifies the name of the end-user who last refreshed the cache. This attribute is application-dependent and is specified by applications that track and store the identity of the current user. This attribute also depends on whether the application exposes mechanisms via the user interface whereby the end-user can refresh the cache.

 

The possible values for this attribute are defined by the ST_Xstring simple type (§3.18.96).

refreshedDate (PivotCache Last Refreshed Date)

Specifies the date when the cache was last refreshed. This attribute depends on whether the application exposes mechanisms via the user interface whereby the end-user can refresh the cache.

 

The possible values for this attribute are defined by the XML Schema double datatype.

refreshedVersion (PivotCache Last Refreshed Version)

Specifies the version of the application that last refreshed the cache. This attribute depends on whether the application exposes mechanisms via the user interface whereby the end-user can refresh the cache.

 

The possible values for this attribute are defined by the XML Schema unsignedByte datatype.

refreshOnLoad (Refresh On Load)

Specifies a boolean value that indicates whether the application will refresh the cache when the workbook has been opened.

 

A value of on, 1, or true indicates that application will refresh the cache when the workbook is loaded.

 

A value of off, 0, or false indicates the application will not automatically refresh cached data. The end user must trigger refresh of the cache manually via the application user interface.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

saveData (Save Pivot Records)

Specifies a boolean value that indicates whether the pivot records are saved with the cache.

 

A value of on, 1, or true indicates pivot records are saved in the cache.

 

A value of off, 0, or false indicates are not saved in the cache.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

supportAdvancedDrill (Supports Attribute Drilldown)

Specifies whether the cache's data source supports attribute drilldown.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

supportSubquery (Supports Subqueries)

Specifies whether the cache's data source supports subqueries.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

tupleCache (Stores Cache for OLAP Functions)

Specifies a boolean value that indicates whether the PivotCache is used store information for OLAP sheet data functions.

 

A value of on, 1, or true indicates information about OLAP sheet data functions are stored in the cache.

 

A value of off, 0, or false indicates the PivotCache does not contain information about OLAP sheet data functions.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

upgradeOnRefresh (Upgrade PivotCache on Refresh)

Specifies a boolean value that indicates whether the cache is scheduled for version upgrade. This attribute depends on whether the application exposes mechanisms via the user interface whereby the cache may be upgraded.

 

A value of on, 1, or true indicates the cache is scheduled for upgrade.

 

A value of off, 0, or false indicates the cache is not scheduled for upgrade.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_PivotCacheDefinition">

   <sequence>

   <element name="cacheSource" type="CT_CacheSource" minOccurs="1" maxOccurs="1"/>

   <element name="cacheFields" type="CT_CacheFields" minOccurs="1" maxOccurs="1"/>

   <element name="cacheHierarchies" minOccurs="0" type="CT_CacheHierarchies"/>

   <element name="kpis" minOccurs="0" type="CT_PCDKPIs"/>

   <element name="tupleCache" minOccurs="0" type="CT_TupleCache"/>

   <element name="calculatedItems" minOccurs="0" type="CT_CalculatedItems"/>

   <element name="calculatedMembers" type="CT_CalculatedMembers" minOccurs="0"/>

   <element name="dimensions" type="CT_Dimensions" minOccurs="0"/>

   <element name="measureGroups" type="CT_MeasureGroups" minOccurs="0"/>

   <element name="maps" type="CT_MeasureDimensionMaps" minOccurs="0"/>

   <element name="extLst" minOccurs="0" type="CT_ExtensionList"/>

   </sequence>

   <attribute ref="r:id" use="optional"/>

   <attribute name="invalid" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="saveData" type="xsd:boolean" use="optional" default="true"/>

   <attribute name="refreshOnLoad" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="optimizeMemory" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="enableRefresh" type="xsd:boolean" use="optional" default="true"/>

   <attribute name="refreshedBy" type="ST_Xstring" use="optional"/>

   <attribute name="refreshedDate" type="xsd:double" use="optional"/>

   <attribute name="backgroundQuery" type="xsd:boolean" default="false"/>

   <attribute name="missingItemsLimit" type="xsd:unsignedInt" use="optional"/>

   <attribute name="createdVersion" type="xsd:unsignedByte" use="optional" default="0"/>

   <attribute name="refreshedVersion" type="xsd:unsignedByte" use="optional" default="0"/>

   <attribute name="minRefreshableVersion" type="xsd:unsignedByte" use="optional" default="0"/>

   <attribute name="recordCount" type="xsd:unsignedInt" use="optional"/>

   <attribute name="upgradeOnRefresh" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="tupleCache" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="supportSubquery" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="supportAdvancedDrill" type="xsd:boolean" use="optional" default="false"/>

</complexType>