Criando e Armazenando Scripts

Updated: October 07, 2025

Os scripts do Altium Designer são normalmente criados e armazenados num Projeto de Script (*.PrjScr), mas podem ser adicionados ou armazenados em qualquer tipo de projeto.

Para começar a escrever scripts, comece por criar um novo projeto de script e adicionar ficheiros de script a esse projeto.

Criar Projetos de Script e Scripts

Um Projeto de Script ajuda-o a gerir os seus scripts e pode ser criado selecionando File » New » Script » Script Project nos menus principais.

Um novo projeto (Script_Project1.PrjScr) para armazenar scripts será listado no painel Projects.

Para adicionar um novo script ao projeto, clique com o botão direito do rato no nome do projeto e selecione Add New to Project no menu de contexto.

Com um novo projeto de script estabelecido, adicione um novo script ao projeto.

Utilize File » Save Project As para guardar o projeto com o nome pretendido. De forma semelhante, utilize File » Save As para guardar e mudar o nome do novo script.

Ao criar um novo script, existem dois tipos de script à escolha, dependendo dos requisitos do seu projeto – Unidades de Script e Formulários de Script.

Tipos de Script

Unidades de Script

Uma unidade de script é um documento de script com uma sintaxe de linguagem específica, por exemplo, DelphiScript.

Uma Unidade de Script com código de script.

Formulários de Script

Um Formulário de Script é uma janela que pode alojar uma gama de controlos, como botões, memorandos e caixas de listagem, que podem ter processadores de eventos. No editor, um Formulário de Script tem duas vistas que podem ser selecionadas com os separadores Code e Form, como pode ser visto na parte inferior do documento de script mostrado abaixo.

Um Formulário de Script com um separador Code e um separador Form abertos.

Relações entre scripts num Projeto

Quando existem vários scripts num projeto, qualquer script (que utilize o mesmo conjunto de linguagem) nesse projeto tem acesso a variáveis globais e procedimentos. Todos os scripts num projeto estão, na prática, “visíveis”, pelo que um procedimento num script pode chamar outro procedimento num script diferente dentro do mesmo projeto de script.

É importante ter nomes únicos para os procedimentos e variáveis globais dos scripts dentro do mesmo projeto. Uma abordagem é mover todos os procedimentos/funções comuns que são utilizados em diferentes scripts para um novo script dentro do mesmo projeto. Isto permite que os procedimentos e funções nesse novo script comum sejam facilmente reutilizados em diferentes projetos de script.

► Consulte Writing Scripts para ver um exemplo de chamada de um procedimento a partir de outro script.

Carregar um Projeto de Script para o Workspace Ligado

O Altium Designer, em conjunto com o seu Workspace ligado, permite criar e gerir Scripts do Workspace. Esses scripts são criados diretamente no Workspace, sendo o projeto de script relevante (*.PrjScr) carregado para uma revisão de um Script do Workspace de destino. O processo é o seguinte:

Crie um novo Item de Script no seu Workspace ligado utilizando o painel Explorer. Consulte a página Creating & Editing Content para saber mais sobre a criação de Items no Workspace.
Clique com o botão direito do rato no Item de Script pretendido no painel Explorer e escolha o comando Upload no menu de contexto. Será apresentada a caixa de diálogo padrão do Windows Open, que lhe permitirá procurar o ficheiro de projeto de script pretendido (*.PrjScr).

Se o Item não tiver nenhuma revisão planeada, o carregamento será feito para a revisão planeada seguinte, criada dinamicamente como parte do processo de carregamento.

Especificar o ficheiro de projeto de script a carregar para o Item de Script de destino.
Com o ficheiro pretendido selecionado, prossiga com o carregamento clicando no botão Open. O ficheiro do projeto, juntamente com todos os ficheiros na mesma pasta, é carregado para a revisão e ficará disponível no separador de vista de aspeto Details dessa revisão, no painel Explorer.

O projeto carregado, juntamente com todos os ficheiros na mesma pasta, é listado no separador de vista de aspeto Details da revisão do Item de Script.

Em alternativa, um projeto de script pode ser carregado para um novo Script do Workspace arrastando o ficheiro de projeto de script selecionado e os ficheiros fonte relacionados a partir de uma pasta de origem no Windows Explorer e largando-os na pasta pretendida no painel Explorer. Será apresentada a caixa de diálogo Create New Item, com os ficheiros arrastados listados na região Sources. O Name do Item será os nomes dos ficheiros, incluindo a extensão (as entradas serão separadas por ponto e vírgula). O Description estará no formato Uploaded from <FileNameandPath>, Size <FileSize>, Created on <FileCreationDate> (as entradas serão separadas por ponto e vírgula). Altere-os conforme necessário. O Item ID estará de acordo com o esquema de nomenclatura de Item definido ao nível da pasta. Se a pasta não tiver um esquema de nomenclatura definido, a nomenclatura seguirá o esquema $CONTENT_TYPE_CODE-{000000}.

Carregar um projeto de script e ficheiros relacionados para a revisão inicial de um Script do Workspace recém-criado utilizando o método de arrastar e largar.

Editar um Script do Workspace

