Usare @mentions negli elementi di lavoro e nelle richieste pull

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

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 del controllo @mention , è possibile selezionare un membro o un gruppo di progetto dall'elenco di ricerca e ricevere un messaggio di posta elettronica che li informa del commento.

Per le organizzazioni che gestiscono gli utenti e i gruppi usando Microsoft Entra ID, gli utenti selezionatori supportano la ricerca in tutti gli utenti e i gruppi aggiunti all'ID Microsoft Entra, non solo quelli aggiunti al progetto. Per limitare il set ai membri e ai gruppi del progetto, vedere Gestire l'organizzazione, Limitare la ricerca e la selezione delle identità.

Nota

È possibile pubblicare un oggetto tramite l'API @mention . Ottenere l'ID utente di Azure DevOps

Se l'organizzazione usa l'edtitor HTML esistente, aggiungere il codice HTML seguente: <div><a href="#" data-vss-mention="version:2.0,{user id}">@John Doe</a> Testing mentioning</div>

Se l'organizzazione usa il nuovo edtitor Markdown per i commenti, è possibile 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 del controllo @mention , è possibile selezionare un membro del progetto dall'elenco di ricerca e ricevere un messaggio di posta elettronica che li informa del commento.

Per le organizzazioni che gestiscono gli utenti che usano Active Directory, gli utenti selezionatori forniscono supporto per la ricerca di tutti gli utenti aggiunti ad Active Directory, non solo per gli utenti aggiunti al progetto.

Utilizzare il controllo @mention per avviare o continuare una discussione all'interno delle aree seguenti:

  • Discussione di un elemento di lavoro o qualsiasi campo RTF
  • Discussione di una richiesta pull
  • Eseguire il commit dei commenti
  • Commenti del set di modifiche o degli scaffali
  • Discussione di un elemento di lavoro
  • Discussione di una richiesta pull
  • Eseguire il commit dei commenti
  • Commenti del set di modifiche o degli scaffali

Nota

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

Selezione della ricerca di identità

Quando si lascia un commento di codice in una richiesta pull, immettere @ per attivare la selezione @mention persone. Dalla selezione utenti viene visualizzato un elenco di utenti menzionati di recente. Per eseguire una ricerca nella directory, scegliere un nome o immettere 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 all'organizzazione. Per altre informazioni, vedere Limitare gli inviti dei nuovi utenti dagli amministratori del progetto e del team.

Per filtrare l'elenco, immettere il nome utente o l'alias fino a quando non viene trovata una corrispondenza.

Screenshot of people picker

È 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.

Per @mention un utente che non è mai stato selezionato in precedenza, continuare a immettere l'intero nome per eseguire la ricerca nella directory completa.

I nomi degli utenti menzionati vengono visualizzati in testo blu. Scegliere il nome del collegamento @mention per aprire le informazioni di contatto dell'utente. Le informazioni di contatto forniscono più contesto per il motivo per cui sono stati aggiunti alla conversazione.

Screenshot of discussion section with at mention made.

Web portal, At mention user contact information accessible

Nota

Non copiare/incollare @mention utenti da un commento precedente. Anche se la formattazione risultante è identica a una menzione immessa correttamente, non viene registrata come una vera menzione né invia una notifica tramite posta elettronica.

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

Screenshot of Email sent in Outlook.

Email sent to at-mention user organization

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

Identità limitate nella selezione della ricerca

In generale, gli utenti selezionano la ricerca e selezionano qualsiasi utente o gruppo aggiunto all'ID Microsoft Entra di un'organizzazione.

Per le organizzazioni che gestiscono gli utenti e i gruppi usando Microsoft Entra ID, gli utenti selezionatori forniscono supporto per la ricerca di utenti e gruppi aggiunti all'ID Microsoft Entra. Per le organizzazioni che vogliono limitare la ricerca e la selezione solo a utenti e gruppi aggiunti a un progetto specifico, è possibile farlo abilitando la funzionalità Limita visibilità utente e collaborazione a progetti specifici per l'organizzazione.

Importante

  • Le funzionalità di visibilità limitate descritte in questa sezione si applicano solo alle interazioni tramite il portale Web. Con le API REST o azure devops i comandi dell'interfaccia della riga di comando, i membri del progetto possono accedere ai dati limitati.
  • Gli utenti guest membri del gruppo limitato con accesso predefinito in Microsoft Entra ID non possono cercare gli utenti con la selezione utenti. Quando la funzionalità di anteprima è disattivata per l'organizzazione o quando gli utenti guest non sono membri del gruppo limitato, gli utenti guest possono cercare tutti gli utenti di Microsoft Entra, come previsto.

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

  • Gli utenti aggiunti al gruppo Project-Scoped Users 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, gli utenti selezionati sono limitati solo a tali 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 la funzionalità Limita visibilità utente e collaborazione a progetti specifici è abilitata per l'organizzazione, gli utenti con ambito progetto non sono in grado di cercare gli utenti aggiunti all'organizzazione tramite l'appartenenza al gruppo Microsoft Entra, anziché tramite un invito esplicito dell'utente. Si tratta di un comportamento imprevisto e si sta lavorando a una risoluzione. Per risolvere automaticamente questo problema, disabilitare la funzionalità Limita visibilità utente e collaborazione a progetti specifici per l'organizzazione.