Uso de matrices en un script para ampliar una historia

Antes de utilizar el conjunto de resultados en el script, debemos asegurarnos de comprender los elementos del conjunto de resultados.

• La cabecera de dimensión contiene nombres de dimensión.
• En Cabecera de columna y Cabecera de fila, encontrará miembros que normalmente forman un árbol. La combinación de todos los miembros de un eje se denomina tupla de eje.
• En el punto de cruce de una tupla de eje de fila y columna, encontrará una celda de datos en el área Datos.

Puede combinar las dos tuplas de filas y columnas en una tupla más grande con el mismo efecto: seleccione una sola celda de datos. Una selección de "tupla grande" como esta también sobrevive a algunos cambios, por ejemplo, si una dimensión se mueve de filas a columnas o si se intercambian ejes.

Se utiliza un enfoque de "tupla individual" en el diseño de historias para seleccionar celdas de datos.

Puede hacer referencia a una celda de datos individual con la función getData({selection}) de una fuente de datos. Para especificar la celda, pase una selección a la función. La selección se escribe en el formato JSON común.

Para cada celda, puede obtener uno de los siguientes valores:

• Valor con formato, por ejemplo, 10.803.914,00
• Valor sin procesar, por ejemplo, 10803914

Si debe trabajar con más de una celda de datos individual, puede trabajar con selecciones. Por ejemplo, puede leer un conjunto de selecciones en una matriz y, a continuación, para generar la visualización deseada, realizar un loop sobre la matriz.

Paso 1: Lea las selecciones deseadas en una matriz.

Paso 2: Bucle sobre la matriz y utilice una función. Por ejemplo, utilice la función getData({selection}) para visualizar/reaccionar a los valores de datos.

Este es el código utilizado en el ejemplo anterior:

1234567891011
var selections = Table_1.getDataSource().getDataSelections({
      [Alias.MeasureDimension]:"00O2SOEHXWHF3AU4LBEW8WZSX",
      "0D_NW_BP__0D_NW_CNTRY":"US"
});
console.log(selections);

for (var x=0; x<selections.length; x++ ){
      var cell = Table_1.getDataSource().getData(selections[x]);
      console.log(cell.formattedValue);
}

Es posible que trabajar solo con los valores no sea suficiente porque los usuarios desean conocer el elemento al que pertenecen los valores.

Puede hacerlo con la función getResultMember(dimension, {selection}), como se muestra en la siguiente figura.

Este es el código utilizado en el ejemplo anterior:

123456789101112
var selections = Table_1.getDataSource().getDataSelections({
    [Alias.MeasureDimension]:"00O2SOEHXWHF3AU4LBEW8WZSX",
    "0D_NW_BP__0D_NW_CNTRY":"US"
});
console.log(selections);

for (var x=0; x<selections.length; x++ ){
    var cell = Table_1.getDataSource().getData(selections[x]);
    var year = Table_1.getDataSource().getResultMember("0CALYEAR", selections[x]); 
    var country = Table_1.getDataSource().getResultMember("0D_NW_BP__0D_NW_CNTRY", selections[x]);
    console.log(country.description + " / " + year.description + " / " + cell.formattedValue);}

Como alternativa a lo que se muestra hasta ahora, puede leer la totalidad (o partes) del conjunto de resultados en una matriz a la vez. Para cada celda, obtendrá una lista completa de propiedades a las que puede hacer referencia en el procesamiento de scripts posterior.

Por ejemplo:

123
var resultset = Table_1.getDataSource().getResultSet();
console.log(resultset);

Para leer el valor del ejemplo anterior, utilice:

123
console.log(resultset[0][Alias.MeasureDimension].formattedValue);

La sintaxis para el getResultSet ofrece tres parámetros opcionales. Si no especifica ninguno de estos parámetros, recupera todo el conjunto de resultados disponible.

1
Table_1.getDataSource().getResultSet(selection?, offset?, limit?: integer) 

• selection Se puede utilizar para restringir el conjunto de resultados devuelto, por ejemplo, a un indicador o miembro de dimensión.
• offset Omite las celdas de offset antes de empezar a devolver las celdas.
• limit Limita el número de celdas devueltas.

El entorno de scripting ofrece un objeto Alias que se puede utilizar para hacer referencia a diferentes objetos estándar. Los objetos disponibles son los siguientes:

• Alias.DefaultTheme
• Alias.FlatHierarchy
• Alias.MeasureDimension
• Alias.NullMember
• Alias.TotalsMember

Para hacer referencia al miembro del resultado en el script, puede utilizar el alias Alias.TotalsMember.

Para hacer referencia a la dimensión de indicador en el script, puede utilizar el alias Alias.MeasureDimension.