Difference between revisions of "Online Quotes"

From GnuCash
Jump to: navigation, search
(1. section header requirements; 2. update doc link to svn)
(Add pointers to documentation, removed from Quote when I turned it into a redirect to here.)
Line 31: Line 31:
  
 
''Note: This has been documented in [https://bugzilla.gnome.org/show_bug.cgi?id=639776 Bug #639776] ''
 
''Note: This has been documented in [https://bugzilla.gnome.org/show_bug.cgi?id=639776 Bug #639776] ''
 +
 +
== Documentation ==
 +
* [http://www.gnucash.org/docs/v2.4/C/gnucash-help/tool-security-edit.html#invest-stockprice-online3 2.4 Manual]
 +
* [http://code.gnucash.org/docs/help/tool-security-edit.html#invest-stockprice-online3 Development Snapshot]
 +
* [http://www.gnucash.org/docs/v2.2/C/gnucash-help/tool-security-edit.html#invest-stockprice-online3 2.2 Manual]

Revision as of 17:48, 23 November 2011

Requirements

You need to install several Perl modules in order to get online quotes. While the error message may be about Finance::Quote not being installed properly, that module alone is not sufficient. If it has been installed on your system, the script gnc-fq-update may be used to install the modules needed. That script, as of 2.4.0, uses CPAN to install:

  • LWP
  • Date::Manip
  • HTML::Parser
  • HTML::TableExtract
  • Crypt::SSLeay
  • Finance::Quote

Then read the instructions.

Warning About Open Files

Updating quotes will modify the GNUCash file/database. As multi-user access is not supported (as of 2.4), the file/database should be closed prior to updating quotes.

cron and Non-X Usage

If you attempt to run

gnucash --add-price-quotes /path/to/file.gnucash

without dbus running (for example, from a cron job or ssh without X forwarding), you may get errors such as

GConf Error: Failed to contact configuration server; the most common cause is a missing or misconfigured D-Bus session bus daemon. 
See http://projects.gnome.org/gconf/ for information. 
(Details -  1: Not running within active session)

One resolution for this, courtesy of SyncEvolution - The Missing Link, is to launch dbus for the duration of the quote retrieval with a cron command similar to

env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EXIT; gnucash --add-price-quotes /path/to/file.gnucash'

Note: This has been documented in Bug #639776

Documentation