Развертывание приложения SDLC

подсказка

Требуемая роль: admin.

Развертывание приложения SDLC включает в себя следующие этапы:

1. Установка приложения SDLC.
2. (опционально) Установка пакета интеграции SDLC-ITSM.
3. (опционально) Развертывание демоданных.

Установка приложения SDLC

Для установки приложения SDLC, установите SOP-файл [SDLC] X.X.X full.sop, где X.X.X соответствует устанавливаемой версии приложения.

Установка обновлений

---

подсказка

Требуемая роль: admin.

Устанавливайте все версии и патчи по порядку. При обновлении установленного приложения SDLC могут потребоваться дополнительные действия. Необходимую информацию об установке той или иной версии вы можете найти в соответствующих вкладках ниже.

Для обновления на версии, не описанные ниже, не требуется специальных действий. Установите на ваш экземпляр SOP-файл [SDLC] X.X.X.sop, где X.X.X соответствует следующей версии приложения после той, которая установлена у вас. Повторите, если нужно обновить на более, чем одну версию.

1.9.1

Обновление с версии 1.9.0 на версию 1.9.1

В этом обновлении были добавлены новые опции для виджета доски Scrum-проекта. Если на вашем экземпляре присутствует пользовательская настройка экземпляра виджета Header scrum board, перед установкой обновления:

1. Перейдите в Структура портала → Экземпляры виджетов.
2. Найдите запись экземпляра виджета Header scrum board и перейдите на ее форму.
3. Скопируйте значение поля Значения опций схемы.

После установки SOP-файла с обновлением снова перейдите на форму экземпляра виджета Header scrum board, вставьте скопированное значение в поле Значения опций схемы и нажмите Сохранить, чтобы вернуть пользовательские настройки.

При последующих обновлениях приложения выполнять эти действия не требуется.

1.9.0

Обновление с версии 1.8.1 на версию 1.9.0

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

1. В навигаторе перейдите в Настройка системы → Серверные скрипты.
2. Откройте форму записи скрипта Migration script subscription available, расположенного по адресу {URL вашего экземпляра}/record/sys_script/176638945014335381.
3. Нажмите Запустить внизу формы.

При последующих обновлениях приложения выполнять эти действия не требуется.

1.8.0

Обновление с версии 1.7.0 на версию 1.8.0

Для загрузки обновления SDLC 1.8.0 импортируйте SOP-файл с изменениями приложения. Далее проведите миграцию на новую версию. Для этого запустите скрипт Migration script for SDLC 1.8.0 version, расположенный по адресу {URL вашего экземпляра}/record/sys_script/175672220206187254.

Миграция проходит в три основных этапа:

1. Основной этап миграции, на котором вносится наибольшая часть изменений.
2. Миграция при вызове системного события SDLC.1.8.0.task_fields_feature_states.
3. Миграция при вызове системного события SDLC.migration_1.8.0.task_state_update.

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

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

Основной этап миграции

Список изменений, производимых на основном этапе миграции:

1. Удаление записей таблицы Правила оформления колонок (sys_style_rule_column) для опций статусов со Значениями canceled и released таблицы Задачи SDLC (pda_backlog_item) и дочерних таблиц.
2. Удаление записей со Значениями canceled и released в таблице Настройка опций (sys_choice) для поля Статус таблицы Задачи SDLC (pda_backlog_item) и дочерних таблиц.
3. Создание записей Отменено, Выпущено в таблице Метки форм (sys_color_table_label) для таблицы Задачи SDLC (pda_backlog_item) и дочерних таблиц.
4. Заполнение поля Статусная модель в записях таблицы Типы задач (pda_task_type): указывается модель, Таблица которой соответствует той таблице, опции поля Статус которой применяются для типа задач. Это может быть таблица типа задач, если вы переопределяли для нее опции поля Статус, или одна из родительских таблиц: Задачи SDLC (pda_backlog_item) или Задачи (task). Если такой статусной модели нет, поле остается пустым. Если таких статусных моделей более одной, указывается запись, созданная ранее.
5. Создание записей Статусных моделей в проекте (pda_state_model_project) для каждого проекта и добавленных к ним типов задач. Указывается модель, Условие которой содержит "Проект равно текущему проекту" и "Тип задачи равен текущему типу задачи".
6. Внесение изменений в таблицу Столбцы доски (board_column):
   • Все записи столбцов пересоздаются. Пользовательские настройки столбцов перезаписываются настройками по умолчанию.
   • Столбцы для "коробочных" статусов Бэклог, Разработка, Проверка, Тестирование, Готово и статусов с совпадающими Значениями создаются Активными. Столбцы для других статусов, включая пользовательские, создаются неактивными.
   • Если существуют опции статуса с одинаковым Значением, для них создается только один столбец.

