Document Commenting

Quando sono integrati con un Workspace connesso, i progetti di Altium Designer consentono a un team di progettazione distribuito di lavorare in modo collaborativo su progetti archiviati e gestiti centralmente. L’interfaccia di progettazione supporta i commenti su vari documenti di progetto 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 consente agli utenti collaboratori di visualizzare in tempo reale i commenti inseriti (ossia a coloro che hanno accesso condiviso al documento) ; i commenti vengono salvati sul server indipendentemente dal progetto, senza alterarne in alcun modo i documenti costitutivi. La funzione di commento è gestita tramite il pannello Comments and Tasks. Quando viene selezionata una voce di commento nel pannello Comments and Tasks, il sistema apre (e carica, se necessario) il documento di progetto associato.

Il pannello Comments and Tasks consente di aggiungere commenti a un’area o a un punto definito nel documento attivo di un progetto Workspace e di assegnare tali commenti ai membri del Workspace, creando di fatto attività per loro. Il pannello consente a tutti gli utenti che stanno lavorando sul documento di aggiungere commenti e visualizzare tutti i commenti senza modificare effettivamente il documento stesso. Questa funzione facilita processi di collaborazione efficaci ed è preziosa quando è necessario evidenziare problemi all’interno del documento senza eseguire fisicamente il merge e senza 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 evolve, i commenti possono essere risolti e chiusi. I commenti inseriti sono disponibili in tempo reale per gli utenti collaboratori – quelli che hanno accesso condiviso al documento – e vengono salvati nel Workspace indipendentemente dal progetto, senza alterarne in alcun modo i documenti costitutivi.

Si noti che commenti e attività possono essere aggiunti e gestiti sia in Altium Designer sia nel Workspace correlato tramite la vista di progettazione dell’interfaccia browser. La funzionalità dei due sistemi di commento è sostanzialmente la stessa e, poiché sia il progetto sia i dati dei commenti sono archiviati nel Workspace, i sistemi lavorano insieme in tempo reale.

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

Dove è supportata la funzione di commento

Schematic

Un commento può essere applicato a un oggetto, a un punto specifico o a un’area in un documento schematico.

PCB

Un commento può essere applicato a un oggetto, a un punto specifico o a un’area in un documento PCB (in modalità layout 2D) – .

Draftsman

Un commento può essere applicato a un punto specifico o a un’area in un documento Draftsman di un progetto PCB, Multi-board o Harness Design – .

Multi-board Schematic

Un commento può essere applicato a un oggetto o a un punto specifico in un documento Multi-board Schematic – .

Multi-board Assembly

Un commento può essere applicato a un punto specifico nel documento Multi-board Assembly – .

Harness Wiring Diagram and Layout Drawing

Un commento può essere applicato a un oggetto, a un punto specifico o a un’area in un documento Wiring Diagram o Layout Drawing di un progetto di harness design.

ActiveBOM

Un commento può essere applicato a una riga in un documento ActiveBOM – .

Accesso al pannello Comments and Tasks

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

• Fare clic sul pulsante Panels in basso a destra nello spazio di progettazione, quindi selezionare Comments and Tasks.

  L’icona Workspace accanto al nome di un pannello nel menu in basso a destra dello spazio di progettazione indica che è necessaria una connessione a un Workspace per visualizzare i dati del pannello associato. Un’icona blu () indica che è attualmente presente una connessione a un Workspace. Un’icona grigia () indica che al momento non è presente alcuna connessione a un Workspace e si verrà indirizzati a connettersi a un Workspace prima di poter accedere ai dati del pannello.

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

• Fare doppio clic sul pin marcatore di un commento inserito nello spazio di progettazione.

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

Prima di utilizzare la funzione di commento, assicurarsi di essere connessi al proprio Workspace e di aver aperto un progetto e uno dei tipi di documento che supportano i commenti (inclusi schematico, PCB 2D, Draftsman e ActiveBOM). Utilizzare il comando File » Open Project per scegliere un progetto Workspace tra quelli condivisi con l’utente. Il pannello Comments and Tasks fornirà indicazioni su questi prerequisiti.

