La herramienta de secuencias de comandos de página del cliente web de Business Central le permite registrar sus acciones, como abrir páginas o introducir datos, y reproducirlas. Puede guardar la grabación y compartirla con otras personas para reproducirla en el futuro. Un caso de uso importante para la herramienta es la captura y ejecución de pruebas de aceptación del usuario. Este caso de uso es el enfoque inicial de esta oleada de lanzamientos.
En el cliente web se accede a la herramienta de scripting de página desde el menú Configuración (icono de rueda dentada). La acción Scripting de página solo aparece si tiene permiso de grabación o reproducción para utilizar la herramienta.
![Elija Secuencias de comandos de página en el menú Configuración para abrirlo Elija Secuencias de comandos de página en el menú Configuración para abrirlo]()
Se abre el panel Secuencias de comandos de página a la derecha. Puede iniciar una nueva grabación o abrir una grabación existente para inspeccionarla o reproducirla.
![Al abrir Page Scripting, puede iniciar una nueva grabación o abrir una existente para reproducirla Al abrir Page Scripting, puede iniciar una nueva grabación o abrir una existente para reproducirla]()
Registro
Para registrar sus acciones e iniciar una prueba de aceptación del usuario, seleccione Iniciar nuevo o seleccione Nueva>nueva grabación en la barra de herramientas de la parte superior del panel. Cuando se inicia la grabación, la barra de herramientas muestra un círculo rojo sólido. Realice las acciones que desea capturar.
La herramienta de secuencias de comandos de página captura sus interacciones en pantalla y las acciones resultantes. Captura acciones como abrir o cerrar páginas, selecciones e introducción de datos.
Durante la grabación, puede eliminar el último paso capturado.
Para detener la grabación, utilice el botón Detener de la barra de herramientas. Para reanudar la grabación y agregar más pasos, seleccione el botón redondo Iniciar grabación en la barra de herramientas.
La siguiente imagen muestra algunos pasos capturados y la barra de herramientas durante la grabación.
![Ejemplo de pasos de registro Ejemplo de pasos de grabación]()
Opciones para capturar pasos
Durante la grabación, puede agregar pasos especiales haciendo clic con el botón secundario en un control de página, como un campo, y seleccionando una opción. En las secciones siguientes se explican estas opciones.
Copiar y pegar desde el portapapeles
La herramienta de scripting de página incluye un portapapeles que puede utilizar para copiar valores de campo. Por ejemplo, puede insertar valores copiados en otros campos, utilizarlos en expresiones o utilizarlos para validar los resultados. Para copiar y pegar durante la grabación, haga clic con el botón secundario en un control de página y seleccione Copiar o Pegar en el menú contextual.
![Ejemplo de pegar un valor copiado en el portapapeles Ejemplo de pegar un valor copiado en el portapapeles]()
Pegar la información de la sesión
Al grabar, puede acceder a la información de la sesión, como el ID de usuario. Con esta información, puede establecer filtros basados en el usuario actual. Para insertar el ID de usuario, haga clic con el botón secundario en un control de la página y seleccione Pegar>Información de sesión>ID de usuario. Para ver un ejemplo, consulte la imagen anterior.
Validar un resultado
Durante la grabación, inserte los pasos de validación para comprobar el resultado al reproducir la grabación. Haga clic con el botón secundario en un control, como un campo o una indicación, y seleccione Validar en el menú contextual. Este paso inserta un paso de validación con el valor actual. Para cambiar el valor que valida el paso, vaya al paso de validación en la lista de pasos Secuencias de comandos de página , seleccione el menú contextual ..., y seleccione Propiedades.
![Insertar un paso de validación durante la grabación Insertar un paso de validación durante la grabación]()
Convertir pasos en condicionales
Durante la grabación, puede insertar un paso de bifurcación condicional. Por ejemplo, es posible que solo desee dar algunos pasos durante la reproducción si no hay filas actuales en una lista.
Para insertar una rama de pasos condicionales, haga clic con el botón secundario en un control de página, seleccione Agregar pasos condicionales cuando y, a continuación, seleccione una opción.
Al insertar el paso condicional, puede agregar más pasos para realizar cuando se cumpla la condición.
Para finalizar la rama condicional, seleccione Finalizar ámbito en la lista de pasos Scripting de página.
Para cambiar la condición, seleccione el paso de condición en la lista de pasos Secuencias de comandos de página . Expanda las propiedades y establezca la regla de comparación y el valor.
![Modificar la regla de comparación y el valor del paso de comparación Modificar la regla de comparación y el valor del paso de comparación]()
Editar pasos capturados
Durante la grabación y la reproducción, puede editar un paso capturado en el panel Secuencias de comandos de página mediante el menú contextual ... en el paso. Las opciones del menú contextual dependen de si está en modo de grabación o reproducción y del tipo de paso. Algunas de las opciones se describen en las siguientes secciones.
Propiedades
Algunos pasos tienen propiedades que incluyen pasos condicionales o pasos de validación. Seleccione Propiedades en el menú contextual de un paso para ver las propiedades de un paso.
![Ejemplo de conjunto de valores de paso con una expresión de Power Fx Ejemplo de conjunto de valores de paso con una expresión de Power Fx]()
Uso de expresiones en propiedades
Los valores y las condiciones pueden utilizar expresiones para cálculos sencillos. Power Fx es el lenguaje de expresión. La interfaz de usuario proporciona un vínculo a la documentación de referencia de expresiones de Power Fx.
Además de las funciones Power Fx, hay disponibles tres objetos de nivel superior:
-
Clipboard
para acceder a las entradas actuales copiadas en la grabación. Parameters
para acceder al valor de cualquier parámetro que pase a la grabación. SessionInfo
para obtener información de sesión, como el ID de usuario actual.
Estos son algunos ejemplos:
- Para validar que un valor copiado anteriormente se incrementa en un paso de validación, utilice la expresión
Clipboard.'SO Processor Activities - ReadyToShip' + 1
. - Para generar un nombre "aleatorio" para utilizarlo en un paso de entrada, utilice la expresión
Customer " & Today()
.
Manejar páginas opcionales
A veces, un flujo registrado no muestra una página porque la página depende de los datos o la configuración. Por ejemplo, la página podría ser el cuadro de diálogo de confirmación que aparece al cerrar un pedido de ventas. Para controlar esta situación, convierta la página en una página opcional. El flujo ejecuta los pasos debajo de la página solo si la página aparece. Para hacer que una página sea opcional, vaya a la lista de pasos Secuencias de comandos de página , seleccione el paso registrado denominado Se mostró la página X, seleccione el menú contextual ..., y seleccione Convertir esta página en una página opcional.
![Cómo hacer que una página sea opcional Cómo hacer que una página sea opcional]()
Los pasos que se dan en la página están sangrados para indicar que son opcionales. Los pasos solo se ejecutan si aparece la página.
![Una vez que una página es opcional, los pasos de esa página aparecen anidados debajo de la página Una vez que una página es opcional, los pasos de esa página aparecen anidados debajo de la página]()
Reproducción
Seleccione Reproducir en la barra de herramientas para reproducir una grabación que haya capturado o abierto desde un archivo.
Durante la reproducción, puede:
- Avance o retroceda un solo paso utilizando los botones Adelante y Atrás de la barra de herramientas. Al retroceder, la herramienta no deshace los cambios. Debe deshacer los cambios manualmente.
- Vuelve al principio de la grabación.
- Ejecute la grabación hasta un paso determinado. Seleccione el menú contextual ..., y, a continuación, seleccione Ejecutar hasta aquí.
A medida que la herramienta reproduce los pasos, registra si cada paso se completa correctamente (marca de verificación verde) o falla (signo de exclamación rojo). La herramienta muestra el resultado de los pasos que validan un resultado.
![Resultado de la reproducción de una grabación. Incluye el resultado de cada paso. Resultado de la reproducción de una grabación. Incluye el resultado de cada paso.]()
Guardar una grabación
Seleccione Guardar en la barra de herramientas para guardar la grabación. Esta acción crea un archivo YAML que puede descargar, compartir, editar y volver a abrir para su reproducción.
Compartir una grabación
Seleccione Compartir en la barra de herramientas para compartir una grabación como un vínculo. El enlace incluye la grabación completa y el resultado de su reproducción. En el siguiente ejemplo, la reproducción falla a mitad de la grabación.
![Compartir una grabación junto con el resultado de la repetición Compartir una grabación junto con el resultado de la repetición]()
Acciones de captura admitidas
La herramienta de scripting de página captura acciones del código AL en ejecución. La herramienta no es una herramienta general de automatización de HTML. No puede automatizar elementos como complementos de control (como gráficos), Power BI o Power Apps incrustados, ni nada fuera de la experiencia del cliente web de Business Central.