Uso de la palabra clave Current/Cur en una función de texto

Puede utilizar la palabra clave current con algunas funciones de texto para dinamizar las fórmulas y hacerlas más útiles y menos repetitivas. La palabra clave current puede reemplazar parámetros obligatorios en funciones de texto. Los parámetros codificados producen los mismos resultados, pero la palabra clave current tiene la ventaja de producir valores dinámicos. Por ejemplo, al utilizar current para el parámetro de página en una cuadrícula de varias páginas, producirá el valor para cada página.

Puede usar cualquier forma de la palabra clave current: current o cur. Las palabras clave Current no distinguen entre mayúsculas o minúsculas.

Nota:

La palabra clave current se soporta en un objeto de texto solo cuando se utilizan las siguientes funciones de texto: MemberName, MemberAlias y MemberDescription, donde la palabra clave current especifica el parámetro de la dimensión de página. Sin embargo, se deben definir el nombre de cuadrícula, fila y columna, si corresponde, y no se puede utilizar la palabra clave current.

Ejemplo 1:

En la función GetCell, muchos de los parámetros son o pueden ser relativos a la celda actual en la que se introduce la función. Por tanto, la palabra clave current puede aplicarse sin problemas a dicha función. La función GetCell usa la sintaxis siguiente:

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

En el ejemplo siguiente, los parámetros codificados de GetCell devuelven el mismo valor de celda de Grid 1, celda 1A, página 1 en varias páginas:

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

El ejemplo siguiente usa la palabra clave current con la función GetCell. La celda en la que se introduce dicha función muestra distintos valores para cada página. Observe que la palabra clave current también se aplica al nombre de cuadrícula. Si se cambia este nombre, la fórmula de texto seguirá siendo válida.

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

Ejemplo 2

Cuando se utiliza la palabra clave current en una celda que se amplía, los resultados son relativos a la celda ampliada.

El ejemplo siguiente utiliza funciones GetCell en una celda ampliada (la columna A se expande a las columnas Qtr1, Qtr2, Qtr3 y la fila 1 se expande a las filas East y West). La fila de texto 1 usa la palabra clave current para el parámetro de columna; la fila de texto 2 usa un valor codificado para el mismo parámetro.

Nombre	Descripción
.	Qtr1, Qtr2, Qtr3
East, West	#
Fila de texto 1	`<<GetCell(cur, 1, cur, cur)>>`
Fila de texto 2	`<<GetCell(current, 1, A, 1)>>`

Los resultados se muestran en la tabla siguiente.

Nombre	Trimestre 1	Trimestre 2	Trimestre 3
East	5120	4502	7304
West	3405	2300	4462
Fila de texto 1	5120	4502	7304
Fila de texto 2	5120	5120	5120

La fila de texto 1 utiliza la palabra clave current para el parámetro de columna, lo que da como resultado la actualización de la columna actual de cada celda ampliada (Qtr1, Qtr2, Qtr3). Asimismo, dado que la palabra clave current se utiliza para el parámetro de página, los valores de la fila de texto 1 actualizan cada página con relación a la página actual de la cuadrícula.
La fila de texto 2 usa un valor codificado para el parámetro de columna (A), lo que da como resultado el mismo valor de 5120 para todos los trimestres. Una referencia codificada a un parámetro de columna devuelve el mismo valor de la parte superior izquierda de la columna y la fila.

Tabla -11 Funciones de texto que soportan la palabra clave current

Función de texto Ejemplo

