Команда Checkin
Переносит ожидающие изменения в текущей рабочей области на сервер Team Foundation (подсистема контроля версий).
Необходимые разрешения
Для использования команды checkin необходимо иметь разрешение Возврат со значением Разрешить. Для использования параметра /author необходимо иметь разрешение "Возврат изменений других пользователей" со значением Разрешить. Дополнительные сведения см. в разделе Разрешения 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]
Параметры
Аргумент |
Описание |
|---|---|
author name |
Предоставляемое пользователем значение параметра /author. |
comment |
Предоставляемое пользователем примечание при возврате. |
@comment file |
Предоставляемый пользователем путь к файлу на диске, содержащему примечание при возврате. |
NoteFieldName=NoteFieldValue |
Устанавливает значение поля примечания при возврате. Можно указать несколько выражений "поле=значение", разделенных точкой с запятой. |
Notefile |
Предоставляемый пользователем путь к файлу на диске, содержащему имена полей примечаний при возврате и значения в формате "поле=значение". Пары, разделенные точкой с запятой, могут располагаться на нескольких строках, например. поле1=значение1; поле2=значение2 которое занимает несколько строк; |
файл_примечания |
Предоставляемое пользователем описание причины, по которой игнорируется политика возврата. При указании причины уведомление о переопределении политики и объяснение будет отправлено администраторам Team Foundation по электронной почте. |
itemspec |
Указывает файл или папку для возврата. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций файла, чтобы определить, какие элементы находятся в области его действия, см. в разделе Параметры командной строки. |
username |
Предоставляет значение для параметра /login. Можно задать значение для имени пользователя как ДОМЕН\имя_пользователя или как имя_пользователя. |
shelvesetname [:owner] |
Определяет набор отложенных изменений, которые требуется вернуть. Необязательный аргумент owner используется для указания набора отложенных изменений, не принадлежащего текущему пользователю. |
TeamProjectCollectionUrl |
URL-адрес коллекции командных проектов, содержащей файлы или папки, которую необходимо вернуть (например, http://myserver:8080/tfs/DefaultCollection). |
Параметр |
Описание |
|---|---|
/author |
Указывает автора ожидающих изменений, предоставляя пользователю возможность вернуть изменения от другого имени. Необходимо разрешение "CheckinOther". |
/comment |
Связывает примечание с набором изменений. |
/noprompt |
Отменяет отображение запросов на ввод данных пользователем. |
/notes |
Предоставляет один или несколько примечаний при возврате для связи с набором изменений. |
/override |
Позволяет переопределить возврат при сбое политики безопасности. Параметр необходим для осуществления возврата, невзирая на наличие политики безопасности. |
/recursive |
Возвращает все элементы в указанной или предполагаемой рабочей папке и вложенных папках. |
/saved |
Если произошла ошибка возврата, пользователь отменил возврат или восстановил изменения из набора изменений, выбранные изменения, примечания, рабочие элементы и причина переопределения политики возврата будут сохранены на компьютере. При использовании с параметром /noprompt параметр /saved выполняет возврат изменений с примечаниями и т. д. которые были сохранены, если таковые имеются. |
/validate |
Параметр /validate позволяет протестировать возврат без его фактического выполнения. При использовании параметра /validate проверяются политики и примечания при возврате, а также выполняется поиск конфликтов без фактического возврата. Любые проблемы, такие как конфликты, которые определяются данным параметром, должны разрешаться перед возвратом элемента. |
/bypass |
Пропускает требование условного возврата. Дополнительные сведения см. в разделе Возврат ожидающих изменений под управлением построения с условным возвратом. |
/login |
Задает имя пользователя и пароль для проверки подлинности пользователя с Visual Studio Team Foundation Server. |
/shelveset |
Указывает имя набора отложенных изменений. |
/collection |
Указывает коллекцию командных проектов. |
Заметки
Ожидающие изменения включают добавление, удаление, переименование, изменение, разрешение разветвлений, восстановление файла или папки, а также тип файла. Некоторые изменения, такие как редактирование и переименование, можно применить одновременно к одному элементу. Ожидающие изменения — это изменения, которые не были отправлены для возврата. Дополнительные сведения об ожидающих изменениях и их полный список в Team Foundation см. в разделе Ожидающие изменения.
Команда checkin создает набор изменений на сервере Team Foundation (подсистема контроля версий) из динамически определяемого набора ожидающих изменений, рабочих элементов, предоставляемых пользователем примечаний, метаданных системы и делает изменения доступными для других пользователей. Для получения изменений другие пользователи могут использовать команду get. Команды history и changeset отображают сведения о наборе изменений для переданных изменений.
Примечание
Поскольку ожидающие изменения можно вернуть с использованием командной строки, существует вероятность, что контекстное меню обозревателя управления исходным кодом не всегда отражает состояние отложенных изменений.
Дополнительные сведения о поиске программы командной строки tf см. в разделе Команды служебной программы командной строки "tf".
Процесс возврата
Операция возврата выполняется автоматически. Это означает, что она завершается успешно или дает сбой только целиком. Если любое из ожидающих изменений не может быть отправлено на сервер Team Foundation (подсистема контроля версий), ни одно из них не будет подтверждено и набор изменений не будет создан. Например, при разрыве подключения к сети в середине операции, она даст сбой целиком.
Первым шагом в операции возврата является проверка ожидающих изменений на соответствие политикам возврата. Для переопределения ошибок политики безопасности можно использовать параметр /override в командной строке. Необходимо указать причину переопределения ошибок политики. Причина будет сохранена на сервере Team Foundation (подсистема контроля версий) и станет атрибутом набора изменений. В основном параметр /override используется в скриптах. Дополнительные сведения см. в разделе Переопределение политики возврата.
Если версия элемента в списке ожидающих изменений отличается от последней версии сервера Team Foundation (подсистема контроля версий), Team Foundation предложит устранить конфликт между версией пользователя и последней версией сервера Team Foundation (подсистема контроля версий). Например, если для файла "stellar.cs" была извлечена версия 4, а последней версией сервера Team Foundation (подсистема контроля версий) является 6, пользователю будет предложено разрешить конфликт. Если не указан параметр **/noprompt **, откроется диалоговое окно Разрешение для изучения и устранения различий в версиях. После решения проблемы и повторного тестирования кода попробуйте выполнить возврат еще раз.
Примеры
В примере показано диалоговое окно Возврат с предварительно выбранными ожидающими изменениями для групповой проверки всех отложенных изменений в рабочей области, сопоставленной с "c:\projects". После нажатия на кнопку Вернуть каждый элемент будет отдельно передан в набор изменений сервера Team Foundation (подсистема контроля версий) и проверен на соответствие версии сервера, поскольку элемент был извлечен. В случае успешного возврата Team Foundation создаст набор изменений и отобразит номер для дальнейшего использования.
c:\projects>tf checkin
В следующем примере все ожидающие изменения в текущей рабочей передаются области на сервер Team Foundation (подсистема контроля версий) вместе с указанным примечанием для создания набора изменений.
c:\projects>tf checkin /comment:"Re-implemented Pi calculator" /noprompt
В следующем примере ожидающие изменения передаются в файл 314.cs, а все остальные изменения в рабочей области остаются в состоянии ожидания.
c:\projects>tf checkin 314.cs /noprompt
См. также
Задачи
Пошаговое руководство. Настройка политик возврата и примечаний при возврате
Ссылки
Синтаксис командной строки (управление версиями)