Module Shares und ShareMaster - Versionsgeschichte

Ph1959de: Updates in Infoboxen

2024-11-21T17:40:52Z

Updates in Infoboxen

← Nächstältere Version		Version vom 21. November 2024, 19:40 Uhr
Zeile 1:		Zeile 1:
	{{Infobox Modul		{{Infobox Modul
	\|ModPurpose=Das Modul Shares dient zur Verwaltung eines Wertpapierdepots.		\|ModPurpose=Das Modul Shares dient zur Verwaltung eines Wertpapierdepots.
	\|ModType=h		\|ModType=d
	\|ModCmdRef=Shares		\|ModCmdRef=Shares
	\|ModForumArea=~~Unterstuetzende~~ Dienste		\|ModFTopic=127195
			\|ModForumArea=Unterstützende Dienste
	\|ModTechName=95_Shares.pm		\|ModTechName=95_Shares.pm
	\|ModOwner=Prof. Dr. Peter A. Henning		\|ModOwner=Prof. Dr. Peter A. Henning ({{Link2FU\|376\|Forum}}/[[Benutzer:pahenning\|Wiki]])
	}}		}}
	~~{{Infobox Modul~~
	~~\|ModPurpose=Das Modul ShareMaster fasst die Daten eines oder mehrer Wertpapierdepots in einer komfortablen Anzeige zusammen.~~
	~~\|ModType=h~~
	~~\|ModCmdRef=ShareMaster~~
	~~\|ModForumArea=Unterstuetzende Dienste~~
	~~\|ModTechName=95_ShareMaster.pm~~
	~~\|ModOwner=Prof. Dr. Peter A. Henning~~
	}}
	~~[[Kategorie:Examples]]~~

	===Shares.pm===		===Shares.pm===
Zeile 40:		Zeile 32:

	===ShareMaster.pm===		===ShareMaster.pm===
			{{Infobox Modul
			\|ModPurpose=Das Modul ShareMaster fasst die Daten eines oder mehrerer Wertpapierdepots in einer komfortablen Anzeige zusammen.
			\|ModType=d
			\|ModCmdRef=ShareMaster
			\|ModFTopic=127195
			\|ModForumArea=Unterstützende Dienste
			\|ModTechName=95_ShareMaster.pm
			\|ModOwner=Prof. Dr. Peter A. Henning ({{Link2FU\|376\|Forum}}/[[Benutzer:pahenning\|Wiki]])
			}}

	Das Modul 95_ShareMaster.pm dient der komfortablen Anzeige der mit dem obigen Modul verwalteten Werte (siehe Beispiele). Dabei erfolgt die Anzeige je Unterdepot, aber auch eine Zusammenfassung nach Kategorien.		Das Modul 95_ShareMaster.pm dient der komfortablen Anzeige der mit dem obigen Modul verwalteten Werte (siehe Beispiele). Dabei erfolgt die Anzeige je Unterdepot, aber auch eine Zusammenfassung nach Kategorien.

Zeile 94:		Zeile 96:
	===Beispieldepot mit 4 deutschen Papieren===		===Beispieldepot mit 4 deutschen Papieren===
	[[Datei:Shares.png\|400px\|]]		[[Datei:Shares.png\|400px\|]]

	Die Währungsattribute des Depots DepotY_EUR haben die Werte		Die Währungsattribute des Depots DepotY_EUR haben die Werte
	attr DepotY_EUR depotCurrency EUR		attr DepotY_EUR depotCurrency EUR
Zeile 116:		Zeile 117:
	define DepotY ShareMaster DepotY_EUR DepotY_CAD		define DepotY ShareMaster DepotY_EUR DepotY_CAD
	und führt zur Anzeige aus dem oberen Bild.		und führt zur Anzeige aus dem oberen Bild.

			[[Kategorie:Examples]]

Pahenning: /* Wichtige Attribute */

2024-04-24T14:38:43Z

Wichtige Attribute

