Commenti

Requirements Portal supporta l'aggiunta di commenti nei progetti dei requisiti. Un commento è una nota aggiunta da un utente, associata a un requisito specifico, a cui altri utenti possono rispondere. I commenti favoriscono la collaborazione tra gli utenti senza modificare i dati condivisi, poiché vengono memorizzati dal Workspace indipendentemente da tali dati. In un commento puoi menzionare una o più persone o gruppi. Un commento può anche essere assegnato a un membro del Workspace.

I commenti vengono pubblicati, gestiti e ricevono risposte direttamente nella tabella dei requisiti tramite una finestra contestuale dei commenti. I commenti vengono visualizzati anche nel pannello Comments and Tasks, situato sul lato destro, che offre una panoramica e uno strumento di navigazione, anziché un'interfaccia operativa. Usa il controllo  in alto a destra per mostrare o nascondere il pannello Comments and Tasks.

Aggiunta di un commento

Puoi attivare la modalità di inserimento dei commenti in uno dei seguenti modi:

• Fai clic sul pulsante  nella parte superiore del pannello Comments and Tasks, quindi usa il cursore di inserimento che appare () per selezionare la riga del requisito da commentare.

• Fai clic sul pulsante  nella riga del requisito e seleziona il comando Commenta dal menu che appare.

In entrambi i casi verrà visualizzata una finestra dei commenti, in cui puoi definire il commento nel contesto del requisito scelto. Digita il commento nell'apposito campo. Nel commento puoi menzionare una o più persone o gruppi. Digita il carattere @ nel campo del commento per accedere rapidamente a un elenco dei membri del Workspace. Un commento può anche essere assegnato a un membro. Per ulteriori informazioni su queste funzionalità aggiuntive, consulta la sezione Utilizzo della finestra contestuale dei commenti.

Dopo aver inserito il commento, aggiunto eventuali menzioni ed effettuato un'assegnazione, se necessario, fai clic sul pulsante  sottostante. Il commento verrà salvato e apparirà sia nella finestra contestuale dei commenti sia nel pannello Comments and Tasks. Nella colonna Identifier dei requisiti con un commento verrà visualizzato un indicatore di commento ().

La seguente sequenza di immagini mostra l'aggiunta di un commento di esempio a un requisito, insieme alla menzione di un membro del team e all'assegnazione di un'attività a tale membro (vedi sotto per i dettagli).

Utilizzo della finestra contestuale dei commenti

I punti seguenti riguardano l'utilizzo dei commenti e della finestra contestuale dei commenti dell'interfaccia:

• Puoi accedere alla finestra dei commenti facendo clic sulla voce del commento nel pannello Comments and Tasks.

  

• Puoi spostare liberamente la finestra facendo clic sulla barra superiore e trascinandola.

• Usa i pulsanti in alto a sinistra nella finestra dei commenti per passare in sequenza, rispettivamente, al commento precedente e a quello successivo.

  Puoi anche usare Shift+Left Arrow e Shift+Right Arrow per passare, rispettivamente, al commento precedente e a quello successivo.

• Dopo l'inserimento di un primo commento, quando viene aperta, la finestra dei commenti è pronta per l'inserimento di una risposta. Digita il testo nell'apposito campo, quindi fai clic sul pulsante per salvarlo. Per uscire senza rispondere, premi Esc.

