Программная реализация надстройки над системой управления проектами 'YouTrack'

Оглавление

Введение

Глава 1. Определение и формулировка требований к надстройке

1.1 Scrum-методология

1.2 Требования к системе управления проектами

1.3 Требования к разрабатываемой надстройке

1.3.1 Delivery report

1.3.2 Cumulative report

1.4 Визуализация данных

1.5 Обзор систем управления проектами

1.5.1 YouTrack

1.5.2 JIRA

1.5.3 Team Foundation Server

1.5.4 Bugzilla

1.5.5 Сравнение представленных систем

1.6 Устав проекта

1.6.1 Описание идеи

1.6.2 Цель и задачи проекта

1.6.3 Актуальность

1.6.4 Возможные риски

1.6.5 Классификация рисков

1.6.6 Анализ и приоритезация рисков

Глава 2. Проектирование надстройки

2.1 Проектирование извлечения данных из YouTrack

2.2 Проектирование интерфейса надстройки

2.3 Взаимодействие с системой

Глава 3. Разработка и тестирование надстройки

3.1 Средства разработки и технологии

3.2 Результат разработки

Заключение

Библиографический список

Приложения

Введение

Трудовые ресурсы составляют значительную часть затрат предприятия в себестоимости продукции. Таким образом, повышение эффективности их использования является одним из наиболее важных факторов в снижении стоимости производства и роста прибыли. Рациональное использование труда во многом определяется организацией аналитической работы, которая требует особого внимания в условиях рыночной экономики.

На сегодняшний день существует множество различных ПО для отслеживания работ сотрудников исполнителя по проекту. Во многих таких системах есть возможность создания графиков и диаграмм, для лучшего восприятия информации и представления общей картины готовности проекта. Однако набор таких визуализаций ограничен и может возникнуть необходимость создания собственных графиков с конкретными показателями. Также, в зависимости от роли, пользователи должны иметь возможность редактирования задач и данных по ним или же только просмотра данных. Таким образом, задача состоит в том, чтобы предоставить сотрудникам заказчика интерфейс для работы с задачами из системы управления проектами, используемой на предприятии.

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

В работе будут рассмотрены эти задачи, в частности, извлечения, обработки и анализа данных по проекту и предоставления информации пользователям в соответствии с ролью. На предприятии данные извлекаются из инструмента для управления проектами YouTrack. Проблема актуальна, поскольку она может сократить время работы с данными, и, таким образом, повысить эффективность рабочего процесса и заказчика, и исполнителя.

Основная цель данного исследования заключается в поиске подходящего способа решения поставленной задачи. В качестве возможного решения, мы рассмотрим веб-приложение, которое принимает данные из текущей системы YouTrack, обрабатывает их в соответствии с формулами, предоставленными заказчиком и представляет их в виде отчетов, необходимых заказчику.

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

Цель работы - изучение существующих систем управления проектами, их функций, которые позволят извлекать данные о задачах проекта, их преимуществ и недостатков и программная реализация собственной надстройки над системой управления проектами YouTrack с учетом проведенного анализа.

Цель работы можно разделить на пять задач:

.        Изучение возможностей системы YouTrack, её ограничений и аналитический обзор её аналогов и их функциональности.

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

.        Разработка надстройки:

-       проектирование интерфейса;

-       определение технологий реализации;

-       программная реализация надстройки.

В представленной работе объектом исследования является процесс управления проектами, предметом - системы управления проектами.

В работе использованы следующие методы исследования:

1.      Общенаучные методы анализа - для поиска и определения необходимой информации.

.        Профессиональные методы:

.1.     Объектно-ориентированное проектирование и программирование - для проектирования всей системы.

.2.     Теория управления проектами и человеческими ресурсами - для анализа предметной области.

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

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

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

1.1 Scrum-методология

- один из наиболее популярных механизмов для реализации методологии Agile. Многие люди считают, что Agile и Scrum - одно и то же, однако это не так. Многие фреймворки могут быть использованы для реализации Agile, например, Kanban, но scrum отличается более короткими итерациями работы [1].

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

В scrum есть четыре церемонии, которые создают структуру спринта:

1.      Планирование спринта: совещание по планированию задач, на котором определяется, что необходимо сделать в предстоящем спринте.

.        Ежедневное собрание: 15-минутное мини-собрание команды разработчиков ПО для синхронизации задач.

.        Спринт-демонстрация: совместное собрание, на котором команда показывает, что реализовано в спринте.

.        Ретроспектива спринта: обзор того, что и почему сделано и не сделано, формирование выводов, чтобы сделать следующий спринт лучше. Во время спринта визуальные артефакты, такие как панели задач и диаграммы сгорания задач, видимые команде, являются мощными мотиваторами. Возможность продемонстрировать новую работу на демонстрационном спринте в равной степени мотивирует, а последовательная, поэтапная обратная связь, которую команда получает от заинтересованных сторон в каждой демонстрации, создаёт мощный способ разработки продуктов.

Характеристики методологии scrum, которые понадобятся в надстройке:

1.      Epic - большой кусок работы, который содержит Story.

.        Story - наименьшая единица работы, также известная как таск.

.        Delivery - дата показа программного продукта заказчику.

.        Sprint - итерация, где команда выполняет работу.

.2 Требования к системе управления проектами

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

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

.        Система управления проектом поддерживала методологию Scrum, т. к. именно она используется на предприятии при разработке ПО.

.        Система предоставляла возможность создания пользовательских полей.

.        Данные о проекте предоставлялись в популярном формате, таком как xml или json.

1.3 Требования к разрабатываемой надстройке

надстройка визуализация интерфейс проект

Разрабатываемая надстройка должна предоставлять интерфейс для работы с задачами из системы управления проектами YouTrack.

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

Все характеристики задачи являются настраиваемыми полями. По умолчанию в YouTrack включены часто используемые поля задач, такие как Type, State и Assignee. Также есть список настраиваемых полей, которые прикреплены к проектам по умолчанию [8].

В дополнение к предварительно определенным полям есть возможность определить свои собственные поля.

Интересующий заказчиков проект содержит следующие характеристики задач:

1.      Priority - приоритет задачи (show-stopper, critical, major, normal, minor).

.        Type - тип задачи (bug, task, epic).

.        State - состояние задачи (open, in progress, to verify, done, duplicate, investigation).

.        Assignee - исполнитель задачи.

.        Due Date - крайний срок (необязательное поле).

.        Sprints - список спринтов проекта.

.        Delivery - список дат отчётности по проекту.

.        Discipline - дисциплина задачи (Development, Content development, Documentation).

.        Request Type - тип запроса (requirement, enhancement, defect, support request).

.        Epic - набор спринтов.

.        Area Path - путь к компоненту в приложении, по которому производится работа в данной задаче.

