Comando Checkin
Esegue il commit nel server per Controllo della versione di Team Foundation delle modifiche in sospeso nell'area di lavoro.
Autorizzazioni necessarie
Per utilizzare il comando checkin è necessario disporre dell'autorizzazione Archivia impostata su Consenti. Per utilizzare l'opzione /author è necessario avere l'autorizzazione Archivia modifiche di altri utenti impostata su Consenti. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.
tf checkin [/author:author name] [/comment:("comment"|@comment file)]
[/noprompt] [/notes:("Note Name"="note text"|@notefile)]
[/override:(reason|@reasonfile)] [/recursive] [/saved] [/validate] [itemspec] [/bypass] [/login:username,[password]]
tf checkin /shelveset:shelvesetname[;shelvesetowner] [/bypass] [/noprompt] [/login:username,[password]] [/collection:TeamProjectCollectionUrl][/author:author name] [/force]
Parametri
Argomento |
Oggetto di descrizione |
|---|---|
author name |
Valore fornito dall'utente per l'opzione /author. |
comment |
Commento, fornito dall'utente, sull'archiviazione. |
@comment file |
Percorso, fornito dall'utente, di un file su disco contenente il commento utilizzato per l'archiviazione. |
NoteFieldName=NoteFieldValue |
Imposta il valore del campo relativo alle note di archiviazione. È possibile specificare più espressioni "campo=valore" separate da punto e virgola. |
Notefile |
Percorso, fornito dall'utente, di un file su disco contenente i nomi e i valori dei campi relativi alle note di archiviazione in formato "campo=valore". Una nota separata da punto e virgola può occupare più righe, ad esempio: campo1=valore1; campo2=valore che si estende su più righe;. |
Filemotivo |
Descrizione, fornita dall'utente, del motivo per il quale i criteri di archiviazione verranno ignorati. Se si specifica un motivo, agli amministratori di Team Foundation verrà inviato un messaggio di posta elettronica in cui viene notificato l'override dei criteri e viene fornita una spiegazione. |
itemspec |
Specifica un file o una cartella da archiviare. Per ulteriori informazioni sul modo con cui Team Foundation esegue l'analisi sulla specifica di un file per determinare quali elementi sono compresi all'interno dell'ambito, vedere Opzioni della riga di comando. |
username |
Fornisce un valore all'opzione /login. È possibile specificare un valore username come DOMINIO\NomeUtente o NomeUtente. |
shelvesetname [:owner] |
Consente di identificare l'area di sospensione da archiviare. L'argomento owner facoltativo viene utilizzato per specificare un'area di sospensione di cui l'utente corrente non è proprietario. |
TeamProjectCollectionUrl |
URL dell'insieme di progetti team contenente i file o le cartelle che si desidera archiviare (ad esempio, http://myserver:8080/tfs/DefaultCollection). |
Opzione |
Oggetto di descrizione |
|---|---|
/author |
Identifica l'autore delle modifiche in sospeso, in modo da consentire a un utente di archiviare le modifiche per conto di un altro utente. Richiede l'autorizzazione CheckinOther. |
/comment |
Associa un commento all'insieme di modifiche. |
/noprompt |
Non vengono visualizzati prompt che richiedono l'input da parte dell'utente. |
/notes |
Fornisce una o più note di archiviazione da associare all'insieme di modifiche. |
/override |
Consente di eseguire l'override di un errore dei criteri di archiviazione. Questa opzione è necessaria solo quando sono disponibili criteri di archiviazione e si desidera eseguire ugualmente l'operazione di archiviazione. |
/recursive |
Archivia tutti gli elementi nella cartella di lavoro specificata o implicita e nelle relative sottocartelle. |
/saved |
Quando un'operazione di archiviazione non riesce o viene annullata dall'utente oppure quando l'utente riprende le modifiche, le eventuali modifiche, i commenti, gli elementi di lavoro, le note di archiviazione e il motivo di override dei criteri di archiviazione selezionati vengono archiviati nel computer. Se combinata con /noprompt, l'opzione /saved consente di archiviare le modifiche con il commento, ecc. e gli eventuali altri elementi salvati. |
/validate |
L'opzione /validate consente di testare l'archiviazione senza effettivamente eseguire l'operazione. Le opzioni /validate attivano la valutazione dei criteri di archiviazione, la verifica delle note di archiviazione e la ricerca di conflitti senza che venga eseguita un'effettiva archiviazione. Prima di archiviare l'elemento è necessario risolvere qualsiasi problema identificato da questa opzione, ad esempio i conflitti. |
/bypass |
Consente di ignorare un requisito di archiviazione gestita. Per ulteriori informazioni, vedere Archiviare modifiche in sospeso controllate da una compilazione di archiviazione gestita. |
/login |
Consente di specificare il nome utente e la password necessari per autenticare l'utente con Visual Studio Team Foundation Server. |
/shelveset |
Specifica l'area di sospensione per nome. |
/collection |
Specifica l'insieme di progetti team. |
Note
Una modifica in sospeso è costituita da un'operazione di aggiunta, eliminazione, ridenominazione, modifica, creazione di un ramo, annullamento dell'eliminazione, tipo file relativa a un file o a una cartella. Alcune modifiche, ad esempio la modifica e la ridenominazione, possono essere applicate contemporaneamente a un singolo elemento. Una modifica in sospeso è una modifica che non è stata inviata per l'archiviazione. Per ulteriori informazioni e un elenco completo delle modifiche in sospeso in Team Foundation, vedere Modifiche in sospeso.
Il comando checkin consente di creare nel server Controllo della versione di Team Foundation un insieme di modifiche da un set definito dinamicamente di modifiche in sospeso, elementi di lavoro, commenti definiti dall'utente e metadati di sistema e di rendere disponibili le modifiche ad altri utenti. Per recuperare le modifiche, gli altri utenti possono utilizzare il comando get. I comandi history e changeset consentono di visualizzare le informazioni sull'insieme di modifiche inviate.
Nota
Poiché è possibile archiviare le modifiche in sospeso dalla riga di comando, il menu di scelta rapida Esplora controllo codice sorgente potrebbe non riflettere sempre lo stato delle modifiche in sospeso.
Per ulteriori informazioni su come accedere all'utilità della riga di comando tf, vedere Comandi dell'utilità della riga di comando Tf.
Processo di archiviazione
L'operazione di archiviazione viene eseguita in modalità atomica, pertanto potrà avere solo esito completamente negativo o completamente positivo. Se non è possibile inviare al server Controllo della versione di Team Foundation una qualsiasi delle modifiche incluse nell'elenco delle modifiche in sospeso, non verrà eseguito il commit di nessuna modifica e non verrà creato nessun insieme di modifiche. Se ad esempio durante l'operazione la connettività di rete viene interrotta, l'intera operazione ha esito negativo.
Il primo passaggio del processo di archiviazione consiste nel valutare la conformità delle modifiche in sospeso ai criteri di archiviazione. Per eseguire l'override di errori di criteri di archiviazione dalla riga di comando, è possibile utilizzare l'opzione /override . In caso di override degli errori di criteri è necessario fornire una spiegazione. Questo motivo è persistente nel server Controllo della versione di Team Foundation e diventa un attributo dell'insieme di modifiche di cui viene eseguito il commit. L'opzione /override viene utilizzata principalmente negli script. Per ulteriori informazioni, vedere Sovrascrivere i criteri di archiviazione.
Se la versione di un elemento nell'elenco delle modifiche in sospeso differisce dall'ultima disponibile nel Controllo della versione di Team Foundation, in Team Foundation verrà chiesto di risolvere prima i conflitti tra la versione dell'utente e l'ultima versione disponibile nel server del Controllo della versione di Team Foundation. Se ad esempio è stata estratta la versione 4 del file stellar.cs e l'ultima versione disponibile nel server Controllo della versione di Team Foundation è la 6, verrà richiesto di risolvere i conflitti. A meno che non venga specificata l'opzione **/noprompt **, viene visualizzata la finestra di dialogo Risolvi che consente di individuare e risolvere le differenze di versione. Una volta risolte le differenze e rieseguito il test del codice, è possibile provare ad archiviare nuovamente le modifiche.
Esempi
L'esempio riportato di seguito consente di visualizzare la finestra di dialogo Archivia in cui sono state preselezionate modifiche in sospeso per un'operazione di archiviazione di massa di tutte le modifiche in sospeso disponibili nell'area di lavoro mappata a c:\projects. Se si fa clic su Archivia, ogni elemento viene inviato singolarmente a un insieme di modifiche nel server per Controllo della versione di Team Foundation e valutato per verificare che la versione del server sia invariata poiché l'elemento è stato estratto. Se l'operazione di archiviazione viene eseguita correttamente, in Team Foundation viene creato un insieme di modifiche e ne viene visualizzato il numero da utilizzare per riferimenti successivi.
c:\projects>tf checkin
L'esempio riportato di seguito consente di inviare al server Controllo della versione di Team Foundation tutte le modifiche in sospeso nell'area di lavoro unitamente al commento specificato per la creazione di un nuovo insieme di modifiche.
c:\projects>tf checkin /comment:"Re-implemented Pi calculator" /noprompt
L'esempio riportato di seguito consente di inviare le modifiche in sospeso apportate al file 314.cs e di lasciare in sospeso tutte le altre revisioni disponibili nell'area di lavoro corrente.
c:\projects>tf checkin 314.cs /noprompt
Vedere anche
Attività
Procedura dettagliata: personalizzazione dei criteri e delle note di archiviazione
Archiviare modifiche in sospeso
Riferimenti
Sintassi della riga di comando (controllo della versione)