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

Azure DevOps Services

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

Внимание

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

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

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

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

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

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

Игнорировать

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

Ум

Категории

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

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

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

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

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

Сборка

Управление лабораторией

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

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

Отчеты

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

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

Необходимые условия

Для получения рекомендаций по адаптации Azure Boards под ваши конкретные бизнес-требования см. статью О конфигурации и кастомизации Azure Boards.

Категория	Требования
разрешения	— Для создания, удаления или редактирования процесса: член группы администраторов коллекции проектов или наличие конкретных разрешений на уровне коллекции: Создать процесс, Удалить процесс, Редактировать процесс, или Удалить поле из организации с установкой на Разрешить. Дополнительные сведения см. в разделе Настройка разрешений и доступа для отслеживания работы, настройка унаследованного процесса. — Чтобы обновить доски: Администратор команды или участник группы Администраторов проектов.
Доступ	- Даже если у вас есть базовый или более низкий доступ, вы все равно можете изменить процесс, если кто-то дает вам разрешения на это. — Чтобы обновить и изменить тип существующих рабочих элементов, обратитесь к члену проекта.
модель процесса проекта	— Иметь модель процесса наследования для коллекции проектов, в которой содержится проект. — Если вы переносите данные в Azure DevOps Services, используйте службу импорта базы данных Team Foundation Server .
Знания	Знакомство с настройками и моделями процессов.

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

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

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

Откройте настройки>Process

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

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 процессов. Пользовательские процессы должны соответствовать всем приведенным ниже правилам. Иначе при импорте могут поступать сообщения об ошибках проверки.

• Настройка размещенного XML-процесса
  • Настройка процесса
    • Экспорт и импорт процесса
  • Поддерживаемые настройки
  • Ограничения
    • Шаблон процесса
    • Конфигурация процесса
    • Категории
    • Типы рабочих элементов
    • Поля рабочих элементов
      • Ограничения лимитов
      • Обязательные поля
      • Ограничения правил
      • Согласованные имена и атрибуты
      • Поля идентификации
        • Добавьте пользовательское поле идентификатора
        • Ограничения правил для полей идентификации
        • Правильный пример
        • Неправильный пример
    • Рабочий процесс
    • Глобальные списки
    • Макет формы
  • Связанные статьи

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

Файл 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. Кроме того, он должен соответствовать следующим условиям:

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

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

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

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

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

Ограничить ограничения

• Элемент FIELDS ограничен 1024 полями.
• Тип рабочего элемента ограничен 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)
• Активировано (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 и состояниями рабочего процесса, сопоставленными с категорией состояния "Завершено".

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

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

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

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

Макет формы

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

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

Связанные статьи

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