.        Spent time - потраченное время на задачу.

.        Estimation Total - оценка всего времени, потраченного на задачу.

.        Estimation DB - оценка времени, потраченного на задачу в рамках работ по базам данных.

.        Estimation Web - оценка времени, потраченного на задачу в рамках работ по веб-части.

.        Estimation Testing - оценка времени, потраченного на задачу в рамках работ по тестированию.

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

В первой версии надстройки требуется реализовать два отчёта: Delivery report и Cumulative report.

1.3.1 Delivery report

Отчёт Delivery отображает информация в разрезе выбранного Delivery. На нём можно увидеть потраченное время на работу каждого кластера (DB, Web, Testing). Задачи, которую выполняет каждый кластер имеют свои приоритеты, которые также отражены в столбцах.

Отчёт представляет из себя диаграмму, составленную из двух типов - bar и line (см. рис. 1.1). По оси X представлены виды работ (работы с базами данных, работы в веб-части приложения, тестирование), по оси Y - количество человеко-часов. Столбцы графика bar составлены из трёх частей, каждая из которых является обозначением количества часов по задаче с определённым приоритетом (P-1, P-2, P-3). Линия графика line обозначает количество доступных человеко-часов в данном Delivery. На отчёте должны присутствовать элементы выбора Delivery и Epic.

Рисунок 1.1. Макет отчёта Delivery

Для создания отчёта Delivery понадобятся следующие данные:

1.      Названия Delivery - для данных в элементе выбора Delivery.

2.      Названия Epic - для данных в элементе выбора Epic.

3.      Количество часов, потраченных на работу в каждом кластере (DB, Web, Testing) - для значения общего количества часов в кластере.

4.      Количество доступных для работы человеко-часов - для значений по line-диаграмме.

5.      Информация о приоритете выполненных задач и количестве часов, потраченном на каждый приоритет - для значений в bar-диаграмме.

.3.2 Cumulative report

Отчёт Cumulative отражает прогресс работ по каждому из Delivery в году, суммарный объём сделанных работ по проекту и запланированный годовой объём работ. Горизонтальная target-линия показывает запланированный объём работ на год, а общий сделанный объём работ показывает оранжевая линия.

Отчёт также сочетает в себе два типа диаграмм: bar и line. По оси X представлены Delivery по месяцам, на левой оси y указано число человеко-часов для line-диаграммы, на правой оси Y - количество часов для bar-диаграммы (рис 1.2). В столбцах предыдущих Delivery указано реальное количество часов (Done), потраченных на задачи в конкретном Delivery; в предстоящих Delivery указано суммарное количество часов на планируемые задачи (Open); для текущего Delivery отображается три показателя по задачам: In Progress, Open и Done (в человеко-часах). Линия показывает суммарное количество часов задач со статусом Done с начала года. Линия target показывает годовую цель по количеству сделанных задач. На отчёте должен присутствовать элемент выбора года.

Рисунок 1.2. Макет отчёта Cumulative

Для создания отчёта Cumulative понадобятся следующие данные:

1.      Названия Delivery - для данных в элементе выбора Delivery.

2.      Дата Delivery - для названий периодов по оси X.

3.      Статус задачи (Open, In Progress, Done) - для разделения столбца текущего Delivery по часам.

4.      Оценочное время выполнения задачи - для суммарного значения времени планируемых задач по каждому Delivery.

5.      Плановая цель по задачам за год - линия target.

С помощью надстройки также необходимо уметь выполнять следующие операции:

1.      Просмотр данных о задаче.

.        Редактирование данных о задаче.

.        Создание новой задачи.

.        Просмотр графиков с необходимыми данными.

.        Ограничение доступа к информации в соответствии с ролью пользователя.

.4 Визуализация данных

Визуализация данных представляет собой графическое отображение абстрактной информации для двух целей: создания смысла (также называемого анализом данных) и коммуникации [3]. Важные истории живут в данных, и визуализация данных является мощным средством для обнаружения и понимания этих историй, а затем для их представления другим. Информация абстрактна в том смысле, что она описывает вещи, которые не являются физическими. Статистическая информация абстрактна. Независимо от того, касается ли это продаж, случаев заболевания, спортивных результатов или чего-то еще, даже если это не относится к физическому миру, все же возможно визуально отобразить её, но для этого необходимо найти способ придать форму тому, что формы не имеет. Этот перевод абстрактного в физические атрибуты видения (например, длина, положение, размер, форма и цвет) может быть успешным только в том случае, если имеется визуальное восприятие и познание. Другими словами, чтобы эффективно визуализировать данные, необходимо следовать принципам проектирования, основанным на понимании человеческого восприятия.

Картина стоит тысячи слов, но только тогда, когда рассказ лучше всего описывается графически, а не словесно, и картина хорошо разработана. Вы могли бы целый день наблюдать за таблицей чисел и никогда не увидеть, что было бы сразу очевидно при просмотре хорошей картины тех же чисел. Для примера приведена простая таблица данных о продажах - годовая стоимость - разделённая на два региона (рис. 1.3):

Рисунок 1.3. Пример табличных данных

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

Эта же информация, представленная в виде линейного графика (рис. 1.4):

Рисунок 1.4. Пример представления информации в виде графика

Из графика просматривается несколько фактов:

1.      Внутренние продажи были значительно выше, чем международные.

2.      Продажи на внутреннем рынке в целом за год выросли.

3.      Международные продажи, напротив, оставались относительно плоскими, с одним очевидным исключением: в августе они резко снизились.

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

То, что информация, представленная в виде текста в таблице, не могла передать, который мозг человека интерпретирует с помощью вербальной обработки, становятся видимыми и понятными при общении визуально. Это и есть «визуализация данных».

1.5 Обзор систем управления проектами

В сравнении рассмотрены наиболее популярные решения для управления проектами. Среди них YouTrack - система, которая используется в данный момент на предприятии и JIRA - наиболее популярная система (45 500 000 пользователей [6]), соответствующая заявленным требованиям.

1.5.1 YouTrack

YouTrack является продуктом компании JetBrains, и сочетает в себе коммерческую систему отслеживании ошибок на основе браузера, систему отслеживания проблем и возможности управления проектами в одном аккуратном и всеобъемлющем пакете (рис. 1.5). Система предлагает функцию поиска задач на основе запросов с автозавершением и позволяет пользователям манипулировать проблемами в пакетах, настраивать набор атрибутов задачи и создавать собственные рабочие процессы.

Можно настроить синхронизацию между Sprints и Versions приложения и использовать доску Agile как еще один способ просмотра списка проблем. В этом случае доска определяется версией Fix, которая определяет спринт на плате. YouTrack помогает управлять и распределять время с помощью возможностей отслеживания времени.

Рисунок 1.5. Интерфейс Youtrack

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

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

