Creating & Storing Scripts

Gli script di Altium Designer vengono solitamente creati e memorizzati in un Progetto Script (*.PrjScr), ma possono essere aggiunti o memorizzati in qualsiasi tipo di progetto.

Per iniziare a scrivere script, comincia creando un nuovo progetto script e aggiungendo file di script a quel progetto.

Creazione di progetti script e script

Un Progetto Script ti aiuta a gestire i tuoi script e può essere creato selezionando File » New » Script » Script Project dai menu principali.

Un nuovo progetto (Script_Project1.PrjScr) per memorizzare gli script verrà elencato nel pannello Projects.

Per aggiungere un nuovo script al progetto, fai clic con il pulsante destro sul nome del progetto e seleziona Add New to Project dal menu contestuale.

Una volta creato un nuovo progetto script, aggiungi un nuovo script al progetto.

Quando si crea un nuovo script, ci sono due tipi di script tra cui scegliere in base ai requisiti del progetto: unità script e form script.

Tipi di script

Unità script

Un'unità script è un documento di script con una sintassi di linguaggio specifica, ad esempio DelphiScript.

Una Script Unit con codice script.

Form script

Una Form Script è una finestra che può ospitare una serie di controlli come pulsanti, memo e caselle di riepilogo, ai quali possono essere associati gestori di eventi. Nell'editor, una Form Script ha due viste selezionabili con le schede Code e Form, come si può vedere nella parte inferiore del documento di script mostrato di seguito.

Una Form Script con una scheda Code e una scheda Form aperte.

Relazioni tra script all'interno di un progetto

Quando in un progetto sono presenti più script, qualsiasi script (che utilizza lo stesso insieme di linguaggi) all'interno di quel progetto ha accesso a variabili globali e procedure. Tutti gli script in un progetto sono di fatto "visibili", quindi una procedura in uno script può chiamare un'altra procedura in uno script diverso all'interno dello stesso progetto script.

È importante avere nomi univoci per procedure e variabili globali negli script all'interno dello stesso progetto. Un approccio consiste nello spostare tutte le procedure/funzioni comuni utilizzate in script diversi in un nuovo script all'interno dello stesso progetto. Questo consente di riutilizzare facilmente le procedure e le funzioni di questo nuovo script comune in diversi progetti script.

► Fai riferimento a Writing Scripts per un esempio di chiamata di una procedura da un altro script.

Caricamento di un progetto script nel Workspace connesso

Altium Designer, in combinazione con il Workspace connesso, offre la possibilità di creare e gestire Workspace Script. Tali script vengono creati direttamente nel Workspace, con il relativo progetto script (*.PrjScr) caricato in una revisione di uno Workspace Script di destinazione. Il processo è il seguente:

1. Crea un nuovo elemento Script nel Workspace connesso utilizzando il pannello Explorer. Fai riferimento alla pagina Creating & Editing Content per ulteriori informazioni sulla creazione di elementi nel Workspace.

2. Fai clic con il pulsante destro del mouse sull'elemento Script richiesto nel pannello Explorer e scegli il comando Upload dal menu contestuale. Verrà visualizzata la finestra di dialogo standard di Windows Open, con cui potrai individuare il file del progetto script richiesto (*.PrjScr).

   Se l'elemento non ha una revisione pianificata, il caricamento verrà eseguito nella revisione pianificata successiva, creata al volo come parte del processo di caricamento.

   
   Specifica del file di progetto script da caricare nell'elemento Script di destinazione.

3. Con il file desiderato selezionato, procedi con il caricamento facendo clic sul pulsante Open. Il file di progetto, insieme a tutti i file nella stessa cartella, viene caricato nella revisione e sarà disponibile nella scheda di visualizzazione dell'aspetto Details per quella revisione, nel pannello Explorer.

   
   Il progetto caricato, insieme a tutti i file nella stessa cartella, è elencato nella scheda di visualizzazione dell'aspetto Details per la revisione dell'elemento Script.

In alternativa, un progetto script può essere caricato in un nuovo Workspace Script trascinando il file del progetto script selezionato e i file sorgente correlati da una cartella di origine in Esplora risorse di Windows e rilasciandoli nella cartella richiesta nel pannello Explorer. Verrà visualizzata la finestra di dialogo Create New Item, con i file trascinati elencati nell'area Sources. Il Name dell'elemento sarà costituito dai nomi dei file, inclusa l'estensione (le voci saranno separate da un punto e virgola). Il Description sarà nel formato Uploaded from <FileNameandPath>, Size <FileSize>, Created on <FileCreationDate> (le voci saranno separate da un punto e virgola). Modificali secondo necessità. Il Item ID sarà conforme allo schema di denominazione degli elementi definito a livello di cartella. Se per la cartella non è definito alcuno schema di denominazione, la denominazione seguirà lo schema $CONTENT_TYPE_CODE-{000000}.

Caricamento di un progetto script e dei file correlati nella revisione iniziale di un nuovo Workspace Script creato con il metodo drag-and-drop.

Modifica di un Workspace Script

In qualsiasi momento, puoi tornare a qualsiasi revisione di un Workspace Script e modificarla direttamente. Fai clic con il pulsante destro sulla revisione nel pannello Explorer e scegli il comando Edit dal menu contestuale. Questo aprirà quella revisione in Altium Designer, dove potrà essere modificata secondo necessità, quindi salvata nuovamente nel Workspace come revisione successiva utilizzando il comando Save to server (scorciatoia: Ctrl+Alt+S) – disponibile dal menu contestuale associato alla voce del progetto nel pannello Projects.

Accesso al comando per avviare la modifica diretta di una revisione esistente di uno script.

Se devi modificare il progetto o il sorgente associato memorizzato in un Workspace Script e disponi dei file sorgente aggiornati, puoi caricare tali file in quel Workspace Script: i nuovi file verranno memorizzati nella revisione successiva di quel Workspace Script.

Progetti globali

I progetti script possono essere installati utilizzando la funzionalità Global Projects in modo che vengano precaricati e resi disponibili all'avvio del software. Le variabili globali e le procedure di questi script sono disponibili per l'uso in altri progetti script aperti.

Per rendere globale un progetto script, vai alla pagina Scripting System - Global Projects tramite la finestra di dialogo Preferences. Usa il pulsante Install per individuare e selezionare un progetto dal file system o dal Workspace. Ripeti questo processo per tutti i progetti script che desideri rendere disponibili globalmente.

Il progetto Workspace Script installato sarà disponibile in Altium Designer ogni volta che un utente è connesso al Workspace. Nota che il progetto Workspace Script installato è elencato in base alla sua posizione o "percorso" all'interno della struttura di cartelle del Workspace e all'ID del Workspace Script che contiene i dati del progetto script.

Usa Scripting System – Global Projects dalla finestra di dialogo Preferences per installare gli script.

I Progetti globali consentono agli script di un progetto locale dello stesso tipo di utilizzare routine dai progetti script globali installati. Quando viene aperta la finestra di dialogo Select item to Run (File » Run Script), i progetti script installati appariranno insieme agli altri progetti script attualmente aperti nel pannello Projects .