Использование меток для создания снимков файлов
Метки позволяют сделать снимок файлов, что позволяет позднее вернуться к работе с ним. С помощью метки можно выполнять просмотр, построение и даже откат большого набора файлов до состояния, в котором они были на момент применения метки.
Необходимые разрешения
Для применения метки необходимо разрешение Метка со значением Разрешить. Для поиска, отображения в списке и просмотра меток необходимо разрешение Чтение со значением Разрешить. Для изменения или удаления метки необходимо быть ее владельцем или иметь разрешение Администрирование меток со значением Разрешить.
Содержание этой статьи
Использование меток
Применение метки
Переименование метки
Отображение в списке, поиск, просмотр, редактирование и удаление меток
Загрузка помеченных версий файлов в рабочую область
Работа с метками в окне "Метка"
Откат файлов до помеченной версии
Работа с метками в командной строке
Использование меток
Во многих проектах разработки программного обеспечения, когда код достигает достаточного уровня качества и стабильности, группа создает и выпускает новую версию продукта. Разработчикам требуется пометить текущую версию каждого файла, так что даже при дальнейших изменениях файлов группа по-прежнему сможет получить и построить новую версию каждого файла в проекте.
Теоретически можно записать идентификатор каждого набора изменений для каждого файла от руки, но процесс такого рода, очевидно, непрактичен. Team Foundation (подсистема контроля версий) упрощает эту работу: достаточно применить метку к папке, ветви или групповому проекту, в которых содержатся файлы. Метке можно присвоить имя в соответствии с любым предпочтительным соглашением об именовании. Например: "Sprint 5", "M1", "Beta2" и "Release Candidate 0".
После применения метки ее можно использовать в качестве квалификатора таких операций, как построение, ветвление, слияние, сравнение и получение конкретных версий файлов и папок.
Порой после применения метки может потребоваться изменить ее. Team Foundation (подсистема контроля версий) позволяет применить метку к дополнительным файлам, удалить метку из определенных файлов и даже изменить версию конкретного файла, к которой относится метка.
Совет
Применение метки дает те же многочисленные преимущества, что и создание ветви, но, как правило, с меньшими затратами и сложностями.
Применение метки
Процедура применения метки
В обозревателе управления исходным кодом щелкните правой кнопкой мыши коллекцию, групповой проект, ветвь, папку или файл, которые требуется пометить, и выберите команду Применить метку.
Откроется диалоговое окно Создание метки.
В поле Имя введите имя для метки.
(Необязательно.) В поле Примечание введите свои комментарии.
В списке Версия по умолчанию выбирается вариант Последняя версия. Этот вариант используется чаще всего, но, если требуется связать метку с конкретной версией, можно выбрать один из следующих вариантов.
Если выбрать пункт Набор изменений, то в поле Набор изменений можно указать номер набора изменений. Или же можно нажать кнопку с многоточием (...), чтобы открыть диалоговое окно Поиск наборов изменений. Дополнительные сведения см. в разделе Поиск данных о наборе изменений.
Если выбрать пункт Дата, то в поле Дата можно ввести дату или выбрать ее с помощью календаря в раскрывающемся меню.
Если выбрать пункт Метка, то можно указать существующую метку, на которой будет основываться новая. Введите имя метки в поле Метка или нажмите кнопку с многоточием (…), чтобы открыть диалоговое окно Поиск метки. Дополнительные сведения см. в подразделе Поиск, редактирование и удаление меток.
Если выбрать пункт Версия рабочей области, то метка будет создана для версии, хранящейся в рабочей области.
Завершив настройку параметров, выполните одно из следующих действий.
Чтобы применить метку, нажмите кнопку Создать.
Чтобы применить метку и изменить ее после этого, нажмите кнопку Создать и изменить. В этом случае после применения метки откроется окно Метка. Дополнительные сведения об использовании окна Метка для редактирования метки см. в разделе Работа с метками в окне "Метка".
Примечание
При применении метки с использованием уже существующего имени система выводит предупреждение и запрос, уточняющий, следует ли продолжать.Если нажать кнопку ОК, чтобы продолжить, то все элементы, не находящиеся в пути, к которому применяется метка, больше не будут иметь эту метку.
Переименование метки
Изменить имя существующей метки нельзя, однако можно легко применить новую метку к тем же файлам и версиям, к которым относится другая метка.
Применение метки, основанной на существующей метке
В обозревателе управления исходным кодом щелкните правой кнопкой мыши узел коллекции проектов (корневой узел) и выберите команду Применить метку.
Откроется диалоговое окно Создание метки.
В поле Имя введите имя для метки.
(Необязательно.) В поле Примечание введите комментарий.
В списке Версия выберите пункт Метка.
На экране появится поле Метка.
Выполните одно из следующих действий.
Введите имя существующей метки.
Если нет уверенности относительно имени существующей метки, нажмите кнопку обзора с многоточием (…) рядом с полем Метка.
Будет открыто диалоговое окно Поиск метки.
С помощью параметров в диалоговом окне Поиск метки отфильтруйте список меток и найдите существующую метку, вместо которой требуется применить новую метку. (дополнительные сведения см. в подразделе Поиск, редактирование и удаление меток).
Нажмите Создать.
(Необязательно.) После создания новой метки можно удалить старую. Дополнительные сведения см. в подразделе Поиск, редактирование и удаление меток.
Отображение в списке, поиск, просмотр, редактирование и удаление меток
Существует два способа поиска и отображения меток в списке: в диалоговом окне Поиск метки и на вкладке Метки в окне Журнал. Найдя интересующую его метку, пользователь может просмотреть, отредактировать и удалить ее либо работать с файлами, к которым она относится.
Процедура поиска меток и работы с ними в диалоговом окне "Поиск метки"
В обозревателе управления исходным кодом в меню Файл последовательно выберите пункты Система управления версиями, Метка и Найти метку.
Будет открыто диалоговое окно Поиск метки.
(Необязательно.) Уточните условия поиска, выполнив одно или несколько из следующих действий.
В текстовом поле Имя введите имя метки.
В списке Проект выберите групповой проект, содержащий метку, которую требуется найти.
В текстовом поле Владелец введите имя или псевдоним владельца метки.
Нажмите кнопку Найти.
В списке Результаты отображаются метки, удовлетворяющие заданным условиям поиска.
(Необязательно.) Выполните одно из следующих действий.
Для просмотра или редактирования метки выберите нужную метку и нажмите кнопку Изменить.
Откроется окно Метка. Дополнительные сведения см. в подразделе Работа с метками в окне "Метка".
Для удаления метки выберите нужную метку и нажмите кнопку Удалить.
Нажмите кнопку Закрыть.
Порой не удается вспомнить имя метки, однако известно, что эта метка была применена к конкретному элементу в системе контроля версий. Следующая процедура описывает, как найти метку и затем работать с ней в этой ситуации.
Отображение в списке меток, относящихся к конкретному элементу, и работа с ними
В обозревателе решений щелкните правой кнопкой мыши элемент, метку которого требуется найти, и выберите команду Просмотреть журнал.
Откроется окно Журнал.
Чтобы отобразить список меток, относящихся к этому элементу, перейдите на вкладку Метки.
(Необязательно.) Выполните одно из следующих действий.
Для просмотра или редактирования метки щелкните ее правой кнопкой мыши и выберите команду Изменить метку.
Откроется окно "Метка". Дополнительные сведения об использовании этого окна см. в подразделе Работа с метками в окне "Метка".
Для удаления метки щелкните ее правой кнопкой мыши и выберите команду Удалить метку.
Щелкните метку правой кнопкой мыши и выберите другие действия, например Получить эту версию и Сравнить.
Дополнительные сведения об использовании вкладки "Метки" в окне "Журнал" см. в разделе Просмотр исторических данных.
Загрузка помеченных версий файлов в рабочую область
Применение метки к набору файлов подобно снимку состояния, в котором они существовали в определенный момент времени. Недели или месяцы спустя может понадобиться просмотреть файлы или работать с ними в том состоянии, в котором они существовали на этом снимке. Следующая процедура описывает, как загрузить помеченные версии набора файлов в рабочую область.
Загрузка помеченных версий файлов в рабочую область
В обозревателе управления исходным кодом щелкните правой кнопкой мыши коллекцию проектов, групповой проект, ветвь или папку, содержащие элементы, которые требуется загрузить, и выберите команду Получить конкретную версию.
Будет отрыто диалоговое окно Получить.
В списке Тип выберите пункт Метка и введите имя метки в поле Метки либо нажмите кнопку с многоточием (…), чтобы открыть диалоговое окно Поиск метки. Дополнительные сведения об использовании этого диалогового окна см. в подразделе Поиск, редактирование и удаление меток.
В диалоговом окне Получение просмотрите и, если требуется, выберите любые дополнительные параметры.
Нажмите кнопку Получить.
Работа с метками в окне "Метка"
Когда окно "Метка" будет открыто посредством одной из приведенных выше процедур, можно приступать к работе с меткой. В верхней части окна находится поле, в котором отображается примечание. При желании его можно изменить.
В окне "Метка" можно выполнять следующие операции:
добавить элемент в число помеченных;
удалить элемент из числа помеченных;
изменить версию файла;
применить к элементу другие действия.
Процедура добавления элемента в число помеченных
В окне Метка нажмите кнопку Добавить элемент.
Будет открыто диалоговое окно Выбор версии элемента.
В диалоговом окне Выбор версии элемента перейдите к элементу, который требуется добавить, и выберите его.
Совет
Для выбора нескольких элементов нажмите и удерживайте клавишу CONTROL или SHIFT.
(Необязательно.) Если требуется связать метку с конкретной версией, в списке Версия можно выбрать один из следующих вариантов.
Если выбрать пункт Последняя версия, метка будет применена к последней версии, имеющейся в системе управления версиями.
Если выбрать пункт Набор изменений, то в поле Набор изменений можно указать номер набора изменений. Или же можно нажать кнопку с многоточием (...), чтобы открыть диалоговое окно Поиск наборов изменений. Дополнительные сведения см. в разделе Поиск данных о наборе изменений.
Если выбрать пункт Дата, то в поле Дата можно ввести дату или выбрать ее с помощью календаря в раскрывающемся меню.
Если выбрать пункт Метка, то можно указать существующую метку, на которой будет основываться новая. Введите имя метки в поле Метка или нажмите кнопку с многоточием (…), чтобы открыть диалоговое окно Поиск метки. Дополнительные сведения см. в подразделе Поиск, редактирование и удаление меток.
Если выбрать пункт Версия рабочей области, то метка будет создана для версии, хранящейся в рабочей области.
Нажмите кнопку ОК.
Откройте меню Файл и выберите команду Сохранить.
Процедура удаления элемента из числа помеченных
В окне Метка найдите коллекцию, групповой проект, ветвь, папку или файл, которые требуется удалить из числа помеченных.
Щелкните элемент правой кнопкой мыши и выберите команду Удалить из помеченных.
Из элемента удаляется метка. Если элемент — коллекция проектов, групповой проект, ветвь или папка, то метка также удаляется из всех элементов, в них содержащихся.
Откройте меню Файл и выберите команду Сохранить.
Процедура изменения версии файла
В окне Метка найдите файл, который требуется изменить.
Щелкните файл правой кнопкой мыши и выберите команду Изменить версию элемента.
Будет открыто диалоговое окно Выбор версии элемента.
Выполните одно из следующих действий.
Выберите пункт Последняя версия, чтобы применить метку к последней версии, имеющейся в системе управления версиями.
Выберите пункт Набор изменений и затем в поле Набор изменений укажите номер набора изменений. Или же можно нажать кнопку с многоточием (...), чтобы открыть диалоговое окно Поиск наборов изменений. Дополнительные сведения см. в разделе Поиск данных о наборе изменений.
Выберите пункт Дата и затем в поле Дата укажите дату или выберите ее с помощью календаря в раскрывающемся меню.
Выберите пункт Метка и затем укажите существующую метку, на которой будет основываться новая. Введите имя метки в поле Метка или нажмите кнопку с многоточием (…), чтобы открыть диалоговое окно Поиск метки. Дополнительные сведения см. в подразделе Поиск, редактирование и удаление меток.
Выберите пункт Версия рабочей области, и метка будет создана для версии, хранящейся в рабочей области.
Откройте меню Файл и выберите команду Сохранить.
Процедура применения к элементу других действий
Щелкнув правой кнопкой мыши элемент в окне "Метка", можно также выбрать одну из следующих команд.
Просмотреть (только файлы)
Просмотреть журнал
Сравнить (только файлы)
Заметки (только файлы)
Получить эту версию
Откат файлов до помеченной версии
Команда tf rollback позволяет вернуть набор файлов в состояние, в котором они существовали в помеченных версиях. Дополнительные сведения см. в разделе Команда rollback (управление версиями в Team Foundation).
Работа с метками в командной строке
В этом подразделе описываются некоторые из типичных способов работы с метками в командной строке.
Отображение списка меток в командной строке
Процедура отображения списка меток в командной строке
Нажмите кнопку Пуск, последовательно выберите пункты Все программы, Microsoft Visual Studio 2010, Средства Visual Studio, а затем — Командная строка Visual Studio (2010).
Введите команду cd путь, где путь — это путь к каталогу, содержащему необходимую рабочую область.
Введите tf labels.
Применение и редактирование метки в командной строке
Применение метки в командной строке приводит к иному результату, нежели та же операция в Visual Studio ALM (как описано ранее в этом разделе). При применении в Visual Studio ALM уже существующей метки она удаляется из всех версий файлов, а затем применяется снова.
Операция применения метки в командной строке имеет аддитивный характер. Предположим, что метка "mylabel" применяется к $/DinnerNow/Features/FeatureTeamA. Если позднее применить "mylabel" к $/DinnerNow/Features/FeatureTeamB, то метка будет связана с обеими папками.
Применение метки с помощью командной строки
Нажмите кнопку Пуск, последовательно выберите пункты Все программы, Microsoft Visual Studio 2010, Средства Visual Studio, а затем — Командная строка Visual Studio (2010).
Введите команду cd путь, где путь — это путь к папке, которую требуется пометить.
Введите tf label mylabel . /recursive.
Система применит метку "mylabel" к хранящейся в рабочей области версии папки, на которую указывает путь, и ко всем файлам и папкам, содержащимся в этой папке.
Удаление метки в командной строке
Удаление метки с помощью командной строки
Нажмите кнопку Пуск, последовательно выберите пункты Все программы, Microsoft Visual Studio 2010, Средства Visual Studio, а затем — Командная строка Visual Studio (2010).
Введите команду cd путь, где путь — это путь к каталогу, содержащему необходимую рабочую область.
Введите команду tf label /delete имя метки, где имя метки — это имя метки, которую требуется удалить.
См. также
Ссылки
Команда Label (управление версиями в Team Foundation)
Основные понятия
Создание рабочей области для работы с командным проектом
Разрешения Team Foundation Server
Использование обозревателя управления исходным кодом