Поддержка Scrum. Доски Agile в YouTrack поддерживают процессы Scrum и Kanban [2]. Они разработаны, чтобы помочь командам планировать, визуализировать и управлять своей работой эффективным образом. Доски Agile в YouTrack поддерживают обновления в режиме реального времени, что означает, что все изменения отражаются на карточках на доске Agile, независимо от того, где они применяются к проблемам.

Рабочий процесс можно организовать несколькими способами. Доску можно использовать в качестве отдельного объекта, где связи между задачами и доской не контролируются любым настраиваемым полем. В этом случае задачи должны быть явно добавлены в Sprint доски. Например, есть возможность перетащить задачу из невыполненных задач (backlog) или создать новую задачу прямо на доске.

Кроме того, можно настроить синхронизацию между Sprints и Versions приложения и использовать доску Agile как еще один способ просмотра списка проблем. В этом случае доска определяется версией Fix, которая определяет спринт на плате. Другими словами, спринты рассматриваются как версии Fix. Карточки на доске могут быть отфильтрованы с помощью поискового запроса (при применении запроса все задачи, не соответствующие запросу, не удаляются с доски, они просто скрыты от пользователя).предоставляет мощную функциональность, которая помогает выполнять различные действия программным путем через свой RESTful API, в том числе:

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

API возвращает данные в форматах xml и json.

Пользовательские поля

В роли администратора можно создавать, редактировать и удалять пользовательские поля в YouTrack. Есть возможность добавить в систему настраиваемые поля и определить их свойства, не привязывая их к проектам в системе.

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

При создании нового поля можно присоединить его к проекту или позволить администратору проекта при необходимости присоединить это поле.

1.5.2 JIRA

JIRA - это гибкий инструмент управления проектами, который поддерживает любую гибкую методологию, будь то Scrum, Kanban или любая другая, которая соответствует предпочтениям пользователя (рис. 1.6). Можно планировать, отслеживать и управлять всеми Agile проектами разработки программного обеспечения с помощью единого инструмента.

Рисунок 1.6. Интерфейс JIRA

Scrum - это гибкая методология, где продукты строятся в серии итераций фиксированной длины. Есть четыре столпа, которые привносят структуру в эту методологию: планирование спринта, организация ежедневных недолгих собраний, спринты и ретроспективы. Вне зависимости от того, JIRA поставляется с исчерпывающим набором гибких инструментов, которые помогают команде легко выполнять эти события.

Совещания планирования спринтов определяют, что команда должна завершить в предстоящем спринт из отставания, или список работ, которые предстоит сделать. JIRA делает отставание центром вашего совещания по планированию спринта, чтобы вы могли оценивать задачи, настраивать спринты, проверять скорость и переопределять приоритеты в режиме реального времени. В JIRA есть несколько инструментов, которые могут помочь планированию спринта.

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

Как только создано шесть или более задач, появляется возможность начать расставлять их приоритеты в отставании. В JIRA можно расставить приоритеты задач, перетаскивая их в порядке важности отставания, который работает для команды.

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

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

В JIRA можно оценить задачи, перейдя к списку несделанных задач и введя число в поле «Оценка» для каждой задачи.

Затем создаётся Sprint для организации задач в спринты.REST API предоставляет стандартный интерфейс для взаимодействия.API предоставляют доступ к ресурсам (сущностям данных) через пути URI. Чтобы использовать REST API, приложение делает HTTP-запрос и анализирует ответ. Используемые методы - стандартные HTTP-методы, такие как GET, PUT, POST и DELETE. REST API работает через HTTP(s), что упрощает их использование с любым языком программирования или фреймворком. Формат ввода и вывода для JIRA REST API - это JSON.использует плагин Atlassian REST для реализации JIRA API. Плагин REST идёт в комплекте с JIRA. Есть возможность добавить свои собственные REST API к JIRA, создав плагин JIRA, который включает модуль плагинов REST.позволяет добавлять настраиваемые поля в дополнение к встроенным полям. При создании настраиваемого поля необходимо быть администратором проекта и можно выбрать между стандартным и расширенным типами. Для стандартных типов для каждого типа отображается предварительный просмотр, поэтому можно заранее увидеть, что было создано. Это гарантирует, что будет получено желаемое поле намного быстрее. Чтобы настроить шаблоны поиска или добавить контексты в настраиваемые поля, используется параметр «Настроить» в каждом настраиваемом поле.

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

1.5.3 Team Foundation ServerFoundation Server (обычно сокращенно TFS) - это продукт Microsoft, который обеспечивает управление исходным кодом (с Team Foundation Version Control или Git), отчетность, управление требованиями, управление проектами (для agile и waterfall разработки программного обеспечения), автоматизированные сборки, управление тестированием и управление релизами (см. рис. 1.7). Он охватывает весь жизненный цикл приложения и обеспечивает возможности DevOps. поддерживает два типа контроля версий Git и Team Foundation Version Control (TFVC).

В зависимости от того, что используется (Git или TFVC) в качестве репозитория, разрабатывать приложения можно в Android Studio, Eclipse, IntelliJ, Visual Studio, Visual Studio Code или Xcode.

Рисунок 1.7. Интерфейс TFS

может использоваться в качестве back-end для многочисленных интегрированных сред разработки (IDE), но адаптирована для Microsoft Visual Studio и Eclipse на всех платформах. Процесс Scrum поддерживает несколько типов рабочих элементов для планирования и отслеживания работы, тестов, отзывов и обзора кода. С разными типами можно отслеживать различные виды работ, такие как элементы списка незавершённых задач, новые задачи, ошибки и т. д. Эти артефакты создаются при создании командного проекта с использованием процесса Scrum. Они основаны на принципах и ценностях Scrum.

В дополнение к типам рабочих элементов, команды имеют доступ к набору общих запросов рабочих элементов для отслеживания информации, анализа прогресса и принятия решений. Если работа производится в локальной системе TFS, также предоставляется доступ к дополнительным отчетам SQL Server и панелям SharePoint.

Службы Visual Studio Team Services и API Team Foundation Server основаны на REST, OAuth, Json и сервисных перехватах - все стандартные веб-технологии, широко поддерживающиеся в отрасли.

Командный проект может содержать сто или более полей данных на основе процесса - Agile, Scrum или CMMI - используемого для создания командного проекта. Данные обновляются во время изменения поля данных внутри рабочего элемента. Каждый рабочий элемент связан с типом рабочего элемента, и данные, которые можно отслеживать, соответствуют полям, назначенным для типа.

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

Не все списки выбора определяются одинаково. Некоторые списки определяются через пользовательский интерфейс или путем добавления учетных записей пользователей в командный проект.

