# Einrichtung der Kursaktualisierung

Wenn Sie mehr als ein paar Devisen und Wertpapiere besitzen, werden Sie es vielleicht bald leid sein, die Kurse ständig per Hand aktualisieren zu müssen. &app; bietet Ihnen die Möglichkeit, automatisch den aktuellsten Kurs für Ihre Devisen und Wertpapiere über das Internet herunterzuladen. Hierfür wird das &app-perl;-Modul &app-fq; verwendet.

## Die Vorraussetzungen für eine Online-Kursabfrage mit &app-fq; sind

- ein &app-perl; Interpreter und

- das &app-perl;-Module &app-fq; mit allen Abhängigkeiten.

Wenn Sie bei der Durchführung der hier beschriebenen Schritte nicht mehr weiterwissen, können Sie auf den unter more_help genannten Kanäle viele hilfsbereiten Anwender erreichen.

Sie können diesen Schritt auch weglassen und Ihre Aktienkurse weiterhin manuell aktualisieren.

## Installieren von &app-perl;

Die Installation von &app-perl; ist im wesentlichen von dem verwendeten Betriebssystem abhängig. Der Aufwand zur Installation ist gering und wird in diesem Abschnitt beschrieben.

Um zu überprüfen ob auf Ihrem System &app-perl; schon bereits installiert ist, rufen Sie den Befehl

    perl -v

im Terminal auf. Wird Ihnen die Versionsnummer des &app-perl;-Interpreters angezeigt, dann machen Sie mit finance-quote-install weiter.

## Unter &lin;

1. Bei den meisten Systemen ist &app-perl; wahrscheinlich bereits installiert. Wird mit dem vorherigen Befehl keine Version angezeigt wird, dann verwenden Sie am einfachsten die Paketverwaltung Ihres Systems zur Installation.

2. Verwenden Sie das &app; &flatpak; Paket sind &app-perl; und &app-fq; bereits funktionsfähig installiert.

## Unter &mac;

1. &app-perl; ist unter &mac; normalerweise schon eingerichtet.

## Unter &win;

1. Unter &win; führen Sie das Programm Start &appname; Online-Preisabfrage installieren aus. Dies wird Strawberry Perl installieren.

   &app; Version 2.2.6 und früher benötigen ActivePerl in Version 5.8.

   &app; Version 2.4 und früher benötigen ActivePerl ab Version 5.16.3.

2. Zu Ausführung beötigen Sie Administratorenrechte, die im Dialog abgefragt werden. Die Installation kann mehr als 15 Minuten dauern.

3. Werden während der Installation die Fehlermeldung `No such file or directory` oder `permission denied` angezeigt, dann kann es helfen das Antivirenprogramm vorübergehend zu deaktiviern.

## Installieren von &app-fq;

Um festzustellen, ob das &app-perl;-Modul &app-fq; bereits auf Ihrem System installiert ist, geben Sie `perldoc Finance::Quote` in einem Terminalfenster ein. Wird Ihnen jetzt eine Dokumentation in dieser Form

    NAME
        Finance::Quote - Get stock and mutual fund quotes from various exchanges

    SYNOPSIS
           [...]

angezeigt, dann ist &app-fq; installiert und Sie können, wie in finance-quote-scheduler beschrieben, den automatisierten Kursabruf konfigurieren. Wenn nicht, dann gibt Ihnen dieser Abschnitt eine Anleitung zur Installation.

Die Installation von &app-fq; unterscheidet sich von einem Betriebssystem zum anderen. Für die verschiedenen unterstützten Systeme, können Sie die folgenden Anweisungen befolgen:

## Unter &lin;

1. Beenden Sie &app;.

2. Führen Sie den Befehl `gnc-fq-check` aus, um zu überprüfen, ob das Programm bereits in einem Verzeichnis liegt, welches in der Umgebungsvariable PATH eingetragen ist.

   Wenn Sie die von Ihrer Distribution bereitgestellten &app; Pakete installiert haben, sollte `gnc-fq-check` bereits in Ihrem PATH sein. Die Aktualität ihrer Distribution können Sie unter &app-fq;- Versionen nachlesen.

   Wenn `gnc-fq-check` nicht in Ihrem PATH ist, vielleicht weil Sie die Anwendung selbst gebaut und dabei ungewöhnliche Pfade verwendet haben, suchen Sie den Ordner in dem &app; installiert ist, z.B. mit dem Befehl `which gnc-fq-check`, und wechseln in dieses Verzeichnis. Es bietet sich an, das aktuelle Verzeichnis in der PATH-Umgebungsvariable aufzunehmen. Hierzu informieren Sie sich bitte in den Unterlagen zu Ihrer Distribution.

3. Als nächstes aktualisieren Sie mit `sudo gnc-fq-update` oder `su -c gnc-fq-update` mit Root-Rechten &app-fq;. Die richtige Syntax ist von der jeweiligen Distribution abhängig.

   Dadurch wird ein internes &app-perl; CPAN

   Siehe CPAN Frequently Asked Questions für weitere Informationen.

   Modul gestartet um die Installation vorzunehmen. Wenn Sie das CPAN zum ersten Mal starten, müssen Sie es einrichten und konfigurieren. Auf den meisten Systemen können Sie jedoch die Standardvorgaben akzeptieren und die erste Frage `Are you ready for manual configuration? [yes]` mit `no` beantworten damit &app-fq; erfolgreich installiert wird.

