summaryrefslogtreecommitdiffstats
path: root/doc/en/details-reports.docbook
blob: e05ec01f7b4815c3ed8503b01e462cce59454556 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
<?xml version="1.0" encoding="UTF-8"?>
<chapter id="details.reports">
<chapterinfo>
  <authorgroup>
    <author>
      <firstname>Ace</firstname>
      <surname>Jones</surname>
      <affiliation>
        <address><email>acejones@users.sourceforge.net</email></address>
      </affiliation>
    </author>
  </authorgroup>
  <date>2009-07-28</date>
  <releaseinfo>1.0</releaseinfo>
</chapterinfo>

<title>Reports</title>

<sect1 id="details.reports.avail">
<title>Available Reports</title>

<para>
<screenshot>
	<screeninfo>Reports View</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="reports_view-all.png" format="PNG" />
	</imageobject>
	<textobject>
	<phrase>Reports View</phrase>
	</textobject>
	</mediaobject>
</screenshot>
</para>

<para>@Rob: Pls update Screenshot to include new Charts section</para>

<para>
  The Reports View lists all available reports, grouped under the following
  headings.
</para>

<sect2>
<title>Income and Expenses</title>
<para>
  The reports in this section show your income and expenses either for the
  current month or for each month in the current year.  Of course, the duration
  of the overall report and the duration captured by each column can be
  configured to your liking. Graphs and Pie Charts also may be produced.
</para>
</sect2>

<sect2>
<title>Net Worth</title>
<para>
  Here there are reports that describe your net worth, either at the current
  moment, every month for the current year, or every year of your history. In
  addition, there is a 7-day Cash Flow Forecast and a Net Worth Graph.  There
  are also reports to get the balances for all of your accounts at any given
  point in time.
</para>
</sect2>

<sect2>
<title>Transactions</title>
<para>
  This section includes reports that list individual transactions.  This is the
  best way to print your account register for a specific period of time.  The
  transactions printed can be grouped together according to your liking by
  choosing the appropriate report, such as:
<itemizedlist>
  <listitem><para>By Account</para></listitem>
  <listitem><para>By Category</para></listitem>
  <listitem><para>By Month or Week</para></listitem>
  <listitem><para>By Payee</para></listitem>
</itemizedlist>
</para>

</sect2>

<sect2>
<title>Cash Flow</title>
<para>
  The Cash Flow report is similar to a Transaction report, but it displays all
  cash-flow related transactions.
</para>
</sect2>

<sect2>
<title>Investments</title>
<para>
  These reports help you keep track of your investments.  They only include
  investment accounts.  There are a variety of presentation filters and styles,
  as shown in this partial list.
</para>
<itemizedlist>
  <listitem><para>Investment Transactions:  Similar to a Transactions report,
    and includes the share price and quantities.</para></listitem>
  <listitem><para>Investment Holdings by Account:  Shows the current shares,
    price, and value for each account.</para></listitem>
  <listitem><para>Investment Holdings by Type:  Same as the previous report, but
    organizes the accounts by type (Stock, Mutual Fund, etc)</para></listitem>
  <listitem><para>Investment Performance by Account: Shows the annualized
    performance over any period of time.  This performs a cash flow analysis of
    all money coming into and going out of the account.  As a result, this is a
    very accurate picture of how well your investments are
    doing.</para></listitem>
  <listitem><para>Investment Performance by Type:  Same as the previous report,
    but organizes the accounts by type (Stock, Mutual Fund,
    etc)</para></listitem>
</itemizedlist>

<para>
  There are also graphs for Investment Prices and Investment Worth.
</para>
</sect2>

<sect2>
<title>Taxes</title>
<para>
  The tax reports are just like the transactions reports, with the addition that
  only Tax related categories are included.  This allows you to flag certain
  categories as being tax-related, and then get one big report at the end of the
  year to see them all in one place. They may be listed either by Category or by
  Payee, and for the last fiscal year.
</para>
</sect2>

<sect2>
<title>Budgeting</title>
<para>
  The budgeting reports are similar to net worth reports, but the reports can
  display the budget for a given year, or even compare it to the actual income
  and expenses for the same period.
</para>
</sect2>

<sect2>
<title>Forecast</title>
<para>
  The forecast reports are just like the net worth reports, but they use the
  information to display forecast information.  You can display the information
  at various levels and for the timeframe of your choosing.
</para>
</sect2>

<sect2>
<title>General Information</title>
<para>
  These reports display non-transaction information about schedules, accounts,
  and loans.
</para>
</sect2>

<sect2>
<title>Charts</title>
<para>
  If <link linkend="details.reports.charts">Charts</link> are enabled, this
  section lists all the reports which are marked to display a graphical chart as
  the default.  They are also listed in one of the other sections, but they are
  also aggregated here for your easy reference.
