Schlüsselwort

Versionsinfo zum Artikel
Gültig ab Version	2008
Gültig bis Version	Gültig für die aktuelle Version
Letzte Änderung	10/2015

Schlüsselwörter dienen dazu, die Beziehungen zwischen den Abfragebedingungen festzulegen und das Abfrageergebnis genauer zu definieren.

Folgende Schlüsselwörter, die in Tabellendokumenten verwendet werden, sind in Abfragen zulässig:

Allgemein gültige Schlüsselwörter

• Vergleichsbedingungen (=, <, >, <>, <=, >=, !=, !>, !<): Über diese Operatoren werden Bedingungen wie „Gleich“ (=) bzw. „Kleiner“ oder „Größer“ (<, >) formuliert. Das Rufzeichen (!) steht für „Nicht“, d. h. „!<“ bedeutet „Nicht kleiner“.
• Between: Mit Hilfe dieses Schlüsselwortes wird ein Bedingungsbereich formuliert. Beispiel: „FB101 Between 1000 and 5000“ gibt alle Nettoerlöse zurück, die innerhalb der gegebenen Grenzen liegen.
• Like: Like wird als Vergleichsoperator für Texte benutzt (FB4760 like 'WG A’). Bei der Suche nach Texten kann auch das Ersatzzeichen „%“ eingesetzt werden. Z.B. sucht „FB4760 like ‘WG%’“ nach allen Elementbezeichnungen, die mit „WG“ beginnen.
• Group by: Dieses Schlüsselwort addiert innerhalb einer Listenabfrage zusammengehörige Werte auf.
• Order by: Sortiert die Elemente einer Listenabfrage nach einer bestimmten Bedingung, in der Regel nach einem Feldbezug. Ein typischer Anwendungsfall ist eine gruppierte und sortierte Liste von Elementbezeichnungen: FB4757=8 Group by FB4760 Order by FB4760
• And und Or: Wenn Sie mehrere Bedingungen in einer Abfrage definieren, werden diese mit And oder Or verknüpft.
• In: Mit Hilfe dieses Schlüsselwortes wird ein Bedingungsbereich formuliert. Beispiel: „FB4763 in (100, 200, 900)" gibt alle Elemente zurück, deren Gruppenfeld 1 den Wert 100, 200 oder 900 hat.

professional planner-spezifische Schlüsselwörter

• BEGINNINGBALANCE: Liefert den Wert der ersten originalen Periode bezogen auf die Zeit-ID. SetDat(1,1,-1,670,262154,beginningbalance): liefert den Januar-Wert statt des Werts des 1. Quartals.
• CLOSINGBALANCE: Liefert den Wert der letzten originalen Periode bezogen auf die Zeit-ID. SetDat(1,1,-1,670,262154,closingbalance) liefert den März-Wert statt des Werts des 1. Quartals.
• DONTUSETIME: Wird in einer Abfrage dieses Schlüsselwort gesetzt, wird die in der SetDat-Formel gesetzte Zeit ignoriert. Stattdessen werden alle Zeiten angezeigt bzw. jene Zeiten, die in der Abfragebedingung mit dem Schlüsselwort Period definiert wurden.
• ORIGINALTIMES: Durch dieses Schlüsselwort werden für die geschaltete Zeitperiode alle jeweiligen Werte auf Zeit-Originalebene ausgegeben. Wird beispielsweise in einer Listenabfrage mit der Einstellung Liste auf das erste Quartal geschaltet, werden die Werte für alle Originalzeitelemente dieses Quartals (= Januar, Februar, März) aufgelistet.
• Org_comment: Kommentar bezogen auf Org-ID. Folgende Abfrage zeigt alle Elemente an, die den gleichen Kommentar aufweisen wie das betreffende Element: SetDat(1;3;10001;4760;17121419;FB4762 like 'org_comment')
• Org_gr0 – Org_gr9: Gruppenfeld bezogen auf Org-ID. Folgende Abfrage zeigt alle Elemente an, die im Gruppenfeld 1 den gleichen Wert wie das betreffende Element aufweisen: SetDat(1;1;10001;4760;17039499;FB4763=org_gr0)
• Org_level: Ebene bezogen auf Org-ID.
• Org_lvnr: Ebenen-ID bezogen auf die Org-ID. Folgende Abfrage zeigt alle Elemente an, die auf Ebene 1 dasselbe Element aufweisen: SetDat(1;2;10001;4759;17121419;e01=org_lvnr1)
• Org_name: Elementbezeichnung bezogen auf die Org-ID. Folgende Abfrage liefert alle Elemente mit demselben Namen: SetDat(1;1;10001;4760;17039499;FB4760 like ’org_name’)
• org_2ndcomment: Kommentar 2 bezogen auf Org-ID. Folgende Abfrage zeigt alle Elemente an, die den gleichen Kommentar 2 wie das betreffende Element haben: SetDat(1;4;10001;4760;17039499;FB4874 like 'org_2ndcomment')
• ORGANIZATION: Org-ID des Elements. Ersetzt in den Abfragen das Schlüsselwort durch die aktuelle Org-ID.
• PERIOD: Das Schlüsselwort Period steht für die aktuell in der SetDat-Formel eingestellte Periode. Mit diesem Schlüsselwort können nun Perioden unabhängig von den im Dataset vorhandenen Zeitperioden abgefragt werden.
• PPADDITIONALFRLIST(): Mit diesem Schlüsselwort kann man sehr einfach Listenabfragen bauen. In der Klammer werden einfach alle Feldbezüge angegeben, die als Ergebnis angezeigt werden sollen.
• PPSHOWHEADER: Dieses Schlüsselwort kann nur in Kombination mit PPADDIONALFRLIST() und Pass-through-Abfragen verwendet werden. Wenn eine Abfrage um dieses Schlüsselwort erweitert wird, werden die ausgewählten Feldbezüge als Spaltenüberschrift angezeigt.
• PRENAME: Wird vor allem bei Pass-through-Abfragen verwendet. Dieses Schlüsselwort liefert den Vorspann der Tabellennamen, z.B. "MSDE_" bei einem MSDE-Dataset bzw. "RockingHorsePlan_" bei einem SQL Server-Dataset.
• SORTPOSITION(): Legt die Spalte oder Zeile fest, nach der sich eine Listenabfrage orientieren soll. Normalerweise erfolgt diese Ausrichtung anhand einer Spalte von Elementbeschriftungen. Der SORTPOSITION()–Befehl wird in der Regel im Zusammenhang mit „Group by“ verwendet. Beispiel: Das Ergebnis der Abfrage soll an der zweiten Spalte ausgerichtet werden: Group by FB4760 SORTPOSITION(2)
• ALWAYSUSEQUERY: Ab der Version professional planner 8 kann in der Ausgangszeile des Drill-down-Filters mithilfe der Einzelabfrage die genaue Summe der darunter liegenden Werte angezeigt werden. Zusätzliche Performanceeinschränkungen sind durch diese Einzelabfragen nicht gegeben, da nur die Summenebene wirklich als Einzelabfrage behandelt wird. Auf der Originalebene wird die Einzelabfrage immer als Standardabfrage ausgeführt. Möchten Sie, dass die Abfrage auch auf Originalebene als Einzelabfrage ausgeführt wird, so müssen Sie ab dieser Version das Schlüsselwort ALWAYSUSEQUERY an die Abfrage der SetDat-Formel anfügen.

Definierte Namen

• PPAccum: Kann den Wert 0 oder 1 annehmen und zeigt an, ob die Kumulation aktiviert ist. Wenn Sie die Formel =WENN(PPAccum=1;"kumuliert";"") in ein Tabellendokument einfügen, wird in der betreffenden Zelle „kumuliert“ angezeigt, falls die Schaltfläche Kumulation gedrückt ist.
• PPEuro: Kann den Wert 0 oder 1 annehmen und zeigt an, ob die Währungsumrechnung aktiviert ist. Nimmt PPEuro den Wert 1 an, ist die Währungsumrechnung aktiviert.
• PPOnline: Kann den Wert 0 oder 1 annehmen und zeigt den Online-Status an. Nimmt PPOnline den Wert 1 an, ist professional planner online geschalten.
• PPReaderData: Kann den Wert 0, 1 oder 2 annehmen und zeigt an, ob der Collector-Modus aktiviert ist. Nimmt PPReaderData den Wert 2 an, dann ist der Collector-Modus aktiviert und modifizierte Daten werden angezeigt. Wenn Sie die Formel =WENN(PPReaderData=1;"CM";WENN(PPReaderData=2;"UD";"")) in ein Tabellendokument einfügen, wird in der betreffenden Zelle „CM“ angezeigt, falls Sie sich im Collector-Modus befinden und die modifizierten Daten angezeigt werden, und „UD“, falls Sie sich im Collector-Modus befinden und die Daten angezeigt werden, die im Dokument gespeichert wurden. Dieses Schlüsselwort steht bis zur Version professional planner 2011 zur Verfügung.
• PPThousand: Kann den Wert 0 oder 1 annehmen und zeigt an, ob die Darstellung in Tausend aktiviert ist. Nimmt PPThousand den Wert 1 an, ist die Darstellung in Tausend aktiviert.
• PPUpdate: Kann den Wert 0 oder 1 annehmen und zeigt an, ob gerade Daten eingelesen werden. Nimmt PPUpdate den Wert 1 an, werden gerade Daten von professional planner eingelesen.
• PPWorkState: Kann den Wert 0 oder 1 annehmen und gibt Auskunft darüber, ob die Schaltfläche Datenstatus anzeigen aktiviert ist. Dieses Schlüsselwort steht bis zur Version professional planner 2011 zur Verfügung.
• PPGrafikX: Dieser vordefinierte PP-Name wird für Diagramme verwendet. Wenn Sie zwei Diagramme in ein Tabellenblatt einfügen, muss ein Diagramm PPGrafik1 und das zweite PPGrafik2 heißen. Der Einsatz dieses Schlüsselworts ist erforderlich, da sonst das Diagramm sein Format verliert, wenn zwischen Normalansicht und Designmodus umgeschaltet wird.
• PPUndo: Kann den Wert 0 oder 1 annehmen und zeigt an, ob die Einstellung Undo aktiviert unter Dokumenteigenschaften im Registerblatt Allgemein aktiviert wurde. Nimmt PPUndo den Wert 1 an, so wurde die Einstellung aktiviert. Dieses Schlüsselwort steht ab der Version professional planner 8 zur Verfügung.
• PP_ListQuery: Kann den Wert True oder False annehmen und zeigt an, ob die Detaillistenanzeige aktiviert ist. Nimmt PP_ListQuery den Wert True an, ist die Detaillistenanzeige aktiviert. Dieses Schlüsselwort steht ab der Version professional planner 8.0.14 zur Verfügung.

Mit Hilfe der nachfolgenden Formel können Sie sich so z.B. bei Bedarf den Datenstatus in einer Zelle anzeigen lassen:

WENN(PPWorkState=1;WENN(SetDat(1;1;10001;5001;35651585) = 1;"In Planung";WENN(SetDat(1;1;10001;5001;35651585) = 2;"Abgeschlossen";"Nicht aktiv"))&" / "&WENN(SetDat(1;1;10001;5002;35651585) = 3;"Abgelehnt";WENN(SetDat(1;1;10001;5002;35651585)=2;"Bewilligt";WENN(SetDat(1;1;10001;5002;35651585)= 1 ;"Wird geprüft";"Nicht Aktiv")));"")