<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter SYSTEM "gnc-gui-de.dtd">
<!-- (Do not remove this comment block.)
Version: 1.0.0
Last modified: August 08th 2021

Maintainers:
  xxx
Author:
  TANIGUCHI Yasuaki <yasuakit@gmail.com>
  Christian Wehling <christian.wehling@web.de>
Translators:
  Christian Wehling <christian.wehling@web.de>
-->
<chapter id="finance-quote"
         xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>Einrichten der Kursabfrage</title>

  <abstract>
    <para>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.
    </para>
  </abstract>

  <itemizedlist>
    <title>Die Vorraussetzungen für eine Online-Kursabfrage mit &app-fq; sind</title>

    <listitem>
      <para>ein &app-perl; Interpreter und
      </para>
    </listitem>

    <listitem>
      <para>das &app-perl;-Module &app-fq; mit allen Abhängigkeiten.
      </para>
    </listitem>

    <listitem>
      <para>das &app-perl;-Module JSON::Parse um die Ausgabe von &app-fq; zu steuern.
      </para>
    </listitem>
  </itemizedlist>

  <note>
    <para>Wenn Sie bei der Durchführung der hier beschriebenen Schritte nicht mehr weiterwissen, können Sie
      auf den unter <xref linkend="more_help" /> genannten Kanäle viele hilfsbereiten Anwender
      erreichen.
    </para>
  </note>

  <para>Sie können diesen Schritt auch weglassen und Ihre Kurse weiterhin manuell aktualisieren.
  </para>

  <sect1 id="fq-perl-install">
    <title>Installieren von &app-perl;</title>

    <abstract>
      <para>Abhängig von dem verwendeten Betriebssystem ist der Aufwand für die Installation von &app-perl;
        gering und wird in diesem Abschnitt beschrieben.
      </para>
    </abstract>

    <para>Um zu überprüfen ob &app-perl; bereits auf Ihrem System installiert ist, rufen Sie den Befehl
      <userinput>perl -v</userinput> im Terminal auf.
<!-- Fixme: https://bugs.gnucash.org/show_bug.cgi?id=798618 -->
      <informalexample>
<?dbfo pgwide="1"?>
<screen language="console">$ perl -v
This is perl 5, version 30, subversion 0 (v5.30.0) built for x86_64-linux-gnu-thread-multi
</screen>
      </informalexample>
      Wird Ihnen die Versionsnummer des &app-perl;-Interpreters angezeigt, dann überspringen Sie
      die nächsten Angaben und fahren Sie stattdessen mit <xref linkend="fq-install" /> fort.
    </para>

    <procedure>
      <title>Unter &lin;</title>

      <step>
        <para>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.
        </para>
      </step>

      <step>
        <para>Verwenden Sie das &app; &flatpak; Paket sind &app-perl; und &app-fq; bereits funktionsfähig
          installiert.
        </para>
      </step>
    </procedure>

    <procedure>
      <title>Unter &mac;</title>

      <step>
        <para>&app-perl; ist unter &mac; normalerweise schon eingerichtet.
        </para>
      </step>
    </procedure>

    <procedure>
      <title>Unter &win;</title>

      <step>
        <para>Unter &win; führen Sie das Programm &mc.winOS.inst-fq; aus. Dies wird
          <ulink url="&url-wp-en;Strawberry_Perl">Strawberry Perl</ulink> installieren.
        </para>
      </step>

      <step>
        <para>Zur Ausführung benötigen Sie <emphasis>Administratorenrechte</emphasis>, die im Dialog abgefragt
          werden. Die Installation kann mehr als 15 Minuten dauern.
        </para>
      </step>

      <step>
        <para>Werden während der Installation die Fehlermeldung <computeroutput>No such file or directory
          </computeroutput> oder <computeroutput>permission denied</computeroutput> angezeigt, dann
          kann es helfen das Antivirenprogramm vorübergehend zu deaktiviern.
        </para>
      </step>
    </procedure>

    <tip>
      <para>Es empfiehlt sich anschließend, das Verzeichnis in dem &app; installiert ist, unter &win; z.B.
        <userinput><replaceable>C:\Programme (x86)\gnucash\bin</replaceable></userinput>, zu Ihrer
        <envar>PATH</envar>-Umgebungsvariable hinzuzufügen. Auf diese Weise ist es für Sie
        einfacher, bei Bedarf die <xref linkend="fq-command-line" /> zu nutzen. Hierzu informieren
        Sie sich bitte in den Unterlagen zu Ihrem Betriebssystem.
      </para>
    </tip>
  </sect1>

  <sect1 id="fq-install">
    <title>Installieren von &app-fq;</title>

    <para>Um festzustellen, ob das &app-perl;-Modul &app-fq; bereits auf Ihrem System verfügbar ist, geben
      Sie <userinput>perldoc Finance::Quote</userinput> in einem Terminalfenster ein. Wird Ihnen
      jetzt eine Dokumentation in dieser Form
