Jira API 통합

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

Jira 링크를 Notion에 붙여 넣고 나타나는 메뉴에서 미리보기를 선택하면 프로젝트나 이슈를 실시간으로 미리 볼 수 있어요. 아직 Jira를 Notion에 연결하지 않았다면 Jira 링크를 Notion에 붙여 넣을 때 연결하라는 메시지가 표시될 거예요. 링크 미리보기에 대해 이 문서에서 자세히 알아보세요 →

Jira 링크를 Notion에 붙여 넣고 나타나는 메뉴에서 멘션을 선택하면 문서에서 프로젝트나 이슈를 손쉽게 참조할 수 있어요. 아직 Jira를 Notion에 연결하지 않았다면 Jira 링크를 Notion에 붙여 넣을 때 연결하라는 메시지가 표시될 거예요. 링크 멘션에 대해 이 문서에서 자세히 알아보세요 →

Jira Sync는 Jira 프로젝트와 이슈를 Notion 프로젝트 데이터베이스와 이슈 데이터베이스로 표시해요. 이 설정을 사용하면 다양하고 유용한 보기, 필터, 정렬을 사용해서 여러 프로젝트를 확인하고 트래킹할 수 있어요. 또한 ID 매핑을 사용해서 Jira ID를 Notion 프로필에 연결할 수도 있답니다. 그러면 동기화된 Notion 데이터베이스에서 작업의 책임자가 누구인지 알 수 있어요.

데이터베이스 동기화 설정을 시작하는 방법에는 몇 가지가 있어요.

• 사이드바의 설정과 멤버 → 가져오기 → Jira Sync로 이동하세요.

• 사이드바의 설정과 멤버 → 내 연결 → Jira Sync로 이동하세요.

• 페이지에서 슬래시 명령어 /jira sync를 사용하면 나타나는 메뉴에서 Jira Sync를 선택하세요.

• Jira 링크를 복사해서 페이지에 붙여 넣으세요.

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

여기에서 아래와 같은 작업을 할 수 있어요.

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

2. 워크스페이스 소유자라면 Jira 관리자 이메일, Jira 사이트 URL, API 토큰을 입력한 후 다음을 선택하세요. Jira 인스턴스의 관리자가 아니라면 동기화를 설정할 때 API 토큰을 사용할 수 없어요. 워크스페이스 멤버라면 워크스페이스 소유자에게 이 API 통합을 활성화해달라고 요청하세요.

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 프로젝트와 이슈의 크기에 따라 몇 시간이 될 수도 있어요.

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

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

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

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

• 데이터베이스 상단에서 Notion이 마지막으로 Jira와 동기화된 시점을 볼 수 있어요. 동기화 실패 또는 동기화 중지됨이 보인다면 아래 단계를 따라 Jira를 다시 연결해야 할 수도 있어요.

  

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

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

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

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

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

Notion에서 Jira 연결을 완전히 해제하려면 Notion에서 사이드바의 설정과 멤버 → 가져오기로 이동하세요. Jira 옆의 ••• 아이콘을 선택하고 제거를 선택하세요.

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