Jira API 통합

Notion과 Jira의 API 통합을 통해 여러 작업을 할 수 있습니다. Jira 링크를 Notion 페이지에 삽입해서 링크된 페이지로 빠르게 이동하거나 페이지를 미리 볼 수 있고, Jira 프로젝트와 이슈를 Notion 데이터베이스에 동기화해서 모든 작업을 한곳에서 트래킹할 수도 있어요. 계속해서 읽어보면서 다양한 API 통합 형태와 설정 방법을 알아보세요.

1. 사이드바의 설정으로 이동하세요.

2. 가져오기를 클릭하고 Jira(링크 미리보기와 링크 멘션용)를 선택하세요.

   • Jira API 통합은 링크 미리보기와 링크 멘션에 사용됩니다.

   • Jira 프로젝트와 이슈를 Notion에서 동기화하는 또 다른 API 통합인 Jira 동기화를 선택할 수도 있습니다. Jira 동기화에 대한 자세한 내용을 보려면 여기를 클릭하세요.

3. 연결을 클릭하고 인증 절차를 완료하세요.

1. Jira 링크를 Notion에 붙여넣으세요.

2. 나타나는 메뉴에서 미리보기를 선택하면 프로젝트나 이슈를 실시간으로 미리 볼 수 있어요.

   • 아직 Jira를 Notion에 연결하지 않았다면 Jira 링크를 Notion에 붙여 넣을 때 연결하라는 메시지가 표시될 거예요. 링크 미리보기에 대해서는 이 문서에서 자세히 알아보세요 →

1. Jira 링크를 Notion에 붙여넣으세요.

2. 나타나는 메뉴에서 멘션을 선택하면 문서에서 프로젝트나 이슈를 손쉽게 참조할 수 있어요.

   • 아직 Jira를 Notion에 연결하지 않았다면 Jira 링크를 Notion에 붙여 넣을 때 연결하라는 메시지가 표시될 거예요. 링크 멘션에 대해서는 이 문서에서 자세히 알아보세요 →

Jira 동기화 API 통합은 사용자 토큰 대신 관리자 API 토큰을 사용하여 Jira 프로젝트와 Notion을 연결하여 보다 통합된 환경을 제공합니다.

이제 자동화, 롤업, Notion AI를 비롯한 Notion의 기능을 최대로 활용할 수 있어요. Notion AI를 사용하여 Jira 프로젝트에 대한 질문에 빠르게 답해보세요.

Jira를 동기화하면 Jira 프로젝트와 이슈가 Notion 프로젝트 데이터베이스와 이슈 데이터베이스로 표시됩니다. 이 설정을 사용하면 다양하고 유용한 보기, 필터, 정렬을 사용해서 여러 프로젝트를 확인하고 트래킹할 수 있어요.

또, ID 매핑을 사용해서 Jira ID를 Notion 프로필에 연결할 수도 있답니다. 그러면 동기화된 Notion 데이터베이스에서 작업의 책임자가 누구인지 알 수 있어요.

동기화는 멤버 누구나 만들 수 있지만, 처음에 Jira 동기화를 설정하려면 워크스페이스 소유자여야 합니다.

1. 사이드바의 설정 → 가져오기 → Jira 동기화로 이동하세요.

   • Jira 데이터베이스 링크를 붙여 넣거나 슬래시 명령어 /jira sync를 사용할 수도 있습니다.

   • 이전에 Jira와 동기화된 데이터베이스를 Notion에 만들었다면 그 데이터베이스를 열고 상단에 있는 Jira 동기화 개선을 선택하세요.

2. 나타나는 창에서 시작하기를 선택하세요.

3. Jira 관리자 이메일, Jira 사이트 URL 및 API 토큰을 입력한 후 다음을 선택하세요.

1. 사이드바의 설정 → 가져오기 → Jira 동기화로 이동하세요.

   • Jira 데이터베이스 링크를 붙여 넣거나 슬래시 명령어 /jira sync를 사용할 수도 있습니다.

2. 나타나는 창에서 시작하기를 선택하세요.

3. 동기화하고자 하는 Jira 사이트를 선택하세요.