Opzioni del pannello Comments and Tasks

Utilizzare i pulsanti nella parte superiore del pannello Comments and Tasks per impostare la disponibilità dei commenti nel pannello e nello spazio dell’editor e per specificare se gli utenti menzionati devono essere notificati.

Il pulsante  del pannello attiva/disattiva la visibilità dei pin marcatori dei commenti nel documento. Le voci di commento nell’elenco del pannello Comments and Tasks possono comunque essere selezionate come di consueto.

Utilizzare il menu a discesa del filtro nel pannello Comments and Tasks () per configurare il filtro dei commenti e il pulsante associato  per passare dalla vista filtrata a quella non filtrata.

• Tasks only - abilitare questa opzione per mostrare solo i commenti assegnati a un utente.
• ASSIGNED TO - tutte le opzioni sono disabilitate per impostazione predefinita. Di conseguenza, tutte le attività/tutti i commenti vengono mostrati e ordinati per nome (la prima voce nell’elenco è l’utente corrente). Quando vengono abilitate le caselle di controllo per uno o più utenti, verranno visualizzate le relative voci. 

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

• Unresolved Only – i commenti che sono stati risolti non sono inclusi nell’elenco.

• Current document only – mostra solo i commenti inseriti nel documento attualmente attivo.

• Notification settings – fare clic per aprire la finestra di dialogo Notification Settings e configurare la ricezione degli avvisi email per tutta l’attività dei commenti in questo progetto (All), solo per i commenti in cui si è menzionati o assegnati (My), oppure per non ricevere affatto avvisi email (None). ► Esempio di contenuto dell’email.

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

  

  Il PDF generato includerà informazioni sui commenti nel progetto: ID commento, autore, data e ora di creazione, testo del commento, assegnatario (per le attività) e stato (per un commento, se è Resolved; per un’attività, il suo stato To Do / In Progress / Resolved). È possibile scegliere di esportare tutti i commenti associati al progetto, indipendentemente da quando sono stati creati, oppure solo i commenti inseriti tra release specifiche del progetto. Sono inoltre disponibili alcune opzioni per definire quali schermate includere nel documento PDF generato. Insieme, entrambe forniscono informazioni su dove si trova un commento e a cosa si applica (punto, componente, area). Se si lasciano entrambe deselezionate, si otterranno solo i commenti stessi. Una volta configurato, fare clic su Export per generare il PDF, utilizzando la finestra di dialogo successiva per determinare dove salvarlo e con quale nome (per impostazione predefinita, quello del progetto).

  • Entire designs snapshots - includi un’istantanea di ciascun documento sorgente con un commento entro l’intervallo di tempo Period specificato. Questo fornisce una conferma visiva di dove si trova il commento nel documento tramite un indicatore di commento numerato.
  • Original design screenshots - includi l’Istantanea originale acquisita quando è stato creato un commento (ed è l’istantanea disponibile dalla finestra Contextual Commenting quando si fa clic su un indicatore di commento nello spazio di progettazione principale). Questa mostra il punto, l’area o il componente a cui si applica il commento.

  L’esportazione dei commenti in PDF può anche essere configurata e generata tramite un file Output Job come parte del rilascio del progetto. Aggiungere un outputter Export Comments come parte della categoria Report Outputs.

  Si noti che la funzione di esportazione dei commenti è disponibile solo per i membri del Workspace in cui risiede il progetto. Non è disponibile per gli utenti con cui il progetto è stato condiviso al di fuori del Workspace.

Posizionamento

Per inserire un commento nello spazio di progettazione di un editor grafico basato su oggetti, come schematico, PCB 2D o Draftsman, eseguire prima il relativo comando. Questo può essere fatto in uno dei seguenti modi:

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

• Fare clic su vicino all’angolo superiore destro dello spazio di progettazione.

• Fare clic su Place » Comment dai menu principali.

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

• Fare clic con il pulsante destro del mouse, quindi selezionare Comment nello spazio di progettazione.

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 richiama la modalità di posizionamento del commento e il cursore cambia in un mirino con un cerchio blu che rileva ed evidenzia gli oggetti selezionabili:

