Schlüsselwort "Current/Cur" in Textfunktionen verwenden

Sie können das Schlüsselwort current mit bestimmten Textfunktionen verwenden, um Formeln dynamischer, nützlicher und weniger redundant zu gestalten. Das Schlüsselwort current kann erforderliche Parameter in Textfunktionen ersetzen. Fest codierte Parameter führen zu den gleichen Ergebnissen, während das Schlüsselwort current dynamische Werte erzeugen kann. Beispiel: Wenn Sie current in einem mehrseitigen Raster für den Page-Parameter verwenden, erzeugt es den Wert für jede Seite.

Sie können eine beliebige Form des Schlüsselwortes current einsetzen, also current oder cur. Beim Schlüsselwort Current wird die Groß- und Kleinschreibung nicht berücksichtigt.

Hinweis:

Das Schlüsselwort current wird in einem Textobjekt nur bei Verwendung der folgenden Textfunktionen unterstützt: MemberName, MemberAlias und MemberDescription, wobei current den Parameter für die Seitendimension festlegt. Sofern zutreffend, müssen Rastername, Zeile und Spalte jedoch definiert werden. Das Schlüsselwort current darf dabei nicht verwendet werden.

Beispiel 1:

Bei der Funktion GetCell können viele Parameter in Relation zur aktuellen Zelle stehen, in der die Funktion eingegeben wird. Das Schlüsselwort current kann daher in dieser Funktion eingesetzt werden. Die Funktion GetCell verwendet folgende Syntax:

<<GetCell ("GridName", Row, Column, Page)>>

Im folgenden Beispiel geben die fest codierten Parameter für GetCell über mehrere Seiten hinweg denselben Zellenwert von Raster 1, Zelle 1A, Seite 1 zurück:

<<GetCell ("Grid1", 1, A, 1)>>

Im nächsten Beispiel wird das Schlüsselwort current mit der Funktion GetCell verwendet. Die Zelle, in der die Funktion eingegeben wird, erzeugt für jede Seite unterschiedliche Werte. Beachten Sie, dass das Schlüsselwort current auch auf den Rasternamen angewendet wird. Selbst wenn sich der Rastername ändert, funktioniert die Textformel dennoch korrekt.

<<GetCell ("current", 1, current, current)>>

Beispiel 2

Wird das Schlüsselwort current in einer Zelle verwendet, die erweitert werden kann, stehen die Ergebnisse in Relation zu der erweiterten Zelle.

Im folgenden Beispiel werden GetCell-Funktionen in einer erweiterten Zelle verwendet (Spalte A wird zu den Spalten Qrt1, Qrt2 und Qrt3 erweitert, Zeile 1 zu den Zeilen Ost und West). In Textzeile 1 wird das Schlüsselwort current für den Column-Parameter verwendet. Textzeile 2 verwendet einen fest codierten Wert für den Column-Parameter.

Name Beschreibung
.

Qrt1, Qrt2, Qrt3

Ost, West

#

Textzeile 1

<<GetCell(cur, 1, cur, cur)>>

Textzeile 2

<<GetCell(current, 1, A, 1)>>

Die Ergebnisse sind in der folgenden Tabelle dargestellt.

Name Quartal 1 Quartal 2 Quartal 3

Ost

5,120

4,502

7,304

West

3,405

2,300

4,462

Textzeile 1

5,120

4,502

7,304

Textzeile 2

5,120

5,120

5,120

  • In Textzeile 1 wird das Schlüsselwort current für den Column-Parameter verwendet, wodurch in jeder erweiterten Zelle (Qrt1, Qrt2, Qrt3) die Spalte jeweils aktualisiert wird. Da zudem das Schlüsselwort current für den Page-Parameter verwendet wurde, werden die Werte in Textzeile 1 für jede Seite des Rasters aktualisiert.

  • Textzeile 2 verwendet einen fest codierten Wert für den Parameter "Column" (A), wodurch in allen Quartalen derselbe Wert, nämlich 5,120 ausgegeben wird. Eine fest codierte Referenz auf einen Column-Parameter gibt denselben oberen linken Wert der Spalte und Zeile zurück.

Tabelle -11 Textfunktionen, die das Current-Schlüsselwort unterstützen

Textfunktion Beispiel
<<DataSource("GridName.Axis[ID]",InfoType)>>

Parameter, wo zutreffend:

  • GridName: in allen Zellen unterstützt

  • InfoType: nicht zutreffend

<<DataSource(current, "App")>>

Hinweis:

Der aktuelle Rastername wird verwendet.

<<GetCell("GridName",Row,Col,Page)>>

Parameter, wo zutreffend:

  • GridName: in allen Zellen unterstützt

  • Row: in allen Zellen unterstützt

  • Col: in allen Zellen unterstützt

  • Page: in allen Zellen unterstützt

<<GetCell(cur, 1, cur, current)>>
<<GetCell(cur, 1(3), cur, current)>>

Hinweis:

Es wird der Wert der dritten (erweiterten) Zeile von Zeile 1 angezeigt.

<<GetCell(cur, cur, A, current)>>
<<GetCell(cur, cur, A(B), current)>>

Hinweis:

Es wird der Wert der zweiten (erweiterten) Spalte von Spalte A angezeigt.

Verwenden Sie den folgenden Code in der Überschrift einer Datenzeile oder -spalte:

