Настройка размещенного XML-процесса

Azure DevOps Services

Azure DevOps Services поддерживает добавление и обновление процессов с помощью административного интерфейса, в котором предусмотренпроцесс импорта через Интернет. После добавления процесса можно создать из него один или несколько проектов. Вы можете обновить процесс в любое время, импортировав его снова. Изменения, внесенные в шаблон процесса, затем применяются ко всем проектам, которые используют этот процесс.

Важно!

С помощью модели размещенного XML-процесса вы настраиваете отслеживание работы, обновляя файлы определения XML шаблона процесса. Эта функция доступна только при переносе данных в Azure DevOps Services с помощью службы импорта базы данных Team Foundation Server.

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

Процесс — это ZIP-файл, содержащий набор взаимозависимых файлов. Эти файлы определяют стандартные блоки системы отслеживания рабочих элементов и других подсистем в Azure DevOps Services. Некоторые стандартные блоки обновляют существующие проекты, а другие применяются только к новым проектам. Полный список стандартных блоков см. в следующей таблице.

Используется при импорте или обновлении процесса

Используется при создании проекта

Заменено системными значениями по умолчанию

Не учитывается

Отслеживание рабочих элементов

Ум

Категории

Конфигурация процесса

Области и итерации

Управление тестированием

Рабочие элементы

Запросы рабочих элементов

Сборка

Lab Management

Управление версиями

Сопоставления с Microsoft Project

Отчеты

Портал (Продукты SharePoint)

Существуют различия между поддерживаемыми Azure DevOps Services и локальными серверами Team Foundation Server. Сводные сведения об этих различиях см. в разделе Отличия при настройке шаблонов процесса.

Настройка процесса

При настройке процесса начать с четко определенного процесса проще, чем создавать новый.

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

Открытие процесса параметров>

Вы создаете, администрируете и настраиваете процессы из процесса параметров>организации.

1. Выберите логотип Azure DevOps, чтобы открыть проекты. Затем выберите Параметры организации.

   

2. Затем выберите Процесс.

   

   Важно!

   Если вы не видите элемент Процесс, вы работаете с TFS-2018 или более ранней версии. Страница Процесс не поддерживается. Необходимо использовать функции, поддерживаемые для локальной модели XML-процессов.

Экспорт и импорт процесса

1. На вкладке Процессы нажмите кнопку с многоточием (...), чтобы открыть контекстное меню для размещенного XML-процесса, который требуется экспортировать. Вы можете экспортировать только размещенные XML-процессы.

   

   Сохраните ZIP-файл и извлеките из него все файлы.

2. Переименуйте процесс в файле ProcessTemplate.xml, расположенном в корневом каталоге.

   Назовите процесс, чтобы отличить его от существующих.

   <name>MyCompany Agile Process </name>

   Измените тип версии и измените основное и дополнительное номера. Укажите отдельный GUID для типа, как показано в следующем примере:

   <version type="F50EFC58-C2FC-4C66-9814-E395D90778A3" major="1" minor="1"/>

3. Применение поддерживаемых настроек.

4. Создайте ZIP-файл всех файлов и папок в корневом каталоге.

5. Импортируйте ZIP-файл пользовательского процесса.

Поддерживаемые настройки

К процессу можно применить следующие настройки:

• Добавление, удаление или изменение WIT.
• Добавление или изменение поля.
• Добавьте до пяти невыполненных работ по портфелям.
• Добавьте категории , которые будут использоваться в конфигурации процесса.
• Изменение конфигурации процесса.
• Добавление глобальных списков.

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

Ограничения

В Azure DevOps Services можно импортировать до 32 процессов. Пользовательские процессы должны соответствовать всем приведенным ниже обобщенным правилам. Иначе при импорте могут поступать сообщения об ошибках проверки.

• Процесс
  • Выполните конфигурацию.
  • Категории
  • Типы рабочих элементов
    • Fields
      • Ограничения
      • Обязательные поля
      • Ограничения правил
      • Согласованные имена и атрибуты
      • Поля идентификации
      • Рабочий процесс
      • Глобальные списки
    • Рабочий процесс
    • Макет формы

Шаблон процесса

Файл ProcessTemplate.xml должен соответствовать синтаксису и правилам, описанным в статье Справочник по xml-элементам ProcessTemplate. Кроме того, он должен соответствовать следующим условиям:

• Ограничивает количество определенных WIT до 64
• Содержит только один файл определения Categories.xml
• Содержит только один файл определения ProcessConfiguration.xml
• Использует уникальные понятные имена во всех полях и определениях WIT