• Fare clic su un oggetto evidenziato per allegare (fissare) un commento a quell’oggetto.

• Fare clic in un’area non evidenziata per allegare un commento a quel punto specifico del documento.

• Fare clic lontano da un oggetto e trascinare il cursore per creare un’area rettangolare evidenziata e allegare un commento all’area specificata ().

In un documento ActiveBOM, fare clic su una cella del documento ActiveBOM per aggiungere un commento a quella riga della BOM. Fare clic con il pulsante destro del mouse su una riga e quindi selezionare il comando Comment per aggiungere un commento a questa riga.

L’azione di posizionamento apre quindi una finestra di dialogo per l’inserimento del commento che offre un campo per immettere il testo del commento e, per i documenti grafici, anche un’opzione aggiuntiva per aggiungere al commento un disegno a mano libera, ove applicabile (). Selezionare l’opzione Assign a task to per assegnare un’attività a sé stessi o a uno degli utenti menzionati nel commento (vedere i dettagli di seguito). Fare clic su per confermare la creazione del commento, che assocerà il commento a un indicatore numerato sul documento e aggiungerà anche una voce di riepilogo del commento nel pannello Comments and Tasks.

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

Menzioni e assegnazioni di attività

Insieme al testo nella finestra di dialogo di inserimento del commento, è possibile aggiungere un riferimento di “menzione” per qualsiasi altro utente o ruolo registrato nel Workspace connesso inserendo il carattere @. Selezionare un nome/email dall’elenco a discesa per aggiungere il riferimento dell’utente (membro del Workspace) al commento e anche come voce Assign a task to – in sostanza, verrà assegnata una task all’utente. Deselezionare quest’ultima opzione se non si desidera che il commento venga considerato come specificamente assegnato a quell’utente. Anche un gruppo di ruoli (ad esempio, “Engineers”) e quindi i relativi utenti che ne fanno parte possono essere aggiunti 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 utente vengono concessi tramite la finestra di dialogo Share dialog; l’utente riceverà un’email che lo informerà dell’accesso condiviso. Se si annulla la finestra di dialogo Share, il progetto non verrà condiviso, ma il commento verrà comunque inserito normalmente.

► Vedi ulteriori informazioni sulla condivisione di un progetto.

Quando un’attività viene assegnata a un utente, l’immagine/foto di questo utente verrà mostrata in alto a sinistra nella finestra di dialogo del commento e nel riquadro del commento nel pannello Comments and Tasks. Inoltre, all’attività verrà assegnato come nome il nome del progetto e il numero di sequenza (ad esempio, Kame_FMU-1) invece di un semplice numero come avviene per i commenti normali. Questo nome viene mostrato anche nella finestra di dialogo del commento e nel riquadro del commento. Fare clic su di esso per aprire la pagina Tasks del progetto nell’interfaccia browser del Workspace con l’attività selezionata evidenziata nell’elenco delle attività.

Posizionamento

La posizione di un commento nello spazio dell’editor viene spostata trascinando la relativa “puntina” in una nuova posizione, durante o dopo il suo inserimento. Quando è selezionata, la puntina del commento include una linea di collegamento all’oggetto o all’area associata.

Si noti che un commento può anche essere posizionato durante il suo inserimento iniziale facendo clic e trascinando in modalità di posizionamento ().

Incollare immagini

È possibile aggiungere un’immagine a un commento copiando prima l’immagine da una finestra Explorer  o da una pagina del browser facendo clic con il pulsante destro del mouse sull’immagine, che la copia negli appunti. Per allegare l’immagine, usare il comando del pulsante destro del mouse Paste (oppure la scorciatoia Ctrl+V ) nel commento stesso (nel campo che riporta 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 a dimensione intera, come mostrato nell’immagine a destra.

È anche possibile pubblicare un commento che includa solo un’immagine incollata senza alcun testo, come mostrato di seguito.

Disegno

Durante l’inserimento o la modifica di un commento, selezionare il pulsante opzione per aggiungere un disegno a mano libera con il cursore risultante a forma di penna. 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 la modalità di disegno a mano libera è attiva (questo è indicato dall’icona nello spazio di progettazione). Queste opzioni consentono di annullare e ripetere 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 del progetto o a un documento) sono elencate nel pannello in un gruppo separato sotto la voce del progetto. Nel pannello, per le attività generali, vengono mostrati gli stessi contenuti e attributi (assegnatario, priorità, ecc.).

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

