Update ooo320-m1
[ooovba.git] / helpcontent2 / source / text / scalc / 01 / 12090105.xhp
blobfbb2ded83f9e2e3b350a692987aab8168e654a1a
1 <?xml version="1.0" encoding="UTF-8"?>
4 <!--***********************************************************************
6 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
7 *
8 * Copyright 2008 by Sun Microsystems, Inc.
10 * OpenOffice.org - a multi-platform office productivity suite
12 * $RCSfile: 12090105.xhp,v $
13 * $Revision: 1.6 $
15 * This file is part of OpenOffice.org.
17 * OpenOffice.org is free software: you can redistribute it and/or modify
18 * it under the terms of the GNU Lesser General Public License version 3
19 * only, as published by the Free Software Foundation.
21 * OpenOffice.org is distributed in the hope that it will be useful,
22 * but WITHOUT ANY WARRANTY; without even the implied warranty of
23 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
24 * GNU Lesser General Public License version 3 for more details
25 * (a copy is included in the LICENSE file that accompanied this code).
27 * You should have received a copy of the GNU Lesser General Public License
28 * version 3 along with OpenOffice.org. If not, see
29 * <http://www.openoffice.org/license.html>
30 * for a copy of the LGPLv3 License.
32 ************************************************************************-->
34 <helpdocument version="1.0">
35 <meta>
36 <topic id="textscalc0112090105xml" indexer="include" status="PUBLISH">
37 <title id="tit" xml-lang="en-US">Data field</title>
38 <filename>/text/scalc/01/12090105.xhp</filename>
39 </topic>
40 <history>
41 <created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created>
42 <lastedited date="2004-09-27T11:52:36">UFI: added info from spec sc-features Field Options in DataPilot
43 YJ: checked</lastedited>
44 </history>
45 </meta>
46 <body>
47 <bookmark xml-lang="en-US" branch="hid/HID_SC_PIVOTSUBT" id="bm_id3153194" localize="false"/>
48 <bookmark xml-lang="en-US" branch="index" id="bm_id7292397"><bookmark_value>calculating;Data Pilot</bookmark_value>
49 </bookmark>
50 <paragraph role="heading" id="hd_id3150871" xml-lang="en-US" level="1" l10n="U" oldref="1">Data field</paragraph>
51 <paragraph role="paragraph" id="par_id3154124" xml-lang="en-US" l10n="U" oldref="16">The contents of this dialog is different for data fields in the <emph>Data</emph> area, and data fields in the<emph> Row</emph> or<emph> Column</emph> area of the <link href="text/scalc/01/12090102.xhp" name="DataPilot">DataPilot</link> dialog.</paragraph>
52 <paragraph role="heading" id="hd_id3152596" xml-lang="en-US" level="2" l10n="U" oldref="2">Subtotals</paragraph>
53 <paragraph role="paragraph" id="par_id3151113" xml-lang="en-US" l10n="U" oldref="3"><ahelp hid="HID_SC_PIVOTSUBT">Specify the subtotals that you want to calculate.</ahelp></paragraph>
54 <bookmark xml-lang="en-US" branch="hid/SC:RADIOBUTTON:RID_SCDLG_PIVOTSUBT:BTN_NONE" id="bm_id3149260" localize="false"/>
55 <paragraph role="heading" id="hd_id3145366" xml-lang="en-US" level="3" l10n="U" oldref="4">None</paragraph>
56 <paragraph role="paragraph" id="par_id3152576" xml-lang="en-US" l10n="U" oldref="5"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_PIVOTSUBT:BTN_NONE">Does not calculate subtotals.</ahelp></paragraph>
57 <bookmark xml-lang="en-US" branch="hid/SC:RADIOBUTTON:RID_SCDLG_PIVOTSUBT:BTN_AUTO" id="bm_id3147428" localize="false"/>
58 <paragraph role="heading" id="hd_id3154012" xml-lang="en-US" level="3" l10n="U" oldref="6">Automatic</paragraph>
59 <paragraph role="paragraph" id="par_id3155856" xml-lang="en-US" l10n="U" oldref="7"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_PIVOTSUBT:BTN_AUTO">Automatically calculates subtotals.</ahelp></paragraph>
60 <bookmark xml-lang="en-US" branch="hid/SC:RADIOBUTTON:RID_SCDLG_PIVOTSUBT:BTN_USER" id="bm_id3152460" localize="false"/>
61 <paragraph role="heading" id="hd_id3155411" xml-lang="en-US" level="3" l10n="U" oldref="8">User-defined</paragraph>
62 <paragraph role="paragraph" id="par_id3149581" xml-lang="en-US" l10n="U" oldref="9"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_PIVOTSUBT:BTN_USER">Select this option, and then click the type of subtotal that you want to calculate in the list.</ahelp></paragraph>
63 <bookmark xml-lang="en-US" branch="hid/SC:MULTILISTBOX:RID_SCDLG_PIVOTSUBT:LB_FUNC" id="bm_id3145799" localize="false"/>
64 <bookmark xml-lang="en-US" branch="hid/sc_MultiListBox_RID_SCDLG_DPDATAFIELD_LB_FUNC" id="bm_id1523789" localize="false"/>
65 <paragraph role="heading" id="hd_id3147124" xml-lang="en-US" level="3" l10n="U" oldref="10">Function</paragraph>
66 <paragraph role="paragraph" id="par_id3154490" xml-lang="en-US" l10n="U" oldref="11"><ahelp hid="SC:MULTILISTBOX:RID_SCDLG_PIVOTSUBT:LB_FUNC">Click the type of subtotal that you want to calculate. This option is only available if the <emph>User-defined</emph> option is selected.</ahelp></paragraph>
67 <bookmark xml-lang="en-US" branch="hid/SC:CHECKBOX:RID_SCDLG_PIVOTSUBT:CB_SHOWALL" id="bm_id3154015" localize="false"/>
68 <paragraph role="heading" id="hd_id3154944" xml-lang="en-US" level="2" l10n="U" oldref="14">Show elements without data</paragraph>
69 <paragraph role="paragraph" id="par_id3149403" xml-lang="en-US" l10n="U" oldref="15"><ahelp hid="SC:CHECKBOX:RID_SCDLG_PIVOTSUBT:CB_SHOWALL">Includes empty columns and rows in the results table.</ahelp></paragraph>
70 <paragraph role="heading" id="hd_id3149122" xml-lang="en-US" level="2" l10n="U" oldref="12">Name:</paragraph>
71 <paragraph role="paragraph" id="par_id3150749" xml-lang="en-US" l10n="U" oldref="13">Lists the name of the selected data field.</paragraph>
72 <bookmark xml-lang="en-US" branch="hid/sc_MoreButton_RID_SCDLG_DPDATAFIELD_BTN_MORE" id="bm_id4281746" localize="false"/>
73 <paragraph role="heading" id="par_idN106EC" xml-lang="en-US" level="2" l10n="NEW">More</paragraph>
74 <paragraph role="paragraph" id="par_idN106F0" xml-lang="en-US" l10n="NEW"><ahelp hid=".">Expands or reduces the dialog. The <emph>More</emph> button is visible for data fields only.</ahelp></paragraph>
75 <bookmark xml-lang="en-US" branch="hid/sc_PushButton_RID_SCDLG_PIVOTSUBT_BTN_OPTIONS" id="bm_id2855922" localize="false"/>
76 <paragraph role="heading" id="par_idN106F3" xml-lang="en-US" level="2" l10n="NEW">Options</paragraph>
77 <paragraph role="paragraph" id="par_idN106F7" xml-lang="en-US" l10n="NEW"><ahelp hid=".">Opens the <link href="text/scalc/01/12090106.xhp">Data Field Options</link> dialog. The <emph>Options</emph> button is visible for column, row, or page fields only.</ahelp></paragraph>
78 <paragraph role="paragraph" id="par_idN10708" xml-lang="en-US" l10n="NEW">If the dialog is expanded by the <emph>More</emph> button, the following items are added to the dialog:</paragraph>
79 <paragraph role="heading" id="par_idN1070B" xml-lang="en-US" level="2" l10n="NEW">Displayed value</paragraph>
80 <paragraph role="paragraph" id="par_idN1070F" xml-lang="en-US" l10n="NEW"><ahelp hid=".">For each data field, you can select the type of display.</ahelp> For some types you can select additional information for a base field and a base item.</paragraph>
81 <bookmark xml-lang="en-US" branch="hid/sc_ListBox_RID_SCDLG_DPDATAFIELD_LB_TYPE" id="bm_id3325907" localize="false"/>
82 <paragraph role="heading" id="par_idN10712" xml-lang="en-US" level="3" l10n="NEW">Type</paragraph>
83 <paragraph role="paragraph" id="par_idN10716" xml-lang="en-US" l10n="NEW"><ahelp hid="1495371266">Select the type of calculating of the displayed value for the data field.</ahelp></paragraph>
84 <table id="">
85 <tablerow>
86 <tablecell colspan="" rowspan="">
87 <paragraph role="tablehead" id="par_idN10724" xml-lang="en-US" l10n="NEW">Type</paragraph>
88 </tablecell>
89 <tablecell colspan="" rowspan="">
90 <paragraph role="tablehead" id="par_idN1072A" xml-lang="en-US" l10n="NEW">Displayed value</paragraph>
91 </tablecell>
92 </tablerow>
93 <tablerow>
94 <tablecell colspan="" rowspan="">
95 <paragraph role="tablecontent" id="par_idN10731" xml-lang="en-US" l10n="NEW">Normal</paragraph>
96 </tablecell>
97 <tablecell colspan="" rowspan="">
98 <paragraph role="tablecontent" id="par_idN10737" xml-lang="en-US" l10n="NEW">Results are shown unchanged</paragraph>
99 </tablecell>
100 </tablerow>
101 <tablerow>
102 <tablecell colspan="" rowspan="">
103 <paragraph role="tablecontent" id="par_idN1073E" xml-lang="en-US" l10n="NEW">Difference from</paragraph>
104 </tablecell>
105 <tablecell colspan="" rowspan="">
106 <paragraph role="tablecontent" id="par_idN10744" xml-lang="en-US" l10n="NEW">From each result, its reference value (see below) is subtracted, and the difference is shown. Totals outside of the base field are shown as empty results.</paragraph>
107 <paragraph role="tablecontent" id="par_idN10747" xml-lang="en-US" l10n="NEW">
108 <emph>Named item</emph>
109 </paragraph>
110 <paragraph role="tablecontent" id="par_idN1074C" xml-lang="en-US" l10n="NEW">If a base item name is specified, the reference value for a combination of field items is the result where the item in the base field is replaced by the specified base item.</paragraph>
111 <paragraph role="tablecontent" id="par_idN1074F" xml-lang="en-US" l10n="NEW">
112 <emph>Previous item or Next item</emph>
113 </paragraph>
114 <paragraph role="tablecontent" id="par_idN10754" xml-lang="en-US" l10n="NEW">If "previous item" or "next item" is specified as the base item, the reference value is the result for the next visible member of the base field, in the base field's sort order.</paragraph>
115 </tablecell>
116 </tablerow>
117 <tablerow>
118 <tablecell colspan="" rowspan="">
119 <paragraph role="tablecontent" id="par_idN1075B" xml-lang="en-US" l10n="NEW">% Of</paragraph>
120 </tablecell>
121 <tablecell colspan="" rowspan="">
122 <paragraph role="tablecontent" id="par_idN10761" xml-lang="en-US" l10n="NEW">Each result is divided by its reference value. The reference value is determined in the same way as for "Difference from". Totals outside of the base field are shown as empty results. </paragraph>
123 </tablecell>
124 </tablerow>
125 <tablerow>
126 <tablecell colspan="" rowspan="">
127 <paragraph role="tablecontent" id="par_idN1076A" xml-lang="en-US" l10n="NEW">% Difference from</paragraph>
128 </tablecell>
129 <tablecell colspan="" rowspan="">
130 <paragraph role="tablecontent" id="par_idN10770" xml-lang="en-US" l10n="NEW">From each result, its reference value is subtracted, and the difference is divided by the reference value. The reference value is determined in the same way as for "Difference from". Totals outside of the base field are shown as empty results.</paragraph>
131 </tablecell>
132 </tablerow>
133 <tablerow>
134 <tablecell colspan="" rowspan="">
135 <paragraph role="tablecontent" id="par_idN10777" xml-lang="en-US" l10n="NEW">Running total in</paragraph>
136 </tablecell>
137 <tablecell colspan="" rowspan="">
138 <paragraph role="tablecontent" id="par_idN1077D" xml-lang="en-US" l10n="NEW">Each result is added to the sum of the results for preceding items in the base field, in the base field's sort order, and the total sum is shown.</paragraph>
139 <paragraph role="tablecontent" id="par_idN10780" xml-lang="en-US" l10n="NEW">Results are always summed, even if a different summary function was used to get each result.</paragraph>
140 </tablecell>
141 </tablerow>
142 <tablerow>
143 <tablecell colspan="" rowspan="">
144 <paragraph role="tablecontent" id="par_idN10787" xml-lang="en-US" l10n="NEW">% of row</paragraph>
145 </tablecell>
146 <tablecell colspan="" rowspan="">
147 <paragraph role="tablecontent" id="par_idN1078D" xml-lang="en-US" l10n="NEW">Each result is divided by the total result for its row in the DataPilot table. If there are several data fields, the total for the result's data field is used. If there are subtotals with manually selected summary functions, the total with the data field's summary function is still used. </paragraph>
148 </tablecell>
149 </tablerow>
150 <tablerow>
151 <tablecell colspan="" rowspan="">
152 <paragraph role="tablecontent" id="par_idN10794" xml-lang="en-US" l10n="NEW">% of column</paragraph>
153 </tablecell>
154 <tablecell colspan="" rowspan="">
155 <paragraph role="tablecontent" id="par_idN1079A" xml-lang="en-US" l10n="NEW">Same as "% of row", but the total for the result's column is used.</paragraph>
156 </tablecell>
157 </tablerow>
158 <tablerow>
159 <tablecell colspan="" rowspan="">
160 <paragraph role="tablecontent" id="par_idN107A1" xml-lang="en-US" l10n="NEW">% of total</paragraph>
161 </tablecell>
162 <tablecell colspan="" rowspan="">
163 <paragraph role="tablecontent" id="par_idN107A7" xml-lang="en-US" l10n="NEW">Same as "% of row", but the grand total for the result's data field is used.</paragraph>
164 </tablecell>
165 </tablerow>
166 <tablerow>
167 <tablecell colspan="" rowspan="">
168 <paragraph role="tablecontent" id="par_idN107AE" xml-lang="en-US" l10n="NEW">Index</paragraph>
169 </tablecell>
170 <tablecell colspan="" rowspan="">
171 <paragraph role="tablecontent" id="par_idN107B4" xml-lang="en-US" l10n="NEW">The row and column totals and the grand total, following the same rules as above, are used to calculate the following expression:</paragraph>
172 <paragraph role="tablecontent" id="par_idN107B7" xml-lang="en-US" l10n="NEW">( original result * grand total ) / ( row total * column total )</paragraph>
173 </tablecell>
174 </tablerow>
175 </table>
177 <bookmark xml-lang="en-US" branch="hid/sc_ListBox_RID_SCDLG_DPDATAFIELD_LB_BASEFIELD" id="bm_id7005523" localize="false"/>
178 <paragraph role="heading" id="par_idN107BA" xml-lang="en-US" level="3" l10n="NEW">Base field</paragraph>
179 <paragraph role="paragraph" id="par_idN107BE" xml-lang="en-US" l10n="NEW"><ahelp hid="1495371267">Select the field from which the respective value is taken as base for the calculation.</ahelp></paragraph>
180 <bookmark xml-lang="en-US" branch="hid/sc_ListBox_RID_SCDLG_DPDATAFIELD_LB_BASEITEM" id="bm_id8070925" localize="false"/>
181 <paragraph role="heading" id="par_idN107C1" xml-lang="en-US" level="3" l10n="NEW">Base item</paragraph>
182 <paragraph role="paragraph" id="par_idN107C5" xml-lang="en-US" l10n="NEW"><ahelp hid="1495371268">Select the item of the base field from which the respective value is taken as base for the calculation.</ahelp></paragraph>
183 </body>
184 </helpdocument>