Module Shares und ShareMaster

Aus FHEMWiki
Zur Navigation springen Zur Suche springen
Shares
Zweck / Funktion
Das Modul Shares dient zur Verwaltung eines Wertpapierdepots.
Allgemein
Typ Hilfsmodul
Details
Dokumentation EN / DE
Support (Forum) Unterstuetzende Dienste
Modulname 95_Shares.pm
Ersteller Prof. Dr. Peter A. Henning
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!


ShareMaster
Zweck / Funktion
Das Modul ShareMaster fasst die Daten eines oder mehrer Wertpapierdepots in einer komfortablen Anzeige zusammen.
Allgemein
Typ Hilfsmodul
Details
Dokumentation EN / DE
Support (Forum) Unterstuetzende Dienste
Modulname 95_ShareMaster.pm
Ersteller Prof. Dr. Peter A. Henning
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Shares.pm

Das Modul 95_Shares.pm dient dazu, ein Wertpapierdepot zu verwalten. Dabei wurden wesentliche Bestandteile des Moduls 98_STOCKQUOTES.pm übernommen, aber strukturell so stark verändert, dass ein neuer Modulname sinnvoll war. vbs, dem Ersteller und Maintainer des Ursprungsmoduls sei an dieser Stelle gedankt. Die strukturellen Änderungen sind insbesondere:

  • separate Währungen für alle Wertpapiere im Depot und das Depot selbst (Attribute shareCurrency und depotCurrency). Das ermöglicht, Wertpapiere in dieses Depot zu legen, die zwar für das eigene Depot in € gekauft werden, aber an ausländischen Börsen gehandelt und ggf. auch im Ausland verwahrt werden.
  • Angabe einer Kategorie (z.B. "Rohstoff" oder "Bio") für jedes Wertpapier.
  • deutliche Vereinfachung der Reading-Namen und Konfigurierbarkeit der angezeigten Werte.

Einrichtung

Die Definition ist einfach und benötigt keine Parameter

define <Depotname> Shares

Das Attribut stocks enthält eine (gerne mehrzeilige) Liste der Wertpapiere im Format

<Symbol>:<Anzahl>:<Einstandswert>:<Kategorie>

Wichtig ist, dass der Einstandwert in Depotwährung angegeben wird.

ShareMaster.pm

Das Modul 95_ShareMaster.pm dient der komfortablen Anzeige der mit dem obigen Modul verwalteten Werte (siehe Beispiele unten).

Einrichtung

Die Definition erhält als Parameter alle Unterdepots

define <Depotname> ShareMaster <Unterdepot1> [<Unterdepot2>]*

Beispiele

Beispieldepot mit 4 deutschen Papieren

Shares.png Die Währungsattribute des Depots DepotY_EUR haben die Werte

attr DepotY_EUR depotCurrency EUR
attr DepotY_EUR shareCurrency EUR

Das Attribut stocks des Depots DepotY_EUR bekommt den mehrzeiligen Wert

BAS.DE:3:154:chemistry,
FRA.DE:6:258.47:mobility,
LIN.DE:1:212:chemistry,
TKA.DE:10:72:tech,

Beispieldepot mit 2 kanadischen Papieren

Die Währungsattribute des Depots DepotY_CAD haben die Werte

attr DepotY_CAD depotCurrency EUR
attr DepotY_CAD shareCurrency CAD

Das Attribut stocks des Depots DepotY_CAD bekommt den mehrzeiligen Wert

PSLV.TO:10:73:commodity,
BLDP.TO:5:76:h2

Zusammenfassung der beiden Beispieldepots