아사나(Asana) 커넥터

소개

아사나(Asana)는 개인과 팀이 작업을 추적하고, 책임을 위임하며, 진행 상황을 모니터링하고, 실시간으로 소통할 수 있도록 설계된 포괄적인 업무 관리 도구입니다. 협업을 위한 중앙 집중식 플랫폼을 제공함으로써, 아사나는 팀이 체계적으로 업무를 관리하고 집중력을 유지하여 프로젝트가 제시간에 완료되도록 돕습니다.

목적

Tulip - Asana 커넥터를 활용하면 Tulip 애플리케이션 내에서 Asana 프로젝트, 작업 및 작업 공간을 효과적으로 관리할 수 있습니다. 또한, 관련 작업 정보를 수정하거나 Tulip 앱에서 직접 새로운 카드를 생성할 수도 있습니다.

API 문서

이 문서에서 강조된 다음 Connector Function 항목들은 Asana API 문서를 활용했습니다 .

필수 조건

1. Asana.com에서 계정을 생성하십시오.

2. 자신에게 가장 적합한 인증 방법을 결정하세요:

   1. 개인 액세스 토큰
   2. 서비스 계정
   3. OAuth
   4. OpenID Connect

3. 이 사용 사례에서는 개인 액세스 토큰을 준비해 두었으므로, 이 링크에서 PAT를 생성해 주세요.

Tulip 연결 세부 정보

Tulip의 HTTP 커넥터에서 다음 정보를 구성해야 합니다.

실행 환경: 클라우드 커넥터 호스트 호스트: app.asana.com 포트: 443 TLS: 예 인증: OAuth 2.0 (Bearer Token) 접두사: Bearer 토큰: 이전 단계에서 생성한 개인 액세스 토큰을 입력하세요.

예시 사전 구축 Connector Functions

GET - 워크스페이스 내 프로젝트 목록

필터링된 프로젝트 집합에 대한 요약된 프로젝트 레코드를 반환합니다. 제공된 매개변수 중 하나 이상을 사용하여 반환될 프로젝트를 필터링하십시오.

GET - 워크스페이스 나열

승인된 사용자가 볼 수 있는 모든 워크스페이스에 대한 요약 레코드를 반환합니다.

GET - 프로젝트 ID별 여러 작업 조회

지정된 프로젝트 내의 모든 작업에 대한 요약 기록을 프로젝트 내 우선순위 순으로 반환합니다. 작업은 한 번에 여러 프로젝트에 동시에 존재할 수 있습니다.

GET - 단일 프로젝트 정보

단일 프로젝트에 대한 전체 프로젝트 레코드를 반환합니다.

GET - ID별 단일 작업

단일 작업에 대한 전체 작업 레코드를 반환합니다.

GET - 사용자별 팀

지정된 사용자가 배정된 모든 팀에 대한 요약 레코드를 반환합니다.

POST - 새 작업 생성

새 작업 생성은 작업에 설정하려는 필드가 포함된 데이터 블록을 /tasks 엔드포인트로 POST하는 것만큼 간단합니다. 명시되지 않은 필드는 기본값을 적용받습니다.

모든 작업은 특정 작업 공간에 생성되어야 하며, 이 작업 공간은 일단 설정되면 변경할 수 없습니다. 대신 프로젝트나 상위 작업을 지정하는 경우 작업 공간을 명시적으로 설정할 필요는 없습니다.

PUT - 작업 상태 완료로 변경

특정 기존 작업은 해당 작업의 URL에 대해 PUT 요청을 수행하여 업데이트할 수 있습니다. 데이터 블록에 제공된 필드만 업데이트되며, 명시되지 않은 필드는 변경되지 않습니다.

이 메서드를 사용할 때는 변경하고자 하는 필드만 지정하는 것이 가장 좋으며, 그렇지 않으면 마지막으로 작업을 조회한 이후 다른 사용자가 변경한 내용을 덮어쓸 수 있습니다.

다음 단계

• Asana에 대해 자세히 알아보세요 .
• 커넥터에 대한 자세한 내용은 여기에서 확인하세요.