1.5.4 Bugzillaявляется «системой отслеживания дефектов» или «системой отслеживания ошибок» (рис. 1.8). Системы отслеживания дефектов позволяют отдельным разработчикам или их группам эффективно отслеживать выдающиеся ошибки в своем продукте.

Рисунок 1.8. Интерфейс Bugzilla

Большинство коммерческих поставщиков программного обеспечения для отслеживания дефектов взимают огромные лицензионные сборы. Несмотря на то, что Bugzilla является бесплатным, у него есть множество функций, которых не хватает дорогостоящим коллегам.

Таким образом, Bugzilla быстро стала фаворитом тысяч организаций по всему миру.предоставляет следующее:

1.      Отслеживание ошибок и изменение кода.

2.      Общение с товарищами по команде.

3.      Отправка и просмотр исправлений.

4.      Управление качеством (QA).

Scrum в Bugzilla можно организовать с помощью сторонних расширений. AgileTools предоставляет инструменты для управления командами и их процессами. В настоящее время он поддерживает процесс Scrum и предоставляет инструменты планирования и отслеживания прогресса для команд, использующих процесс Scrum.

Данные, которые необходимо связать с задачей - это данные о пользователе, который получит выгоду от работы, о компоненте продукта, на который он повлияет, и о счете времени, которое представляет воспринимаемую сложность работы. В Bugzilla нет полей для них, но поле catchall, называемое «whiteboard», может быть отформатировано таким образом, чтобы инструменты, такие как BugzillaJS и Scrumbu.gs, могли легко найти его [5]. И когда вы совмещаете это с данными истории ошибок из Bugzilla API, у вас есть все, что вам нужно для расчета графика выполнения работ, скорости команды и разработчика, а также всевозможных даже ужасных вещей.имеет собственный REST API, версию HTTP своего XMLRPC и API JSONRPC. Он документирован вместе с другими интерфейсами WebServices и Bugzilla. Это предпочтительный способ взаимодействия с Bugzilla с внешними приложениями, в Интернете или иным образом.

До недавнего времени Bugzilla поддерживала только более старые технологии, а именно XMLRPC и JSONRPC. Команда BMO создала новый API REST летом 2013 года, чтобы предоставить современный веб-интерфейс для Bugzilla.

До нативного API REST была создана отдельная служба прокси, называемая BzAPI, которая предоставила API REST, используя данные, полученные с помощью более старых интерфейсов RPC, а также различные другие источники данных Bugzilla, включая представления CSV. Дополнительную информацию смотрите в документах на уровне совместимости BzAPI. Пользовательские поля обрабатываются как любые другие поля - они могут быть установлены в проектах и использоваться для поисковых запросов. Пользовательские поля следует добавлять только в случае необходимости и с тщательным учетом.

Перед добавлением настраиваемого поля лучше убедиться, что Bugzilla уже не может выполнить требуемое поведение. Многие параметры Bugzilla по умолчанию не включены, и иногда оказывается, что достаточно просто включить определенные параметры, которые уже существуют.

.5.5 Сравнение представленных систем

Сравнение рассмотренных систем представлено в таблице 1.1.

Таблица 1.1. Сравнение систем по выделенным критериям

На предприятии было принято решение приобрести лицензию Youtrack. Он не является бесплатным, но дешевле всех остальных аналогов и при этом имеет встроенные инструменты управления проектом с помощью методологии Scrum.

1.6 Устав проекта

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

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

.6.1 Описание идеи

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

Также в данной системе есть функция расчёта эффективности конкретного сотрудника, наличие которой позволит оценить работу сотрудника за определённый период времени, рассчитать затраты на заработную плату сотрудников и спланировать будущие затраты. К тому же будет снижена вероятность неэффективного использования ресурсов.

.6.2 Цель и задачи проекта

Основной целью проекта является разработка ПО, состоящего из серверной и клиентской части. ПО представляет собой программный продукт для web-браузеров. В рамках реализации проекта планируется реализовать следующие задачи:

.        Определить рамки системы.

.        Спроектировать архитектуру системы.

.        Спроектировать интерфейсы взаимодействия с пользователем.

.        Разработать программную реализацию ПО.

.        Выполнить тестирование системы.

.        Развернуть систему на аппаратуре заказчика.

.6.3 Актуальность

Описываемый проект реализует потребность заказчика в программном обеспечении (ПО) в виде автоматизированной системы генерации отчётов и работы с тасками основанном на:

-             хранении информации о трудозатратах в системе Youtrack;

-             хранении информации о тасках в системе Youtrack;

-             хранении информации о ролях пользователей и авторизация по данным пользователя из системы Youtrack.

Разработанное программное обеспечение автоматизированной системы генерации отчётов о трудозатратах сотрудников исполнителя позволит снизить трудозатраты сотрудников заказчика за счет уменьшения времени, требуемого на анализ данных (за счёт их визуализации), расчёт эффективности сотрудников и текущее состояние проекта.

.6.4 Возможные риски

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

Таблица 1.2. Возможные риски

.6.5 Классификация рисков

Еще одним результатом совместного обсуждения рисков стал список с их основными причинами, условиями возникновения, последствиями и возможным ущербом (табл. 1.3).

Таблица 1.3. Классификация рисков

.6.6 Анализ и приоритезация рисков

Список с приоритетами рисков представлен в таблице 1.4.

Таблица 1.4. Анализ и приоритезация рисков

Инвестором будет являться заказчик. Проект реализуется в рамках существующей компании ООО «Смарт Аналитикс».

2. Проектирование надстройки

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

.1 Проектирование извлечения данных из YouTrack

использует встроенную базу данных JetBrains Database - транзакционное хранилище пар «ключ - значение». Для удалённых вызовов процедур используется REST-стиль.

Пользовательский тип поля - это формат, который присваивается значениям, хранящимся в поле. Этот формат определяет, как YouTrack интерпретирует данные.

Поддерживаемые типы можно разделить на две категории [7]:

1.      Простые типы - эти типы включают типы даты, целого и строки.

.        Перечисляемые типы - эти типы позволяют выбирать значения из предопределенного списка. Простые типы хранят отдельные значения в определенном формате. Среди простых типов, которые поддерживаются в YouTrack есть такие, как: string, date, period, integer, float.

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

Таблица 2.1. Перечисляемые типы полей в YouTrack

Типы полей характеристик проекта представлены в таблице 2.2.

Таблица 2.2. Типы полей проекта

Для извлечения значений полей необходимо воспользоваться REST API, который предоставляет YouTrack. Запросы варьируются в зависимости от типа извлекаемого значения:

1.      GET /rest/admin/customfield/stateBundle/{bundleName} - возвращает группу значений состояний по её имени.

.        GET /rest/admin/agile/{agileById}/sprint/{sprintById} - возвращает информацию о спринте по его Id.

.        GET /rest/admin/customfield/versionBundle/{bundleName} - возвращает группу значений версий по её имени.

