# Common Transaction Operations

A transaction represents the movement of money from one account to another account. Whenever you spend or receive money, or transfer money between accounts, that is a transaction. In &appname; transactions always involve at least two accounts.

&appname; uses accounts as a way of grouping or organizing the recording of transactions. This section describes the methods &appname; has to help enter transactions quickly into the register.

&appname; has several methods available for entering transactions.

- Entering directly into the register window is the most common way of entering transactions.

- Using the Transfer Funds window .

- Importing transactions either from a file or via on-line banking.

## Transfer Funds Dialog Box

The Transfer Funds Dialog Box, accessed via Ctrl T Actions Transfer... or by pressing the Transfer icon from the account register tab, serves two purposes in &app;:

- A way to create a simple (i.e. two-split) transaction between arbitrary accounts.

- Collect exchange rate or amount information in a multi-currency transaction (see ).

The Basic Information and Transfer Accounts panes will be disabled in the Transfer Funds dialog when it is being used only to collect exchange rate or amount information.

### Basic Information

The Basic Information section collects the entries for constructing a transaction: Date, description, amount, etc.

- Amount: The amount of the transaction in the Transfer Fromaccount's commodity.

- Date: The posting date for the transaction, i.e. the date that you want to record it in your book.

- Num: A reference number for the transaction, often a check number.

- Description: The description of the transaction, often the payer or payee.

- Memo: Additional information you might want to note about the transaction. Anything entered here will be added to the Memo fields of both splits.

### Transfer Accounts

The Transfer From and Transfer To tree views are used to select the accounts which will participate in the transaction. They normally show only Asset and Liability accounts. If you need to use an Income or Expense account in one of them, check the Show Income/Expense checkbox below the appropriate view.

- Choose the Transfer From account.

- Choose the Transfer To account.

### Currency Transfer

The Currency Transfer pane is used to collect the needed information to enter the amount of the Transfer To split. You may enter either a price or an amount and &appname; will compute the other. If you have Online Price Retrieval installed (see ) you can use the Fetch Rate button to retrieve a current quote.

The Currency Transfer pane is enabled only if the selected accounts use different commodities or the Transfer Funds dialog was launched to collect price or amount information from editing a transaction in the register.

The Currency Transfer pane is organized as a radio group with two selections, Exchange Rate and To Amount. Each consists of a radio button and a numeric entry.

If a relevant price is available in the price database (see ) the Exchange Rate will have that as a default entry.

- Select the Exchange Rate radio button if you want to enter a price or use the Fetch Rate button.

- Select the To Amount radio button if you want to enter the amount of the To Account split.

- Enter the price/exchange rate or the amount in the numeric entry corresponding to radio button you selected. &appname; will calculate the other amount for you when you exit the field. If it's enabled you can use the Fetch Rate button to retrieve a current quote.

If you have created a price in the Price Editor (see ) for the current date quote retrieval will not update that price. You must first delete the manually-created price in the Price Editor before you Button1 on the Fetch Rate button.

The Fetch Rate button will immediately create or replace a price in the Price Editor unless there is an existing manually-created price for today.

### Finishing Up

Select OK to commit the transaction (or confirm the price/amount) or Cancel to dismiss the dialog without entering the transaction.

When committing a transaction or confirming an exchange rate the price on the transaction date in the Price Editor may be updated. See for details.

## Enter Transaction via register

When the Account Register Window for an account is opened the list of transactions for that account is shown. This window has the name of the account on its tab. The menus contain several functions that alter the display of transactions. The Toolbar also contains several functions that are often used when entering or manipulating transactions. These are described in the section of this document.

### Entering Directly in the Register Window

The register window will look slightly different depending on the style options you have chosen. The following describes entering simple transactions in the basic ledger style. The cursor is placed in the date field by default when the register window is opened.

When working on transactions in &appname;, be aware that the Enter key and the Tab key behave differently, and perform different actions.

The Enter key moves to the first field of the next split, regardless of which field you are in. If there is no next split, proceeds to the next transaction. In any case, Enter finishes the transaction edit, and any imbalance is posted to Imbalance-CUR, where CUR is the currency of the transaction.

The Tab key moves to the next field in the current split. If it's the last field, moves to the next split, creating a new one if there isn't one. If the split is blank, the Tab key finishes the transaction and posts any imbalance to Imbalance-CUR, as above.

1. Selecting the small icon on the right of the date field drops down a date selection calendar. Use the arrows to select the correct month and year for the transaction then select the date. Selecting the icon once more will close the date selection calendar. It is also possible to type in the date or part of the date and let &appname; fill the rest.

2. Press Tab to move to or select the Num field. Here you can enter a check or transaction number. Pressing + (plus) will automatically advance the number by one from the last transaction to have a number.

3. Press Tab to move or select the Description field. This field is used to enter either a payee or other description for the transaction. It will automatically attempt to fill the payee name as you type.

4. At this stage one of two things will happen if tab is pressed. If &appname; matches an existing transaction the cursor will jump to one of the amount fields, automatically filling in the transfer account. Selecting any field with the mouse instead of tabbing will not automatically fill the transferring account field. If there is no matching (existing) transaction, &appname; will move the cursor to the Transfer field with only one line of the transaction supplied.

5. Accounts may be selected either by typing them in or by pressing the small button on the right of the Transfer field, which will display a pick list of all non-placeholder accounts. Note that this pick list will still display hidden accounts. If you have hidden an account in your chart of accounts, you may want to set the account also to be a placeholder account so that it doesn't display here.

   When typing, &appname; will fill in available accounts as you type. For example, if you have Equity and Expenses top-level accounts, typing E will fill in Equity because it sorts before Expenses. Continuing to type x will present Expenses the account separator (: by default, see Account Preferences about changing it) will accept the currently offered account so that you can start typing the name of a child account.

6. The next field R is used for reconciliation. This is described in the Reconcile an Account to a Statement section.

7. Press the Tab key to move to the first of the amount fields. The names of the next two columns are different according to what type of account is opened. For example, Bank accounts show Deposit and Withdrawal here, Credit Card accounts show Payment and Charge, and Stock accounts show Shares, Price, Buy and Sell.

8. Enter an amount for the transaction in the correct fields. When the transaction is "balanced" pressing the Enter key, selecting the Enter icon or going to Transaction Enter Transaction will finish the transaction. Selecting the Cancel icon or going to Transaction Cancel Transaction will erase the transaction.

9. Transactions with just one transfer account will show the name of that account in the Transfer field in completed transactions. (The Transfer field is the fourth (4) from the left in the register display.)

10. To move to the blank transaction at the bottom of the register, press the Blank Toolbar icon or go to Actions Blank Transaction .

## Associating an External File with a Transaction.

Some users find it helpful to associate external files or URLs, perhaps images of store receipts, cancelled checks, or vendor invoices, with their transactions. &app; provides a facility for doing just that.

Select a transaction in the Register and Button2 click it to present the Context Menu and select Update Association for Transaction. You will be presented with the Change a Transaction Association dialog.

Change a Transaction Association Dialog

