Instruction in english language.
1. Установка
Для того чтобы попробовать плагин, скачайте его, установите и в разделе "Лицензия" запросите триальный ключ на 30 дней.
Скачать дистрибутив можно на странице плагина.
Установка происходит через Universal Plugin Manager в административной консоли JIRA.
- Первым шагом запрашиваем лицензионный ключ. Для этого в административной части JIRA в пункте меню Plugins войдите в пункт Teamlead Feedback -> Лицензия в выпадающем списке. На вкладке нажмите кнопку "Запросить лицензию". Полученный по электронной почте ключ вставляем в поле Лицензионный ключ и подтверждаем.
- После получение ключа идем в тот же пункт меню и добавляем новую/редактируем существующую форму.
2. Конфигуратор форм
Для доступа в конфигуратор пользователь должен иметь как минимум права администратора и как максимум права системного администратора.
Название поля | Описание |
|---|---|
* Название формы | Заполняется произвольно. |
* Проект | В этом проекте будут создаваться запросы. |
* Тип запроса | С этим типом запросы будут создаваться в проекте указанном в разделе Проект. |
* Пользователь для создания пользователей | От имени этого пользователя будут создаваться пользователи. |
* Пользователь для поиска запросов | От имени этого пользователя будет производится поиск запросов для вывода совпадений (поля, по которым будет происходить поиск указываются ниже). |
* Jira URL | Адрес JIRA, по которому форма будет обращаться для создания запроса. |
Группы пользователей | Вновь созданный пользователь будет автоматически добавлен в эти группы. |
Email администратора | Пользователь может обратиться по указанному адресу, если происходит сбой при работе формы. |
Вывод совпадений | Будет ли форма выводить список совпадений на текущий экран. |
Поля, по которым нужно искать похожие запросы | Выбор: Тема, Описание, Комментарий, Окружение. |
Тип поля для компонент | Выбор:
|
Тип поля для продуктов | Выбор:
|
Разрешить загружать файлы | Возможность вложить 1 файл в запрос(планируется возможность добавления нескольких файлов ). |
Отправлять уведомление при создании нового пользователя | Не выводится на экран формы. Будет ли послано уведомление с данными авторизации нового пользователя. |
Уровень доступа к таске после создания | Не выводится на экран формы. Укажите требуемый уровень, если в вашей JIRA есть уровни доступа. |
Название поля на форме | Имя пользовательского поля, выводимого на экран. |
Тип пользовательского поля | Выбор:
|
Поле в JIRA | Пользовательское поле JIRA (см. выше поддерживаемые типы), с которым мы хотим связать поле на форме. |
Сообщение об успешной регистрации запроса | В тексте об успешной регистрации запроса можно использовать переменную созданного запроса %ISSUE_LINK% для вставки в свой текст (например, чтобы сразу перейти по этой ссылке в запрос). |
Код формы | Сгенерированный код формы для создания запросов для вставки на сайт. |
Стикер | Сгенерированный код формы в виде стикера для создания запросов для вставки на сайт (содержит 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. Запрос в компанию
2. Запрос на хостинг
3 Просмотр краткой истории своих запросов
4. Конфигуратор формы 
5. Пример кода для вставки на сайт:
<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.
