11.3. Hilfsprogramme zur Symbolsuche und Aktualisierung

Zusammenfassung

GnuCash bietet Hilfsprogramme, die Sie bei der Auswahl der richtigen Symbole und der Verifikation für die gewünschte Online- Kursquelle unterstützen. Ein weiteres Skript führt die erstmalige Installation durch oder bringt Finance::Quote auf den aktuellen Stand. Und letztendlich stehen auch Tools zur Fehleranalyse bereit.

Prozedur 11.7. Perl Skripts unter Windows ausführen

  1. Öffnen Sie ein CMD- oder Powershell -Fenster: Klicken Sie auf Fenster und geben Sie entweder cmd oder powershell ein und wählen Sie den entsprechenden Menüpunkt. Das muss nicht als Administrator ausgeführt werden.

  2. Da, wie zuvor empfohlen, das GnuCash-Verzeichnis in die PATH Umgebungsvariable eingetragen wurde, müssen Sie jetzt nur noch jedem gnc-fq-xxx Perl Skriptbefehl Perl und ein Leerzeichen voranstellen, z.B. perl gnc-fq-check. Andernfalls müssen Sie den Befehl in der Form C:\strawberry-perl\bin\perl.exe C:\Programme (x86)\gnucash\bin\ gnc-fq-check ausführen.

11.3.1. gnc-fq-check

Zusammenfassung

Dieses Programm liefert die Versionsnummer des derzeit installierten Finance::Quote Moduls sowie eine Liste der über Finance::Quote verfügbaren Quellen. Es informiert Sie auch, wenn es ein Problem mit Ihrer Installation gibt und schlägt eventuell eine Lösung vor.

$ gnc-fq-check
Can't locate Mozilla/CA.pm in @INC (you may need to install the Mozilla::CA module)
(@INC contains: /usr/lib/perl5/site_perl/5.30.1/x86_64-linux-thread-multi /usr/
lib/perl5/site_perl/5.30.1 /usr/lib/perl5/vendor_perl/5.30.1/x86_64-linux-thread-multi
/usr/lib/perl5/vendor_perl/5.30.1 /usr/lib/perl5/5.30.1/x86_64-linux-thread-multi
/usr/lib/perl5/5.30.1 /usr/lib/perl5/site_perl)
at /usr/lib/perl5/vendor_perl/5.30.1/Finance/Quote/Tiaacref.pm line 33.
Compilation failed in require at (eval 303) line 1.
BEGIN failed--compilation aborted at (eval 303) line 1.
 at /usr/local/bin/gnc-fq-check line 91.
("1.47" "adig" "aex" "aiahk" "alphavantage" "amfiindia" "asegr" "asia" "asx"
"australia" "bamosz" "bet" "bmonesbittburns" "bourso" "brasil" "bse" "bsero" "canada"
"canadamutual" "citywire" "cominvest" "cse" "deka" "dutch" "dwsfunds" "europe"
"fetch_live_currencies" "fidelity" "fidelity_direct" "fidelityfixed" "financecanada"
"finanzpartner" "finland" "fool" "france" "ftfunds" "ftportfolios" "ftportfolios_direct"
"fundlibrary" "goldmoney" "greece" "hex" "hu" "hufund" "hungary" "hustock" "indiamutual"
"known_currencies" "lerevenu" "maninv" "morningstar" "morningstarjp" "mstaruk" "nasdaq"
"nyse" "nz" "nzx" "platinum" "romania" "seb_funds" "sixfunds" "sixshares"
"stockhousecanada_fund" "tdefunds" "tdwaterhouse" "tiaacref" "tnetuk" "troweprice"
"troweprice_direct" "trustnet" "tsp" "tsx" "uk_unit_trusts" "ukfunds" "unionfunds"
"usa" "usfedbonds" "vanguard" "vwd" "yahoo" "yahoo_asia" "yahoo_australia"
"yahoo_brasil" "yahoo_europe" "yahoo_json" "yahoo_nz" "yahoo_yql" "za" "za_unittrusts")

Der erste Teil ist die Fehlermeldung über ein fehlendes Perl-Modul Mozilla/CA.pm. Am Ende in Klammern steht die normale Ausgabe der aktuell installierten Finance::Quote-Version[23] und eine Liste der verfügbaren Kursdaten-Quellen.

