summaryrefslogtreecommitdiffstats
path: root/doc/en/details-search.docbook
blob: 6783c57f6ba7450e33f2074197d74e62a11b9c70 (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
<?xml version="1.0" encoding="UTF-8"?>
<chapter id="details.search">
<chapterinfo>
  <authorgroup>
    <author>
      <firstname>Darin</firstname>
      <surname>Strait</surname>
      <affiliation>
        <address><email>darin.strait@ashdar-partners.com</email></address>
      </affiliation>
    </author>
  </authorgroup>
  <date>2009-08-05</date>
  <releaseinfo>1.0</releaseinfo>
</chapterinfo>
<title>Search Transactions</title>

<sect1 id="details.search.general">
<title>General</title>

<para>
  The <guilabel>Search Transactions</guilabel> dialog searches your data based
  on criteria that you specify. You can access the dialog by going to
  the <guimenu>Edit</guimenu> menu and selecting
  <guimenuitem>Find transactions...</guimenuitem>.
</para>

<para>
  There are two main tabs in this dialog. The <quote>Criteria</quote> tab
  displays a number of sub-tabs for specifying the search critera.
</para>

<para>
  The results will be displayed under the <quote>Result</quote> tab after the
  search has completed. Below the list of results, &kappname; shows the number
  of transactions that met the search criteria.  Double-clicking on an
  individual transaction in the result list will bring up the appropriate ledger
  and display the transaction.
</para>

<para>
  When the <guibutton>Find</guibutton> button is pressed, the search is
  initiated and all criteria that have been entered on any tab will be taken
  into account.
</para>

<para>
 The <guibutton>Reset</guibutton> button resets all of the fields on all of the
 critera sub-tabs back to the defaults. This allows you to specify new search
 criteria.
</para>

<para>
  The <guibutton>Close</guibutton> button closes the <guilabel>Search
  Transactions</guilabel> dialog box.
</para>

</sect1>

<sect1 id="details.search.criteria">
<title>Search Criteria</title>

<para>
  There are several sub-tabs under the main <quote>Criteria</quote> tab, each of
  which allows you to specify different types of search criteria.  Below the
  area for specifying the criteria, &kappname; lists each of the different types
  of criteria that are currently specified for the search.
</para>

<sect2 id="details.search.text">
<title>Text</title>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="find-text.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Search transactions Dialog, Text tab</phrase>
</textobject>
</mediaobject>
</screenshot>

<para>
  This tab allows you to speicify text to search for.  There are also two check
  boxes that control how the text is used in the search.
</para>

<para>
  By default, this will match on simple substrings. For example:
</para>

<para>
<itemizedlist>
  <listitem>
    <para><quote>Best</quote> will find <quote>Best Cakes, Inc.</quote></para>
  </listitem>
  <listitem>
    <para>
      <quote>est</quote> will also find <quote>Best Cakes, Inc.</quote>
    </para>
  </listitem>
</itemizedlist>
</para>

<para>
  In the dropdown field next to the text field,
  select <guilabel>Contains</guilabel> if you want to find transactions that
  contain the text, or select <guilabel>Does not contain</guilabel> if you want
  to find transactions that do not contain the specified text.
</para>

<para>
  If you check the <guilabel>Case Sensitive</guilabel> box, the search will be
  case sensitive.  For example, <quote>best</quote> would not find <quote>Best
  Cakes, Inc.</quote> if this option is set.
</para>

<para>
  If you check the <guilabel>Treat Text as regular expression</guilabel> box,
  the text will be treated as a regular expresssion.  For details on how to
  craft a regular expression, visit the &Qt; documentation about the
  <ulink url="http://qt.nokia.com/doc/3.3/qregexp.html#1">QRegExp
  class</ulink>.
</para>
</sect2>

<sect2 id="details.search.account">
<title>Account</title>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="find-account.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Search transactions Dialog, Account tab</phrase>
</textobject>
</mediaobject>
</screenshot>

<para>
  This tab allows you to specify the accounts that should be searched. 
</para>

<para>
  Accounts are displayed in a tree format. Accounts that are marked for search
  are indicated with a check box. If you click the <guibutton>All</guibutton>
  button, all accounts are marked for searching. If you click the
  <guibutton>None</guibutton> button, no accounts will be marked for
  searching. Individual accounts can be marked or unmarked by clicking on the
  box next to the account name using the left mouse button. A complete hierarchy
  of accounts can be marked or unmarked by clicking on the box using the right
  mouse button.
</para>
</sect2>

<sect2 id="details.search.date">
<title>Date</title>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="find-date.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Search transactions Dialog, Date tab</phrase>
</textobject>
</mediaobject>
</screenshot>

<para>
  This tab allows you to specify which dates should be searched.
</para>

<para>
  The <quote>Range</quote> control provides a convenient way to set the From and
  To controls.  The From and To controls can be manipulated individually. Dates
  can be entered manually. The controls will prevent you from entering
  non-existing dates. Date values can also be changed by clicking on the up and
  down arrows when a particular part of a date is highlighted.  Clicking on the
  small calendar icon will bring up a calendar to easily select dates.
</para>
</sect2>


<sect2 id="details.search.amount">
<title>Amount</title>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="find-amount.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Find Dialog, Amount tab</phrase>
</textobject>
</mediaobject>
</screenshot>

<para>
  This tab allows you to specify what amounts should be searched for.
</para>

<para>
  You can search for an exact amount or for a range of amounts. If you click on
  the calculator icon, a small on-screen calculator will pop up to assist you in
  entering a value.
</para>
</sect2>

<sect2 id="details.search.category">
<title>Category</title>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="find-category.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Search transactions Dialog, Category tab</phrase>
</textobject>
</mediaobject>
</screenshot>

<para>
  This tab allows you to specify which categories should be searched. 
</para>

<para>
  Categories are displayed in a tree format. Categories that are marked for
  search are indicated with a box. If you click the <guibutton>All</guibutton>
  button, all categories are marked for searching. If you click
  the <guibutton>None</guibutton> button, no categories will be marked for
  searching. If you click the <guibutton>Income</guibutton> button, income
  categories will be marked and expense categories will be unmarked. If you
  click the <guibutton>Expense</guibutton> button, income categories will be
  unmarked and expense categories will be marked.
</para>

<para>
  Individual categories can be marked or unmarked by clicking on the box next to
  the category name using the left mouse button. A complete hierarchy of
  categories can be marked or unmarked by clicking on the box using the right
  mouse button.
</para>
</sect2>

<sect2 id="details.search.payee">
<title>Payee</title>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="find-payee.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Search transactions Dialog, Payee tab</phrase>
</textobject>
</mediaobject>
</screenshot>

<para>
  This tab allows you to specify which payees should be searched. 
</para>

<para>
  Payees that are marked for search are indicated with a box. If you click
  the <guibutton>All</guibutton> button, all payees are marked for searching. If
  you click the <guibutton>None</guibutton> button, no payees will be marked for
  searching. Individual payees can be marked or unmarked by clicking on the box
  next to the payee name.
</para>

<para>
  If you check the <guilabel>Select transactions without payees</guilabel> box,
  only transactions with no payee will be selected.
</para>

</sect2>

<sect2 id="details.search.details">
<title>Details</title>

<para>
  This tab allows you to specify various additional search criteria.
</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="find-details.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Search transactions Dialog, Details tab</phrase>
</textobject>
</mediaobject>
</screenshot>

<para>
<itemizedlist>
  <title>Type can be one of the following:</title>
  <listitem><para>All Types</para></listitem>
  <listitem><para>Payments</para></listitem>
  <listitem><para>Deposits</para></listitem>
  <listitem><para>Transfers</para></listitem>
</itemizedlist>

<itemizedlist>
  <title>State can be one of the following:</title>
  <listitem><para>All states</para></listitem>
  <listitem><para>Not reconciled</para></listitem>
  <listitem><para>Cleared</para></listitem>
  <listitem><para>Reconciled</para></listitem>
</itemizedlist>

<itemizedlist>
  <title>Validity can be one of the following:</title>
  <listitem><para>Any transaction</para></listitem>
  <listitem><para>Valid transaction</para></listitem>
  <listitem><para>Invalid transaction</para></listitem>
</itemizedlist>
</para>

<para>
  You can search for a particular transaction number or search for a range of
  transaction numbers.
</para>

</sect2>
</sect1>

<sect1 id="details.search.results">
<title>Search results</title>

<para>
  The <quote>Result</quote> tab displays the Date, Account, Details,
  Reconciliation status, Payment, and Deposit for each transaction
  that matches the search criteria you have entered.  Right clicking
  on the header row of the results list allows you to alter the sort
  order of the results.
</para>

<para>
  Double-clicking on a transaction will display the corresponding
  account ledger and focus on the selected transaction.
</para>

</sect1>

</chapter>