<!-- Fixme: https://bugs.gnucash.org/show_bug.cgi?id=798618 -->
      <informalexample>
<?dbfo pgwide="1"?>
<screen language="console">
$ perldoc Finance::Quote
NAME
    Finance::Quote - Get stock and mutual fund quotes from various exchanges

SYNOPSIS
    [...]
</screen>
      </informalexample>
      angezeigt, dann ist &app-fq; installiert und Sie können, wie in
      <xref linkend="fq-auto-quote" /> beschrieben, den automatisierten Kursabruf konfigurieren.
      Wenn nicht, dann gibt Ihnen dieser Abschnitt eine Anleitung zur Installation.
    </para>

    <note>
      <title>Erwarteter Zeitaufwand</title>

      <simpara>Abhängig von der Qualität Ihrer Internetverbindung und CPUs kann die erstmalige Installation Ihren
        Computer eine Stunde oder länger beschäftigen.
      </simpara>
    </note>

    <para>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:
    </para>

    <procedure>
      <title>Unter &lin;</title>

      <step>
        <simpara>Beenden Sie &app;.
        </simpara>
      </step>

      <step>
        <simpara>Aktualisieren Sie &app-fq; mit <userinput>sudo gnc-fq-update</userinput>. Der Befehl kann auch für
          eine Neuinstallation verwendet werden. Die richtige Syntax ist von der jeweiligen
          Distribution abhängig.
        </simpara>

        <tip>
          <simpara>Falls das mit der Meldung <computeroutput>sudo: gnc-fq-update: Befehl nicht
            gefunden</computeroutput> fehlschlägt, geben Sie <userinput>which
            gnc-fq-update</userinput> ein. Das sollte einen Pfad wie
            <computeroutput>/usr/local/bin/gnc-fq-update</computeroutput> zuückliefern. Wiederholen
            Sie den Befehl mit jenem zurückgelieferten Pfad: <userinput>sudo
            /usr/local/bin/gnc-fq-update</userinput>.
          </simpara>
        </tip>
      </step>

      <step>
        <simpara>Führen Sie den Befehl <userinput>gnucash-cli --quotes info</userinput> aus, um zu überprüfen, ob
          das Programm bereits in einem Verzeichnis liegt, welches in der Umgebungsvariable
          <envar>PATH</envar> eingetragen ist.
          <footnote>
            <simpara>Wenn Sie die von Ihrer Distribution bereitgestellten &app; Pakete installiert haben, sollte
              &app-cli; bereits in Ihrem <envar>PATH</envar> sein. Die &app-fq; Version, die von
              Ihrem Paketmanager bereitgestellt wird, kann unter
              <ulink url="&url-repo;perl:finance-quote/versions">
              <citetitle>&app-fq;-versions</citetitle></ulink> nachgelesen werden oder mit dem
              info-Befehl der Softwareverwaltung überprüft werden.
            </simpara>
          </footnote>
        </simpara>

        <simpara>Ist &app-fq; richtig installiert ist, dann werden die Versionsnummer sowie die von &app-fq;
          verwendbaren Quellen für eine Kursabfrage aufgelistet. Bei Problemen mit der Installation
          wird eventuell eine Lösung vorgeschlagen.
        </simpara>
      </step>
    </procedure>

    <procedure>
      <title>Unter &mac;</title>

      <note>
        <para>Sie müssen mit einer Benutzerkennung angemeldet sein, die den Mac administrieren kann, um dieses
          Vorgehen anzuwenden.
        </para>
      </note>

      <step>
        <simpara>Beenden Sie &app;.
        </simpara>
      </step>

      <step>
        <simpara>Installieren Sie &app-xcode;
          <footnote>
            <para>Sie können &app-xcode; aus dem App Store installieren oder Sie installieren die viel kleineren
              Xcode-Befehlszeilentools, indem Sie <userinput>sudo xcode-select --install</userinput>
              in einer Terminal.app Eingabeaufforderung ausführen.
            </para>
          </footnote>
          , falls noch nicht geschehen. Es enthält Entwicklungswerkzeuge, die von CPAN benötigt
          werden, um die benötigten &app-fq; Module zu bauen und zu testen.
        </simpara>
      </step>

      <step>
        <simpara>Öffnen Sie ein <application>Finder</application>-Fenster, wählen &gm.macOS.appl; in der
          <emphasis>Seitenleiste</emphasis>, klicken doppelt auf &gmi.macOS.appl.util; in der
          <emphasis>Dateifläche</emphasis> und öffnen mit Doppelkick eine
          <application>Terminal</application>-Anwendung.
        </simpara>
      </step>

      <step>
        <simpara>In der Termianlanwendung tragen Sie <userinput>sudo
          /Applications/Gnucash.app/Contents/Resources/bin/gnc-fq-update</userinput> ein. Das Skript
          stellt viele Fragen, die alle mit den Vorgabewerten beantwortet werden können.
        </simpara>
      </step>

      <step>
        <simpara>Geben Sie <userinput>exit</userinput> ein oder Betätigen Sie
          <keycombo>
            &kc.ctrl;<keycap>D</keycap>
          </keycombo>
          um die Shell zu beenden, gefolgt von
          <keycombo>
            &kc.cmd; <keycap>Q</keycap>
          </keycombo>
          damit die Terminalanwendung geschlossen wird.
        </simpara>
      </step>
    </procedure>

    <procedure>
      <title>Unter &win;</title>

      <step>
        <simpara>Beenden Sie &app;.
        </simpara>
      </step>

      <step>
        <simpara>Führen Sie &mc.winOS.inst-fq; aus. Dies ist ein kleines Hilfsprogramm, das &app-fq; für Sie
          installiert.
        </simpara>
      </step>
    </procedure>
  </sect1>

  <sect1 id="fq-command-line">
    <title>Verwendung von &app-cli; für Tests und Automatisierung</title>

    <abstract>
      <para>&app; enthält die Befehlszeilenanwendung &app-cli;, welche mit der Option
        <replaceable>--quotes</replaceable> in einer Terminalsitzung verwendet werden kann, um die
        Version und die unterstützten Quellmodule von &app-fq; zu prüfen, Kurse oder Wechselkurse
        für ausgewählte Wertpapiere oder Währungen anzuzeigen und alle Kurse in einem Buch zu
        aktualisieren, ohne hierfür die grafische Benutzeroberfläche zu starten.
      </para>
    </abstract>

    <note>
      <para>In &app; Version 4.x und früher wurden die separaten Perl-Programme
        <userinput>gnc-fq-check</userinput> an Stelle von <userinput>gnucash-cli --quote
        info</userinput> und <userinput>gnc-fq-dump</userinput> anstatt <userinput>gnucash-cli
        --quote dump</userinput> verwendet.
      </para>
    </note>

    <sect2 id="fq-check-version">
      <title>Anzeige der &app-fq; Version und der unterstützten Quellen</title>

      <abstract>
        <para>Die Nutzung der Option <replaceable>--quotes info</replaceable> liefert die Versionsnummer des
          derzeit installierten &app-fq; Moduls sowie eine Liste der verfügbaren Quellen. Es
          informiert Sie auch, wenn es ein Problem mit Ihrer Installation gibt und nennt die Gründe
          dafür.
        </para>
      </abstract>

      <para>Die neueste &app-fq; Version ist &app-fq-vers;. Entsprechend der Aktualität Ihrer Installation kann
        sich die nachfolgende Auflistung der Quellenmodule unterscheiden.
      </para>

      <para>Die Eingabe von
        <cmdsynopsis>
          <command>gnucash-cli</command>
          <group choice="req">
            <arg choice="plain">
              -Q
            </arg>

            <arg choice="plain">
              --quotes
            </arg>
          </group>

          <arg choice="plain">
            info
          </arg>
        </cmdsynopsis>
        im Terminal erzeugt die folgende Ausgabe:
      </para>

      <informalexample>
