Difference between revisions of "Custom URI Scheme"

Revision as of 14:43, 16 February 2011

This wiki page discusses the possibility to register some custom URL Scheme so that the online banking functions in GnuCash can be called from a browser.

Links:

• http://people.w3.org/~dom/archives/2005/09/integrating-a-new-uris-scheme-handler-to-gnome-and-firefox/

Here's my target use case: User browses on the gnucash.org/de website. Website contains a link "Click here to donate from your German bank account" where the link target contains our custom URI Scheme (the part usually called the "protocol"):

hbci://de/11111111/22222222?desc=Some%20Description

• "hbci" is our URL Scheme which is unused so far
• "de" refers to the fact we're using the German bank account addressing scheme,
• 1111111 is the bank code of the German bank,
• and 2222222 is the account number.

Once clicked, this URL string needs to be passed to GnuCash, most probably as a command line argument similar to the file://path/filename argument. I'll have to tweak the command line parsing so that my custom schemes are redirected into the online banking module, but that shouldn't be a problem.

Once that URL made it into GnuCash's online banking module, it should look up the preferred online banking account which the user regularly uses, then open the dialog for transferring money. The user just has to insert the amount, then press "Send now", then entering his security numbers, and voila, here the money goes to our gnucash donation bank account.