Comando Checkin

Archiviare le modifiche in sospeso ai file o alle cartelle sul server.

Quasi ogni modifica apportata ai file nel computer di sviluppo viene archiviata nell'area di lavoro come modifica in sospeso finché non viene archiviata. Quando si archiviano le modifiche, vengono memorizzate come insieme di modifiche sul server. Sebbene il comando Checkin fornisca un'interfaccia utente diversa da Visual Studio (vedere Archiviare il proprio lavoro nel codebase del team), il processo è fondamentalmente lo stesso.

Requisiti: vedere Riferimento alle 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] [/force] [/noautoresolve]  [/login:username,[password]] [/new]

tf checkin /shelveset:shelvesetname[;shelvesetowner] [/bypass] [/noprompt] [/login:username,[password]] [/collection:TeamProjectCollectionUrl][/author:author name] [/force]

Parametri

Parametro	Descrizione
/author:author name	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. Vedere Riferimento alle autorizzazioni per Team Foundation Server
/bypass	Consente di ignorare un requisito di archiviazione gestita. Per ulteriori informazioni, vedere Archiviare modifiche in sospeso controllate da una compilazione di archiviazione gestita.
/collection:TeamProjectCollectionUrl	Se si utilizza l'opzione /shelveset, l'opzione /collection specifica l'url della raccolta di progetti team che contiene lo shelveset. Ad esempio: http://myserver:8080/tfs/DefaultCollection. Per impostazione predefinita, si presuppone che la raccolta di progetti team sia l'unica che contiene l'area di lavoro mappata alla directory corrente.
/comment	Associa un commento all'insieme di modifiche utilizzando uno dei seguenti argomenti: Comment: Commento, fornito dall'utente, sull'archiviazione. @comment file: Il percorso di un file su disco contenente il commento utilizzato per l'archiviazione.
/force	Forza un'archiviazione degli elementi con modifiche in sospeso anche se non sono presenti modifiche del contenuto del file.
itemspec	Specifica l'ambito degli elementi per archiviarli dall'area di lavoro dell'utente. È possibile specificare più di un argomento Itemspec. Per la sintassi, vedere Riferimenti ai comandi del controllo della versione di Team Foundation.
/login:username,[password]	Specifica l'account utente per l'esecuzione del comando. Vedere Riferimenti ai comandi del controllo della versione di Team Foundation.
/new	Lo stato selezionato di ogni modifica in sospeso (come illustrato nella finestra di dialogo Archivia ), il commento associato agli elementi di lavoro, le note di archiviazione ed il motivo di esecuzione dell'override dei criteri di archiviazione, sono archiviati nel computer dello sviluppatore come modifiche in sospeso finché non saranno archiviate. L'opzione /new cancella questi metadati di archiviazione prima dell'archiviazione. Questa opzione ed il comportamento di modifica non ha effetto quando si utilizza l'opzione /noprompt.
/noautoresolve	Come impostazione predefinita, il sistema tenta automaticamente di applicare Risolvi tutti automaticamente (vedere Risolvere conflitti di controllo della versione di Team Foundation). È possibile specificare l'opzione per disabilitare questo comportamento predefinito.
/noprompt	Evita la visualizzazione delle finestre e delle finestre di dialogo (come ad esempio la finestra di dialogo Archivia ) e reindirizza i dati di output al prompt dei comandi. Vedere Riferimenti ai comandi del controllo della versione di Team Foundation.
/notes	Fornisce uno o più note di archiviazione da associare all'insieme di modifiche utilizzando uno dei seguenti argomenti: 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 un punto e virgola può estendersi su più righe, ad esempio: campo1=valore1; campo2=prima riga del valore2 seconda riga del valore2; campo3=valore3;
/override	Esegue l'override dei criteri di archiviazione utilizzando uno dei seguenti argomenti: reason: Una ragione fornita dall'utente, del motivo per il quale i criteri di archiviazione verranno ignorati. Reasonfile: Il percorso di un file contenente una descrizione fornita dall'utente della ragione per cui i criteri di archiviazione vengono trascurati.
/recursive	In modo ricorsivo archivia gli elementi nella directory specificata e in tutte le sottodirectory.
/saved	Ignora questo parametro.
/shelveset:shelvesetname[;owner]	Specifica uno shelveset per l'archiviazione. L'argomento owner facoltativo viene utilizzato per specificare uno shelveset di cui l'utente corrente non è proprietario. Nota Dopo aver archiviato lo shelveset, il sistema lo elimina.
/validate	Verificare se l'archiviazione riuscirebbe senza archiviare i file. Il sistema valuta i criteri di archiviazione, le note di archiviazione ed elenca i conflitti. Nota Se non si specifica l'opzione /noprompt, è necessario scegliere il pulsante Archivia nella finestra di dialogo Archivia per convalidare l'archiviazione.Dopo avere scelto questo pulsante, il sistema non archivia i file.

Esempi

Archiviare le modifiche in sospeso nell'area di lavoro corrente

c:\code\SiteApp\Main>tf checkin

Visualizzare la finestra di dialogo Archivia, che visualizza tutte le modifiche in sospeso nell'area di lavoro corrente. È possibile utilizzare la finestra di dialogo Archivia per selezionare o deselezionare le modifiche in sospeso che si desidera archiviare, per aggiungere un commento, per associare gli elementi di lavoro e per eseguire altre attività, quindi selezionare il pulsante Archivia quando si è pronti per continuare.

Archiviare le modifiche in sospeso con un commento

c:\code\SiteApp\Main>tf checkin /comment:"Re-implemented Pi calculator"

Archiviare le modifiche in sospeso nell'area di lavoro corrente e fornire un commento ai colleghi del team che spieghi lo scopo delle modifiche.

Archiviare una modifica di un singolo elemento senza utilizzare la finestra di dialogo di archiviazione

c:\code\SiteApp\Main>tf checkin program.cs /noprompt

Archiviare le modifiche in sospeso in program.cs. La finestra di dialogo Archivia non viene visualizzata e se qualche conflitto blocca l'archiviazione, il sistema non mostra la finestra dei conflitti.

Utilizzo di Visual Studio

• Archiviare il proprio lavoro nel codebase del team Utilizzare Visual Studio per archiviare le modifiche al server.

Suggerimenti

• Per invalidare i cambiamenti (ed eventualmente se è necessario pulire l'area di lavoro per un'altra attività), utilizzare Comando Shelve.

• Se qualche conflitto blocca l'archiviazione, è possibile utilizzare Resolve Command per risolverli.

• Se un computer e un account utente non presentano un'area di lavoro mappata alla raccolta di progetti team che contiene lo shelveset, è possibile utilizzare /shelveset e le opzioni /collection per archiviare uno shelveset.