Jira 스포크

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기12분

    • Jira에서 문제, 사용자, 스토리 및 그룹을 관리합니다. 플로우에서 사용할 Jira 데이터를 검색합니다. 양방향 웹후크를 사용하고 ServiceNow 콜백 URL을 통해 Jira를 구독합니다.

    스토어에서 앱 요청

    ServiceNow Store 웹 사이트를 방문하면 사용 가능한 모든 앱을 확인하고 스토어에 요청을 제출하는 방법에 대한 정보를 참조할 수 있습니다. 출시된 모든 앱의 누적 릴리스 정보는 ServiceNow Store 버전 기록 릴리스 정보를 참조하십시오.

    통합 허브 구독

    이 스포크는 Integration Hub 구독이 필요합니다. 자세한 내용은 법무 일정 - 통합 허브 개요를 참조하십시오.

    스포크 버전

    Jira 스포크 v5.1.0 이 최신 버전입니다.

    스포크 종속성

    앱을 설치하는 데 문제가 있는 경우 다음 종속 플러그인이 설치되어 있는지 확인합니다.

    • ServiceNow 통합 허브 작업 템플릿 - 데이터 스트림(com.glide.hub.action_type.datastream)
    • Complex Object (com.glide.cobject)
    • ServiceNow 통합 허브 작업 단계 - 연결 정보 가져오기(com.glide.hub.action_step.get_connection_info)
    • ServiceNow 통합 허브 런타임(com.glide.hub.integration.runtime)
    • ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
    • ServiceNow Flow Designer - Dynamic Inputs (com.glide.hub.dynamic_inputs)
    • 통합 - 외부 인증 프레임워크(com.glide.external.app)
    주:
    이러한 플러그인 중 일부는 라이센스 가능 기능이며, 스포크 구현 외부에서 사용되는 경우 적절한 라이센스가 필요합니다. 라이센스에 대한 자세한 내용은 계정 관리자에게 문의하십시오.

    지원되는 버전

    이 스포크는 API 버전 v2용으로 빌드되었지만 이후 버전과 호환될 수 있습니다.
    주:
    • Jira 인스턴스가 다른 API 버전을 지원하는 경우 속성 관련 목록의 API 버전에서 API 버전을 지정합니다. 기본적으로 API 버전은2입니다. 연결 기록 생성에 대한 자세한 내용은 을 참조하십시오 Jira 스포크에 대한 연결 구성 .
    • Jira 서비스 데스크는 스포크에서 지원되지 않습니다.

    Jira 웹후크 모듈

    양방향 웹후크는 필요한 이벤트에 대한 알림을 받도록 설정할 수 있습니다. 라우팅 정책은 인스턴스에 알리기 ServiceNow 위해 충족해야 하는 조건을 정의합니다. 이러한 조건은 알림을 받고자 하는 이벤트를 Jira 기반으로 합니다. 조건이 충족되면 라우팅 정책이 연결된 하위 플로우를 트리거하여 작업을 자동화합니다 Jira .

    양방향 웹후크는 별도의 설정이 필요하며 스포크 작업을 사용하지 않고 독립적으로 사용할 수 있습니다. 기본적으로 Jira 웹후크 애플리케이션은 다음 Jira 에서 사용할 수 있으며 다음과 같은 모듈이 있습니다.
    • Jira 웹후크 레지스트리
    • Jira WebHook 라우팅 정책
    Jira 웹후크 레지스트리 모듈을 사용하여 토큰을 할당하고 API 경로를 제공합니다. 여기에서 콜백 URL을 생성하고 에 URL을 Jira제공해야 합니다. 기본 라우팅 정책은 WebHook 라우팅 정책 모듈에 제공됩니다 Jira . 기본 라우팅 정책은 다음 필드를 지원합니다.
    범주 필드
    문제
    • Jira 인스턴스 URL
    • 웹후크 이벤트
    • 문제 설명
    • 작성됨
    • 업데이트됨
    • 문제 해결
    • 이전 문제 해결
    • 문제 요약
    • 이슈 유형
    • 이전 문제 유형
    • 문제 우선순위
    • 이전 문제 우선순위
    • 문제 상태
    • 이전 문제 상태
    • 문제 상태 범주
    • 이전 문제 상태 범주
    • 프로젝트
    설명
    • Jira 인스턴스 URL
    • 웹후크 이벤트
    • 코멘트
    • 작성됨
    • 업데이트됨
    • 문제 요약
    • 이슈 유형
    • 문제 우선순위
    • 문제 상태
    • 문제 상태 범주
    • 프로젝트
    Worklog
    • Jira 인스턴스 URL
    • 웹후크 이벤트
    • 작업 로그 소요 시간
    • 작성됨
    • 업데이트됨
    첨부 파일
    • Jira 인스턴스 URL
    • 웹후크 이벤트
    • 작성됨
    • 첨부 파일 이름
    • 첨부 파일 크기
    • 첨부 파일 MIME 유형
    프로젝트
    • Jira 인스턴스 URL
    • 웹후크 이벤트
    • 프로젝트
    버전
    • Jira 인스턴스 URL
    • 웹후크 이벤트
    • 버전
    • 버전 설명
    • 버전에 병합됨
    • 버전 설명에 병합됨

    라우팅 정책에서 다른 조건을 사용하려면 WebHook 라우팅 정책 모듈에서 Jira 라우팅 정책을 생성하고 요구 사항에 따라 조건을 지정합니다. 웹후크 설정 및 구성에 관한 정보는 을 참조하십시오 Jira 스포크에 대한 양방향 웹후크 설정 .

    스포크 하위 플로우

    다양한 JiraJira 웹후크 이벤트를 처리하는 샘플 하위 플로우를 제공합니다. 사용 가능한 샘플 하위 플로우는 프로세스 Jira 웹후크입니다. 프로세스 Jira 웹후크 하위 플로우는 다음 필드를 지원합니다.
    범주 필드
    문제
    • 사용자
    • 문제
    • 첨부 파일
    • 문제 변경 로그
    • 프로젝트
    코멘트
    • 문제
    • 프로젝트
    • 코멘트
    Worklog Worklog
    첨부 파일 첨부 파일
    프로젝트 프로젝트
    버전 버전
    웹후크 이벤트
    타임스탬프
    페이로드
    주:
    이는 전체 Jira 페이로드입니다.
    기본 하위 플로우를 사용자 지정하려면 샘플 하위 플로우의 복사본을 만들고, 페이로드를 구문 분석하고, 요구 사항에 따라 하위 플로우를 사용자 지정해야 합니다. 페이로드는 하위 플로우에 대한 입력 중 하나입니다.

    하위 플로우를 사용자 지정할 때 무한 루프를 방지하도록 하위 플로우가 구성되어 있는지 확인해야 합니다.

    주:
    • 스포크 하위 플로우를 사용하도록 웹후크를 구성해야 합니다. 웹후크 설정 및 구성에 대한 정보는 을 참조하십시오 Jira 스포크에 대한 양방향 웹후크 설정 .
    • 샘플 하위 플로우는 기본적으로 사용자로 실행됩니다. 이 하위 플로우는 시스템으로 실행되도록 구성할 수 있습니다.

    스포크 트리거

    의 Jira 스포크 트리거를 사용하여 필요한 이벤트를 구독합니다. 엔드포인트를 사용하면 웹후크를 ServiceNow 인스턴스와 연결할 수 있습니다. 지정된 트리거 조건이 충족되는 경우에만 실행되도록 플로우를 구성할 수 있습니다. 지원되는 이벤트는 다음과 같습니다.

    범주 트리거 설명
    보드 관리 보드 삭제됨 보드가 삭제되면 트리거가 시작됩니다.
    보드 업데이트됨 트리거는 보드가 업데이트될 때 시작됩니다.
    보드 작성됨 트리거는 보드가 생성될 때 시작됩니다.
    설명 관리 설명이 삭제되었습니다. 댓글이 삭제되면 트리거가 시작됩니다.
    설명이 업데이트되었습니다. 트리거는 의견이 업데이트될 때 시작됩니다.
    설명이 작성되었습니다. 트리거는 의견이 작성될 때 시작됩니다.
    문제점 관리 문제가 업데이트됨 문제가 업데이트되면 트리거가 시작됩니다. 문제 할당됨, 문제 해결됨, 문제 종결됨, 문제 재오픈됨, 문제 이동됨 및 문제 업데이트와 관련된 기타 이벤트와 같은 이벤트는 이 웹후크 이벤트 아래에 포함됩니다.
    문제 할당됨 문제가 할당되면 트리거가 시작됩니다.
    문제가 삭제됨 문제가 삭제되면 트리거가 시작됩니다.
    문제 생성됨 트리거는 문제가 생성될 때 시작됩니다.
    스프린트 관리 스프린트 업데이트됨 트리거는 스프린트가 업데이트될 때 시작됩니다.
    스프린트 삭제됨 트리거는 스프린트가 삭제될 때 시작됩니다.
    스프린트 생성됨 트리거는 스프린트가 생성될 때 시작됩니다.
    스프린트 종결됨 트리거는 스프린트가 종결될 때 시작됩니다.
    스프린트 시작됨 트리거는 스프린트가 시작될 때 시작됩니다.

    Jira 스포크에 대한 트리거 설정에 대한 자세한 내용은 단원을 참조하십시오 Jira 스포크에 대한 트리거 설정. 인바운드 통합에 대한 자세한 내용은 다음 문서를 참조하십시오 조건부 및 이벤트 기반 인바운드 통합.

    스포크 작업

    에서 이벤트가 발생할 Now Platform때 의 워크플로우 스튜디오 작업을 Jira 스포크 사용하여 작업을 자동화 Jira 합니다. 사용 가능한 작업은 다음과 같습니다.

    주:
    • 이 릴리스 이후의 일부 스포크 작업에는 연결 별칭 입력이 없습니다.

      이전 버전의 작업을 사용하는 인스턴스의 기존 플로우는 계속 작동합니다. 그러나 이러한 이전 작업은 사용되지 않는 접미사를 추가하여 이름이 바뀌며 이 버전부터는 사용할 수 없습니다.

    • 오류 평가 기능은 일부 스포크 작업에서 제공됩니다.
    범주 작업 설명
    감사 관리 감사 로그 스트림 조회 AtlassianJira 사용자 구독에 대한 로그인 활동을 검색합니다.
    그룹 관리 그룹에 사용자 추가 의 Jira그룹에 지정된 사용자를 추가합니다.
    그룹 생성 에서 Jira그룹을 작성합니다.
    그룹 스트림 조회 기본 그룹을 포함한 Atlassian 계정의 모든 그룹을 조회합니다.
    주:
    이 작업은 클라우드 구독에서만 Jira 사용할 수 있습니다.
    그룹 이름 스트림으로 사용자 조회 Atlassian 그룹의 모든 구성원에 대한 상세 정보를 조회합니다.
    그룹 제거 에서 지정된 그룹을 Jira제거합니다.
    그룹에서 사용자 제거 의 Jira그룹에서 지정된 사용자를 제거합니다.
    문제 관리 의견 추가 에서 Jira지정된 문제에 대한 주석을 추가합니다.
    감시자 추가 지정된 사용자를 지정된 문제에 대한 감시자로 추가합니다.
    문제점 할당 사용자에게 Jira 문제를 할당합니다.
    첨부 파일 복사 기록과 ServiceNow 연결된 필수 첨부 파일을 의 필수 문제에 Jira복사합니다.
    문제 작성 에서 Jira문제를 작성합니다. 조직에서 사용하는 Jira방식에 따라 문제는 소프트웨어 버그, 프로젝트 작업, 지원 센터 티켓 등을 나타낼 수 있습니다. 의 Jira 문제는 의 Now Platform작업을 나타냅니다.
    문제 생성 최대 50개의 문제를 대량으로 생성합니다. 작업이 생성하는 문제 유형은 설정에 따라 Jira 다릅니다.
    첨부 파일 제거 에서 Jira필요한 첨부 파일을 삭제합니다.
    문제 삭제 에서 Jira문제를 삭제합니다.
    감시자 삭제 지정된 문제에 대한 감시자인 사용자를 삭제합니다.
    전환 수행 한 상태에서 다른 상태로 문제를 Jira 전환합니다.
    프로젝트별 문제 유형 상태 조회 프로젝트의 상태에 대한 상세 정보를 검색합니다.
    문제 조회 문제에 대한 상세 정보를 검색합니다.
    문제 우선순위 조회 문제 우선순위 목록과 개별 문제 우선순위에 대한 상세 정보를 검색합니다.
    문제 스트림 조회 JQL 쿼리 문자열과 일치하는 문제 목록을 검색합니다.
    스프린트 문제 스트림 조회 지정된 스프린트에 대한 모든 문제의 상세 정보를 검색합니다.
    전환 조회 지정된 문제 ID의 모든 전환에 대한 정보를 조회합니다.
    감시자 조회 지정된 문제에 대한 감시자 목록을 검색합니다.
    문제 업데이트 입력으로 전달된 값으로 문제의 설정된 필드 Jira 수를 업데이트합니다.
    메타데이터 조회 보드 가져오기(메타데이터) 에 있는 Jira모든 보드의 상세 정보를 조회합니다.
    생성 가능한 필드 가져오기(메타데이터) 필수 Jira 프로젝트의 모든 필드 목록을 검색합니다.
    편집 가능한 필드 가져오기(메타데이터) 필수 Jira 문제에서 편집 가능한 모든 필드 목록을 검색합니다.
    문제 유형 가져오기(메타데이터) 필수 Jira 프로젝트의 모든 문제 유형 목록을 조회합니다.
    프로젝트 가져오기(메타데이터) 모든 Jira 프로젝트의 목록을 검색합니다.
    프로젝트 관리 프로젝트 작성 에서 Jira프로젝트를 작성합니다.
    프로젝트 조회 ID 또는 키로 지정된 프로젝트의 상세 정보를 검색합니다.
    프로젝트 조회 모든 프로젝트의 상세 정보를 검색합니다.
    주:
    이 작업은 서버에서만 Jira 작동합니다.
    프로젝트 스트림 조회 모든 프로젝트의 상세 정보를 검색합니다.
    주:
    이 작업은 클라우드에서만 Jira 작동합니다.
    프로젝트에 할당 가능한 사용자 조회 하나 이상의 프로젝트에서 문제에 할당할 수 있는 사용자 목록을 검색합니다.
    스프린트 관리 스프린트 생성 에서 Jira스프린트를 생성합니다.
    스프린트 삭제 에서 Jira스프린트를 삭제합니다.
    스프린트 조회 필요한 스프린트의 상세 정보를 복잡한 객체로 조회합니다.
    보드로 스프린트 조회 필요한 보드에서 모든 스프린트의 상세 정보를 조회합니다.
    스프린트 업데이트 에서 Jira스프린트의 상세 정보를 업데이트합니다.
    스토리 관리 스토리 작성 클라우드 인스턴스에 Jira 스토리를 작성합니다. 이는 ServiceNow Agile Development 플러그인의 스토리와 비슷합니다.
    스토리 스트림 조회 모든 스토리의 상세 정보를 검색합니다.
    스토리 업데이트 제공된 입력 값으로 클라우드에 있는 Jira 스토리의 설정된 필드 수를 업데이트합니다.
    사용자 관리 사용자 생성 에서 Jira사용자를 작성합니다.
    주:
    OAuth 2.0 인증을 사용하는 경우 이 작업은 지원되지 않습니다.
    인증 사용자 조회 인증된 사용자 계정의 상세 정보를 조회합니다.
    사용자에 대한 그룹 구성원 자격 조회 Atlassian 사용자의 모든 그룹에 대한 상세 정보를 조회합니다.
    사용자 스트림 조회 모든 Atlassian Jira 사용자 구독의 상세 정보를 조회합니다.
    주:
    이 작업은 클라우드 구독에서만 사용할 수 있습니다 Jira .
    이름으로 사용자 스트림 조회 검색 문자열과 일치하는 사용자 목록을 검색합니다.
    주:
    이 작업은 서버 구독에서만 Jira 사용할 수 있습니다.
    사용자 제거 에서 Jira사용자를 제거합니다.
    주:
    OAuth 2.0 인증을 사용하는 경우 이 작업은 지원되지 않습니다.
    유틸리티 작업 문제 첨부 파일을 기록에 복사 첨부 Jira 파일을 인스턴스의 모든 기록 ServiceNow 으로 복사합니다. 하위 플로우에서 이 작업을 사용하는 경우 컨텐츠 URL 데이터 필이 첨부 파일 URL 필드에 지정되어 있는지 확인합니다.
    필드 조회 에서 Jira필수 필드 레이블의 내부 이름 및 기타 상세 정보를 검색합니다.
    설명에서 문제 조회 지정된 코멘트에 대한 페이로드를 구문 분석하여 문제의 상세 정보를 검색합니다. 문제에 대한 상세 정보 없이 설명 관련 정보만 지정한 경우 Jira 온프레미스 서버의 프로세스 Jira 웹후크 하위 플로우에서 Jira 이 작업을 사용할 수 있습니다. 예를 들어 설명 정보만 지정된 경우 이 작업은 페이로드를 구문 분석하고 문제 상세 정보를 추출합니다.
    문제에 대한 최신 첨부 파일 조회 에서 지정된 문제에 Jira대한 최신 첨부 파일을 검색합니다. 확인을 위해 플로우 또는 하위 플로우에서 이 작업을 사용할 수 있습니다. 예를 들어, 하위 플로우는 문제의 Jira 최신 첨부 파일이 지정된 첨부 파일과 같지 않은 경우에만 첨부 파일을 추가합니다.
    문제에 대한 최신 설명 조회 Jira에서 지정된 문제에 대한 최신 의견을 검색합니다. 확인을 위해 플로우 또는 하위 플로우에서 이 작업을 사용할 수 있습니다. 예를 들어, 하위 플로우는 문제의 Jira 최신 댓글이 지정된 댓글과 같지 않은 경우에만 추가 댓글을 추가합니다.
    웹후크 관리 웹후크 조회 인스턴스에서 등록된 모든 웹후크의 Jira 상세 정보를 검색합니다.
    웹후크 구독 인스턴스에 웹후크를 등록합니다 Jira .
    웹후크 구독 취소 인스턴스에 등록된 웹후크 Jira 를 삭제합니다.
    웹후크 업데이트 에서 지정된 ID로 웹후크를 Jira업데이트합니다.
    주:
    OAuth 2.0 인증을 사용하는 경우 이 작업은 지원되지 않습니다.

    Jira 계좌 요구 사항

    Atlassian Jira 계정을 사용하기 위해 Jira API 토큰을 생성해야 합니다.

    연결 및 자격 증명 별칭 요구 사항

    통합 허브는 별칭을 사용하여 연결 및 자격 증명 정보와 OAuth 자격 증명을 관리합니다. 별칭을 사용하면 여러 환경을 사용할 때 여러 자격 증명과 연결 정보 프로파일을 구성하지 않아도 됩니다. 연결 또는 자격 증명 정보가 변경되면 연결을 사용하는 작업을 업데이트할 필요가 없습니다.

    이 스포크는 Jira 별칭 기록을 사용합니다. 이러한 작업을 사용하려면 connection 레코드와 credential 레코드를 생성하고 별칭 레코드와 Jira 연결해야 합니다.

    이러한 작업은 인스턴스에서 실행할 수 있는 REST 호출을 사용합니다. 별칭과 Jira 연결된 연결 기록을 사용하여 작업이 실행되는 엔드포인트를 구성합니다.