Uso de opciones de scripting globales en un script para ampliar una historia

En lecciones anteriores, trabajamos con variables de script locales. Se definieron con la función var dentro de un único bloque de script. El valor solo era accesible dentro de ese bloque específico y no se podía acceder a él desde el exterior.

Las variables de script globales se definen como "objeto permanente propio a nivel de historia". Esto significa que se puede acceder a ellos desde todos los bloques de script dentro de la historia.

En el siguiente ejemplo, puede ver una pestaña Estructura de la historia de SAP Analytics Cloud y el panel Variable de script. Puede:

1. Crear una nueva variable de script en la pestaña Esquema de una historia
2. Nombrar la variable de script
3. Seleccione el tipo de datos de la variable de script
4. Active la variable de script que se va a utilizar como parámetro de URL. Para las variables de tipo matriz y las variables de tipo no primitivo (tipos distintos de string, boolean, integer y number), la función de parámetro de URL no se aplica y la opción está desactivada de forma predeterminada.

Con las variables de script globales, puede pasar un parámetro del URL a la historia. Por ejemplo, podría:

• Pasar un valor que se utiliza como filtro para una dimensión
• Pasar un valor que se utiliza para definir una disposición específica

Si desea pasar una variable de script global como parámetro de URL, debe anteponer el nombre de la variable con p_ en el URL con el siguiente formato: <yourAppURL>&p_<VariableName>=<VariableValue>.

Por ejemplo, <yourAppURL>&p_viewMode=condensed. Este escenario se utiliza en un ejercicio, por lo que verá los pasos para crearlo más adelante en esta lección.

Al utilizar variables de script expuestas como parámetro "URL", se establecen en la carga inicial de la historia.

Con la opción Activar URL dinámico, el valor de URL también se puede actualizar durante el uso de la historia. Por ejemplo, cuando un usuario abre una historia con el parámetro de URL p_Entity=Alemania y en el modo de visualización cambia un filtro a Francia. El parámetro de URL se actualiza a p_Entity=France sin necesidad de volver a iniciar la historia por completo. A continuación, el usuario también puede marcar este URL y compartirlo con otros con la certeza de que se aplicará el mismo filtro.

En lecciones anteriores, se examinó la definición de elementos para el widget manualmente mediante entrada directa y dinámicamente mediante scripting. En esta lección, veremos la definición dinámica de los elementos para el widget mediante la vinculación de propiedades.

La función de vinculación de propiedades ofrece al diseñador de historias la opción de vincular los valores a uno de los siguientes objetos:

• Variables de script
• Variables de modelo
• Filtros y variables de mosaico

La vinculación de valores de widget es una forma fácil de crear valores dinámicos para propiedades, por ejemplo, elementos de un widget Cuadro de lista.

En el siguiente ejemplo, puede ver una lista desplegable que muestra los valores de filtro definidos de la tabla. La entrada seleccionada se vuelve a escribir en una variable de script global.

El valor de un widget simple se puede vincular a uno de los siguientes:

• Variable de script de tipo primario
• Propiedad de aplicación
• Filtro y variable de mosaico
• Variable de modelo

La vinculación de valores está disponible para varios widgets diferentes. La siguiente lista le ofrece un resumen de los widgets y los tipos de vinculación admitidos:

1. Cuadro de lista, desplegable, grupo de casillas de seleccióny grupo de botones de selección
   • Valores vinculables: ID, texto de visualización
   • Vinculaciones admitidas: variable de script, filtro de widget y variable y variable de modelo
2. Campo de entrada, área de texto
   • Valores vinculables: IDText
   • Vinculaciones admitidas: variable de script, filtro y variable de widget, variable de modelo y propiedad de historia (incluido el usuario/hora/fecha actual, la fecha de la última modificación, la fecha/hora de la última modificación, el último modificador y el creador)
