Управление глобальным рабочим процессом [witadmin]
Глобальный рабочий процесс позволяет минимизировать объем работ по определению и обновлению полей рабочих элементов и глобальных списков, которые являются общими для многих типов рабочих элементов и командных проектов. Глобальный рабочий процесс позволяет определять и обновлять поля и глобальные списки. Управление глобальным рабочим процессом для коллекции командных проектов или командного проекта, осуществляется с помощью следующих команд средства командной строки witadmin:
exportglobalworkflow: экспортирует глобальный рабочий процесс в XML-файл или в окно командной строки.
importglobalworkflow: импортирует глобальный рабочий процесс из XML-файла.
Примечание
Прежде чем можно будет определить глобальный проект, соответствующий компонент необходимо включить на сервере уровня приложений.Поэтому на сервере должна быть запущена версия Visual Studio Team Foundation Server, поддерживающая этот компонент, например Team Foundation Server 2010 с пакетом обновления 1 (SP1).Пакет обновления можно загрузить на следующей странице веб-сайта Майкрософт: Service Pack 1 of Visual Studio Team Foundation Server 2010, Beta.
Для настройки интеграции используйте программу командной строки witadmin, находящуюся в папке диск:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE на компьютере, на котором выполняется Сред. Командный обозреватель. На 64-разрядных компьютерах программа расположена в папке диск:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE.
Дополнительные сведения о глобальном рабочем процессе см. в разделе Настройка глобального рабочего процесса.
Необходимые разрешения
Для коллекции командного проекта, где определен рабочий процесс, необходимо иметь следующий набор разрешений:
Для экспорта глобального рабочего процесса необходимо быть допустимым пользователем командного проекта или коллекции проектов.
Для импорта глобального рабочего процесса необходимо быть членом следующих групп безопасности: группы Администраторы Team Foundation или Администраторы проекта для импорта глобального рабочего процесса в командный проект, или группы Администраторы коллекции проектов для импорта глобального рабочего процесса в коллекцию проектов.
Дополнительные сведения см. в разделах Разрешения Team Foundation Server и Группы по умолчанию, права и роли в Team Foundation Server.
Примечание
Даже если вход в систему выполнен с разрешениями администратора, чтобы выполнить эту функцию на сервере с операционной системой Windows Server 2008, необходимо открыть окно командной строки с повышенными привилегиями.Чтобы открыть окно командной строки с повышенными привилегиями, нажмите кнопку Пуск, щелкните правой кнопкой мыши пункт Командная строка и выберите команду Запуск от имени администратора.Дополнительные сведения см. на следующей странице веб-сайта Майкрософт: Контроль учетных записей.
witadmin exportglobalworkflow /collection:CollectionURL [/p:ProjectName] [/f:FileName] [/e:Encoding] [/exportgloballists]
witadmin importglobalworkflow /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:Encoding] [/v]
Параметры
Параметр |
Описание |
---|---|
/collection:CollectionURL |
Задает универсальный код ресурса (URI) коллекции. Необходимо указать URI-адрес в следующем формате: http://имя_сервера:порт/имя_виртуального_каталога/имя_коллекции Если виртуальный каталог не указан, необходимо указать URI-адрес в следующем формате: http://ИмяСервера:Порт/ИмяКоллекции. |
/p:ProjectName |
Необязательный. Командный проект, в который экспортируется/из которого импортируется глобальный рабочий процесс. Данный командный проект должен быть определен в коллекции проектов, заданной параметром /collection. Если не указан командный проект, для коллекции будет импортирован или экспортирован глобальный рабочий проццесс. |
/f:FileName |
Путь и имя XML-файла определения глобального рабочего процесса для экспорта или импорта.
Примечание
Если на клиентском компьютере работает Windows Vista, то возможно пользователь не имеет разрешений на доступ к определенным папкам.При попытке экспорта глобального списка в расположение, для доступа к которому у пользователя отсутствуют разрешения, технология виртуализации реестра автоматически перенаправит экспортируемый файл и сохранит его в виртуальном хранилище.Дополнительные сведения см. на страницах Виртуализация реестра (страница может быть на английском языке) и Типовые проблемы виртуализации файлов и реестра в Windows Vista (страница может быть на английском языке) веб-сайта корпорации Майкрософт.Во избежание перенаправления файл можно экспортировать в расположение, для которого имеются права доступа.
|
/e:Encoding |
Необязательный. Имя формата кодирования .NET Framework 2.0. Указанное кодирование будет использоваться для экспорта или импорта XML-данных. Например, /e utf-7 задает кодировку Юникод (UTF-7). Если этот параметр не указан, то witadmin пытается определить кодировку и в случае сбоя обнаружения использует UTF-8. |
/v |
Необязательный. Проверяет XML-код, определяющий рабочий процесс, но не импортирует файл XML-определения. |
/exportgloballists |
Необязательный. Экспортирует определения глобальных списков, на которые ссылается глобальный рабочий процесс. Определения глобальных списков будут внедрены в XML-определение глобального рабочего процесса. Если этот параметр не указан, определения глобальных списков пропускаются. |
/? либо help |
Отображает справку по команде в окне командной строки. |
Заметки
Определять новые поля рабочих элементов можно путем их импорта через глобальный рабочий процесс. Изменить свойства существующих полей с помощью глобального процесса, однако, нельзя. При импорте глобального рабочего процесса, не содержащего элемента FIELDS, все ранее импортированные правила глобального рабочего процесса будут удалены. Определения полей затронуты не будут.
Примеры
Если не указано иначе, во всех примерах применяются следующие значения:
URI коллекции командного проекта: http://AdventureWorksServer:8080/AWTeam/Collection1
Командный проект: Contoso
Номер порта веб-сайта сервера: 8080
Экспорт определения глобального рабочего процесса для командного проекта
В следующем примере экспортируется глобальный рабочий процесс для командного проекта:
witadmin exportglobalworkflow /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:Contoso /f:C:myGlobalWorkflow.xml
Импорт определения глобального рабочего процесса в командный проект
В следующем примере глобальный рабочий процесс импортируется в командный проект Contoso:
witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:Contoso /f:C:collectionGlobalWorkflow.xml
Импорт определения глобального рабочего процесса в коллекцию
В следующем примере глобальный рабочий процесс импортируется в коллекцию:
witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:collectionGlobalWorkflow.xml
См. также
Задачи
Добавление, использование глобальных списков и управление ими
Основные понятия
Определение глобальных списков
Другие ресурсы
Настройка глобального рабочего процесса
witAdmin. Администрирование объектов для отслеживания рабочих элементов