</para>
</sect2>

<sect2>
<title>Favorites</title>
<para>
  This section lists all the reports you have marked as a favorite in the report
  configuration dialog.  They are still listed in one of the other sections, but
  they are also aggregated here for your easy reference.  Favorite reports are
  also included on the financial summary page for even easier reference.
</para>
</sect2>

<sect2>
<title>Configuring Reports</title>
<para>
  To access the report configuration dialog, bring up the report you wish to
  configure, and press the <guibutton>Configure</guibutton> button at the top of
  the report.
</para>
</sect2>

</sect1>

<sect1 id="details.reports.working">
<title>Working With Reports</title>

<para>
  There are a number of actions you can take on each report.  You can access
  these by right-clicking the report name in the list of reports.  Alternately,
  once you have run a report, there are buttons across the top of the view to
  invoke each of these:
</para>

<itemizedlist>
  <listitem><para>Chart: Only present if the report is capable of displaying a
    chart. Clicking this option toggles between the report and the
    chart.</para></listitem>
  <listitem><para>Configure: Change the properties of this report. You can
    customize the report to your liking and save it for future
    use.</para></listitem>
  <listitem><para>New: Create a new customized report based on the selected
    report.</para></listitem>
  <listitem><para>Copy: The report output can be copied to the clipboard to
    paste them in another application, like a spreadsheet, for further
    analysis.</para></listitem>
  <listitem><para>Export: Reports can be saved in &HTML; or CSV
    format.</para></listitem>
  <listitem><para>Delete: Customized reports can be deleted.  The default
    reports that ship with KMyMoney cannot be deleted.</para></listitem>
  <listitem><para>Close: Close the current report.</para></listitem>
</itemizedlist>
</sect1>

<sect1 id="details.reports.config">
<title>Configuring Reports</title>

<sect2>
<title>Working with custom reports</title>
<para>
  You can configure the default reports or create your own from them by
  selecting 'New' and then configuring the new report. When you select
  'Configure' you will be presented with the Report Tab. Initially, it is named
  the same as the old report with <quote>Custom</quote> added to the end. You
  can change the name to whatever you want.  You can even name your custom
  reports the same as a default report, or the same as another custom
  report. Also, you can always use the Comment field to further distinguish
  reports.
</para>

<para>
  The Report Configuration dialog has a number of tabs across the top.  Each tab
  displays options for configuring different aspects of the report.
</para>

</sect2>

<sect2><title>Report Tab</title>
<para>
	<screenshot>
	<mediaobject>
	<imageobject>
	<imagedata fileref="report_configuration-reporttab.png" format="PNG" />
	</imageobject>
	<textobject>
	<phrase>Report Configuration -Report</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para>
  On this tab, you set the basic properties of this report.
<itemizedlist>
  <listitem><para>Report Name: Choose a name for this report.</para></listitem>
  <listitem><para>Comment: Enter a comment to help you remember the details of
    this report.</para></listitem>
  <listitem><para>Convert values to base currency: Select this option to convert
    all values in the report to your base currency. Leave it unchecked if you'd
    like to see values in their original currency. If currencies are not
    converted, then subtotals will not be shown.</para></listitem>
  <listitem><para>Mark as favorite report: Check this to cause this report to
    show up on the home page and in the group of <guilabel>Favorite
    Reports</guilabel>.</para></listitem>
</itemizedlist>
</para>

</sect2>

<sect2 id="details.reports.config.rowscolumns">
<title>Rows/Columns Tab</title>
<para>
  On this tab, you configure how you would like the rows and columns to be selected
  and organized.  This tab presents different configuration options depending on
  the style of report you have selected.
</para>

<para>
	<screenshot>
	<mediaobject>
	<imageobject>
	<imagedata fileref="report_configuration-rowscolumns.png" format="PNG" />
	</imageobject>
	<textobject>
	<phrase>Report Configuration -Rows and Columns</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para>@Rob: Screenshot of rows/columns tab from an income/expense report</para>

<para>
  For income/expense and net worth reports:
<itemizedlist>
  <listitem><para>Columns: Choose how large of a time period each column should
    encompass</para></listitem>
  <listitem><para>Rows: Choose what kind of accounts to display as the rows of
    this report</para></listitem>
  <listitem><para>Detail: Choose the level of detail required for this
    report.</para></listitem>
</itemizedlist>
</para>

