Include Page

	main_menu
	main_menu

Panel
Instruction in english language.

Table of Contents

separator	braces

1. Установка

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

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

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

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

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

Название поля	Описание
* Название формы	Заполняется произвольно.
* Проект	В этом проекте будут создаваться запросы.
* Тип запроса	С этим типом запросы будут создаваться в проекте указанном в разделе Проект.
* Пользователь для создания пользователей	От имени этого пользователя будут создаваться пользователи. Внимание, у этого пользователя должны быть права на создание пользователей.
* Пользователь для поиска запросов	От имени этого пользователя будет производится поиск запросов для вывода совпадений (поля, по которым будет происходить поиск указываются ниже).
* Jira URL	Адрес JIRA, по которому форма будет обращаться для создания запроса.
Группы пользователей	Вновь созданный пользователь будет автоматически добавлен в эти группы.
Email администратора	Пользователь может обратиться по указанному адресу, если происходит сбой при работе формы.
Вывод совпадений	Будет ли форма выводить список совпадений на текущий экран.
Поля, по которым нужно искать похожие запросы	Выбор: Тема, Описание, Комментарий, Окружение.
Тип поля для компонент	Выбор: Не отображать поле, select, checkbox; select - выбор из выпадающего списка одного значения; checkbox - выбор нескольких значений. Запрос будет создан с выбранными значениями компонент. Значения загружаются в форму во время генерации кода формы. Если после публикации формы вы создали новый компонент, то необходимо обновить форму, чтобы подгрузить еще одно значение.
Тип поля для продуктов	Выбор: Не отображать поле, select, checkbox; select - выбор из выпадающего списка одного значения; checkbox - выбор нескольких значений. Запрос будет создан с выбранными значениями продуктов. Значения загружаются в форму во время генерации кода формы. Если после публикации формы вы создали новый продукт, то необходимо обновить форму, чтобы подгрузить еще одно значение.
Разрешить загружать файлы	Возможность вложить 1 файл в запрос(планируется возможность добавления нескольких файлов ).
Отправлять уведомление при создании нового пользователя	Не выводится на экран формы. Будет ли послано уведомление с данными авторизации нового пользователя.
Уровень доступа к таске после создания	Не выводится на экран формы. Укажите требуемый уровень, если в вашей JIRA есть уровни доступа.
Название поля на форме	Имя пользовательского поля, выводимого на экран.
Тип пользовательского поля	Выбор: string (строка); select-list (простой) - выбор из выпадающего списка одного значения; cascading-select (каскадный список) - зависимый двухуровневый выпадающий список значений; multi-check (мультивыбор) - выбор нескольких значений.
Поле в 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. Запрос в компанию

Image Added

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

Image Added

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

Image Added

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

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

Code Block

language	javascript
linenumbers	true

<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

...

Page tree

Versions Compared

Old Version 38

New Version Current

Key

1. Установка

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

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

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

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

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

Page tree

Page History

Versions Compared

Old Version 38

New Version Current

Key

1. Установка

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

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

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

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

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