Fare clic su una voce di 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.

Commenti scollegati

Quando un documento di progetto viene rimosso, oppure il suo UniqueID è cambiato, i commenti del documento possono diventare "scollegati". Tali commenti possono comunque essere consultati dalla regione comprimibile Detached Comments del pannello. Fare clic sul riquadro di un commento scollegato nel pannello Comments and Tasks per mostrarne la finestra di dialogo nello spazio 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 un thread di commenti e fornisce informazioni di riepilogo, inclusi chi ha inserito il commento e quando, il testo del commento iniziale, eventuali menzioni/assegnazioni applicate e il numero di risposte nel thread.

Un thread di commenti viene aperto selezionando la relativa voce nel pannello Comments and Tasks oppure facendo clic sul relativo indicatore nello spazio di progettazione. Questa azione evidenzia il commento nell’editor del documento e apre la finestra di dialogo della voce di commento, che include il commento iniziale ed eventuali risposte degli utenti. Se il commento selezionato è associato a un altro documento di progetto, il sistema aprirà (e caricherà, se necessario) quel documento.

Navigazione tra i commenti selezionando i marcatori a pin nello spazio di progettazione e selezionando le voci nel pannello Comments and Tasks.

Finestra di dialogo Commenti

L’interazione con un commento inserito avviene tramite la finestra di dialogo popup del commento, che mostra tutte le voci del thread di commenti selezionato e include opzioni per anteprima, risposta, modifica, risoluzione ed eliminazione di una voce. La finestra di dialogo si apre quando si inserisce inizialmente un commento oppure quando si seleziona un commento già inserito nel pannello Comments and Tasks o nello spazio di progettazione. Premere Esc oppure fare clic nello spazio di progettazione per chiudere la finestra di dialogo del commento.

Anteprima

Selezionare l’opzione Original Snapshot nel commento iniziale per vedere una cattura grafica dell’area dell’editor nel momento in cui il commento è stato inserito. Fare clic sull’icona in alto a destra dello screenshot oppure sullo screenshot stesso per aprire un’anteprima a dimensione intera (fare clic sull’icona  in alto a destra di questa anteprima oppure sull’immagine stessa per chiuderla).

Rispondi

Immettere testo e, facoltativamente, una menzione utente ('@') nel campo Reply per aggiungere una nuova voce al thread di commenti. Selezionare l’opzione Assign a task to per creare un’attività assegnata a un utente specificato nel menu a discesa. Fare clic su  per confermare la voce.

Modifica ed elimina

Un commento esistente può essere modificato dall’autore di quel commento utilizzando l’opzione Edit disponibile nel menu del commento. Fare clic sul pulsante per confermare la modifica del commento.

Utilizzare l’opzione Delete per rimuovere il commento attualmente selezionato. Si noti che l’intero thread verrà rimosso se viene eliminato il commento iniziale (anziché una risposta).

Utilizzare l’opzione Convert to Task per convertire il commento in un’attività assegnata a sé stessi.

Utilizzare l’opzione Copy Link per copiare l’URL del thread di commenti. Questo collegamento può essere utilizzato per aprire questo progetto nella Web Viewer dell’interfaccia browser del Workspace, con un oggetto, un punto o un’area del commento ingranditi e centrati.

Risolvi

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

Impostazione di priorità e stati delle attività

Se un commento-attività è stato assegnato a un utente, è possibile impostarne priorità e stato. Un’attività viene inizialmente impostata immediatamente con priorità Medium e stato To Do, ma questi valori possono essere modificati facendo clic sul relativo controllo nella parte superiore della finestra di dialogo del commento.

