Команда Changeset
Отображает сведения о наборе изменений и позволяет изменять соответствующие атрибуты, например комментарии и примечания при возврате.
Необходимые разрешения
Для использования команды changeset необходимо иметь разрешение Чтение со значением Разрешить для всех файлов или папок в наборе изменений, для которых нужно отобразить полную информацию. Изменять примечания и комментарии, связанные с набором изменений, могут только те пользователи, которые его создали, или пользователи, имеющие разрешение "Пересмотр изменений других пользователей". Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf changeset [/comment:("comment"|@commentfile)]
[/notes:("NoteFieldName"="NoteFieldValue"|@notefile)] [/noprompt][/collection:TeamProjectCollectionUrl]]
[changesetnumber | /latest][/login:username,[password]]
Параметры
Аргумент |
Описание |
|---|---|
comment |
Предоставляет комментарий о возврате. |
@commentfile |
Задает путь к файлу на диске, содержащему комментарий для возврата. |
NoteFieldName=NoteFieldValue |
Устанавливает значение поля примечания при возврате. Можно указать несколько выражений "поле=значение", разделенных точкой с запятой. |
@notefile |
Предоставляет путь к файлу на диске, содержащему имена полей примечаний при возврате и значения в формате "поле=значение", расположенные по одному на строке. |
TeamProjectCollectionUrl |
URL-адрес коллекции командных проектов, содержащей набор изменений, о котором необходимо отобразить данные, или атрибуты которого требуется изменить (например, http://myserver:8080/tfs/DefaultCollection). |
username |
Предоставляет значение для параметра /user. Можно задать этот аргумент как домен\имя_пользователя или как имя_пользователя. |
changesetnumber |
Определяет набор изменений для проверки или редактирования. Нельзя использовать вместе с параметром /latest. |
Параметр |
Описание |
|---|---|
/comment |
Заменяет комментарий набора изменений, созданный во время процесса возврата, новым комментарием. |
/notes |
Предоставляет один или несколько примечаний при возврате для связи с набором изменений. |
/latest |
Указывает самый последний набор изменений. Нельзя использовать вместе с номер_набора_изменений. |
/noprompt |
Отменяет отображение запросов на ввод данных пользователем. |
/collection |
Указывает коллекцию командных проектов. |
/login |
Задает имя пользователя и пароль для проверки подлинности пользователя с Visual Studio Team Foundation Server. |
Заметки
Набор изменений — это набор изменений файла или папки, которые были зафиксированы на сервере 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