Función de texto	Ejemplo
<<DataSource("GridName.Axis[ID]",InfoType)>> Parámetros, si proceden: `GridName`: soportado en todas las celdas `InfoType`: no procede	<<DataSource(current, "App")>> Nota: Se utiliza el nombre de la cuadrícula actual.
<<GetCell("GridName",Row,Col,Page)>> Parámetros, si proceden: `GridName`: soportado en todas las celdas `Row`: soportado en todas las celdas `Col`: soportado en todas las celdas `Page`: soportado en todas las celdas	<<GetCell(cur, 1, cur, current)>> <<GetCell(cur, 1(3), cur, current)>> Nota: Aparece el valor de la tercera fila (ampliada) de la fila 1. <<GetCell(cur, cur, A, current)>> <<GetCell(cur, cur, A(B), current)>> Nota: Aparece el valor de la segunda columna (ampliada) de la columna A.
Utilice los siguientes valores en una fila de datos o en un encabezado de columna: <<MemberName("DimName")>> Utilice los siguientes valores en una fila que no sea de datos o en un encabezado de columna: <<MemberName("GridName",Row/Col/Page,"DimName")>> Utilice el siguiente parámetro cuando corresponda: `DimName`: solo en celdas de encabezado	<<MemberName(current)>> <<MemberName("current", Row/Col/Page, "current")>> Nota: Devuelve el nombre del miembro de la fila, columna o página de datos que corresponde a la dimensión donde se ubica la celda de encabezado. Puede utilizarse con la función `<<MemberDimension>>` para crear encabezados personalizados en una cuadrícula.
<<CalcStatus("GridName",Row,Col,Page)>> Nota: Los parámetros que permiten la palabra clave `current` están resaltados en negrita.	<<CellText("GridName", Row, Column, Page)>> <<CellText("GridName", Row, Column, Page, MemberOverride)>>
<<GridDimension("GridName","Axis",index)>> Nota: Los parámetros que permiten la palabra clave `current` están resaltados en negrita.	<<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)>> Nota: Los parámetros que permiten la palabra clave `current` están resaltados en negrita.
<<ListOfCellDocuments("GridName",FileName)>> Nota: Los parámetros que permiten la palabra clave `current` están resaltados en negrita.
<<GridDimension("GridName","Axis",Index)>> Parámetros, si proceden: `GridName`: soportado en todas las celdas `Axis`: solo celdas de encabezado `Index`: solo celdas de encabezado	<<GridDimension(cur,"Page",1)>> <<GridDimension(cur,cur,cur)>> Nota: Aparece el nombre de la dimensión correspondiente a la celda de encabezado.
<<GetHeading("GridName",Page,Ref,Offset)>> <<GetHeading("GridName",Page,Ref,"Delim")>> Parámetros, si proceden: `GridName`: soportado en todas las celdas `Page`: soportado en todas las celdas `Ref`: soportado en todas las celdas, pero no debe utilizarse en las celdas de encabezado* `Offset`: solo celdas de encabezado `Delim`: no procede	<<GetHeading(cur, cur, A, " - ")>> <<GetHeading(cur, cur, 1, " - ")>> Nota: En los ejemplos anteriores, aparecen en la página actual todos los encabezados de la columna A y la fila 1. <<GetHeading(cur, cur, A, cur)>> Nota: El encabezado de la columna A se muestra en la dimensión correspondiente a la ubicación de la celda del encabezado con la fórmula. <<GetHeading(cur, cur, cur, " - ")>> Nota: Si se utiliza en la celda de texto de una fila, el resultado será la separación de todos los encabezados de la columna actual por medio de " - ". Esto permite a los usuarios repetir encabezados de columna después de un salto de página manual.
*El uso de la palabra clave `current` para el parámetro de "referencia" es limitado. La palabra clave `current` no puede utilizarse con la función `GetHeading` cuando se introduce como "cabecera personalizada" en una fila o columna, ya que se crearía una referencia circular. Puede utilizar la palabra clave `current` como tercer parámetro de una celda que forma parte de una fila o columna de texto que no esté en el área del encabezado de la cuadrícula. Por ejemplo, si agrega la siguiente fórmula a la celda A3, donde la fila 3 es una fila de texto: `<<GetHeading(cur,cur,cur,1)>>`, el resultado será el primer encabezado de la columna A. Puede utilizar la función GetHeading dentro de una celda de encabezado. Sin embargo, el parámetro de `referencia` no debería usar la palabra clave `current`. Por ejemplo, cuando introduce `<<GetHeading(cur, cur, A, cur)>>` en la celda de encabezado de la columna B, se obtiene el encabezado de la columna A.

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

Parámetros, si proceden:

GridName: soportado en todas las celdas
InfoType: no procede

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

Nota:

Se utiliza el nombre de la cuadrícula actual.

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

Parámetros, si proceden:

GridName: soportado en todas las celdas
Row: soportado en todas las celdas
Col: soportado en todas las celdas
Page: soportado en todas las celdas

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

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

Nota:

Aparece el valor de la tercera fila (ampliada) de la fila 1.

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

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

Nota:

Aparece el valor de la segunda columna (ampliada) de la columna A.

Utilice los siguientes valores en una fila de datos o en un encabezado de columna:

<<MemberName("DimName")>>

Utilice los siguientes valores en una fila que no sea de datos o en un encabezado de columna:

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

Utilice el siguiente parámetro cuando corresponda:

DimName: solo en celdas de encabezado

<<MemberName(current)>>

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

Nota:

Devuelve el nombre del miembro de la fila, columna o página de datos que corresponde a la dimensión donde se ubica la celda de encabezado. Puede utilizarse con la función <<MemberDimension>> para crear encabezados personalizados en una cuadrícula.

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

Nota:

Los parámetros que permiten la palabra clave current están resaltados en negrita.

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

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

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

Nota:

Los parámetros que permiten la palabra clave current están resaltados en negrita.

<<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)>>

Nota:

Los parámetros que permiten la palabra clave current están resaltados en negrita.

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

Nota:

Los parámetros que permiten la palabra clave current están resaltados en negrita.

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

Parámetros, si proceden:

GridName: soportado en todas las celdas
Axis: solo celdas de encabezado
Index: solo celdas de encabezado

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

<<GridDimension(cur,cur,cur)>>

Nota:

Aparece el nombre de la dimensión correspondiente a la celda de encabezado.

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

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

Parámetros, si proceden:

GridName: soportado en todas las celdas
Page: soportado en todas las celdas
Ref: soportado en todas las celdas, pero no debe utilizarse en las celdas de encabezado*
Offset: solo celdas de encabezado
Delim: no procede

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

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

Nota:

En los ejemplos anteriores, aparecen en la página actual todos los encabezados de la columna A y la fila 1.

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

Nota:

El encabezado de la columna A se muestra en la dimensión correspondiente a la ubicación de la celda del encabezado con la fórmula.

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

Nota:

Si se utiliza en la celda de texto de una fila, el resultado será la separación de todos los encabezados de la columna actual por medio de " - ". Esto permite a los usuarios repetir encabezados de columna después de un salto de página manual.

*El uso de la palabra clave current para el parámetro de "referencia" es limitado. La palabra clave current no puede utilizarse con la función GetHeading cuando se introduce como "cabecera personalizada" en una fila o columna, ya que se crearía una referencia circular. Puede utilizar la palabra clave current como tercer parámetro de una celda que forma parte de una fila o columna de texto que no esté en el área del encabezado de la cuadrícula. Por ejemplo, si agrega la siguiente fórmula a la celda A3, donde la fila 3 es una fila de texto: <<GetHeading(cur,cur,cur,1)>>, el resultado será el primer encabezado de la columna A. Puede utilizar la función GetHeading dentro de una celda de encabezado. Sin embargo, el parámetro de referencia no debería usar la palabra clave current. Por ejemplo, cuando introduce <<GetHeading(cur, cur, A, cur)>> en la celda de encabezado de la columna B, se obtiene el encabezado de la columna A.