Cargar scripts

Completado

El script debe cargarse primero como recurso web de script para usar los scripts de cliente en un formulario. Puede usar los recursos web de script para mantener bibliotecas de funciones de script de cliente que se han escrito en JavaScript o TypeScript, y puede usarlas desde un formulario de aplicación basada en modelo o desde la definición de la cinta de la barra de comandos. Si se usa TypeScript, debe transcodificarse a JavaScript antes de cargarlo como recurso web.

Para cargar un recurso web de script, cree una nueva biblioteca Formularios desde el editor de formularios.

Captura de pantalla del cuadro de diálogo Agregar biblioteca.

Asegúrese de seleccionar Script(JScript) como tipo.

Captura de pantalla que muestra el cuadro de diálogo de agregar recurso web con Tipo de script seleccionado

Para que los datos de las columnas de la tabla estén disponibles para incluirse en la lógica de un script, debe asegurarse de configurar el formulario para usar la columna en el formulario. Además de tener que agregar la columna como control en el formulario, corre el riesgo de que alguien la elimine y haga que su script deje de funcionar porque la columna a la que hace referencia ya no está disponible. Para asegurarse de que los datos de las columnas estén siempre disponibles para el script, puede agregar la columna como una dependencia. La siguiente imagen muestra la adición de la columna Puntuación de ideas de la tabla Idea como dependencia.

Captura de pantalla de la adición de la columna de números de cuenta de la tabla de cuentas como dependencia

Dependencias de recursos web

Además de las dependencias de datos, también puede configurar dependencias en otros recursos web. Esta dependencia ahorra tiempo y simplifica la lógica de carga, porque el formulario no necesita cargar explícitamente varios recursos web dependientes al registrar un script para un evento de formulario, comando de cinta o reglas de habilitación de cinta. Con la configuración de dependencia, puede registrar el script principal y dejar que la configuración de dependencia cargue el resto de recursos de los que depende su código.

Es importante tener en cuenta que las dependencias de recursos web no proporcionan ningún control sobre el orden en que se cargan los recursos web. Todos los recursos web se cargan de forma asincrónica y en paralelo. Si tiene un recurso web de JavaScript, que depende de que se cargue e inicialice otro recurso web de JavaScript para poder inicializarse, debe administrar esa dependencia de otra manera.

Usar bibliotecas de scripts de clientes

Una vez configuradas como recurso web de script, las bibliotecas de scripts de clientes se pueden asociar a comandos de cinta y eventos de formulario. Para asociar un script con un formulario, seleccione las Bibliotecas de formularios, en la barra de herramientas, y luego en Agregar biblioteca.

Captura de pantalla de las bibliotecas de formularios que agregan una biblioteca

Desde el cuadro de diálogo Agregar biblioteca, puede asociar un recurso web de script cargado existente o crear uno nuevo.

Captura de pantalla del cuadro de diálogo de agregar biblioteca, que muestra que puede asociar un recurso web de script cargado existente o crear uno nuevo.

Solo es necesario asociar la biblioteca de scripts con el formulario una vez por script para cada formulario, independientemente de la cantidad de controladores de eventos que registre en ese formulario.

A medida que cree la lógica de scripts del cliente y necesite realizar cambios después de la carga inicial, debería volver al recurso web de script de la solución y cargar la nueva versión del archivo. Después de la carga, debe publicar el recurso web de script para que la aplicación utilice los últimos cambios.