← Nächstältere Version		Version vom 24. April 2024, 16:38 Uhr
Zeile 63:		Zeile 63:
	Für das Modul 95_ShareMaster.pm		Für das Modul 95_ShareMaster.pm
	*'''depotCurrency''' ist die Anzeigewährung für den Gesamtwert dieses Depots, auch die Einstandswerte jedes Papier müssen in dieser Währung angegeben werden. Format: <code><ISO-Code for currency>[:<Currency Symbol>]</code>, Default: EUR:€		*'''depotCurrency''' ist die Anzeigewährung für den Gesamtwert dieses Depots, auch die Einstandswerte jedes Papier müssen in dieser Währung angegeben werden. Format: <code><ISO-Code for currency>[:<Currency Symbol>]</code>, Default: EUR:€
			*'''categories''' ist eine kommagetrennte Liste der Kategorien für dieses Depot, die in der Zusammenfassung dargestellt werden. Beispiel:
			automotive,mobility,bio,chemistry,commodity,energy,finance,h2,health,pharma,realestate,sales,software,tech
			Für die in diesem Beispiel verwendeten Kategorien gibt es im Modul eine deutsche Übersetzung.
	*'''pollInterval''' ist der Zeitabstand für Abfragen, Default: 300 (Sekunden)		*'''pollInterval''' ist der Zeitabstand für Abfragen, Default: 300 (Sekunden)

Pahenning: /* Wichtige Attribute */

2024-04-24T14:34:20Z

Wichtige Attribute

← Nächstältere Version		Version vom 24. April 2024, 16:34 Uhr
Zeile 47:		Zeile 47:
	define <MasterDepotname> ShareMaster <Unterdepot1> [<Unterdepot2>]*		define <MasterDepotname> ShareMaster <Unterdepot1> [<Unterdepot2>]*
	==Wichtige Attribute==		==Wichtige Attribute==
			Für das Modul 95_Shares.pm
	*'''shareCurrency''' ist die Anzeigewährung für die Wertpapiere. Format: <code><ISO-Code for currency>[:<Currency Symbol>]</code>, Default: EUR:€		*'''shareCurrency''' ist die Anzeigewährung für die Wertpapiere. Format: <code><ISO-Code for currency>[:<Currency Symbol>]</code>, Default: EUR:€
	*'''depotCurrency''' ist die Anzeigewährung für den Gesamtwert dieses Depots, auch die Einstandswerte jedes Papier müssen in dieser Währung angegeben werden. Format: <code><ISO-Code for currency>[:<Currency Symbol>]</code>, Default: EUR:€		*'''depotCurrency''' ist die Anzeigewährung für den Gesamtwert dieses Depots, auch die Einstandswerte jedes Papier müssen in dieser Währung angegeben werden. Format: <code><ISO-Code for currency>[:<Currency Symbol>]</code>, Default: EUR:€
Zeile 59:		Zeile 60:
	*'''colors''' ist eine kommagetrennte Liste von Farbspezifikationen im HTML-Format, um Änderungen in den Kurswerten darzustellen, mit den Grenzen >1%,1%,0%,-1%,<-1% Default: "green,seagreen,black,orangered,red"		*'''colors''' ist eine kommagetrennte Liste von Farbspezifikationen im HTML-Format, um Änderungen in den Kurswerten darzustellen, mit den Grenzen >1%,1%,0%,-1%,<-1% Default: "green,seagreen,black,orangered,red"
	*'''headercolor''' ist eine Farbspezifikation im HTML-Format zur Hervorhebung der Kopfzeile in einer Depotabelle. Default #aaaaff;		*'''headercolor''' ist eine Farbspezifikation im HTML-Format zur Hervorhebung der Kopfzeile in einer Depotabelle. Default #aaaaff;

			Für das Modul 95_ShareMaster.pm
			*'''depotCurrency''' ist die Anzeigewährung für den Gesamtwert dieses Depots, auch die Einstandswerte jedes Papier müssen in dieser Währung angegeben werden. Format: <code><ISO-Code for currency>[:<Currency Symbol>]</code>, Default: EUR:€
			*'''pollInterval''' ist der Zeitabstand für Abfragen, Default: 300 (Sekunden)

	==Alternative Symbole==		==Alternative Symbole==

Pahenning: /* Wichtige Attribute */

2024-04-24T14:30:42Z

Wichtige Attribute

