Share via

Импорт и экспорт типов рабочих элементов и управление ими [witadmin]

  • Статья

Управлять типами рабочих элементов для командного проекта можно с помощью следующих команд witadmin.

  • Командаdestroywitd окончательно удаляет тип рабочего элемента и все рабочие элементы этого типа без возможности восстановления.

  • Команда exportwitd экспортирует определение типа рабочего элемента в XML-файл или окно командной строки.

  • Команда importwitd импортирует типы рабочих элементов из XML-файла определения в командный проект на сервере, на котором выполняется Team Foundation Server. Если рабочий элемент с таким именем уже существует, новое определение типа рабочего элемента перезаписывает существующий тип. Если тип рабочего элемента еще не существует, эта команда создает новый тип. Чтобы проверить XML-файл, определяющий тип рабочего элемента, не импортируя его, используется параметр /v.

  • Команда listwitd выводит имена типов рабочих элементов в указанном проекте в окне командной строки.

  • Команда renamewitd изменяет отображаемое имя типа рабочего элемента в конкретном проекте. После запуска этой команды для рабочих элементов этого типа отображается новое имя.

Для запуска инструмента командной строки witadmin откройте окно командной строки там, где установлено либо Visual Studio, либо Team Explorer, и введите:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

В 32-разрядной версии Windows замените %programfiles(x86)% на %programfiles%.

Дополнительные сведения о типах рабочих элементов см. в разделе Добавление определений типов рабочих элементов в шаблон процесса.

Примечание

Создавать и изменять типы рабочих элементов можно с помощью редактора процессов, мощного средства для Visual Studio.Это средство не поддерживается.Дополнительные сведения см. в следующей статье: Team Foundation Server Power Tools.

Требования

Для командного проекта, для которого определены типы рабочих элементов, необходимо иметь следующий набор разрешений:

  • Для экспорта или создания списка типов рабочих элементов необходимо быть членом группы безопасности Администраторы проекта или иметь разрешение Просмотр сведений на уровне проекта со значением Разрешить.

  • Для удаления, импорта или переименования типов рабочих элементов необходимо быть членом группы безопасности Администраторы Team Foundation или Администраторы проекта.

Для получения дополнительной информации см. Справочник по разрешениям Team Foundation Server.

Примечание

Даже если вход в систему выполнен с разрешениями администратора, для выполнения этой функции необходимо открыть окно командной строки с повышенными привилегиями на сервере, на котором выполняется Windows Server 2008.Чтобы открыть окно командной строки с повышенными привилегиями, в меню Пуск откройте контекстное меню пункта Командная строка и выберите Запуск от имени администратора.Дополнительные сведения см. в статье Контроль учетных записей.

witadmin destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]

witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]

witadmin importwitd /collection:CollectionURL [/p:Project] /f:FileName [/e:Encoding] [/v]

witadmin listwitd /collection:CollectionURL /p:Project

witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]

Параметры

Параметр

Описание

/collection:CollectionURL

Задает универсальный код ресурса (URI) коллекции командных проектов. URI необходимо указать в следующем формате: http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции.

Если виртуальный каталог не используется, URI имеет следующий формат:

http://ИмяСервера:Порт/ИмяКоллекции.

/p:Project

Командный проект, для которого предполагается управлять типами рабочих элементов. Командный проект должен быть определен в коллекции проектов, указанной параметром /collection.

Параметр /p обязателен, если вы не запускаете программу importwitd с параметром /v.

/n:TypeName

Имя типа рабочего элемента, который требуется удалить, экспортировать, импортировать или переименовать.

/f:FileName

Путь и имя XML-файла определения, содержащего типы рабочих элементов для экспорта или импорта. Если опустить этот параметр при использовании команды exportwitd, XML-файл отображается в окне командной строки.

Примечание

Если используется Windows Vista, у вас может не быть разрешений на доступ к определенным папкам.Если вы попытаетесь экспортировать тип рабочего элемента в расположение, на доступ к которому у вас нет прав, компонент виртуализации реестра автоматически перенаправит экспортированный файл и сохранит его в виртуальном хранилище.Чтобы избежать этого перенаправления, можно экспортировать файл в расположение, на доступ к которому у вас есть разрешения. Дополнительные сведения см. в следующих статьях: Registry Virtualization (Виртуализация реестра) и Common file and registry virtualization issues in Windows Vista (Проблемы общих файлов и виртуализации реестра в Windows Vista).

/e:кодировка

Имя формата кодирования .NET Framework 2,0. Команда использует указанную кодировку для экспорта или импорта XML-данных. Например, /e:utf-7 задает кодировку Юникод (UTF-7). Если этот параметр не указан, witadmin пытается определить кодировку, а в случае неудачи witadmin использует UTF-8.

/exportgloballists

Экспортирует определения глобальных списков, на которые ссылается тип рабочего элемента. Определения для глобальных списков будут включены в XML-файл определения типа рабочего элемента. Если их не указать, определения для глобальных список пропускаются.

/v

