Comando Checkin

Articolo
08/22/2007

Esegue il commit nel server Controllo del codice sorgente Team Foundation delle modifiche in sospeso nell'area di lavoro.

tf checkin [/author:author name] [/comment:("comment"|@comment file)] 
[/noprompt] [/notes:(“Note Name”=”note text”|@notefile)] 
[/override:reasonfile|@reason] [/recursive] [/saved] [/validate] 
[filespec]

Parametri

Argomento	Descrizione
authorname	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 il criterio di archiviazione verrà ignorato. 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.
Filespec	Indica un file o una cartella da archiviare. Per ulteriori informazioni sul tipo di analisi eseguito da Team Foundation su una specifica di file per determinare gli elementi all'interno dell'ambito, vedere Opzioni della riga di comando.

Opzione	Descrizione
/author	Identifica l'autore delle modifiche in sospeso specificate o implicite, 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 è disponibile un criterio 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	Questa opzione non accetta argomenti. 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 e gli eventuali altri elementi salvati.
/validate	L'opzione /validate consente di testare l'archiviazione senza effettivamente eseguire l'operazione. Durante l'utilizzo dell'opzione /validate vengono valutati i criteri di archiviazione, verificate le note di archiviazione e ricercati eventuali conflitti senza tuttavia eseguire effettivamente l'operazione di archiviazione. In tal modo è possibile risolvere eventuali problemi, ad esempio conflitti.

Note

Una modifica in sospeso è costituita da un'operazione di aggiunta, eliminazione, ridenominazione, modifica, diramazione, 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. Per modifica in sospeso si intende una modifica non ancora inviata per l'archiviazione. Per ulteriori informazioni e per un elenco completo delle modifiche in sospeso disponibili in Team Foundation, vedere Modifiche in sospeso.

Il comando checkin consente di creare nel server Controllo del codice sorgente Team Foundation un insieme di modifiche da un insieme 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 del codice sorgente potrebbe non essere sempre sincronizzato con lo stato delle modifiche in sospeso.

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 del codice sorgente 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 del codice sorgente 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 Procedura: eseguire l'override di un criterio di archiviazione.

Se la versione di base di un elemento nell'elenco delle modifiche in sospeso differisce dall'ultima disponibile nel Controllo del codice sorgente Team Foundation, in Team Foundation viene chiesto di risolvere dapprima i conflitti tra la versione dell'utente e l'ultima versione disponibile nel server Controllo del codice sorgente Team Foundation. Se ad esempio è stata estratta la versione 4 del file stellar.cs e l'ultima versione disponibile nel server Controllo del codice sorgente 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 in sospeso nel server Controllo del codice sorgente Team Foundation e valutato per verificare che la versione del server Controllo del codice sorgente Team Foundation è 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 del codice sorgente 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

Sicurezza

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.

Vedere anche

Condividi tramite

Comando Checkin

Parametri

Note

Processo di archiviazione

Esempi

Sicurezza

Vedere anche

Attività

Riferimenti

Concetti

Altre risorse

Risorse aggiuntive