Кроме того, процесс должен пройти следующие проверки:

• Имена процессов являются уникальными и содержат не более 155 символов Юникода.
  • Шаблон с тем же именем и GUID версии, что и существующий процесс, перезаписывает этот процесс.
  • Шаблон с тем же именем, но идентификаторОМ GUID другой версии приводит к ошибке.
  • Имена процессов не могут содержать следующие специальные символы: . , ; ' ` : / \ * | ? " & % $ ! + = ( ) [ ] { } < >.
    Дополнительные ограничения см. в разделе Ограничения именования .
• Папки процесса не содержат .exe файлов. Даже если можно импортировать процесс, содержащий файл .exe, создание проекта завершается сбоем.
• Общий размер процесса составляет не более 2 ГБ. В противном случае создание проекта завершается сбоем.

Выполните конфигурацию.

Файл определения ProcessConfiguration.xml должен соответствовать синтаксису и правилам, описанным в справочнике по XML-элементу ProcessConfiguration. Кроме того, он должен соответствовать следующим условиям:

• Задает все элементы TypeFields
• Ограничено пятью невыполненной работой портфеля
• Содержит только одну невыполненную работу портфеля без поддержки
• Указывает только один родительский портфель невыполненной работы для каждого подчиненного портфеля.
• Содержит необходимые сопоставления состояния рабочего процесса с метаданными и не ссылается на неподдерживаемые метаданные.

Категории

Файл определения Categories.xml должен соответствовать синтаксису и правилам, описанным в справочнике по xml-элементам категорий. Кроме того, он должен соответствовать следующим условиям:

• Ограничено 32 категориями
• Определяет все категории, на которые ссылается файл ProcessConfiguration.xml.

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

Элемент WITD и его дочерние элементы должны соответствовать синтаксису и правилам, описанным в справочнике по XML-элементам WITD. Кроме того, он должен соответствовать следующим условиям:

• Существует не более 512 полей в одном WIT и 512 полей во всех WIT.
• Понятное имя и обязательный атрибут refname , назначенные WIT, уникальны в наборе файлов определения WIT.
• Обязательное значение атрибута refname не содержит запрещенных символов и не использует запрещенное пространство имен System. Имя и Майкрософт. Имя.
• Имена ссылок содержат по крайней мере одну точку (.), а все остальные символы представляют собой буквы без пробелов.
• Элемент WITD содержит элемент FORM , который определяет элемент WebLayout, соответствующий синтаксису, указанному в элементах WebLayout и Control.

Поля рабочих элементов

Элемент FIELDS и его дочерние элементы должны соответствовать синтаксису и правилам, описанным в справочнике по XML-элементу FIELD. Кроме того, он должен соответствовать следующим условиям:

• Понятное имя и обязательный атрибут refname , назначенные WIT, уникальны в наборе файлов определения WIT.
• Обязательное значение атрибута refname не содержит запрещенных символов и не использует запрещенное пространство имен System. Имя и Майкрософт. Имя.
• Имена ссылок содержат по крайней мере одну точку (.), а все остальные символы представляют собой буквы без пробелов.

Элемент FIELD и его дочерние элементы могут содержать элемент GLOBALLIST .

Ограничение ограничений

• Элемент FIELDS ограничен 512 полями.
• Тип рабочего элемента ограничен 64 полями имени пользователя. Поле имени пользователя — это поле с атрибутом и значением syncnamechanges=true.
• Элементы ALLOWEDVALUES или SUGGESTEDVALUES ограничены 512 элементами LISTITEM .
• Поле ограничено 1024 правилами.

Обязательные поля

В файле ProcessConfiguration.xml указаны следующие поля:

• Для всех WIT в категории, определяющей невыполненную работу по настройке процесса, укажите поля, используемые для атрибутов и значений type=Team и type=Order.
• Для всех WIT в категории, которая определяет обычную невыполненную работу или невыполненную работу портфеля, укажите поле, используемое для type=Effort.
• Для всех WIT в категории, определяющей элемент TaskBacklog , укажите:
  • Поле, используемое для type=RemainingWork.
  • Поле, используемое для type=Activity.
  • Правило ALLOWEDVALUES для поля, используемого для type=Activity.

Ограничения правил

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

