Funktionen

Überblick

Mit Funktionen in Tilde-Formeln können Sie Informationen und Daten aus Lucanet abfragen und in einem Excel-Bericht ausgeben. 

Eine Funktion gibt an, welche Art von Information abgerufen wird (z. B. Zahlenwerte, Währungen, Wechselkurse).

Aufbau der Tilde-Formel

Für Funktionen muss die Tilde-Formel wie folgt aufgebaut sein:

~Funktion(Parameter 1="Wert";...;Parameter n="Wert")

 

Regeln für Funktionen in Tilde-Formeln

Für Funktionen in Tilde-Formeln gelten folgende Regeln:

  • An den Funktionsnamen schließen sich kein, ein oder mehrere Parameter an.
  • Die Parameter einer Funktion sind in runde Klammern ( ) eingeschlossen.
  • Mehrere Parameter werden durch ein Semikolon ( ; ) voneinander getrennt.
  • Die Parameter einer Funktion werden durch ein Schlüsselwort oder einen Platzhalter beschrieben.
  • Ein Schlüsselwort hat einen Wert, der auf ein Gleichheitszeichen ( = ) folgt und in Anführungszeichen steht.
  • Als Werte können auch Zellbezüge verwendet werden. Bei Zellbezügen dürfen keine Anführungszeichen verwendet werden. 
Funktion 'Wert'

Mit der Funktion Wert kann ein beliebiger Wert eines Kontos oder einer Position aus der Lucanet-Datenbank ausgelesen werden.

Aufbau der Tildeformel für die Funktion 'Wert'

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Wert(Position="Name oder URL der Position/des Kontos"; Schlüsselwort_1/Platzhalter_1;...; Schlüsselwort_n/Platzhalter_n)