4. 새 동기화 생성을 선택하거나 드롭다운 메뉴에서 기존의 동기화를 선택하세요. 기존 동기화를 선택하면 프로젝트가 기존의 동기화된 프로젝트 데이터베이스와 이슈 데이터베이스에 추가돼요.

5. API 통합을 설정하는 워크스페이스 소유자가 아니라면 열리는 데이터베이스에서 Jira 계정을 연결해야 합니다. 여기에서 Notion에 동기화할 데이터를 선택하세요. 동기화할 프로젝트 선택을 먼저 한 다음 동기화할 속성 선택을 하세요.

또 다른 사이트, 팀스페이스, 워크스페이스에 대해 Jira 동기화를 설정하려면 위 단계를 반복하세요. 댓글과 첨부 파일도 동기화됩니다(이슈당 파일 최대 5개, 총 1MB까지).

데이터베이스 페이지에 권한을 적용하여 공동 작업자가 동기화된 데이터베이스에 액세스하도록 허용할 수 있어요.

동기화된 데이터베이스에 사람 속성이 포함될 예정입니다! 이제 ID 매핑을 사용하여 JIRA ID를 팀의 Notion 프로필에 연결할 수 있습니다. 아래 방법에 따라 진행하세요.

1. Jira Cloud가 구축되어 있는지 확인하세요.

2. 관리자인 경우 Jira로 가서 Jira 시스템 설정(Jira System settings)을 클릭하여 조직 내에서 사용자 이메일 가시성을 숨김(Hidden)에서 공개(Public)로 변경하세요. 개별 사용자인 경우 이메일 가시성 옵션을 변경하여 수동으로 설정을 변경해야 합니다. 이 안내에 따라 변경하세요 →

Notion 데이터베이스에 동기화된 Jira 프로젝트와 이슈 속성을 편집하려면 동기화된 데이터베이스 상단에서 ••• 아이콘을 선택하고 소스를 선택하세요.

Jira와 동기화된 데이터베이스를 삭제하려면 동기화된 데이터베이스 상단에서 ••• 아이콘을 선택하고 표 삭제를 선택하세요.

Jira 프로젝트가 Notion 프로젝트 데이터베이스에 동기화됩니다. 프로젝트는 Notion의 관련성 있는 동기화된 이슈 데이터베이스에서 해당하는 Jira 이슈에 자동으로 매핑돼요. 이 데이터베이스의 기본 데이터베이스 보기는 미리 채워져 있어서 다음과 같은 작업을 더 빠르게 시작할 수 있어요.

• 활성(표 보기): 이 보기는 동기화된 프로젝트 중에 상태가 진행 중인 프로젝트를 보여줍니다. 다시 말해, 이 보기에서는 이미 완료된 프로젝트가 표시되지 않아요. 용이한 검색을 위해 소유자와 날짜를 필터링하는 사전 설정된 필터도 있어요.

• 타임라인 보기: 이 보기는 프로젝트 이름, 상태, 소유자, 완료율을 보여줍니다. 용이한 검색을 위해 상태, 소유자, 날짜를 필터링하는 사전 설정된 필터도 있어요.

• 보드 보기: 이 보기는 프로젝트를 상태별로 그룹화해서 보여줍니다(계획 중, 진행 중 등). 보기에 표시되는 상태는 ••• 메뉴에서 사용자 지정할 수 있어요. 프로젝트는 우선순위의 내림차순으로 정렬됩니다.

• 전체(표 보기): 이 보기는 동기화된 프로젝트를 모두 보여줍니다. 용이한 검색을 위해 상태, 소유자, 날짜를 필터링하는 사전 설정된 필터도 있어요.

Jira 이슈(에픽, 버그, 작업, 하위 작업, 스토리)는 Notion 이슈 데이터베이스(Notion 작업 데이터베이스에 해당)에 동기화됩니다. 동기화된 프로젝트 데이터베이스와 마찬가지로 기본 데이터베이스 보기가 자동으로 만들어져서 더 빠르게 시작할 수 있어요.

• 프로젝트별(표 보기): 이 보기는 모든 작업을 프로젝트별로 그룹화해서 보여줍니다. 용이한 검색을 위해 상태, 담당자, 날짜, 프로젝트를 필터링하는 사전 설정된 필터도 있어요.

• 에픽별(표 보기): 이 보기는 Jira 스토리, 작업, 버그를 에픽별로 그룹화해서 보여줍니다.