4. Führen Sie `gnc-fq-check` aus, um zu prüfen, ob &app-fq; richtig installiert ist. Wenn dies so ist, dann werden die Versionsnummer sowie die von &app-fq; verwendbaren Quellen für eine Kursabfrage aufgelistet. Bei Problemen mit der Installation von &app-fq; wird eventuell eine Lösung vorgeschlagen.

## Unter &mac;

1. Beenden Sie &app;.

2. Installieren Sie XCode, falls noch nicht geschehen.

   XCode ist ein optionales Element auf Ihrer &mac; Distributions-DVD.

3. Führen Sie die Anwendung Update Finance Quote im &app; dmg aus.

   Sie können es von der dmg ausführen oder in denselben Ordner kopieren, in den Sie &app; kopiert haben. Es öffnet sich ein Terminalfenster und führt ein Skript für Sie aus, das Ihnen eine Reihe von Fragen stellt. Akzeptieren Sie bei jeder Frage die Vorgabe, es sei denn, Sie wissen, was Sie tun.

## Unter &win;

1. Beenden Sie &app;.

2. Führen Sie Start &appname; Online-Preisabfrage installieren aus. Dies ist ein kleines Hilfsprogramm, das &app-fq; für Sie installiert.

## Automatisierte Abfrage von Kursen

Mit dem Kommando `gnucash-cli --quotes get &user-datafile;`

Der Befehl für den Online-Kursabruf wurde ab &app; 4.0 geändert. Der alte Befehl `gnucash --add-price-quotes &user-datafile;` ist immer noch verfügbar, aber er ist veraltet und wird in einer zukünftigen Version entfernt werden. Wenn Sie ein Upgrade von &app; 3.11 oder einer früheren Version durchgeführt haben, wird empfohlen, den neuen Befehl `gnucash-cli` zu verwenden.

können Sie die aktuellen Kurse Ihrer Devisen und Wertpapiere abrufen und direkt in ihre &app;-Datendatei schreiben ohne die Benutzeroberfläche zu starten. Somit ist eine automatische, regelmäßige Aktualisierung der Kursdatenbank möglich.

Beachten Sie bitte, dass die Datendatei nicht gleichzeitig in einer anderen Instanz von &app; geöffnet sein darf!

Die angegebene Datei &user-datafile; ist abhängig von dem Namen und dem Speicherort Ihrer Datendatei. Dies lässt sich anhand des Namens feststellen, der im oberen Rahmen des &app; Fensters vor dem - angezeigt wird.

Der Dateiname ist auch in der Liste der zuletzt geöffneten Dateien im Datei-Menü zu finden. Wenn Sie den Mauszeiger über dem Menüeintrag mit der Nummer 1 in der Liste der zuletzt geöffneten Dateien platzieren, wird in der Statusleiste die vollständige Dateibezeichnung angezeigt.

Sie müssen den Befehl `gnucash-cli` bei einem Scheduler (Zeitplaner) eintragen, um die Onlinekurse automatisch und regelmäßig zu erhalten. Die Methode hängt von Ihrem Betriebssystem ab.

### Automatischer Kursabruf jeden Freitag um 16:00 Uhr

### Unter &lin; und &mac;

Eintragen des Befehls zum Kursabruf per `gnucash-cli` mittels cron.

1. Führen Sie das Kommando `crontab -e` aus.

2. Fügen Sie die folgende Zeile in Ihre crontab ein:

       0 16 * * 5 gnucash-cli --quotes get &user-datafile; > /dev/null 2>&1

   Läuft auf Ihrem Rechner zu dem Zeitpunkt des Kursabrufs keine graphische Benutzeroberfläche, die bereits den dbus gestartet hat, so müssen Sie den Eintrag stattdessen wie folgt vornehmen:

       0 16 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EXIT;
       gnucash-cli --quotes get &user-datafile; > /dev/null 2>&1

   (Die Zeilenumbrüche nicht in die crontab übernehmen, die wurden hier nur zum Zwecke der Lesbarkeit eingefügt.)

### Unter &win;

Anlegen des Kursabrufs per `gnucash-cli` mit der Aufgabenplanung.

1. Wählen Sie Start Systemsteuerung Aufgabenplanung .

2. Klicken Sie auf Aufgabe erstellen.

3. Geben Sie die entsprechenden Angaben im Fenster Aufgabe erstellen ein.

Passen Sie die Zeit an den Börsenschluss an und bedenken Sie, dass bei Fondskursen das Netto-Anlagevermögen (NAV) deutlich nach Börsenschluss ermittlet wird. Eine Beschreibung zu den Typen finden Sie unter tool-price.

Einige Benutzer haben im &app; Wiki unter Aktienhandel und ausführlicher im englischsprachigen Wiki Online Quotes Page on GnuCash Wiki ihre Erfahrungen und weiter Ergänzungen zusammengestellt.