Regeln für die Funktion 'Wert'
  • Der Basisparameter Position/Konto muss angegeben werden. 
  • Alle anderen Basisparameter sind optional.
  • Für optionale Parameter kann entweder ein Platzhalter oder ein Schlüsselwort verwendet werden.
  • Einem Parameter wird ein Wert zugewiesen, der auf ein Gleichheitszeichen ( = ) folgt.
  • Der Wert eines Parameters muss in Anführungszeichen ( " ) stehen.
Basisparameter für die Funktion 'Wert'

In der Funktion Wert können die folgenden, den Dimensionen in Lucanet entsprechenden Basisparameter verwendet werden:

  • Position/Konto
  • Periode
  • Organisationselement
  • Datenebene
  • Bewertungsebene/-gruppe
  • Transaktionswährung
  • Anzeigewährung
  • Partner
Optionale Parameter für die Funktion 'Wert'

Zusätzlich zu den Basisparametern können in der Funktion Wert die folgenden optionalen Parameter verwendet werden.

Der Parameter Kürzel ist optional und gibt an, in welchem Buch oder Spiegel nach einer Position oder einem Konto gesucht werden soll. Mit der Angabe des zu durchsuchenden Buchs oder Spiegels können Sie Fehlermeldungen vermeiden, falls die gesuchte Position oder das gesuchte Konto mehrfach vorhanden ist.

Wird der Parameter weggelassen, werden alle Bücher und Spiegel durchsucht.

Hinweis: In Spiegeln kann nur nach Positionen gesucht werden.

Aufbau der Tilde-Formel

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Wert(Kürzel="Kürzel des Buchs";Pos="Position/Konto")

Standardmäßig werden Werte eines Kontos oder einer Position in der definierten Standardwährung des Buchungskreises, Konsolidierungskreises oder der Konsolidierungseinheit in MS Excel eingelesen, den das angegebene Organisationselement referenziert. Um Werte in anderen Währungen in MS Excel einzulesen, können die beiden Parameter Transaktionswährung und Anzeigewährung verwendet werden. 

Aufbau der Tilde-Formel

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Wert(Pos="Position/Konto";Transaktions­währung="Transaktions­währung";Anzeige­währung="Anzeige­währung")

Schlüsselwörter

Als Werte für Transaktionswährung und Anzeigewährung können die in Lucanet im Arbeitsbereich Währungsumrechnung definierten Währungen verwendet werden.

Varianten

Das Resultat einer Abfrage hängt von den in der Tilde-Formel verwendeten Schlüsselwörtern ab. Die folgenden Varianten sind verfügbar:

  • Ohne Schlüsselwort
    Die Summe aller angegebenen Werte (in allen Transaktionswährungen) umgerechnet in die Standardwährung des Organisationselements
  • Nur Anzeigewährung
    Die Summe aller angegebenen Werte (in allen Transaktionswährungen) umgerechnet in die angegebene Anzeigewährung
  • Nur Transaktionswährung
    Die Summe aller in der angegebenen Transaktionswährung angegebenen Werte umgerechnet in die Standardwährung des Organisationselements
  • Transaktionswährung und Anzeigewährung
    Die Summe aller in der angegebenen Transaktionswährung angegebenen Werte umgerechnet in die angegebene Anzeigewährung

 

Um die Werte aller Transaktionswährungen zu erfassen, kann Transaktionswährung="All" verwendet werden, sofern der Standardname des Elements zur Wertabfrage aller Transaktionswährungen (Alle Transaktionswährungen) beibehalten wurde.

Sobald Sie das Element umbenennen, muss die Tilde-Formel entsprechend angepasst werden. Als Parameter müssen Sie in der Tilde-Formel anstelle von All mindestens die ersten drei Buchstaben des Elementnamens angeben.

Beispiel

Im Excel-Arbeitsblatt werden alle Varianten zur Abfrage der Position Anlagevermögen verwendet. In der Spalte Wert in wird die aus der Tilde-Formel resultierende Währung angezeigt, wenn die Standardwährung des gewählten Organisationselements EUR ist: 

Zeigt einen Excel-Ausschnitt. In der letzten Spalte sind Tildeformeln enthalten, die alle am Ende der Parameter 'Transaktionswährung enthalten=Währung' enthalten
Parameter 'Währung'

Der Parameter Bewegungsart ist optional und liest entweder die Werte eines Kontos oder die Werte für eine Bewegungsart (oder Bewegungsartengruppe aus dem Anlagespiegel) in MS Excel ein.

Aufbau der Tilde-Formel

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Wert(Pos="Position/Konto";Bewegungsart="Schlüsselwort")


Schlüsselwörter

Die folgenden Schlüsselwörter sind verfügbar:

  • Start
    Liefert den Anfangswert des Kontos zu einem bestimmten Datum
  • Verkehrszahlen/VZ
    Liefert die Veränderung des Kontos zu einem bestimmten Datum
  • Saldo
    Liefert den Saldo des Kontos zu einem bestimmten Datum

 

Schlüsselwörter für Bewegungsarten oder Bewegungsartengruppen

Soll der Wert für eine Bewegungsart oder für eine Bewegungsartengruppe ermittelt werden, muss die ID der Bewegungsart, das Kürzel der Bewegungsartengruppe oder ein Zellbezug auf eine Zelle mit einem entsprechenden Eintrag angegeben werden:

  • Name einer Bewegungsart, z. B. 110 Zugang
    Liefert den Wert 110 Zugang
  • AHK.Start oder WB.Start
    Liefert den Startwert in der Bewegungsartengruppe Anschaffungs- und Herstellungskosten oder Wertberichtigungen
  • AHK.VZ oder WB.VZ
    Liefert die Veränderung in der Bewegungsartengruppe Anschaffungs- und Herstellungskosten oder Wertberichtigungen
  • AHK.Saldo oder WB.Saldo
    Liefert den Saldo in der Bewegungsartengruppe Anschaffungs- und Herstellungskosten oder Wertberichtigungen.

 

Die Benennung der Schlüsselwörter hängt davon ab, wie die Benennung in den Dimensionen unter Bewegungsarten angegeben ist.

 

Beispiel

In der Funktion wird der Parameter Bewegungsart mit dem Schlüsselwort ba und einem Zellbezug (d11) verwendet:

Zeigt einen Excel-Ausschnitt mit einer Tildeformel und einer Tabelle. Rot herovrgehoben ist die Zelle D11 mit der Bewegungsart AHK.Start und den Teil der Tildeformeln mit dem Parameter ba=d11) Parameter 'Bewegungsart'

Der Parameter Kein Fehler ist optional und gibt an, dass die Fehlermeldung unterdrückt werden soll, wenn die gesuchte Position oder das Konto nicht gefunden wird. Der Rückgabewert der Funktion Wert ist in diesem Fall 0.

Aufbau der Tilde-Formel

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Wert(Pos="Position/Konto";Kein Fehler)

Mithilfe des Parameters YTD kann der Wert eines Kontos oder einer Position für den Year-To-Date-Zeitraum bis zur aktuellen Periode abgefragt werden.

Aufbau der Tildeformel

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Wert(Pos="Position/Konto";YTD="Year to date")

Beispiel

Im folgenden Beispiel werden die Werte für die Position Löhne und Gehälter für den Zeitraum zwischen Juli 2017 (= "YTD 07") und der aktuell für den Bericht eingestellten Periode ab (z. B. November 2017) abgefragt.  

