FKT Set: Unterschied zwischen den Versionen

Aus CoPlanner 11
Zur Navigation springenZur Suche springen
T.auer (Diskussion | Beiträge)
K weiteres Beispiel
Ergänzung Bedingung
Zeile 9: Zeile 9:
Die Bedingungen könne sich dabei auf in der Dimension vorhandene Dimensionen beziehen, Attribute könne nicht direkt gefiltert werden.  
Die Bedingungen könne sich dabei auf in der Dimension vorhandene Dimensionen beziehen, Attribute könne nicht direkt gefiltert werden.  


{| class="wikitable" width="{{{breite|100%}}}"
|-
! width="150pt" |Parameter
!Beschreibung
|-
|Bedingung 1 bis n
| Jede Bedingung besteht aus 3 Teilen, dem einzuschränkenden Attribut, einem Operator und der Einschränkung selbst. Beispiel: COPSYS_ID me @Session_Unternehmen_ID@.
Das einzuschränkende Attribut bezieht sich immer auf die Dimension auf der das FKT_SET gesetzt wird. Daher sind diese nur mit dem Namen anzugeben. Falls eine Dimension als Attribut mehrfach in der Dimension vorkommt, dann kann durch Angabe des Alias oder des LookUp-Appendix die gewünschte Dimension angegeben werden. Wird kein Appendix angegeben und kein Alias verwendet, wird immer die LookUp-Dimension _1 genommen. Anzugeben wäre dies z.B.: Unternehmen_1 me @Session_Unternehmen_ID@
Der Operator ist mit einem Vergleichstyp anzugeben, wobei folgende erlaubt sind:
:* me+under
:*me
:*<>
:*>
:*>=
:*<
:*<=
Die Einschränkung = wird bei Dimensionen immer als me interpretiert, und ist nur aus Kompatibilitätsgründen enthalten.
Die Einschränkung selbst kann jeder Datenpfad, Variable oder Funktion sein, die eine gültige COPSYS_ID liefert.
|}
==Ergebnis==
==Ergebnis==
Liefert alle Elemente, auf welche die Bedingung(en) zutreffen.
Liefert alle Elemente, auf welche die Bedingung(en) zutreffen.

Version vom 9. April 2025, 07:38 Uhr

Funktion

FKT_Set('<Bedingung 1>', ..., '<Bedingung n>')

Diese Funktion gehört zu den serverseitigen Funktionen.

FKT_Set dient dazu, Elemente aus einer Dimension auszuwählen, bzw. eine Dimension einzuschränken (ähnlich wie dies bisher über RuleFilter gelöst werden konnte). Der Aufbau der Syntax ist dabei an Funktionen wie FKT_SUM oder FKT_AGG orientiert.

Die Bedingungen könne sich dabei auf in der Dimension vorhandene Dimensionen beziehen, Attribute könne nicht direkt gefiltert werden.

Parameter Beschreibung
Bedingung 1 bis n Jede Bedingung besteht aus 3 Teilen, dem einzuschränkenden Attribut, einem Operator und der Einschränkung selbst. Beispiel: COPSYS_ID me @Session_Unternehmen_ID@.

Das einzuschränkende Attribut bezieht sich immer auf die Dimension auf der das FKT_SET gesetzt wird. Daher sind diese nur mit dem Namen anzugeben. Falls eine Dimension als Attribut mehrfach in der Dimension vorkommt, dann kann durch Angabe des Alias oder des LookUp-Appendix die gewünschte Dimension angegeben werden. Wird kein Appendix angegeben und kein Alias verwendet, wird immer die LookUp-Dimension _1 genommen. Anzugeben wäre dies z.B.: Unternehmen_1 me @Session_Unternehmen_ID@

Der Operator ist mit einem Vergleichstyp anzugeben, wobei folgende erlaubt sind:

  • me+under
  • me
  • <>
  • >
  • >=
  • <
  • <=


Die Einschränkung = wird bei Dimensionen immer als me interpretiert, und ist nur aus Kompatibilitätsgründen enthalten.

Die Einschränkung selbst kann jeder Datenpfad, Variable oder Funktion sein, die eine gültige COPSYS_ID liefert.

Ergebnis

Liefert alle Elemente, auf welche die Bedingung(en) zutreffen.

Beispiel

Man hat eine einfache Dimension Regionen, die wie folgt aussieht:


Die einzelnen Orte der Bezirke haben dabei ein Attribut "Einwohnerzahl", das angibt, ob die Orte mehr als 10.000 Einwohner haben.

Zusätzlich definiert man eine Anwendungseigenschaft für mehr als 10.000 Einwohner.


Wenn man jetzt in einer einfachen Maske die Regionen auf die Achse gibt, und folgenden Ausdruck bei AvailableElementsExpression der Dimension angibt:

FKT_SET('Einwohnerzahl != ' + @EinwohnerZehntausend@)


so erhält man folgendes Ergebnis auf der Achse:


Es kann auf Session-Variablen und Anwendungseigenschaften zugegriffen werden, und gleich wie in FKT_SUM... auf Filter in der Maske.

Anwendung der Funktion erfolgt z.B. bei Matrixmasken in der ReadOnlyElementsExpression oder AvailableElementsExpression.


Verwandte Funktionen:

  • FKT_SPARSESUBTREE: wie FKT_SET, liefert aber zusätzlich einen Teilbaum (bis zu einem gemeinsamen Parent); im oben beschriebenen Beispiel erhält man folgendes Ergebnis:
  • FKT_FULLSUBTREE: wie FKT_SET, liefert aber zusätzlich alle Parentelemente bis zum Wurzelknoten; im oben beschriebenen Beispiel erhält man folgendes Ergebnis:
  • FKT_COMMONPARENTSUBTREE: wie FKT_SET, liefert aber zusätzlich ein gemeinsames Element als Wurzelknoten (damit dieses z.B. im Filter ausgewählt werden kann um alle zu wählen); im oben beschriebenen Beispiel erhält man folgendes Ergebnis:

  • FKT_SETFROMDATA: Liefert die gruppierten Elemente der angegebenen Spalte in der angegebenen Tabelle. Um auch diese Daten als Sparsetree bzw. Fulltree aufzubauen, ist eine Verschachtelung der Expressions möglich. (siehe Beispiele)

Beispiele für Expressions (für die oben angeführten Beispiele)

  • FKT_SET('Einwohnerzahl != ' + @EinwohnerZehntausend@))
  • FKT_FULLSUBTREE(FKT_SET('Einwohnerzahl != ' + @EinwohnerZehntausend@))
  • FKT_FULLSUBTREE('Einwohnerzahl != ' + @EinwohnerZehntausend@)
  • FKT_SPARSESUBTREE(FKT_SET('Einwohnerzahl != ' + @EinwohnerZehntausend@))
  • FKT_COMMONPARENTSUBTREE(FKT_SET('Einwohnerzahl != ' + @EinwohnerZehntausend@))

Weiteres Beispiel:

Root-Element und "keine Zuordnung" in der Dimension unterdrücken:

FKT_SET('COPSYS_ID !> 2')