Connettere Azure Boards a Excel (legacy)

servizi Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Important

Il componente aggiuntivo per l'integrazione di Office Azure DevOps non è più supportato e potrebbe non funzionare con le versioni correnti di Office o browser. Microsoft non fornisce aggiornamenti o correzioni per questo componente aggiuntivo. Per le operazioni degli elementi di lavoro in blocco, usare la funzionalità importazione/esportazione CSV, che è l'approccio consigliato e supportato.

Note

Questo articolo riguarda il componente aggiuntivo precedente per l'integrazione di Azure DevOps con Office. Per i nuovi flussi di lavoro in blocco, usare l'importazione/esportazione CSV o la modifica bulk degli elementi di lavoro nel portale Web. I passaggi seguenti sono destinati ai team che si basano ancora su flussi di lavoro basati su Excel.

Per supportare i processi legacy di monitoraggio del lavoro, è possibile usare Microsoft Excel per aggiungere o aggiornare gli elementi di lavoro. È possibile lavorare in modalità online (connessa a Azure Boards o Azure DevOps Server) o in modalità offline (su una copia locale del documento).

Tip

È possibile usare l'intelligenza artificiale per facilitare questa attività più avanti in questo articolo, oppure vedere Abilitare l'assistenza AI con Azure DevOps MCP Server per iniziare.

Client di Office supportati e versioni di Azure DevOps

Nella tabella seguente viene illustrato il supporto client di Office per versione Azure DevOps/Visual Studio.

macOS non è supportato. Anche se è stato installato Visual Studio per Mac, la connessione a Azure DevOps da Excel o da qualsiasi altro client di Office non è supportata.

versione Azure DevOps/Visual Studio Excel integrazione del progetto Creazione di storyboard in PowerPoint Note
Servizi Azure DevOps
Azure DevOps Server 2020
Visual Studio 2022
Visual Studio 2019
integrazione di Office 2019 Azure DevOps
✅ Supportato ❌ Non supportato ❌ Non supportato L'integrazione dei progetti e TFSFieldMapping sono deprecati. Il collegamento dall'interno di PowerPoint è deprecato, ma è comunque possibile aggiungere un collegamento Storyboard dall'interno di un elemento di lavoro.
Visual Studio 2017 (legacy) ✅ Supportato ✅ Supportato ✅ Supportato Solo supporto per sistemi legacy.

Prerequisites

Categoria Requisiti
Programma informatico - Microsoft Excel 2016 o versione successiva, incluse le versioni di Microsoft 365.
- Visual Studio o Azure DevOps Office Integration 2019 gratuito.
- Il plug-in di integrazione di Office per Azure DevOps (installato con Visual Studio o con Azure DevOps Office Integration 2019).
Scarica Azure DevOps Office Integration 2019 - Vai a Download di Visual Studio.
- Scorrere fino a Tutti i download.
- Espandi Altri strumenti, framework e pacchetti ridistribuibili.
- Trova Integrazione di Azure DevOps per Office 2019 e seleziona Scarica.
- Se non è possibile individuare il download o non si ha accesso, accedere con un account Microsoft o contattare l'amministratore.
Permissions - Accesso dei membri del progetto per connettersi a un progetto di Azure Boards.
Progetto - Un progetto di Azure Boards. Se non ne hai uno, vedi Creare un progetto.

Per informazioni sui requisiti di compatibilità, vedere Azure DevOps compatibilità del client.

Limitazioni e problemi noti

Il componente aggiuntivo di integrazione di Office Azure DevOps precede l'autenticazione Microsoft 365 moderna e Microsoft non la gestisce più attivamente. Si aspettano queste limitazioni:

  • Autenticazione moderna: L'accesso condizionale, l'autenticazione a più fattori e i criteri di conformità dei dispositivi possono bloccare l'accesso. Se l'accesso interattivo non riesce, accedere al client di Office con lo stesso account usato per Azure DevOps prima di aprire il foglio di lavoro.
  • Token di accesso personali (PAT): Alcuni scenari richiedono un token di accesso personale anziché l'accesso interattivo. I PAT sono credenziali di lunga durata, quindi evitali quando possibile. Usare Microsoft Entra token in cui è supportato. Se è necessario usare un PAT, vedi Usare i token di accesso personale.
  • Microsoft 365 (Web) e macOS: il componente aggiuntivo funziona solo in Office desktop in Windows. Excel per il web e Office per Mac non supportano questo componente aggiuntivo.
  • Agenti ospitati e automazione: Il componente aggiuntivo supporta solo l'uso interattivo. Non supporta scenari non presidiati o basati su pipeline. Usare invece l'API REST Azure DevOps.
  • Set di dati di grandi dimensioni: La pubblicazione o l'aggiornamento di migliaia di elementi di lavoro in un singolo foglio di lavoro può causare un timeout. Suddividi il lavoro in più fogli di lavoro oppure usa l'importazione/esportazione CSV.

