Comando Checkin
Aggiornamento: novembre 2007
Esegue il commit nel server 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:reasonfile|@reason] [/recursive] [/saved] [/validate]
[itemspec]
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. |
itemspec |
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 |
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. Gli eventuali problemi, quali conflitti, individuati mediante tale opzione devono essere risolti prima di archiviare l'elemento. |
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 della versione di 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.
.gif "Nota") 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. |
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 Procedura: eseguire l'override di un criterio 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 del Controllo della versione di Team Foundation e valutato per verificare che la versione del server del Controllo della versione di Team Foundation 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
Procedura: archiviare le modifiche in sospeso
Concetti
Invio delle modifiche al server del controllo della versione
Riferimenti
Sintassi della riga di comando (Team System)