Ejemplo: proyecto de scripting
Authentic Desktop viene con un proyecto de scripting de ejemplo que puede encontrar aquí: C:\Users\<user>\Documents\Altova\Authentic2024\AuthenticExamples\SampleScripts.asprj. Este proyecto consiste en unas pocas macros y un formulario de Windows.
Para cargar el proyecto de scripting en el Editor de scripts:
1.En el menú Herramientas haga clic en Editor de scripts.
2.Haga clic en Abrir y navegue hasta el archivo SampleScripts.asprj desde la ruta indicada más arriba.
El proyecto contiene vaciar macros en el directorio "Macros".
Macro | Descripción |
AddMacroMenu | Esta macro añade un elemento de menú nuevo a Authentic Desktop invocando el método Application.AddMacroMenuItem de la API COM. El primer argumento del método Application.AddMacroMenuItem es el nombre de la macro que se quiere añadir (en este ejemplo, "CloseAllButActiveDoc") y el segundo argumento es el texto que aparece con ese elemento del menú.
Siempre que se ejecute esta macro se añade un comando de menú nuevo llamado "CloseAllButActiveDoc" al menú Herramientas. Para eliminar los elementos de menú de la macro creados anteriormente puede reiniciar Authentic Desktop o crear una macro que llame al método de la API Application.ClearMacroMenu. |
CloseAllButActiveDocument | Cuando se ejecuta, esta macro itera por todos los documentos abiertos en Authentic Desktop y los cierra todos, excepto el que esté activo. |
SearchPath | Esta macro muestra un formulario que permite a los usuarios buscar archivos dentro del proyecto actual. El formulario está en el directorio "Formularios",, donde puede ver el diseño y los controladores de eventos asociados.
El método GetAllPathsFromProject() devuelve como matriz todas las rutas de acceso a archivos que pertenecen al proyecto abierto en ese momento. La definición de este método está en el script GlobalDeclarations del proyecto. El método InsertStringInArrayUnique controla que solamente se añadan rutas de acceso únicas a la matriz. A continuación, el formulario se inicializa con CreateForm. Por último, la matriz se convierte en un tipo .NET con el método CreateForm. y el formulario se rellena con la colección ArrayList resultante.
El botón Abrir del formulario tiene un controlador que llama al método Application.Documents.OpenFile de la API para abrir el archivo seleccionado. |
Para habilitar el proyecto de scripting como proyecto global de sc de Authentic Desktop:
1.En el menú Herramientas haga clic en Opciones.
2.Haga clic en la pestaña Scripting.
3.En "Archivo de proyecto de scripting global" haga clic en Examinar y seleccione el archivo SampleScripts.asprj en la ruta indicada más arriba.
4.Este proyecto de scripting no tiene macros o controladores de eventos automáticos, por lo que no necesita marcar las casillas Ejecutar macros automáticas... o Procesar eventos.
5.Haga clic en Aplicar.
En este punto en el menú Herramientas | Macros aparecen varios elementos nuevos.
Para ejecutar la macro "SearchPath":
1.Abra un proyecto de Authentic Desktop que contenga varios archivos (en este ejemplo, C:\Users\<user>\Documents\Altova\Authentic2024\AuthenticExamples\Examples.spp).
2.En el menú Herramientas haga clic en Macros y después haga clic en Ruta de búsqueda (SearchPath).
3.Teclee el término de búsqueda (en este ejemplo, ".xml").
En la imagen se ve cómo aparecen todos los nombres de archivos que contienen el término de búsqueda. Para mostrar uno de esos elementos en el editor principal haga clic en cualquiera de ellos y después haga clic en Abrir.