Поделиться через


Команда "changeset"

Обновлен: Ноябрь 2007

Отображает сведения о наборе изменений и позволяет изменять соответствующие атрибуты, например комментарии и примечания при возврате.

Требуемые разрешения

Для использования команды changeset необходимо иметь разрешение Чтение со значением Разрешить для всех файлов или папок в наборе изменений, для которых нужно отобразить полную информацию. Изменять примечания и комментарии, связанные с набором изменений, могут только те пользователи, которые его создали, или пользователи, имеющие разрешение "Пересмотр изменений других пользователей". Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

tf changeset [/comment:comment|@commentfile] [/server:servername] 
[/notes:(“NoteFieldName”=”NoteFieldValue”|@notefile)] [/noprompt] 
[changesetnumber | /latest]

Параметры

Аргумент

Описание

comment

Предоставляет комментарий о возврате.

@commentfile

Задает путь к файлу на диске, содержащему комментарий для возврата.

servername

Предоставляемое пользователем значение параметра /server. Пример: "teamfoundation2".

NoteFieldName=NoteFieldValue

Устанавливает значение поля примечания при возврате. Можно указать несколько выражений "поле=значение", разделенных точкой с запятой.

@notefile

Предоставляет путь к файлу на диске, содержащему имена полей примечаний при возврате и значения в формате "поле=значение", расположенные по одному на строке.

changesetnumber

Определяет набор изменений для проверки или редактирования. Нельзя использовать вместе с параметром /latest.

Параметр

Описание

/comment

Заменяет комментарий набора изменений, созданный во время процесса возврата, новым комментарием.

/server

Определяет Team Foundation Server. Этот параметр является обязательным, если вызов команды осуществляется из каталога, который не сопоставлен рабочей области.

/notes

Предоставляет один или несколько примечаний при возврате для связи с набором изменений.

/latest

Указывает самый последний набор изменений. Нельзя использовать вместе с номер_набора_изменений.

/noprompt

Отключает отображение запросов на ввод данных пользователем.

Заметки

Набор изменений — это набор изменений файла или папки, которые были зафиксированы на сервере Team Foundation (подсистема контроля версий) в виде части одного события возврата. Дополнительные сведения см. в разделе Работа с наборами изменений системы управления версиями.

Команду changeset можно использовать для просмотра атрибутов набора изменений и для изменения его свойств. Для определения набора изменений, о котором требуется получить сведения, воспользуйтесь командой "history". Дополнительные сведения см. в разделе Команда "history".

Ссылки на другие команды Team Foundation, предоставляющие дополнительные сведения об элементах на сервере Team Foundation (подсистема контроля версий) и всех сопоставленных рабочих областях, см. в разделе Информационные команды.

Дополнительные сведения о поиске программы командной строки tf см. в разделе Команды служебной программы командной строки "tf".

Примеры

В следующем примере в диалоговом окне Набор изменений отображаются подробные сведения о наборе изменений 8675309 в редактируемом формате, а существующий комментарий заменяется текстом "This is a new comment".

После нажатия клавиши ВВОД открывается диалоговое окно Сведения для набора изменений<номер_набора_изменений>— исходные файлы. Нажмите кнопку Сохранить, чтобы связать комментарий с набором изменений.

c:\projects>tf changeset /comment:"This is a new comment." 8675309

В следующем примере показаны два примечания при возврате для связи с набором изменений.

c:\projects>tf changeset /notes:reviewer=Jo; Security = checked 8675309

В следующем примере показано два примечания при возврате, включающих пробелы в значениях и именах, для связи с набором изменений.

c:\projects>tf changeset /notes:"Code Reviewer"="John Smith";"Security Reviewer"="Chen Yang" 8675309

В следующем примере показано связывание примечаний при возврате, включенных в файл notes.txt с набором изменений 8675309.

c:\projects>tf changeset /notes:@notes.txt 8675309

Файл notes.txt может иметь следующий формат:

field1=value1;

field2=value that

spans multiple

lines;

field3 = value3;

В следующем приложении происходит замена существующего комментария для набора изменений 8675309 и отображение сведений о наборе изменений в окне командной строки. В примере диалоговое окно Набор изменений не открывается.

c:\projects>tf changeset /comment:”This is an automatically generated comment.” /noprompt 8675309

В следующем примере в окне командной строки отображаются нередактируемые сведения о наборе изменений 8675309.

c:\projects>tf changeset 8675309 /noprompt

Пример результатов выполнения

Changeset: 8675309
User: DOMAIN\JohnG
Date: 01/21/2004 21:03:45
Comment:  This check-in fixes issues in several features.  I also refactored some items in buf.c into a new file named bif.c because buf.c was too hard to parse.
Items:
   $/baz/proj/bif.c           Added
   $/baz/proj/buf.c          Modified, Renamed
Work Items:
   34527     The "Access Denied" message is not descriptive enough.
   35628     The UI flickers when I press the '8', 'y', 'Ctrl', and 'End' buttons at the same time.
Check-in Notes:
   Code Reviewer:  ShellM
   Performance Reviewer: ShellM
   Security Reviewer: ShellM

См. также

Основные понятия

Работа с наборами изменений системы управления версиями

Ссылки

Команда "checkin"

Команды "checkout" и "edit"

Команда "shelve"

Команда "history"

Команда "configure"

Другие ресурсы

Команды служебной программы командной строки "tf"