Framework:Formeln: Unterschied zwischen den Versionen

Aus CoPlanner 10
Zur Navigation springenZur Suche springen
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Zeile 74: Zeile 74:
===[[:Kategorie:Funktionen_-_serverseitig|Funktionen]]===
===[[:Kategorie:Funktionen_-_serverseitig|Funktionen]]===


Funktionen können im Formeldesigner ausgewählt werden und ermöglichen umfangreiche Berechnungen und Datenmanipulationen in Formeln. Eine Übersicht der [[:Kategorie:Framework_Formeln|CoPlanner Funktionen]] finden Sie [[:Kategorie:Framework_Formeln|hier]]
Funktionen können im Formeldesigner ausgewählt werden und ermöglichen umfangreiche Berechnungen und Datenmanipulationen in Formeln. Eine Übersicht der [[:Kategorie:Funktionen_-_serverseitig|CoPlanner Funktionen]] finden Sie [[:Kategorie:Funktionen_-_serverseitig|hier]]


===Bedingungen===
===Bedingungen===

Version vom 16. November 2010, 13:29 Uhr

Eine Formel ist ein Objekt, dass zumindest eine Quell- und eine Zieltabelle besitzt. Diese können zwar auch dieselbe Tabelle sein, grundsätzlich unterscheiden sich Formeln von berechneten Feldern (siehe Tabellendesigner) durch einen erweiterten Verwendungsgrad, komplexere Anwendungsmöglichkeiten und einer meist höheren Ausführungszeit.

Formel-Designer

Verknüpfungen

Framework, Formeln

Aktiv

Die Formel wird ausgeführt, wenn ein Datensatz in der Quelltabelle gespeichert wird. Dieses Speichern wird entweder durch eine User-Eingabe und dem Klick auf den Speicher-Button ausgelöst, oder aber durch eine andere Formel, die als Zieltabelle obige Quelltabelle eingestellt hat. Eine weitere Möglichkeit aktive Formeln ausführen zu lassen, ist per Makrobefehl „Tabellensätze dieses Plans neu rechnen“.

Bei Makro rechnen

Die Formel wird ausgeführt, wenn man im MakroMode ist. Man wechselt in diesen MakroMode mit dem Makro-Befehl „Session Parameter ändern“, mit dem Parameter „MakroMode=1. Mit dem Parameter „MakroMode=0“ wechselt man wieder in den User-Modus.

Formelart

Bezieht sich auf die Ausführungslogik der Fromel, wobei folgende Typen unterschieden werden:

  • Single: Ein Datensatz erzeugt einen anderen Datensatz
  • Same: Ein Datensatz rechnet auf sich selbst, beschreibt also bspw. ein Feld des selben Datensatzes
  • Aggregat: Mehrere Datensätze werden zu einem Datensatz zusammengefasst
  • Quellsatz: Nicht implementiert

Quelltabelle

Jene Tabelle oder Dimension, welche als Auslöser für die Formel dienen soll

Zieltabelle

Jene Tabelle oder Dimension, in welcher ein Feld oder Lookup geschrieben werden soll.

Execution Order

Reihenfolge der Abarbeitung. Ist dann zu verwenden, wenn mehrere Formeln dieselbe Quelltabelle verwenden, und die Reihenfolge der Berechnungen wichtig ist. Bspw. soll in der Erfolgsplanung jene Formel die den Ust-Betrag mittels dem UST-Satz errechnet, vor der Formel ausgeführt worden sein, die diesen Ust-Betrag dann weiter in die Zahllast-Ermittlung rechnet.

Löschweitergabe

Vorgänger

Wenn aktiv, dann werden beim Löschen eines Datensatzes der aus einer Formel generiert wurde, auch die dazugehörigen Quelldatensätze gelöscht. Dieses Verhalten ist nur in Ausnahmefällen gewünscht.

Nachfolger

Mit dieser Option werden die aus dem Quellsatz erzeugten Zielsätze automatisch gelöscht, wenn der Quellsatz gelöscht wird. Dieses Verhalten ist in den meisten Fällen gewünscht!

Hinweis  Die Löschweitergabe betrifft nur Formeln des Typs Single. Bei Formeln des Typs Same ist diese Einstellung wirkungslos, da der Satz selbst ja gelöscht wird. Bei Formeln des Typs Aggregat, wird beim Löschen eines Quellsatzes die Formeln ausgeführt, nicht aber der Zielsatz gelöscht, da dieser ja mehrere Quellsätze zu einem Zielsatz zusammenfasst.


Iterationstabelle

Um eine Formel mehrfach mit verschiedenen Parametern aufzurufen, können Iterationen verwendet werden. Sollen die Elemente, über die iteriert werden sollen, aus einer Tabelle kommen, wird diese hier ausgewählt (siehe nachfolgendes Beispiel unter Iterationen).


Zuweisungen Bedingungen

Framework, Formeln - Bedingungen & Formeln

Zuweisungen

Im oberen Teil des Registers „Zuweisungen Bedingungen“ werden nun die Inhalte einer Formel definiert. Während in der linken Spalte „Quelle“ eine Berechnung oder ein Wert aus der Quelltabelle stehen, wird in der rechten Spalte „Ziel“ das zu beschreibende Feld der Zieltabelle ausgewählt. Um meine neue Verbindung anzugeben, klicken Sie auf die obere „Add“-Schaltfläche. Danach springen Sie mit Klick auf das …-Symbol in den Editor des jeweiligen Feldes. Dort stehen Ihnen dann alle Felder der Quell- bzw. Zieltabelle sowie alle Funktionen, Variablen und Anwendungseigenschaften zur Verfügung.