Per le alternative supportate, vedere Modificare in blocco gli elementi di lavoro nel portale Web e Importare o aggiornare elementi di lavoro in blocco usando file CSV.

Pubblicare e aggiornare gli elementi di lavoro

Quando si lavora in Excel, si modifica una copia locale dei dati degli elementi di lavoro.

Usare queste azioni per rimanere sincronizzati:

  • Aggiorna scarica i valori più recenti da Azure Boards nel foglio di lavoro.
  • Pubblica carica le modifiche del foglio di lavoro in Azure Boards.

All'inizio, il foglio di lavoro e Azure Boards corrispondono. Nel corso del tempo, altri utenti o processi possono modificare gli stessi elementi di lavoro. Per evitare conflitti e modifiche non aggiornati, utilizzare questo ritmo:

  1. Aggiornare quando si apre il file.
  2. Apportare un piccolo set di modifiche.
  3. Pubblicare le modifiche.
  4. Aggiorna nuovamente, soprattutto durante le sessioni più lunghe.

Ripetere questo ciclo durante la sessione.

Azure DevOps ed Excel

Il diagramma seguente illustra la sincronizzazione bidirezionale tra Excel e Azure DevOps:

  • Excel pubblica le modifiche locali in Azure DevOps.
  • Excel si aggiorna per recuperare gli aggiornamenti lato server.

Diagramma che mostra il flusso di pubblicazione e aggiornamento bidirezionale tra Excel, Team Explorer e Azure DevOps.

Per il flusso di lavoro completo Excel, vedere Aggiungere elementi di lavoro in blocco con Excel.

Connettere un progetto Azure DevOps a Excel

Per aggiungere o modificare elementi di lavoro in Excel, connettere prima il foglio di lavoro a un progetto di Azure DevOps.

Note

  • Questa sezione illustra Excel passaggi per Azure Boards. PowerPoint usa un flusso di connessione simile.
  • In Azure DevOps Services, il portale seleziona automaticamente la Team Project Collection. In Azure DevOps Server selezionare la raccolta prima di selezionare il progetto.

Scegliere un percorso di connessione:

  • Portale Web
  • client di Excel (cloud)
  • Excel client (locale)
  • Visual Studio/Team Explorer

Il foglio di lavoro si collega come elenco di immissione (elenco manuale) o elenco di query (risultati di query salvati).

Questo metodo di connessione richiede l'estensione Azure DevOps Open in Excel Marketplace e Visual Studio 2017 o versione successiva.

  1. Nel browser, verifica che sia selezionato il progetto corretto, quindi vai a Boards>Queries>All.

    Schermata che mostra il menu Boards espanso con la voce Query evidenziata.

  2. Selezionare la query da aprire in Excel.

  3. Nella scheda Risultati selezionare l'icona azioni e quindi selezionare Apri in Excel.

    Schermata che mostra il menu contestuale dei risultati della query con il comando Apri in Excel evidenziato.

Tip

È possibile usare più fogli di lavoro all'interno di una cartella di lavoro di Excel per lavorare con elenchi di input o query diversi. È possibile connettersi a un solo progetto per cartella di lavoro.

Se si sposta il progetto Azure DevOps in una raccolta di progetti diversa nella stessa istanza di Azure DevOps Server, i documenti si riconnettono automaticamente. Se il progetto passa a un'istanza di Azure DevOps Server diversa, è necessario riconnettere manualmente i documenti al nuovo server.

Lavorare offline e riconnettersi a Azure Boards

È possibile lavorare offline in Excel per aggiungere o aggiornare gli elementi di lavoro, quindi riconnettersi e sincronizzarsi in un secondo momento.

Note

Se il progetto viene spostato in un'altra organizzazione di Azure DevOps o in un'istanza di Azure DevOps Server diversa, riconfigura la connessione del documento. Per la procedura, vedere Connettere Azure DevOps progetto a Excel.

