Condividi tramite


Usare @mentions negli elementi di lavoro e nelle richieste di pull

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Il controllo @mention consente di aggiungere rapidamente un utente o un gruppo a un elemento di lavoro o a una discussione di richiesta pull. Usando la selezione utenti all'interno del controllo @mention , è possibile selezionare un membro o un gruppo di progetto dall'elenco di ricerca. L'utente o il gruppo menzionato riceve una notifica tramite posta elettronica relativa al commento.

Per le organizzazioni che gestiscono i loro utenti e gruppi utilizzando Microsoft Entra ID, i selettori di persone supportano la ricerca di tutti gli utenti e gruppi all'interno di Microsoft Entra ID. È possibile cercare utenti e gruppi oltre a quelli aggiunti al progetto. Per ulteriori informazioni, vedere Limitare la visibilità degli utenti per i progetti e altro.

Nota

È possibile pubblicare un @mention tramite API. Per ottenere l'ID utente di Azure DevOps, vedere Ottenere l'ID utente di Azure DevOps.

  • Se l'organizzazione usa l'editor HTML esistente, aggiungere il codice HTML seguente:
    <div><a href="#" data-vss-mention="version:2.0,{userID}">@John Doe</a> Testing mentioning</div>
    
  • Se l'organizzazione usa il nuovo editor Markdown per i commenti, usare il codice seguente:
    @<userID>
    

Il controllo @mention consente di aggiungere rapidamente un utente a un elemento di lavoro o a una discussione di richiesta pull. Usando la selezione utenti all'interno del controllo @mention , è possibile selezionare un membro del progetto dall'elenco di ricerca. L'utente menzionato riceve una notifica tramite posta elettronica relativa al commento.

Per le organizzazioni che gestiscono gli utenti con Active Directory, i selettori di utenti supportano la ricerca di tutti gli utenti all'interno di Active Directory, non solo gli utenti aggiunti al progetto.

Usare il controllo @mention per avviare o continuare una discussione nelle aree seguenti:

  • Discussioni sugli elementi di lavoro o campi di testo arricchito
  • Discussioni sulle richieste di pull
  • Eseguire il commit dei commenti
  • Commenti del set di modifiche o del insieme di scaffali

Nota

Per Azure DevOps Server locale, configurare un server SMTP in modo che i membri del team possano visualizzare l'opzione Notifiche dal menu dell'organizzazione o del profilo utente e ricevere notifiche.

Prerequisiti

Categoria Requisiti
Accesso al progetto , membro del progetto.

Selezione della ricerca di identità

  1. Immettere @ in un commento di codice in una richiesta pull per attivare il selettore @mention delle persone.
  2. Visualizzare l'elenco degli utenti menzionati di recente.
  3. Cercare nella directory selezionando un nome dall'elenco o immettendo il nome dell'utente che si sta cercando.

Avviso

Se si dispone dell'autorizzazione per invitare gli utenti all'organizzazione, indipendentemente dal fatto che il criterio Limita inviti sia disabilitato, è possibile @mention un utente che non fa parte dell'organizzazione. Questa azione invita l'utente alla tua organizzazione. Per ulteriori informazioni, vedere Limitare gli inviti a nuovi utenti da parte degli amministratori di progetto e team.

Per filtrare l'elenco, immettere il nome utente o l'alias finché non viene trovata una corrispondenza.

Screenshot del selettore di persone

I nomi degli utenti menzionati vengono visualizzati in testo blu. Scegliere il nome del collegamento @mention per aprire le informazioni di contatto dell'utente, fornendo più contesto sul perché sono stati aggiunti alla conversazione.

È anche possibile usare menzioni di gruppo. Immettere il nome di un team o di un gruppo di sicurezza, scegliere Cerca e quindi selezionare tra le opzioni elencate.

Screenshot della sezione di discussione con una menzione effettuata.

Nota

Non copiare e incollare gli utenti @mention da un commento precedente. Anche se la formattazione può essere identica a una menzione immessa correttamente, non viene registrata come una vera menzione e non invia una notifica tramite posta elettronica.

Al termine della selezione e dell'inserimento di testo, l'utente @mention riceve un messaggio di posta elettronica che li informa della menzione.

Screenshot del messaggio di posta elettronica inviato in Outlook.

Usare il controllo @mention nelle discussioni delle richieste pull, nei commenti del commit, nei commenti del set di modifiche e nei commenti degli scaffali.

Suggerimento

Poiché non è presente alcuna macro diretta @CreatedBy , è possibile utilizzare la @Me macro in combinazione con il campo "Created By" per filtrare gli elementi di lavoro creati dall'utente. Ad esempio, per contrassegnare l'autore di elementi con descrizioni vuote, è possibile eseguire una query per identificare tali elementi e quindi contrassegnare manualmente gli autori nella sezione commenti di ogni elemento di lavoro, chiedendo loro di aggiornare la descrizione.

Identità limitate nella selezione dei risultati di ricerca

I selettori di persone cercano e selezionano generalmente qualsiasi utente o gruppo aggiunto all'ID di Microsoft Entra di un'organizzazione.

Per le organizzazioni che utilizzano Microsoft Entra ID per gestire utenti e gruppi, gli strumenti di selezione supportano la ricerca di tutti gli utenti e gruppi all'interno della directory. Per limitare la ricerca e la selezione solo agli utenti e ai gruppi aggiunti a un progetto specifico, abilita la funzionalità di anteprima Limita la visibilità e la collaborazione degli utenti a progetti specifici per l'organizzazione.

Quando la funzionalità Limita la visibilità utente e la collaborazione a progetti specifici è abilitata per un'organizzazione, l'elenco di identità che è possibile selezionare da un menu di scelta utenti è limitato nei modi seguenti:

  • Gli utenti aggiunti al gruppo Utenti con ambito progetto possono selezionare solo da un elenco di identità che contiene utenti e gruppi aggiunti in modo esplicito al progetto a cui sono connessi.
  • Se tutti i membri del progetto vengono aggiunti al gruppo Utenti con ambito Progetto, i selettori di persone sono limitati solo a quegli utenti e gruppi aggiunti al progetto. Tutti i membri del progetto possono selezionare solo identità che corrispondono a utenti e gruppi aggiunti in modo esplicito al progetto a cui sono connessi.

Avviso

Quando si usa questa funzionalità di anteprima, considerare le limitazioni seguenti:

  • Le funzionalità di visibilità limitate descritte in questa sezione si applicano solo alle interazioni tramite il portale Web. Con le API REST o i comandi CLI, i membri del progetto possono accedere ai dati riservati.
  • Gli utenti del gruppo limitato possono selezionare solo gli utenti che vengono aggiunti in modo esplicito ad Azure DevOps e non agli utenti che hanno accesso tramite l'appartenenza al gruppo Microsoft Entra.
  • Gli utenti guest che sono membri del gruppo limitato con accesso predefinito in Microsoft Entra ID non possono cercare gli utenti con il selettore persone.