Creación y almacenamiento de scripts

Los scripts de Altium Designer normalmente se crean y almacenan en un proyecto de scripts (*.PrjScr), pero pueden agregarse o almacenarse en cualquier tipo de proyecto.

Para comenzar a escribir scripts, empiece creando un nuevo proyecto de scripts y agregando 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.

Un nuevo proyecto (Script_Project1.PrjScr) para almacenar scripts aparecerá en el panel Projects.

Para agregar 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, agregue un nuevo script al proyecto.

Al crear un nuevo script, hay dos tipos de script entre los que puede elegir según los requisitos de su proyecto: unidades de script y formularios de script.

Tipos de script

Unidades de script

Una unidad de script es un documento de script con una sintaxis de lenguaje específica, 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 una variedad de controles, como botones, notas y cuadros de lista, que pueden tener controladores de eventos. En el editor, un formulario de script tiene dos vistas seleccionables con las pestañas Code y Form, como puede verse en la parte inferior del documento de script que se muestra a continuación.

Un formulario de script con una pestaña Code y una pestaña Form abiertas.

Relaciones entre scripts dentro de un proyecto

Cuando hay varios scripts en un proyecto, cualquier script (que use el mismo conjunto de lenguaje) dentro de ese proyecto tiene acceso a variables globales y procedimientos. En efecto, todos los scripts de un proyecto son “visibles”, por lo que un procedimiento de un script puede llamar a otro procedimiento de un script diferente dentro del mismo proyecto de scripts.

Es importante tener nombres únicos de procedimientos y variables globales para los scripts dentro del mismo proyecto. Un enfoque consiste en mover todos los procedimientos/funciones comunes que se usan en distintos scripts a un nuevo script dentro del mismo proyecto. Esto permite reutilizar fácilmente los procedimientos y funciones de este nuevo script común en diferentes proyectos de scripts.

► Consulte Writing Scripts para ver un ejemplo de cómo llamar a un procedimiento desde otro script.

Carga de un proyecto de scripts en el Workspace conectado

Altium Designer, junto con su Workspace conectado, ofrece la capacidad de crear y gestionar scripts del Workspace. Estos scripts se crean directamente dentro del Workspace, y el proyecto de scripts correspondiente (*.PrjScr) se carga en una revisión de un Workspace Script de destino. El proceso es el siguiente:

1. Cree un nuevo Script Item en su Workspace conectado usando el panel Explorer. Consulte la página Creating & Editing Content para obtener más información sobre la creación de Items en el Workspace.

2. Haga clic con el botón derecho en el Script Item requerido en el panel Explorer y elija el comando Upload en el menú contextual. Aparecerá el cuadro de diálogo estándar de Windows Open, con el que podrá buscar el archivo de proyecto de script requerido (*.PrjScr).

   Si el Item no tiene una revisión planificada, la carga se realizará en la siguiente revisión planificada, creada sobre la marcha como parte del proceso de carga.

   
   Especificación del archivo de proyecto de script que se cargará en el Script Item de destino.

3. Con el archivo deseado seleccionado, continúe con la carga haciendo clic en el botón Open. El archivo del proyecto, junto con todos los archivos de la misma carpeta, se cargan a la revisión y estarán disponibles en la pestaña de vista de aspecto Details para esa revisión, en el panel Explorer.

   
   El proyecto cargado, junto con todos los archivos de la misma carpeta, se muestra en la pestaña de vista de aspecto Details para la revisión del Script Item.

Como alternativa, un proyecto de script puede cargarse en un nuevo Workspace Script arrastrando el archivo de proyecto de script seleccionado y los archivos fuente relacionados desde una carpeta de origen en el Explorador de Windows y soltándolos en la carpeta requerida del panel Explorer. Aparecerá el cuadro de diálogo Create New Item, con los archivos arrastrados listados en la región Sources. El Name del Item será el nombre de los archivos, incluida la extensión (las entradas estarán separadas por punto y coma). El Description tendrá el formato Uploaded from <FileNameandPath>, Size <FileSize>, Created on <FileCreationDate> (las entradas estarán separadas por punto y coma). Cámbielos según sea necesario. El Item ID estará de acuerdo con el esquema de nombres de Item definido a nivel de carpeta. Si la carpeta no tiene definido un esquema de nombres, la nomenclatura seguirá el esquema $CONTENT_TYPE_CODE-{000000}.

Carga de un proyecto de script y archivos relacionados a la revisión inicial de un Workspace Script recién creado mediante el método de arrastrar y soltar.

Edición de un Workspace Script

En cualquier momento, puede volver a cualquier revisión de un Workspace Script y editarla directamente. Haga clic con el botón derecho en la revisión del panel Explorer y elija el comando Edit en el menú contextual. Esto abrirá esa revisión en Altium Designer, donde podrá editarse según sea necesario y luego guardarse de nuevo en el Workspace como la siguiente revisión mediante el comando Save to server (atajo: Ctrl+Alt+S), disponible en el menú contextual al hacer clic con el botón derecho sobre 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 cambiar el proyecto o el código fuente asociado almacenado en un Workspace Script, y dispone de los archivos fuente actualizados, puede cargar esos archivos en ese Workspace Script; los nuevos archivos se almacenarán en la siguiente revisión de ese Workspace Script.

Proyectos globales

Los proyectos de scripts pueden instalarse mediante la función Global Projects para que se precarguen y estén disponibles cuando se inicie el software. Las variables globales y los procedimientos de estos scripts están disponibles para usarse en otros proyectos de scripts abiertos.

Para hacer global un proyecto de scripts, vaya a la página Scripting System - Global Projects a través del cuadro de diálogo Preferences. Use el botón Install para buscar y seleccionar un proyecto desde el archivo o el Workspace. Repita este proceso para todos los proyectos de scripts que desee poner a disposición globalmente.

El proyecto de Workspace Script instalado estará disponible para Altium Designer siempre que un usuario esté conectado al Workspace. Tenga en cuenta que el proyecto de Workspace Script instalado aparece listado por su ubicación o “ruta” dentro de la estructura de carpetas del Workspace y el ID del Workspace Script que contiene los datos del proyecto de script.

Use 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. Cuando se inicia el cuadro de diálogo Select item to Run (File » Run Script), los proyectos de scripts instalados aparecerán junto con otros proyectos de scripts abiertos actualmente en el panel Projects .