Uso de las opciones comunes de JavaScript en un script para mejorar una historia

En los scripts, puede "almacenar" un valor en una variable. Existen dos tipos de variables: variables locales y globales. Cubriremos las globales más adelante en el curso. Las variables de script locales se pueden crear con el comando var. Solo son válidos dentro del script en el que están asignados. Cuando el script se procesa por completo, la variable pierde su valor.

var <NameOfVariable> = <ValueOfVariable>;

• Debe asignar un valor en la sentencia var
• El valor asignado define el tipo de datos de la variable

Independientemente del tipo de variable que cree, debe asignarle un nombre como identificador, como counter, selectedCountry, myList. Los desarrolladores suelen utilizar convenciones de nomenclatura específicas para facilitar a todos la lectura del código. Si estás interesado en aprender más sobre este tema, consulta el siguiente documento y alinea una definición consistente con tus colegas desarrolladores de historias: Devopedia - Convenciones para fijar nombres

"Individual" igual a (=) son operadores de asignación. Se utilizan para asignar un valor a una variable.

Triple igual a (===) son operadores de comparación. Si utiliza triple igual, se compararán tanto los valores como los tipos.

El doble es igual a (==) son operadores de comparación. Con doble igual, los valores se comparan, pero los tipos no. SAP Analytics Cloud no admite la conversión automática de tipo, por lo que no utilice doble igual a en ningún script.

Una técnica muy común para realizar un seguimiento de los valores de variables o el procesamiento de scripts es hacer uso de la consola del navegador. Puede escribir valores de texto o variables en la consola mediante el comando console.log();.

Para acceder a la consola desde el navegador, debe abrir las Herramientas del desarrollador desde la barra de herramientas del navegador y cambiar a la pestaña Consola.

12345678910111213
var selectedCountry = Dropdown1.getSelectedText();

switch (selectedCountry) {
   case "Germany":
      // code that is relevant for Germany
      break;
  case "USA":
      // code that is relevant for USA
      break;
  default:
      // code that is relevant for all other countries
}

Puede utilizar la sentencia switch para seleccionar una de varias secciones de código. La expresión (en nuestro caso selectedCountry) se compara con los valores de cada caso. Si coincide, se ejecuta la sección de código asociada. Para detener el procesamiento posterior de la sentencia switch, utilice la sentencia break para saltar del conmutador.

Si no utiliza un salto, se procesarán todas las líneas siguientes. Esto incluye todas las siguientes sentencias case independientemente de su valor.

En el ejemplo anterior, puede ver tres sentencias. Se corresponden con lo siguiente:

• Enunciado 1: Declara la variable para el iterador de bucle
• Sentencia 2: ¿Se verifica la condición antes de ejecutar las líneas de código?
• Sentencia 3: Es el cambio en el iterador de bucle que se ejecuta cada vez que se ejecutan las líneas de código cerradas

Por ejemplo, desea registrar en log todas las jerarquías de la fuente de datos a la consola con para que escriba el siguiente script:

123456
var Hierarchies = TBL_Quantity.getDataSource().getHierarchies("0D_NW_PRID");

for (var j=0; j<Hierarchies.length; j++){
      console.log(Hierarchies[j].id +" - " + Hierarchies[j].description);
}

Las sentencias utilizadas en el script se resaltan a continuación.

• Extracto 1: var j=0
• Extracto 2: j<Hierarchies.length
• Extracto 3: j++

For Los bucles se utilizan ampliamente, por ejemplo, se utilizan para realizar un loop sobre las entradas de una matriz que verá en un ejercicio posterior en el curso.

Los bucles While son similares a los bucles for pero con menos sentencias.

1234
while (condition) {
      // this block will be executed if condition is true
}

Por ejemplo, desea registrar en log todas las jerarquías de la fuente de datos a la consola con mientras, por lo que escribe el siguiente script:

12345678
var Hierarchies = TBL_Quantity.getDataSource().getHierarchies("0D_NW_PRID");

var x = 0;
while (x < Hierarchies.length) {
      console.log(Hierarchies[x].id +" - " + Hierarchies[x].description);
      x++;
} 

No olvide modificar la variable utilizada en la condición.

Trabajar con matrices es esencial en muchas situaciones. Algunas API de comando devuelven una matriz y debe saber cómo gestionarlas.

En esta lección, presentamos el concepto de matrices ya que se pueden devolver en API para que sea importante que comprenda cuáles son. Sin embargo, en la siguiente lección aplicará sus conocimientos cuando complete un ejercicio que contenga matrices, así como conceptos como variables de script globales y funciones de script.

Una matriz es algo así como una lista de elementos. Cuando trabaja con ellos en un script, normalmente:

• Acceder a un único elemento por su posición (también llamada "índice") en la lista
• Bucle por toda la lista y procese cada elemento uno tras otro

Las matrices se identifican con [ ] como se muestra en el ejemplo anterior anterior y pueden ser:

1. Impreso en consola
   Code Snippet

   Copy codeSwitch to dark mode

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

2. Accedido con loop
   Code Snippet

   Copy codeSwitch to dark mode

   12345
   var resultset = Table_1.getDataSource().getResultSet();
   for (var x=0; x<resultset.length; x++){
   console.log(resultset[x]["@MeasureDimension"].rawValue);
   }
   

3. Accedido con índice
   Code Snippet

   Copy codeSwitch to dark mode

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

En algunas situaciones de scripting, puede ser útil crear una variable que pueda almacenar más de una entrada. Por ejemplo, desea almacenar una lista de widgets que se deben procesar o una lista de indicadores que se deben utilizar del script.

En el vídeo Ampliación de widgets de navegación genéricos con scripting, se han introducido los pasos para mejorar los widgets de navegación genéricos:

1. Defina los elementos para el widget en el panel Generador. Se puede definir de tres maneras diferentes:
   1. Manualmente, mediante input directo
   2. Dinámicamente, mediante scripting
   3. Dinámicamente, utilizando la vinculación de propiedades
2. Defina la acción que se debe ejecutar en el script onSelect del widget

En esa lección, definió manualmente los elementos para el widget mediante input directo. En esta lección, veremos la definición dinámica de los elementos mediante scripting.

El siguiente código es un ejemplo de scripting que se puede utilizar para rellenar dinámicamente la lista desplegable:

12345
var countries = Table_1.getDataSource().getMembers("0D_NW_BP__0D_NW_CNTRY");
for (var x = 0; x < countries.length; x++ ) {
	var country = countries[x];
	Dropdown_1.addItem(country.id, country.description);
}

Como ejemplo típico del uso de matrices en el script, utilizaremos el ejemplo de escribir todos los miembros de una dimensión en una lista desplegable. Debe pensar en el evento correcto en el que agregar el código. El Page_1.onInitialization() puede ser un buen lugar, sin embargo, dependiendo de la frecuencia con la que los miembros puedan cambiar, puede ser útil añadirlo al evento onResultChanged del widget de origen.

La API Application.getWidgets(); puede devolver una matriz de widgets descrita por las opciones de búsqueda de widgets. Como ejemplo, puede crear una matriz de todos los gráficos de su historia con un nombre que empiece por "CH_Tile". La API también puede crear una matriz de otros widgets, por ejemplo, Botón, Imagen, etc.

El código utilizado para devolver una matriz de todos los gráficos de su historia con un nombre que empiece por "CH_Tile":

123
var tilecharts = Application.getWidgets({type:WidgetType.Chart, searchPattern:"CH_Tile"});
console.log (tilecharts);

Para comprender el contenido y la estructura de una matriz, puede enviarla al Log de consola y analizar su contenido allí.