Versions Compared

Old Version 8

changes.mady.by.user Anton Romm (Teamlead)

Saved on

compared with

New Version Current

changes.mady.by.user Dmitri Abrosov (Teamlead)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Include Page

...

main_menu
main_menu

Panel

Instruction in english language.

Table of Contents
separatorbraces

1. Установка

Info

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

...

Установка

Info

Скачать дистрибутив можно на странице плагина.
Установка происходит через Universal Plugin Manager в административной консоли JIRA.

Настройка

  1. Первым шагом запрашиваем лицензионный ключ. В Для этого в административной части JIRA в пункте меню Plugins появится пункт войдите в  пункт Teamlead Feedback -> НастройкаЛицензия в выпадающем списке. На вкладке нажмите кнопку "Запросить лицензию". Полученный по электронной почте ключ вставляем в поле Лицензионный ключ и подтверждаем.
  2. После получение ключа идем в тот же пункт меню и добавляем новую/редактируем существующую форму.
    В следующей таблице перечислены атрибуты настройки формы

2. Конфигуратор форм

Info

Для доступа в конфигуратор пользователь должен иметь как минимум права администратора и как максимум права системного администратора.

Название поля

Описание

Пример заполнения

* Название формы

Текстовое поле

 

Код проекта

Выпадающий список, Название проекта JIRA.

 

Тип таски

Тип запроса JIRA

 

Заполняется произвольно.

* Проект

В этом проекте будут создаваться запросы.

* Тип запроса

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

* Пользователь для создания пользователей

Справочник пользователей JIRA

 

От имени этого пользователя будут создаваться пользователи.
(warning) Внимание, у этого пользователя должны быть права на создание пользователей.

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

Справочник пользователей JIRA

 

Jira URL

Текстовое поле

 

Группы пользователей

Группы JIRA

 

Email администратора

Текстовое поле

 

От имени этого пользователя будет производится поиск запросов для вывода совпадений (поля, по которым будет происходить поиск указываются ниже).

* Jira URL

Адрес JIRA, по которому форма будет обращаться для создания запроса.

Группы пользователей

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

Email администратора

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

Вывод совпадений

Будет ли форма выводить список совпадений на текущий экран.

Вывод совпадений

Да/Нет

 

Поля, по которым нужно искать похожие запросы

Выбор: Тема
, Описание
, Комментарий
, Окружение.

 

Тип поля для компонент

Выбор:

  • Не отображать поле, select, checkbox;
  • select - выбор из выпадающего списка одного значения;
  • checkbox - выбор нескольких значений.
    Запрос будет создан с выбранными значениями компонент. 
    Значения загружаются в форму во время генерации кода формы. Если после публикации формы вы создали новый компонент, то необходимо обновить форму, чтобы подгрузить еще одно значение.

Тип поля для продуктов

Выбор:

  • Не отображать поле, select, checkbox;
  • select - выбор из выпадающего списка одного значения;
  • checkbox
 
  • - выбор нескольких значений.
    (info) Запрос будет создан с выбранными значениями продуктов. Значения загружаются в форму во время генерации кода формы. Если после публикации формы вы создали новый продукт, то необходимо обновить форму, чтобы подгрузить еще одно значение.

Разрешить загружать файлы

Да/Нет

Возможность вложить 1 файл в запрос(планируется возможность добавления нескольких файлов ). 

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

Да/Нет

Не выводится на экран формы. Будет ли послано уведомление с данными авторизации нового пользователя. 

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

Уровень доступа JIRA

 Не выводится на экран формы. Укажите требуемый уровень, если в вашей JIRA есть уровни доступа.

Название поля на форме

Текстовое поле

 

Тип поля

Строка
selectlist (простой)
multi-check

 

Поле в JIRA

Выпадающий список пользовательских полей JIRA

 

Имя пользовательского поля, выводимого на экран.

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

Выбор:

  • string (строка);
  • select-list (простой) - выбор из выпадающего списка одного значения;
  • cascading-select (каскадный список) - зависимый двухуровневый выпадающий список значений;
  • multi-check (мультивыбор) - выбор нескольких значений.

Поле в JIRA

Пользовательское поле JIRA (см. выше поддерживаемые типы), с которым мы хотим связать поле на форме.

Сообщение об успешной регистрации запроса

В тексте об успешной регистрации запроса можно использовать переменную созданного запроса %ISSUE_LINK% для вставки в свой текст (например, чтобы сразу перейти по этой ссылке в запрос).

Код формы

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

Стикер

Код формы

Генерированный код для вставки.

 

Примеры

Image Removed Image Removed Image Removed

Сгенерированный код формы в виде стикера для создания запросов для вставки на сайт (содержит HTML и CSS).

История запросов

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

* Поля, обязательные к заполнению.

Настройки стикера

Название поля

Описание