Zeigt einen Excel-Ausschnitt mit einer Tildeformel. Rot hervorgehoben ist die Abfrage mithilfe des YTD-Parameters
Optionaler Parameter 'YTD'
Schlüsselwörter für die Funktion 'Wert'

Für die Parameter der Funktion Wert sind folgende Schlüsselwörter verfügbar:

  • Position/Konto: Position, Pos , Konto, Kon 
  • Periode: Periode, Zeitraum 
  • Organisationselement: Organisationselement, OE 
  • Datenebene: Datenebene, DE
  • Bewertungsebene: Bewertungsebene, BE
  • Transaktionswährung: Transaktionswährung, TW
  • Anzeigewährung: Anzeigewährung, Währung, AW
  • Partner: Partner, P

 

Die folgende Tabelle zeigt Beispiele für Schlüsselwörter mit zugewiesenen Werten:


Beispiel

Beschreibung


Posi­tion="Umsatz"

Wert in Anführungszeichen

Es wird nach der Position Umsatz gesucht.


Daten­ebene=A3

Absoluter Zellbezug

Es wird nach der Datenebene gesucht, deren Kürzel in der Zelle A3 steht.


Organi­sationsele­ment=8

Bezug auf Zeile

Es wird nach dem Organisationselement gesucht, dessen Kürzel in der Zeile 8 in derselben Spalte steht.


Position=A

Bezug auf Spalte

Es wird nach der Position gesucht, deren Name in der Spalte A in derselben Zeile steht.


Position=A:C

Bezug auf einen Zellbereich

Es wird nach der Position gesucht, deren Name in der ersten nicht leeren Spalte in derselben Zeile in den Spalten A bis C steht.


Periode=Zeit­raum.Vergleich

Bezug auf Platzhalter

Es wird die Periode verwendet, die durch den Platzhalter Zeitraum.Vergleich repräsentiert wird.


Bewertungs­ebene=Über­schrift

Bezug auf benannte Zelle

Es wird nach einer Bewertungsebene gesucht, deren Kürzel  in der Zeile, die mithilfe der Anweisung Zeile: Überschrift benannt wurde, in derselben Spalte steht (siehe Zeilen und Spalten benennen).


Beispiel für die Funktion 'Wert'

Im Excel-Arbeitsblatt hat die Funktion Wert Parameter für die Position (pos), die Periode (periode) und die Bewegungsart (ba).

In der Tilde-Formel werden Bezüge auf einen Zellbereich (pos=b:c), eine Zelle (c12) und auf eine Zeile (15) verwendet: 

Zeigt einen Excel-Ausschnitt mit Tildeformeln. Mariert ist die Tildeformel für o.g. beispiel Funktion 'Wert'
Weitere Funktionen

Folgende weitere Funktionen können in einer Tilde-Formel eingesetzt werden:

Mithilfe der Funktion Währung kann die Standardwährung von Elementen aus dem Arbeitsbereich Buchungskreise oder dem Arbeitsbereich Organisationselemente in MS Excel eingelesen werden.

Aufbau der Tilde-Formel

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Währung(Organisationselement="Name des Elements")

Als Organisationselement können folgende Elemente angegeben werden:

  • Referenz auf Buchungskreis
  • Referenz auf Kostenstelle
  • Referenz auf Kostenstellengruppe
  • Referenz auf Konsolidierungskreis
  • Referenz auf Konsolidierungseinheit
  • Referenz auf Konsolidierungseinheitengruppe
  • Organisationsgruppe

 

Die Angabe eines Elements ist optional. Wird kein Element angegeben, muss der Benutzer beim Erzeugen des Berichts ein Element wählen. 

Beispiel

Im Excel-Arbeitsblatt wird der Parameter Organisationselement der Funktion Währung mit einem Bezug auf die Zelle B2 spezifiziert: 

Zeigt einen Excel-Ausschnitt mit einer Tildeformel ~Währung
Funktion 'Währung'

Mit der Funktion Kurs kann der Durchschnittskurs, der Stichtagskurs oder der YTD-Kurs, zu dem eine Transaktionswährung in eine Anzeigewährung umgerechnet wird, in MS Excel eingelesen werden.

Aufbau der Tilde-Formel

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Kurs(Tabelle="Name der Wechselkurs­tabelle";Datenebene;Kursart;Periode)


Schlüsselwörter

Für den Parameter Kursart sind folgende Schlüsselwörter verfügbar:

  • Stichtagskurs: Liefert den Stichtagskurs eines Monats
  • Durchschnittskurs: Liefert den Durchschnittskurs eines Monats
  • YTD-Kurs: Liefert den YTD-Kurs eines Monats

 