At the top is a radio button with two choices File Association and Location Association. If there's an item associated then the radio button will have the appropriate selection. At the bottom, 3 buttons: Remove, Cancel, and OK. Remove will remove the current association and close the dialog box; the other two do the usual actions.

If the File Association radio button is selected the control beneath it is a file chooser button. It will display the name of the selected file if there is one or None if there isn't. Clicking the button will bring up a file chooser dialog from which one may select the file to associate.

If the Location Association radio button is selected there is a text entry beneath it in which you may type a URL.

When you have finished click the OK button to confirm your choice or the Cancel button to dismiss the dialog without making a change.

Open Association for Transaction is enabled if there is a file or URL associated with the selected transaction. Selecting it will open a file in the operating system's default viewer for the file type and a URL in the default browser

Remove Association from Transaction is enabled if there is a file or URL associated with the selected transaction and does exactly what you'd expect.

Chain and Paperclip

When the Register is in Double Line mode the cell underneath the Reconciliation cell is the Association cell and displays

- a paperclip symbol if there is a file associated with the transaction and

- a chain-link symbol if there is a URL associated with it

as long as those symbols are supported by the current font for the cell. Hovering over the cell will display the file path or URL in a tooltip and clicking in it will open the file or URL as the Open Transaction context menu item would.

## Multiple Split Transactions

The register window will look slightly different depending on the style options you have chosen. The following describes entering transactions with multiple splits in the basic ledger style. &appname; describes as a Split when money is transferred to or from more than two accounts in a transaction. The cursor is placed in the date field by default when the register window is opened.

The multiple account lines will not be displayed in the Basic Ledger unless the Split icon or the Action Split Transaction option have been selected.

1. Selecting the triangle icon on the right of the date field drops down a date selection dialog. Use the arrows to select the correct month and year for the transaction then select the date. Selecting the icon once more will close the date selection calendar. It is also possible to type in the date or part of the date and let &appname; fill the rest.

2. Press Tab to move to or select the Num field. Here you can enter a check or transaction number. Pressing + (plus) will automatically advance the number by one from the last transaction to have a number.

3. Press Tab to move to or select the Description field. This field is used to enter either a payee or other description for the transaction. It will automatically attempt to fill the payee name as you type.

4. At this stage one of two things will happen if tab is pressed. If &appname; matches an existing transaction the cursor will jump to one of the amount fields, automatically filling in the transfer account. Selecting any field with the mouse instead of tabbing will not automatically fill the transferring account field. If there is no matching (existing) transaction, &appname; will move the cursor to the Transfer field with only one line of the transaction supplied.

5. When typing in the Transfer field &appname; will also attempt to automatically match the account. It does this alphabetically, so typing `Ex` will match the `Expenses` section of the account list. When the section is matched, it is possible to move to a child account by pressing : (colon). If after typing Ex you press : then the cursor will move to the first child account in the list. Typing combinations of letters and : will allow movement down the tree of accounts quickly. The small icon on the right of the Transfer field can be used as an alternate way of selecting accounts.

6. The next field is used for reconciliation. This is described in

7. Press Tab to move to the first of the amount fields. The names of the next two columns are different according to what type of account is opened. For example, Bank accounts show Deposit and Withdrawal here, Credit Card accounts show Payment and Charge, and Stock accounts show Shares, Price, Buy and Sell.

8. Enter the total amount for the transaction in the correct field. Before pressing Tab or Enter read next step.

9. To enter the additional splits, press the Split button on the Toolbar or select Actions Split Transaction . Transactions with more than one split show the text --Split Transaction-- and the Split button will need to be used to show the details.

10. The display will expand, the titles of the amount columns will be renamed and the Transfer column name will be blank. The first line contains the description and the amount of the transaction. The second line contains the currently opened account name in the Account field and the amount of the transaction. The third line contains the transfer account name in the Account field. If the amount is not balanced, &appname; will indicate this by placing gray check-boxes in the amount columns with the unbalanced amount in a blank last row.

11. When one of the short lines is selected, the column titles will change. The very first and last (Date and Balance) columns will have blank titles. Num will change to Action, Description to Memo, the now blank Transfer column will change to Account. The last two amount columns will show the name described in step seven.

12. The Action and Memo columns are optional to fill out at this stage. Action is used to describe what kind of account transfer is involved. Memo is an additional description of the transfer.

13. Move to the missing amount field on the third line and fill in the amount. Pressing the Enter key, selecting the Enter icon or going to Actions Enter will now move the cursor to the next line.

14. The Account column contains the list of transfer accounts. This column is the one that is used to add splits. The method described in step five can be used to select another account on a blank line. Add as many additional splits as needed.

15. When the transaction is balanced the gray check-boxes will disappear and the last blank line will not have an amount.

16. Pressing Enter as described above will jump to the next transaction. Selecting the next transaction will close the split or it can be manually closed by pressing the Split icon or selecting Actions Split Transaction .

## Multiple Currency/Commodity Transactions

Any transaction that has splits whose accounts are denominated in different commodities (currencies are a subset of commodities) requires an exchange rate to convert between the two. For more information please see Chapter 10 of the Tutorial and Concepts Guide.