Смещение по вертикалиЗадается смещение положения стикера по вертикали, в процентах, начиная с верхнего края страницы ( 0 - стикер наверху страницы, 50 - стикер по середине страницы, 100 - стикер внизу страницы).
Смещение по горизонталиЗадается смещение положения стикера по горизонтали, в процентах, начиная с левого  края страницы ( 0 - стикер в левом краю страницы, 50 - стикер по середине страницы, 100 - стикер в правом краю страницы).
ПоворотПоворот стикера, в градусах.
Примеры

Смещение по вертикали - 0 %, смещение по горизонтали - 50 %, поворот - 0 градусов : стикер будет находиться наверху страницы, посередине.

Смещение по вертикали - 50 %, смещение по горизонтали - 100 %, поворот - 90 градусов : стикер будет находиться на странице справа, посередине.

Смещение по вертикали - 50 %, смещение по горизонтали - 0 %, поворот - 270 градусов : стикер будет находиться на странице слева, посередине.

Смещение по вертикали - 100 %, смещение по горизонтали - 50 %, поворот - 180 градусов : стикер будет находиться внизу страницы, посередине.

3. Выбор языка в форме

Для выбора языка в форме нужно добавить в тело существующей формы:
<div style='display:none;'><input type='text' id='feedback-language' name='feedback-language' class='feedback-language' placeholder='Выберите язык (en/ru)' value='ru'/></div>

Если нужен русский язык, то оставить value='ru', если английский, то поменять на value='en'.

4. Использование формы

1. Запрос в компанию

Image Added

2. Запрос на хостинг

Image Added

3 Просмотр краткой истории своих запросов

Image Added

4. Конфигуратор формы Image Added

5. Пример кода для вставки на сайт:

Code Block
languagejavascript
linenumberstrue
<STYLE TYPE='text/css'>BODY, input, select, table {
font-size: 12px;font-family: Arial,Helvetica,FreeSans,'sans - serif';}
</STYLE>
<div id='feedback-main-div' style='font-size: 12px; font-family: Arial,Helvetica,FreeSans,sans-serif'>
<div id='feedback-error'></div>
<form enctype='multipart/form-data' id='feedback-form' name='feedback-form' target='feedback-response' method='post' action='http://localhost:8080/plugins/servlet/feedback/create'>
<input type='hidden' name='form-index' id='form-index' value='1'/>
<div><input type='text' id='feedback-summary' name='feedback-summary' size='60' placeholder='Тема обращения' value=''/></div>
<div><TEXTAREA id='feedback-body' name='feedback-body' COLS='62' ROWS='5' placeholder='Тут можно указать подробности...'></TEXTAREA></div>
<div><select id='feedback-component' name='feedback-component'>
<option value='' selected >Выберите компонент</option>
</select>
</div>
<input type='text' id='feedback-email' name='feedback-email' placeholder='E-mail для ответа' size='38' value=''/>
<div><input type='file' id='feedback-attachment' name='feedback-attachment' size='38' /></div>
<input type='button' value=' Задать вопрос ' onclick='addFeedback()'/>
</form></div>
<iframe id='feedback-response' name='feedback-response' frameborder='no' style='display: none' width='450' height='200'></iframe><div id='feedback-new-issue-div'><input type='button' id='feedback-new-issue-button' value='Создать еще запрос'></div><script type='text/javascript'>
jQuery(window).load(function()
{
   jQuery('#feedback-main-div').show();
   jQuery('#feedback-new-issue-div').hide();
   jQuery('#feedback-response').hide();
   jQuery('#feedback-new-issue-button').click(function ()
   {
    jQuery('#feedback-form')[0].reset();
    jQuery('#feedback-main-div').show();
    jQuery('#feedback-new-issue-div').hide();
    jQuery('#feedback-response').hide();
   });
});

function addFeedback() {
   var summary = jQuery('#feedback-summary').val();
   var email = jQuery('#feedback-email').val();
   if (summary.trim() == '' || email.trim() == '')
   {
    var message = '';
    if (summary.trim() == '')
    {
     message = message + '<div>Введите тему обращения</div>';
    }
    if (email.trim() == '')
    {
     message = message + '<div>Введите E-mail для ответа</div>';
    }
    jQuery('#feedback-error').html(message);
    return false;
}
   jQuery('#feedback-error').html('');
   jQuery('#feedback-main-div').hide();
   jQuery('#feedback-new-issue-div').show();
   jQuery('#feedback-response').show();
   jQuery('#feedback-form').submit();
   return false;
}
</script>

5. Использование обработчика почты

После установки плагина в JIRA появляется новый обработчик почты Teamlead Jira Email Handler, который позволяет:

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

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

userGroup=<название группы>

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

Info

Наиболее удобный способ настройки – настроить вначале стандартный обработчик, сохранить его. Затем отредактировать и изменить его тип на Teamlead Jira Email Handler и добавить параметр userGroup.

 

...

Include Page
Подвал сайта Teamlead

Подвал сайта Teamlead