• Элементы правил полей не могут указывать атрибуты for и not .
• Элементы FIELD не могут содержать дочерние элементы правила CANNOTLOSEVALUE, NOTSAMEAS, MATCH и PROHIBITEDVALUES.
• За исключением следующих полей, определения FIELD для System. Поля имен не могут содержать правила полей.
  • System.Title может содержать правила REQUIRED и DEFAULT.
  • System.Description может содержать правила REQUIRED и DEFAULT.
  • System.AssignedTo может содержать правила REQUIRED, DEFAULT, ALLOWEXISTINGVALUE и VALIDUSER.
  • System.ChangedBy может содержать правила REQUIRED, DEFAULT, ALLOWEXISTINGVALUE и VALIDUSER.

Согласованные имена и атрибуты

В рамках процесса или коллекции проектов имя, тип и другие атрибуты, определяемые элементом FIELD , должны быть одинаковыми во всех определениях WIT.

Поля идентификации

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

• Кому назначено (System.AssignedTo)
• Авторизован как (System.AuthorizedAs)
• Кем изменено (System.ChangedBy)
• Кем создано (System.CreatedBy)
• Activated By (Microsoft.VSTS.Common.ActivatedBy)
• Closed By (Microsoft.VSTS.Common.ClosedBy)
• Разрешено (Microsoft.VSTS.Common.ResolvedBy)

Добавление настраиваемого поля удостоверения

Строковое поле распознается как поле идентификатора при указании атрибута syncnamechanges как True.

Ограничения правил для полей удостоверений

Для текущего выпуска импорта процесса не указывайте в определении FIELD какие-либо из следующих правил.

• SUGGESTEDVALUES
• Правила, содержащие значения, не являющиеся идентификаторами.

Правильный пример

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

    <FIELD name="Project Manager" refname="Fabrikam.ProgramManager" type="String" reportable="dimension" syncnamechanges="true">
        <ALLOWEXISTINGVALUE />
        <VALIDUSER group="[PROJECT]\Program Manager Group" />
        <HELPTEXT>The program manager responsible for signing off on the user story.</HELPTEXT>
    </FIELD>

Перед импортом процесса убедитесь, что вы создали группу в проектах, обновляемых процессом.

Неправильный пример

Следующий пример недопустим, так как он указывает:

• Элемент ALLOWEDVALUES.
• Элемент DEFAULT , указывающий строку value="Not Assigned", не являющуюся идентификатором .

    <FIELD name="Project Manager" refname="Fabrikam.ProgramManager" type="String" reportable="dimension" syncnamechanges="true">
        <ALLOWEXISTINGVALUE />
        <ALLOWEDVALUES>
          <LISTITEM value="[PROJECT]\Program Manager Group" />
          <LISTITEM value="Not Assigned" />
        </ALLOWEDVALUES>
        <DEFAULT from="value" value="Not Assigned" />
        <VALIDUSER />
        <HELPTEXT>The program manager responsible for signing off on the user story.</HELPTEXT>
    </FIELD>

Рабочий процесс

Элемент WORKFLOW и его дочерние элементы должны соответствовать синтаксису и правилам, описанным в справочнике по XML-элементам WORKFLOW. Кроме того, он должен соответствовать следующим условиям:

• Ограничивает каждое WIT до 16 состояний рабочего процесса
• Определяет все состояния рабочего процесса, сопоставленные с метаданными в файле определения ProcessConfiguration.
• Определяет переход между всеми состояниями рабочего процесса, сопоставленными с категорией состояния "Предлагаемое", и состояниями рабочего процесса, сопоставленными с категорией состояния "InProgress"
• Определяет переход между всеми состояниями рабочего процесса, сопоставленными с категорией состояния "InProgress", и состояниями рабочего процесса, сопоставленными с категорией состояния "Завершено".

Описание категорий состояний и сопоставлений см. в разделе Состояния рабочего процесса и категории состояний.

Глобальные списки

Для модели процессов hosted XML на импорт глобальных списков накладываются следующие ограничения:

• Существует не более 64 глобальных списков.
• В списке содержится не более 512 элементов.
• В общей сложности среди всех глобальных списков, указанных во всех типах WIT, можно определить примерно 10 000 элементов.

Макет формы

Элемент FORM и его дочерние элементы должны соответствовать синтаксису и правилам, описанным в справочнике по XML-элементам FORM.

Элемент Control не может указать пользовательский элемент управления. Пользовательские элементы управления не поддерживаются.

Похожие статьи

• Импорт и экспорт размещенного XML-процесса
• Правила и их оценка
• Изменение проекта с размещенного XML на наследуемый процесс
• Клонирование размещенного XML-процесса в процесс наследования
• Поддерживаемые операции при переходе из размещенного XML к наследуемому процессу