Tipp

Wenn ein Fehler angezeigt wird, lesen Sie den nächsten Abschnitt Abschnitt 11.3.2, „gnc-fq-update“. Ansonsten fahren Sie mit Abschnitt 11.3.3, „gnc-fq-dump“ fort.

11.3.2. gnc-fq-update

Zusammenfassung

Dieses Programm installiert oder aktualisiert das Finance::Quote Softwaremodul und löst bei Bedarf die Abhängigkeiten zu weiteren Softwarepaketen auf.

Anmerkung

Windows-Benutzer sind im Allgemeinen besser beraten, wenn sie das Update-Tool StartGnuCashErweiterung um Kurse mit GnuCash online abzurufen ausführen.

Anmerkung

Dieses Programm erfordert für eine Installation unter Linux oder macOS Superuser- oder Administratorrechte, aber nicht in Windows.

gnc-fq-update startet Perls Standardmodul CPAN [24] um die Installation vorzunehmen. Wenn Sie CPAN zum ersten Mal verwenden, müssen Sie es konfigurieren, wobei Sie auf den meisten Systemen jedoch die Standardvorgaben akzeptieren und die erste Frage Are you ready for manual configuration? [yes] mit no beantworten können, damit Finance::Quote erfolgreich installiert wird.

11.3.3. gnc-fq-dump

Zusammenfassung

Dieses Programm liefert Kursdaten für eine Quelle und eine Liste von Symbolen in einem Format, das für Menschen leicht zu lesen ist. Es ist nützlich, um zu überprüfen, ob eine bestimmte Online-Kursquelle erreichbar ist und funktioniert.

Mit Hilfe diesen Befehls können Sie überprüfen, ob das Symbol/Abkürzung, welches Sie für Ihr Wertpapier zum Online-Kursabruf verwenden möchten, bei der gewünschten Art der Kursabruf-Quelle funktioniert.

Tipp

Mit gnc-fq-dump können Sie Symbole schneller als aus GnuCash heraus überprüfen, wenn während des Abrufs mit GnuCash ein Fehler auftritt. Dies kann Sie davor bewahren, GnuCash mit aktiviertem Debug-Logging laufen zu lassen, während Sie ein nicht funktionierendes Symbol überprüfen.

  • Um ausführliche Inforamtionen zu einem Wertpapier zu erhalten, führen Sie in der Befehlszeile einen Befehl in dieser Form aus:

    gnc-fq-dump [-v] Quelle Symbol...

    zum Beispiel gnc-fq-dump -v yahoo_json IBM.

  • Zum Abrufen eines Wechselkurses führen Sie folgenden Befehl aus: gnc-fq-dump [-v] currency USD EUR [25] [26]

Um zu testen, ob Finance::Quote für Währungen innerhalb von GnuCash funktioniert,

  1. nehmen Sie eine Buchung zwischen dem gewünschtem Handelsgut und der Buchwährung,

  2. machen einen Rechtsklick darauf, und dann

  3. wählen Sie im Kontextmenü die Option Wechselkurs bearbeiten….

Der Buchen Dialog wird angezeigt. Klicken Sie auf die Schaltfläche Wechselkurs abrufen, und wenn alles gut läuft, wird der aktuelle Kurs in das Feld für den Wechselkurs eingetragen.

11.3.4. gnc-fq-helper

Dies ist ein Skript, das GnuCash zum Abrufen von Kursen verwendet und musss normalerweise vom Benutzer nicht verwendet werden. Sollte der Abruf eines Kurses in GnuCash zu einem Fehlverhalten führen, kann mit diesem Skript eine Diagnose durchgeführt werden und hilft Entwicklern bei der Entscheidung, ob der Fehler in GnuCash oder Finance::Quote liegt.



[23] Die neueste Finance::Quote Version ist 1.53.

[24] Siehe CPAN Frequently Asked Questions für weitere Informationen.

[25] Seit Finance::Quote 1.41 ist die Standardquelle für Währungen Alpha Vantage. Lesen Sie auch die Hinweise zu Tabelle A.1, „Währungs-Quelle für Finance::Quote“.

[26] Die alten Yahoo-Währungen sind immer noch verfügbar als gnc-fq-dump yahoo_json USDEUR=X.