Progetti del Workspace

Parent page: Altium On-Prem Enterprise Server

Altium Designer, in combinazione con il Workspace di Enterprise Server, offre il supporto per Workspace Projects. I progetti Workspace sono destinati alla fase di sviluppo del ciclo di vita del progetto, semplificando la creazione e il flusso di lavoro continuo per i progetti sotto controllo di versione. L'archiviazione centralizzata sotto il controllo del Workspace consente inoltre a questa funzionalità di costituire una base per altri servizi collaborativi.

Alcuni vantaggi chiave dell'utilizzo dei progetti Workspace sono:

• Archiviazione semplificata. Non è necessario prendere decisioni sulle posizioni di archiviazione. Il backup e altri servizi di base sono gestiti automaticamente.
• Base per funzionalità collaborative.
• Controllo di versione applicato.
• Vantaggi di un sistema di commenti dedicato.
• Notifiche e stato. Lo stato del documento, incluse le modifiche locali, è visibile all'intero team di progettazione.
• La progettazione PCB concorrente funziona senza alcuna configurazione complessa.
• Possibilità di condividere con altri utenti una vista interattiva di un progetto in sola lettura, basata su browser, tramite il Web Viewer.
• Una gamma di funzionalità avanzate di controllo di versione, come una vista interattiva della cronologia del progetto.

Dal punto di vista tecnico, un progetto Workspace è la combinazione di meta-informazioni memorizzate nel Workspace di Enterprise Server insieme a una stretta integrazione con il servizio di controllo di versione del Workspace stesso. Il flusso di lavoro tipico è il seguente:

1. Un utente crea un nuovo progetto Workspace tramite la finestra di dialogo Create Project di Altium Designer, convertendo un progetto locale esistente tramite la finestra di dialogo Make Available On Server , oppure dall'interfaccia browser del Workspace (descritta in dettaglio di seguito). Durante la creazione, l'utente definisce il nome del progetto, la descrizione e il repository di progettazione.
2. L'accesso al progetto viene definito e gestito nell'interfaccia browser del Workspace oppure direttamente all'interno di Altium Designer.
3. Tutti i collaboratori selezionano il progetto da aprire (sia da Altium Designer sia dall'interfaccia browser del Workspace), dopodiché esso viene automaticamente estratto come file di progettazione.

Questo documento esamina il lavoro con i progetti tramite l'interfaccia browser del Workspace di Enterprise Server. Per informazioni su come lavorare con i progetti nel software di progettazione, vedere Utilizzo dei progetti.

Creazione di un nuovo progetto Workspace

Esistono tre modi principali per creare un progetto Workspace:

• Creazione di un nuovo progetto dall'interfaccia browser del Workspace, oppure dall'interno di Altium Designer.
• Rendere disponibile al Workspace un progetto esistente (un progetto locale, oppure un progetto locale attualmente sotto controllo di versione esterno) dall'interno di Altium Designer – cioè convertire un progetto locale in un progetto Workspace. Per saperne di più, vedere la pagina Rendere disponibile nel Workspace un progetto esistente .
• Clonazione di un progetto Workspace esistente tramite l'interfaccia browser del Workspace, oppure clonando un progetto dal pannello Projects di Altium Designer.

Per creare un progetto Workspace direttamente tramite l'interfaccia browser del Workspace:

1. Accedi all'interfaccia e seleziona l'opzione di menu Projects per accedere alla pagina Designs . Tutti i progetti creati in precedenza saranno elencati qui.

2. Fai clic sul pulsante nella parte superiore della pagina e quindi sull'opzione di menu Create Project per aprire la finestra Create Project .

   Se sono disponibili definizioni di processo attive per il tema di processo Project Creations – definite nella scheda Project Creations della pagina Processes dell'interfaccia browser del Workspace – allora il menu del pulsante offrirà tali processi come opzioni al posto dell'opzione Create Project. Scegli la voce richiesta per avviare il flusso di lavoro di quel processo.

3. La finestra verrà inizialmente presentata in una vista semplificata. Inserisci il nome desiderato per il progetto, una descrizione (se necessaria) e scegli un Project Template adatto dal menu a discesa Templates.

   Il nome del progetto deve iniziare con, e può contenere, A-Z, a-z o 0-9. Sono consentiti underscore, trattini e spazi, ma questi ultimi possono essere usati solo all'interno del nome (gli spazi iniziali e finali verranno ignorati). Non è possibile utilizzare le seguenti parole: AUX, COM1-COM9, LPT1-LPT9, CON, NUL e PRN. Inoltre, il nome non può contenere i seguenti caratteri: \ . / ? % * : | " < >.
4. Per accedere a più controlli, fai clic sul pulsante . Verranno visualizzati i seguenti campi:
   1. Parent Folder – usa questo campo per specificare dove deve essere creata la cartella del progetto all'interno della struttura di cartelle del Workspace. Per impostazione predefinita, sarà Projects\<ProjectName>. Il percorso predefinito per i nuovi progetti è specificato nella pagina Admin – Settings – Projects dell'interfaccia browser del Workspace.

   2. Repository – questo campo elencherà tutti i repository di progettazione gestiti tramite il servizio locale di controllo di versione del Workspace e che sono stati condivisi con te per l'uso. Scegli il repository in cui archiviare il nuovo progetto e i relativi file. Per impostazione predefinita, sarà selezionato il repository Versioned Storage (basato su Git).

      Se hai eseguito l'aggiornamento a Enterprise Server da una tecnologia server precedente e hai ancora la possibilità di utilizzare repository di progettazione interni (SVN) e/o esterni (SVN/Git), verrà visualizzato il campo Repository . Questo elenca tutti i repository di progettazione gestiti tramite il servizio locale di controllo di versione del Workspace e che sono stati condivisi con te per l'uso. Scegli il repository in cui archiviare il nuovo progetto e i relativi file. Se viene scelto un repository basato su SVN, verrà visualizzato il campo Repository Folder. Usa questo campo per specificare il nome della cartella all'interno del repository in cui ospitare il progetto e i file associati. Per impostazione predefinita, verrà usato il nome del progetto.

Definizione di un nuovo progetto Workspace direttamente tramite l'interfaccia browser del Workspace.

Dopo aver definito il nuovo progetto come richiesto, fai clic su – il nuovo progetto verrà creato. Tornerai all'elenco dei progetti a livello di riepilogo, dove ora vedrai una voce per il progetto appena creato.Un ulteriore progetto Workspace, creato tramite l'interfaccia browser.

Esplorazione dei progetti Workspace

L'elenco dei progetti nella pagina Projects dell'interfaccia browser del Workspace include tutti i progetti condivisi con te e offre una gamma di controlli per accedere alle funzionalità di gestione del progetto. Usa il pulsante  per passare la pagina alla modalità di anteprima del progetto (riquadri grafici) e il pulsante per passare alla modalità elenco dettagliato.

La pagina Designs dell'interfaccia browser del Workspace – il centro di comando per lavorare con i tuoi progetti Workspace. Qui è mostrata la modalità elenco dettagliato della pagina. Passa il mouse sopra l'immagine per vedere la modalità di anteprima del progetto.

Le voci di progetto nella vista sono ordinate automaticamente per data di Last modified, con il progetto modificato più di recente che appare per primo nell'elenco. Fai clic sul pulsante per passare all'ordinamento per nome del progetto e fai nuovamente clic per alternare tra ordine crescente e decrescente.

La vista in modalità elenco () può essere ordinata per Name, Author o Date, utilizzando in ciascun caso l'intestazione della colonna. Fai clic una volta per ordinare in ordine crescente, fai nuovamente clic per ordinare in ordine decrescente. Le frecce a destra del nome della colonna indicheranno la direzione di ordinamento attualmente attiva.

La vista Projects fornisce dati Properties e Activities relativi al progetto selezionato, disponibili nel pannello laterale destro della vista.

Le informazioni nel pannello laterale includono: Properties scheda: Project – un riepilogo di alto livello dello stato del progetto, inclusa la vista 3D della scheda (quando per il progetto è disponibile un PCB). Shared With – gli utenti e/o i ruoli che hanno accesso al progetto. Passa il mouse su una voce per vedere il nome completo dell'utente/ruolo. Parameters – metadati dettagliati estratti o calcolati dal progetto stesso. Fai clic sul controllo Show More per espandere l'elenco completo. Releases – un elenco delle release del progetto in ordine cronologico. Fai clic su una voce per aprire quella release nel Manufacturing Portal del Workspace. Activity scheda – un elenco cronologico degli eventi del progetto, come un Commit, una Release o un flusso di lavoro di processo completato associato al progetto.

Per ciascun progetto, le seguenti operazioni sono disponibili anche tramite i pulsanti nella parte superiore della vista (e descritte in dettaglio nelle sezioni collegate che seguono):

• Condividi – controlli di accesso con cui configurare i permessi di accesso al progetto.
• Attività – accesso tramite menu alle attività di processo disponibili per il progetto.
• Funzioni – accesso tramite menu alle funzioni del progetto. Disponibili anche dal pulsante di un progetto selezionato quando si è in modalità Anteprima:
  • Apri – apre il progetto nella relativa vista dettagliata incentrata sul CAD. Equivale a fare clic (modalità Anteprima) o doppio clic (modalità Elenco) su una voce del nome progetto.
  • Sposta – sposta il progetto in un’altra cartella padre all’interno della struttura di cartelle del Workspace.
  • Modifica – modifica il progetto in termini di Name, Description e Workspace Parameters.
  • Clona – crea una copia identica del progetto con un nome diverso.
  • Segui/Non seguire più – consente di seguire/non seguire più l’attività di un progetto ricevendo le relative notifiche (aggiornato, rilasciato, ecc.) nella scheda Activitiy del progetto, e anche via email se le Notifiche email sono abilitate.
  • Elimina – rimuove la voce del progetto spostandone struttura e dati nel Workspace Trash, dove può essere eliminato definitivamente dal Workspace o ripristinato allo stato precedente.

È inclusa anche una funzione di Search del progetto che può filtrare l’elenco dei progetti in base a una serie di proprietà quali Nome, Autore, Descrizione, ecc. Digita qualsiasi parte di una stringa di ricerca nel campo nella parte superiore dell’interfaccia del browser. L’elenco verrà aggiornato per includere solo le voci di progetto i cui attributi contengono la stringa di ricerca.

Per cancellare il filtro di ricerca, fare clic sulla voce principale della pagina Projects nel riquadro di navigazione a sinistra, oppure svuotare il campo di ricerca e premere Enter.

Esempio di utilizzo della funzione di ricerca, in questo caso per trovare un progetto in base alla sua Descrizione.

Lavorare con le cartelle del Workspace

Il Workspace offre anche la possibilità di creare e gestire cartelle di progetto all’interno della propria struttura. I progetti possono quindi essere creati in qualsiasi cartella della gerarchia risultante oppure spostati al suo interno.

Per creare una nuova cartella sotto la cartella di livello superiore (predefinita) Project, scegliere l’opzione Create Folder dal menu del pulsante . Nella successiva finestra Create Folder, specificare il nome della nuova cartella, la relativa cartella padre e una descrizione facoltativa. Una nuova cartella viene sempre creata sotto la cartella attualmente selezionata, che diventa la sua cartella padre.

Aprire una cartella creata selezionandone il titolo e risalire nella gerarchia usando il percorso di navigazione sopra.

Usare le opzioni del menu per modificare i dettagli di una cartella (Edit), spostare la cartella sotto una cartella padre diversa (Move) oppure rimuovere la cartella dalla struttura di cartelle del Workspace (Delete). Quando si sposta una cartella, selezionare una nuova cartella padre dall’albero gerarchico nella finestra Move folder <folder> to.

Caricare un progetto

In Altium Designer, il comando Make Available on Server carica un progetto locale nel Workspace, dove diventa un progetto Workspace sotto il relativo controllo di versione. Un processo equivalente può essere eseguito all’interno dell’interfaccia browser del Workspace dall’opzione Upload Project disponibile nel menu del pulsante . Individuare e selezionare la cartella host di un progetto locale per caricare quel progetto, per impostazione predefinita, nella cartella Workspace attualmente selezionata, oppure usare l’opzione Change nell’elenco Parent Folder della finestra Upload Project per selezionare una posizione alternativa nella gerarchia di cartelle.

Qualsiasi collegamento esistente al controllo di versione nel progetto locale viene ignorato e il progetto caricato diventa un progetto Workspace completamente soggetto a controllo di versione – il progetto sorgente locale non viene modificato in alcun modo.

Spostare un progetto

Per spostare un progetto in una cartella Workspace diversa, selezionare l’opzione Move dalle opzioni del menu a discesa e selezionare una nuova posizione dalla gerarchia di cartelle nella finestra Move project <project> to. Una volta confermato con il pulsante , il progetto selezionato verrà quindi ospitato sotto la cartella padre appena specificata.

Condivisione di un progetto Workspace

Una volta che un progetto si trova nel Workspace, è opportuno determinare quali utenti possano effettivamente accedervi. Questo avviene condividendo il progetto o, più precisamente, configurandone i permessi di accesso. Un progetto Workspace è condiviso, per impostazione predefinita, con i seguenti soggetti:

• Il proprietario del progetto, che di solito è il progettista che lo ha creato (o lo ha reso disponibile nel Workspace): permessi di accesso completi (Lettura/Scrittura).
• Il gruppo di ruoli Administrators: permessi di accesso completi (Lettura/Scrittura).
• Tutti i membri del Workspace: con accesso in sola visualizzazione.

I permessi predefiniti per i nuovi progetti possono essere definiti/modificati nella pagina Admin – Settings – Projects dell’interfaccia browser del Workspace. Si noti che al proprietario del progetto viene intrinsecamente assegnato il permesso di accedervi e pertanto non è presente nell’elenco.

La configurazione dei permessi di accesso può essere eseguita tramite l’interfaccia browser del Workspace e anche direttamente da Altium Designer.

Per configurare l’accesso a un progetto dall’interfaccia browser del Workspace, selezionare la voce del progetto nella pagina Designs  (Projects nel menu principale) e fare clic sul pulsante per accedere alla finestra Share:<project> – oppure scegliere l’opzione Share dal menu associato a una voce di progetto. Questo offre tutti i controlli necessari per condividere il progetto con altri utenti o gruppi di utenti (Ruoli).

Con i progetti gestiti centralmente nel Workspace, la condivisione con altri consiste semplicemente nella gestione dei permessi di ciascun progetto.

All’interno della finestra Share <project>:

• Un utente/ruolo ha accesso Lettura/Scrittura quando l’opzione Can Edit è abilitata. Se questa opzione è disabilitata, dispone solo dell’accesso in lettura.
• Un progetto può essere condiviso con tutti i membri del Workspace con accesso in sola lettura (Can View) o lettura/scrittura (Can Edit) usando il menu a discesa della voce Workspace Members nell’area Shared With.
• Per rimuovere l’accesso condiviso a un progetto per un utente/ruolo esistente, fare clic sull’opzione Remove nel relativo menu a discesa.

Aspetti da tenere presenti:

• Per impostazione predefinita, tutti gli utenti del Workspace potranno vedere il progetto. Se si desidera limitare l’accesso a un insieme specifico di utenti e/o gruppi, è necessario prima selezionare No access nel menu a discesa della voce Workspace Members .
• Il proprietario di un progetto ha accesso permanente in Lettura/Scrittura.
• È anche possibile condividere un collegamento diretto al progetto. Il collegamento si ottiene facendo clic sul controllo Copy Link, nella parte inferiore della finestra Sharing. Il collegamento viene copiato negli appunti. Quando viene usato, fornisce all’utente interessato – ove consentito – l’accesso alla pagina di gestione dettagliata del progetto, una panoramica della quale è presentata nella sezione successiva.

Attività del progetto Workspace

Il Workspace offre la capacità unica di applicare Process Workflows configurabili ai progetti del Workspace per eseguire attività personalizzate come revisioni di progetto e creazione di nuovi progetti. I processi e i relativi Workflow sottostanti vengono creati e configurati da un amministratore del Workspace e, quando abilitati, diventano disponibili agli utenti sia di Altium Designer sia dell’interfaccia browser del Workspace.

► Vedi Creazione e gestione dei processi per maggiori informazioni.
► Vedi Esecuzione delle revisioni di progetto per informazioni su questi processi in Altium Designer.

Dal punto di vista dell’utente, i Process Workflow e i relativi passaggi intrinseci sono considerati come Activities. Le Attività disponibili possono essere avviate dagli utenti e i relativi passaggi del workflow possono essere completati dagli utenti assegnati come una sequenza di attività, disponibili tramite la pagina Tasks.

Seleziona il menu nella pagina Designs (Projects) e scegli tra i Processi disponibili per avviare un’attività per il progetto attualmente selezionato. Completa i campi e le opzioni richiesti nelle successive finestre del modulo di processo, quindi avvia il processo (). A seconda del Process Workflow richiamato, potrebbe essere necessario inviare un passaggio successivo () per preparare i dati alla revisione.

I Task del workflow vengono quindi creati per l’utente o gli utenti assegnati all’Attività. Un task che si applica a un utente connesso apparirà nella sua pagina Tasks, dove potrà essere eseguito per far avanzare il Workflow alla fase successiva.

Nota che quando un’Attività è stata assegnata a un Gruppo di ruoli – Engineers per esempio – un Task correlato diventa disponibile per tutti i membri di quel gruppo, e anche per tutti gli utenti individuali assegnati all’Attività – qui, l’utente Bruce (membro del ruolo Engineers). In tali casi, uno qualsiasi di questi utenti può completare il passaggio di revisione e inviare il risultato ().

Funzioni del progetto Workspace

Le operazioni funzionali associate ai progetti sono disponibili dal menu nella pagina Designs  e includono la possibilità di aprire, spostare, modificare, clonare, seguire e rimuovere un progetto Workspace. Il menu è disponibile anche dal pulsante di una voce di progetto selezionata:

Aprire un progetto

Seleziona l’opzione Open dal menu di una voce di progetto o dal menu superiore per aprire un progetto nella sua vista CAD incentrata sulla produzione, oppure quando sei in modalità Preview (), fai clic sul nome del progetto. La vista fornisce accesso a diverse sotto-viste disponibili dal riquadro di navigazione:

• Design – naviga e interagisci con i documenti di progetto, ispeziona le proprietà degli oggetti e inserisci commenti di revisione. La vista si applica alla revisione corrente (più recente) del progetto e utilizza l’interfaccia Web Viewer.
• Supply – esamina in modo interattivo i dati BOM work-in-progress (WIP) estratti dai documenti di progetto, incluse le voci per i dati dei componenti di produttori e fornitori derivati da un documento ActiveBOM popolato del progetto.
• Releases – visualizza informazioni riepilogative su tutte le Release del progetto corrente, ciascuna delle quali può essere aperta nella vista Manufacturing Portal . Questa a sua volta fornisce sotto-viste per i file del pacchetto di release, i documenti di progetto e i dati di approvvigionamento in quella release selezionata.
• Activities – visualizza le Attività del workflow di processo attive o chiuse che si applicano al progetto corrente.
• History – sfoglia una timeline progressiva dei principali eventi relativi al progetto, inclusi creazione, commit, release e cloni. Ogni volta che si verifica un evento supportato associato al progetto, tale evento viene aggiunto alla timeline come riquadro dedicato con varie azioni supportate, ove applicabile.

► Vedi Gestione di un progetto specifico per maggiori informazioni.

Modificare un progetto

Per modificare le proprietà di un progetto esistente nel Workspace, seleziona la sua voce nella pagina Designs (Projects) e quindi l’opzione Edit dal suo menu o dal menu superiore . Nella successiva finestra Project Editing puoi modificare Name del progetto, Description e gestire le voci Parameters del Workspace .

Fai clic sul pulsante nella finestra Project Editing per mostrare dati di proprietà aggiuntivi derivati dal progetto e memorizzati con esso. Seleziona il controllo Parameters per accedere e aggiungere (), modificare o rimuovere () coppie Nome/Valore dei parametri. Questi vengono salvati nel Workspace con il progetto e possono essere usati come Special Strings in Altium Designer – accessibili dal pannello Properties con un oggetto di testo posizionato selezionato nell’area di progettazione. Al contrario, i parametri di tipo Project vengono salvati nel file di progetto (*.PrjPcb) e possono essere modificati in Altium Designer.

Clonare un progetto

Per clonare (duplicare) un progetto Workspace esistente, seleziona la sua voce nella pagina Designs (Projects) e quindi l’opzione Clone dal suo menu o dal menu superiore . Usa la finestra Clone Project per impostare il nome e la descrizione del progetto clonato: per impostazione predefinita, verrà usato il nome del progetto originale con un suffisso - Copy.

Fai clic sul pulsante per mostrare campi di proprietà aggiuntivi, che includono la cartella padre di destinazione e le informazioni del Repository. L’impostazione della cartella di destinazione corrisponderà automaticamente al nome del progetto, a meno che non venga specificata manualmente o assegnata a una diversa cartella padre esistente tramite l’opzione Change.

Un progetto può essere clonato in Altium Designer dall’opzione Clone del menu  nel pannello Explorer, oppure facendo clic con il pulsante destro sul nome di un progetto nel pannello Projects e scegliendo l’opzione Clone dal menu contestuale.

Dopo aver impostato i campi come richiesto, fai clic sul pulsante per confermare. Il progetto originale verrà clonato (duplicato) insieme ai file e ai dati che lo compongono e verrà aggiunto come nuova voce di progetto all’elenco della pagina Projects.

Seguire un progetto

Per “seguire” – ricevere notifiche relative a – un progetto nel Workspace, seleziona la sua voce nella pagina Designs (Projects) e quindi l’opzione Watch dal suo menu o dal menu superiore .

Quando segui (watch) un progetto, riceverai notifiche relative al progetto (come messaggi di commit, release e modifica delle proprietà) nella scheda Activities nel riquadro destro dell’interfaccia. Il creatore del progetto verrà automaticamente impostato per seguire quel progetto. Quando abilitato, il comando cambierà in Unwatch – selezionalo per smettere di seguire il progetto e interrompere la ricezione di notifiche per gli eventi relativi a quel progetto.

Eliminare un progetto Workspace

Per eliminare (rimuovere) un progetto Workspace esistente, seleziona la sua voce nella pagina Designs (Projects) e quindi l’opzione Delete dal suo menu o dal menu superiore . L’azione è di fatto una “eliminazione soft”, in cui il repository del progetto viene spostato nell’area Trash del Workspace. Un progetto può essere eliminato in Altium Designer usando l’opzione Delete del menu  nel pannello Explorer.

Da quella vista (seleziona Trash dal menu principale), la voce del progetto può essere rimossa completamente (Permanently Delete) oppure l’azione può essere annullata (Restore). Tieni presente che il pulsante rimuoverà tutte le voci (ove possibile) archiviate nel Cestino del Workspace.