Настройка размещенного 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-файл пользовательского процесса.

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

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

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

Ограничения

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

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

Файл 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.
  • Понятное имя и обязательный атрибут ссылок , назначенный WIT, являются уникальными в наборе файлов определений WIT.
  • Требуемое значение атрибута ссылочного имени не содержит запрещенных символов или использует систему запрещенных пространств имен.Имя и корпорация Майкрософт.Имя.
  • Имена ссылок содержат по крайней мере один период (.), а все остальные символы — буквы без пробелов.
  • Элемент WITD содержит элемент FORM, который определяет элемент WebLayout, соответствующий синтаксису, указанному в элементах WebLayout и Control.

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

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

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

Элемент 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.

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

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

  • Элементы правил полей не могут указывать атрибуты.
  • Элементы FIELD не могут содержать элементы дочернего правила NOTLOSEVALUE, 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)
  • Активировано (Microsoft.VSTS.Common.ActivatedBy)
  • Закрыто (Microsoft.VSTS.Common.ClosedBy)
  • Разрешено (Microsoft.VSTS.Common.ResolvedBy)
Добавление поля настраиваемого удостоверения

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

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

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

  • ПРЕДЛАГАЕМЫЕ ЗНАЧЕНИЯ
  • Правила, содержащие значения неидентности.
Правильный пример

Чтобы ограничить имена учетных записей, допустимые в поле удостоверения, укажите 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 и его дочерние элементы должны соответствовать синтаксису и правилам, описанным в справочнике по элементу WORKFLOW XML. Кроме того, он должен соответствовать следующим условиям:

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

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

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

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

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

Макет формы

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

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