Anweisungen

Überblick

Mithilfe von Anweisungen in einer Tilde-Formel können in einen Excel-Bericht dynamisch Spalten oder Zeilen eingefügt oder Zeilen oder Spalten benannt werden. 

Aufbau der Tilde-Formel für Anweisungen

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

~Anweisung:"Parameter_1";"Parameter_2"

 

Regeln für Anweisungen in Tilde-Formeln

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

  • Anweisungen enden stets mit einem Doppelpunkt ( : ) gefolgt von den Parametern für die Anweisung.
  • Die Parameter einer Anweisung müssen in Anführungszeichen ( " ) stehen.
  • Mehrere Parameter werden durch ein Semikolon ( ; ) getrennt.
Verfügbare Anweisungen

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

Zeilen und Spalten benennen

Mithilfe der Anweisungen Zeile und Spalte kann die betreffende Zeile oder Spalte benannt werden, sodass auf diese in Funktionen nicht nur anhand der Zeilen- oder Spaltennummer, sondern auch anhand des Namens zugegriffen werden kann.

Der Zugriff über Namen hat den Vorteil, dass Funktionen auch nach dem Einfügen von Zeilen und Spalten (wodurch sich die Nummerierung der bereits vorhandenen Zeilen und Spalten ändern kann), einen korrekten Zellbezug besitzen.

Aufbau der Tilde-Formel, um Zeilen und Spalten zu benennen

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Zeile/Spalte:"Name"

Hinweis: Der Name der Zeile oder Spalte darf keinem Platzhalter entsprechen.

 

Beispiel

In der folgende Berichtsvorlage wird Zeile 5 mit Periode benannt. In der Funktion Wert wird über den Namen Periode auf die Zeile mit den Periodenüberschriften zugegriffen:

Anweisung 'Zeile benennen' Anweisung 'Zeile benennen'

Der erzeugte Bericht sieht wie folgt aus:

Ergebnis der Anweisung 'Zeile benennen' Ergebnis der Anweisung 'Zeile benennen'
Zeilen und Spalten einfügen

Mithilfe der Anweisungen Fülle Zeilen und Fülle Spalten können auf der Grundlage der jeweiligen Zeile in einen Excel-Bericht weitere Zeilen oder Spalten dynamisch eingefügt werden.

 

Aufbau der Tilde Formel, um Spalten und Zeilen einzufügen

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Fülle Zeilen/Fülle Spalten:Schlüsselwort=Position/Organi­sationselement/Partner/Bewegungs­art/Bewertungsebene/Datenebene;[Kürzel];[Name/OID];[Keine Nullwerte];[Ebene]

Die Parameter Kürzel, Name/OID, Keine Nullwerte und Ebene können abhängig vom Parameter optional genutzt werden.

 

Schlüsselwörter für Positionen und Organisationselemente

In den Zeilen oder Spalten eines Excel-Arbeitsblatts können Positionen oder Konten sowie Organisationselemente eingefügt werden. Die folgenden Schlüsselwörter sind verfügbar:

  • Position="Aktiva" oder Pos="Aktiva"
    Alle Positionen oder Konten, die der Position Aktiva direkt untergeordnet sind
  • Position=B7 oder Pos=B7
    Alle Positionen oder Konten, die der Position in Zelle B7 direkt untergeordnet sind
  • Organisationselement="Konzern" oder OE="Konzern"
    Alle Organisationselemente, die dem Organisationselement Konzern direkt untergeordnet sind
  • Organisationselement=B oder OE=B
    Alle Organisationselemente, die dem Organisationselement in der Spalte B direkt untergeordnet sind

 

Schlüsselwörter für Dimensionselemente

In den Zeilen oder Spalten eines Excel-Arbeitsblatts können Elemente aus den Arbeitsbereichen Partner, Datenebenen, Bewertungsebenen und Bewegungsarten eingefügt werden. D. h. es können Partner, Datenebenen, Bewertungsebenen oder Bewegungsarten eingefügt werden, die unter Ordnern hängen. Bei Partnern können auch Elemente unterhalb von Partnergruppen eingefügt werden.

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

  • Partner="Tochter USA" oder P="Tochter USA"
    Alle Partner, die der Partnergruppe Tochter USA direkt untergeordnet sind
  • Datenebene=lucanet://db=data­base&oid=123456 oder DE=lucanet://db=database&oid=123456
    Alle Datenebenen, die dem Ordner mit der OID 123456 direkt untergeordnet sind
  • Bewertungsebene=lucanet://db=data­base&oid=234567 oder BE=lucanet://db=database&oid=234567
    Alle Bewertungsbenen, die dem Ordner mit der OID 234567 direkt untergeordnet sind
  • Bewegungsart=lucanet://db=data­base&oid=345678 oder BA=lucanet://db=database&oid=345678
    Alle Bewegungsarten, die dem Ordner 345678 direkt zugeordnet sind
  • Ordner für Datenebenen, Bewertungsebenen und Bewegungsarten können nicht mithilfe ihres Namens abgefragt werden, sondern müssen mit ihrer OID angesprochen werden. 
  • Seit Lucanet 11 LTS werden Links auf Lucanet-Elemente im Format ln:goto/LNFC/datenbankname?oid=XXXXX erstellt. Das bisherige Format lucanet://db=daten­bankname&oid=XXXXX bleibt jedoch gültig und kann weiterhin verwendet werden. In einigen Beispielen zum Lucanet.Excel-Reporting wird daher das Format lucanet://db=datenban­kname&oid=XXXXX verwendet.

Beispiel

Das Excel-Arbeitsblatt enthält eine Tilde-Formel mit der Anweisung Fülle Zeilen. In der Formel wird die URL der Position Sonstige betriebliche Aufwendungen verwendet:

Anweisung 'Fülle Spalten' Anweisung 'Fülle Spalten'

Im erzeugten Bericht werden alle in Sonstige betriebliche Aufwendungen enthaltenen Positionen angezeigt. Die Zeile 19 zeigt die Gesamtsumme aller Positionen:

Ergebnis der Anweisung 'Fülle Spalten' Ergebnis der Anweisung 'Fülle Spalten'

Optionale Parameter

Je nach Parameter können für die Anweisungen Fülle Zeilen und Fülle Spalten folgende optionale Parameter verwendet werden:

Je nach Parameter können folgende optionale Parameter verwendet werden. Die optionalen Parameter sind im Folgenden ausführlich beschrieben.

  • Mit Parameter Position: Kürzel, Ebene, Keine Nullwerte, Name/OID
  • Mit Parameter Organisationselement: Kürzel, Ebene, Keine Nullwerte, Name/OID
  • Mit Parameter Partner: Ebene, Keine Nullwerte, Name/OID
  • Mit Parameter Datenebene: Keine Nullwerte, Name/OID
  • Mit Parameter Bewertungsebene: Keine Nullwerte, Name/OID
  • Mit Parameter Bewegungsart: Keine Nullwerte, Name/OID

Der Parameter Kürzel ist optional und gibt das Buch oder den Spiegel an, aus dem Positionen oder Konten eingefügt werden sollen. Der Parameter Kürzel wird verwendet, wenn eine Position oder Konto in mehreren Büchern oder Spiegeln vorkommt.

Hinweis: In Spiegeln kann nur nach Positionen gesucht werden.

Aufbau der Tilde-Formel für 'Kürzel'

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Fülle Zeilen/Fülle Spalten:Kürzel="Kürzel";pos="Position"/Organisationselement="Organisationselement"

Schlüsselwörter

Das Schlüsselwort legt fest, woher die einzulesenden Daten bezogen werden. Folgende Schlüsselwörter sind zulässig:

  • Kürzel des Hauptbuchs, Kürzel des Hauptbuchs inklusive Nebenbücher oder Kürzel eines Spiegels
    Einlesen von Werten aus Büchern oder Spiegeln mit dem angegebenen Kürzel
  • fin
    Das Schlüsselwort fin kann weiterhin verwendet werden, um Werte aus den Büchern auszulesen, in die die Bilanz und GuV früherer Versionen überführt wurden.
  • stat
    Das Schlüsselwort stat kann weiterhin verwendet werden, um Werte aus einem Statistikbuch auszulesen, in das die Werte früherer Versionen überführt wurden.

 

Beispiel für 'Kürzel'

Die Anweisung Fülle Zeilen liest alle Positionen unterhalb von Aktiva aus dem Hauptbuch für die Bilanz mit dem Kürzel B in MS Excel ein:  

Zeigt einen Excel-Ausschnitt mit der Tildeformel Fülle Zeiler und dem Parameter 'Kürzel'
Anweisung 'Fülle Zeilen' mit Parameter 'Kürzel'

Der Parameter Ebene ist optional und gibt an, welche Ebene unterhalb der gewählten Position, des gewählten Kontos, des gewählten Organisationselements oder der gewählten Partnergruppe in MS Excel eingelesen werden soll. Wird der Parameter nicht angegeben, wird nur die auf das Element folgende Ebene eingefügt.

Aufbau der Tilde-Formel für 'Ebene'

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Fülle Zeilen/Fülle Spalten:Schlüsselwort=Position/Konto/Organisationselement/Partnergruppe;Ebene=x

Werte für 'Ebene'

Folgende Werte für Ebene sind möglich:

  • Zahl, z. B. 2
    Fügt die mit der Zahl definierte Ebene unterhalb der angegebenen Position, des Kontos, des Organisationselements oder der Partnergruppe ein. Wird eine tiefere als die erste Ebene eingefügt, werden die Elemente der Zwischenebenen nicht eingefügt, sondern nur die Elemente, die sich auf der angegebenen Ebene befinden.
  • Konto
    Fügt alle Konten unter dem angegebenen Konto in alphabetischer Reihenfolge ein
  • Position
    Fügt alle untersten Positionen unter der angegebenen Position in alphabetischer Reihenfolge ein, denen keine weiteren Elemente untergeordnet sind
     

Hinweis: Bei Partnergruppen ist für Ebene nur die Angabe einer Zahl (z. B.: Ebene=2) zulässig. Die Parameter Konto und Position sind nicht erlaubt.

Beispiel für 'Ebene'

In der Anweisung wird angegeben, dass die zweite Ebene unterhalb der Position mit der URL lucanet://db=demo&oid=2408240 (= Sonstige betriebliche Aufwendungen) in MS Excel eingelesen werden soll:

Zeigt einen Excel-Ausschnitt mit der Tildeformel Fülle Zeiler und dem Parameter 'Ebene' Anweisung 'Fülle Zeilen' mit Parameter 'Ebene'

In Lucanet existieren unterhalb der Position Sonstige betriebliche Aufwendungen zwei Ebenen: 

Zeigt ein Buch in Lucanet mit einer Position und mehreren Unterebenen Position mit mehreren Ebenen

Im Bericht werden die Positionen und Werte der zweiten Ebene angezeigt:

Zeigt einen Excel-Ausschnitt. In Spalte B/C der Tabelle sind die Positionen der zweiten Ebene der Position Sonstige betriebliche Aufwendungen aufgeführt. Ergebnis für Parameter 'Ebene'

Der Parameter Keine Nullwerte ist optional und gibt an, dass Zeilen oder Spalten, die in Lucanet keine Werte enthalten, nicht in MS Excel dargestellt werden sollen.

Aufbau der Tilde-Formel für 'Keine Nullwerte'

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Fülle Zeilen/Fülle Spalten:Schlüsselwort=Position/Konto/Organisationselement/Partner/Datenebene/Bewertungsebene/Bewegungsart;Keine Nullwerte

Der Parameter Name/OID ist optional und gibt an, ob die abgefragten Elemente mit Namen oder mit ihrer URL in MS Excel importiert werden sollen.

Aufbau der Tilde-Formel für 'Name/OID'

Die Tilde-Formel muss wie folgt aufgebaut sein:

~Fülle Zeilen/Fülle Spalten:Name/OID;Schlüsselwort=Position/Organisationselement/Partner/Datenebene/Bewertungsebene/Bewegungsart

Schlüsselwörter

Das Schlüsselwort legt fest, ob die einzulesenden Elemente mit Namen oder mit OID in MS Excel importiert werden sollen. Folgende Schlüsselwörter sind zulässig:

  • Name
    Die Namen der Elemente werden in MS Excel importiert.
  • OID
    Die URL der Elemente wird in MS Excel importiert.

 

Beispiel

In ~Fülle Zeilen wird angegeben, dass die OIDs der Elemente unterhalb der Position mit der URI ln:goto/LNFC/demo_group?oid=12907 in MS Excel eingelesen werden soll:

Zeigt einen Excel-Ausschnitt mit der Tildeformel Fülle Zeiler und dem Parameter OID
Anweisung 'Fülle Zeilen' mit Parameter 'OID'
  • Wird der Parameter Name/OID nicht verwendet, werden die Namen der abgefragten Elemente in MS Excel erzeugt.
  • Wird der Parameter OID verwendet, können mithilfe der Funktion Attribut zusätzlich die Namen der abgefragten Elemente in MS Excel importiert werden (siehe Abschnitt Funktion Attribut).
Kontaktieren Sie uns