• 보드 보기: 이 보기는 상태별로 그룹화해서 우선순위의 내림차순으로 정렬해줍니다. 사전 설정된 필터로는 담당자, 프로젝트, 속성, 하위 작업이 표시돼요.

• 모든 작업(표 보기): 이 보기는 동기화된 작업을 모두 보여줍니다. 사전 설정된 필터로는 작업 이름, 상태, 담당자, 날짜, 우선순위, 태그, 프로젝트가 표시돼요.

• 내 작업(표 보기): 이 보기는 내가 담당하는 작업만 보이도록 필터링되어 있습니다. 상태, 날짜, 프로젝트를 필터링하는 사전 설정된 필터가 있어요.

Jira 동기화는 대부분의 Jira 속성을 지원하지만 일부 속성은 지원되지 않습니다. 지원되지 않는 Jira 속성은 아래와 같습니다.

• 첫 동기화는 보통 몇 분이면 완료되지만 Jira 프로젝트와 이슈의 크기에 따라 몇 시간이 걸릴 수도 있습니다.

• 속성의 서식 있는 텍스트와 중첩된 다중 선택 등 일부 필드나 속성은 동기화되지 않을 수도 있어요.

• 첫 동기화를 설정하고 나면 속성의 업데이트 사항이 실시간으로 Notion에 반영됩니다. 새로운 속성을 만들 경우 이 변경 사항이 동기화되는 데는 최대 12시간이 걸릴 수 있어요.

• Jira를 Notion과 수동으로 동기화할 수는 없습니다. 동기화는 Jira에 변경 사항이 발생하면 작동해요.

• 현재는 Jira의 업데이트 사항만 Notion 데이터베이스에 동기화됩니다. 반대의 경우는 지원되지 않아요. 즉, Notion 데이터베이스의 업데이트 사항이 Jira에 동기화되지는 않아요.

• 데이터베이스 맨 위에 있는 파란색 배지에서 Notion이 마지막으로 Jira와 동기화된 시간을 확인할 수 있습니다. 노란색으로 표시된 동기화 실패 또는 동기화 중지됨이 보인다면 아래 단계를 따라 Jira를 다시 연결해야 할 수도 있어요.

  

• 프로젝트나 속성을 추가하거나 제거하려면 동기화된 데이터베이스에 대해 편집 허용이나 모두 허용 권한이 있어야 합니다.

• Notion에서 업데이트 사항이 보이지 않는다면 페이지를 새로 고쳐보세요.

• Watcher 속성은 제대로 동기화되는 데 최대 12시간이 걸릴 수 있습니다.

웹훅 등록에 실패하거나 프로젝트 동기화에 실패하면 데이터베이스 상단에 동기화 실패라고 표시됩니다. 이 문제를 해결하려면 다른 프로젝트 세트로 동기화를 다시 시도해 보세요. Jira에서 프로젝트에 아무 문제가 없는지도 확인해 볼 수 있어요.

Jira 토큰이 더 이상 유효하지 않거나 다른 사람이 Notion에서 Jira 연결을 해제했다면 데이터베이스 상단에 동기화 중지됨이라고 표시됩니다. 이 문제를 해결하려면 동기화 중지됨 옆의 재인증을 선택하세요. 이 프로세스를 완료하려면 워크스페이스 소유자여야 해요.

Jira 인스턴스가 Notion에 다시 연결되더라도 프로젝트 데이터베이스와 이슈 데이터베이스가 다시 만들어지지 않습니다. 이전에 있던 프로젝트 데이터베이스와 이슈 데이터베이스를 계속해서 사용할 수 있어요.

Notion에서 Jira의 연결을 완전히 해제하려면 아래 방법에 따라 진행하세요.

1. 사이드바의 설정 → 가져오기로 이동하세요.

2. Jira 옆의 ••• 아이콘을 선택하고 제거를 선택하세요.

레거시 동기화된 데이터베이스는 이런 모습입니다. 레거시 동기화된 데이터베이스가 있다면 위의 단계를 따라 새로 개선된 Jira 동기화를 사용해서 Notion에 프로젝트 데이터베이스와 이슈 데이터베이스를 다시 만들 수 있어요.