XIRR(noch nicht verfügbar)

Überblick

Kurzbeschreibung

Das XIRR-Nuclet bietet Funktionen zur Berechnung des internen Zinsfußes (Internal Rate of Return). Die Berechnung erfolgt auf der Grundlage einer Reihe von Zahlungen (Geldbeträge, gebunden an Datumswerte).

Die Berechnug entspricht den Excel-Funktionen XIRR (bzw. XINTZINSFUSS).

Nuclet-Bestandteile

Das XIRR-Nuclet umfasst im Rahmen der .nuclet-Datei

• diverse Java-Regeln (verteilt auf Packages),

• eine Jobsteuerung (zur Steuerung eines Test-Jobs).

Tabelle 1: Nuclet-Bestandteile

Java-Package-Struktur

Die Java-Regeln sind in fünf Packages unterteilt. Von diesen Regeln sind sind im Normalfall nur vier Java-Klassen bei der Nuclet-Integration wirklich relevant:

• org.nuclet.xirr.data.XIRRSeries, als Datenstruktur für eine Serie von Zahlungen

• org.nuclet.xirr.logic.XIRRLogic, als Logik zum Aufruf der XIRR-Berechnungen

• org.nuclet.xirr.test.XIRRTestJob, als Job zum Aufrufen von Tests

• org.nuclet.xirr.parameter.XIRRSystemParameters, zur Konfiguration von System-Parametern

Integration

Notwendige Schritte zur Integration

Die Integration des XIRR-Nuclets erfolgt in 3 Schritten:

1. Download

2. Nuclet-Import

3. Konfiguration von System-Parametern

4. Anbindung des eigenen Java-Codes an die XIRR-Logik

Alle Integrationschritte werden im folgenden im Detail erläutert.

Schritt 1: Download

Download der ZIP-Datei „XIRR-v1.4.0-4.19.3.zip“ auf der Nuclos-Webpage unter „Nuclos Services“ > „Download“ > „Nuclet Download“. Das ZIP anschließend lokal entpacken.

Schritt 2: Nuclet-Import

Import des XIRR-Nuclets unter „Konfiguration“ > „Nuclet Management“ > „Importieren“ in Ihre bestehende Nuclos-Instanz, Auswahl der Datei „XIRR-v1.4.0-4.19.3.nuclet“

Schritt 3: Konfiguration der System-Parameter

Die Einrichtung des verwendeten Nuclos-Systemparamets erfolgt in der Version v1.0.0 über die Anpassung der Konstanten XIRR_DEFAULT_GUESS in der Klasse org.nuclet.xirr.parameter.XIRRSystemParameters:

Tabelle 2: System-Parameter

Schritt 4: Anbindung des eigenen Java-Codes an die XIRR-Logik

Die Einbindung der XIRR-Logik erfolgt über die Initialisierung einer org.nuclet.xirr.data.XIRRSeries, die mit den Zahlungsbeträgen und Kalenderdaten der Zahlungen gefüllt wird. Optional ist ein spezifischer Startwert („guess“) mitzugeben. Falls kein Startwert angegeben ist, wird der Default-Startwert verwendet (s. Schritt 3). Einer Instanz der Klasse org.nuclet.xirr.logic.XIRRLogic wird sodann das Series-Objekt zur Berechnung übergeben.

Hier ein Beispiel zur Integration in einer UpdateRule:

@Rule(name="AktualisiereZahlungsverkehr", description="Aktualisiert den Zahlungsverkehr")
public class AktualisiereZahlungsverkehr implements UpdateRule
{
 
	public void update(UpdateContext context)
	{
		(...)
 
		XIRRLogic logic = new XIRRLogic(context); // Initialisierung der XIRR-Logik
		XIRRSeries series = new XIRRSeries(); // es ist möglich, den Startwert (guess) mizugegeben
 
		Zahlungsverkehr zvk = context.getBusinessObject(Zahlungsverkehr.class);
		List<Zahlung> lstZahlungen = zvk.getZahlung();
 
		for (Zahlung z : lstZahlungen) {
			series.add(z.getDatum(), z.getBetrag());
		}
 
		BigDecimal bgdXirrValue = logic.calculate(series); // ohne Konvergenz ist der Wert „null“!
	 
		(...)
	}
}

Versionshistorie