Ampliación de widgets de botón para ejecutar objetos técnicos de acción de datos

Los widgets de botones se pueden ampliar a:

• Visualizar diálogos personalizados y mensajes emergentes. Por ejemplo, los botones se pueden ampliar para proporcionar al usuario mensajes y diálogos personalizados, mientras que los iniciadores de acciones de datos solo muestran los diálogos de sistema integrados.
• Seleccione el contexto de otro widget (como una tabla de datos) y aplíquelo automáticamente a su objeto técnico de acción de datos. Los botones se pueden ampliar para eliminar la necesidad de proporcionar valores manualmente en un diálogo de petición.
• Añada botones en el modo de visualización para permitir que los usuarios apliquen rápidamente las opciones solo disponibles en el modo de edición. Por ejemplo, si un planificador no tiene acceso de edición a una historia, puede pulsar un botón para modificar una propiedad como fijar una tabla en solo lectura.
• Visualizar una lista de versiones para una tabla de datos.
• Permita un acceso fácil a las opciones de la barra de herramientas más utilizadas, como actualizar y revertir, lo que facilita a los planificadores porque ya no necesitan buscar opciones en la barra de herramientas.

Una acción de datos es una herramienta de planificación flexible para realizar modificaciones estructuradas en una versión de datos de modelo, como copiar datos de un modelo a otro. Sin embargo, hay dos formas de utilizar acciones de datos en una historia:

1. Uso de un widget Iniciador de acción de datos.

   Este tema se trata en detalle en el curso Aprovechamiento de funciones avanzadas en SAP Analytics Cloud para planificación.

2. Uso de un objeto técnico de acciones de datos y API relacionadas. Puede hacer lo siguiente:
   • Realice acciones de datos.
   • Establezca los valores de parámetro de las acciones de datos.
   • Leer valores de parámetro de acciones de datos.
   

Vea este vídeo para obtener más información sobre los requisitos del equipo para un botón de acción de datos que se amplía con scripting.

Su equipo ha creado una historia que utilizan todos los planificadores del equipo. Actualmente, la historia tiene acciones de datos, pero cuando se hace clic en ellas, los planificadores reciben un mensaje del sistema que dice Espere mientras se ejecuta la acción de datos, un indicador de ocupado y una opción para ejecutar el job en proceso de fondo.

El equipo prefiere que las modificaciones se bloqueen hasta que finalice la acción de datos y los datos se actualicen automáticamente. No desean que la opción Ejecutar en proceso de fondo esté disponible para los planificadores.

Le sugerimos que amplíe la historia con un botón de acción de datos. El botón solo aparecerá cuando haya una versión privada disponible y no permitirá a los planificadores ejecutar la acción de datos en proceso de fondo.

Después de trabajar con su colega Christine para comprender completamente el requisito empresarial para el botón de acción de datos ampliado, creará un botón de acción de datos que:

1. Solo aparece cuando hay una versión privada.
2. Copia y actualiza los datos.
3. Tiene un indicador de ocupado sin una ventana de diálogo mientras se está ejecutando.
4. Indica al planificador cuándo se ejecuta correctamente.

Antes de añadir el scripting, primero debe crear y configurar la acción de datos y, a continuación, añadir el objeto técnico de acción de datos a su historia.

En el siguiente ejemplo, el objeto técnico de acción de datos DataAction_1 se ha añadido a la historia de planificación y se ha configurado con la acción de datos y los parámetros como se muestra.

Añada un widget de botón a la página de historia. Este botón BTN_Copy se utilizará para ejecutar la acción de datos.

Visibilidad del tiempo de visualización: compruebe que el panel Estilo del botón garantice que está fijado en Oculto. Esto garantizará que el botón no aparezca temporalmente mientras se ejecuta el script que planea añadir para verificar si se están ejecutando versiones privadas

Para el botón BTN_Copy, seleccione Más acciones y añádale un script onClick.

El siguiente script se utiliza para ejecutar el objeto técnico de acción de datos DataAction_1 cuando se selecciona el botón para copiar y, a continuación, actualizar los datos en la tabla:

12
DataAction_1.execute();
TBLPLANNING.getDataSource().refreshData();

Cree el objeto de script SO_Planning – updateButtonVisibility y añada el código a continuación para mostrar y ocultar el botón BTN_Copy en función de si existe o no una versión privada:

12345678910
// retrieve all private versions available in the model
var selectedPrivateVersion = TBLPLANNING.getPlanning().getPrivateVersions();

// if private version exists
if (selectedPrivateVersion.length > 0) {
	BTN_Copy.setVisible(true);
	} 
else {
	BTN_Copy.setVisible(false);
	}

El botón está configurado para que esté oculto de forma predeterminada, por lo que debe añadir el siguiente código a Page_1 - onInitialization:

12
//Call Global Script function to populate story with button if private version exists
SO_Planning.updateButtonVisibility();

Una vez actualizada la tabla, es importante verificar si hay versiones privadas, por lo que debe añadir el siguiente código a TBLPLANNING - onResultChanged:

1
SO_Planning.updateButtonVisibility();

Añada un indicador de ocupado que aparece cuando se hace clic en el botón Copiar y actualizar datos para mostrar al usuario que la acción de datos se está ejecutando:

1
Application.showBusyIndicator();

Ocultar el indicador de ocupado cuando la acción de datos haya terminado de ejecutarse:

1
Application.hideBusyIndicator();

Añada el siguiente código para visualizar el mensaje personalizado una vez que la acción de datos se ejecute correctamente:

1
Application.showMessage(ApplicationMessageType.Success,"The data action has run successfully and the table has refreshed.");