Gemeinsame Lookups synchron halten

Verbindungen zwischen Quelle und Ziel werden für Wertfelder explizit durch eigene Zeilen in den Zuweisungen angegeben. Auch Dimensionen können auf diese Weise verknüpft werden – durch Anklicken des Hakens „Gemeinsame Lookups synchron halten“ werden jedoch alle Dimensionen, deren Alias-Namen zwischen Quelle und Ziel übereinstimmen, automatisch synchronisiert. Felder, die nicht verknüpft sind bzw. durch diese Option verbunden werden können, werden im Ziel bei Neuanlage mit deren Standardwert versorgt.

Funktionen

Funktionen können im Formeldesigner ausgewählt werden und ermöglichen umfangreiche Berechnungen und Datenmanipulationen in Formeln. Eine Übersicht der CoPlanner Funktionen finden Sie hier

Bedingungen

Im unteren Teil des Registers „Zuweisungen Bedingungen“ werden nun allfällige Bedingungen für die Formel definiert, das heißt die Formel wird nur angewandt, wenn bestimmte Bedingungen erfüllt sind. Im Standardmodell des CoPlanner sind zum Beispiel alle Formeln auf den Planzeitraum eingeschränkt. Um eine neue Bedingung einzufügen, klicken Sie auf die untere „Add“-Schaltfläche. Danach springen Sie mit Klick auf das …-Symbol in den Editor des jeweiligen Feldes. Dort stehen Ihnen dann alle Felder der Quell- und Zieltabelle sowie alle Funktionen, Variablen und Anwendungseigenschaften zur Verfügung. Zwischen den beiden zu vergleichenden Werten wählen Sie bitte einen passenden Vergleichsoperator aus und definieren am Ende einen Vergleichstyp (Numerisch, Text oder Datum). Ist die angegebenen Bedingung erfüllt (z. B. [Umsatzerloese_PLAN.Umsatz]>0), wird die Formel für diesen Datensatz ausgeführt.

Iterationen

Framework, Formeln - Iterationen

Iterationen erlauben die mehrfache Abarbeitung einer Formel mit verschiedenen Parametern. Dazu wird das Register Iterationen verwendet. Fügen Sie zunächst mit der Schaltfläche „Parameter hinzufügen“ einen Parameter (eine Spalte) hinzu, danach fügen Sie mittels „Iteration hinzufügen“ beliebig viele Zeilen ein. Dann vergeben Sie Werte für den Parameter.

Benötigen Sie weitere Parameter, fügen Sie diese mit der Schaltfläche „Parameter hinzufügen“ hinzu. Mit „Parameter löschen“ können diese auch wieder gelöscht werden. Um eine einzelne Iteration zu löschen, markieren Sie diese und drücken Entf oder das X-Symbol am rechten Ende des Datensatzes.

In der Formel selbst sprechen Sie die in den Feldern „Parameter“ defnierten Werte mit dem Platzhalter [PAR 0] etc. an.

Haben Sie also eine Formel definiert, die den Wert [PAR 0]*100 in ein Zielfeld schreibt und danach zwei Iterationen definiert, die die Werte 0,8 und 0,2 beinhalten, werden bei der Abarbeitung der Formel zwei Zieldatensätze erzeugt, einer mit dem Wert 80 und einer mit dem Wert 20.

Ist eine Iterationstabelle angegeben, wird das Register „Iterationen“ durch das Register „Spaltenmapping für Iterationstabelle“ ersetzt. Da nun eine Tabelle angegeben ist, über die iteriert wird, werden automatisch alle Datensätze dieser Iterationstabelle nacheinander abgearbeitet. Dabei können alle zur Verfügung stehenden Felder dieser Tabelle als Parameter verwendet werden. Diese werden durch „Mapping hinzufügen“, Klick auf „Neuen Eintrag“ und Auswahl eines Feldes angegeben.

Die Zeit-Dimension wird häufig für solche Iterationen verwendet, wenn etwa für alle Monate in einem bestimmten Zeitraum (zu definieren über die Bedingungen der Formel) ein Datensatz erzeugt werden soll. Bei der Zeitdimension empfiehlt sich darüber hinaus die Einschränkung nur auf Monate, z. B. über die Funktion „fkt_TimeDimTypeFlag.

Datei:Fw Formeln Spaltenmapping für Iterationstabelle.jpg
Framework, Formeln - Spaltenmapping für Iterationstabelle


Groups

Diese werden nur beim Formeltyp AGGREGAT verwendet. Sie definieren, nach welchen Look-Ups in der Zieltabelle der Zieldatensatz ermittelt werden soll.

Framework, Formeln - Groups

Zielsatzbindung

Die Option „Zielsatzbindung“ gibt an, ob die erzeugten Gruppen von Datensätzen je Tabelle, je Formel oder nur bezogen auf die in der Gruppierung angegebenen Felder aktualisiert werden sollen.


Interationen

Framework, Formeln - Groups

Ist im Register „Verknüpfung“ eine Iterationstabelle angegeben, kann hiermit zu den Datensätzen der Iterationstabelle gesprungen werden.