Commenti sui documenti

Altium Training

Altium Essentials: Design Review and Commenting

This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.

Quando sono integrati con un Workspace connesso, i progetti di Altium Designer consentono a un team di progettazione distribuito di collaborare su progetti archiviati e gestiti centralmente. L'interfaccia di progettazione supporta l'aggiunta di commenti a vari documenti di progettazione per migliorare il processo di collaborazione. I commenti, ovvero note aggiunte dagli utenti, possono essere inseriti nei documenti e ricevere risposte da altri utenti.

Il pannello Comments and Tasks
Il pannello Comments and Tasks

I commenti inseriti sono disponibili in tempo reale per gli utenti che collaborano (quelli che hanno accesso condiviso al documento) e vengono salvati sul server indipendentemente dal progetto, senza modificare in alcun modo i documenti che lo compongono. La funzione di commento è gestita tramite il pannello Comments and Tasks. Quando si seleziona una voce di commento nel pannello Comments and Tasks, il sistema apre (e carica, se necessario) il documento di progettazione associato.

Il pannello Comments and Tasks consente di aggiungere commenti a un'area definita o a un punto del documento attivo di un progetto del Workspace e di assegnarli ai membri del Workspace, creando di fatto delle attività per loro. Il pannello consente a tutti gli utenti che lavorano sul documento di aggiungere commenti e visualizzare tutti quelli presenti senza modificare il documento stesso. Questa funzione facilita processi di collaborazione efficaci ed è preziosa quando occorre segnalare problemi all'interno del documento senza unire fisicamente le modifiche e generare conflitti. Il pannello Comments and Tasks può essere utilizzato essenzialmente per creare un elenco di cose da fare e, man mano che il progetto si sviluppa, i commenti possono essere risolti e chiusi. I commenti inseriti sono disponibili in tempo reale per gli utenti che collaborano, ossia quelli che hanno accesso condiviso al documento, e vengono salvati nel Workspace indipendentemente dal progetto, senza modificare in alcun modo i documenti che lo compongono.

Se non disponi dell'accesso alla funzionalità di creazione e gestione delle attività, questa non sarà disponibile e il pannello sarà denominato Comments.

Per informazioni sui progetti dal punto di vista del Workspace, consulta Workspace Projects (Workspace Altium 365, Workspace Enterprise Server).

Nota che i commenti e le attività possono essere aggiunti e gestiti sia in Altium Designer sia nel relativo Workspace, tramite la vista di progettazione dell'interfaccia browser. Le funzionalità dei due sistemi di commento sono sostanzialmente identiche e, poiché sia il progetto sia i dati dei commenti sono archiviati nel Workspace, i sistemi interagiscono in tempo reale.

Consulta Commenting in the Web Viewer (Workspace Altium 365, Workspace Enterprise Server) per informazioni dettagliate sul sistema di commento nell'interfaccia browser di un Workspace.

Dove è supportata l'aggiunta di commenti

Schema elettrico

È possibile applicare un commento a un oggetto, a un punto specifico o a un'area di un documento schematico.

PCB

È possibile applicare un commento a un oggetto, a un punto specifico o a un'area di un documento PCB (in modalità layout 2D) – .

Nota che, quando si seleziona un commento in un documento PCB, viene attivata automaticamente la stessa vista utilizzata dal revisore (layer visibili, layer attivo, vista superiore/inferiore). Di seguito è mostrato un esempio di cambio della configurazione della vista quando si seleziona un commento.

Javascript ID: PCB_Support1

La configurazione della vista prima di selezionare un commento: tutti i layer di segnale sono abilitati, Bottom è il layer attivo e la scheda è mostrata dal lato inferiore.