Системные события

Системные события, обновляющие записи таблицы Задачи SDLC (pda_backlog_item) и дочерних таблиц в ходе миграции:

1. SDLC.1.8.0.task_fields_feature_states – событие:

   • заполняет поле Тип задачи на формах задач значением типа задачи, который соответствует таблице записи;

   • меняет отображаемое наименование всех задач в соответствии с новым шаблоном {number} + [{pda_project_code}] + {subject};

   • меняет статусы существующих фич в соответствии с обновленной статусной моделью:

     Статус до миграции	Статус после миграции
     Новый	Воронка
     Разработка, Проверка, Тестирование	Реализация
     Готово	Завершена

2. SDLC.migration_1.8.0.task_state_update – если задача находится в статусе Отменено или Выпущено, событие меняет ее статус на предыдущий согласно таблице Изменения статусов задач SDLC (pda_task_state_history) и присваивает ей признак Отменено или Выпущено. Если предыдущая запись истории не найдена, устанавливается значение статуса --Нет--.

к сведению

При вызове системных событий для миграции записи обновляются по сто за раз. Если на экземпляре больше ста записей таблицы Задачи SDLC (pda_backlog_item) и дочерних таблиц, системные события автоматически вызываются до полной обработки всех записей.

Возможные ошибки

Основной этап миграции

Ошибка: [SDLC Migration 1.8.0] Errors while running the migration:

• Failed to {the_action_performed_by_the_function} in the function {function_name}:
  • {Error}. ({record_id})

Решение:

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

Системное событие SDLC.1.8.0.task_fields_feature_states

Ошибка: [SDLC migration 1.8.0] Errors while updating Task type, Display name, or State for features in records:

• {Error}. ({record_id})

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

Системное событие SDLC.migration_1.8.0.task_state_update

Ошибка: [SDLC migration 1.8.0] Errors while updating State in records:

• {Error}. ({record_id})

Решение:

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

1.6.0

Обновление с версии 1.5.2 на версию 1.6.0

В этом обновлении была добавлена настройка фильтрации карточек на досках. Чтобы она работала, необходимо запустить скрипт, который заполнит поле Таблица фильтрации (pda_table_id) для существующих в системе досок. Мы также обновили демоданные, однако их переустановка не требуется: если вы запустите скрипт, как описано ниже, необходимые изменения будут внесены и в них.

Если на вашем экземпляре есть доски задач, после установки обновления выполните следующие действия:

1. В навигаторе перейдите в Настройка системы → Серверные скрипты.
2. Откройте форму записи скрипта Mirgation script for table for filter, расположенного по адресу {URL вашего экземпляра}/record/sys_script/174584256514191079.
3. Нажмите Запустить внизу формы.

При последующих обновлениях приложения выполнять эти действия не требуется.

1.1.3

Обновление с версии 1.1.2 на версию 1.1.3

В этом обновлении было исправлено некорректное системное наименование одного из статусов спринта.

Если в таблице Спринты (pda_sprint) есть записи, вам необходимо выполнить следующие действия после завершения обновления 1.1.3:

1. Импортируйте SOP-файл [SDLC]_STR0003361_Fix_state_for_sprint.sop.
2. В навигаторе перейдите в Настройка системы → Серверные скрипты
3. Откройте форму записи скрипта Fix incorrect state for sprint.
4. Нажмите Запустить внизу формы.

При последующих обновлениях приложения выполнять эти действия не требуется.