.        GET /rest/admin/project/{projectName}/assignee - возвращает всех участников проекта.

.        GET /rest/admin/customfield/userBundle/{bundleName} - возвращает группу значений пользователей по её имени.

.        GET /rest/admin/customfield/bundle/{bundleName} - возвращает значение из группы значений перечисляемого типа.

.        GET /rest/admin/project/{projectId}/customfield/{customFieldName} - возвращает настраиваемое поле проекта по его имени.

Также у пользователя должна быть возможность создавать новые задачи и редактировать существующие: PUT /rest/issue?{project}&{summary}&{description}&{attachments}&{permittedGroup} - создание новой задачи в YouTrack.

1.      POST /rest/issue/{issueID}?{summary}&{description} - редактирование существующей задачи.

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

Аутентификация пользователя в YouTrack также производится через REST API. Соответствующий запрос: POST /rest/user/login?{login}&{password}, где login - логин пользователя в системе YouTrack, password - пароль пользователя в системе YouTrack. Запрос возвращает cookie аутентификации, с помощью которой пользователь сможет производить действия через систему.

.2 Проектирование интерфейса надстройки

Конечный пользователь системы будет работать с задачами из YouTrack и сформированными отчётами о задачах и трудозатратах. Функции, предусмотренные в рамках первой версии системы и требующие собственного интерфейса:

1.      Страница просмотра списка задач.

.        Страница просмотра списка отчётов.

.        Страница просмотра отчёта.

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

.        Страница создания новой задачи.

Главная страница приложения содержит список задач (рис. 2.1). Списки задач сгруппированы по поисковым запросам пользователя из YouTrack, которые отражены в боковой панели. Основной блок контента содержит список задач по выбранному запросу. Вверху страницы находится панель с кнопками переключения между списком задач из YouTrack и списком отчётов, а также кнопка создания новой задачи.

Рисунок 2.1. Макет главной страницы приложения

Чтобы отобразить список отчётов необходимо нажать на кнопку отображения списка отчётов. Произойдёт смена заголовка боковой панели и её содержание (см. рис. 2.2). Также при нажатии на отчёт в списке отчётов в основном блоке контента будет показано превью отчёта.

Рис. 2.2. Макет страницы приложения со списком отчётов

Отредактировать задачу можно при просмотре её подробной информации (рис. 2.3). Дизайн страницы создания задачи аналогичен странице просмотра детальной информации задачи, за исключением вкладок «Комментарии», «История» и «Связанные задачи».

Рисунок 2.3. Макет страницы просмотра подробной информации задачи

.3 Взаимодействие с системой

Описание действий, совершаемых при взаимодействии пользователя и системы показаны в диаграммах прецедентов.

Название прецедента №1: Работа с отчётами (рис. 2.4).

Акторы: Зарегистрированный пользователь с любыми правами доступа.

Краткое описание: Пользователь открывает систему, авторизуется и совершает необходимые ему действия (просмотр отчёта, смена временной отметки в отчёте).

Основной поток (табл. 2.3):

Таблица 2.3. Работа с отчётами

Рисунок 2.4. Использование надстройки. Работа с отчётами.

Название прецедента №2: Работа в надстройке с задачами из YouTrack.

Акторы: Пользователь с правами Администратора, пользователь с правами редактирования и просмотра задач, пользователь с правами просмотра задач.

Краткое описание: Авторизованный пользователь открывает главную страницу приложения и совершает необходимые ему действия (просматривает, редактирует информацию о диаграммах и пользователях).

Потоки действий (табл. 2.4):

Таблица 2.4. Работа в надстройке с задачами из YouTrack

Глава 3. Разработка и тестирование надстройки

В результате этапа проектирования было получено представление о системе и её реализации. В главе рассматриваются использованные технологии реализации и приведены фрагменты кода надстройки.

.1 Средства разработки и технологии