Registers for accounts of type STOCK or FUND display four columns, Shares, Price, Buy, and Sell (the last two will be Credit and Debit respectively if you've enabled Use formal accounting labels in the Accounts tab of Preferences). Enter any two and &appname; will calculate the other for you; if you enter 3 and the result doesn't balance &appname; will ask which one to change to make the split balance.

Registers of other types have only Credit and Debit (the names will be different depending on the account type if you haven't enabled Use formal accounting labels) and so use the Transfer Dialog with most of the fields disabled to collect either an Exchange Rate or a To Amount (the amount in the other currency/comodity). Please see () for details of using this dialog.

When committing a transaction or confirming an exchange rate the price on the transaction date in the Price Editor may be updated. See for details.

## Editing a Transaction

Editing a transaction involves just selecting the part of the transaction that needs to be changed. Once the changes are complete pressing the Enter key, selecting the Enter icon or going to Transaction Enter Transaction will now move the cursor to the next line or transaction.

To see a more detailed view of a transaction for editing in Basic Ledger, press the Split button on the Toolbar or select Actions Split Transaction .

## Deleting a Transaction

If a transaction needs to be removed from the register, select the transaction and press either the Delete icon on the Toolbar or go to Transaction Delete Transaction . A window will appear to confirm the delete, unless the preference has been changed. The window presents two options; "Remember and don’t ask again", and "Remember and don’t ask again this session". The response will be set according to the selected checkbox. The preference can also be reset via Actions Reset Warnings . .

Parts of a transaction can also be removed by pressing the Split button on the Toolbar or selecting Actions Split Transaction . The part of the transaction that needs to be deleted can be then selected for deletion.

## Add Reversing Transaction

In formal accounting, transactions should never be deleted or altered. Instead, when a mistake is made, the original transaction remains in the ledger, and a reversing transaction is added to the ledger. This reversing transaction restores the ledger to its state before the error, allowing the user to enter the transaction again correctly.

While a user can certainly enter reversing transactions manually, &appname; includes a menu option ( Transaction Add Reversing Transaction ) that can quickly create the reversing transaction for you. This option only appears when you are in an account register. When you are in the transaction that needs to be reversed, all you need to do is select this menu item, and a duplicate transaction that reverses the active transaction is immediately created.

Once you choose the menu item, a reversing transaction is immediately created in the account using the current date. You may wish to locate the new transaction at the end of the register, and add explanatory notes to it.

## Removing Transaction Splits

Removing Transaction Splits involves erasing all splits except the one for the account that is opened. This is a useful way of reusing a previous transaction that has multiple splits that need to be changed. (Note this can be done without opening the split, but doing so makes the effect more visible)

1. If in Basic Ledger, press the Split button on the Toolbar or select Actions Split Transaction to open the transaction. If in other modes select transaction.

2. Select Transaction Remove Transaction Splits .

   A window will appear to confirm the delete, unless the preference has been changed. The window presents two options; "Remember and don’t ask again", and "Remember and don’t ask again this session". The response will be set according to the selected checkbox. The preference can also be reset via Actions Reset Warnings . .

3. All Accounts and their related details will be removed except for the currently opened account.

4. The amount is not balanced and &appname; will indicate this by placing gray check-boxes in the amount columns with the unbalanced amount in the blank last row.

5. Edit the transaction to fill in the new details.

## Copying a Transaction

Copying Transactions is available from the Transaction menu. The Transaction menu has Cut Transaction, Copy Transaction and Paste Transaction which allows a whole transaction to be cut or copied and pasted to a new transaction line. This way of copying a transaction will use the date showing in the new transaction blank line.

The Transaction Duplicate Transaction... or the Toolbar Duplicate which, unlike the Copy method, allows for choosing a different date.

- Select the transaction to duplicate.

- Go to Transaction Duplicate Transaction...

- A dialog called Duplicate Transaction will prompt for a new Date and Num for the transaction.

- Press OK to add the transaction to the register.

## Setting the reconcile status (R field) of a transaction

In the &appname; register there is a column labeled R. This field indicates the status of a transaction. Possible values are:

n

  No. This is the default status when a transaction is created.

c

  Cleared. Status may be assigned either manually or by an import process. Indicates the transaction is included in the bank's record of the account transactions but has not yet been reconciled to a bank statement in &app;.

y

  Yes, reconciled. This status is solely assigned by the reconciliation process (see ). Places limits optionally requiring confirmation on editing fields in that line of a transaction.

f

  Frozen. Not implemented at this time

v

  Voided. Status is assigned or released manually through the transaction menu () to a transaction and applies to every line in the transaction. It hides most of the transaction details but does not delete them. When a transaction is voided a reason entry is required that appears to the right of the transaction notes. The notes and void reason will only be visible when you have enabled View Double Line .

## Jump to another Account Register

When using the Account Register Window it is frequently useful to be able to view another account and also the transfer account at the same time. &appname; allows you to do this quickly by using the Jump button available in the Toolbar or the Actions Jump menu item in the Account Register Window.

Select the transaction in the Account Register Window and either click the Jump icon or select Actions Jump to open the Account Register Window target. If the transaction is split between more than one transfer account then you will need to show all the split transfer accounts first and select the transfer account to jump to.

## Scheduling Transactions

Scheduled Transactions provide the ability to have reminders scheduled or transactions scheduled to be entered at a specified date. This is combined with the Since Last Run assistant () to review and enter the transactions. The Mortgage & Loan Repayment assistant () is used to setup a scheduled transaction to repay a compounding interest loan. The Scheduled Transaction Editor () is used to create and edit transactions that are to be added to the register in an automated way.

The easiest way to setup a scheduled transaction is to use an existing transaction in an account register as a template. Select the transaction you wish to use as a template and then either select the Schedule icon on the Toolbar or go to Actions Schedule... . This will bring up the Make Scheduled Transaction dialog.

- Name: Enter a name to use for the scheduled transaction. This will be used in the Description field of the transaction.

- Frequency: Choose the time period you want between scheduled entries. The dates that the transactions will be entered will show in the mini calendar pane to the right.

- Start Date: Choose a date for the scheduled transaction to start.

- Never End: This scheduled transaction has no finish date.

- End Date: Choose a date for the scheduled transaction to end.

- Number of Occurrences: Enter the number of times you wish the scheduled transaction to be added to the register.

The Advanced... button brings up the Scheduled Transaction Editor’s dialog to Edit the Scheduled Transaction. This is described in the section Scheduled Transaction Editor.

### Scheduled Transactions Window

The Scheduled Transactions Window is used to access the list of scheduled transactions and create, edit or remove them. It also provides a calendar which displays upcoming scheduled transactions. Clicking on the calendar view and hovering over any date will pop up a small dialog that shows the transactions scheduled for that day. The blue highlight in the calendar indicates which days have scheduled transactions. To dismiss the hover dialog click once more.

The top pane of the Scheduled Transaction Window contains the list of scheduled transactions that are currently setup. This window lists the Name of the transaction, if the transaction is enabled for scheduling, the Frequency (month and day) that the transaction is to be entered, the last time the transaction was entered and the next time the transaction will be entered.

The right side of this pane contains a down arrow button that when clicked will pull-down a window to allow selection of the characteristics displayed in the list. Unchecking the appropriate box will remove the characteristic from the display.

The Toolbar of this window contains three buttons to create, delete and edit scheduled transactions. New and Edit buttons opens the Edit Scheduled Transaction dialog. Delete removes the selected scheduled transaction. The same options are available thru Schedule New/Edit/Delete , from the Scheduled Transaction Tab.

Below the list of scheduled transactions is the Upcoming calendar. This calendar displays up to the next year and highlights the dates that the scheduled transactions are scheduled to occur so it is easy to see when the transactions are scheduled. Clicking on a date in the calendar brings up a list of scheduled transactions for that date. Moving the mouse over other dates changes to the list of transactions on those dates. Clicking once more on the calendar removes the transaction list.

The Scheduled Transaction Window is activated from the Account tab or the Transaction Register via Actions Scheduled Transaction Scheduled Transaction Editor... .

## Edit Scheduled Transaction Window

The Edit Scheduled Transaction Window is divided into a Name area, Options area, Occurrences area, Recurrence Frequency area, mini calendar and Template Transaction pane.

The Name field is used to enter the name for the scheduled transaction. This will be used in the Description of the transaction.

The Options area contains check-boxes to set if the transaction is automatically created and how many days in advance the transaction is created and/or a reminder posted.

The Occurrences area contains selections to set for dates limits on transactions to be entered or the number of transactions to be entered.

The Recurrence Frequency area contains selections to set how often the transaction is scheduled to be added and on what dates this occurs.

The mini calendar provides a visual indication of what transactions are already scheduled.

The Template Transaction pane allows you to setup the transaction as you would like it to be entered into the register.

These options are described in more detail in

- From the Scheduled Transaction tab selecting a transaction from the list and pressing the Edit or New buttons will bring up the Edit Scheduled Transaction Editor.

## Printing Checks

Checks are printed in &appname; from the account register. &appname; provides the ability to print to several standard Quicken Checks (including US Letter) or to make a custom check format. Check position and Date formats are also customizable.

To print a single check in &appname;, select the transaction to print a check for and go to File Print Checks . This will open the Print Checks properties dialog to print the selected transaction.

To print multiple checks in &appname; execute a search to find the transactions you wish to print. With the search results window as the front window go to File Print Checks . This will open the Print Checks properties dialog to print all the transactions in the search results window.

The Print Checks dialog has two tabs. The first tab, Options, is used to setup the most common options to print a check. The second tab, Custom format, is used to setup the position of various fields on the check. It is useful to print a test check to a plain piece of paper first and use that to make any adjustments needed.

The default selection in Options is for Quicken/Quickbooks (tm) US-Letter checks.

- Check format: Test with Quicken first then use custom if the position is incorrect.

- Check position: This sets if the Top, Middle or Bottom check is printed. Custom is used if the position of the checks on the page is incorrect.

- Date format: The default here is set in the Preferences International section. Choose a date format. This can also be adjusted by the Use of the Months: and Years: lines. Custom allows the date format to be set in the Format: box (%m means month, %d means day, %Y means year) A Sample of the format chosen is displayed below.

- Address: This sets the address of the Payee, if the check format includes a space for it and you are printing a single check.

The Custom format tab has two sections. The top half of the window (above the dividing line) allows you to position the fields in each check. It contains two columns to enter in the X and Y co-ordinates of the field position on the check. Positions in the Custom Check Format entry area are specified with x = 0 at the left edge of the check with x increasing to the right, and y = 0 at the top edge of the check with y increasing as you travel down. (If you are using a version of GTK prior to 2.10, then y = 0 is at the bottom of the page and y increases as you travel up.)

- Payee:

- Date:

- Amount (words):

- Amount (numbers):

- Address:

- Notes:

- Memo:

- Splits Amount:

- Splits Memo:

- Splits Account:

The part of the custom format tab below the dividing line contains fields to position the entire check correctly on the page. The Translation field is the distance from the top left corner and the Rotation field rotates the check clockwise by the indicated amount.

The Units field in the bottom half of the window specifies the units used in all the fields in both halves of the window.

Once OK is pressed on the Print Check dialog the Print &appname; Document dialog is presented. Press OK to print the check.

## Importing Transactions from Files

Imported transactions will generally be to a specific account in your account tree. In the following this will be referred to as the import or base account. It may or may not be specified in the data being imported depending on the import format. It is usually the first split of a transaction being imported.

All transactions will also need to have a destination account for any other splits associated with the tansaction. These may or may not be supplied in the imported data, depending upon the data source and the format of the data. If it is not, &appname; may be able to assign an account on the basis of the previous import history by matching infomation in the imported data to data associated with previous account assignments in the importer. The user may always over-ride this automatic assignment or where no assignment can be made automatically assign an account manually.

Multi-split data exported from &appname; in CSV format will normally have both the import and destination accountsfor transaction splits specified in the data file.

### Import Formats

&appname; allows transactions to be imported in a number of structured formats for the exchange of financial data as well as in the unstructured CSV format, a plain text tabular format commonly used for the import and export of data to and from spreadsheets:

- QIF (.qif) Quicken Interchange format - import data from Quicken financial software;

- OFX/QFX (.ofx,.qfx) Open Financial eXchange format (QXF is an Intuit/Quicken proprietary version of OFX);

- CSV (.csv) Comma Separated Values;

- Others Import with AQBanking supports importing several European and International file formats including:

  - CAMT 052Daily Bank Statements

  - OLYMPIC Banking System ERI

  - Spanish Q45

  - SWIFT MT535, MT940, MT942.Bank Statements

  - Swiss YellowNet XML

Files using these formats do not necessarily use the file extensions shown above.

These import methods can be accessed from the File Import sub-menu entry, along with methods for importing other types of data. Select the appropriate entry from the File Import sub-menu to initiate importing transactions.

### Import Preference

User preferences set in the Import tab or the Online Banking tab of the user preferences accessed by Edit Preferences from the menu will affect the importing of transactions from the files described below.

### Import QIF

To import data from Quicken®, MS Money®, or other programs that use QIF(Quicken® Interchange Format), you must first export your data to a QIF file. One way to do this is to export each account as a separate QIF file. An easier way, available in Quicken® 98 and beyond, is to export all accounts at once into a single QIF file. Check your program's manual to determine if this option is available.

#### To import QIF files:

Select File Import Import QIF... from the menu to open the QIF Import dialog box illustrated below.

The Import QIF Files Assistent

Dialog Navigation

The right hand pane will display some or all of the following navigation buttons:

- Cancel: Exit the dialog;

- Back: Go back to the previous step;

- Next: Proceed to the next step.

The buttons displayed are determined by whether navigation to the destination step is valid from the current step.

Import Dialog Steps

The left hand pane lists the steps in the import dialog process. The right hand pane contains instructions and/or controls for performing the operations in the step selected and highlighted in the left hand pane. The import process steps are:

- Import of QIF files: Initial informational panel. Click Next to proceed;

- Select a QIF file to load: Open a file selection dialog. Navigate to and select the file you wish to import and click Import. Then click Next;

- Load QIF files: Click the Start button to load the file. The file will be parsed and loaded. If errors or warnings occur you may have to remove the file, edit it and reimport it. If there are no errors click Next;

- Set a date format for the file: Select a date format (m-d-y or d-m-y) appropriate to the locale of the source of your QIF file. In the US this is generally m-d-y and in Europe d-m-y;

- Set the default QIF account name: If the QIF file does not specify an account name, enter an account name. If importing data from another accounting program you should use the name used in that program;

- QIF files you have loaded: This step allows you to edit the list of files to be imported and to load additional files. To remove a file, click on the row and then click on Unload selected file. To load another file click the Load another file. When you have all the files you wish to import loaded, click Next;

- Accounts and stock holdings: Information panel. Click Next to proceed;

- Match QIF accounts with &appname; accounts: QIF account names are matched to &appname; accounts if possible. New &appname; accounts are created if no matching accounts are found. For stock, the required account structures are also created. Created accounts are indicated by checking the checkbox in the New column. Assigned accounts may be edited by selecting the appropriate the row and clicking on the Change &appname; Account button to to run the account selection dialog;

- Income and Expense categories: Information panel. Click Next to proceed;

- Match QIF categories to &appname; accounts: QIF categories are matched to &appname; accounts where possible. New &appname; accounts are created where no matching &appname; account is found. Created accounts are indicated by the checkbox in the New column being checked. If you are not sure what changes are needed, it is safe to accept the &appname; account names. These may be changed later in &appname;. Assigned accounts may be edited by selecting the appropriate row and clicking on the Change &appname; Account button to run the account selection dialog;

- Payees and Memos: Information page. Click Next to proceed;

- Match payees/memos to &appname; accounts: QIF payees and memos are matched to &appname; accounts where possible and new accounts are created where this is not possible again indicated by the checkbox in the New column. The assigned account may be changed by selecting a row and clicking on the Change &appname; Account button to to run the account selection dialog;

- Choose the QIF file currency: Select the required currency from the dropdown list and click on Next to continue;

- Tradable commodities: Not yet implemented;

- QIF Import: Click on Start to begin the import. &appname; currently proceeds to the Update your &appname; accounts tab if the import is successful;

- Match existing transactions: Not yet implemented;

- Select possible duplicates: Not yet implemented;

- Update your &appname; accounts: Click Apply to complete the import. Depending upon the size of your file, the import might take a few minutes to complete, so a progress bar displays the percentage finished. When the import process is complete, &appname; will return you to the main window, which should now display the names of the accounts you imported.

  Other features are not currently implemented;

- QIF Import Summary: Click on Close to exit the wizard.

### Import OFX/QFX

File->Import->Import OFX/QFX transactions opens a file selection dialog. Navigate to the file you wish to import, select a file with the appropriate extension (.ofx or .qfx), then press the Import button.

&appname; then opens an Account Selection dialog to select an account in your CoA to match to an account name in the import file. Select the appropriate account from the account tree and press the OK button. On subsequent import of files from the same source account, the mapped &appname; account is remembered and the account selection dialog is not displayed.

The generic import transaction matcher dialog is opened next. See the Import Matcher section (common to both OFX/QFX and CSV import formats) following the Import CSV section to continue the import process.

### Import CSV

Clicking on File->Import->Import Transactions from CSV will bring up the CSV Transaction Import Assistant dialog illustrated below.

The CSV Transaction import Assistant is largely self explanatory with information panes which describe the functionality.

Dialog Navigation

Each pane displays a selction of the following navigation buttons at the bottom right:

- Cancel Exit the CSV Transaction Import Assistant;

- Back Return to the previous step in the assistant;

- Next Proceed to the next step in the assistant.

The buttons displayed are determined by the validity of the traget step from the current step.

CSV Import Process Steps

The steps in the CSV import process are listed in the left hand pane with the current step highlighted. Explanatory text and the widgets to setup and carry out the step are displayed in the right hand pane. The function of the controls in each step is explained below, in the explanatory information in the panes or in tooltips on some controls. The steps in the CSV import process are:

- Introductory information panel

  The CSV Transaction Import Assistant - Introduction

  Click Next to continue;

- Select File for Import: Display the File selection dialog. Navigate to the file you wish to import then click the Next button;

- Import Preview: The Import Preview pane controls set options for the import of CSV data and provides a preview of the data to be imported.

  The CSV Import Preview Pane

  The CSV Import Preview Pane with settings to import the shown data.

  Import preview Controls

  - Load and Save Settings

    The settings group &appname; Export Settings defines a setting group for used for the export and reimport of &appname; transaction data - use this if importing data previously exported from &appname;.

    Save

      Once you have set all the import parameters, you can save these settings by typing a unique name in the Load and Save Settings Entry combo box and clicking the Save icon just to the right of the box.

    Load

      A previously defined settings group can be retrieved by selecting the appropriate setting group name from the dropdown list activated by the down arrow at the right end of the text box. This will set all other settings to the stored values.

    Delete

      The Delete/Trashcan icon to the right of the Save icon can be used to remove the saved settings group selected from the drop down list for the box.

  - Account: If the data you are importing does not specify the source account for the transaction an account can be selected from the drop down list will import all transactions to the selected account. Leave blank if your imported data specifies a source account;

  - File Format:

    - Character-separated: Selecting this radio button will allow you to define characters which will be used to distinguish columns in the input file. The default is comma separated. In countries using the comma as decimal separator the semicolon is common as column separator. However spaces, tabs, colons or semicolons or any combination of them may be used to separate columns in the input file by selecting the appropriate check boxes. You may also define custom separators by typing the required characters into the text box and selecting the Custom checkbox. This may be used in combination with any of the predefined separators;

    - Fixed-Width: Selecting this radio button will allow you to define column boundaries by double clicking at the appropriate positions in the sample records displayed in the panel below. Single clicking in a column will narrow, widen or merge the column.

  - Multi-split: Selecting this check box allows the splits for a single transaction to be defined on consecutive lines within the file with each line defining a single split. If not selected each line is assumed to contain the information for a single transaction including one or two splits;

    Multi-split is a gnucash specific variant of a csv file to support easier data preparation.

    Each line should define one split by

    transaction-specific fields

      date and description as bare minimum and

    split specific fields

      account and deposit/withdrawal as bare minimum.

    There is a convenience feature built-in so you don't have to repeat the transaction fields if the split belongs to the same transaction as the previous one (though you can repeat them if that makes csv preparation easier).

    Sample Multi-split.csv

        Date,Description,Deposit,Account
        05/03/2006,Grocery Store,-45.21,Assets:Checking
        ,,45.21,Expenses:Groceries
        14/03/2006,Employers R Us,670.00,Assets:Checking
        ,,180.00,Expenses:Taxes:Federal
        ,,90.00,Expenses:Taxes:Medicare
        ,,60.00,Expenses:Taxes:Social Security
        ,,-1000.00,Income:Salary

  - Miscellaneous: The miscellaneous settings allow you to set:

    - Encoding: This is usually UTF-8, but may differ for files from other sources;

    - Date Format: This does not default to the Locale setting so check it matches the data you are importing;

    - Currency Format: Select the format of the decimal separator (full stop or comma or other) for the currency if the correct value is not supplied by Locale;

    - Leading Lines to Skip: Select the number of header lines to skip in the imported file;

      While we only want to import transactions, some banks send additional informations like a fieldname header or account status information as header or footer.

    - Trailing Lines to Skip: Select the number of trailing lines to skip in the import file;

    - Skip alternate lines: Use to skip every second line in the import file.

    to match the settings for the file you are importing. Tooltips may also contain information on the setting and options.

  The import panel shows the data being imported as it is interpreted using the settings chosen to define columns and formats. The dropdown lists in the headers for each column of the import allow you to associate a specific column in the imported data with a specific field in the display of a transaction in an account register. At a minimum to import data, columns in the imported data containing the following information must be specified:

  - Date: of transaction;

  - Account: into which transaction is to be imported (or alternatively set the base account as above);

  - Description: of the transaction;

  - Deposit or Withdrawal: column.

  The dropdown list of &appname; transaction data fields which may be associated with a column of the imported data contains the following:

  - None: The column is not assigned to a transaction data field and is not imported;

  - Date: Ensure the date format in the column matches the Miscellaneous date Format Setting;

  - Num: Transaction Num field - Use for check numbers etc.;

  - Description;

  - Notes;

  - Transaction Commodity;

  - Void Reason;

  - Action;

  - Account: This header should be matched to a column specifying the source account for a transaction if it is present. Otherwise, set the source account in the Account combo box;

  - Deposit: Apply this header to a column containing the amount of the transaction. Positive amounts in the column generally represent an increase in the account balance and negative amounts a decrease in the balance (asset accounts: Checking, Savings). In external statements supplied by a bank for a check or savings account, a credit (Cr) is normally an increase in the account balance and a debit (Dr) a decrease in the account balance. In the banks eyes, your savings or checking account is a Liability to them;

    If the amount data is in separate columns for debits and credits you will have to apply both this heading and the Withdrawal heading.

  - Withdrawal: Apply this header to a column with the amount of the transaction where positive amounts in the column represent a decrease in the account balance and negative amounts an increase in the balance (e.g. Liability account: credit card).

    Where separate columns are used for debits and credit to the account apply it to the opposite to the column to which Deposits is applied;

    Some experimentation may be necessary to determine the correct allocation of the Deposit and Withdrawal headings.

  - Price: The price for commodity transactions and/or transactions involving currency exchange;

  - Memo: Additional column containing descriptive information relevant to one split of a transaction. If in the first line of a multi-split import it will apply to the source account. In subsequent lines/splits it is applied to the transfer account defined in that line or allocated to it in the matcher;

  - Reconciled: Apply to a column indicating the reconciliation status of the transaction. This generally only applies to data exported from &appname;;

  - Reconcile Date: Apply to a column which specifies the date of reconciliation, generally only for &appname; exported data;

  - Transfer Action;

  - Transfer Account: This header should be applied to a column which specifies the transfer account for the second split of a single line import and/or for subsequent splits in multiline exported transactions;

  - Transfer Memo: Apply to a column with descriptive information relevant to a split to a transfer account specified by Transfer Account;

  - Transfer Reconciled: Apply to a column with reconciliation status information relevant to a split to a transfer account specified by Transfer Account;

  - Transfer Reconcile Date: Apply to a column containing a reconciliation date relevant to a split to a transfer account previously specified in Transfer Account.

  The Skip Errors check box will skip trying to import any rows with errors in matching the columns.

  When you are happy with all the import settings, save them if you will use the same settings again, then press the Next button.

- Match Import and &appname; accounts: This window allows you to map the accounts identified in the account columns (Account and Transfer Account) with accounts in the &appname; account tree (Account name). Double click on a row to bring up a dialog to select the matching &appname; account. If you have previously imported transactions to this account and account mappings can be matched automatically, this window will not be displayed. When you have selected a match for all accounts, click on the Next button;

- Transaction Information: The Transaction Information panel allows review of data entry settings so far. Clicking Next will perform checks on the data. If there are errors you will be returned to the Import Preview pane to edit the settings. For no errors you proceed to the next step;

- Match Transactions: Clicking on Match Transactions will then bring up the main Import Matcher window. The Import Matcher is described in a separate section;

- Import Summary: &appname; displays a summary of the imported data. Click on the Close to exit the wizard.

Multi-split imports of multicurrency transactions and commodity transactions are experimental and may currently experience some errors. Please experiment and report any bugs encountered.

### Import several file formats with AQBanking

If &app; was built with &app-aqb; support and you have &app-aqb; installed on your computer you may use Import using AQBanking to import files in several formats.

You will first be presented with a dialog box having two lists. The left one lists importer plugins and the right one lists file format profiles available for that importer. In some cases, for example swift, the profiles include specialized formats for particular bank: Continuing the example the swift importer can import both generic MT940 and MT942 statements and those specialized for the Netherlands's AMRO Bank.

Select an importer and a profile from the lists. &app; will remember your selection for the next time you do an import.

Click OK to proceed to the filechooser. Select a file to import and click the Import button to proceed.

&appname; will process the selected file and map the account description in the import file onto the selected account and use it for future imports from the same account. The imported transactions will then be displayed in the Generic Import Transaction Matcher for review.

### Generic Transaction Import Matcher

#### Introduction

The Generic Transaction Import Matcher Window

This is an image of the import transaction matcher window after opening a file to import.

The Import Matcher checks whether an imported transaction matches an existing transaction already recorded in &appname; within a predefined time window (~+_42 days) for the account into which the transactions are being imported. A match probablity is calculated based on the Date, Amount, Transaction ID's (if present), Check numbers (if present) and the Description and split Memo fields. Exact matches will generate a high match probability and flag a transaction as matching an existing transaction and therefore not to be imported. If there is a lower quality match to an existing transaction, the imported transaction may be flagged for updating of non-matching information in the &appname; record of the matching transaction. These decisions can be overridden by the user.

If no matching transaction can be identified the transaction will be flagged for import. The matcher will attempt to assign a transfer account based on matches between tokenized information for previously imported transactions stored in lists associated with the transfer accounts which were assigned to them on import.

- If a good match is obtained, the transfer account is assigned and the transaction is flagged as ready to import.

- If a transfer account cannot be assigned, the transaction will be flagged for import and manual assignment of the transfer account by the user. By default, if no transfer account is assigned, transactions will be assigned to an Imbalance account on import. This is to indicate that they need an appropriate account assigned to them.

#### Import Formats

The generic import transaction matcher is invoked when transaction data is imported using any of the following import formats:

- QIF;

- OFX/QXF;

- CSV;

- MT940;

- MT942;

- DTAUS.

#### Controls

##### List of Controls

This window has the following

Controls:

- List of downloaded transactions: Table containing information from the imported transactions.

- Show Account column: Checkbox to display the account into which the transactions are being imported. This is the second column labelled Account in the screenshot;

- Show Memo column: Checkbox to display the Memo from the imported transactions after the column labelled Description;

- Show matched information: Checkbox to display the matched transaction which has been already imported or entered into &appname;. If there is one, this will be a line with a white background (by default) after the imported transaction. This is either the manually selected match if one has been selected or the best possible match otherwise;

- Append: Checkbox to indicate that when updating and clearing a matched transaction, the imported Description and Notes are to be appended to the matched transaction Description and Notes respectively, rather than overwriting them. When the OK button is clicked, the state of the checkbox is saved so the next import for that account will automatically default it to the saved state;

- Reconcile after match: Checkbox to automatically start the reconciliation process after transactions have been matched and imported;

- Help: Display a popup help window;

- Cancel: Close this window without importing transaction data;

- OK: Close this window importing transaction data;

##### List of downloaded transactions

The List of downloaded transactions has the following columns which display the following information for each of the downloaded transactions:

Columns in List of Downloaded Transactions

- Date - The date supplied with the downloaded transaction;

- Account - The import or base account to which the transactions will be imported (optional see above);

- Amount - The amount of the transaction (split to the import or base account);

- Description - The description of the transaction;

- Memo - The memo for the split to the import or base account of the transaction (optional see above);

- A - Add - Checkbox which indicates that the transaction is to be imported as a new transaction;

- U+C - Update and Clear - Checkbox which indicates that the transaction matches an existing transaction but has some differences and the existing transaction will be updated with the different information;

- C - Clear - Checkbox which indicates that the transaction matches an existing transaction and will not be imported;

- Info - For transactions which have been matched to an existing transaction, this column displays a bar indicating the quality of the match;

- Additional Comments - Shows what is to happen to the transaction and the transfer account if known;

##### Import Status

In addition to the checkboxes, the import status of each transaction is indicated by the background color of the transaction row. The checkbox state, background colors and their meaning are described in .

Import Status of Transactions

Checked Box | Background | Meaning
--- | --- | ---
A | &color-intervention-probably-required; Gold | &color-intervention-probably-required; No matches, flagged for input and no transfer account matched – Import as a new transaction. Intervention required to select a transfer account.
&color-intervention-not-required; Green | &color-intervention-not-required; No matches detected, flagged for input and a transfer account is matched – Import as a new transaction. Reconciliation status will be set as cleared (c) on import. Intervention is not required.
U+C | &color-intervention-not-required; Green | &color-intervention-not-required; Matches an existing transaction but not exactly on date and/or amount – Intervention not required, import and update. Reconciliation status will be set as cleared (c) on import.
C | &color-intervention-not-required; Green | &color-intervention-not-required; Matches an existing transaction: – Not to be imported. The existing transaction reconciliation status will be as cleared (c) on import. Intervention is not required
| &color-intervention-required; Brown | &color-intervention-required; Transaction has poor matches and no action was set: – Not to be imported. Intervention required.
| &color-row-selected; Blue | &color-row-selected; Row is selected

The colors illustrated here are the defaults for &appname; specified in gnucash-fallback.css. You may experience different colors if the gtk-3.0 CSS files have been modified

You may always intervene manually to

- change the import action by selecting another checkbox (or none) and/or

- manually assign a different transfer account

after reviewing the matched transactions and accounts and the automatically selected actions.

Multi row selection is enabled for the list of downloaded transactions. The following operations can be performed on the list of downloaded transactions:

- Click Button1 (see Mouse Buttons) on a row: Select this row (row is displayed with a blue background);

- Double-click Button1 on a row: If the transactions is flagged for import (see below) this will open an account selection dialog to select a destination/transfer account to be used in the second split of the imported transaction. You may create a new account if necessary in this dialog using the New Account button. If the transaction is flagged as matching an existing transaction either for import or updating, the match picker dialog is opened to allow the matched transactions to be examined and a correct match selected;

- Ctrl Button1 on a row: Add the row to a selection of rows (displayed with a blue background) to which a single destination/transfer account may be applied;

- Shift Button1 on a row: Select all rows between the last selected row and this row and add them to the current selection of rows;

- Click Button2 in the window: Display a popup menu which when clicked in turn opens a dialog to select a single destination/transfer account which will be applied to all rows currently selected.

It is important to assign a transfer account to each transaction prior to import of the transactions. Otherwise the tokenized information from the imported transaction will not be appended to the list of tokens for an assigned account for use in future matching of transactions to transfer accounts.

Note that "reconciled" in this context does not mean the same as "reconciled" in the process of reconciling an account to an external statement. The reconciliation status of an imported transaction is set to cleared (c) on import of a new transaction. See Setting the reconcile status (R field) of a transaction for details of the values of reconciliation status.

Where a row has been matched to an existing transaction or is to update an existing transaction it will have a DarkSeaGreen background. Double-clicking Button1 on the row will bring up the Match Picker dialog which displays detail of the imported. If you, feel the wrong transfer account has been assigned or the matcher has not produced a valid result, you may change the checkbox selection if you disagree with the matcher decisions and you may reassign an assigned transfer account (see below).

Double-clicking Button1 on a row marked as New with a DarkSeaGreen1 background and a transfer account assigned to it will bring up the account selection dialog to allow you to choose a different transfer account for the second split.

Double-clicking Button1 on a row marked New with no transfer account matched with a Gold background will also bring up the account selection dialog to allow you to assign a suitable transfer account to the transaction.

#### Assign a Destination Account to a Single Transaction

Select the required row by clicking Button1 on it. It is displayed with a Blue background color.

Double clicking Button1 on a row will select it and open an Account Selection dialog to allow you to assign a transfer account. Select the desired transfer account in the dialog and click OK. The dialog has a New Account button which will allow you to create a suitable account if there is no existing account which can be applied as the transfer account.The row background will change to a Green and the assigned destination account will be displayed in the Info column.

or alternatively, Button1 click on a row to select it followed by a Button2 click to bring up a popup menu then select Assign a transfer account to display the Account Selection dialog, select the destination account and click the OK button.

#### Assign a Destination Account to Multiple Transactions

Sometimes you will have several transactions which can have the same destination account. &appname; allows you to select multiple transactions and apply the same destination account to all transactions in the selection.

Rows in a selection are displayed with a Blue background.

Only rows which have the A checkbox checked and either a Green or Gold background colour can be selected for inclusion in a multiple selection. Rows with a Brown background or with the U+C or C checkboxes checked cannot be selected in a multiple selection.

To select rows and add rows to a selection either:

- Click Button1 on first row and then Ctrl Button1 on other rows to add to the selection; or

- Click Button1 on first row and then Shift Button1 on another row to select all rows between them.

- Rubber banding is also enabled so you may also hold Button1 and drag over rows to create a selection. To add more rows, Ctrl Button1 and drag over more rows.

then Button2 to display a popup menu and then select Assign a transfer account to open the Account Selection dialog. Select the desired destination account (create a new account if necessary) and click the OK button in the Account Selection dialog.

#### Completing the Import

Once you have assigned destination accounts for all the imported transactions using the above methods (all row backgrounds will be a light green colour), check that the assigned destination acounts are correct and then press the OK button at the bottom of . The transactions selected for import will have their splits added to the selected source and destination accounts.

The tokenized data from the transactions assigned to a given transfer account is stored on exiting from the matcher and is used to match transactions to the appropriate transfer account in future imports.

### Match Picker

The Match Picker allows you to review and edit existing &appname; transactions which have been matched to a transaction being imported. Button1 on a row with the C checkbox checked to bring this dialog up.

The Match Picker Dialog

The Match Picker dialog window showing existing &appname; transactions matching an imported transaction.

The top pane of the Match Picker displays details of the first split of the transaction to be imported. The column labels:

- Account

- Date

- Amount

- Description

- Memo

- Balanced

are the same and have the same meaning as in with the exception of the Balanced column which gives the amount of the balancing split for the transaction.

The lower pane displays the details of existing &appname; transactions which match this transaction. If no transactions are displayed check the Show Reconciled checkbox at the bottom of the panel. The first row in this pane will normally be the auto-matched transaction with the best match score. Other rows will display other existing transactions which might also be matches for the transaction being imported. The columns in this pane are:

- Confidence: This column indicateds the confidence of the individual match as both a bar chart and a numerical value. Where the bar extends into the green, the match is good. If the bar only extend to the red or yellow setions the quality of match is more doubtful.

- Date

- Amount: If this does not match exactly the amount of the transaction being imported but otherwise the match is good, the amount of the imported transactions is used to update the existing transaction matching it.

- Description

- Memo

- Reconciled: Indicates the reconciliation status of a matching existing transaction.

- Pending Action

If you are not happy with the existing transaction that was auto-matched, Button1 on your preferred match to select it and then Button1 the OK. The transaction will then be marked as a (manual) match in the Info column of the Import Matcher. To exit the dialog without changing the auto-match Button1 on the Cancel.

### Import Match Editor

The Import Match Editor allows you to edit the data used by &appname; to automatically assign a transfer account in the Import Matcher. It can be used to edit the data used by the Bayesian matcher, the Non-Bayesian matcher and online ID's. To open it select Tools->Import Map Editor from the menu.

The Import Map Editor

The Import Map Editor illustrating typical entries for the Bayesian matcher.

The three radio buttons at the top of the dialog select the type of data being displayed and edited:

- Bayesian: The Bayesian matcher matches a transfer or destination account using the frequency of association of a token string with an assigned transfer/destination account in the Import matcher for a specific source account (the account that the first split of the imported transactionis directed to);

- Non-Bayesian: The Non Bayesian matcher matches the transfer account on the basis of the occurrence of a token string in transactions assigned to a transfer/destination account and does not record the frequency of association. This was the original &appname; matching process and has now been superceeded by the Bayesian matcher in more recent versions;

- OnlineiD: Online ids are specific strings which identify specific accounts in information downloaded from online sources. they may include account numbers and specific instiution identifiers.

The Bayesian matcher data columns are:

- Source Account: This is the account into which a transaction has been imported and is normally the first split in an imported record. It may either be specified in the record itself or during the import setup for all transactions to be imported. The arrow control at the left of each entry in this column may be used to display all the data used in matching a transfer or destination account for transactions which have this account as their source split;

- Match String: This column displays a specific token string that has been associated with the allocation of the account in the Mapped to Account Name column as a transfer/destination account for transfers to the Source Account;

- Mapped to Account Name: The account name in this column is a &appname; account name which has been allocated as a transfer/destination account in association with the token string in the Match String column;

- Count of Match String Usage: This is the number of times the token string in the Match String column has occurred in association with the transfer/destination account specified in the Mapped to Account Name column for transactions imported to &appname;.

The Non-Bayesian matcher displays the same first three columns as the Bayesian matcher having the same usage. It does not store data on the frequency with which a particular token is associated with the assignement of a given transfer/destination account. It has an additional column which specifies the type of the imported data process in which the assignment occurred.It has the following columns:

- Source Account;

- Based on: This identifies the import process in which the Match String was associated with the transfer destination account in the Mapped to Account Name column;

- Match String;

- Mapped to Account Name.

Online ID displays the same columns with the same data as the Non-Bayesian matcher.

The Filter textbox at the bottom of the dialog allows filtering of the displayed data matching the entered string in either the Match String column or the Mapped to Account Name column.

The Expand All and Collapse All buttons expand or collapse the data in the other columns for the accounts in the Source Account column.

The Delete button will delete any selected rows in the displayed matcher data.

The Close button closes the Import Match Editor dialog.

## Exporting Transactions

&appname; allows transaction data to be exported in CSV format with the optional use of alternative column separators. Transactions can be exported in either a single line format (simple layout) which can only be used for transactions with two splits and may not allow all the data associated with a transaction to be exported or in a multiline format where two or more lines are used for transactions with two or more splits with each splits information on separate lines. Transaction data can be exported either from the currently selected active register or from selected accounts. The menu commands to export transactions are:

- File->Export->Export Transactions to CSV;

- File->Export->Export Active Register to CSV.

These commands start the wizard illustrated in to setup the export. They differ only in that in the latter case the Account Selection step is not available in the left hand pane.

The Export Transactions Wizard.

The Export transaction wizard opens at the first step and performs the steps listed in the left hand pane:

- Choose Export Settings;

- Account Selection;

- Choose File Name for export;

- Export Now...;

- Export Summary.

Navigation between the steps uses the buttons displayed in the right hand lower corner of the wizard. Which of the following buttons are displayed will depend on what is permissible from the step:

- Cancel: Exit the wizard without exporting any transactions;

- Back: Return to the previous step in the wizard;

- Next: Proceed to the next step.

### Choose Export Settings

This step allows you to choose various options in the formattig of the transactions being exported.

The Options checkboxes may be selected singly or both may be selected together:

- Quotes: Surround each data field in quotes;

- Simple layout: If checked, the ouput transaction data will be as displayed in the single row register view option and some of the transfer detail may be lost.

  The column headers for data exported in Simple layout format are:

  1. Date

  2. Account Name: name of the source account;

  3. Number

  4. Description

  5. Full Category Path: full account name for transfer/destination account;

  6. Reconcile

  7. Amount with Sym

  8. Amount NUm

  9. Rate/Price

  If Simple layout is not checked the transaction data will be exported in a multi-line format.

  The column headers for a multiline output for a transaction are:

  1. Date: first line only;

  2. Transaction ID: first line only;

  3. Number: first line only;

  4. Description: first line only

  5. Notes: first line only;

  6. Commodity/Currency: first line only;

  7. Void Reason: first line only;

  8. Action: first line and subsequent lines;

  9. Memo: first line and subsequent lines;

  10. Full Account Name: first line and subsequent lines;

  11. Account Name: first line and subsequent lines;

  12. Amount with SYm: first line and subsequent lines;

  13. Amount Num: first line and subsequent lines;

  14. Reconcile: first line and subsequent lines;

  15. Reconcile Date: first line and subsequent lines;

  16. Rate/Price: first line and subsequent lines;

  Each line contains the data relevant to a single split with the first line also having transaction data relevant to all splits in the first 7 columns.

The Separators radio buttons allow the choice of an alternative column separator:

- Comma(,): This is the default separator;

- Colon(:): Use a colon to separate the columns;

- Semicolon(;): Use a semicolon to separate the columns;

- Custom: Define a custom character to separate the columns by entering it in the textbox.

Button1 on Next to go to the next step.

### Account Selection

This step allows selection of one or more accounts and the specification of the date range containing the transactions to be exported.

The Accounts panel displays an account tree which allows one or more accounts to be selected for export. ( Ctrl Button1> and Shift Button1 may be used to select accounts). The Select Subaccounts button will select all subaccounts of a selected account. The Select All button will select all accounts in the account tree for export. The number of accounts which have been selected is indicated.

The Dates panel allows selection of either all transactions or only those within a selected date range in the selected accounts to be exported.

### Choose File Name for export

A file selection dialog is presented allowing specification of a file name and a path to the directory/folder in which it is to be stored.

### Export Now...

The filename and path of the file to be exported and the number of accounts to be exported is displayed. To continue with the export Button1 the Apply button.

### Export Summary

Displays a message if the file is successfully exported or an error message and debugging suggections if not.

## Online Actions ...

For each account on which you want to execute this actions you will have to run the once.

This section is "under construction - any input will be welcome !!".

### Get Balance

### Get Transactions ...

### Issue Transaction

### Direct Debit

## General Journal

The General Journal is an advanced register used to enter transactions without needing to open individual accounts. The General Journal shows the transaction entries for all accounts on one register.

Entering transactions in the General Journal is more complicated than entering them in the individual account registers. The advantage is the General Journal provides a more comprehensive view of the transactions you have entered in all your accounts.

The General Journal defaults to showing only the previous month of transactions. This is changeable by using the "Filter By..." on the View menu.