Disconnettere un file di documento dalla rete

Prima di disconnettersi, preparare il foglio di lavoro:

  1. Aprire il documento da modificare offline.

  2. Ottenere gli aggiornamenti più recenti. Nella barra multifunzione Team Excel selezionare Aggiorna nel gruppo Elementi di lavoro.

  3. Aggiungere tutte le colonne che si prevede di modificare. Non è possibile aggiungere colonne dopo la disconnessione.

  4. Disconnettere il computer dalla rete o salvare il file dell'elenco degli elementi di lavoro e copiarlo in un altro computer.

    Office potrebbe visualizzare un errore di connessione dopo la disconnessione.

  5. Modificare o aggiornare l'elenco degli elementi di lavoro in base alle esigenze.

    Anche se offline, non è possibile creare la maggior parte dei tipi di collegamento tra gli elementi di lavoro. I collegamenti padre-figlio in un elenco ad albero di Excel sono l'eccezione.

Riconnettere un file a Azure Boards

Quando si torna online, risincronizzare il file:

  1. Riconnettere il computer alla rete o copiare il file in un computer connesso a Azure Boards.

  2. Se il file è stato modificato offline, in Excel, nella barra multifunzione Team selezionare Pubblica nel gruppo Elementi di lavoro.

  3. Se non sono state apportate modifiche offline, selezionare Aggiorna .

  4. Risolvere eventuali errori o conflitti di convalida.

Estensioni del Marketplace

Queste estensioni del Marketplace supportano scenari di integrazione Azure DevOps e Microsoft 365:

  • Azure DevOps Apri in Excel

    Apre i risultati delle query o gli elementi di lavoro selezionati in Excel dal portale web per la modifica e l'analisi in blocco.

    • Publisher: Microsoft DevLabs
    • Requisiti: Microsoft Excel e Visual Studio o il client di integrazione di Office Azure DevOps
    • Compatibilità: servizi Azure DevOps e Azure DevOps Server
  • Integrazione di Office 365

    Invia le notifiche del service hook di Azure DevOps, ad esempio per eventi di build, push del codice ed elementi di lavoro, alla posta in arrivo di un gruppo Microsoft 365.

    • Editore: Microsoft
    • Ambito: servizi Azure DevOps

    Note

    La pagina Marketplace indica che questa estensione è preinstallata con Visual Studio Team Services/Azure DevOps Services.

Usare l'intelligenza artificiale per lavorare con gli elementi di lavoro senza Excel

Se si configura il server MCP Azure DevOps, è possibile descrivere le attività comuni degli elementi di lavoro in linguaggio naturale, evitando le componente aggiuntivo di Excel legacy per molti scenari.

Sostituire i valori segnaposto prima di eseguire un prompt: <ProjectName>, <AreaPath>, <IterationPath>e <UserName>.

Attività Richiesta di esempio
Aggiungi elementi di lavoro in blocco Create 10 User Stories in project <ProjectName> under area path <AreaPath> in iteration <IterationPath>
Importare una gerarchia Create an Epic "Checkout revamp" in project <ProjectName> with 3 Features and 2 User Stories under each Feature
Aggiornare i valori dei campi Set Iteration Path to <IterationPath> for all active Tasks assigned to <UserName> in project <ProjectName>
Riassegnare il lavoro Reassign all active User Stories in area path <AreaPath> from <UserName> to <UserName>
Spostare gli elementi in uno sprint Move all uncommitted User Stories in project <ProjectName> from iteration <IterationPath> to iteration <IterationPath>
Aggiungi tag in blocco Add tag "release-2026" to all User Stories in iteration <IterationPath> in project <ProjectName>
Esegui query su elementi di lavoro Show all active unassigned Bugs in project <ProjectName>
Esportare un'istantanea List all resolved Bugs in project <ProjectName> from the last 30 days with Title, Assigned To, and Closed Date
Aggiorna i valori in blocco Set Priority to 2 for all active Bugs in area path <AreaPath> in project <ProjectName>
Modificare il tipo di elemento di lavoro Change all Issues tagged "convert-to-bug" to Bug in project <ProjectName>

Note

Se si usa Visual Studio Code, la modalità agente è particolarmente utile per le operazioni complesse degli elementi di lavoro.