Была изучена документация по выбранным языкам программирования (C# для серверной части, TypeScript для клиентской части) и библиотекам (ReactJS, Highcharts). Также возможно было использовать язык программирования Java, но в организации мало людей, которые работали с ним, и гораздо меньше опыта работы с этим языком. ReactJS дает возможность ускорить работу приложения, обновляя только конкретные компоненты на странице с отчетом, а не на всей странице. Highcharts - это библиотека, которая помогает создавать интерактивные диаграммы для веб-страницы. Одновременный доступ к данным и различные права доступа могут быть обеспечены выбранными технологиями.- библиотека для создания графиков написанная на JavaScript, позволяет легко добавлять интерактивные, анимированные графики на сайт или в веб-приложение. На данный момент графиков поддерживают большое количество диаграмм линейных, круговых, колоночных рассеивающих и многих других типов.

Поддерживаются следующие типы вывода графиков [4]:(см. рис. 3.1);;;;;;;;

другие.

Рисунок 3.1. График типа line

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

3.2 Результат разработки

При первоначальном входе в систему пользователю высвечивается страница с формой авторизации (рис. 3.2).

Рисунок 3.2. Окно авторизации приложения

Пользователь вводит свои данные и нажимает кнопку Log In. Происходит запрос к API системы YouTrack и при её успешном выполнении сохраняется cookie аутентификации. Код метода получения и сохранения cookie:

public YouTrackAuthCookie GetAuthenticationCookieFromYouTrack(string login, string password)request = new RestRequest("/rest/user/login", Method.POST);

request.AddParameter("login", login);

request.AddParameter("password", password);

var response = this._client.Execute(request);

 this.EnsureOkResponseStatus(response, "Cannot authenticate user on YouTrack instance '{0}', login '{1}', status code {2}",

this._client.BaseUrl,

login,

response.StatusCode);

var authCookie = response.Cookies

.FirstOrDefault(cookie => cookie.Name == YOUTRACK_AUTH_COOKIE);

if (authCookie == null)

{

var message = string.Format("Cannot found YouTrack authentication cookie ({0}) in response to {1} for user {2}",

YOUTRACK_AUTH_COOKIE, this._client.BaseUrl,

login);

throw new ApplicationException(message);

}

var authCookieInfo = new YouTrackAuthCookie

{

Name = authCookie.Name,

Value = authCookie.Value,

Domain = authCookie.Domain,

Path = authCookie.Path,

HttpOnly = authCookie.HttpOnly,

Secure = authCookie.Secure,

Expires = authCookie.ExpiresauthCookieInfo;

}

При успешном входе пользователь перенаправляется на главную страницу приложения (см. рис. 3.3). Если возникает ошибка авторизации, пользователю высвечивается уведомление об ошибке. Главная страница приложения содержит список поисковых запросов пользователя из YouTrack в боковой панели и список задач выбранного запроса.

В верхней панели добавлены кнопки создания новой задачи, переключения между списками задач и отчётов, выхода из приложения и поле поиска задачи, с префиксом проекта (сокращённое название проекта из YouTrack).

Рисунок 3.3. Интерфейс приложения, вкладка Issues (задачи)

Для перехода к списку отчётов используется кнопка Reports (рис. 3.4). При её нажатии список задач меняется на список отчётов. После выбора любого отчёта из списка появляются его превью. Для перехода к отчёту используется кнопка Go to report.

Рисунок 3.4. Превью отчёта Delivery

Чтобы создать новую задачу необходимо нажать кнопку Submit New Request, после чего появляется форма как на рисунке 3.5. Пользователь заполняет необходимые поля и нажимает кнопку Submit New Request. Происходит запрос на создание новой задачи к API YouTrack:

 static createIssue(title, description, callback, context) {

Youtrack._req("CreateIssue",

"/rest/issue",

Youtrack._paramsToUrl({ y_project: encodeURIComponent(Settings.ProjectId), y_summary: encodeURIComponent(title), y_description: encodeURIComponent(description) }),

callback, context);

 }

Рисунок 3.5. Создание новой задачи

Ест возможность выбрать задачу из списка и просмотреть её детали (см. рис. 3.6). Задачу можно отредактировать, нажав кнопку редактирования в правом верхнем углу деталей задачи. Запрос обновления задачи к API YouTrack:

 static updateIssue(data: { issueId: string; title: string; description: string; }, callback, context) {

Youtrack._req("POST", "/rest/issue/" + data.issueId,

Youtrack._paramsToUrl({ y_summary: encodeURIComponent(data.title), y_description: encodeURIComponent(data.description) }),

callback, context, );

 }

Боковая панель группирует запросы по сохранённым поисковым запросам пользователя из YouTrack:

static getSavedSearches(callback, context) {

const login = Youtrack._getCurrentLogin();

Youtrack._req("GET",

"/rest/user/" + login + "/filter", null,

 callback, context);

}

Рисунок 3.6. Просмотр деталей задачи

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

Заключение

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

С участием заказчика определены требования к функциям, интерфейсу и средствам создания надстройки. С их учётом разработан проект надстройки, который включает в себя описание работы с данными о проекте, способы их извлечения из системы YouTrack, устройство и взаимодействие компонентов системы, обоснованы средства реализации системы и инструменты, применённые в ходе работ.

Также представлена начальная версия интерфейса системы. Архитектура системы спроектирована с учётом возможных расширений в будущем. Разработана первая версия надстройки с необходимой функциональностью, выбраны технологии реализации и проект согласован с заказчиком. Вычисления из файла Excel перенесены в систему, созданы необходимые отчёты в виде графиков. Функционал реализован с использованием заявленных заказчиком технологий. Планируется поддержка проекта и обновление, возможно его расширение. В систему могут быть добавлены новые отчёты, содержащие информацию не только о трудозатратах, но и о самом проекте.

На данный момент система внедрена на предприятии и используется по назначению более чем двадцатью людьми.

Библиографический список

1.      A brief look into using the scrum framework for software development. [Электронный ресурс] URL: https://www.atlassian.com/agile/scrum (дата обращения: 28.04.2017).

.        Agile Boards. [Электронный ресурс] URL: https://www.jetbrains.com/youtrack/features/agile_project_management.html (дата обращения: 28.04.2017).

.        Definition of visualization. [Электронный ресурс] URL: #"896790.files/image019.jpg">

Рисунок A.1. Использование надстройки. Работа в надстройке с задачами из YouTrack

Рисунок А.2. Диаграмма классов надстройки

Приложение B. Код приложения

Запросы к Youtrack (youtrack.ts):

import * as $ from "jquery";{ JsonCache } from "../helpers/jsonCache";{ hashHistory } from 'react-router';{ spaPatternUrls } from "../helpers/urlHelper";{ Settings } from "../settings";class Youtrack {

private static _server: string;

constructor() {

}

 private static _req(method, api_path, parametrs: string, callback, context, body?) {

const c = JsonCache.getItem<string>("authCookie");

let url = "/Proxy/" + method + Youtrack._paramsToUrl({ c: encodeURIComponent(c), p: encodeURIComponent(api_path) }) + (parametrs ? parametrs.replace("?", "&") : "");

 var req = new XMLHttpRequest();

context = context || this;

req.onreadystatechange = function () {

if (req.readyState == 4) {

if (req.status == 200) {

let res = JSON.parse(req.responseText || "{}");

if (res && res.value && (res.value == "You are not logged in." || res.value == "User not found or you have no permission to read user.")) {

hashHistory.push(spaPatternUrls.auth());

}

else {

callback.call(context, res);

}

}

else {

callback.call(context, JSON.parse(req.responseText || "{}"));

}

}

};

method = method == "GET" || method == "POST" ? method : "GET";

 req.open(method, url, true);

req.timeout = 40000;

if (req.setRequestHeader) {

req.setRequestHeader("Accept", "application/json");

}

req.send(body || "");

}

private static _getCurrentLogin() {

return JsonCache.getItem<string>("userLogin");

}

private static _paramsToUrl(dict) {

dict = dict ? dict : [];

const result = [];

for (let prop in dict) {

result.push("{0}={1}".replace("{0}", prop)

.replace("{1}", dict[prop]));

}

return result.length == 0 ? "" : `?${result.join("&")}`;

}

 static search(query, callback, offset, context, limit) {

limit = limit || 1000;

Youtrack._req("GET",

"/rest/issue/search",

Youtrack._paramsToUrl({ y_filter: encodeURIComponent(query), y_after: encodeURIComponent(offset), y_max: encodeURIComponent(limit) }),

callback, context);

}

static getCurrentUser(callback, context) {

return this.getUserInfo("current", callback, context);

}

static getSavedSearches(callback, context) {

const login = Youtrack._getCurrentLogin();

Youtrack._req("GET",

"/rest/user/" + login + "/filter", null,

callback, context);

}

 static getUserInfo(login, callback, context) {

login = login || Youtrack._getCurrentLogin() || "current";

Youtrack._req("GET",

"/rest/user/" + login, null,

callback, context);

}

 static getIssues(query, callback, context) {

Youtrack._req("GET", "/rest/issue", Youtrack._paramsToUrl({ y_filter: encodeURIComponent(query) }),

callback, context);

}

 static getIssue(id, callback, context) {

Youtrack._req("GET",

"/rest/issue/" + id, Youtrack._paramsToUrl({ y_wikifyDescription: true }),

callback, context);

}

 static getIssuesCount(query, callback, context) {

Youtrack._req("GET", "rest/issue/count", Youtrack._paramsToUrl({ y_filter: encodeURIComponent(query) }),

callback, context);

 static downloadAttach(link: string, callback, context) {

link = link.replace(Settings.YoutrackServer + "/_persistent/", "");

let y_file = link.split("?")[1].split("&")[0].split("=")[1];

let y_c = link.split("?")[1].split("&")[1].split("=")[1];

link = link.split("?")[0];

 window.open("Attach/Get" + Youtrack._paramsToUrl({

c: encodeURIComponent(JsonCache.getItem<string>("authCookie")),

f: encodeURIComponent(link.split("?")[0]),

y_file: encodeURIComponent(y_file),

y_c: encodeURIComponent(y_c)

}), "_black");

}

 static updateIssue(data: { issueId: string; title: string; description: string; }, callback, context) {

Youtrack._req("POST", "/rest/issue/" + data.issueId,

Youtrack._paramsToUrl({ y_summary: encodeURIComponent(data.title), y_description: encodeURIComponent(data.description) }),

callback, context, );

}

 static executeCommand(issueId, dict, callback, context) {

let command = "";

for (let item in dict) {

command += item + " " + dict[item] + " ";

}

Youtrack._req("POST", "/rest/issue/" + issueId + "/execute", null,

callback, context, "command=" + encodeURIComponent(command));

}

 static createIssue(title, description, callback, context) {

Youtrack._req("CreateIssue",

"/rest/issue",

Youtrack._paramsToUrl({ y_project: encodeURIComponent(Settings.ProjectId), y_summary: encodeURIComponent(title), y_description: encodeURIComponent(description) }),

callback, context);

}

 static getIssueChanges(id, callback, context) {

Youtrack._req("GET",

"/rest/issue/" + id + "/changes", null,

callback, context);

}

 static getIssueLinks(id, callback, context) {

Youtrack._req("GET",

"/rest/issue/" + id + "/link", null,

callback, context);

}

}

Кэширование данных (jsonCache.ts):

interface CacheItem<TEntity> {

value: TEntity;

userKey: number;

}class JsonCache {

private static _getKey(key?) {

if (!key)

key = "JsonCache";

return `JsonCache.${key}`;

}

private static _getStorage() {

return window.localStorage;

}

static removeItem(key) {

const sessionKey = this._getKey(key);

const storage = this._getStorage();

const result = storage[sessionKey] ? true : false;

storage.removeItem(sessionKey);

return result;

}

private static _getUserKey() {

return -1;

}

static getItem<TEntity>(key) {

const sessionKey = this._getKey(key);

const storage = this._getStorage();

const storageItemValue = storage.getItem(sessionKey);

const storageItemValueObject: CacheItem<TEntity> = storageItemValue && JSON.parse(storageItemValue);

let result = storageItemValueObject && storageItemValueObject.value;

if (storageItemValueObject) {

if (storageItemValueObject.userKey !== this._getUserKey()) {

this.removeItem(key);

result = null;

}

}

return result;

}

 static setItem<TEntity>(key: string, value: TEntity) {

const sessionKey = this._getKey(key);

const storage = this._getStorage();

 const result: CacheItem<TEntity> = { value: value, userKey: this._getUserKey() };

storage.setItem(sessionKey, JSON.stringify(result));

}

}

Работа с задачами (IssueHelper.ts):

import { Issue } from "../base";{ Settings } from "../settings";class issueHelper {

static _parseDateTime(dateTime) {

let createdDate = new Date(parseInt(dateTime)).toUTCString();

return createdDate = createdDate.substring(createdDate.indexOf(",") + 2, createdDate.lastIndexOf(":"));

}

 static _getDefaultValueIfEmpty(name: string, nullIfEmpty?: boolean) {

if (nullIfEmpty) return "";

return "No " + name.toLowerCase();

}

 static getIssueFieldValueByName(issue: Issue, name: string, nullIfEmpty?: boolean): any {

let result;

if (!issue) return this._getDefaultValueIfEmpty(name, nullIfEmpty);

if (name == RequiredFields.id) {

return issue && issue.id || this._getDefaultValueIfEmpty(name);

}

 var field = issue.field.filter(function (item) {

return item.name == name;

})[0];

 if (!field) return this._getDefaultValueIfEmpty(name, nullIfEmpty);

if (name == RequiredFields.updated || name == RequiredFields.created) {

result = this._parseDateTime(field.value)

}

if (name == "Assignee") {

result = JSON.parse(JSON.stringify(field.value[0])).fullName;

}

if (name == "Estimation" || name == "Estimation DB" || name == "Estimation Web" || name == "Estimation Testing") {

result = JSON.parse(JSON.stringify(field)).valueId[0];

}

return result || field && field.value || "";

}

static getValuesForRequiredFields(issue: Issue): {

id: string;

summary: string;

description: string;

created: string;

updated: string;

reporterFullName: string;

updaterFullName: string;

attachments: string;{

id: this.getIssueFieldValueByName(issue, RequiredFields.id, true),

summary: this.getIssueFieldValueByName(issue, RequiredFields.summary, true),

description: this.getIssueFieldValueByName(issue, RequiredFields.description, true),

created: this.getIssueFieldValueByName(issue, RequiredFields.created, true),

updated: this.getIssueFieldValueByName(issue, RequiredFields.updated, true),

reporterFullName: this.getIssueFieldValueByName(issue, RequiredFields.reporterFullName),

updaterFullName: this.getIssueFieldValueByName(issue, RequiredFields.updaterFullName),

attachments: this.getIssueFieldValueByName(issue, RequiredFields.attachments)

}

}

static getSettingsField(fieldName: string) {

return Settings.IssueFields.filter((item) => { return item.youtrackId == fieldName })[0];

}

 static isNeedToShowField(fieldName: string): boolean {

let field = this.getSettingsField(fieldName);

return !!(field && field.show);

}

 static isCanBeEditField(fieldName: string): boolean {

let field = this.getSettingsField(fieldName);

return !!(field && field.edit);

}

 static getFileldDisplayName(fieldName: string): string {

let field = this.getSettingsField(fieldName);

return (field && field.displayName) || fieldName;

}

 static getFileldWorkflow(fieldName: string): string {

let field = this.getSettingsField(fieldName);

return (field && field.workflow) || null;

}

static getFileldDafaultValue(fieldName: string): string {

let field = this.getSettingsField(fieldName);

return (field && field.default) || this._getDefaultValueIfEmpty(fieldName);

}

}var RequiredFields = {

id: "id",

summary: "summary",

description: "description",

created: "created",

updated: "updated",

updaterFullName: "updaterFullName",

reporterFullName: "reporterFullName",

attachments: "attachments"

};

Извлечение значений полей (FieldsHelper.cs):

using System;System.Collections.Generic;System.Linq;Helpers

{

using System.Net;

using RestSharp;

public class FieldsHelper : BaseRestSharpHelper

{

private readonly RestClient _client;

private readonly string _youtrackUrl;

private string _authCookieValue;

private JsonConfigHelper _config;

private const string ENUM_TYPE = "enum[1]";

private const string USER_TYPE = "user[1]";

private const string VERSION_BUNDLE = "version[1]";

private const string STATE_BUNDLE = "state[1]";

 private readonly string[] _supportedTypes = new string[] { ENUM_TYPE ,

USER_TYPE,

VERSION_BUNDLE,

STATE_BUNDLE };

 public FieldsHelper(string youtrackUrl, JsonConfigHelper configHelper)

{

this._client = new RestClient(youtrackUrl);

_youtrackUrl = youtrackUrl;

this._client.CookieContainer = new CookieContainer();

this._config = configHelper;

}

 public List<string> GetFieldValues(string projectId, string fieldName)

{

string fieldType;

string bundleName = GetEnumBundleName(projectId, fieldName, out fieldType);

List<string> filedValues = new List<string>();

if (fieldType == ENUM_TYPE)

{

filedValues = GetBundleValues(bundleName);

}

else if (fieldType == USER_TYPE)

{

filedValues = fieldName == "Assignee" ? GetAssignees(projectId) : GetUserBundleValues(bundleName);

}

else if (fieldType == VERSION_BUNDLE)

{

filedValues = fieldName == "Sprints"? null : GetVersionBundleValues(bundleName);

}

else if (fieldType == STATE_BUNDLE)

{

filedValues = GetStateBundleValues(bundleName);

}

return filedValues;

}

 private List<string> GetStateBundleValues(string stateBundleName)

{

List<string> values = new List<string>();

 var request = new RestRequest("/rest/admin/customfield/stateBundle/{bundleName}", Method.GET);

request.AddUrlSegment("bundleName", stateBundleName);

string authCookie = GetAdminAuthCookieValue();

AuthHelper.AddAuthCookie(request, authCookie);

 var response = this._client.Execute<dynamic>(request);

this.EnsureOkResponseStatus(response, "Cannot get values for state bundle '{0}', status code {1}",

stateBundleName,

response.StatusCode);

 foreach (dynamic v in response.Data["state"])

{

values.Add(v["value"]);

}

return values;

}

public string GetAdminAuthCookieValue()

{

if (!string.IsNullOrEmpty(this._authCookieValue))

{

return this._authCookieValue;

}

 AuthHelper authHelper = new AuthHelper(_youtrackUrl);

var authCookie = authHelper.GetAuthenticationCookieFromYouTrack(

_config.SuperUserLogin,

_config.SuperUserPassword);

this._authCookieValue = authCookie.Value;

return this._authCookieValue;

}

 private List<string> GetSprints(string versionBundleName)

{

List<string> values = new List<string>();

 var request = new RestRequest("/rest/admin/customfield/versionBundle/{bundleName}", Method.GET);

request.AddUrlSegment("bundleName", versionBundleName);

string authCookie = GetAdminAuthCookieValue();

AuthHelper.AddAuthCookie(request, authCookie);

 var response = this._client.Execute<dynamic>(request);

this.EnsureOkResponseStatus(response, "Cannot get values for version bundle '{0}', status code {1}",

versionBundleName,

response.StatusCode);

 foreach (dynamic v in response.Data["version"])

{

values.Add(v["value"]);

}

return values;

}

 private List<string> GetVersionBundleValues(string versionBundleName)

{

List<string> values = new List<string>();

 var request = new RestRequest("/rest/admin/customfield/versionBundle/{bundleName}", Method.GET);

request.AddUrlSegment("bundleName", versionBundleName);

string authCookie = GetAdminAuthCookieValue();

AuthHelper.AddAuthCookie(request, authCookie);

 var response = this._client.Execute<dynamic>(request);

this.EnsureOkResponseStatus(response, "Cannot get values for version bundle '{0}', status code {1}",

versionBundleName,

response.StatusCode);

 foreach (dynamic v in response.Data["version"])

{

values.Add(v["value"]);

}

return values;

}

 private List<string> GetAssignees(string projectName)

{

List<string> values = new List<string>();

 var request = new RestRequest("/rest/admin/project/{projectName}/assignee", Method.GET);

request.AddUrlSegment("projectName", projectName);

string authCookie = GetAdminAuthCookieValue();

AuthHelper.AddAuthCookie(request, authCookie);

 var response = this._client.Execute<dynamic>(request);

this.EnsureOkResponseStatus(response, "Cannot get values for user bundle '{0}', status code {1}",

projectName,

response.StatusCode);

 foreach (dynamic v in response.Data["assignees"])

{

values.Add(v["login"]);

}

return values;

}

 private List<string> GetUserBundleValues(string userBundleName)

{

List<string> values = new List<string>();

 var request = new RestRequest("/rest/admin/customfield/userBundle/{bundleName}", Method.GET);

request.AddUrlSegment("bundleName", userBundleName);

string authCookie = GetAdminAuthCookieValue();

AuthHelper.AddAuthCookie(request, authCookie);

 var response = this._client.Execute<dynamic>(request);

this.EnsureOkResponseStatus(response, "Cannot get values for user bundle '{0}', status code {1}",

userBundleName,

response.StatusCode);

 foreach (dynamic v in response.Data["user"])

{

values.Add(v["login"]);

}

return values;

}

 private List<string> GetBundleValues(string bundleName)

{

List<string> values = new List<string>();

 var request = new RestRequest("/rest/admin/customfield/bundle/{bundleName}", Method.GET);

request.AddUrlSegment("bundleName", bundleName);

string authCookie = GetAdminAuthCookieValue();

AuthHelper.AddAuthCookie(request, authCookie);

 var response = this._client.Execute<dynamic>(request);

this.EnsureOkResponseStatus(response, "Cannot get values for bundle '{0}', status code {1}",

bundleName,

response.StatusCode);

 foreach (dynamic v in response.Data["value"])

{

values.Add(v["value"]);

}

return values;

}

 private string GetEnumBundleName(string projectId, string fieldName, out string fieldType)

{

var request = new RestRequest("/rest/admin/project/{projectId}/customfield/{customFieldName}", Method.GET);

request.AddUrlSegment("projectId", projectId);

request.AddUrlSegment("customFieldName", fieldName);

string authCookie = GetAdminAuthCookieValue();

AuthHelper.AddAuthCookie(request, authCookie);

 var response = this._client.Execute<dynamic>(request);

this.EnsureOkResponseStatus(response, "Cannot get values for field '{0}', status code {1}",

fieldName,

response.StatusCode);

 fieldType = response.Data["type"];

if (!_supportedTypes.Contains(fieldType))

{

string message = string.Format("Only fields with type {0} can be returned, but {1} was returned",

string.Join(", ", _supportedTypes),

response.Data["type"]);

}

return response.Data["param"][0]["value"];

}

}

}