Comando Changeset
Aggiornamento: novembre 2007
Visualizza informazioni e consente di modificare gli attributi, ad esempio commenti e note di archiviazione associate a un insieme di modifiche.
Autorizzazioni necessarie
Per utilizzare il comando changeset è necessario disporre dell'autorizzazione Lettura impostata su Consenti per qualsiasi file o cartella nell'insieme di modifiche per il quale si desidera visualizzare informazioni complete. Le note e i commenti associati a un insieme di modifiche possono essere modificati solo dagli utenti che hanno creato l'insieme di modifiche o da un utente che dispone dell'autorizzazione globale Esamina modifiche di altri utenti. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.
tf changeset [/comment:comment|@commentfile] [/server:servername]
[/notes:(“NoteFieldName”=”NoteFieldValue”|@notefile)] [/noprompt]
[changesetnumber | /latest]
Parametri
Argomento |
Descrizione |
|---|---|
comment |
Fornisce un commento sull'archiviazione. |
@commentfile |
Indica un percorso di un file su disco contenente il commento utilizzato per l'archiviazione. |
servername |
Valore fornito dall'utente per l'opzione /server. Esempio: teamfoundation2. |
NoteFieldName=NoteFieldValue |
Imposta il valore del campo relativo alle note di archiviazione. È possibile specificare più espressioni "campo=valore" separate da punto e virgola. |
@notefile |
Fornisce il percorso di un file sul disco contenente i nomi e i valori dei campi relativi alle note di archiviazione in formato "campo=valore", specificati uno per riga. |
changesetnumber |
Identifica l'insieme di modifiche da rivedere o modificare. Non può essere utilizzato con l'opzione /latest. |
Opzione |
Descrizione |
|---|---|
/comment |
Sostituisce il commento dell'insieme di modifiche creato durante il processo di archiviazione con un nuovo commento. |
/server |
Identifica Team Foundation Server. Questa opzione è necessaria se il comando viene richiamato da una directory che non è mappata a un'area di lavoro. |
/notes |
Fornisce una o più note di archiviazione da associare all'insieme di modifiche. |
/latest |
Specifica l'insieme di modifiche più recente. Non può essere utilizzata con changesetnumber. |
/noprompt |
Non vengono visualizzati prompt che richiedono l'input da parte dell'utente. |
Note
Un insieme di modifiche è costituito da un insieme di revisioni di file e cartelle di cui è stato eseguito il commit nel server Controllo della versione di Team Foundation nel corso dello stesso evento di archiviazione. Per ulteriori informazioni, vedere Utilizzo degli insiemi di modifiche per il controllo della versione.
Utilizzare il comando changeset per visualizzare gli attributi di un insieme di modifiche e cambiarne le proprietà. Utilizzare il comando History per determinare l'insieme di modifiche su cui si desidera ottenere informazioni. Per ulteriori informazioni, vedere Comando History.
Per i collegamenti agli altri comandi di Team Foundation che forniscono ulteriori informazioni sugli elementi disponibili sul server Controllo della versione di Team Foundation e su tutte le aree di lavoro mappate ad esso, vedere Comandi di carattere informativo.
Per ulteriori informazioni su come accedere all'utilità della riga di comando tf, vedere Comandi dell'utilità della riga di comando Tf.
Esempi
L'esempio riportato di seguito consente di visualizzare informazioni dettagliate sull'insieme di modifiche 8675309 in un formato modificabile nella finestra di dialogo Insieme di modifiche e di sostituire il commento esistente con il commento "This is a new comment".
Una volta premuto INVIO, viene visualizzata la finestra di dialogo Dettagli per l'insieme di modifiche<numero insieme di modifiche>- File di origine. Scegliere Salva per associare il commento all'insieme di modifiche.
c:\projects>tf changeset /comment:"This is a new comment." 8675309
L'esempio riportato di seguito consente di fornire due note di archiviazione da associare all'insieme di modifiche.
c:\projects>tf changeset /notes:reviewer=Jo; Security = checked 8675309
L'esempio riportato di seguito consente di fornire due note di archiviazione da associare all'insieme di modifiche nei cui valori e nomi sono inclusi spazi.
c:\projects>tf changeset /notes:"Code Reviewer"="John Smith";"Security Reviewer"="Chen Yang" 8675309
L'esempio riportato di seguito consente di associare le note di archiviazione incluse nel file notes.txt all'insieme di modifiche 8675309.
c:\projects>tf changeset /notes:@notes.txt 8675309
Il formato del file notes.txt può essere il seguente:
field1=value1;
field2=value that
spans multiple
lines;
field3 = value3;
L'esempio seguente consente di sostituire il commento esistente per l'insieme di modifiche 8675309 e di visualizzare informazioni sull'insieme di modifiche nella finestra del prompt dei comandi. In questo esempio non viene avviata la finestra di dialogo Insieme di modifiche.
c:\projects>tf changeset /comment:”This is an automatically generated comment.” /noprompt 8675309
L'esempio riportato di seguito consente di visualizzare informazioni non modificabili sull'insieme di modifiche 8675309 nella finestra del prompt dei comandi.
c:\projects>tf changeset 8675309 /noprompt
Esempio di output:
Changeset: 8675309
User: DOMAIN\JohnG
Date: 01/21/2004 21:03:45
Comment: This check-in fixes issues in several features. I also refactored some items in buf.c into a new file named bif.c because buf.c was too hard to parse.
Items:
$/baz/proj/bif.c Added
$/baz/proj/buf.c Modified, Renamed
Work Items:
34527 The "Access Denied" message is not descriptive enough.
35628 The UI flickers when I press the '8', 'y', 'Ctrl', and 'End' buttons at the same time.
Check-in Notes:
Code Reviewer: ShellM
Performance Reviewer: ShellM
Security Reviewer: ShellM
Vedere anche
Concetti
Utilizzo degli insiemi di modifiche per il controllo della versione