Jira не может прикрепить файл так как отсутствовал указатель
Некоторое время назад мы завершили интересный проект для одной российской компании – Технологии Процессинга. Эта компания является одним из лидеров среди российских компаний, специализирующихся на технологиях беспроводной высокочастотной связи (NFC). Они разрабатывают комплексные системы для осуществления бесконтактных платежей в общественном транспорте, решения для автоматизации бизнес-процессов в транспортной системе, автоматические системы обработки платежей для органов государственной власти, а также предоставляет сервисы проведения безналичных платежей для розничной торговли.
Широкий выбор решений и ряд эффективных технологий позволяют этой компании развивать уникальные и комплексные системы по автоматизации бизнес-процессов. Для каждого клиента отдельно выбирается наиболее подходящее и оптимальное решение для эффективной обработки данных и работы с заявками.
Ни для кого не секрет что JIRA это более чем система отслеживания ошибок программного обеспечения. Любой человек может найти ей сферу применения для создания комплексных аналитических систем по обработке заявок клиентов. Эта компания использовала JIRA, в качестве платформы для глобальной транспортной системы по обработке заявлений от граждан, поступающих в Транспортный Департамент Москвы и Московской области.
Обзор проекта
Транспортный департамент Москвы имеет разветвлённую иерархию подразделений, которые также отражены в схемах работы с заявками в системе JIRA. Каждое подразделение работает с десятками документов, заявок и фотографиями для каждого запроса. Обмен и работа с прикреплёнными файлами осуществляется на постоянной основе среди многочисленных отделов Департамента Транспорта. И для них стало, по-настоящему, серьёзной проблемой – работа с документооборотом и переводом прикреплённых файлов между разными отделами, особенно когда число документов превышает несколько десятков файлов для входящей заявки.
По этой причине потребовалось специальное решение, которое позволило бы выбирать документы и файлы, необходимые следующему отделу, ответственному за обработку определённых типов заявок. Было решено разработать систему для выбора файлов для облегчения работы отделов, работающих только с определёнными типами документов. Тогда пользователи могли бы сами выбирать файлы, которые будут видны следующему отделу, в который перешла заявка.
Обработка прикреплённых файлов
По умолчанию, JIRA устанавливается с механизмом загрузки и обработки прикреплённых файлов. Но это становится достаточно неудобным, когда вы работаете с тысячами документов в течение дня, и особенно, когда документооборот подчиняется ряду правил и ограничений при переводе заявок между отделами или уровнями поддержки. Это и было основной проблемой нашего клиента.
Адд-он позволяет добавить два специальных поля для прикрепления файлов через стандартные формы JIRA при переводе заявки из одного статуса в другой. Во время перевода заявки согласно установленной схемы, эти поля позволяют пользователю выбрать какие прикреплённые файлы должны быть доступны в выбранной категории при переходе на следующий уровень. На следующем уровне, уже другой пользователь работает только со списком прикреплённых файлов, выбранных при переходе.
Таким образом, на разных переходах пользователи будут видеть только те прикреплённые файлы, которые выбирались при переводе на другой уровень.
Если вам уже не требуется какой-то прикреплённый файл в категории, вы можете легко изменить набор прикреплённых файлов в этой категории.
Адд-он также поддерживает стандартный функционал JIRA по работе с прикреплёнными файлами, поэтому если даже какой-то пользователь забыл прикрепить файл или документ к нужной категории, вы всегда сможете найти его в списке файлов, прикреплённых к заявке.
Конфигурация
Адд-он может быть легко установлен на JIRA версий 5 и 6. После установки становятся доступными два специальных поля.
Вы можете выбрать эти поля из списка пользовательских полей JIRA. Эти поля не требуют сложной конфигурации, администратору лишь требуется указать категорий прикреплённых файлов. Категория прикреплённых файлов позволяет пользователям быстро и легко находить требуемые файлы без долгого просмотра списка документов и файлов, относящихся к текущей заявке. Затем администратор должен лишь добавить эти поля в нужные формы перехода и на этом всё.
Специальные поля также добавляются в стандартную форму просмотра детальной информации о заявке. Если вы не хотите привязывать эти поля к определённой категории, вы можете оставить их без изменений, в этом случае адд-он будет работать глобально со всем прикреплёнными файлами.
Также доступен программный интерфейс, позволяющий другим компонентам и сервисам запрашивать файлы и документы для собственных целей. Например, для отправки выбранных прикреплённых файлов клиенту по почте.
Результаты
Этот адд-он позволил упростить жизненный цикл прикреплённых файлов и, в целом, ускорить процедуры электронного документооборота. Теперь каждый отдел или уровень поддержки просматривают только файлы, необходимые для их работы. Адд-он также позволил навести порядок в прикреплённых файлах, поэтому пользователям не нужно листать десятки файлов, а они сразу могут найти необходимый файл в одной из категорий. Данный плагин упростил процесс обработки заявок клиентов и сделал этот процесс чуточку приятнее.
Приобретённый опыт мы использовали для создания модифицированного плагина по управления прикреплёнными файлами в JIRA - Smart Attachments.
При первом входе, как Вы помните, всплыли ошибки в виде оповещений в интерфейсе JIRA. Устраним их.
Это говорит о том, что при попытке войти в системные настройки JIRA.
Вы будете каждый раз вводить логин/пароль.
переходим в режим редактирования нажав на клавишу A , и набираем следующую строку
В итоге должно получиться как на скрине. Выходим из режима редактирования нажав на клавишу ESC. Сохраним изменения и выходим из файла командой :wq!
Так как мы произвели изменения под рутом, то при создании файла его владельцем стал root и соответствующие права на файл. Это можно просмотреть командой
Исправим так как должно быть. Для этого введем следующие 2 команды. Первая меняет права доступа к файлу, вторая владельца файла.
Смотрим, что получилось. Теперь все ровно. Едим дальше.
Исправим ошибку Base URL for gadgets (URL канала гаджетов)
Вы можете сами проверить доступность JIRA по URL введя следующую команду. Если Вы сразу настроили работу JIRA Service Desk через 80 или 443 порт, то команды вводим без указания порта.
И получите примерно такой результат. JIRA не может подключиться и проверить саму себя, так как доменное имя имеет внешний IP адрес. Здесь нужно понимать как работает сеть. Трафик из NAT-а в тот же NAT ходить не будет.
Для этого вводим следующую команду в putty нашего JIRA-сервера
Переходим в режим редактирования клавишей A и добавляем строчку. После чего нажимаем ESC для выхода из режима редактирования и выходим их файла с сохранением командой :wq! . Должно быть так.
Нажимаем обновить на все плагины по очереди. И вот как должно быть после установки.
Для вступления изменений в силу останавливаем службу jira командой
дожидаемся остановки. Должно быть так
Запускаем службу командой
команда отработает быстро, дожидаемся только полного запуска службы в фоновом режиме. Занимает примерно, в зависимости от мощности сервера, минут 3-5.
Нажимаем на Load all gadgets и получаем такой список
И в конце проверяем работу команды curl -v после изменений. Теперь получаем ответ Connection to host left intact
Когда вложения файлов включены, вашим пользователям будет разрешено прикреплять файлы и скриншоты к задачам JIRA. Для хранения вложений требуется пространство на сервере.
Вложения файлов включены по умолчанию. Если вы хотите, вы можете настроить способ обработки вложений JIRA или вообще отключить эту функцию.
Заметка:
ваши пользователи также должны иметь разрешения «Создать вложения» для прикрепления файлов к задачам
чтобы пользователи могли прикреплять файл при создании новой задачи, вам необходимо убедиться, что поле Attachment не скрыто в конфигурациях полей, связанных с конкретными типами задач.
Для настройка файловых вложений, необходимо выполнить следующие шаги:
Если у вас нет глобального разрешения системных администраторов JIRA, вы не сможете включить или отключить вложения файлов.
Комбинация клавиш: g + g + начало ввода вложений
Как уже упоминалось выше, если вы не вошли в систему как пользователь с глобальными правами администратора JIRA System Administrators, эта опция вам недоступна.
Дополнительную информацию об эскизах см. в информационном примечании ниже. Если вы используете Linux, обратитесь к примечанию Linux ниже.
Чтобы позволить этим пользователям или членам ролей группы / проекта удалять свои собственные прикрепленные файлы из задач, им также должно быть назначено разрешение «Удалить собственные вложения» (Delete Own Attachments) для этих проектов.
Нет необходимости продолжать дальше, если:
Однако, если вы хотите настроить эти разрешения, перейдите к шагам в следующем разделе.
Чтобы произвести настройку разрешений на создание / удаление вложений. выполните следующие шаги:
Комбинация клавиш: g + g + начать вводить схемы разрешений
- Нажмите ссылку «Разрешения» (Permissions), связанную с соответствующей схемой разрешения, чтобы отредактировать разрешения этой схемы.
- На странице «Редактировать разрешения» (Edit Permissions) найдите «Создание вложений» (Create Attachments) в разделе «Разрешения вложений» (Attachment Permissions) и нажмите ссылку «Добавить» (Add).
- В опциях выбора пользователя справа от страницы «Добавить новые разрешения» (Add New Permission) выберите соответствующие (группы) пользователей или роли, а затем нажмите кнопку «Добавить» (Add).
Чтобы разрешить этим пользователям или членам роли группы / проекта удалять свои собственные вложения, не забудьте также присвоить им разрешение «Удалить собственные вложения» (Delete Own Attachments).
Внешняя обработка на управляемой форме для 1С:Предприятие 8.3 по интеграции с Atlassian Jira используя Jira REST API. Ключевые функции: выборка запросов с использованием JQL; добавление и изменение запросов; добавление, изменение и удаление записей о работах; чтение комментариев к запросам; сохранение всех ключевых параметров между сеансами работы. Тестирование проводилось на платформе 1С (8.3.11.2954) совместно с JIRA Server platform (7.3.7)
Вы используете Jira как веб-морду, общедоступную для всех ?А 1С как учетную систему для расчета зарплаты и прочих расчетов ? (1) Да, именно так.
Jira + Confluence - снаружи для клиентов и внешних подрядчиков.
1С - внутри, для аналитики, документооборота, расчетов и учета. Отлично просто. Сам собирался, но, руки так и не дошли.
Спасибо за отличную разработку, очень нуждался в таком инструменте!
При попытке изменить задачу выходит следующая ошибка:
Ссылка на полноразмерный скриншот
В чем может быть проблема?
(6) Возможно вы не заполнили на закладке "Параметры" таблицу "Типы и статусы запросов". Если причина не в этом, готов к вам подключится по teamviewer и удаленно разобраться с проблемой. Напишите мне в личку. я буду на связи
Ссылка на полноразмерный скриншот Жаль что только управляемые формы. Обработка конечно очень хороша. Все действия пишет. Все ошибки четко выводит. Но вот код читать немного трудно без многих комментов.
Если не полениться то можно подстроить под любую систему. Жаль нельзя добавить +10 (12) Спасибо за оценку :). Про комментарии кода - согласен. по хорошему надо было бы. но уже и так все свои временные лимиты израсходовал на обработку + публикацию :). Потому как в пришлось все свои наработки по интеграции достать из рабочей конфигурации и много чего написать нового и переписать по другому под формат внешней обработки. Добрый день. Jira Server развернут в демо-версии на локальной машине, созданы 2 пользователя: админ и обычный пользователь
Из обработки не могу подключиться, выдает ошибку аутентификации 401.
Подскажите, пожалуйста, в чем может быть дело.
Спасибо. (16) Добрый день. Что вижу на картинке, и с чем приходилось иногда сталкиваться. Jira иногда не работает корректно с кириллическими именами пользователей. Попробуйте создать пользователей, указав имя пользователя латиницей (на английском), Например не "Владимир", а "wowan_ht"
(20) Добрый день, сложно сказать не имея подробной информации.
Попробую предположить исходя из того что в этот момент происходит.
В момент получения статусов выполняется REST запрос:
В вашем случае скорее всего ошибка может быть в написании ключа проекта.
(24) Добрый день. Данная обработка предназначена для серверной версии Jira. При этом, на сколько я знаю, если речь идет об облачной версии, могут быть нюансы в написании отдельных запросов через REST.
- запрос такой же как и для серверной версии.
Возможно проблема в настройках прав пользователя под которым вы выполняете этот запрос:
Просто если у вас не работает запрос через браузер, сл-но он не работает и через обработку.
(25) Добрый вечер. Синхронизацию запустить получилось. Данные получены. Но столкнулся с еще одной проблемой: не могу создать новую задачу в обработке. Ошибка Код состояния 400 <"errorMessages":[],"errors":<"reporter":"Field 'reporter' cannot be set. It is not on the appropriate screen, or unknown.">>. А при попытке изменить задачу выдается ошибка: Значение не является значением объектного типа (Количество).(26) Добрый день.
По Вопросу-1. "Не могу создать новую задачу. "reporter":"Field 'reporter' cannot be set"
Судя по ошибке при ваших настройках Jira, и с правами пользователя, под которым вы подключаетесь к Jira, нет возможности изменить поле "reporter".
Я проверил на "своей" Jira - у меня всё работает.
Ниже на картинке то как информация о "reporter" (автор) запроса отображается в моей Jira.
Попробуйте посмотреть как у вас:
1. Работает ли у вас выборка запросов (Закладка в обработке "Выборка запросов" - "Прочитать из Jira"/
2. Выводиться ли информация в поле "Reporter.name" (В списке выбранных запросов)
3. Откройте ссылку из колонки "Rest link" в браузере, и поищете поиском "reporter"
Если информация читается, но не записывается, причина с большой вероятность в ограниченных правах пользователя под которыми вы работаете c Jira через Rest. Проверьте что вы можете непосредственно в Jira под этим пользователем создать Запрос.
А затем попробуете при создании через обработку, указывать в качестве Автора (reporter), того же пользователя.
Просмотр через блокнот или сразу в окне браузере не принципиально. Если это поле читается при выборке запросов, значит вопрос с его установкой из обработки.
Проблема может быть из-за имени пользователя в Jira введенного кириллицей. Такой вопрос уже подымался (смотрите комментарий №17). А как у в вашем случае?
Судя по ошибке, скорее всего в вашем случае в проекте Jira не используются "Компоненты". Проверить это вы можете скачав файл json и проанализировав поля запроса.
В публикации в разделе "Источники и ссылки" в п.5 есть ссылка на онлайн просмотр Json файлов.
Вы можете закомментировать код обработки по чтению данных о компонентах в таком случае, чтобы избежать ошибки при работе обработки.
Читайте также: