Condividi tramite

Comando Checkin

  • Articolo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Il comando TFVC checkin controlla le modifiche apportate al server nel file e nella cartella in sospeso.

Quasi ogni modifica apportata ai file nel computer di sviluppo viene archiviata nell'area di lavoro come modifica in sospeso fino a quando non viene archiviata. Quando si archiviano le modifiche, queste vengono archiviate come un insieme di modifiche nel server. Il checkin comando fornisce un'interfaccia utente diversa per eseguire gli stessi processi documentati per Visual Studio in Archiviare il lavoro nella codebase del team.

Suggerimenti

  • Per riservare le modifiche o pulire l'area di lavoro per un'altra attività, usare il comando Shelve.

  • Se i conflitti bloccano l'archiviazione, è possibile usare il comando Risolvi per risolverli.

  • Se un computer e un account utente non hanno un'area di lavoro mappata alla raccolta di progetti che contiene gli scaffali, è possibile usare le /shelveset opzioni e /collection per archiviare un insieme di scaffali.

Prerequisiti

Sintassi

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 che un utente possa archiviare le modifiche per conto di un altro utente.

Richiede l'autorizzazione CheckinOther . Vedere Informazioni di riferimento su autorizzazioni e gruppi.

/bypass

Ignora un requisito di archiviazione controllato. Per altre informazioni, vedere Archiviare una cartella controllata da un processo di compilazione di archiviazione controllato.

/collection:<ProjectCollectionUrl>

Se si utilizza l'opzione shelveset , l'opzione /collection specifica l'URL della raccolta di progetti che contiene l'insieme di scaffali. Ad esempio: http://myserver:8080/tfs/DefaultCollection.

Per impostazione predefinita, si presuppone che la raccolta di progetti sia quella che contiene l'area di lavoro che esegue il mapping della directory corrente.

/comment

Associa un commento al set di modifiche utilizzando uno degli argomenti seguenti:

  • "<comment>": commento fornito dall'utente relativo all'archiviazione.
  • @<comment file>: percorso di un file su disco contenente il commento per l'archiviazione.

/force

Forza un'archiviazione sugli elementi con modifiche in sospeso anche quando non sono presenti modifiche al contenuto nel file.

<itemspec>

Specifica l'ambito degli elementi da archiviare dall'area di lavoro dell'utente. È possibile specificare più itemspec argomenti. Per la sintassi, vedere Usare i comandi di controllo della versione di Team Foundation.

/login:<username>[,<password>]

Specifica l'account utente per eseguire il comando. Vedere Usare i comandi di controllo della versione di Team Foundation.

/new

Stato selezionato di ogni modifica in sospeso, come illustrato nella finestra di dialogo Archiviazione . Il commento, gli elementi di lavoro associati, le note di archiviazione e il motivo dell'override dei criteri di archiviazione vengono archiviati nel computer di sviluppo come modifiche in sospeso fino a quando non vengono archiviate. L'opzione /new cancella i metadati di archiviazione prima di eseguire l'archiviazione. Questa opzione e il comportamento che modifica non hanno alcun effetto quando si usa l'opzione /noprompt .

/noautoresolve

Per impostazione predefinita, il sistema tenta automaticamente di conflitti AutoResolve All . Specificare questa opzione per disabilitare questo comportamento predefinito. Per altre informazioni, vedere Risolvere i conflitti di controllo della versione di Team Foundation.

/noprompt

Elimina la visualizzazione di finestre e finestre di dialogo, ad esempio la finestra di dialogo Archivia e reindirizza i dati di output al prompt dei comandi. Vedere Usare i comandi di controllo della versione di Team Foundation.

/notes

Fornisce una o più note di archiviazione da associare al set di modifiche utilizzando uno degli argomenti seguenti:

  • <NoteFieldName>=<NoteFieldValue>: imposta il valore del campo della nota di archiviazione. È possibile fornire più espressioni separate field=value da punto e virgola.
  • @<NoteFile>: percorso fornito dall'utente di un file su disco contenente i nomi e i valori dei campi delle note di archiviazione nel formato .field=value Un riquadro note delimitato da punto e virgola può estendersi su più righe, ad esempio:

    <Field1>=<Value1>;
    <Field2>=<First line of Value2>;
    <Second line of Value2>;
    <Field3>=<Value3>;

/override

Esegue l'override di un criterio di archiviazione usando uno degli argomenti seguenti:

  • reason: motivo per cui i criteri di archiviazione vengono ignorati dall'utente.
  • reasonfile: percorso di un file contenente una descrizione fornita dall'utente del motivo per cui il criterio di archiviazione viene ignorato.

/recursive

Verifica in modo ricorsivo gli elementi nella directory specificata ed eventuali sottodirectory.

/saved

Ignorare questo parametro.

/shelveset:<shelvesetname>[;<owner>]

Specifica un set di scaffali da archiviare. L'argomento facoltativo owner specifica un insieme di scaffali che l'utente corrente non è proprietario.

Nota

Dopo aver archiviato gli scaffali, il sistema lo elimina.

/validate

Verifica se l'archiviazione ha esito positivo, 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 selezionare il pulsante Archiviazione nella finestra di dialogo Archiviazione per convalidare l'archiviazione. Dopo aver selezionato questo pulsante, il sistema non archivia i file.

Esempi

Gli esempi seguenti presuppongono che c:\code\SiteApp\Main sia la cartella principale mappata alla raccolta di progetti nell'area di lavoro dell'utente.

Archiviare tutte le modifiche in sospeso nell'area di lavoro corrente

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

c:\code\SiteApp\Main>tf checkin

Archiviare tutte le modifiche in sospeso con un commento

L'esempio seguente controlla tutte le modifiche in sospeso nell'area di lavoro corrente e fornisce un commento per aiutare i colleghi a comprendere lo scopo delle modifiche.

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

Archiviare una modifica a un singolo elemento senza usare la finestra di dialogo Archiviazione

L'esempio seguente controlla le modifiche in sospeso per program.cs. La finestra di dialogo Archiviazione non viene visualizzata e, se si verificano conflitti, il sistema non visualizza la finestra dei conflitti.

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