Module Shares und ShareMaster: Unterschied zwischen den Versionen

Aus FHEMWiki
KKeine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Zeile 17: Zeile 17:
[[Kategorie:Examples]]
[[Kategorie:Examples]]


===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:
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.  
* 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.
* Angabe einer Kategorie (z.B. "Rohstoff" oder "Bio") für jedes Wertpapier.
* deutliche Vereinfachung der Reading-Namen und Konfigurierbarkeit der angezeigten Werte.
* deutliche Vereinfachung der Reading-Namen und Konfigurierbarkeit der angezeigten Werte.
 
====Einrichtung====
===Shares.pm===
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
Das Attribut ''stocks'' enthält eine (gerne mehrzeilige) Liste der Wertpapiere im Format
  <Symbol>:<Anzahl>:<Einstandswert>:<Kategorie>
  <Symbol>:<Anzahl>:<Einstandswert>:<Kategorie>
Zeile 28: Zeile 30:


===ShareMaster.pm===
===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==
==Beispiele==
Zeile 47: Zeile 53:
  PSLV.TO:10:73:commodity,
  PSLV.TO:10:73:commodity,
  BLDP.TO:5:76:h2
  BLDP.TO:5:76:h2
===Zusammenfassung der beiden Beispieldepots===

Version vom 8. April 2022, 11:55 Uhr

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

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