La scheda dopo aver selezionato un commento (viene applicata la stessa vista utilizzata al momento dell'aggiunta del commento): Top è l'unico layer di segnale abilitato, Top è il layer attivo e la scheda è mostrata dal lato superiore.

Draftsman

È possibile applicare un commento a un punto specifico o a un'area di un documento Draftsman di un progetto PCB, multi-scheda o di cablaggio – .

Schema multi-scheda

I commenti nei documenti schematici multi-scheda sono disponibili quando l'opzione MBS.Comments è abilitata nella finestra di dialogo Impostazioni avanzate.

È possibile applicare un commento a un oggetto o a un punto specifico di un documento schematico multi-scheda – .

Assieme multi-scheda

I commenti nei documenti di assieme multi-scheda sono disponibili quando l'opzione MBA.Comments è abilitata nella finestra di dialogo Impostazioni avanzate.

È possibile applicare un commento a un punto specifico del documento di assieme multi-scheda – .

Schema di cablaggio e disegno di layout

I commenti nei documenti di schema di cablaggio e disegno di layout sono disponibili quando l'opzione Harness.Comments è abilitata nella finestra di dialogo Impostazioni avanzate.

È possibile applicare un commento a un oggetto, a un punto specifico o a un'area di un documento di schema di cablaggio o disegno di layout di un progetto di cablaggio. 

ActiveBOM

I commenti nei documenti ActiveBOM sono disponibili quando l'opzione BOM.Comments è abilitata nella finestra di dialogo Impostazioni avanzate.

È possibile applicare un commento a una riga di un documento ActiveBOM – .

Accesso al pannello Commenti e attività

È possibile accedere al pannello da un progetto del Workspace nei seguenti modi:

  • Fai clic sul pulsante Panels in basso a destra nell'area di progettazione, quindi seleziona Comments and Tasks.

    L'icona del Workspace accanto al nome di un pannello nel menu in basso a destra nell'area di progettazione indica che è necessaria una connessione a un Workspace per visualizzare i dati del pannello associato. Un'icona blu () indica che al momento è attiva una connessione a un Workspace. Un'icona grigia () indica che al momento non è attiva alcuna connessione a un Workspace e ti verrà richiesto di connetterti a un Workspace prima di poter accedere ai dati del pannello.

  • Seleziona il comando View » Panels » Comments and Tasks dai menu principali.

  • Fai doppio clic sul contrassegno di un commento inserito nell'area di progettazione.

Per accedere al pannello Comments and Tasks, il documento attivo deve essere un documento schematico, PCB, ActiveBOM, schematico multi-scheda o Draftsman di un progetto del Workspace aperto. Saranno disponibili per la selezione solo i progetti attualmente condivisi con te.

Aggiunta di un commento quando non si è connessi a un Workspace

Prima di utilizzare la funzione di commento, assicurati di essere connesso al tuo Workspace e di aver aperto un progetto e un documento di un tipo che supporti i commenti (inclusi schema elettrico, PCB 2D, Draftsman e ActiveBOM). Utilizza il comando File » Open Project per scegliere un progetto del Workspace tra quelli condivisi con te. Il pannello Comments and Tasks fornirà indicazioni su questi prerequisiti.

Se usufruisci dei vantaggi del tuo abbonamento ma non hai ancora creato un Workspace Altium 365 per la tua azienda, puoi provare le funzioni di commento in modalità demo. Dopo aver effettuato l'accesso al tuo account Altium da Altium Designer e mentre lavori con un progetto locale, puoi inserire fino a tre commenti. Per utilizzare tutte le funzionalità di commento e salvare i commenti inseriti, il progetto deve essere reso disponibile nel Workspace: un apposito controllo sarà disponibile nel riquadro del messaggio sotto la finestra di dialogo a comparsa dei commenti nell'area di progettazione.

Prova la funzione di commento in modalità demo se non hai ancora attivato un Workspace Altium 365.
Prova la funzione di commento in modalità demo se non hai ancora attivato un Workspace Altium 365.

Opzioni del pannello Comments and Tasks

Utilizza i pulsanti nella parte superiore del pannello Comments and Tasks per impostare la disponibilità dei commenti nel pannello e nell'area dell'editor e per specificare se inviare notifiche agli utenti menzionati.

Il pulsante  del pannello attiva o disattiva la visibilità degli indicatori dei commenti sul documento. Le voci dei commenti nell'elenco del pannello Comments and Tasks possono comunque essere selezionate come di consueto.

Utilizza il menu a discesa dei filtri nel pannello () per configurare il filtraggio dei commenti e il relativo pulsante  per passare dalla vista filtrata a quella non filtrata e viceversa.

  • TYPE - abilita il tipo da visualizzare. Per impostazione predefinita, sono tutti abilitati.

  • SCOPE - abilita Current document per visualizzare solo i commenti relativi al documento corrente.

  • ASSIGNEE - tutte le opzioni sono disabilitate per impostazione predefinita. Di conseguenza, tutte le attività e tutti i commenti vengono mostrati e ordinati per nome (la prima voce nell'elenco è l'utente corrente). Quando si selezionano le caselle di controllo di uno o più utenti, vengono visualizzate le voci relative agli utenti selezionati. 

  • Clear Filters - consente di ripristinare rapidamente le impostazioni predefinite del filtro.

Utilizza le opzioni del menu del pulsante  per configurare la visibilità dei commenti e le notifiche:

  • Unresolved Only – i commenti risolti non vengono inclusi nell'elenco.

  • Notification settings – fai clic per aprire la finestra di dialogo Notification Settings e configurare la ricezione delle notifiche e-mail per tutte le attività relative ai commenti in questo progetto (All), solo per i commenti in cui sei menzionato o a cui sei assegnato (My), oppure per non ricevere alcuna notifica e-mail (None). ► Esempio del contenuto di un'e-mail.

  • Export Comments – fai clic per aprire la finestra di dialogo Comment Export Configuration e configurare l'esportazione dei commenti in un file PDF.

Il PDF generato includerà informazioni sui commenti nel progetto: ID del commento, autore, data e ora di creazione, testo del commento, assegnatario (per le attività) e stato (per un commento, se è Resolved; per un'attività, lo stato To Do / In Progress / Resolved). Puoi scegliere di esportare tutti i commenti associati al progetto, indipendentemente da quando sono stati creati, oppure solo quelli creati tra specifici rilasci del progetto. Sono inoltre disponibili alcune opzioni per definire quali istantanee includere nel documento PDF generato. Insieme, queste forniscono informazioni sulla posizione di un commento e sull'elemento a cui si riferisce (punto, componente, area). Se lasci entrambe le opzioni deselezionate, otterrai soltanto i commenti. Una volta completata la configurazione, fai clic su Export per generare il PDF, utilizzando la finestra di dialogo successiva per stabilire dove salvarlo e con quale nome (per impostazione predefinita, quello del progetto).

L'esportazione dei commenti in PDF può essere configurata ed eseguita anche tramite un file Output Job durante il rilascio del progetto. Aggiungi un generatore di output Export Comments alla categoria Report Outputs.

Tieni presente che la funzione di esportazione dei commenti è disponibile solo per i membri del Workspace in cui risiede il progetto. Non è disponibile per gli utenti esterni al Workspace con cui è stato condiviso il progetto.
  • Entire designs snapshots - include un'istantanea di ciascun documento sorgente contenente un commento nell'intervallo di tempo Period specificato. Questa fornisce una conferma visiva della posizione del commento nel documento tramite un indicatore numerato.
  • Original design screenshots - include l'istantanea originale acquisita alla creazione di un commento (disponibile anche nella finestra Contextual Commenting quando si fa clic su un indicatore di commento nell'area di progettazione principale). Questa mostra il punto, l'area o il componente a cui si riferisce il commento.

Inserimento

Per inserire un commento nell'area di progettazione di un editor grafico basato su oggetti, come quello degli schemi elettrici, dei PCB 2D o di Draftsman, esegui prima il relativo comando. Puoi farlo in uno dei seguenti modi:

  • Fai clic sul pulsante  disponibile nel pannello Comments and Tasks.

  • Fai clic su  vicino all'angolo superiore destro dell'area di progettazione.

  • Fai clic su Place » Comment nei menu principali.

  • Utilizza la scorciatoia da tastiera Ctrl+Alt+C.

  • Fai clic con il pulsante destro del mouse nell'area di progettazione, quindi seleziona Comment.

A seconda del tipo di documento (vedi sopra), i commenti possono essere assegnati a un oggetto, a un punto specifico o a un'area del documento attivo. Il comando attiva la modalità di inserimento dei commenti e il cursore assume la forma di un mirino con un cerchio blu che rileva ed evidenzia gli oggetti selezionabili:

  • Fai clic su un oggetto evidenziato per associare un commento a quell'oggetto.

  • Fai clic in un'area non evidenziata per associare un commento a quel punto specifico del documento.

  • Fai clic lontano da un oggetto e trascina il cursore per creare un'area rettangolare evidenziata e associare un commento all'area specificata ().

In un documento ActiveBOM, fai clic su una cella per aggiungere un commento alla corrispondente riga della distinta base. Fai clic con il pulsante destro del mouse su una riga, quindi seleziona il comando Comment per aggiungere un commento a tale riga.

L'operazione di inserimento apre quindi una finestra di dialogo con un campo per immettere il testo del commento e, per i documenti grafici, un'opzione aggiuntiva per aggiungere un disegno a mano libera al commento, ove applicabile (). Seleziona l'opzione Assign a task to per assegnare un'attività a te stesso o a uno degli utenti menzionati nel commento (vedi i dettagli di seguito). Fai clic su  per confermare la creazione del commento, che verrà associato a un indicatore numerato sul documento; verrà inoltre aggiunta una voce di riepilogo del commento al pannello Comments and Tasks.

Inserimento di un commento su un oggetto, menzione di un altro utente registrato nel commento, spostamento dell'indicatore del commento e aggiunta di un disegno a mano libera al commento.

Un commento inserito è immediatamente disponibile per tutti gli utenti che hanno accesso al progetto e sarà disponibile anche nella vista del progetto accessibile tramite browser del Workspace connesso.

Il numero di caratteri che è possibile inserire in un commento standard e in un'attività è limitato a 2000.

Menzioni e assegnazione delle attività

Oltre al testo, nella finestra di dialogo di inserimento dei commenti è possibile aggiungere una «menzione» riferita a qualsiasi altro utente o ruolo registrato nel Workspace connesso, inserendo il carattere @. Selezionare un nome/indirizzo e-mail dall'elenco a discesa per aggiungere al commento il riferimento all'utente (membro del Workspace) e anche come voce Assign a task to: in sostanza, all'utente verrà assegnata un'attività task. Deselezionare quest'ultima opzione se non si desidera che il commento venga considerato come assegnato specificamente a quell'utente. Anche un gruppo di ruoli (ad esempio, «Ingegneri»), e quindi gli utenti che ne fanno parte, può essere aggiunto come menzione.

Se un utente menzionato non ha accesso al progetto corrente, verrà richiesto di condividerlo con tale utente. Questa opzione è disponibile se si è il proprietario del progetto o un amministratore del Workspace. I diritti di accesso dell'utente vengono concessi tramite la finestra di dialogo Condividi; l'utente riceverà un'e-mail che lo informerà dell'accesso condiviso. Se si annulla la finestra di dialogo Condividi, il progetto non verrà condiviso, ma il commento verrà inserito normalmente.

► Ulteriori informazioni sulla condivisione di un progetto.

Quando un'attività viene assegnata a un utente, l'immagine/foto di tale utente viene visualizzata in alto a sinistra nella finestra di dialogo del commento e nel riquadro del commento nel pannello Comments and Tasks. Inoltre, l'attività verrà denominata utilizzando il nome del progetto e il numero progressivo (ad esempio, Kame_FMU-1) anziché un semplice numero, come avviene per i commenti normali. Questo nome viene visualizzato anche nella finestra di dialogo del commento e nel relativo riquadro. Fare clic sul nome per aprire la pagina Tasks del progetto nell'interfaccia browser del Workspace, con l'attività selezionata evidenziata nell'elenco delle attività.

Un'attività può essere associata a un commit del progetto quando si salva il progetto nel Workspace connesso. Come indicato nel suggerimento della finestra di dialogo Salva sul server, aggiungere l'ID dell'attività al campo Comment (così come appare nel pannello Comments and Tasks); l'attività verrà collegata al commit del progetto che verrà creato dopo aver fatto clic su OK nella finestra di dialogo.

Il collegamento al commit verrà visualizzato nel riquadro dei dettagli dell'attività quando si seleziona il riquadro dell'attività nella pagina Tasks dell'interfaccia browser del Workspace (Workspace Altium 365, Workspace Enterprise Server) o nella vista Tasks della pagina di gestione dettagliata del progetto (Workspace Altium 365, Workspace Enterprise Server). Fare clic sul collegamento per aprire la vista History del progetto con il commit correlato evidenziato nella sequenza temporale.

Il collegamento al commit associato verrà visualizzato nel riquadro dei dettagli dell'attività. Passare il cursore sull'immagine per vedere la pagina History che si apre facendo clic sul collegamento e il commit correlato evidenziato nella sequenza temporale.
Il collegamento al commit associato verrà visualizzato nel riquadro dei dettagli dell'attività. Passare il cursore sull'immagine per vedere la pagina History che si apre facendo clic sul collegamento e il commit correlato evidenziato nella sequenza temporale.

Posizionamento

La posizione di un commento nello spazio dell'editor può essere modificata trascinando il relativo «segnaposto» in una nuova posizione, durante o dopo il suo inserimento. Quando è selezionato, il segnaposto del commento include una linea di collegamento all'oggetto o all'area associati.

Sebbene sia possibile spostare (trascinare) il segnaposto di un commento nell'editor del documento, il punto o l'area definiti inizialmente non possono essere modificati.

Si noti che è possibile posizionare un commento anche durante il suo inserimento iniziale, facendo clic e trascinando in modalità di posizionamento ().

Incollare immagini

È possibile aggiungere un'immagine a un commento copiandola prima da una finestra Explorer o da una pagina del browser facendo clic con il pulsante destro del mouse sull'immagine, per copiarla negli appunti. Per allegare l'immagine, utilizzare il comando Paste del menu contestuale (oppure la scorciatoia Ctrl+V ) all'interno del commento stesso (nel campo con la dicitura Add others with @ or paste images). 

Ogni immagine può avere una dimensione massima di 2 MB. Dopo averla incollata nel commento, fare clic sull'immagine per visualizzarla per intero, come mostrato nell'immagine a destra.

È anche possibile pubblicare un commento contenente solo un'immagine incollata, senza alcun testo, come mostrato di seguito.

Disegno

Durante l'inserimento o la modifica di un commento, selezionare il pulsante di opzione  per aggiungere un disegno a mano libera utilizzando il cursore a forma di penna che viene visualizzato. Fare clic e trascinare per creare linee, quindi fare clic con il pulsante destro del mouse per terminare e associare il disegno al commento attualmente selezionato.

Per accedere alla modalità Freehand Drawing del pannello Properties, premere il tasto Tab quando è attiva la modalità di disegno a mano libera (indicata dall'icona  nello spazio di progettazione). Queste opzioni consentono di annullare e ripristinare i commenti nel menu a discesa Commands e di modificare larghezza, dimensione e colore nel menu a discesa Properties .

Attività generali

Le attività generali (attività applicate al progetto corrente ma non associate a un commento o a un documento del progetto) sono elencate nel pannello in un gruppo separato sotto la voce del progetto. Per le attività generali, il pannello mostra gli stessi contenuti e attributi (assegnatario, priorità, ecc.).

Le attività generali sono elencate nel pannello Comments and Tasks.
Le attività generali sono elencate nel pannello Comments and Tasks.

Fare clic sulla voce di un'attività generale nel pannello per accedere alle relative finestre di dialogo dei commenti. Utilizzare la finestra di dialogo per pubblicare commenti (inclusi quelli con immagini incollate) per l'attività generale selezionata.

È possibile creare un'attività generale per un progetto dalla pagina Tasks dell'interfaccia browser del Workspace, accedendo alla pagina di gestione dettagliata del progetto. Per saperne di più, consultare Management of a Specific Project ( Workspace di Altium 365, Workspace di Enterprise Server).

Commenti scollegati

Quando un documento di progetto viene rimosso o il suo UniqueID viene modificato, i commenti del documento possono risultare "scollegati". Questi commenti sono comunque accessibili dalla sezione comprimibile Detached Comments del pannello. Fai clic sul riquadro di un commento scollegato nel pannello Comments and Tasks per visualizzarne la finestra di dialogo nell'area di progettazione del documento attualmente aperto.

Lavorare con i commenti

I commenti inseriti in un documento di progetto vengono registrati sia nel pannello Comments and Tasks (come sequenza di voci numerate) sia nell'editor del documento corrispondente (come indicatori grafici numerati). Ogni voce del pannello rappresenta una discussione e fornisce informazioni di riepilogo, tra cui chi ha inserito il commento e quando, il testo del commento iniziale, eventuali menzioni/assegnazioni e il numero di risposte nella discussione.

Per aprire una discussione, seleziona la relativa voce nel pannello Comments and Tasks oppure fai clic sull'indicatore associato nell'area di progettazione. Il commento viene evidenziato nell'editor del documento e si apre la finestra di dialogo del commento, che include il commento iniziale e tutte le risposte degli utenti. Se un commento selezionato è associato a un altro documento di progetto, il sistema aprirà (e caricherà, se necessario) tale documento.

Navigazione tra i commenti selezionando gli indicatori nell'area di progettazione e le voci nel pannello Comments and Tasks.

Finestra di dialogo dei commenti

L'interazione con un commento inserito avviene tramite la finestra di dialogo a comparsa del commento, che mostra tutte le voci della discussione selezionata e include opzioni per visualizzare un'anteprima, rispondere, modificare, risolvere ed eliminare una voce. La finestra di dialogo si apre quando si inserisce inizialmente un commento o quando si seleziona un commento esistente nel pannello Comments and Tasks o nell'area di progettazione. Premi Esc o fai clic nell'area di progettazione per chiudere la finestra di dialogo del commento.

Scorri in sequenza tutti i commenti disponibili utilizzando i pulsanti precedente/successivo () nell'intestazione della finestra di dialogo.

Anteprima

Seleziona l'opzione Original Snapshot nel commento iniziale per visualizzare un'immagine dell'area dell'editor acquisita al momento dell'inserimento del commento. Fai clic sull'icona in alto a destra nello screenshot o sullo screenshot stesso per aprire un'anteprima a dimensione intera (fai clic sull'icona  in alto a destra nell'anteprima o sull'immagine stessa per chiuderla).

Risposta

Inserisci il testo e, facoltativamente, una menzione di un utente ('@') nel campo Reply per aggiungere una nuova voce alla discussione. Seleziona l'opzione Assign a task to per creare un'attività assegnata a un utente specificato nel menu a discesa. Fai clic su  per confermare la voce.

Modifica ed eliminazione

Un commento esistente può essere modificato dal suo autore utilizzando l'opzione Edit disponibile nel menu  del commento. Fai clic sul pulsante  per confermare la modifica del commento.

Utilizza l'opzione Delete per rimuovere il commento attualmente selezionato. Tieni presente che, se viene eliminato il commento iniziale (anziché una risposta), verrà rimossa l'intera discussione.

Utilizza l'opzione Convert to Task per convertire il commento in un'attività assegnata a te.

Utilizza l'opzione Copy Link per copiare l'URL della discussione. Questo collegamento può essere utilizzato per aprire il progetto nel Web Viewer dell'interfaccia browser del Workspace, con l'oggetto, il punto o l'area del commento ingranditi e centrati.

Risoluzione

Fai clic sul pulsante / per alternare lo stato del commento tra Resolved e Unresolved (predefinito). Un commento risolto (chiuso come completato) è inattivo e non modificabile; sia la relativa voce nel pannello Comments and Tasks sia il suo indicatore nel documento vengono visualizzati in grigio.

Impostazione di priorità e stati delle attività

Se un commento relativo a un'attività è stato assegnato a un utente, è possibile impostarne la priorità e lo stato. A un'attività vengono inizialmente assegnati la priorità Medium e lo stato To Do, ma è possibile modificarli facendo clic sul controllo associato nella parte superiore della finestra di dialogo del commento.

Tag del commit, ID della revisione del rilascio e informazioni sulla revisione del progetto 

I tag dei commit e gli ID delle revisioni dei rilasci vengono visualizzati quando si consultano i commenti/le attività pertinenti sia nel pannello Comments and Tasks sia nella finestra di dialogo dei commenti in Altium Designer.

  • I commenti creati nel visualizzatore Web durante la visualizzazione dell'istantanea del progetto relativa a un commit con tag includeranno il nome del tag associato. Fai clic sul collegamento del nome del tag per aprire l'istantanea del commit corrispondente nel visualizzatore Web.

  • I commenti creati nel visualizzatore Web durante la visualizzazione di un rilascio specifico includeranno l'ID della revisione del rilascio. Fai clic sul collegamento dell'ID della revisione del rilascio per aprire il portale di produzione relativo a questo rilascio.

  • I commenti creati nel visualizzatore Web durante la visualizzazione di un'istantanea di una revisione del progetto includeranno la voce relativa alla revisione del progetto. Fai clic sul collegamento della revisione del progetto per aprire la pagina della revisione.

Lavorare con le attività Jira

Se l'integrazione con Jira è abilitata e configurata per il tuo Workspace di Altium 365, un commento inserito includerà l'opzione aggiuntiva per inserire una segnalazione Jira e collegarla al tuo servizio Atlassian Jira®. Come i commenti convenzionali e le attività associate, le segnalazioni Jira inserite possono essere visualizzate, modificate e commentate dall'interno dei documenti di progetto, nonché visualizzate/selezionate tramite il pannello Comments and Tasks.

Un'istanza di attività Jira inserita viene sincronizzata con la rispettiva segnalazione nello spazio Jira. La sincronizzazione bidirezionale dei dati tra le segnalazioni Jira e le attività del Workspace consente di gestire i progetti di progettazione tramite lo spazio Jira insieme ad Altium 365.

  • Consulta la pagina Integrazione con Jira per una panoramica delle funzionalità.

  • Consulta la pagina Esplorazione dell'interfaccia browser per i dettagli sulla configurazione dell'integrazione con Jira per il tuo Workspace di Altium 365.

  • Consulta la pagina Visualizzatore Web per i dettagli sull'utilizzo delle attività Jira nel visualizzatore Web dell'interfaccia browser del Workspace di Altium 365.

Creare una segnalazione Jira

Per inserire un'attività relativa a una segnalazione Jira per un progetto, inserisci prima un commento nel modo consueto, quindi seleziona l'opzione Jira Issue nella finestra di dialogo del commento. Prosegui scegliendo un tipo di segnalazione e aggiungendo un riepilogo per creare l'attività sincronizzata con la segnalazione Jira.

Inserisci un'attività Jira nel documento di progetto corrente iniziando con l'inserimento di un'istanza di commento. La modalità alternativa Jira è disponibile nel menu a discesa Comment.

Avvia l'inserimento dell'attività Jira selezionando l'opzione Jira Issue dal menu Comment della finestra di dialogo.

Fai clic sull'opzione Create Issue se non è già selezionata.

Seleziona il tipo di ticket da creare dall'elenco a discesa Issue Type, che include quelli disponibili nel tuo servizio Jira.

Inserisci un Summary per il ticket e, facoltativamente, una descrizione e un assegnatario. L'elenco a discesa Assignee include solo gli utenti registrati come membri del tuo account Jira. Seleziona Post per confermare.

Il ticket Jira viene inserito nella posizione iniziale del commento nel documento e incluso nel pannello Comments and Tasks; fornisce un collegamento al ticket nello spazio Jira e consente di modificare in modo interattivo le impostazioni di priorità (Medium, High, ecc.) e stato (To Do, In Progress, ecc.) dell'attività.

 
  • Il numero di caratteri che è possibile inserire quando si pubblica un commento relativo a Jira o si risponde a tale commento è limitato a 20.000.

  • Quando si crea un'attività Jira tramite Altium Designer, sono supportati i seguenti campi:

    • Testo

    • Numero

    • Campo URL

    • Elenco a discesa

    • Elenco a discesa con ricerca (per l'utente assegnatario, la ricerca di ticket Jira e la ricerca di un'attività padre durante la creazione di una sottoattività)

    • Campo a selezione multipla (vengono presentate caselle di controllo con un avviso che richiede di selezionare almeno un'opzione per continuare – ).

Seleziona il Task ID del ticket Jira del Workspace nella finestra di dialogo dei commenti o nel pannello Comments and Tasks per aprire direttamente il ticket nello spazio Jira in una nuova scheda del browser predefinito. Il Task ID del Workspace è associato al Issue Key nello spazio Jira e i principali parametri Jira, come Riepilogo, Descrizione, Assegnatario e Commenti, vengono mappati tra le due istanze. L'utente del Workspace che ha creato il ticket Jira risulta essere il segnalatore del ticket in Jira. Tieni presente che un'istantanea del documento corrente del Workspace viene inclusa come allegato Jira se, durante la creazione del ticket Jira del Workspace, è stata selezionata l'opzione Attach original snapshot (vedi sopra).

Un'attività Jira inserita nel Workspace crea un ticket Jira sincronizzato nello spazio Jira. I due elementi sono collegati tramite la mappatura del Task ID del Workspace con il Issue Key di Jira.
Un'attività Jira inserita nel Workspace crea un ticket Jira sincronizzato nello spazio Jira. I due elementi sono collegati tramite la mappatura del Task ID del Workspace con il Issue Key di Jira.

Oltre ai parametri mappati tra i ticket del Workspace e di Jira, vengono sincronizzate anche le impostazioni di stato Priority e Progress relative all'attività. Ad esempio, modificando la priorità dell'attività del ticket nel Workspace da Medium a High, la modifica viene immediatamente riportata nel ticket su Jira; analogamente, modificando lo stato di avanzamento da To Do a In Progress in Jira, cambia anche lo stato del ticket Jira del Workspace. Per visualizzare i dati aggiornati potrebbe essere necessario aggiornare i dati facendo clic sul pulsante  nella parte superiore del pannello Comments and Tasks.

Collegamento a un ticket Jira

L'integrazione Jira di Altium 365 consente inoltre di collegare un'attività del Workspace a un ticket Jira esistente nel servizio Atlassian Jira tramite la modalità Jira Issue della finestra di dialogo dei commenti. Puoi collegare qualsiasi ticket del progetto Jira specificato, che verrà quindi sincronizzato con l'attività Jira del Workspace.

Javascript ID: LinkJiraIssue

Inserisci un'istanza di commento nell'area del documento o sull'oggetto che desideri associare a un ticket Jira esistente, quindi seleziona la modalità Jira Issue e l'opzione Link Issue nella finestra di dialogo dei commenti.

Utilizza l'elenco a discesa Select or search issues per selezionare il ticket Jira (mostrato come testo Summary) da collegare all'istanza dell'attività Jira appena inserita. Inizia a digitare nel campo di testo per cercare il ticket Jira desiderato.

L'elenco a discesa Jira Issue della finestra di dialogo mostrerà il ticket selezionato nello spazio Jira. Se necessario, seleziona l'opzione Attach original snapshot per trasferire a Jira un'immagine della vista corrente del documento.

Fai clic sul pulsante Post per stabilire il collegamento tra l'attività Jira del Workspace e il ticket Jira selezionato.

La nuova attività relativa al ticket Jira viene visualizzata nel pannello Comments and Tasks e nella finestra di dialogo dei commenti, che includerà tutti i commenti esistenti o aggiunti: seleziona l'opzione Show all Replies della finestra di dialogo per visualizzare l'elenco completo.

Il ticket Jira collegato è ora sincronizzato con l'attività Jira del Workspace, che include il Comments del ticket ed è impostata sugli stati Progress e Priority definiti dal ticket Jira, ovvero In Progress e High in questo esempio. Nota che le voci Web links del ticket Jira ora indicano che un'attività Jira del Workspace Altium 365 è stata collegata (o ricollegata) a questo ticket.

Un ticket Jira esistente viene collegato a un'attività del Workspace specificando la relativa voce Jira Issue nella modalità Link Issue della finestra di dialogo dei commenti del Workspace.
Un ticket Jira esistente viene collegato a un'attività del Workspace specificando la relativa voce Jira Issue nella modalità Link Issue della finestra di dialogo dei commenti del Workspace.

Pannello To-Do

Il pannello To-Do è disponibile quando l'opzione UI.PanelToDoList è abilitata nella finestra di dialogo Advanced Settings.

Sebbene il Workspace connesso offra il set completo di funzionalità per i commenti e l'assegnazione delle attività descritto sopra, puoi anche accedere al pannello To-Do per tenere traccia delle tue attività. Il pannello To-Do elenca tutti gli elementi To-Do attualmente definiti per il progetto attivo. Un elemento To-Do funge da promemoria per un'attività da svolgere in seguito in relazione a un documento.

Il pannello To-Do
Il pannello To-Do

AI-LocalizedLocalizzato tramite A
Se trovi un problema, seleziona il testo/l’immagine e premi Ctrl + Enter per inviarci il tuo feedback.
Nav
Contents
Disponibilità delle funzionalità

Le funzionalità a tua disposizione dipendono dalla soluzione Altium di cui disponi: Altium Develop, Altium Agile Teams, Altium Agile Enterprise oppure Altium Designer (con abbonamento attivo).

Se non vedi una funzionalità documentata nel software che stai effettivamente utilizzando, contatta il reparto 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.

Contents