Informazioni su Commit Tag, ID revisione di rilascio e Design Review 

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

• I commenti creati nel Web Viewer durante la visualizzazione dello snapshot di progetto di un commit con tag includeranno il nome del tag associato. Fare clic sul collegamento del nome del tag per aprire nel Web Viewer lo snapshot del commit correlato.

• I commenti creati nel Web Viewer durante la visualizzazione di una release specifica includeranno l’ID di revisione della release. Fare clic sul collegamento dell’ID di revisione della release per aprire il Manufacturing Portal di questa release.

• I commenti creati nel Web Viewer durante la visualizzazione di uno snapshot di Design Review includeranno la voce della design review. Fare clic sul collegamento della design review per aprire la relativa pagina.

Lavorare con le attività Jira

Se Jira Integration è abilitata e configurata per il tuo Altium 365 Workspace, un commento inserito includerà l’opzione aggiuntiva di creare e collegare un issue Jira nel tuo servizio Atlassian Jira®. Come i commenti convenzionali e le relative attività associate, gli issue Jira inseriti possono essere visualizzati, modificati e commentati dall’interno dei documenti di progetto, oltre che visualizzati/selezionati tramite il pannello Comments and Tasks.

Un’istanza di attività Jira inserita viene sincronizzata con il rispettivo issue nello spazio Jira. La sincronizzazione bidirezionale dei dati tra gli issue Jira e le attività del Workspace consente di gestire il progetto di progettazione tramite lo spazio Jira in combinazione con Altium 365.

Creare un issue Jira

Per inserire un’attività di tipo Jira Issue per un progetto di progettazione, inserire prima un commento nel modo consueto e quindi selezionare l’opzione Jira Issue nella finestra di dialogo del commento. Proseguire scegliendo un tipo di issue e aggiungendo un riepilogo per creare l’attività issue Jira sincronizzata.

❯ ❮ Javascript ID: CreateJiraIssue

Inserire un’attività Jira nel documento di progetto corrente prima inserendo un commento. La modalità Jira alternativa è disponibile dal menu a discesa Comment. Richiamare l’inserimento dell’attività Jira selezionando l’opzione Jira Issue dal menu Comment della finestra di dialogo. Fare clic sull’opzione Create Issue se non è già selezionata. Selezionare il tipo di issue da creare dall’elenco a discesa Issue Type, che include quelli disponibili nel tuo servizio Jira. Immettere un Summary dell’issue e una descrizione/assegnatario facoltativi. L’elenco a discesa Assignee includerà solo gli utenti che sono membri registrati del tuo account Jira. Selezionare Post per confermare. L’issue Jira viene inserito nella posizione iniziale del commento del documento, è incluso nel pannello Comments and Tasks, fornisce un collegamento all’issue nello spazio Jira e include accesso interattivo alle impostazioni della sua priorità attività (Medium, High, ecc.) e del suo stato (To Do, In Progress, ecc.).

Selezionare il Task ID dell’issue Jira del Workspace nella finestra di dialogo del commento o nel pannello Comments and Tasks per aprire direttamente quell’issue nello spazio Jira in una nuova scheda del browser predefinito. Il Task ID del Workspace corrisponde al Issue Key nello spazio Jira e i principali parametri Jira, come Summary, Description, Assignee e Comments, vengono mappati tra le due istanze. L’utente Workspace che ha creato il Jira Issue è l’Issue Reporter sul lato Jira. Si noti che un’immagine snapshot del documento Workspace corrente viene inclusa come allegato Jira se durante la creazione del Jira issue del Workspace è stata selezionata l’opzione Attach original snapshot (vedere sopra).

Un'attività Jira del Workspace posizionata creerà un problema Jira sincronizzato nello spazio Jira. I due elementi sono collegati dalla mappatura del Workspace Task ID con il Jira Issue Key.

