Creación y almacenamiento de scripts
De un vistazo
- Crea y guarda proyectos de scripts, y comprende cuándo utilizar unidades o formularios de scripts.
- Carga proyectos de scripts en un Workspace conectado, edita los scripts almacenados y guarda las revisiones actualizadas.
- Instala proyectos de scripts locales o de un Workspace como proyectos globales para que sus rutinas estén disponibles para otros proyectos de scripts.
Los scripts de Altium Designer suelen crearse y almacenarse en un proyecto de scripts (*.PrjScr), pero pueden añadirse o almacenarse en cualquier tipo de proyecto.
Para empezar a escribir scripts, cree primero un nuevo proyecto de scripts y añada archivos de script a ese proyecto.
Creación de proyectos de scripts y scripts
Un proyecto de scripts le ayuda a gestionar sus scripts y puede crearse seleccionando File » New » Script » Script Project en los menús principales.
En el panel Projects aparecerá un nuevo proyecto (Script_Project1.PrjScr) para almacenar scripts.
Para añadir un nuevo script al proyecto, haga clic con el botón derecho en el nombre del proyecto y seleccione Add New to Project en el menú contextual.

Una vez creado el nuevo proyecto de scripts, añada un nuevo script al proyecto.
Al crear un nuevo script, puede elegir entre dos tipos según los requisitos de su proyecto: unidades de script y formularios de script.
Tipos de scripts
Unidades de script
Una unidad de script es un documento de script con la sintaxis de un lenguaje específico, por ejemplo, DelphiScript.

Una unidad de script con código de script.
Formularios de script
Un formulario de script es una ventana que puede alojar diversos controles, como botones, campos de texto multilínea y cuadros de lista, que pueden tener controladores de eventos. En el editor, un formulario de script tiene dos vistas que pueden seleccionarse con las pestañas Code y Form, como se puede ver en la parte inferior del documento de script que se muestra a continuación.
Un formulario de script con las pestañas de código y formulario abiertas.
Relaciones entre scripts dentro de un proyecto
Cuando hay varios scripts en un proyecto, cualquier script de ese proyecto que utilice el mismo lenguaje tiene acceso a las variables y los procedimientos globales. En la práctica, todos los scripts de un proyecto son «visibles», por lo que un procedimiento de un script puede llamar a otro procedimiento de un script distinto dentro del mismo proyecto de scripts.
Es importante que los nombres de los procedimientos y las variables globales de los scripts de un mismo proyecto sean únicos. Una opción consiste en trasladar todos los procedimientos y funciones comunes que se utilizan en distintos scripts a un nuevo script dentro del mismo proyecto. Esto permite reutilizar fácilmente los procedimientos y las funciones de este nuevo script común en distintos proyectos de scripts.
► Consulte Escritura de scripts para ver un ejemplo de cómo llamar a un procedimiento desde otro script.
Carga de un proyecto de scripts en el espacio de trabajo conectado
Altium Designer, junto con su espacio de trabajo conectado, permite crear y gestionar scripts del espacio de trabajo. Estos scripts se crean directamente en el espacio de trabajo, cargando el proyecto de scripts correspondiente (*.PrjScr) en una revisión del script de destino del espacio de trabajo. El proceso es el siguiente:
- Cree un nuevo elemento de script en su espacio de trabajo conectado mediante el panel Explorer. Consulte la página Creación y edición de contenido para obtener más información sobre cómo crear elementos en el espacio de trabajo.
-
Haga clic con el botón derecho en el elemento de script deseado en el panel Explorer y seleccione el comando Upload en el menú contextual. Aparecerá el cuadro de diálogo estándar de Windows Open, que le permitirá buscar el archivo de proyecto de scripts deseado (
*.PrjScr).
Especificación del archivo de proyecto de scripts que se cargará en el elemento de script de destino. -
Una vez seleccionado el archivo deseado, haga clic en el botón Open para continuar con la carga. El archivo del proyecto, junto con todos los archivos de la misma carpeta, se cargará en la revisión y estará disponible en la pestaña de vista Details de esa revisión, en el panel Explorer.

El proyecto cargado, junto con todos los archivos de la misma carpeta, aparece en la pestaña de vista Details de la revisión del elemento de script.
Como alternativa, puede cargar un proyecto de scripts en un nuevo script del espacio de trabajo arrastrando el archivo de proyecto de scripts seleccionado y los archivos fuente relacionados desde una carpeta de origen del Explorador de Windows y soltándolos en la carpeta deseada del panel Explorer. Aparecerá el cuadro de diálogo Create New Item, con los archivos arrastrados enumerados en la sección Sources. El campo Name del elemento contendrá los nombres de archivo, incluida la extensión (las entradas estarán separadas por punto y coma). El campo Description tendrá el formato Uploaded from <FileNameandPath>, Size <FileSize>, Created on <FileCreationDate> (las entradas estarán separadas por punto y coma). Modifique estos valores según sea necesario. El campo Item ID se ajustará al esquema de nomenclatura de elementos definido para la carpeta. Si la carpeta no tiene ningún esquema de nomenclatura definido, se utilizará el esquema $CONTENT_TYPE_CODE-{000000}.

Carga de un proyecto de scripts y sus archivos relacionados en la revisión inicial de un script del espacio de trabajo recién creado mediante el método de arrastrar y soltar.
Edición de un script del espacio de trabajo
En cualquier momento, puede volver a cualquier revisión de un script del espacio de trabajo y editarla directamente. Haga clic con el botón derecho en la revisión en el panel Explorer y seleccione el comando Edit en el menú contextual. Esto abrirá esa revisión en Altium Designer, donde podrá editarla según sea necesario y, después, guardarla de nuevo en el espacio de trabajo como la siguiente revisión mediante el comando Save to server (atajo de teclado: Ctrl+Alt+S), disponible en el menú contextual que aparece al hacer clic con el botón derecho en la entrada del proyecto en el panel Projects.

Acceso al comando para iniciar la edición directa de una revisión existente de un script.
Si necesita modificar el proyecto o los archivos fuente asociados almacenados en un script del espacio de trabajo y dispone de los archivos fuente actualizados, puede cargarlos en ese script del espacio de trabajo; los nuevos archivos se almacenarán en su siguiente revisión.
Proyectos globales
Los proyectos de scripts se pueden instalar mediante la función Global Projects para que se carguen previamente y estén disponibles al iniciar el software. Las variables y los procedimientos globales de estos scripts están disponibles para su uso en otros proyectos de scripts abiertos.
Para convertir un proyecto de scripts en global, acceda a la página Sistema de scripting - Proyectos globales a través del cuadro de diálogo Preferences. Utilice el botón Install para buscar y seleccionar un proyecto en el sistema de archivos o en el espacio de trabajo. Repita este proceso con todos los proyectos de scripts que desee que estén disponibles globalmente.
El proyecto de scripts del espacio de trabajo instalado estará disponible en Altium Designer siempre que un usuario esté conectado al espacio de trabajo. Tenga en cuenta que el proyecto de scripts del espacio de trabajo instalado se muestra con su ubicación o «ruta» dentro de la estructura de carpetas del espacio de trabajo y el ID del script del espacio de trabajo que contiene los datos del proyecto de scripts.

Utilice Scripting System – Global Projects del cuadro de diálogo Preferences para instalar scripts.
Los proyectos globales permiten que los scripts de un proyecto local del mismo tipo utilicen rutinas de los proyectos de scripts globales instalados. Al abrir el cuadro de diálogo Select item to Run (File » Run Script), los proyectos de scripts instalados aparecerán junto con los demás proyectos de scripts abiertos en ese momento en el panel Projects .