3. Botón deslizante
   • Valores vinculables: valor actual
   • Vinculaciones admitidas: variable de script, filtro y variable de widget, variable de modelo
4. Regulador de área
   • Valores vinculables: valor inicial y valor final
   • Vinculaciones admitidas: variable de script, filtro y variable de widget, variable de modelo
5. Imagen
   • Valores vinculables: URL de imagen
   • Vinculaciones admitidas: variable de script

También puede utilizar la opción de la función Reescribir en tiempo de ejecución. Con esto, puede asignar automáticamente el valor seleccionado por un usuario a una variable de script global que puede utilizarse en otros scripts o widgets.

El objeto de script global actúa como contenedor o biblioteca. Es una parte no visible de una historia.

Puede invocar una función de script con la siguiente sintaxis: <ScriptObjectName>.<ScriptFunctionName>();

Como diseñador de historias, puede utilizar una función para encapsular determinada lógica de script que se puede utilizar en otras funciones de script, como programas de control de eventos. Esto le impide duplicar código y facilita la actualización de historias. Una vez que haya añadido un objeto de script, puede crear funciones en este objeto. Cada función de script tiene:

1. Un nombre configurable (obligatorio)
2. Tipo de devolución (opcional)
3. Argumentos (opcional)

Puede acceder al objeto de script en scripts con su nombre como otros widgets. Dentro de una función del objeto de script, tiene acceso a todos los objetos de la historia, como widgets, variables globales o ventanas emergentes.

En la parte izquierda del siguiente ejemplo, puede ver el objeto de script Utils con una función de script llamada deviceSize.

Utiliza el ancho y el alto como argumentos de entrada y devuelve una matriz que contiene el tamaño y la orientación.

A la derecha puede ver lo siguiente:

1. El script dentro de la función de script
2. El uso de la función de script
3. Los resultados tal como se muestran en la consola

Con las funciones basadas en patrones, puede crear funciones basadas en cadenas proporcionando solo ejemplos de entrada y salida en lugar de escribir código de script. Por ejemplo, puede transformar direcciones de correo electrónico como john.doe@sap.com en nombres como John Doe.

Puede crear una función basada en patrón como inferior de un objeto de script desde el esquema de una historia.

1. Añadir función basada en patrón

   Seleccione Añadir función basada en patrón para añadirla a su historia. Una vez hecho esto, debe crear el patrón mediante ejemplos de formación de entrada y salida.

2. Propiedades

   Añada un nombre para la función en el campo Nombre. También puede añadir una Descripción opcional a la función.

3. Crear patrón

   Seleccione el icono Añadir junto a Crear patrón. En Ejemplo de formación, defina la entrada y la salida (por ejemplo, Entrada: max.mustermann@sap.com se convertirá en Salida: Max Mustermann).

   A veces, un ejemplo no es suficiente debido a la posible ambigüedad. En este caso, puede utilizar hasta tres ejemplos de formación seleccionando el icono Añadir para cada ejemplo de formación.

4. Crear/Restablecer

   Seleccione Crear para que un algoritmo de aprendizaje automático empiece a buscar un patrón que coincida con cada ejemplo.

   En cuanto modifica un ejemplo de entrenamiento, el patrón vuelve a su valor predeterminado, que solo devuelve la entrada. Si desea deshacer las modificaciones en ejemplos de formación nuevos o modificados, seleccione Restablecer. Esto establece la función basada en patrón en el último patrón de trabajo.

5. Verificar patrón

   Si la creación del patrón se ha realizado correctamente, puede verificar el patrón introduciendo ejemplos de entrada que sigan el patrón de ejemplo de entrenamiento. Si introduce ejemplos que no siguen el patrón anterior, la función mantendrá su patrón predeterminado, que es solo la salida de la entrada. Para verificar el patrón, seleccione el icono Añadir junto a Verificar patrón. Escriba un ejemplo de prueba en el campo Entrada y en el campo Salida, debería ver la salida correcta.