Insieme ai parametri mappati tra il Workspace e i problemi Jira, vengono sincronizzate anche le impostazioni di stato relative all'attività Priority e Progress. Ad esempio, spostando l'attività del problema del Workspace da uno stato di priorità Medium a High, la modifica verrà immediatamente riflessa nel problema sul lato Jira; analogamente, cambiando lo stato di avanzamento da To Do a In Progress sul lato Jira, cambierà anche lo stato del problema Jira del Workspace. Potrebbe essere necessario un aggiornamento dei dati (eseguito facendo clic sul pulsante  nella parte superiore del pannello Comments and Tasks) per visualizzare i dati aggiornati.

Collegamento a un problema Jira

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

❯ ❮ Javascript ID: LinkJiraIssue

Posiziona un'istanza di commento nell'area del documento o sull'oggetto che desideri associare a un problema Jira esistente, quindi seleziona la modalità Jira Issue e l'opzione Link Issue nella finestra di dialogo dei commenti. Usa il menu a discesa Select or search issues per selezionare il problema Jira (mostrato come testo Summary) che verrà collegato alla nuova istanza dell'attività Jira posizionata. Inizia a digitare nel campo di testo per cercare il problema Jira desiderato. Il menu a discesa Jira Issue della finestra di dialogo mostrerà il problema selezionato dallo spazio Jira. Se necessario, seleziona l'opzione Attach original snapshot per trasferire un'immagine della vista corrente del documento in Jira. Fai clic sul pulsante Post per stabilire il collegamento tra l'attività Jira del Workspace e il problema Jira selezionato. La nuova attività del problema Jira viene mostrata nel pannello Comments and Tasks e nella finestra di dialogo dei commenti, che includerà eventuali commenti esistenti (o aggiunti): seleziona l'opzione Show all Replies della finestra di dialogo per visualizzare l'elenco completo.

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

Un problema 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

Sebbene il Workspace connesso fornisca un insieme completo di funzionalità per i commenti e l'assegnazione delle attività descritte 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 viene utilizzato come promemoria per un'attività che deve essere eseguita successivamente in relazione a un documento.

Il pannello To-Do

To-Do Panel Content and Use

Il pannello To-Do può elencare due tipi di elementi "to-do" per il progetto attivo:

• Un elemento To-Do a livello di progetto.
• Un elemento To-Do a livello di documento, aggiunto a un documento testuale all'interno del progetto.

Per ciascun elemento To-Do, vengono visualizzate le seguenti informazioni:

• Done - questa casella di controllo consente di selezionare l'elemento quando l'attività definita è stata completata.
• Action Item - l'attività effettiva che deve essere eseguita.
• Priority - l'importanza dell'attività da eseguire (Lowest, Low, Normal (predefinita), High, Highest).
• Document - un riferimento al documento sorgente a cui è stato aggiunto un elemento To-Do a livello di documento.
• Owner - può essere il nome della persona che inserisce l'attività o che deve effettivamente eseguirla.
• Category - può essere l'area specifica del progetto a cui appartiene l'attività da eseguire (ad esempio schemi, regole di progettazione, routing, vincoli, ecc.).

Aggiunta di elementi To-Do a livello di progetto

Gli elementi To-Do a livello di progetto vengono aggiunti direttamente dal pannello stesso. Prima di aggiungere qualsiasi elemento, assicurati che il documento attivo nella finestra dell'editor di progettazione sia uno dei documenti di progetto per il quale desideri definire elementi To-Do.

Per aggiungere un nuovo elemento To-Do, fai clic con il pulsante destro del mouse all'interno del pannello e scegli la voce Add Project To-Do Item dal successivo menu contestuale visualizzato. Si aprirà la finestra di dialogo Edit To-Do Item.

Usa questa finestra di dialogo per inserire un testo appropriato per l'attività che deve essere eseguita per il progetto. Usa i campi disponibili nella finestra di dialogo per definire un task's Priority, Owner, and Category. Dopo aver definito l'elemento come richiesto, fai clic su OK per aggiungere il nuovo elemento al pannello.

Aggiunta di elementi To-Do a livello di documento