Em qualquer fase, pode regressar a qualquer revisão de um Script do Workspace e editá-la diretamente. Clique com o botão direito do rato na revisão no painel Explorer e escolha o comando Edit no menu de contexto. Isto abrirá essa revisão no Altium Designer, onde pode ser editada conforme necessário, e depois guardada novamente no Workspace como a revisão seguinte utilizando o comando Save to server (atalho: Ctrl+Alt+S) – disponível no menu de contexto associado à entrada do projeto no painel Projects.

Clicar com o botão direito do rato na entrada de nível superior do próprio Script do Workspace irá editar a revisão mais recente desse Script do Workspace.

Aceder ao comando para iniciar a edição direta de uma revisão existente de um script.

Se precisar de alterar o projeto ou a fonte associada armazenada num Script do Workspace, e tiver os ficheiros fonte atualizados, pode carregar esses ficheiros para esse Script do Workspace – os novos ficheiros serão armazenados na revisão seguinte desse Script do Workspace.

Para abrir o ficheiro de projeto armazenado numa revisão de um Script do Workspace, ou um dos seus ficheiros fonte associados, selecione esse ficheiro – no separador de vista de aspeto Details da revisão no painel Explorer – depois clique com o botão direito do rato e escolha o comando Open no menu de contexto. O projeto (também todos os ficheiros fonte) ou o(s) ficheiro(s) fonte (como documento(s) livre(s)) serão abertos no Altium Designer.

Um Script do Workspace pode ser utilizado indiretamente como parte de uma revisão de um Item de Preferências de Design – quando instalado como parte dessas preferências libertadas, através da página Scripting System – Global Projects da caixa de diálogo Preferences – em uma ou mais Environment Configurations definidas. Uma configuração de ambiente é usada para restringir o ambiente de trabalho de um designer a utilizar apenas elementos de design aprovados pela empresa. As configurações de ambiente são definidas e armazenadas no Team Configuration Center – um serviço disponibilizado através do Workspace. Depois de se ligar ao Workspace e de escolher (se aplicável) entre a seleção de configurações de ambiente disponíveis para si, o Altium Designer será configurado no que diz respeito à utilização de preferências. Se a configuração de ambiente escolhida tiver definida uma revisão de Item de Preferências de Design, então essa será aplicada de imediato. Se a configuração de ambiente escolhida aplicável a si não tiver especificada uma revisão de Item de Preferências de Design, então as preferências continuarão a poder ser definidas manualmente. Por outras palavras, é livre de reutilizar manualmente uma revisão de um Item de Preferências de Design ou de utilizar um ficheiro de preferências guardado localmente. Para mais informações, consulte Environment Configuration Management (Altium 365 Workspace, Enterprise Server Workspace). Consulte a página Accessing, Defining & Managing System Preferences para saber mais sobre como guardar preferências de design num Workspace ligado.

Projetos Globais

Os projetos de script podem ser instalados utilizando a funcionalidade Global Projects, de modo a serem pré-carregados e ficarem disponíveis quando o software é iniciado. As variáveis globais e os procedimentos desses scripts ficam disponíveis para utilização noutros projetos de script abertos.

Para tornar um projeto de script global, navegue até à página Scripting System - Global Projects através da caixa de diálogo Preferences. Utilize o botão Install para navegar até e selecionar um projeto a partir do ficheiro ou do Workspace. Repita este processo para todos os projetos de script que gostaria de disponibilizar globalmente.

O projeto de Script do Workspace instalado ficará disponível para o Altium Designer sempre que um utilizador estiver ligado ao Workspace. Note que o projeto de Script do Workspace instalado é listado pela sua localização ou “caminho” dentro da estrutura de pastas do Workspace e pelo ID do Script do Workspace que contém os dados do projeto de script.

Utilize Scripting System – Global Projects da caixa de diálogo Preferences para instalar scripts.
Utilize Scripting System – Global Projects da caixa de diálogo Preferences para instalar scripts.

Os Projetos Globais permitem que scripts de um projeto local do mesmo tipo utilizem rotinas dos projetos de script globais instalados. Quando a caixa de diálogo Select item to Run é iniciada (File » Run Script), os projetos de script instalados aparecerão juntamente com outros projetos de script atualmente abertos no painel Projects .

As ligações de referência do Workspace criadas nas Preferências por um projeto de script do Workspace instalado são mantidas e, por isso, serão incluídas se o conjunto atual de Preferências também for guardado no Workspace. Assim, uma revisão do Item de Preferências de Design resultante, se reutilizada, fornecerá automaticamente o script do Workspace ligado. Consulte a página Accessing, Defining & Managing System Preferences para saber mais sobre como guardar preferências de design num Workspace ligado.

Versão para impressão

Localizado por IA

Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.

Disponibilidade de Funcionalidades

As funcionalidades disponíveis dependem da solução Altium que possui – Altium Develop, uma edição do Altium Agile (Agile Teams ou Agile Enterprise), ou Altium Designer (com subscrição ativa).

Se não encontrar uma funcionalidade mencionada no seu software, contacte a equipa de Vendas da Altium para saber mais.

Documentação Legada

A documentação do Altium Designer já não é versionada. Se precisar de aceder à documentação de versões anteriores do Altium Designer, visite a secção Documentação Legada da página de Outros Instaladores.