<?dbfo pgwide="1"?>
<screen language="console">
$ gnucash-cli --quotes info
Finance::Quote Version 1.57 wurde gefunden.
Finance::Quote Quellen:
aex          alphavantage              amfiindia    asegr        asx
aufunds      australia    bamosz       bet          bloomberg    bourso
bse          bseindia     bvb          canada       canadamutual
comdirect    cse          deka         dutch        dwsfunds     europe
fetch_live_currencies     fidelity     fidelity_direct
finanzpartner             fondsweb     fool         france       ftfunds
fundata      fundlibrary  goldmoney    googleweb    greece       hu
hufund       hungary      hustock      iexcloud     india        indiamutual
known_currencies          marketwatch  morningstarau
morningstarch             morningstarjp             morningstaruk
mstaruk      nasdaq       nseindia     nyse         nzx          onvista
oslobors     romania      seb_funds    sinvestor    six
tesouro_direto            tiaacref     tmx          tradegate    tradeville
treasurydirect            troweprice   troweprice_direct         tsp
tsx          twelvedata   ukfunds      unionfunds   usa          xetra
yahoo_json   yahooweb     za
</screen>
      </informalexample>

      <para>Wenn es ein Problem mit Ihrer Installation gibt, werden Sie darauf hingeweisen. In dem nachfolgend
        aufgeführtem Beispiel wird auf Probleme mit den &app-perl;-Modulen Finance::Quote und
        JSON::Parse hingewiesen:
      </para>

      <informalexample>
