@CalcMgrFindFirst

English (Español a continuación)

It is a function that locates the first «text substring» within a «text string» that matches a given expression.

This function consists of three arguments:

@CalcMgrFindFirst (text, regExpr, ignoreCase)

• «text»: is the text string in which the given expression must be found. In the function it goes between quotes.
• «regExpr»: is the expression that you must locate. These expressions follow the structure of the java language (java.util.regex.Pattern), and within the function they are enclosed in quotes.

To know the structure of these expressions, the following websites can be consulted:

• https://regex101.com/
• https://www.vogella.com/tutorials/JavaRegularExpressions/article.html

The structure of these expressions can be very varied and complex; as an example, it can be:

1. A text: «Zone»
2. An indeterminate number of any font: «\ w +»
3. A certain letter followed by an indeterminate number of any letter: “M + \ w +” (the letter “M” followed by an indeterminate number of any type of letter).
4. …

• “ignoreCase” refers to whether the comparison is case-sensitive. It can take two values:

@_true: case insensitive. For example «City» and «city» consider them the same.

@_false: is case sensitive. For example «City» and «city» consider them different.

Let’s see some examples of results:

• @CalcMgrFindFirst (“Valencia Murcia Sevilla”, “Valencia”, @_true): “Valencia”.
• @CalcMgrFindFirst (“Valencia Murcia Sevilla”, “valencia”, @_true): “Valencia” (not case-sensitive).
• @CalcMgrFindFirst (“Valencia Murcia Sevilla”, “Valencia”, @_false): “Valencia”.
• @CalcMgrFindFirst (“Valencia Murcia Sevilla”, “valencia”, @_false): empty result (it is case-sensitive).
• @CalcMgrFindFirst (“Valencia Murcia Sevilla”, “Alicante”, @_true): empty result.

This string function can be used in calculation scripts. Let’s see an example:

Español

In this calculation, when it traverses the «Markets» dimension, where there is a member that is «Andalucia», the @CalcMgrFindFirst function extracts the term «Andalucia» from the expression «Andalucia M» (with the expression «\ w +»). This member is assigned 5 units, while the rest of the members of this dimension are assigned 1 unit.

Es una función que localiza la primera “subcadena de texto” dentro de una “cadena de texto” que coincide con una expresión determinada.

Esta función consta de tres argumentos:

@CalcMgrFindFirst(text, regExpr, ignoreCase)

• “text”: es la cadena de texto en el que debe encontrar la expresión dada. En la función va entre comillas.
• “regExpr”: es la expresión que debe localizar. Estas expresiones siguen la estructura del lenguaje java (java.util.regex.Pattern), y dentro de la función va entre comillas.
• “ignoreCase”: hace referencia a si en la comparación se diferencia por mayúsculas y minúsculas. Puede tomar dos valores:

@_true: no diferencia mayúsculas y minúsculas. Por ejemplo “Ciudad” y “ciudad” los considera iguales.

@_false: sí diferencia mayúsculas y minúsculas. Por ejemplo “Ciudad” y “ciudad” los considera diferentes.

Para conocer la estructura de las «regExpr» (expresiones regulares) se pueden consultar las siguientes webs:

• https://regex101.com/
• https://www.vogella.com/tutorials/JavaRegularExpressions/article.html

La estructura de estas expresiones puede ser muy variada y compleja; a título de ejemplo, puede ser:

1. Un texto: “Zona”
2. Un número indeterminado de cualquier tipo de letra: “\w+”
3. Una letra determinada seguido de un número indeterminado de cualquier letra: “M+\w+” (la letra “M” seguida de un número indeterminado de cualquier tipo de letras).
4. …

Veamos algunos ejemplos de resultados:

• @CalcMgrFindFirst(“Valencia Murcia Sevilla”, “Valencia”, @_true): resultado “Valencia”.
• @CalcMgrFindFirst(“Valencia Murcia Sevilla”, “valencia”, @_true): resultado “Valencia” (no diferencia entre mayúsculas y minúsculas).
• @CalcMgrFindFirst(“Valencia Murcia Sevilla”, “Valencia”, @_false): resultado “Valencia”.
• @CalcMgrFindFirst(“Valencia Murcia Sevilla”, “valencia”, @_false): resultado vacío (sí diferencia entre mayúsculas y minúsculas).
• @CalcMgrFindFirst(“Valencia Murcia Sevilla”, “Alicante”, @_true): resultado vacío.

Esta función string se puede utilizar en scripts de cálculos. Veamos un ejemplo:

En este cálculo cuando recorre la dimensión “Mercados”, donde hay un miembro que es “Andalucía”, la función @CalcMgrFindFirst extrae de la expresión “Andalucía M” el término “Andalucía” (con la expresión “\w+”). A este miembro le asigna 5 unidades, mientras que al resto de miembros de esta dimensión le asigna 1 unidad.