1.2.1

Обновление с версии 1.2.0 на версию 1.2.1

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

Создание истории существующих задач

1. Импортируйте SOP-файл [SDLC]_STR0003993_Create_SDLC_Task_State_Change_Records.sop.
2. В навигаторе перейдите в Настройка системы → Серверные скрипты.
3. Откройте форму записи скрипта Create history records for tasks.
4. Нажмите Запустить внизу формы.

Процесс выполнения скрипта можно контролировать по записям в таблице Основной журнал (sys_log). В журнал записывается информация после обработки каждых 500 записей. После завершения работы скрипта в журнале появляется запись "Migration script finished".

В зависимости от числа записей в таблице Задачи SDLC работа скрипта может занять некоторое время. Ориентировочная продолжительность обработки 10 000 записей – 25–30 мин.

При последующих обновлениях приложения выполнять эти действия не требуется.

1.3.1

Обновление с версии 1.3.0 на версию 1.3.1

В этом обновлении дополнена логика списания трудозатрат с форм задач и из окна предпросмотра задач на досках проектов. Теперь при списании трудозатрат учитываются лимиты, введенные в версии 1.1.1 приложения Управление работой и временем (WTM).

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

предупреждение

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

1. Импортируйте SOP-файл [SDLC]_STR0004547_Update_time_spent_in_SDLC_Tasks_and_Timesheets.sop.
2. В навигаторе перейдите в Планировщик → Запланированные скрипты.
3. Откройте форму записи скрипта [SDLC] Update time spent in SDLC Tasks and Timesheets.
4. Установите флажок Активно.
5. Укажите удобные дату и время в поле Дата и время запуска.
6. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

Скрипт будет запущен в указанное время и обновит значения поля Общие трудозатраты (pda_total_time_spent) в записях задач и записи таблицы Табель трудозатрат (wtm_timesheet) на основе созданных Карточек трудозатрат (wtm_timecard). Процесс выполнения скрипта можно контролировать в Основном журнале (sys_log).

В зависимости от числа записей работа скрипта может занять некоторое время. Ориентировочная продолжительность обработки 10 000 записей таблицы Задачи SDLC и 1000 записей таблицы Табель трудозатрат – 10 мин.

При последующих обновлениях приложения выполнять эти действия не требуется.

Установка пакета интеграции SDLC-ITSM

Если на экземпляре установлено приложение ITSM, и вам требуется установить связь между этими приложениями, установите файл [SDLC] SDLC.1.2.0_ITSM.1.12.1.sop и настройте Интеграцию SDLC-ITSM. Эту настройку необходимо провести только один раз. При последующих обновлениях приложения эти данные будут сохранены.

к сведению

Поддерживаемые версии приложений:

• ITSM 1.12.1
• SDLC 1.2.0

Развертывание демоданных

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

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

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

1. Убедитесь, что на ваш экземпляр SimpleOne установлено приложение SDLC. Нажмите иконку в правом верхнем углу, чтобы открыть Настройки. Проверьте в списке Приложения наличие опции SDLC.
2. Установите JSON-файл с демоданными согласно инструкции.

Список записей

---

Демоданные (сущности SDLC)

• 7 проектов (2 проекта со SCRUM-подходом, 5 – с KANBAN). Для каждого проекта доступна доска задач соответствующего типа.
• 32 участника проекта (часть сотрудников являются участниками нескольких проектов)
• 5 продуктов
• 18 модулей продуктов
• 6 спринтов
• 2 релиза
• 6 дополнительных атрибутов для двух досок
• 2 области для двух досок
• 12 бейджей для трех досок
• 42 столбца для всех досок
• 4 дорожки для трех досок
• 6 правил дорожек
• 14 цветовых маркеров для пяти досок
• 81 задача:
  • 7 эпиков
  • 9 фич
  • 10 дефектов
  • 17 пользовательских историй
  • 32 общие задачи
  • 5 подзадач

Демоданные (сущности Simple Application)

• 13 сотрудников с ролью pda_user
• 1 сотрудник с ролями pda_user, pda_admin
• 1 компания
• 1 расположение