Releasing to a Workspace

Con la vista Release in Online Mode, il processo di rilascio è un flusso a fasi, con le voci sul lato sinistro della vista che mostrano a colpo d'occhio in quale fase ti trovi attualmente:

  1. Configure Server Release – questa fase del processo di rilascio è quella in cui specifichi il/i tipo/i di dati che desideri generare: Dati sorgente (sempre generati), Dati di fabbricazione, Dati di assemblaggio (per il progetto base e per ogni variante rilevata).

  2. Validate Project – questa fase successiva del processo di rilascio viene eseguita automaticamente quando viene rilevato uno o più report di tipo Validation nei file OutJob assegnati. Vengono eseguiti tutti i generatori di output di validazione definiti in un file Output Job assegnato all'elemento dati in fase di rilascio.

  3. Generate Data – questa fase successiva del processo di rilascio viene eseguita automaticamente. Qui vengono eseguiti tutti gli altri output – definiti nei file OutJob assegnati agli elementi dati inclusi – per generare i dati da rilasciare nei relativi elementi di destinazione nel Workspace.

  4. Review Data – con tutti i controlli di validazione superati e i dati di output generati, questa fase del processo di rilascio ti consente di esaminare i dati generati.

    Se scegli di usare i comandi Prepare & Release o Prepare & Release & Publish to PLM (dal menu associato al pulsante ), il Project Releaser non si fermerà alla fase Review Data.

  5. Upload Data – dopo aver confermato il rilascio nella fase precedente, questa fase successiva viene avviata automaticamente. Mostra semplicemente l'avanzamento del caricamento dei dati nelle revisioni dei relativi elementi dati nel Workspace di destinazione.

  6. Execution Report – questa è la fase finale del processo e fornisce un riepilogo del rilascio. Sono disponibili collegamenti di navigazione per passare rapidamente alle revisioni degli elementi generate nel pannello Explorer panel. Se hai aperto il Project Releaser come parte di un processo di rilascio e pubblicazione verso un PLM, verrà visualizzato il pulsante . Fai clic su questo pulsante per continuare il flusso di lavoro sottostante del processo e pubblicare nel PLM.

    Se scegli di usare il comando Prepare & Release & Publish to PLM (dal menu associato al pulsante ), il Project Releaser non si fermerà alla fase Execution Report e non verrà visualizzato alcun pulsante .
  7. Publish to PLM – questa fase è presente solo quando il rilascio viene eseguito nell'ambito del relativo processo attivato (per il rilascio e la successiva pubblicazione verso un PLM). Questa fase viene avviata automaticamente quando si fa clic sul pulsante nella fase precedente (oppure viene aperta direttamente se è stato usato il comando Prepare & Release & Publish to PLM (dal menu associato al pulsante )). Verrà visualizzata la finestra di dialogo Login Credentials. Inserisci Username e Password per la tua istanza PLM e seleziona il modello PLM che desideri usare (che appare nel formato <PLMInstance>:<PublishingTemplate>).

    Tieni presente che le credenziali di accesso alla tua istanza PLM sono richieste solo la prima volta che pubblichi su tale istanza. Verranno quindi memorizzate nel Workspace. Successivamente, qualsiasi pubblicazione di quel progetto sulla stessa istanza PLM procederà direttamente, in conformità con il flusso di lavoro definito e il modello di pubblicazione scelto.
    Se stai pubblicando per la prima volta e i codici articolo (lato PLM) non sono ancora associati al progetto del Workspace, tali codici articolo verranno creati nel PLM e associati al progetto come parte di quella pubblicazione iniziale. Hai anche la possibilità di definire voci di componente per i componenti del Workspace nell'istanza PLM come parte dell'operazione di pubblicazione, in modo da ottenere una BOM dei componenti all'interno del PLM (opzionale, in base al modello di pubblicazione definito e usato durante la pubblicazione del progetto nell'istanza PLM).

Fase online 1 – Configura il rilascio sul server

