Reporting Work Item Revisions
Questa API consente di accedere a tutte le revisioni degli elementi di lavoro nel progetto o nella raccolta e consente di compilare un magazzino.
La risposta dell'API contiene un batch di revisioni degli elementi di lavoro("valori"), un URL per il batch successivo di revisioni degli elementi di lavoro("nextLink") e un valore booleano che indica se sono state lette tutte le revisioni degli elementi di lavoro attualmente disponibili("isLastBatch").
Il flusso di lavoro per la compilazione del magazzino è il seguente:
- Effettuare una richiesta all'API senza fornire un parametro continuationToken
- Elaborare le revisioni degli elementi di lavoro restituite dall'API
- Rendere persistente "nextLink" e selezionare "isLastBatch"
- Se "isLastBatch" è true, sospendere per un periodo di tempo (varia a seconda della latenza di destinazione)
- Effettuare la richiesta successiva usando l'URL di "nextLink"
- Andare al passaggio 2
Nota
I risultati di questa API sono interessati quando si usano le funzionalità Sposta elemento di lavoro e/o Cambia tipo di elemento di lavoro insieme a "project" nell'URL e/o nei "tipi" nella stringa di query.
- Le richieste con ambito progetto restituiranno solo revisioni degli elementi di lavoro dal progetto specificato.
- Le richieste con ambito tipi restituiranno solo revisioni degli elementi di lavoro dei tipi specificati
Progetti di esempio
Operations
| Read Reporting Revisions Get |
Ottenere un batch di revisioni degli elementi di lavoro con l'opzione di inclusione degli elementi eliminati |
| Read Reporting Revisions Post |
Ottenere un batch di revisioni degli elementi di lavoro. Questa richiesta può essere usata se l'elenco di campi è sufficientemente grande da poter eseguire l'URL oltre il limite di lunghezza. |