Gli elementi To-Do a livello di documento vengono aggiunti a un documento sorgente testuale (ad esempio file VHDL, file di vincoli, documento di codice sorgente embedded, ecc.). Prima di aggiungere qualsiasi elemento, assicurati che il documento richiesto sia attivo nella finestra dell'editor di progettazione e che questo documento appartenga al progetto di cui stai attualmente definendo gli elementi To-Do complessivi.

Per aggiungere un nuovo elemento To-Do, posiziona il cursore di testo nella posizione desiderata all'interno del documento in cui vuoi inserire un elemento To-Do, fai clic con il pulsante destro del mouse e scegli la voce Add To-Do Item dal successivo menu a comparsa visualizzato. Verrà visualizzata la finestra di dialogo Edit To-Do Item. Usa questa finestra di dialogo per inserire un testo appropriato relativo all'attività che deve essere eseguita nel documento. Usa i campi disponibili nella finestra di dialogo per definire un Priority, Owner e Category per l'attività (ad esempio passaggio di formattazione, passaggio di revisione del codice, ecc.). Dopo aver definito l'elemento To-Do come richiesto, fai clic su OK per chiudere la finestra di dialogo e riportare il focus al documento corrente. Una voce per l'elemento To-Do apparirà nel pannello To-Do e anche nel punto contrassegnato dalla posizione corrente del cursore di testo. La voce apparirà come commento (tra i delimitatori di commento definiti per quel tipo di documento), includendo il testo effettivo dell'elemento e un identificatore univoco, come mostrato nell'immagine seguente.

Menu del tasto destro

Il menu del tasto destro fornisce i seguenti comandi:

• Goto Source - questo comando diventa disponibile quando l'elemento selezionato nel pannello è un elemento To-Do a livello di documento. Usa questo comando per aprire (se non è già aperto) il documento sorgente associato a cui si fa riferimento nel campo Documento dell'elemento e renderlo il documento attivo nella finestra dell'editor di progettazione. Il cursore di testo verrà posizionato all'inizio del testo dell'elemento To-Do.
• Add Project To-Do Item - aggiunge un elemento To-Do a livello di progetto al pannello per il progetto attivo.
• Edit - modifica l'elemento To-Do selezionato. Verrà visualizzata la finestra di dialogo Edit To-Do Item, che ti consentirà di apportare le modifiche richieste.
• Delete - elimina l'elemento To-Do selezionato dal pannello.
• Show Completed Items - con questa opzione abilitata, nel pannello rimarranno visualizzati solo gli elementi To-Do contrassegnati come completati (opzione Done abilitata).
• Report - genera un report contenente tutti gli elementi To-Do attualmente visualizzati nel pannello. Dopo aver avviato il comando, si aprirà la finestra di dialogo Report Preview nella quale potrai configurare, stampare ed esportare il report in vari formati di file.

Note

• Se nel pannello è stato definito un elemento To-Do a livello di documento e il documento sorgente corrispondente è il documento attivo nella finestra dell'editor di progettazione, il testo dell'intera voce To-Do nel pannello verrà visualizzato in grassetto.
• Facendo doppio clic su una voce di elemento To-Do nel pannello si aprirà la finestra di dialogo Edit To-Do Item, consentendoti di modificare la definizione dell'attività.
• Le voci nel pannello possono essere ordinate in base a qualsiasi colonna facendo clic sull'intestazione di quella colonna. Fai clic una volta per ordinare in ordine crescente; fai clic di nuovo per ordinare in ordine decrescente.
• Il filtro diretto consente di passare rapidamente a una voce di elemento To-Do digitando direttamente nel pannello. Puoi filtrare in base a qualsiasi colonna di dati nel pannello. Usa i tasti Right Arrow e Left Arrow per passare da una colonna all'altra per il filtro, oppure fai clic direttamente su un campo all'interno di una colonna. Per usare questa funzione di filtro, fai clic all'interno di una colonna di dati e digita la prima lettera della voce a cui vuoi passare. Verrà selezionata la prima voce in quella colonna che inizia con la lettera digitata e la lettera verrà evidenziata per mostrare che il filtro del contenuto della colonna si basa sulla lettera digitata.