Questa fase del processo di rilascio è quella in cui specifichi il/i tipo/i di dati che desideri generare. Gli elementi dati che possono essere rilasciati sono:

  • Source Data – un'istantanea del progetto sorgente.
  • Fabrication Data – i dati richiesti da una casa di fabbricazione per creare la scheda nuda.
  • Assembly Data for the Base Design (no variations) – i dati richiesti da una casa di assemblaggio per popolare completamente la scheda nuda in conformità con una distinta base, e per il progetto base senza varianti.
  • Assembly Data for Design Variant n – i dati richiesti da una casa di assemblaggio per popolare la scheda nuda in conformità con una distinta base, e per Variant n del progetto base.

Il numero di set di dati di assemblaggio corrisponderà al progetto base (senza varianti) e a tutte le varianti rilevate definite per quel progetto.

Inoltre, puoi aggiungere e configurare sezioni Custom Data, che ti consentono di creare un set personalizzato di dati di rilascio. Questo serve soprattutto per la compatibilità con versioni precedenti o per flussi di dati personalizzati. Non vengono creati riferimenti, ad eccezione dei dati sorgente. È possibile aggiungere e configurare un numero qualsiasi di set di dati personalizzati come parte del rilascio (fai clic sul controllo Add Section sotto l'elenco degli elementi dati attualmente definiti).

Fase 1 del processo di rilascio del progetto – configurazione di ciò che deve essere incluso nel rilascio (quali dati generare).
Fase 1 del processo di rilascio del progetto – configurazione di ciò che deve essere incluso nel rilascio (quali dati generare).

L'elemento Source Data è sempre incluso in un rilascio. Gli altri elementi dati possono essere inclusi facoltativamente.

Una volta configurati come richiesto gli item di dati da creare come parte del rilascio, fai clic sul pulsante in basso a destra nella vista per procedere.

Il pulsante ha due stati. Facendo clic su di esso verrà avviato il comando standard Prepare. Questo procederà con il rilascio fino alla fase Review Data, consentendoti essenzialmente di ricontrollare che tutto sia in ordine prima di confermare il rilascio dei dati. Se non vuoi fermarti per la revisione, usa il menu a discesa associato al pulsante e scegli il comando Prepare & Release.

Come parte della preparazione vengono eseguiti diversi controlli pre-rilascio, tra cui:

  • Assicurarsi che il progetto e tutti i file siano stati salvati.
  • Assicurarsi che il progetto e tutti i file pertinenti siano stati sottoposti a commit nel VCS, se applicabile.
  • Assicurarsi che a ciascun item di dati abilitato sia stato assegnato un nome.
  • Verificare che l'utente disponga dei diritti per creare l'item di destinazione (e la revisione).
  • Creare nel Workspace gli Item di destinazione richiesti (e le revisioni pianificate), dove attualmente non esistono, e assicurarsi che venga utilizzata la revisione successiva per quegli item che invece esistono già.

Se vengono rilevati problemi, ti verranno proposte soluzioni per risolverli (come il salvataggio locale dei file modificati e il commit nel VCS).

Se nel progetto da rilasciare vengono trovati documenti esterni (documenti associati al progetto ma archiviati in una cartella diversa dalla cartella del progetto o da una sua sottocartella), si aprirà la finestra di dialogo External files, con un elenco di documenti esterni (). Per evitare potenziali problemi, si consiglia di archiviare tutti i documenti associati al progetto nella cartella del progetto o in una sua sottocartella.

L'Item Source Data viene generato in questo momento, con uno snapshot dei file del progetto di progettazione sorgente rilasciato nella revisione dell'item di destinazione.

Fase online 2 – Convalida progetto

Dopo che la Fase 1 è stata completata senza problemi, questa fase successiva del processo di rilascio viene eseguita automaticamente quando viene rilevato uno o più report di tipo Validation nei file OutJob assegnati. Vengono eseguiti tutti i generatori di output di convalida definiti in un file Output Job assegnato all'item di dati in fase di rilascio. Ciò include l'esecuzione di uno qualsiasi dei seguenti:

  • Differences Report – uso del comparatore per determinare se i documenti di progettazione sorgente e PCB sono correttamente sincronizzati.
  • Electrical Rules Check – verifica della validità elettrica/grafica del progetto sorgente acquisito.
  • Design Rules Check – verifica della validità del documento PCB rispetto ai vincoli di progettazione a livello di scheda specificati.
  • BOM Checks – verifica di possibili violazioni associate ai Design Item o alle Part Choices nel documento BOM sorgente (*.BomDoc), ove disponibile. – confronto delle footprint sulla scheda con la relativa libreria sorgente per assicurarsi che siano aggiornate e corrispondenti.
  • Component State Checking – verifica della presenza di componenti che si trovano in stati con restrizioni. Come parte della configurazione, determini l'azione da intraprendere per ciascuno stato attualmente definito, di ciascuna Lifecycle Definition attualmente definita nel Workspace di destinazione: nessuna azione, un avviso oppure generare un errore. Quest'ultima opzione impedirà il rilascio del progetto. Inoltre, l'esecuzione del controllo genererà un pratico report basato su HTML, che ti consentirà di vedere a colpo d'occhio quali componenti del progetto non si trovano in stati validi.
  • Environment Configuration Compliance Check – verifica che vengano utilizzati solo item di dati consentiti tramite la configurazione dell'ambiente disponibile per l'uso dal ruolo a te assegnato (se applicabile). Questo controllo può anche garantire che tutti i design item provengano da un Workspace.

Se la convalida ha esito positivo, viene visualizzata l'icona , con il testo Passed. In caso contrario, verrà visualizzata l'icona , con il testo Failed.

Il rilascio non andrà a buon fine se uno qualsiasi dei controlli di convalida non viene superato correttamente.
Facendo clic su in basso a destra nella vista, il processo di rilascio verrà interrotto.

Fase online 3 – Genera dati

Dopo che la Fase 2 è stata completata senza problemi, questa fase successiva del processo di rilascio viene eseguita automaticamente. È qui che vengono eseguiti tutti gli altri output, definiti nei file OutJob assegnati ai Data Item inclusi, per generare i dati da rilasciare nei relativi item di destinazione nel Workspace.

Come per le altre fasi, ma in modo più evidente in questa fase, poiché richiede più tempo per essere eseguita, vengono utilizzate icone per mostrare l'avanzamento della generazione:

– non ancora eseguito/generato.

– in esecuzione/generazione.

– generato correttamente.

– generazione non riuscita.

Facendo clic su in basso a destra nella vista, il processo di rilascio verrà interrotto.

Fase online 4 – Rivedi dati

Con tutti i controlli di validazione superati e i dati di output generati, questa fase del processo di rilascio consente di esaminare i dati generati.

Se si sceglie di usare il comando Prepare & Release (dal menu associato al pulsante ), il Project Releaser non si fermerà alla fase Review Data.

Esaminare i dati generati, verificando che tutto sia corretto, prima di confermare il rilascio e caricare i dati nel Workspace.
Esaminare i dati generati, verificando che tutto sia corretto, prima di confermare il rilascio e caricare i dati nel Workspace.

Per impostazione predefinita, la pagina presenta una vista semplice (compatta) dei dati generati. Passare a una vista più dettagliata facendo clic sul controllo Details associato a una sezione di interesse.

Fare clic su un controllo Details per passare dalla vista semplice a quella dettagliata dei dati generati per la sezione associata. Per tornare indietro, fare nuovamente clic sul controllo Hide Details.
Fare clic su un controllo Details per passare dalla vista semplice a quella dettagliata dei dati generati per la sezione associata. Per tornare indietro, fare nuovamente clic sul controllo Hide Details.

Nella vista compatta dei dati generati, fare clic su un collegamento View per aprire il file di dati o il set di file associato, sia nell'editor pertinente all'interno di Altium Designer (ad esempio, l'editor CAM per file Gerber o file ODB++ compressi/non compressi) sia nell'applicazione esterna pertinente (ad esempio, Microsoft Excel per una distinta base). Nella vista dettagliata, fare doppio clic su una voce per visualizzare solo quel file.

Un comune test di verifica della prontezza al rilascio utilizzato da molti progettisti consiste nel confrontare i file Gerber generati dalla release corrente con i file Gerber della release precedente. Fare clic sul collegamento Compare Gerber accanto a un output Gerber e selezionare una release precedente dal menu a discesa per confrontare i dati Gerber preparati con quelli della release scelta. Il browser predefinito aprirà il Company Workspace e visualizzerà i risultati.

Accesso alla funzione di confronto Gerber dal Project Releaser, prima di rilasciare i dati in un Workspace.
Accesso alla funzione di confronto Gerber dal Project Releaser, prima di rilasciare i dati in un Workspace.

► Ulteriori informazioni sulla funzione Gerber Comparison (Altium 365 Workspace, Enterprise Server Workspace).

Nella sezione Source Data, in vista compatta, facendo clic sul collegamento View si aprirà Esplora file di Windows nella cartella temporanea in cui è stata salvata l'istantanea dei file sorgente del progetto. Questa funzionalità è disponibile anche tramite il collegamento Explore, a destra dell'intestazione della sezione. In effetti, ogni sezione dispone di tale controllo, per passare rapidamente alla sottocartella relativa a quei dati all'interno della cartella temporanea.

Nella vista dettagliata, i comandi del menu contestuale accessibile con il tasto destro consentono di aprire un documento ed esplorare il percorso in cui è stato generato (nella cartella temporanea). È inoltre possibile aggiungere colonne dati per il percorso della cartella e la data di creazione: fare clic con il tasto destro nell'area dell'intestazione di una griglia e scegliere il comando Select Columns, che consente di accedere a una finestra di dialogo con cui personalizzare i dati visualizzati.

Se, dopo aver esaminato i dati, si ritiene necessario apportare modifiche, fare clic sul pulsante in basso a destra nella vista. Verrà visualizzata una finestra di dialogo di conferma che avviserà del fatto che tutti i dati generati andranno persi: facendo clic su OK il rilascio verrà annullato e si tornerà alla Fase 1 del processo.

Il sistema impedisce naturalmente qualsiasi modifica ai file di progetto tra la preparazione del rilascio e il rilascio dei dati nel Workspace. Se si modificano in qualsiasi modo i file di progetto, il processo di rilascio verrà terminato e si tornerà alla fase iniziale, prima della preparazione del rilascio.

Se i dati generati appaiono tutti corretti, procedere con il rilascio facendo clic sul pulsante (anch'esso in basso a destra nella vista). Verrà visualizzata la finestra di dialogo Confirm Release, che riepiloga le configurazioni del progetto che verranno rilasciate nel Workspace. Qui si ha anche la possibilità di aggiungere un Name (per impostazione predefinita, la voce qui è [ProjectName]), Description e aggiungere eventuali note di rilascio pertinenti.

Conferma di ciò che verrà rilasciato, in termini di revisioni degli elementi generate, e possibilità di modificare Nome/Descrizione e aggiungere note di rilascio.
Conferma di ciò che verrà rilasciato, in termini di revisioni degli elementi generate, e possibilità di modificare Nome/Descrizione e aggiungere note di rilascio.

Fase online 5 – Caricamento dati

Dopo aver confermato il rilascio nella fase precedente, si accede automaticamente a questa fase successiva. Essa mostra semplicemente l'avanzamento del caricamento dei dati nelle revisioni dei relativi elementi dati nel Workspace.

Questa fase riflette semplicemente l'avanzamento del caricamento dei dati generati nelle revisioni degli elementi collegate nel Workspace.
Questa fase riflette semplicemente l'avanzamento del caricamento dei dati generati nelle revisioni degli elementi collegate nel Workspace.

Fase online 6 – Report di esecuzione

Questa è la fase finale del processo e fornisce un riepilogo del rilascio.

Il report finale del rilascio.
Il report finale del rilascio.

Utilizzare i collegamenti di navigazione per accedere rapidamente alla revisione dell'elemento associato, contenente i dati rilasciati (dati di fabbricazione, dati di assemblaggio ed eventuali set di dati personalizzati), nel pannello Explorer, il portale verso il Workspace.

Visualizzazione dei dati rilasciati per il progetto, direttamente nel Workspace, tramite il pannello Explorer.
Visualizzazione dei dati rilasciati per il progetto, direttamente nel Workspace, tramite il pannello Explorer.

I parametri definiti per le varianti del progetto sono inclusi nelle revisioni corrispondenti dei set di dati di assemblaggio. Quando si visualizza il progetto nel Explorer del pannello Classic View, selezionare la revisione richiesta del set di dati di assemblaggio e passare alla scheda della vista aspetto Parameters per vedere i parametri della variante.

Un parametro di variante VariantLabel = A è stato aggiunto alla variante di progetto Default. Il set di dati di assemblaggio rilasciato include questo parametro e può essere trovato nella scheda della vista aspetto Parameters nel pannello Explorer.
Un parametro di variante VariantLabel = A è stato aggiunto alla variante di progetto Default. Il set di dati di assemblaggio rilasciato include questo parametro e può essere trovato nella scheda della vista aspetto Parameters nel pannello Explorer.

Questo è tutto: una volta rilasciato il progetto, è possibile semplicemente chiudere la vista Release (usando il pulsante in basso a destra nella vista). E quando in futuro sarà necessario rilasciare nuovamente lo stesso progetto, il Project Releaser lo renderà rapido e semplice, incrementando automaticamente le revisioni degli elementi di destinazione.

Ogni volta che si esegue una release del progetto, verrà aggiunto un riquadro evento Project Released alla timeline della vista History del progetto. La persona che ha eseguito il rilascio viene mostrata per nome (e immagine), insieme a data e ora. Se al momento del rilascio dei dati generati nel Workspace è stata aggiunta una nota di rilascio, tramite la finestra di dialogo Confirm Release dialog, anche questa verrà visualizzata all'interno del riquadro. Verranno inoltre elencati tutti i set di dati inclusi nella release.

Si noti che se l’ultimo commit del progetto non ha ancora un tag, verrà assegnato automaticamente un tag a questo ultimo commit. Questo tag avrà la forma di RELEASE_<RevisionID>, dove <RevisionID> è il numero di revisione dei sorgenti del progetto rilasciati (A.1A.2, ecc.), ad esempio, RELEASE_A.3.

Riquadro evento di esempio Project Released nella vista History del progetto. Poiché l’ultimo commit del progetto non aveva alcun tag, è stato taggato dopo il rilascio.
Riquadro evento di esempio Project Released nella vista History del progetto. Poiché l’ultimo commit del progetto non aveva alcun tag, è stato taggato dopo il rilascio.

Scopri di più su Project History.

Pubblicazione in un’istanza PLM

Related pages: Integrazione PLM (Altium 365 Workspace, Enterprise Server Workspace), Pubblicazione in un PLM

Hai la possibilità di pubblicare un progetto di progettazione in un’istanza PLM come parte dell’esecuzione di Project Releaser in Altium Designer. L’operazione di pubblicazione utilizza un modello di pubblicazione, definito come parte della configurazione di integrazione di quell’istanza PLM, per controllare come i dati devono essere propagati al PLM. Questa funzionalità è disponibile tramite un processo opportunamente configurato. Come parte dell’installazione viene fornita una definizione di processo di esempio – Project Releaser with Publish – il cui workflow sottostante consente la pubblicazione nell’istanza PLM integrata come fase aggiuntiva di Project Releaser. Il diagramma del workflow è mostrato di seguito.

Questa definizione di processo non può essere attivata e utilizzata così com’è. È quindi più simile a un “modello”: modificala in base ai requisiti della tua azienda, assegnale un nome e salvala come nuova definizione di processo, che can potrai quindi attivare e utilizzare.

Il diagramma del workflow della definizione di processo di esempio predefinita Project Releaser with Publish
Il diagramma del workflow della definizione di processo di esempio predefinita Project Releaser with Publish

Una volta attivato, il processo per la pubblicazione in un’istanza PLM come parte di Project Releaser è accessibile in Altium Designer dal sottomenu Project » Project Releaser per il progetto attivo oppure dal sottomenu contestuale Project Releaser, accessibile facendo clic con il pulsante destro del mouse sulla voce del progetto di progettazione nel pannello Projects.

Accesso al processo per la pubblicazione in un’istanza PLM come parte di Project Releaser
Accesso al processo per la pubblicazione in un’istanza PLM come parte di Project Releaser

Verrà visualizzato Project Releaser, con una fase aggiuntiva – 7. Publish to PLM. Inoltre, è disponibile un comando dal menu associato al pulsante Prepare & Release & Publish to PLM – nel caso in cui si desideri eseguire Project Releaser senza fermarsi a esaminare i dati generati e il report di esecuzione.

Un comando aggiuntivo per eseguire Project Releaser senza fermarsi a esaminare i dati generati e il report di esecuzione
Un comando aggiuntivo per eseguire Project Releaser senza fermarsi a esaminare i dati generati e il report di esecuzione

Se esegui Project Releaser con il comando standard Prepare, dopo aver esaminato e rilasciato i dati, il pulsante verrà presentato nella fase Execution Report. Fai clic su questo pulsante per continuare il workflow sottostante del processo e pubblicare nel PLM. Verrà visualizzata la finestra di dialogo Login Credentials. Inserisci Username e Password per la tua istanza PLM e seleziona il modello PLM che desideri utilizzare (che appare nel formato <PLMInstance>:<PublishingTemplate>).

Se scegli di utilizzare il comando Prepare & Release & Publish to PLM, alla fine ti verrà presentata direttamente la finestra di dialogo Login Credentials. Project Releaser non si fermerà nella fase Execution Report e non verrà presentato alcun pulsante .
Si noti che le credenziali di accesso alla tua istanza PLM sono richieste solo la prima volta che pubblichi in tale istanza. Verranno quindi memorizzate nel Workspace. Successivamente, qualsiasi pubblicazione di quel progetto nella stessa istanza PLM procederà direttamente, in conformità con il workflow definito e il modello di pubblicazione scelto.

La finestra di dialogo Login Credentials aperta durante la prima pubblicazione nell’istanza PLM.
La finestra di dialogo Login Credentials aperta durante la prima pubblicazione nell’istanza PLM.

Fai clic sulla scheda Diagram per vedere il workflow sottostante del processo.

La scheda Diagram della finestra di dialogo Login Credentials
La scheda Diagram della finestra di dialogo Login Credentials

Fai clic sul pulsante per procedere con il processo di pubblicazione, in conformità con tale workflow.

Se stai pubblicando per la prima volta e i codici articolo (lato PLM) non sono ancora associati al progetto Workspace, tali codici articolo verranno creati nel PLM e associati al progetto come parte di quella pubblicazione iniziale. Hai anche la possibilità di definire voci di componente per i componenti del Workspace nell’istanza PLM come parte dell’operazione di pubblicazione, in modo da ottenere una BOM dei componenti all’interno del PLM (opzionale, in base al modello di pubblicazione definito e utilizzato durante la pubblicazione del progetto nell’istanza PLM).
Controlla lo stato del processo di pubblicazione nel PLM tramite l’interfaccia browser del Workspace, dalla vista Activities nella pagina di gestione dettagliata del progetto. La pagina di gestione dettagliata del progetto si apre selezionando il progetto richiesto nella pagina Projects dell’interfaccia browser del Workspace, facendo clic sul controllo sopra l’elenco dei progetti e scegliendo la voce Open nel menu associato. In alternativa, fai doppio clic direttamente sulla voce del progetto richiesta nell’elenco. La pagina si aprirà in una nuova scheda del browser. Sarà sempre possibile vedere esattamente che cosa è stato creato, ad esempio i codici articolo nell’istanza PLM, come parte della cronologia del workflow del processo (scheda History).
AI-LocalizedLocalizzato tramite A
Se trovi un problema, seleziona il testo/l’immagine e premi Ctrl + Invio per inviarci il tuo feedback.
Disponibilità delle funzionalità

Le funzionalità disponibili dipendono dalla soluzione Altium in uso – Altium Develop, un’edizione di Altium Agile (Agile Teams o Agile Enterprise), oppure Altium Designer (con licenza attiva).

Se non vedi nel tuo software una funzionalità descritta,  contatta il team vendite di Altium per saperne di più.

Documentazione legacy

La documentazione di Altium Designer non è più suddivisa per versione. Se è necessario accedere alla documentazione delle versioni precedenti di Altium Designer, visitare la sezione Documentazione legacy della pagina Altri programmi di installazione.

Contenuto