Asana
Интеграция c Asana помогает работать с задачами Asana напрямую из Юздеска: создавать их и видеть актуальные статусы, а также привязывать задачи к определённой карточке запроса.
Настройка интеграции
1. Создайте дополнительное поле с типом «текст». Откройте раздел «Настройки» ⟶ «Дополнительные поля», нажмите «Создать».
2. Создайте динамический блок. Откройте раздел «Настройки» ⟶ «Блоки», нажмите «Добавить динамический блок»:
- Имя – название системы,
- Заголовок – название блока, которое будет отображаться в карточке запроса,
- URL – заполните поле значением https://asana.usedesk.ru/,
- Включен – установите флажок для активации блока,
- Добавить параметр – POST параметры (см. п. 3).
3. Добавьте параметры (POST):
- field_id — id дополнительного поля,
- asana_token — токен Asana. Его нужно сгенерировать в консоли разработчика,
- usedesk_token — токен Юздеска. Тут мы описываем, как его получить.
4. После внесения всех изменений нажмите «Сохранить».
Принцип работы интеграции
В карточке запроса дополнительный блок расположен в правой части страницы под карточкой клиента и другими дополнительными блоками (при наличии).
Дополнительное поле, которое вы использовали для настройки, можете скрыть, и убрать возможность редактирования (настройка в дополнительном поле).
Создание задачи
При нажатии на кнопку «Создать» отображается форма создания задачи:
«Название задачи» — произвольное поле. В поля «Workspace», «Проект» и «Исполнитель» автоматически подтянутся значения из Asana по мере заполнения карточки. Поле «Дедлайн» позволяет указать дату в формате «ДД-ММ-ГГГГ». В описании можно подробнее указать описание созданной задачи. Созданная задача автоматически прикрепится к запросу.
Прикрепление задачи в карточку запроса
К карточке запроса вы можете привязать одну или несколько задач. Связь будет отображаться в дополнительном поле из п. 1. Привязать = видеть информацию по конкретной задаче (задачам) в карточке запроса. Для этого нажмите «Связать» и заполните поле «Номер», вписав ключ задачи Asana. Например: 1200006350188623.
Информация в дополнительном блоке карточки запроса
Дополнительный блок карточки запроса включает в себя следующую информацию и функции:
Нет прикрепленных задач
Если с текущим запросом не связали ни одной задачи, мы покажем сообщение «Связанных задач нет» и две кнопки: «Создать» и «Связать», с помощью которых вы можете добавить задачи к запросу:
Прикреплена одна задача
Помимо кнопок «Создать» и «Связать» появляется кнопка «Отвязать». Также показываются детали задачи:
По клику на название задачи можно перейти в задачу в Asana — например, чтобы увидеть подзадачи.
Прикреплено несколько задач
Если к запросу привязано несколько задач, мы покажем их список. При нажатии на заголовок открывается карточка задачи, а при нажатии на иконку рядом с заголовком вы перейдёте в Asana. Тут же можно создать ещё одну задачу:
Чтобы вернуться к списку привязанных задач, обновите дополнительный блок с помощью кнопки с двумя стрелочками.
Комментарии в запросе
При создании, связке и отвязке задачи мы укажем детали во внутреннем комментарии:
