@NAME

English (Español a continuación)

This function converts the name of a member (or its alias) to a text string so that it can be used in another calculation function.

Its structure consists of two parts:

  • @NAME (Part A, Part B)

«Part A»: name of a member (or dimension) or list of member names (or dimensions).

«Part B»: «UNIQUE», is optional; It is used when the Outline allows duplicate names and serves to indicate to this function that in the cases of duplicate members it takes the qualified name.

Let’s see some examples:

1.- Suppose we have the following members of the «Product» dimension:

  • PR_001
  • PR_002
  • TV_001
  • TV_002

If we want to extract the first two characters of these names, previously we have to convert it into a text string, using this function:

  • @NAME (@CURRMBR (“Product”))

Once converted into a text string we can extract the first two characters:

  • @SUBSTRING (@NAME (@CURRMBR (“Product”)), 0,2)

We can use it in a FIX:

2.- Suppose now that we have the following members of the dimension «Year» in which it is indicated, in the last two characters, the percentage of margin that must be applied each year:

  • 2016_15
  • 2017_20
  • 2018_15
  • 2019_12

If we want to extract the percentage of margin to apply (extracting the last two characters of these names), previously we have to convert it into a text string, using this function:

  • @NAME (@CURRMBR (“Year”));

Once converted into a text string we can extract the last two characters:

  • @SUBSTRING (@NAME (@CURRMBR (“Year”)), 5);

If we want to use it in a calculation, we convert it to a value:

  • @CalcMgrDoubleFromString (@SUBSTRING (@NAME (@CURRMBR (“Year”)), 5));

Español

Esta función convierte el nombre de un miembro (o su alia) en una cadena de texto para que pueda ser utilizado en otra función de cálculo.

Su estructura consta de dos partes:

  • @NAME(Parte A, Parte B)

“Parte A”: nombre de un miembro (o dimensión) o lista de nombres de miembros (o dimensiones).

“Parte B”: “UNIQUE”, es opcional; se utiliza cuando el Outline permite nombres duplicados y  sirve para indicarle a esta función que en los casos de miembros duplicados tome el nombre cualificado.

Veamos algunos ejemplos:

1.- Supongamos que tenemos los siguientes miembros de la dimensión “Producto”:

  • PR_001
  • PR_002
  • TV_001
  • TV_002

Si queremos extraer los dos primeros caracteres de estos nombres, previamente lo tenemos que convertir en una cadena de texto, utilizando para ello esta función:

  • @NAME(@CURRMBR(“Producto”))

Una vez convertido en una cadena de texto podemos extraer los dos primeros caracteres:

  • @SUBSTRING(@NAME(@CURRMBR(“Producto”)),0,2)

Podemos utilizarlo en un FIX:

2.- Supongamos ahora que tenemos los siguientes miembros de la dimensión “Año” en el que viene recogido, en los dos últimos caracteres el porcentaje de margen que hay que aplicar cada año:

  • 2016_15
  • 2017_20
  • 2018_15
  • 2019_12

Si queremos extraer el porcentaje de margen a aplicar (extrayendo los dos últimos caracteres de estos nombres), previamente lo tenemos que convertir en una cadena de texto, utilizando para ello esta función:

  • @NAME(@CURRMBR(“Año”));

Una vez convertido en una cadena de texto podemos extraer los dos últimos caracteres:

  • @SUBSTRING(@NAME(@CURRMBR(“Año”)),5);

Si lo queremos utilizar en un cálculo lo convertimos en valor:

  • @CalcMgrDoubleFromString(@SUBSTRING(@NAME(@CURRMBR(“Año”)),5));