Проверяет XML-файл, определяющий тип рабочего элемента, но не импортирует XML-файл определения.

Примечание

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

/new:NewName

Новое имя типа рабочего элемента.

/noprompt

Отключает запрос подтверждения.

/? или help

Отображает справку по команде в окне командной строки.

Заметки

При использовании команды destroywitd она окончательно удаляет все следующие объекты:

  • тип рабочего элемента;

  • все рабочие элементы этого типа;

  • соответствующие записи в таблицах рабочих элементов, длинные текстовые таблицы и таблицы ссылок;

  • объекты в кэше метаданных типа рабочего элемента.

Примеры

Если не указано иначе, во всех примерах применяются следующие значения:

  • URI-адрес коллекции командных проектов: http://AdventureWorksServer:8080/tfs/DefaultCollection

  • Имя проекта: AdventureWorks

  • Имя входного или выходного файла: myworkitems.xml

  • Имя типа рабочего элемента: myworkitem

  • Кодировка по умолчанию: UTF-8

Экспорт определения типа рабочего элемента

Следующая команда экспортирует определение типа myworkitem в файл myworkitems.xml.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem

В следующем примере выполняется экспорт рабочего элемента с использованием кодировки Юникод (UTF-7).

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7

Экспорт определения типа рабочего элемента и глобальных списков, на которые он ссылается

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

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists

Список определений типа рабочего элемента

Следующий пример кода выводит определение типа рабочего элемента в окне командной строки.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /n:myworkitem

Импорт определений типов рабочих элементов

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

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks

Проверка XML-файла определения типа рабочего элемента

Следующий пример кода проверяет XML-файл, определяющий тип рабочего элемента, но не импортирует определение.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v

Вопросы и ответы

Вопрос. Какие настройки я могу сделать, не отказываясь от использования мастера настройки компонентов для обновления командного проекта после обновления TFS?

Ответ. Можно добавить собственные типы рабочих элементов и изменить макет формы. Мастер настройки компонентов обновит командные проекты, и вы сможете получить доступ к компонентам последней версии.

Изменение рабочего процесса или переименование типа рабочего элемента может потребовать выполнения определенных ручных операций при обновлении командного проекта. Дополнительные сведения о том, какие настройки вы можете вносить без последствий, а каких следует избегать, см. в разделе Настройка отслеживания хода выполнения работы: оценка влияния обслуживания и обновления перед настройкой.

Вопрос. Как изменить цвет, связанный с типом рабочего элемента?

Ответ. В Team Web Access рабочие элементы отображаются в результатах запросов и на страницах невыполненной работы и досок задач инструментов планирования Agile. Чтобы изменить цвет, связанный с существующим объектом WIT, или добавить цвет для нового WIT, измените конфигурацию процесса.

Назначение цветов различным типам рабочих элементов

В. Как деактивировать или отключить тип рабочих элементов?Как запретить пользователям создавать рабочие элементы определенного типа?

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

<TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER not="[Team Project Name]Project Valid Users" />
     </FIELD>
   </FIELDS>
</TRANSITION>

Если требуется ограничить создание рабочих элементов определенного типа для группы пользователей, есть два способа ограничения доступа:

  • Добавьте тип рабочего элемента в группу "Скрытые категории", чтобы запретить большинству пользователей создавать соответствующие рабочие элементы. Если требуется открыть доступ для группы пользователей, можно создать гиперссылку на шаблон, который открывает форму рабочего элемента, и сделать эту ссылку общей для тех членов команды, которые должны создавать их;

  • Добавьте правило поля в рабочий процесс для поля System.CreatedBy, чтобы запретить группе пользователей создавать рабочие элементы определенного типа. Как показано в следующем примере, пользователь, создающий рабочий элемент, должен принадлежать к Allowed Group, чтобы сохранить рабочий элемент.

    <TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER for="Allowed Group" not="Disallowed Group" />
     </FIELD>
   </FIELDS>
</TRANSITION>

В. Как удалить тип рабочего элемента?

О. Чтобы запретить членам команды использовать указанный тип рабочего элемента для создания рабочего элемента, можно удалить его из командного проекта. С помощью witadmin destroywitd можно безвозвратно удалить все рабочие элементы, созданные с помощью этого типа рабочего элемента, а также сам тип рабочего элемента. Например, если команда не использует рабочий элемент "Препятствие", можно удалить тип рабочего элемента "Препятствие" из проекта веб-сайта Fabrikam.

witadmin destroywitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"Impediment"

При удалении типа рабочего элемента, который принадлежит к категории, необходимо обновить определение категорий для командного проекта, чтобы в нем отображалось новое имя. В частности, средства планирования Agile не будут работать, если не обновить определение категорий.

Для получения дополнительной информации см. Импорт и экспорт категорий [witadmin].

См. также

Задачи

Создание типа рабочего элемента

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

Настройка объектов отслеживания работ для поддержки командных процессов

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

witAdmin. Настройка объектов для отслеживания рабочих элементов и управление этими объектами