<<MemberName("DimName")>>

Verwenden Sie den folgenden Code in der Überschrift einer Zeile oder Spalte ohne Daten:

<<MemberName("GridName",Row/Col/Page,"DimName")>>

Verwenden Sie ggf. den folgenden Parameter:

DimName: nur in Überschriftenzellen

<<MemberName(current)>>
<<MemberName("current", Row/Col/Page, "current")>>

Hinweis:

Gibt den Namen des Elements der Datenzeile, -spalte oder -seite zurück, die der Dimension entspricht, in der sich die Überschriftenzelle befindet. Kann zusammen mit der Funktion <<MemberDimension>> verwendet werden, um benutzerdefinierte Überschriften für ein Raster zu erstellen.

<<CalcStatus("GridName",Row,Col,Page)>>

Hinweis:

Die Parameter, die das Schlüsselwort current zulassen, sind fett markiert.

<<CellText("GridName", Row, Column, Page)>>
<<CellText("GridName", Row, Column, Page, MemberOverride)>>
<<GridDimension("GridName","Axis",index)>>

Hinweis:

Die Parameter, die das Schlüsselwort current zulassen, sind fett markiert.

<<MemberAlias("DimName")>>
<<MemberAlias("GridName", "DimName")>> <<MemberAlias("GridName", Row|Col|Page, "DimName")>>
<<MemberDesc("DimName")>>
<<MemberDesc("GridName", "DimName")>>
<<MemberDesc("GridName", Row|Col|Page, "DimName")>>
<<MemberName("DimName")>>
<<MemberName("GridName", "DimName")>>
<<MemberName("GridName", Row|Col|Page, "DimName")>>
<<MemberQualifiedName("DimName")>>
<<MemberQualifiedName("GridName", "DimName")>>
<<MemberQualifiedName("GridName", Row|Col|Page, "DimName")>>
<<MemberProperty(DimensionName, Property)>> 
<<MemberProperty("GridName", DimensionName, Property)>> 
<<MemberProperty("GridName", Row|Col|Page, DimensionName, Property)>>
<<ProcessManagementStatus("GridName",Row,Column,Page)>>

Hinweis:

Die Parameter, die das Schlüsselwort current zulassen, sind fett markiert.

 
<<ListOfCellDocuments("GridName",FileName)>>

Hinweis:

Die Parameter, die das Schlüsselwort current zulassen, sind fett markiert.

 
<<GridDimension("GridName","Axis",Index)>>

Parameter, wo zutreffend:

  • GridName: in allen Zellen unterstützt

  • Axis: nur in Überschriftenzellen

  • Index: nur in Überschriftenzellen

<<GridDimension(cur,"Page",1)>>
<<GridDimension(cur,cur,cur)>>

Hinweis:

Es wird der Dimensionsname angezeigt, der der Kopfzelle entspricht.

<<GetHeading("GridName",Page,Ref,Offset)>>
<<GetHeading("GridName",Page,Ref,"Delim")>>

Parameter, wo zutreffend:

  • GridName: in allen Zellen unterstützt

  • Page: in allen Zellen unterstützt

  • Ref: in allen Zellen unterstützt, sollte jedoch nicht in Überschriftenzellen verwendet werden*

  • Offset: nur in Überschriftenzellen

  • Delim: nicht zutreffend

<<GetHeading(cur, cur, A, " - ")>>
<<GetHeading(cur, cur, 1, " - ")>>

Hinweis:

Im obigen Beispielen werden alle Überschriften in Spalte A und Zeile 1 für die aktuelle Seite angezeigt.

<<GetHeading(cur, cur, A, cur)>>

Hinweis:

Es wird die Überschrift in Spalte A für die Dimension angezeigt, die der Position entspricht, an der sich die Überschriftenzelle mit der Formel befindet.

<<GetHeading(cur, cur, cur, " - ")>>

Hinweis:

Wird diese Formel in einer Zeilentextzelle eingesetzt, werden alle Überschriften in der aktuellen Spalte, getrennt durch ein "-", angezeigt. Dadurch können Benutzer Spaltenüberschriften nach manuellen Seitenumbruch wiederholen.

* Die Verwendung des Schlüsselwortes current für den Parameter "reference" ist eingeschränkt. Das Schlüsselwort current kann nicht in der Funktion GetHeading verwendet werden, wenn es als benutzerdefinierte Überschrift in einer Zeile oder Spalte eingegeben wird, da hierdurch ein Zirkelbezug erstellt wird. Sie können das Schlüsselwort current als dritten Parameter in einer Zelle verwenden, die Teil einer Textzeile oder -spalte ist, die sich nicht im Überschriftenbereich des Rasters befindet. Beispiel: Wenn Sie die Formel <<GetHeading(cur,cur,cur,1)>> in Zelle A3 hinzufügen, wobei Zeile 3 eine Textzeile ist, ist das Ergebnis die erste Überschrift von Spalte A. Die GetHeading-Funktion kann in einer Überschriftenzelle verwendet werden. Das Schlüsselwort current darf jedoch nicht im Parameter reference verwendet werden. Beispiel: Wenn Sie <<GetHeading(cur, cur, A, cur)>> in die Überschriftenzelle von Spalte B eingeben, wird die Überschrift von Spalte A zurückgegeben.