Инструкция по настройке интеграций с YouTrack
Сервис YouTrack является одним из самых популярных таск-менеджеров, который используется самыми разными компаниями вне зависимости от их численности и сферы деятельности.
В Albato доступны интеграции с сервисом, когда мы можете передавать в YouTrack данные из любых систем. Пока для сервиса доступно действие
- Новая задача
Кроме этого, доступны два триггера (действия), актуальные, когда сервис является источником данных.
- Задача создана
- Задача обновлена
Чтобы использовать таск-менеджер YouTrack в своих интеграциях, в первую очередь, следует сначала выполнить подключение сервиса к Albato.
Подключение YouTrack к Albato
Зайдите в верхнем меню интерфейса Albato в раздел “Подключения” и нажмите кнопку “Добавить подключение”.
Выберите из списка сервисов категорию “Другое” или воспользуйтесь поисковой строкой, чтобы быстрее найти YouTrack и нажмите “Добавить подключение”.
На следующем экране настройки полей нужно заполнить, используя данные из самого сервиса YouTrack.
Задайте уникальное название для сервиса и перейдите в настройки YouTrack. Настройки подключения Albato закрывать не нужно.
Скопируйте ID либо из адресной строки браузера, либо укажите название рабочей области, которое вы использовали при создании аккаунта. Перейдите в список пользователей системы, выберите пользователя, от которого будет идти доступ к интеграции и откройте у него вкладку “Аутентификация”:
Далее создаем новый токен и копируем его значения:
Переносим значение в Albato и завершаем настройку подключения:
Первая часть подключения готова. Для того, чтобы получать тикеты из YouTrack, нужно ещё создать два Workflow в YouTrack, прописать туда наши JS-коды и вставить в них вебхук из подключения.
Перейдите во вкладку Workflows:
Создайте новый Workflow:
Задайте ему название и выберите правило “При изменении” (on-change):
Вставьте полностью туда следующий код:
const albatoHook = '{{albatoHook}}'; const entities = require('@jetbrains/youtrack-scripting-api/entities'); const http = require('@jetbrains/youtrack-scripting-api/http'); const workflow = require('@jetbrains/youtrack-scripting-api/workflow'); function periodToHours(period) { return period ? ( period.getMinutes() / 60 + ( period.getHours() + period.getDays() * 8 + period.getWeeks() * 40 ) ) : 0; } function formatValue(value) { if (typeof value === 'object' && value !== null) { switch (value.$$type) { case 'User': value = value.fullName; break; default: if ('getPeriodType' in value) { value = periodToHours(value); } else if (value.constructor.name === 'ImmutableIterableWW') { const array = value; value = []; array.forEach(item => value.push(item.name)); } else { value = value.name; } } } return value === undefined ? null : value; } exports.rule = entities.Issue.onChange({ title: workflow.i18n('Send webhook to Albato'), guard: function(ctx) { return ctx.issue.becomesReported && ctx.issue.isReported; }, action: function(ctx) { const issue = ctx.issue; const fields = {}; for (let field in issue.fields) { fields[field] = formatValue(issue.fields[field]); } const tags = []; issue.tags.forEach(nameTag => tags.push(nameTag.name)); const payload = { 'event': 'newTicket', 'ticketUrl': issue.url, 'tags': tags, 'id': issue.id, 'summary': issue.summary, 'description': issue.description, 'projectId': issue.project.key, 'project': issue.project.name, 'dateCreate': issue.created, 'dateUpdate': issue.updated, 'fields': fields, }; console.log(issue.tags); const connection = new http.Connection(albatoHook, null, 2000); connection.addHeader('content-type', 'application/json'); const response = connection.postSync('', null, payload); if (!response.isSuccess) { console.warn('Failed to post webhook to Albato. Details: ' + response.toString()); } }, });
Данный код ловит только создание задач, а следующий код, рассчитан на изменение задач. Вы можете работать в одном правиле или создать еще одно дополнительное и также вставить в него следующий код:
const albatoHook = '{{albatoHook}}'; const entities = require('@jetbrains/youtrack-scripting-api/entities'); const http = require('@jetbrains/youtrack-scripting-api/http'); const workflow = require('@jetbrains/youtrack-scripting-api/workflow'); function periodToHours(period) { return period ? ( period.getMinutes() / 60 + ( period.getHours() + period.getDays() * 8 + period.getWeeks() * 40 ) ) : 0; } function formatValue(value) { if (typeof value === 'object' && value !== null) { switch (value.$$type) { case 'User': value = value.fullName; break; default: if ('getPeriodType' in value) { value = periodToHours(value); } else if (value.constructor.name === 'ImmutableIterableWW') { const array = value; value = []; array.forEach(item => value.push(item.name)); } else { value = value.name; } } } return value === undefined ? null : value; } exports.rule = entities.Issue.onChange({ title: workflow.i18n('Send webhook to Albato'), guard: function(ctx) { return !ctx.issue.becomesReported && ctx.issue.isReported; }, action: function(ctx) { const issue = ctx.issue; const fields = {}; for (let field in issue.fields) { fields[field] = formatValue(issue.fields[field]); } const tags = []; issue.tags.forEach(nameTag => tags.push(nameTag.name)); const payload = { 'event': 'changedTicket', 'ticketUrl': issue.url, 'tags': tags, 'id': issue.id, 'summary': issue.summary, 'description': issue.description, 'projectId': issue.project.key, 'project': issue.project.name, 'dateCreate': issue.created, 'dateUpdate': issue.updated, 'fields': fields, }; console.log(issue.tags); const connection = new http.Connection(albatoHook, null, 2000); connection.addHeader('content-type', 'application/json'); const response = connection.postSync('', null, payload); if (!response.isSuccess) { console.warn('Failed to post webhook to Albato. Details: ' + response.toString()); } }, });
Важный момент!
Теперь вам нужно в каждом правиле, куда вы вставили код, заменить в самой первой константе
«const albatoHook = ‘{{albatoHook}}’;», значение {{albatoHook}}, на реальный вебхук из созданного ранее подключения. Скопируйте вебхук, из вашего созданного подключения в Albato.
Вставьте вебхук в каждый созданный вами процесс:
Далее вам нужно привязать ваш Workflow к нужному вам проекту. Для этого вернитесь в список ваших Workflow, выделите созданный вами Workflow и привяжите его к нужным проектам:
Готово! Теперь вы можете использовать сервис в своих интеграциях.
Настройка связок с YouTrack
В Albato есть возможность передавать данные в YouTrack, чтобы сервис выполнял действие по постановке задач.
На первом этапе создания связки выберите сервис, из которого хотите получать данные, а на этапе выбора сервиса, куда передавать данные выберите YouTrack:
Выберите свое подключение сервиса. Далее откроется еще один блок, в котором нужно будет выбрать проект, куда будут вноситься новые задачи.
На следующим этапе вам для заполнения будут доступны несколько полей. Название, приоритет, тип и состояние являются обязательными из списка.
Для примера заполним таблицу значениями из Битрикс24:
- В поле “Название” мы установим название (заголовок) задачи из Битрикс24.
- В поле “Комментарий” мы можем поставить значение “Комментарий”, чтобы снабдить данными новую задачу в YouTrack.
- Значение приоритета можно выбрать из справочника. Для примера мы будем использовать нормальный уровень приоритетности задачи (96-2).
- В поле Type установим значение Task (96-9), тем самым укажем, что это обычная задача.
- В поле State укажем значение Open (98-1), то есть задача только появилась и она открыта.
- Subsystem заполняется значением, в котором будет передаваться размещение задачи.
- Поле Estimation нужно для оценки времени, которое уйдет на выполнение определенной задачи.
Пример заполненных полей:
Настройка исходящих данных
Теперь рассмотрим, как мы будем ловить поля для проекта. Создайте в Albato связку, выберите получать данные из YouTrack и нужное вам событие:
Если вы выбрали обновление, то на следующем шаге вы можете поставить галочку на «Загружать каждую задачу лишь единожды», если галочка стоит, то каждый тикет будет в одну связку попадать лишь один раз без повторного попадания.
На шаге «Ловец хуков», вам необходимо нажать кнопку «Ожидать вебхук», затем инициировать то событие, которое было выбрано (создание или изменение тикета) в YouTrack. После, вы получите все поля вашего проекта:
Дальше вы выбираете, куда отправлять данные, например, в Telegram.
Далее вы формируете текст вместе с кастомными полями, которые могут прийти из YouTrack.
Готово! Связка создана.
В каждой связке ловец хуков запоминает поля строго на одну свою связку. Вы можете создать несколько связок на каждый проект (если во всех проектах разный набор полей) и отфильтровать связку по проекту. Для этого откройте фильтр входящих данных у триггера:
Добавьте условие и выберите ID проекта, выберите условие «равно», а в правом поле, пропишите айди вашего проекта в YouTrack:
После этого нажмите сохранить. Такая связка будет работать только с одним проектом, а вы сможете разделить данные по проектам при помощи разных связок, создавая разные сценарии. Кроме этого, в фильтре можно задать статус задачи, что в комбинации с галочкой «Загружать каждую задачу лишь единожды», будет всегда запускаться определённый сценарий один раз, при попадании задачи в определённом статусе.
На этом настройка связки с YouTrack закончена.
Дополнительные параметры настройки
После основной настройки связки вы можете настроить дополнительные действия или инструменты. Для этого нажмите в “+” и выберите необходимый шаг, который необходимо совершить системе.
Вы также можете настроить фильтр входящих данных. О том, как он работает, можно подробно прочитать здесь.
С появлением интернета и научно-технического прогресса онлайн казино стали неотъемлемой долею веселительной индустрии, предоставляя игрокам уникальный и удачный опыт азартных игр. Это виртуальное окружение кардинально изменило представление о том, как люди услаждаются играми на деньги.
Доступность 24/7:
Одним из важных удобств онлайн казино 1xbet официальный личный кабинет является доступность в любое время суток. Игроки могут наслаждаться своими любимыми забавами в любом месте и в хоть какое удобное для них время, не зависимо от географического расположения.
Широкий Выбор Игр:
Онлайн казино предоставляют большой выбор игр – от классических игровых слотов до настольных игр, в том числе блэкджек и рулетка. Это обеспечивает разнообразие, удовлетворяя различные вкусы игроков.
Призы и Рекламные акции:
Виртуальные казино завлекают клиентов разными бонусами и рекламными акциями. Это может включать в себя безвозмездные вращения, дополнительные денежные средства для ведения игры или другие поощрения, которые крайне редко встречаются в обычных казино.
Безопасность и Конфиденциальность:
Онлайн казино предоставляют высокий уровень безопасности и конфиденциальности. Технологические процессы шифрования данных защищают личную и финансовую информацию игроков, что делает надежное игровое окружение.
Комфортные Способы Оплаты:
Широкий выбор удобных методов оплаты делает онлайн казино привлекательными для игроков. Электронные кошельки, кредитные карты, банковские переводы – каждый может выбрать метод, который превосходнейшим образом соответствует его предпочтениям.
Мобильная Сопоставимость:
Онлайн казино стали максимально мобильными, поддерживая игру на смартфонах и планшетах. Это обеспечивает свободу перемещения и позволяет игрокам услаждаться азартом в пути.
Социальное Взаимодействие:
Современные он-лайн казино интегрируют социальные функции, дозволяя игрокам разговаривать между собой работая в режиме онлайн. Это делает атмосферу социального взаимодействия, аналогичную атмосфере обычных казино.
Экономия Времени и Ресурсов:
Забава в онлайн казино экономит время и ресурсы, которые раньше требовались на тур к физическому казино. Из-за этому игроки могут сосредоточиться на самой игре, минимизируя затраты времени и усилий.
Он-лайн казино предоставляют удобство и обилие, сделав азартные игры доступными для абсолютно всех, кто имеет доступ к интернету. Это эволюция в мире азартных развлечений, которая соединяет внутри себя традиционный азарт с современными технологиями, делая процесс игры более увлекательным и удобным.
С появлением веба и технологического прогресса он-лайн казино стали неотъемлемой долею веселительной промышленности, предоставляя игрокам уникальный и удобный опыт азартных игр. Это виртуальное окружение кардинально изменило представление про то, как люди услаждаются азартными играми.
Доступность 24/7:
Одним из важных удобств онлайн казино 1xbet зеркало на сегодня является доступность в любое время суток. Игроки могут услаждаться своими любимыми играми в любом месте и в хоть какое удобное им время, не зависимо от географического расположения.
Широкий Выбор Игр:
Онлайн казино предоставляют громадный выбор игр – от классических слотов до настольных игр, таких как блэкджек и рулетка. Это обеспечивает обилие, удовлетворяя разные вкусы игроков.
Призы и Промо-Акции:
Виртуальные казино привлекают клиентов различными бонусами и промо-акциями. Это может включать в себя бесплатные вращения, дополнительные денежные средства для игры или другие поощрения, которые крайне редко встречаются в обычных казино.
Безопасность и Конфиденциальность:
Онлайн казино предоставляют высочайший уровень безопасности и конфиденциальности. Технологические процессы шифрования данных оберегают личную и финансовую информацию игроков, что делает надежное игровое окружение.
Удобные Методы Оплаты:
Широкий выбор удобных методов оплаты делает онлайн казино симпатичными для игроков. Электрические кошельки, кредитные карты, банковские переводы – каждый может выбрать метод, который превосходнейшим образом подходит его предпочтениям.
Мобильная Сопоставимость:
Онлайн казино стали максимально мобильными, поддерживая игру на смартфонах и планшетах. Это обеспечивает свободу перемещения и позволяет игрокам наслаждаться пылом в пути.
Социальное Взаимодействие:
Современные он-лайн казино интегрируют социальные функции, дозволяя игрокам разговаривать между собой в режиме реального времени. Это создает атмосферу социального взаимодействия, аналогичную атмосфере традиционных казино.
Экономия Медли и Ресурсов:
Игра в онлайн казино экономит время и ресурсы, которые требовались на поездку к физическому казино. Благодаря этому игроки могут сосредоточиться на самой игре, минимизируя затраты медли и усилий.
Онлайн казино предоставляют удобство и разнообразие, сделав азартные игры доступными для абсолютно всех, кто имеет доступ к интернету. Это эволюция во всем мире развлечений на деньги, которая соединяет внутри себя традиционный азарт с современными технологиями, делая процесс игры более интересным и удобным.
С появлением веба и научно-технического прогресса онлайн казино стали неотъемлемой долею развлекательной индустрии, предоставляя игрокам уникальный и удачный опыт азартных игр. Это виртуальное окружение кардинально изменило представление о том, как люди наслаждаются играми на деньги.
Доступность 24/7:
Одним из главных удобств он-лайн казино 1xbet зеркало на сегодня прямо является доступность в любое время суток. Игроки могут наслаждаться своими любимыми забавами в любом месте и в любое удобное для них время, не зависимо от географического расположения.
Широкий Выбор Игр:
Онлайн казино предоставляют громадный выбор игр – от классических слотов до настольных игр, таких как блэкджек и рулетка. Это обеспечивает обилие, удовлетворяя различные вкусы игроков.
Призы и Промо-Акции:
Виртуальные казино завлекают клиентов различными бонусами и промо-акциями. Это может включать в себя безвозмездные вращения, дополнительные валютные средства для игры или другие поощрения, которые изредка встречаются в традиционных казино.
Безопасность и Конфиденциальность:
Он-лайн казино предоставляют высочайший уровень безопасности и конфиденциальности. Технологии шифрования данных оберегают собственную и финансовую информацию игроков, что делает надежное игровое окружение.
Удобные Методы Оплаты:
Широкий выбор удобных методов оплаты делает онлайн казино симпатичными для игроков. Электронные кошельки, кредитные карты, банковские переводы – каждый выбирает метод, который наилучшим образом подходит его предпочтениям.
Мобильная Совместимость:
Он-лайн казино стали максимально мобильными, поддерживая игру на смартфонах и планшетах. Это дает обеспечение свободу перемещения и позволяет игрокам наслаждаться азартом в пути.
Социальное Взаимодействие:
Современные онлайн казино интегрируют социальные функции, позволяя игрокам общаться между собой в режиме реального времени. Это делает атмосферу социального взаимодействия, аналогичную атмосфере традиционных казино.
Экономия Времени и Ресурсов:
Забава в он-лайн казино экономит время и ресурсы, которые требовались на тур к физическому казино. Из-за этому игроки могут сосредоточиться на самой игре, минимизируя затраты времени и усилий.
Онлайн казино предоставляют удобство и обилие, сделав азартные забавы доступными для всех, кто имеет выход в интернет. Это эволюция во всем мире азартных развлечений, которая сочетает внутри себя традиционный азарт с современными технологиями, делая процесс игры более интересным и удобным.
С появлением веба и научно-технического прогресса онлайн казино стали неотъемлемой долею веселительной промышленности, предоставляя игрокам уникальный и удачный опыт азартных игр. Это виртуальное окружение кардинально изменило представление о том, как люди услаждаются азартными играми.
Доступность круглосуточно всю неделю:
Одним из важных удобств онлайн казино 1xbet zerkalo является доступность в хоть какое время суток. Игроки могут наслаждаться своими любимыми играми в любом месте и в любое удобное для них время, не зависимо от географического расположения.
Широкий Выбор Игр:
Он-лайн казино предоставляют громадный выбор игр – от классических слотов до настольных игр, в том числе блэкджек и рулетка. Это обеспечивает обилие, удовлетворяя различные вкусы игроков.
Призы и Промо-Акции:
Виртуальные казино привлекают клиентов различными призами и промо-акциями. Это может включать в себя безвозмездные вращения, дополнительные денежные средства для игры или другие поощрения, которые изредка встречаются в обычных казино.
Безопасность и Конфиденциальность:
Онлайн казино предоставляют высочайший уровень безопасности и конфиденциальности. Технологические процессы шифрования данных обороняют собственную и финансовую информацию игроков, что создает надежное игровое окружение.
Комфортные Способы Оплаты:
Широкий выбор удобных способов оплаты делает онлайн казино симпатичными для игроков. Электронные кошельки, кредитки, банковские переводы – каждый может выбрать метод, который наилучшим образом подходит его предпочтениям.
Мобильная Совместимость:
Онлайн казино стали очень мобильными, поддерживая забаву на смартфонах и планшетах. Это дает обеспечение свободу перемещения и позволяет игрокам наслаждаться азартом в пути.
Социальное Взаимодействие:
Современные он-лайн казино интегрируют социальные функции, позволяя игрокам разговаривать между собой работая в режиме реального времени. Это делает атмосферу общественного взаимодействия, аналогичную атмосфере традиционных казино.
Экономия Времени и Ресурсов:
Забава в он-лайн казино экономит время и ресурсы, которые раньше требовались на поездку к физическому казино. Благодаря этому игроки могут сосредоточиться на самой игре, минимизируя затраты времени и усилий.
Он-лайн казино предоставляют удобство и разнообразие, сделав азартные забавы доступными для абсолютно всех, кто имеет выход в интернет. Это эволюция во всем мире развлечений на деньги, которая соединяет в себе традиционный азарт с современными технологиями, делая процесс игры более интересным и удобным.
С появлением интернета и научно-технического прогресса онлайн казино стали неотъемлемой частью веселительной промышленности, предоставляя игрокам уникальный и удобный опыт азартных игр. Это виртуальное окружение кардинально изменило представление про то, как люди наслаждаются азартными играми.
Доступность 24/7:
Одним из важных удобств он-лайн казино 1xbet зеркало рабочее прямо является доступность в любое время суток. Игроки могут наслаждаться своими любимыми играми в любом месте и в любое удобное им время, не зависимо от географического расположения.
Широкий Выбор Игр:
Он-лайн казино предоставляют огромный выбор игр – от классических слотов до настольных игр, таких как блэкджек и рулетка. Это обеспечивает обилие, удовлетворяя разные вкусы игроков.
Призы и Промо-Акции:
Виртуальные казино завлекают клиентов разными бонусами и рекламными акциями. Это может включать в себя безвозмездные вращения, дополнительные валютные средства для ведения игры или другие поощрения, которые изредка встречаются в обычных казино.
Безопасность и Конфиденциальность:
Он-лайн казино предоставляют высокий уровень безопасности и конфиденциальности. Технологии шифрования данных оберегают собственную и финансовую информацию игроков, что делает надежное игровое окружение.
Удобные Способы Оплаты:
Широкий выбор удобных способов оплаты делает он-лайн казино симпатичными для игроков. Электрические кошельки, кредитные карты, банковские переводы – каждый может выбрать метод, который превосходнейшим образом подходит его предпочтениям.
Мобильная Совместимость:
Онлайн казино стали максимально мобильными, поддерживая забаву на смартфонах и планшетах. Это дает обеспечение свободу перемещения и позволяет игрокам услаждаться пылом в пути.
Социальное Взаимодействие:
Современные онлайн казино интегрируют социальные функции, дозволяя игрокам разговаривать между собой в режиме онлайн. Это создает атмосферу социального взаимодействия, аналогичную атмосфере обычных казино.
Экономия Медли и Ресурсов:
Забава в онлайн казино экономит время и ресурсы, которые требовались на тур к физическому казино. Благодаря этому игроки могут сосредоточиться на самой игре, минимизируя затраты медли и усилий.
Онлайн казино предоставляют удобство и обилие, сделав азартные забавы доступными для абсолютно всех, кто имеет выход в интернет. Это эволюция во всем мире азартных развлечений, которая сочетает в себе традиционный азарт с современными технологиями, делая процесс игры более интересным и удобным.
С появлением интернета и технологического прогресса онлайн казино стали неотъемлемой долею веселительной промышленности, предоставляя игрокам уникальный и удачный опыт азартных игр. Это виртуальное окружение кардинально изменило представление про то, как люди наслаждаются играми на деньги.
Доступность круглосуточно всю неделю:
Одним из важных удобств онлайн казино 1xbet личный кабинет является доступность в хоть какое время суток. Игроки могут услаждаться своими любимыми играми в любом месте и в хоть какое удобное им время, не зависимо от географического расположения.
Широкий Выбор Игр:
Онлайн казино предоставляют большой выбор игр – от классических игровых слотов до настольных игр, таких как блэкджек и рулетка. Это обеспечивает обилие, удовлетворяя разные вкусы игроков.
Бонусы и Рекламные акции:
Виртуальные казино привлекают клиентов разными бонусами и промо-акциями. Это может включать в себя безвозмездные вращения, дополнительные валютные средства для игры или другие поощрения, которые крайне редко встречаются в обычных казино.
Безопасность и Конфиденциальность:
Онлайн казино предоставляют высочайший уровень безопасности и конфиденциальности. Технологии шифрования данных защищают собственную и финансовую информацию игроков, что создает надежное игровое окружение.
Удобные Методы Оплаты:
Широкий выбор удобных методов оплаты делает онлайн казино привлекательными для игроков. Электрические кошельки, кредитки, банковские переводы – каждый может выбрать способ, который наихорошим образом подходит его предпочтениям.
Мобильная Сопоставимость:
Онлайн казино стали максимально мобильными, поддерживая игру на смартфонах и планшетах. Это обеспечивает свободу перемещения и позволяет игрокам услаждаться пылом в пути.
Социальное Взаимодействие:
Современные онлайн казино интегрируют социальные функции, позволяя игрокам разговаривать между собой в режиме реального времени. Это делает атмосферу социального взаимодействия, аналогичную атмосфере обычных казино.
Экономия Медли и Ресурсов:
Забава в онлайн казино экономит время и ресурсы, которые раньше требовались на тур к физическому казино. Благодаря этому игроки могут сосредоточиться на самой игре, минимизируя затраты медли и усилий.
Онлайн казино предоставляют удобство и обилие, сделав азартные игры доступными для всех, кто имеет выход в интернет. Это эволюция во всем мире азартных развлечений, которая соединяет внутри себя традиционный азарт с современными технологиями, делая процесс игры более интересным и удобным.