Personalizzare il formato degli avvisi di posta elettronica per le modifiche agli elementi di lavoro

È possibile personalizzare il contenuto e il formato delle notifiche di posta elettronica per le modifiche apportate dall'utente o dai membri del team agli elementi di lavoro modificando i file di trasformazione xsl associati. I membri del team possono configurare gli avvisi di progetto in Team Explorer per diverse notifiche e specificare il formato HTML o testo normale. Ad esempio, è possibile generare notifiche per progetti, elementi di lavoro ed eventi di compilazione e personalizzare l'aspetto delle notifiche inviate all'utente di Team Foundation.

I file di trasformazione delle notifiche di posta elettronica vengono archiviati nella seguente cartella nel server a livello applicazione:

Unità:\Programmi\Microsoft Visual Studio 2010 Team Foundation Server\Application Tier\TFSJobAgent\Transforms

È possibile utilizzare un editor XML, ad esempio Visual Studio, per modificare i file di trasformazione. Nell'elenco che segue sono riportati i due file di trasformazione per l'evento di elemento di lavoro:

WorkItemChangedEvent.xsl

Configurazione per l’invio di e-mail in formato HTML

WorkItemChangedEvent.plaintextXsl

Configurazione l’invio di e-mail in formato testo.

Il servizio eventi utilizza i file con estensione xsl e plaintextXsl per trasformare i dati XML per un evento in un messaggio di posta elettronica. Modificare il file .xsl per avere un formato diverso per l'avviso mediante posta elettronica. Per i messaggi di posta elettronica in formato HTML, il layout principale per tutti gli eventi viene archiviato in TeamFoundation.xsl. È necessario fare una copia di backup dei file che si desidera modificare, quindi eseguire un test delle modifiche. Una volta apportate le modifiche, Team Foundation Server utilizzerà la trasformazione modificata per le future generazioni di notifiche per un evento.

Nota

Il contenuto dei messaggi di posta elettronica emessi viene generato automaticamente dal file TeamFoundation.xsl e dai file xsl WorkItemChangedEvent superiori. Non è consigliabile modificare il file TeamFoundation.xsl. Se si modifica il contenuto di questo file, è necessario eseguire un test accurato delle modifiche. Eventuali modifiche errate apportate a questo file possono comportare il mancato funzionamento degli avvisi di posta elettronica di Team Foundation e l'impossibilità di visualizzare gli elementi di lavoro, gli insiemi di modifiche o i file di Team Foundation in un browser Web.

Autorizzazioni necessarie

Per eseguire queste procedure, è necessario appartenere al gruppo di sicurezza Amministratori nel server a livello applicazione di Team Foundation.

Modificare il modello utilizzato per l'invio di avvisi mediante posta elettronica per le modifiche dell'elemento di lavoro

  1. Nel server a livello applicazione aprire la seguente cartella:

    Unità:\Programmi\Microsoft Visual Studio 2010 Team Foundation Server\Application Tier\TFSJobAgent\Transforms

  2. Aprire WorkItemChangedEvent.xsl nel Blocco note o in un altro editor di testo.

    Nota

    Anche se l'accesso è stato eseguito con autorizzazioni amministrative, è necessario aprire il Blocco note o un altro editor con privilegi amministrativi per eseguire questa funzione in un server che esegue Windows Server 2008. Per aprire Blocco note con privilegi amministrativi, fare clic su Start, fare clic con il pulsante destro del mouse su Prompt dei comandi e quindi fare clic su Esegui come amministratore. Per ulteriori informazioni, vedere il sito Web Microsoft: Controllo dell'account utente (la pagina potrebbe essere in inglese).

  3. Modificare il file per visualizzare il messaggio desiderato nella notifica di posta elettronica.

    Nota

    È necessario apportare le stesse modifiche a WorkItemChangedEvent.plaintextXsl per ogni utente che ha richiesto la ricezione di messaggi nel formato testo normale.

  4. Salvare il file WorkItemChangedEvent.xsl.

Vedere anche

Attività

Configurare le notifiche di posta elettronica e specificare il server SMTP

Altre risorse

Configurazione di risorse per il supporto di progetti team