본문으로 건너뛰기

이슈 트래커 설정

이슈 트래커 설정으로 ABC User Feedback의 이슈를 외부 이슈 관리 시스템(Jira 등)과 연동할 수 있습니다. 내부 이슈에 외부 티켓 링크를 연결하여 개발 워크플로우와 자연스럽게 통합할 수 있습니다.

이슈 트래커 개요​

연동의 목적​

이슈 트래커 연동은 다음과 같은 목적으로 사용됩니다:

  • 워크플로우 통합: 고객 피드백과 개발 작업 연결
  • 이슈 추적: 내부 이슈와 외부 티켓의 일대일 매핑
  • 진행 상황 공유: 개발팀과 고객지원팀 간 정보 동기화
  • 효율성 향상: 중복 작업 방지 및 컨텍스트 유지

연동 방식​

  • 수동 링크 연결: ABC 이슈에 외부 티켓 번호를 수동으로 입력
  • URL 자동 생성: 설정된 Base URL과 Project Key로 자동 링크 생성
  • 클릭 이동: 생성된 링크를 클릭하여 외부 시스템으로 바로 이동

참고: 실시간 양방향 동기화는 지원하지 않습니다. 상태 변경과 같은 동기화가 필요한 경우 Webhook을 활용하세요.

설정 화면 접근​

접근 방법​

  1. 상단 메뉴에서 Settings 클릭
  2. 좌측 메뉴에서 이슈 트래커 관리 선택

설정 화면 구성​

이슈 트래커 관리 화면은 다음과 같이 구성됩니다:

  • Issue Tracking System: 연동할 시스템 선택 드롭다운
  • Connection Settings: 연결 정보 입력 영역
  • Link Preview: 생성될 링크 미리보기

Jira 연동 설정​

시스템 선택​

1. Issue Tracking System 설정​

드롭다운에서 Jira를 선택합니다.

연결 정보 입력​

2. Base URL 설정​

Jira 시스템의 기본 주소를 입력합니다.

입력 예시설명
https://yourcompany.atlassian.netJira Cloud 인스턴스
https://jira.company.com자체 호스팅 Jira Server
https://jira.internal:8080내부 네트워크 Jira

주의사항:

  • https:// 또는 http:// 프로토콜 포함 필수
  • 마지막 슬래시(/) 제거
  • 포트 번호가 있는 경우 포함

3. Project Key 설정​

Jira 프로젝트의 고유 키를 입력합니다.

입력 예시설명
PROJ일반적인 프로젝트 키
DEV개발팀 프로젝트
CS고객지원팀 프로젝트
BUG버그 관리 전용

Project Key 확인 방법:

  1. Jira에서 해당 프로젝트 접속
  2. 이슈 번호에서 - 앞부분이 Project Key
  3. 예: PROJ-123에서 PROJ가 Project Key

링크 미리보기​

설정한 정보를 바탕으로 생성될 링크를 미리 확인할 수 있습니다.

미리보기 구성​

Base URL + /browse/ + Project Key + - + Issue Number

예시:

  • Base URL: https://yourcompany.atlassian.net
  • Project Key: PROJ
  • Issue Number: 123 (사용자가 입력)
  • 생성된 링크: https://yourcompany.atlassian.net/browse/PROJ-123

링크 형식 검증​

미리보기로 다음 사항을 확인하세요:

  • URL 형식이 올바른지
  • 실제 Jira 이슈 접근 가능한지
  • 팀원들이 접근 권한을 가지고 있는지

이슈에서 티켓 연결​

티켓 번호 입력​

이슈 트래커 설정이 완료되면 개별 이슈에서 외부 티켓을 연결할 수 있습니다.

연결 방법​

  1. Issue 탭에서 원하는 이슈를 클릭합니다
  2. 우측 Issue Details 패널이 열립니다
  3. Ticket 필드에 외부 티켓 번호를 입력합니다

입력 형식​

입력 방식설명생성되는 링크
123숫자만 입력https://jira.company.com/browse/PROJ-123

시스템이 자동으로 Project Key를 추가하므로 숫자만 입력해도 됩니다.

링크 자동 생성​

티켓 번호 입력 후 Save 버튼을 클릭하면 링크가 자동으로 생성됩니다.

링크 기능​

  • 클릭 이동: 링크 클릭 시 새 탭에서 외부 Jira 이슈로 이동
  • 외부 링크 표시: 링크 옆에 외부 링크 아이콘 표시
  • 수정 가능: Edit 모드에서 티켓 번호 변경 가능

연결 해제​

외부 티켓 연결을 제거하려면:

  1. 이슈 상세 패널에서 Edit 버튼 클릭
  2. Ticket 필드의 내용을 삭제
  3. Save 버튼으로 변경사항 저장

관련 문서​