<para>The following levels of detail are available:
<itemizedlist>
  <listitem><para>All: Show every category or account.</para></listitem>
  <listitem><para>Top-Level: Show only the highest-level categories or accounts,
    and roll up the sums of the subordinates categories or accounts into those
    values.</para></listitem>
  <listitem><para>Groups: Show only the totals of the income, expenses, assets,
    or liabilities.</para></listitem>
  <listitem><para>Total: Show only the grand totals line.</para></listitem>
</itemizedlist>
</para>

<para>
  For transaction reports:
<itemizedlist>
  <listitem><para>Organize by: Choose how to group the transactions in this
    report</para></listitem>
  <listitem><para>Show Columns: Choose which columns should be shown in the
    report. The date and transaction amount are always shown.</para></listitem>
  <listitem><para>Include only Tax Categories: Only show categories which have
    been marked as tax-related.</para></listitem>
  <listitem><para>Include only Investment Accounts: Only show transactions from
    investment accounts.</para></listitem>
  <listitem><para>Include only Loan Accounts: Only show transactions from loan
    accounts.</para></listitem>
</itemizedlist>
</para>

</sect2>

<sect2>
<title>Chart Tab</title>
<para>@Rob: Screenshot of chart tab</para>

<para>
  This tab allows you to configure what the report should look like when it is
  displayed as a chart.  See the <link linkend="details.reports.charts">Graphs
  &amp; Charts</link> section for more explanation of the charting functions.
<itemizedlist>
  <listitem><para>Chart Type: The visual format of chart
    desired.</para></listitem>
  <listitem><para>Show grid lines: Whether to print horizontal and vertical grid
    lines on the chart.</para></listitem>
  <listitem><para>Draw values on chart: Whether to print the data values on the
    chart itself for chosen data points.</para></listitem>
  <listitem><para>Show chart by default: Whether this report should first be
    displayed as a chart when it's opened.</para></listitem>
  <listitem><para>Line width: The width of data lines on the
    chart.</para></listitem>
</itemizedlist>
</para>

</sect2>

<sect2>
<title>Other Tabs</title>
<para>
  The other tabs in this dialog are the same as in the Search Transactions
  interface.  Please refer to
  the <link linkend="details.search">documentation</link> on that interface for
  details on the other tabs.</para>
</sect2>

</sect1>

<sect1 id="details.reports.charts">
<title>Graphs &amp; Charts</title>

<sect2>
<title>Viewing as a Chart</title>

<para>
  Each report can be viewed in either textual form or graphical (chart) form.
  The same report configuration parameters are used in either case.  You can
  easily jump back and forth between the textual and graphical forms by pressing
  the <guibutton>Chart</guibutton> or <guibutton>Report</guibutton> buttons
  along the top of the report view.
</para>

<para>
  Care should be taken to limit the amount of data you choose to display on a
  chart. If you are not careful, using the same configuration for both textual
  and graphical forms means it's possible to configure a chart to be visually
  cluttered, unappealing, and uninformative. &kappname; will not force you to
  keep your charts readable and useful!
</para>

</sect2>

<sect2>
<title>Available Chart Types</title>

<sect3>
<title>Line Graph</title>
<para>@Rob: Screenshot of a simple line graph</para>

<para>
  A line graph is one of the most simple forms of a chart.  There is one line
  for each series. (Usually a series is a single account or category; see below
  for more details on that.) The time periods stretch out along the bottom axis,
  and the currency values are along the left.
</para>

<para>
  The detail level for each line is controlled in the <link
  linkend="details.reports.config.rowscolumns">Rows/Columns</link> Tab of chart
  configuration.  If you choose the <quote>Top-Level</quote> detail level, there
  will be one line for each of the top-most accounts or categories which show
  the sum total of all underlying accounts or categories.  If you choose
  <quote>Groups</quote> it will instead show one line each for Income, Expenses,
  Assets, or Liabilities, depending on the other settings.
</para>
</sect3>

<sect3>
<title>Bar Graph</title>
<para>@Rob: Screenshot of a simple bar graph</para>

<para>
  The bar graph works exactly the same as the line graph, except there is one
  bar for each series in each time slice.
</para>
</sect3>

<sect3>
<title>Pie Chart</title>
<para>@Rob: Screenshot of a simple pie chart</para>

<para>
  The pie chart is the most simple chart available.  It shows only one time
  slice, as opposed to showing the values across time.  This chart shows only
  the totals column of whatever report is selected.  If your report is
  configured to NOT convert values to the base currency, there will be no totals
  column, and therefore this report is not useful.
</para>
</sect3>

<sect3>
<title>Ring Chart</title>
<para>@Rob: Screenshot of a simple ring chart</para>

<para>
  The ring chart is very similar to a pie chart, except there is one
  <quote>ring</quote> for each time slice in the report.
</para>
</sect3>

</sect2>

</sect1>
</chapter>