Creación y almacenamiento de scripts

De un vistazo

Aprende a crear, organizar y almacenar scripts en Altium Designer, desde la configuración de un proyecto de scripts hasta la gestión de revisiones en un Workspace conectado. Este artículo explica las unidades y los formularios de scripts, cómo los scripts comparten variables y procedimientos dentro de un proyecto y cómo los proyectos globales permiten que los scripts estén disponibles entre sesiones. Sigue leyendo para dar el siguiente paso en la gestión de tus scripts de Altium Designer con confianza.

- 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.
Profundiza con IA:
 

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.
Una vez creado el nuevo proyecto de scripts, añada un nuevo script al proyecto.

Utilice File » Save Project As para guardar el proyecto con el nombre deseado. Del mismo modo, utilice File » Save As para guardar y cambiar el nombre del nuevo script.

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.
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.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:

  1. 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.
  2. 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).

    Si el elemento no tiene ninguna revisión planificada, la carga se realizará en la siguiente revisión planificada, que se creará sobre la marcha como parte del proceso de carga.

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

  3. 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.
    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.
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.

Al hacer clic con el botón derecho en la entrada de nivel superior de un script del espacio de trabajo, se editará la revisión más reciente de ese script.

Acceso al comando para iniciar la edición directa de una revisión existente de un script.
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.

Para abrir el archivo de proyecto almacenado en una revisión de un script del espacio de trabajo, o uno de sus archivos fuente asociados, seleccione el archivo en la pestaña de vista Details de la revisión en el panel Explorer y, a continuación, haga clic con el botón derecho y seleccione el comando Open en el menú contextual. El proyecto (junto con todos sus archivos fuente) o los archivos fuente seleccionados (como documentos independientes) se abrirán en Altium Designer.

Un script del espacio de trabajo se puede utilizar indirectamente como parte de una revisión de un elemento de preferencias de diseño, cuando se instala como parte de esas preferencias publicadas a través de la página Sistema de scripting – Proyectos globales del cuadro de diálogo Preferences, en uno o varios Environment Configurations definidos. Una configuración de entorno se utiliza para restringir el entorno de trabajo de un diseñador al uso exclusivo de elementos de diseño aprobados por la empresa. Las configuraciones de entorno se definen y almacenan en el Centro de configuración de equipos, un servicio proporcionado a través del espacio de trabajo. Una vez que se haya conectado al espacio de trabajo y haya elegido, si corresponde, una de las configuraciones de entorno disponibles, Altium Designer se configurará en lo relativo al uso de las preferencias. Si la configuración de entorno elegida tiene definida una revisión de un elemento de preferencias de diseño, esta se aplicará de inmediato. Si la configuración de entorno elegida que le corresponde no tiene especificada una revisión de un elemento de preferencias de diseño, las preferencias se podrán seguir definiendo manualmente. En otras palabras, podrá reutilizar manualmente una revisión de un elemento de preferencias de diseño o utilizar un archivo de preferencias guardado localmente. Para obtener más información, consulte Environment Configuration Management (Espacio de trabajo de Altium 365, Espacio de trabajo de Enterprise Server). Consulte la página Acceso, definición y gestión de las preferencias del sistema para obtener más información sobre cómo guardar las preferencias de diseño en un espacio de trabajo conectado.

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.
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 .

Los enlaces de referencia al espacio de trabajo creados en las Preferencias por un proyecto de scripts del espacio de trabajo instalado se conservan y, por lo tanto, se incluirán si el conjunto de preferencias actual también se guarda en el espacio de trabajo. Por consiguiente, si se reutiliza una revisión del elemento de preferencias de diseño resultante, esta proporcionará automáticamente el script del espacio de trabajo vinculado. Consulte la página Acceso, definición y gestión de las preferencias del sistema para obtener más información sobre cómo guardar las preferencias de diseño en un espacio de trabajo conectado.
AI-LocalizedLocalizado por IA
Si encuentra un problema, seleccione el texto/imagen y presioneCtrl + Enterpara enviarnos sus comentarios.
Nav
Contents
Disponibilidad de funciones

Las funciones disponibles para usted dependen de qué solución de Altium tenga: Altium Develop, Altium Agile Teams, Altium Agile Enterprise o Altium Designer (con suscripción activa).

Si no ve una función documentada en su software actual, contacte con Ventas de Altium para obtener más información.

Documentación heredada

La documentación de Altium Designer ya no está versionada. Si necesita acceder a la documentación de versiones anteriores de Altium Designer, visite la sección Documentación heredada de la página de Otros instaladores.

Contents