Es kann immer nur genau eins der verfügbaren Schlüsselwörter angegeben werden.

Beispiel

Im Excel-Arbeitsblatt werden Stichtagskurs und Durchschnittkurs für die Tabelle USD -> EUR in der Datenebene Ist monatlich (~monat) in MS Excel eingelesen. In der Tilde-Formel werden Datenebene (B2), Stichtagskurs (B) und Periode (4) mithilfe von Zellbezügen verwendet:

Zeigt einen Excel-Ausschnitt mit einer Tildeformel ~Kurs Funktion 'Kurs'

Der erzeugte Bericht sieht wie folgt aus:

Zeigt einer Auschnitt aus einer Excel-Datei. Die Spalten sind verschiedene Monate, Zeile 6 ist der Stichtagskurs, Zeile 8 der Durchschnittskurs pro Monat Ergebnis für Funktion 'Kurs'

Mit der Funktion Attribut kann die Abfrage von Attributwerten realisiert werden. Die Funktion Attribut kann außerdem mit den Tilde-Formeln ~Fülle Zeilen und ~Fülle Spalten kombiniert werden, um zusätzlich zu den OIDs von Elementen auch ihre Namen in MS Excel einzulesen.

Aufbau der Tilde-Formal

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Attribut(Attribut;Element)
 

Parameter der Funktion Attribut

Folgende Parameter müssen angegeben werden:

  • Attribut: Schlüssel des Attributs, dessen Wert in MS Excel eingelesen werden soll
  • Element: Name oder URL des Elements, dessen Attributwert in MS Excel eingelesen werden soll


Beispiel

Im Excel-Arbeitsblatt wird die Funktion Attribut zur Abfrage der deutschen Namen (Attribut=name) und der englischen Namen (Attribut=name_eng) von Positionen und Konten verwendet. In Spalte C wird in Zeile 3 ein Zellbezug (b) und in Zeile 4 direkt die URL des Kontos verwendet:

Zeigt einen Excel-Ausschnitt mit einer Tildeformel ~Attribut Funktion 'Attribut'

Der erzeugte Bericht sieht wie folgt aus:

Zeigt einen Excel-Ausschnitt mit dem Ergebnis der Funktion Attribut. Angezeigt werden die Spalten "Position/Konto URL", "Position/Konto Name", "Position/Konto Name Englisch" und in den Zeilen die entsprechenden Werte aus der Lucanet-Datenbank Ergebnis für Funktion 'Attribut'

Mit der Funktion Dokument kann auf die Beschreibung von Elementen zugegriffen werden.

Aufbau der Tilde-Formel

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Dokument(Element)

Der Parameter Element repräsentiert das Element, dessen Beschreibung Sie in MS Excel übernehmen wollen.

Beispiel

Die Tilde-Formel liefert die Beschreibung der Datenebene mit der URL ln:goto/LNFC/demo?oid=12907.

Zeigt einen Excel-Ausschnitt mit einer Tildeformel ~Dokument
Funktion 'Dokument'

Aktuell können in der CFO Solution Platform noch keine Beschreibungen zu Elementen hinzugefügt werden. Deshalb können derzeit mit der Funktion Dokument ausschließlich Beschreibungen abgerufen werden, die im Lucanet.Financial Client für Elemente hinzugefügt wurden.

Mithilfe der Funktion Kommentar können Kommentare zu Positionen und Konten in MS Excel eingelesen werden.

Aufbau der Tilde-Formel

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Kommentar(Position/Pos/Kon­to/Kon="Position/Konto";Periode="Pe­riode";Datenebene="Datenebene";Bewer­tungsebene="Bewertungsebene";Organi­sationselement="Organisationselement")

Die Angabe einer Datenebene, Bewertungsebene und eines Organsiationselements ist optional. Wird kein Element angegeben, muss der Benutzer beim Erzeugen des Berichts eines dieser Elemente wählen.

Beispiel

Die Tilde-Formel liefert den Kommentar zur Position Technische Anlagen und Maschinen im November 2017:

Zeigt einen Excel-Ausschnitt mit einer Tildeformel ~Kommentar Funktion 'Kommentar'

Aktuell können in der CFO Solution Platform noch keine Kommentare für Positionen oder Konten hinzugefügt werden. Deshalb können derzeit mit der Funktion Kommentar ausschließlich Kommentare abgerufen werden, die im Lucanet.Financial Client für Positionen oder Konten hinzugefügt wurden.

Kontaktieren Sie uns