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 连接器，您可以在 Tulip 应用中有效跟踪您的 Asana 项目、任务和工作区。此外，您还可以修改任何相关的任务信息，甚至直接从 Tulip 应用中创建新卡片。
API 文档
本文档中重点介绍的以下Connector Function 均基于Asana API文档开发。
先决条件
-
请在 Asana.com 上注册一个账户。
-
确定最适合您的身份验证方法：
- 个人访问令牌
- 服务账户
- OAuth
- OpenID Connect
-
针对此用例，我们已准备好个人访问令牌，因此请通过此链接生成一个 PAT。
Tulip 连接详细信息
需要在 Tulip 的 HTTP 连接器上配置以下信息。
运行环境：云连接器 主机：app.asana.com 端口：443 TLS：是 身份验证：OAuth 2.0（Bearer 令牌） 前缀：Bearer 令牌：插入上一步生成的个人访问令牌。
预构建示例Connector Functions
GET - 列出工作区中的项目
返回经过筛选的项目集的简要项目记录。请使用提供的一个或多个参数来筛选返回的项目。
GET - 列出工作区
返回授权用户可见的所有工作区的简要记录。
GET - 按项目 ID 获取多个任务
返回指定项目内所有任务的简要记录，按其在项目中的优先级排序。一个任务可能同时存在于多个项目中。
GET - 单个项目信息
返回单个项目的完整项目记录。
GET - 按 ID 查询单个任务
返回单个任务的完整任务记录。
GET - 按用户查询团队
返回指定用户所属的所有团队的简要记录。
POST - 创建新任务
创建新任务非常简单，只需向 /tasks 端点发送 POST 请求，并在数据块中包含您希望为该任务设置的字段即可。任何未指定的字段将采用默认值。
每个任务必须创建在特定的工作区中，且该工作区一旦设定便无法更改。如果您指定了项目或父任务，则无需显式设置工作区。
PUT - 将任务状态更改为已完成
可以通过向特定任务的 URL 发送 PUT 请求来更新该任务。只有数据块中提供的字段会被更新；未指定的字段将保持不变。
使用此方法时，最好仅指定您希望更改的字段，否则可能会覆盖自您上次检索该任务以来其他用户所做的更改。