This connector is a good starting point that implements a core set of the service's most common functions. You should expect to extend it by adding functions for the specific endpoints your workflow requires. Additionally, some configuration may be required in Asana to establish a connection with Tulip. Please review our [connectors](/r230/docs/<span translate=)">connector framework to learn more about how to build and modify connectors in Tulip.
To download the app, visit: [connectors](https://tulip.co/library/<span translate=)/asana-connector/">Library
Введение
Asana — это комплексный инструмент для управления рабочим процессом, разработанный, чтобы помочь отдельным пользователям и командам отслеживать задачи, делегировать обязанности, контролировать ход работы и общаться в режиме реального времени. Предоставляя централизованную платформу для совместной работы, Asana помогает командам оставаться организованными и сосредоточенными, обеспечивая своевременное завершение проектов.
Цель
С помощью коннектора Tulip — Asana вы можете эффективно отслеживать свои проекты, задачи и рабочие пространства Asana в приложении Tulip. Кроме того, вы можете изменять любую соответствующую информацию о задачах или даже создавать новые карточки прямо из приложения Tulip.
Документация по API
Следующие функции « Connector Function », упомянутые в этом документе, используют документацию по API Asana.
Необходимые условия
-
Зарегистрируйте аккаунт на сайте Asana.com.
-
Выберите наиболее подходящий для вас метод аутентификации:
- Личный токен доступа
- Учетная запись службы
- OAuth
- OpenID Connect
-
Для данного сценария использования мы подготовили личный токен доступа, поэтому сгенерируйте PAT по этой ссылке.
Параметры подключения Tulip
В HTTP-коннекторе Tulip необходимо настроить следующую информацию.
Работает на: Cloud Connector HostHost: app.asana.comПорт: 443TLS: ДаАутентификация: OAuth 2.0 (Bearer Token)Префикс: BearerToken: Вставьте личный токен доступа, сгенерированный на предыдущем шаге.
Пример готовой конфигурации Connector Functions
GET — список проектов в рабочей среде
Возвращает сжатые записи о проектах для некоторого отфильтрованного набора проектов. Используйте один или несколько предоставленных параметров для фильтрации возвращаемых проектов.
GET — Список рабочих пространств
Возвращает краткие записи обо всех рабочих пространствах, доступных авторизованному пользователю.
GET — несколько задач по ID проекта
Возвращает сжатые записи задач для всех задач в рамках указанного проекта, отсортированные по приоритету внутри проекта. Задачи могут одновременно входить в состав нескольких проектов.
GET — Информация об отдельном проекте
Возвращает полную запись об одном проекте.
GET — одна задача по идентификатору
Возвращает полную запись о задаче для одной задачи.
GET — Команды по пользователю
Возвращает краткие записи обо всех командах, в которые входит указанный пользователь.
POST — Создание новой задачи
Создать новую задачу очень просто: достаточно отправить запрос POST на конечную точку /tasks с блоком данных, содержащим поля, которые вы хотите задать для задачи. Все не указанные поля примут значения по умолчанию.
Каждая задача должна быть создана в конкретной рабочей области, и эту рабочую область нельзя изменить после ее установки. Рабочую область не обязательно указывать явно, если вместо этого вы укажете проекты или родительскую задачу.
PUT — Изменение статуса задачи на «выполнена»
Конкретную существующую задачу можно обновить, отправив запрос PUT на URL-адрес этой задачи. Будут обновлены только те поля, которые указаны в блоке данных; все неуказанные поля останутся без изменений.
При использовании этого метода лучше всего указывать только те поля, которые вы хотите изменить, иначе вы можете перезаписать изменения, внесённые другим пользователем с момента вашего последнего запроса задачи.
Следующие шаги
- Узнайте больше об Asana здесь.
- Узнайте больше о коннекторах здесь