<?dbfo pgwide="1"?>
<screen language="console">
$ gnucash-cli --quotes info
Failed to initialize Finance::Quote: missing_modules Finance::Quote JSON::Parse
</screen>
      </informalexample>

      <para>In diesem Fall ist &app-fq; nicht richtig installiert und kann so nicht für den Kursabruf mit &app;
        genutzt werden. Bitte installieren Sie &app-fq; entsprechend der Anleitung unter
        <xref linkend="fq-install" />.
      </para>
    </sect2>

    <sect2 id="fq-print-quotes">
      <title>Abfrage von Kursen in einem Terminalfenster</title>

      <abstract>
        <para>Die Option <replaceable>--quotes dump</replaceable> liefert Kursdaten für eine Kursquelle und eine
          Liste von Symbolen in einem Format, das für Menschen leicht zu lesen ist. Dies ist
          nützlich, um zu überprüfen, ob eine bestimmte Online-Kursquelle erreichbar ist und
          Daten liefert.
        </para>

        <para>Weiterhin können Sie überprüfen, ob das <xref linkend="tool-ge-Symbol" />, welches Sie für Ihr
          Wertpapier zum Online-Kursabruf verwenden möchten, bei der gewünschten
          <xref linkend="tool-ge-TypeQuoteSource" /> bekannt ist.
        </para>
      </abstract>

      <tip>
        <para>Sie können <userinput>gnucash-cli --quotes dump</userinput> verwenden, um Kursquellen und Symbole
          einzeln zu testen, wenn &app; einen Fehler beim Abrufen von Kursen meldet. Der Befehl
          zeigt die Felder an, die von &app; genutzt werden. Verwenden Sie die Optionen
          <userinput>gnucash-cli --verbose --quotes dump</userinput>, um alle Informationen zu
          sehen, die &app-fq; von der Kursquelle erhält.
        </para>
      </tip>

      <para>Um einen Kurs für eine oder mehrere Aktien oder den Wechselkurs für eine oder mehrere Währungen
        anzuzeigen, verwenden Sie den Befehl wie folgt:
        <cmdsynopsis>
          <command>gnucash-cli</command>
          <group choice="req">
            <arg choice="plain">
              -Q
            </arg>

            <arg choice="plain">
              --quotes
            </arg>
          </group>

          <arg choice="plain">
            dump
          </arg>

          <group choice="opt">
            <arg choice="plain">
              -V
            </arg>

            <arg choice="plain">
              --verbose
            </arg>
          </group>

          <arg choice="plain">
            <replaceable>Quelle</replaceable>
          </arg>

          <arg choice="plain" rep="repeat">
            <replaceable>Symbol</replaceable>
          </arg>
        </cmdsynopsis>
      </para>

      <para>Es bietet eine Ausgabeform für Devisenkurse und zwei für Aktien und Wertpapiere.
        <variablelist>
          <varlistentry>
            <term>Währungen</term>

            <listitem>
              <para>Für den Abruf von Devisenkursen wird die Quelle <userinput>currency</userinput> verwendet, welche
                mindestens zwei <ulink url="&url-wp-de;ISO_4217">ISO&nbsp;4217</ulink>
                Währungscodes erfordern; die Wechselkurse werden in der ersten Währung angegeben.
                <footnote>
                  <para>Seit &app-fq; 1.41 ist die Standardquelle für Währungen <quote>Alpha Vantage</quote>. Lesen Sie
                    auch die Hinweise dazu in <xref linkend="gnc-tbl-fq-currency-source" />.
                  </para>
                </footnote>
                Zum Beispiel:
                <informalexample>
<?dbfo pgwide="1"?>
<screen language="console">
$ gnucash-cli --quotes dump currency USD GBP EUR
1 GBP = 1.27951 USD

1 EUR = 1.09823 USD
</screen>
                </informalexample>
              </para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>Wertpapiere</term>

            <listitem>
              <para>Zum Abruf von Kursen Ihrer Wertpapiere ist die abzufragende Kursquelle sowie das gewünschte Symbol
                anzugeben.
                <itemizedlist>
                  <listitem>
                    <para>Eine Kurzform, die nur die Felder anzeigt, die &app; benötigt, ergänzt mit Kommentaren, die
                      angeben, ob die Felder empfohlen oder erforderlich sind; damit können Sie
                      herausfinden, ob &app; in der Lage sein wird die Kursangaben zu verwenden, um
                      die Kursdatenbank Ihres Buches zu aktualisieren.
                      <informalexample>
<?dbfo pgwide="1"?>
<screen language="console">
$ gnucash-cli --quotes dump yahooweb AAPL
    Symbol: AAPL            &lt;=== erforderlich
     Datum: 07/28/2023      &lt;=== empfohlen
  Währung: USD             &lt;=== erforderlich
   Letzter: 193.22          &lt;=\ 
       NAV:                 &lt;=== Eins von diesen
     Preis:                 &lt;=/ 
</screen>
                      </informalexample>
                    </para>
                  </listitem>

                  <listitem>
                    <para>Mit der Option <userinput>--verbose</userinput> wird eine längere Ausgabe mit allen Datenfeldern
                      von &app-fq; zurückgegeben. Dies kann nützlich sein, um Probleme mit einem
                      &app-fq; Quellmodul zu beheben.
                      <informalexample>
<?dbfo pgwide="1"?>
<screen language="console">
$ ALPHAVANTAGE_API_KEY=123456789 gnucash-cli --verbose --quotes dump alphavantage INTC
INTC:
        date =&gt; 07/27/2023
       close =&gt; 34.3600
        open =&gt; 34.8200
currency_set_by_fq =&gt; 1
     success =&gt; 1
     isodate =&gt; 2023-07-27
        last =&gt; 34.5500
        high =&gt; 35.0300
    currency =&gt; USD
      symbol =&gt; INTC
      volume =&gt; 58890821
         low =&gt; 34.1100
    p_change =&gt; 0.5530
         net =&gt; 0.1900
      method =&gt; alphavantage
</screen>
                      </informalexample>

                      <note>
                        <para>Beachten Sie, dass wir in diesem Fall als Quelle alphavantage verwendet und den
                          <userinput>ALPHAVANTAGE_API_KEY</userinput> in der Befehlszeile angegeben
                          haben. Das ist nicht notwendig, wenn der Schlüssel bereits in
                          &mc.ed.pref; <xref linkend="prefs-online-quotes" /> gespeichert ist.
                        </para>
                      </note>
                    </para>
                  </listitem>
                </itemizedlist>
              </para>
            </listitem>
          </varlistentry>
        </variablelist>
      </para>

      <procedure>
        <para>Um zu testen, ob &app-fq; für Währungen innerhalb von &app; funktioniert, gehen Sie wie folgt vor:
        </para>

        <step>
          <para>erstellen Sie eine Buchung mit dem gewünschtem Handelsgut in der Buchwährung,
          </para>
        </step>

        <step>
          <para>machen einen Rechtsklick darauf,
          </para>
        </step>

        <step>
          <para>wählen Sie im Kontextmenü die Option &gmi.ac.ed-ex;.
          </para>
        </step>

        <step>
          <para>Klicken Sie auf die Schaltfläche <guilabel>Wechselkurs abrufen</guilabel> im
            <xref linkend="trans-win-enter" />.
          </para>
        </step>
      </procedure>

      <para>Sind die Kursquelle sowie das Symbol richtig eingestellt, wird der aktuelle Kurs in das Feld für
        den Wechselkurs eingetragen.
      </para>
    </sect2>

    <sect2 id="fq-auto-quote">
      <title>Automatisierte Aktualisierung von Kursen mit &app-cli;</title>

      <para>Mit dem Kommando <command>gnucash-cli --quotes get &user-datafile;</command>
        <footnote>
          <simpara>Dies ersetzt den Befehl <userinput>&app; --add-price-quotes &user-datafile;</userinput> in &app;
            Version 4.x und früher.
          </simpara>
        </footnote>
        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.
        <note>
          <para>Der Befehl schlägt fehl, wenn kein exclusiver Zugriff auf die Datendatei möglich ist, z.B. weil
            die Datendatei in einer anderen &app; Instanz geöffnet ist oder die letzte Sitzung für
            die Datei abgestürzt ist.
          </para>
        </note>
      </para>

      <para>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 <quote>-</quote> angezeigt wird.
        <tip>
          <para>Der Dateiname ist auch in der Liste der zuletzt geöffneten Dateien im &gm.file;-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 <guilabel>Statusleiste</guilabel> die
            vollständige Dateibezeichnung angezeigt.
          </para>
        </tip>
      </para>

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

      <example>
        <title>Automatischer Kursabruf jeden Freitag um 16:00 Uhr</title>

        <procedure>
          <title>Unter &lin; und &mac;</title>

          <para>Eintragen des Befehls zum Kursabruf per <command>gnucash-cli</command> mittels
            <application>cron</application>.
          </para>

          <step>
            <simpara>Führen Sie das Kommando <command>crontab -e</command> aus.
            </simpara>
          </step>

          <step>
            <para>Fügen Sie die folgende Zeile in Ihre crontab ein:
              <informalexample>
<?dbfo pgwide="1"?>
<screen>
0 16 * * 5 gnucash-cli --quotes get &user-datafile; &gt; /dev/null 2&gt;&amp;1
</screen>
              </informalexample>

              <important>
                <para>Läuft unter &lin; 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:
                  <informalexample>
<?dbfo pgwide="1"?>
<screen>
0 16 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EXIT;
gnucash-cli --quotes get &user-datafile; &gt; /dev/null 2&gt;&amp;1
</screen>
                  </informalexample>
                  (Den Zeilenumbruch nicht in die crontab übernehmen, der wurde hier nur zum Zwecke
                  der Lesbarkeit eingefügt.)
                </para>
              </important>
            </para>
          </step>
        </procedure>

        <procedure>
          <title>Unter &win;</title>

          <para>Anlegen des Kursabrufs per <command>gnucash-cli</command> mit der Aufgabenplanung.
          </para>

          <step>
            <simpara>Wählen Sie &mc.winOS.sys.tasks;.
            </simpara>
          </step>

          <step>
            <simpara>Klicken Sie auf &gmi.winOS.sys.task;.
            </simpara>
          </step>

          <step>
            <simpara>Geben Sie die entsprechenden Angaben im Fenster <guilabel>Aufgabe erstellen</guilabel> ein.
            </simpara>
          </step>
        </procedure>

        <para>Passen Sie die Zeit an den Börsenschluss an und bedenken Sie, dass bei
          <emphasis>Fondskursen</emphasis> das Netto-Anlagevermögen (NAV) deutlich nach
          Börsenschluss ermittlet wird. Eine Beschreibung zu den Typen finden Sie unter
          <xref linkend="tool-price" />.
<!-- FIXME: adjust the link to a proper ID -->
        </para>
      </example>

      <para>Einige Benutzer haben im &app; Wiki unter
        <ulink url="&url-wiki-de;Aktienhandel">Aktienhandel</ulink> und ausführlicher im
        englischsprachigen Wiki
        <ulink url="&url-wiki-OQ;#Updating_enabled_Quotes_from_outside_GnuCash">Online Quotes Page
        on GnuCash Wiki</ulink> ihre Erfahrungen und weiter Ergänzungen zusammengestellt.
      </para>
    </sect2>
  </sect1>
</chapter>