← Nächstältere Version		Version vom 24. April 2024, 16:30 Uhr
Zeile 58:		Zeile 58:
	*'''arrows''' ist eine kommagetrennte Liste von Pfeilsymbolen im HTML-Format, die Änderungen im Kurswert symbolisieren, mit den Grenzen >1%,1%,0%,-1%,<-1% Default: "🢁,🢅,🢂,🢆,🢃"		*'''arrows''' ist eine kommagetrennte Liste von Pfeilsymbolen im HTML-Format, die Änderungen im Kurswert symbolisieren, mit den Grenzen >1%,1%,0%,-1%,<-1% Default: "🢁,🢅,🢂,🢆,🢃"
	*'''colors''' ist eine kommagetrennte Liste von Farbspezifikationen im HTML-Format, um Änderungen in den Kurswerten darzustellen, mit den Grenzen >1%,1%,0%,-1%,<-1% Default: "green,seagreen,black,orangered,red"		*'''colors''' ist eine kommagetrennte Liste von Farbspezifikationen im HTML-Format, um Änderungen in den Kurswerten darzustellen, mit den Grenzen >1%,1%,0%,-1%,<-1% Default: "green,seagreen,black,orangered,red"
	*'''headercolor ist eine Farbspezifikation im HTML-Format zur Hervorhebung der Kopfzeile in einer Depotabelle. Default #aaaaff;		*'''headercolor''' ist eine Farbspezifikation im HTML-Format zur Hervorhebung der Kopfzeile in einer Depotabelle. Default #aaaaff;

	==Alternative Symbole==		==Alternative Symbole==

Pahenning: /* Wichtige Attribute */

2024-04-24T14:30:27Z

Wichtige Attribute

← Nächstältere Version		Version vom 24. April 2024, 16:30 Uhr
Zeile 56:		Zeile 56:
	'''sourcesLinks''' ist eine kommagetrennte Liste im Format <code><QuelleA>:<StringA>[,<QuelleX>:<StringX>]</code>. Der String ist eine URL, die den Platzhalter ''$SYMBOL'' enthalten kann. Dieser Platzhalter wird für jedes Wertpapier durch das verwendete Symbol ersetzt. Beispiel:		'''sourcesLinks''' ist eine kommagetrennte Liste im Format <code><QuelleA>:<StringA>[,<QuelleX>:<StringX>]</code>. Der String ist eine URL, die den Platzhalter ''$SYMBOL'' enthalten kann. Dieser Platzhalter wird für jedes Wertpapier durch das verwendete Symbol ersetzt. Beispiel:
	yahoo_json:http://de.finance.yahoo.com/quote/$SYMBOL		yahoo_json:http://de.finance.yahoo.com/quote/$SYMBOL
	*'''arrows''' ist eine kommagetrennte Liste von Pfeilsymbolen im HTML-Format, die Änderungen im Kurswert symbolisieren, mit den Grenzen >1%,1%,0%,-1%,<-1%		*'''arrows''' ist eine kommagetrennte Liste von Pfeilsymbolen im HTML-Format, die Änderungen im Kurswert symbolisieren, mit den Grenzen >1%,1%,0%,-1%,<-1% Default: "🢁,🢅,🢂,🢆,🢃"
	Default: "🢁,🢅,🢂,🢆,🢃"		*'''colors''' ist eine kommagetrennte Liste von Farbspezifikationen im HTML-Format, um Änderungen in den Kurswerten darzustellen, mit den Grenzen >1%,1%,0%,-1%,<-1% Default: "green,seagreen,black,orangered,red"
	*'''colors''' ist eine kommagetrennte Liste von Farbspezifikationen im HTML-Format, um Änderungen in den Kurswerten darzustellen, mit den Grenzen >1%,1%,0%,-1%,<-1%		*'''headercolor ist eine Farbspezifikation im HTML-Format zur Hervorhebung der Kopfzeile in einer Depotabelle. Default #aaaaff;
	Default: "green,seagreen,black,orangered,red"
	*'''headercolor ist eine Farbspezifikation im HTML-Format zur Hervorhebung der Kopfzeile in einer Depotabelle.Default #aaaaff;
	==Alternative Symbole==		==Alternative Symbole==
	Viele der Datenanbieter, z.B. Yahoo, erschweren in unregelmäßigen und nicht vorhersehbaren Abständen den Zugang. Das ist verständlich, weil sie durch den häufigen Zugriff Kosten haben - aber dennoch ärgerlich, weil man plötzlich von einem auf den anderen Tag keine Kursdaten mehr bekommt.		Viele der Datenanbieter, z.B. Yahoo, erschweren in unregelmäßigen und nicht vorhersehbaren Abständen den Zugang. Das ist verständlich, weil sie durch den häufigen Zugriff Kosten haben - aber dennoch ärgerlich, weil man plötzlich von einem auf den anderen Tag keine Kursdaten mehr bekommt.

Pahenning am 24. April 2024 um 14:29 Uhr

2024-04-24T14:29:28Z

@@ Zeile 46: / Zeile 46: @@
 Die Definition erhält als Parameter alle Unterdepots
   define <MasterDepotname> ShareMaster <Unterdepot1> [<Unterdepot2>]*
 ==Beispiele==
@@ Zeile 72: / Zeile 109: @@
    define DepotY ShareMaster DepotY_EUR DepotY_CAD
 und führt zur Anzeige aus dem oberen Bild.

Pahenning: /* Alternative Symbole */

2024-04-24T14:06:55Z

Alternative Symbole

← Nächstältere Version		Version vom 24. April 2024, 16:06 Uhr
Zeile 93:		Zeile 93:
	attr <Depotname> altSymbol 1		attr <Depotname> altSymbol 1
	auf Xetra als Quelle umschalten, ohne den gesamten Depotbestand neu einzugeben.		auf Xetra als Quelle umschalten, ohne den gesamten Depotbestand neu einzugeben.

			Selbstverständlich wird in der Anzeige des Depots nur das jeweils verwendete Symbol dargestellt - die komplexere Darstellung beschränkt sich auf das ''stocks''-Attribut.

Pahenning am 24. April 2024 um 14:05 Uhr

2024-04-24T14:05:08Z

← Nächstältere Version		Version vom 24. April 2024, 16:05 Uhr
Zeile 73:		Zeile 73:
	und führt zur Anzeige aus dem oberen Bild.		und führt zur Anzeige aus dem oberen Bild.

	==~~Änderungen in der yahoo API (Mai 2023)~~==		==Alternative Symbole==
	~~Leider haben Änderungen in~~ der Yahoo ~~API dazu geführt~~, ~~dass die Abrufe eventuell~~ nicht mehr ~~funktionieren~~. ~~Ärgerlicherweise besteht zudem der Workaround derzeit darin~~, ~~händisch~~ in ~~installierten Perl-Dateien Versionsnummern zu ändern - und niemand weiß~~, ~~wie nachhaltig diese Anpassungen sein werden~~. ~~Falls das angelegte Depot aus yahoo finance nur Nullen holt~~, ~~sind folgende Schritte nötig~~: ~~Zuerst sucht man eine Perl~~-~~Datei mit~~		Viele der Datenanbieter, z.B. Yahoo, erschweren in unregelmäßigen und nicht vorhersehbaren Abständen den Zugang. Das ist verständlich, weil sie durch den häufigen Zugriff Kosten haben - aber dennoch ärgerlich, weil man plötzlich von einem auf den anderen Tag keine Kursdaten mehr bekommt.
	~~(sudo) find /~~ -~~name YahooJSON~~.~~pm -print~~
	~~und erhält den Speicherort von YahooJSON~~.pm. ~~Oft findet man die Datei unter /usr/share/perl5/Finance/Quote/YahooJSON~~.pm. ~~Im nächsten Schritt sucht man in der Datei die Zeile~~		Aus diesem Grund bietet das Modul 95_Shares.pm die Möglichkeit, für jedes Wertpapier mehrere Symbole anzugeben. Die Syntax für jede Zeile des Attributes ''stocks'' ist in diesem Fall
	~~my $YIND_URL_HEAD =~~ '~~https://query1~~.~~finance~~.~~yahoo.com/v7/finance/quote?symbols=~~';		<Symbol0>[\|<SymbolN, N=1...>]*:<Anzahl>:<Einstandswert>:<Kategorie>,
	~~und ändert die v7 in v6~~. ~~Danach sollte~~ der ~~Abruf (zumindest erstmal) gehen~~.		Beispiel:
			NADQ.DE\|LU2197908721:10:500:tech,
			Das erste ist in diesem Beispiel das Yahoo-Symbol für einen beliebten NASDAQ-ETF, das zweite die ISIN. Die Anzahl der alternativen Symbole ist nicht begrenzt.

			Desweiteren gibt es für das Modul das Attribut ''defaultSource''. Dessen Syntax ist
			<Quelle0>[\|<QuelleN, N=1...>]*
			Beispiel:
			yahoo_json\|xetra
			Die dritte Komponente dieses Systems ist das Attribut ''altSymbol''. Und damit sollte schon klar sein, wie das läuft.
			* Wenn ''altSymbol'' den Wert 0 hat, wird für jedes Position mit dem Symbol0 standardmäßig bei Quelle0 nachgeschaut
			* Wenn ''altSymbol'' den Wert 1 hat, wird für jedes Position mit dem Symbol1 standardmäßig bei Quelle1 nachgeschaut
			* etc.
			Sollte es also vorkommen, dass Yahoo den Zugriff mal wieder erschwert, kann man mit der einfachen Änderung
			attr <Depotname> altSymbol 1
			auf Xetra als Quelle umschalten, ohne den gesamten Depotbestand neu einzugeben.

Pahenning: /* Shares.pm */

2024-04-24T13:42:52Z

Shares.pm

← Nächstältere Version		Version vom 24. April 2024, 15:42 Uhr
Zeile 36:		Zeile 36:
	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>
	* Wichtig ist, dass der Einstandswert für jedes Wertpapier''in Depotwährung'' angegeben wird.		* Wichtig ist, dass der Einstandswert für jedes Wertpapier ''in Depotwährung'' angegeben wird.
	* Zum Thema der alternativen Symbolen siehe unten.		* Zum Thema der alternativen Symbolen siehe unten.

Pahenning: /* Shares.pm */

2024-04-24T13:42:25Z

Shares.pm

← Nächstältere Version		Version vom 24. April 2024, 15:42 Uhr
Zeile 22:		Zeile 22:
	* 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.
			* Alternative Symbole für jedes Wertpapier, z.B. Yahoo-Symbol\|ISIN\|WKN zum schnellen Wechsel des Datenanbieters
	====Einrichtung====		====Einrichtung====
	Das Modul benötigt das Perl-Modul Finance::Quote, das mit dem ~~folgenden~~ Kommandozeilenbefehl installiert wird		Das Modul benötigt das Perl-Modul Finance::Quote, das am Sichersten mit dem Kommandozeilenbefehl
			cpan Finance::Quote
			installiert wird. Da hierbei viele zusätzliche Perl-Module geholt und getestet werden, kann das schon eine ganze Weile dauern!

			Auf Linux-Systemen kann man das ggf. durch
	apt install libfinance-quote-perl		apt install libfinance-quote-perl
			abkürzen. Dabei kann es aber zu Fehlermeldungen beim Aufruf kommen, weil dieses Linux-Paket offenbar nicht ganz vollständig ist.

	Die Definition des Depots ist ~~dann~~ einfach und benötigt keine Parameter		Die Definition des Depots ist sehr einfach und benötigt keine Parameter
	define <Depotname> Shares		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>
	Wichtig ist, dass der ~~Einstandwert~~ ''in Depotwährung'' angegeben wird.		* Wichtig ist, dass der Einstandswert für jedes Wertpapier''in Depotwährung'' angegeben wird.
			* Zum Thema der alternativen Symbolen siehe unten.
	~~'''Achtung''': Offenbar ist dieses Package nicht ganz vollständig. Wenn es danach zu Fehlermeldungen kommt, etwa~~
	~~Can't locate object method "methods" via package "Finance::Quote::currency_rates" (perhaps you forgot to load "Finance::Quote::currency_rates"?)~~
	~~muss das Perl-Package von Hand repariert werden. Dazu auf~~ der ~~Kommandzeile eingeben~~
	~~cpan Finance::Quote~~
	~~und ggf. eine halbe Stunde Wartezeit einplanen~~.

	===ShareMaster.pm===		===ShareMaster.pm===