• Puoi menzionare una persona o un gruppo in un commento. Inserisci il carattere @ per accedere a un elenco a comparsa di tutti i membri del team del Workspace. In alternativa, cerca il gruppo o la persona (quest'ultima per nome o indirizzo email) digitando @ seguito da uno o più caratteri: verrà visualizzato un elenco di gruppi, membri del team e persone esterne al team (ma appartenenti alla tua organizzazione) corrispondenti alla ricerca, da cui scegliere. Puoi fare clic su una voce per aggiungerla oppure usare i tasti Up Arrow / Down Arrow e premere Enter per aggiungerla.

  Una persona menzionata che è membro del team o di un gruppo menzionato riceverà un'email di notifica del commento.

  

  Puoi menzionare qualsiasi persona o gruppo in un commento. Inserisci il carattere @ per accedere a un elenco di tutti i membri e gruppi del Workspace.

  

  In alternativa, inserisci @ e inizia a digitare per cercare un gruppo o una persona. L'elenco dinamico include i membri del Workspace, altre persone della tua organizzazione e i gruppi definiti per il Workspace.

  

  Quando rispondi a un commento, puoi anche assegnare un'attività alla persona appena menzionata.

  

  La persona, le persone o i gruppi desiderati appariranno come menzioni nel testo del commento (con il loro nome, ove possibile).

   

• Puoi assegnare un'attività a una persona che è stata menzionata. Abilita l'opzione Assign a Task to a questo scopo: per impostazione predefinita viene selezionata la prima persona menzionata oppure, se non sono presenti menzioni, tu stesso (Me). In alternativa, usa il menu a discesa per scegliere un altro membro del Workspace a cui assegnare l'attività. La persona assegnataria viene mostrata nella voce del pannello Comments and Tasks tramite l'immagine o la lettera del suo profilo utente, insieme a un riferimento all'attività associata. L'assegnazione dell'attività può essere modificata o rimossa durante la modifica del commento.

  

  Quando a un commento è associata un'attività, il bordo superiore della relativa finestra include:

  • un'icona (immagine/lettera) che indica il membro a cui è stata assegnata l'attività del commento. Seleziona l'icona per riassegnare l'attività a un altro membro del Workspace dall'elenco a discesa.

  • il riferimento alfanumerico dell'attività, composto dall'identificatore del requisito con il numero dell'attività come suffisso. Fai clic sul riferimento per passare alla voce corrispondente nella pagina Attività del Workspace.

    Dalla pagina Tasks del Workspace, puoi anche visualizzare e modificare la priorità dell'attività (Medium per impostazione predefinita).

  • lo stato corrente dell'attività (To Do, In Progress, Resolved), che può essere modificato dal relativo menu a discesa ().

  

• È possibile aggiungere un'attività a un commento esistente utilizzando l'opzione Convert to Task disponibile nel menu  della finestra. La nuova attività viene inizialmente assegnata a te e può essere riassegnata a un altro membro del Workspace selezionando la relativa voce nell'elenco a discesa che si apre dall'avatar dell'assegnatario (in alto a sinistra).

  

• La finestra dei commenti accetta anche un file immagine o uno screenshot incollato dagli appunti di Windows. Puoi incollare lo screenshot (o il file immagine copiato) nel campo del commento prima o dopo eventuali note di testo e menzioni degli utenti. L'immagine viene visualizzata nel corpo della finestra dei commenti: fai clic sull'immagine per aprirla a grandezza naturale. La voce del commento inserito nel pannello Comment and Tasks includerà una nota includes images correlata.

  

• Un commento può essere modificato o eliminato, esclusivamente tramite la finestra dei commenti, utilizzando rispettivamente i comandi Edit e Delete . Questi sono disponibili nel menu associato al controllo . Tieni presente che questi comandi sono disponibili solo per i commenti che hai inserito tu: non puoi modificare o rimuovere un commento di un altro utente. Per modificare un commento esistente, apporta le modifiche, quindi fai clic sul pulsante per confermarle. Per uscire senza applicare alcuna modifica, premi Esc.

  Se elimini un commento, tieni presente che verranno eliminate anche tutte le risposte associate.

  

• Quando si accede alla finestra dei commenti, vengono visualizzati solo il primo e l'ultimo commento del thread. Per visualizzare tutti i commenti del thread, fai clic sul controllo disponibile tra queste due voci. Utilizza la barra di scorrimento per sfogliare tutti i commenti.

  

• Un commento può essere contrassegnato come risolto (o reso nuovamente attivo) tramite il controllo nella parte superiore della finestra dei commenti. Se al commento è associata un'attività assegnata, il suo stato corrente può essere impostato su Resolved (o un altro stato) dal menu a discesa dello stato. I commenti risolti non vengono visualizzati nel pannello Comments and Tasks per impostazione predefinita, ma possono essere resi visibili tramite l'opzione per mostrare/nascondere i marcatori: consulta la sezione successiva per ulteriori informazioni.

  

Utilizzo del pannello Commenti

I punti seguenti riguardano l'utilizzo dei commenti e del pannello Comments and Tasks dell'interfaccia:

• Il pannello Comments and Tasks offre una panoramica dei commenti dell'intero progetto e uno strumento per navigare tra essi, anziché un'interfaccia operativa per pubblicarli, modificarli e rispondere. Queste funzionalità sono disponibili esclusivamente nella finestra contestuale dei commenti.

• Il pannello Comments and Tasks può essere aperto anche facendo clic su un marcatore di commento nell'area di visualizzazione principale. Questa operazione apre anche la finestra contestuale dei commenti.

• Utilizza il controllo in alto a destra nel pannello per visualizzare i marcatori dei commenti nella tabella dei requisiti () o per nasconderli ().

  

  

   

• Nella parte superiore del pannello Comments and Tasks sono presenti i controlli che consentono di accedere ai filtri dei thread, per definire quali elementi vengono visualizzati nel pannello. È possibile definire essenzialmente due livelli di filtro. Il primo, o livello primario, consente di controllare quali commenti degli utenti vengono visualizzati.

  

  Le opzioni di filtro del pannello limitano le voci dei commenti a:

  • Tasks only – solo i commenti assegnati come attività degli utenti, a loro volta disponibili nel flusso della pagina Attività.

  • Assigned to – solo i commenti assegnati agli utenti selezionati nell'elenco sottostante. Quando si seleziona la casella di controllo di un utente, il pannello (e il documento visualizzato) includerà solo i commenti con attività assegnate a quell'utente. Tieni presente che l'utente attualmente connesso compare in cima all'elenco, indipendentemente dalle assegnazioni delle attività dei commenti.

  Il livello secondario di filtro, applicato insieme al metodo di filtro primario, offre due opzioni che consentono di nascondere tutti i commenti o le attività risolti (Unresolved only abilitato) e/o di visualizzare solo i commenti relativi al contesto attualmente selezionato (ovvero cartella, specifica o sezione), anziché all'intero progetto (Current context only abilitato).

  

• Fai clic sulla voce Notification Settings (nella parte inferiore della finestra delle opzioni mostrata sopra) per accedere a una finestra in cui configurare per quali commenti del progetto ricevere notifiche email. Puoi scegliere di ricevere notifiche per tutti i thread di commenti, per nessun thread oppure solo per quelli in cui sei coinvolto (che hai avviato, a cui hai risposto o in cui sei stato menzionato).

  

• Anche per l'ordinamento dei thread di commenti nel pannello sono previsti due livelli. Innanzitutto, i commenti vengono ordinati in base alla specifica a cui appartengono, seguendo lo stesso ordine della struttura Requirements nell'albero del progetto a sinistra. Poi, per ogni requisito, i commenti vengono ordinati per data di creazione, in ordine decrescente.

• Quando fai clic sulla voce di un thread di commenti nel pannello, quel commento viene aperto nella finestra contestuale dei commenti. Anche la voce del commento nel pannello Comments and Tasks viene evidenziata in blu. Se fai clic su un commento che non appartiene alla specifica attualmente visualizzata, verrai reindirizzato alla specifica che lo contiene.

  

• Ogni voce di commento nel pannello fornisce un riepilogo delle informazioni principali relative a quel commento, come mostrato nell'esempio seguente.