Команда "checkin"
Обновлен: Ноябрь 2007
Переносит ожидающие изменения в текущей рабочей области на сервер Team Foundation (подсистема контроля версий).
Требуемые разрешения
Для использования команды checkin необходимо иметь разрешение Возврат со значением Разрешить. Для использования параметра /author необходимо иметь разрешение "Возврат изменений других пользователей" со значением Разрешить. Дополнительные сведения см. в разделе Разрешения 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]
Параметры
Аргумент |
Описание |
|---|---|
authorname |
Предоставляемое пользователем значение параметра /author. |
comment |
Предоставляемое пользователем примечание при возврате. |
@comment file |
Предоставляемый пользователем путь к файлу на диске, содержащему примечание при возврате. |
NoteFieldName=NoteFieldValue |
Устанавливает значение поля примечания при возврате. Можно указать несколько выражений "поле=значение", разделенных точкой с запятой. |
Notefile |
Предоставляемый пользователем путь к файлу на диске, содержащему имена полей примечаний при возврате и значения в формате "поле=значение". Пары, разделенные точкой с запятой, могут располагаться на нескольких строках, например. поле1=значение1; поле2=значение2 которое занимает несколько строк; |
файл_примечания |
Предоставляемое пользователем описание причины, по которой игнорируется политика возврата. При указании причины уведомление о переопределении политики и объяснение будет отправлено администраторам Team Foundation по электронной почте. |
itemspec |
Указывает файл или папку для возврата. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций файла, чтобы определить, какие элементы находятся в области его действия, см. в разделе Параметры командной строки. |
Параметр |
Описание |
|---|---|
/author |
Указывает автора заданных или предполагаемых ожидающих изменений, предоставляя пользователю возможность вернуть изменения от другого имени. Необходимо разрешение "CheckinOther". |
/comment |
Связывает примечание с набором изменений. |
/noprompt |
Отключает отображение запросов на ввод данных пользователем. |
/notes |
Предоставляет один или несколько примечаний при возврате для связи с набором изменений. |
/override |
Позволяет переопределить возврат при сбое политики безопасности. Параметр необходим для осуществления возврата, невзирая на наличие политики безопасности. |
/recursive |
Возвращает все элементы в указанной или предполагаемой рабочей папке и вложенных папках. |
/saved |
Если произошла ошибка возврата, пользователь отменил возврат или восстановил изменения из набора изменений, выбранные изменения, примечания при возврате, рабочие элементы и причина переопределения политики будут сохранены на компьютере. При использовании с параметром /noprompt параметр /saved выполняет возврат сохраненных изменений с примечанием, если таковые имеются. |
/validate |
Параметр /validate позволяет протестировать возврат без его фактического выполнения. Параметры /validate дают возможность проверить политики возврата, примечания при возврате и обнаружить конфликты. Все обнаруженные с помощью параметра проблемы, такие как конфликты, должны быть устранены до возврата элемента. |
Заметки
Ожидающие изменения включают добавление, удаление, переименование, изменение, разрешение разветвлений, восстановление файла или папки, а также тип файла. Некоторые изменения, такие как редактирование и переименование, могут быть применены одновременно к одному элементу. Ожидающие изменения — это изменения, которые не были отправлены для возврата. Дополнительные сведения об ожидающих изменениях и их полный список в Team Foundation см. в разделе Ожидающие изменения.
Команда checkin создает набор изменений на сервере Team Foundation (подсистема контроля версий) из динамически определяемого набора ожидающих изменений, рабочих элементов, предоставляемых пользователем примечаний, метаданных системы и делает изменения доступными для других пользователей. Для получения изменений другие пользователи могут использовать команду get. Команды history и changeset отображают сведения о наборе изменений для переданных изменений.
.gif "Примечание") Примечание. |
|---|
Поскольку ожидающие изменения можно вернуть с использованием командной строки, существует вероятность, что контекстное меню обозревателя системы управления версиями не всегда синхронизировано с состоянием отложенных изменений. |
Дополнительные сведения о поиске программы командной строки 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 (подсистема контроля версий), поскольку элемент был извлечен. В случае успешного возврата 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
См. также
Задачи
Пошаговое руководство. Управление версиями в Team Foundation с помощью командной строки
Пошаговое руководство. Настройка политик возврата и примечаний при возврате
Практическое руководство. Возврат ожидающих изменений
Основные понятия
Отправка изменений на сервер системы управления версиями
Ссылки
Синтаксис командной строки (Team System)