Docusign eSignature 스포크

스토어에서 앱 요청

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

통합 허브 구독

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

스포크 버전

Docusign eSignature 스포크 v4.0.1 이 최신 버전입니다.

스포크 종속성

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

ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
ServiceNow 통합 허브 런타임(com.glide.hub.integration.runtime)
ServiceNow Flow Designer - Dynamic Inputs (com.glide.hub.dynamic_inputs)

주:

이러한 플러그인 중 일부는 라이센스 가능 기능이며, 스포크 구현 외부에서 사용되는 경우 적절한 라이센스가 필요합니다. 라이센스에 대한 자세한 내용은 계정 관리자에게 문의하십시오.

호환 버전

이 스포크는 Docusign eSignature API 버전 v2 또는 v2.1용으로 빌드되었지만 이후 버전과 호환될 수 있습니다.

주요 기능

Docusign eSignature 스포크를 사용하면 플로우 디자이너가 다음을 수행할 수 있습니다.

디지털 서명을 위해 첨부 파일 또는 Docusign 전자 서명 템플릿에서 ServiceNow 개인 또는 수신자 목록으로 문서를 보내는 프로세스를 자동화합니다.
에서 Docusign 전자 서명 계정과 템플릿을 검색하고 동기화합니다 ServiceNow.
- Docusign 전자 서명에서 계정 및 관련 템플릿 목록을 검색한 다음 계정 가져오기 하위 플로우를 사용하여 계정 [sn_docusign_spoke_accounts] 및 템플릿 [sn_docusign_spoke_docusign_templates] 테이블에 기록으로 삽입하거나 업데이트합니다.
- 지정된 Docusign 전자 서명 계정과 연결된 템플릿을 검색한 다음 계정당 템플릿 가져오기 하위 플로우를 사용하여 템플릿 [sn_docusign_spoke_docusign_templates] 테이블에 기록으로 삽입하거나 업데이트합니다.
템플릿 및 요청 시 문서 요청을 보내기 위한 샘플 플로우를 복사하고 사용자 지정합니다.
문서에 서명할 때까지 플로우를 일시 중지합니다. 스크립팅된 REST API 웹후크는 수신자가 문서에 서명할 때까지 기다립니다.
플로우에서 서명된 문서의 값을 사용합니다.
감사를 위해 완성된 Docusign 전자 서명 문서를 기록에 ServiceNow 첨부합니다.
봉투 및 사용자를 관리합니다.

스포크 요구 사항

Docusign 전자 서명 계정
Docusign 전자 서명 관리자 자격 증명
ServiceNow와 통합하도록 구성된 Docusign 전자 서명 애플리케이션
클라이언트 ID, 통합자 키, 비밀 키 및 RSA 키 페어와 같은 Docusign 전자 서명 애플리케이션 상세 정보
ServiceNow 통합 허브 구독
주:
서비스 카탈로그(com.glideapp.servicecatalog.flow_designer) 플러그인에 대한 플로우 디자이너 지원을 활성화했는지 확인합니다.

사용자 지정 애플리케이션을 만들고 구성하는 방법은 Docusign 개발자 센터 설명서를 참조하십시오.

스포크 플로우

Docusign eSignature 스포크는 Docusign 작업 자동화를 보여주는 샘플 플로우를 제공합니다. Docusign 전자 서명 스포크 작업을 사용하여 조직에서 원하는 모든 작업을 자동화합니다. 샘플 플로우를 사용자 지정하려면 새 애플리케이션 범위에 복사합니다. 사용 가능한 샘플 플로우는 다음과 같습니다.


플로우	설명
디지털 서명을 위해 문서 보내기	디지털 서명을 위한 문서 보내기 항목에서 서비스 카탈로그 요청을 생성할 때 디지털 서명을 위해 문서를 Docusign으로 보냅니다. 이 플로우를 사용하기 전에 디지털 서명을 위한 문서 보내기 카탈로그 항목을 활성화하십시오.
Docusign 템플릿을 사용하여 입사 제안을 후보자에게 보내기	템플릿을 사용하여 사용자에게 DocuSign 봉투를 보냅니다. 예를 들어 이 플로우를 사용하여 후보에게 채용 제안을 보냅니다. 이 플로우를 사용하기 전에 템플릿 시연 - 후보에게 채용 제안 보내기 카탈로그 항목을 활성화하십시오.

Docusign eSignature 스포크는 Docusign eSignature 스포크 샘플 플로우에 사용할 카탈로그 항목을 추가합니다. Docusign eSignature 스포크 샘플 플로우를 트리거하기 전에 이러한 카탈로그 항목을 활성화합니다.


카탈로그 항목	설명
디지털 서명을 위해 문서 보내기	Docusign에서 디지털 서명을 위해 문서를 보냅니다.
템플릿 시연 - 후보에게 채용 제안 보내기	Docusign 템플릿을 사용하여 작업 제안을 보냅니다.

스포크 하위 플로우

Docusign eSignature 스포크는 DocuSign 작업 자동화를 보여주는 샘플 하위 플로우를 제공합니다. 샘플 하위 플로우를 사용자 지정하려면 새 애플리케이션 범위에 복사합니다. 사용 가능한 샘플 하위 플로우는 다음과 같습니다.


범주	하위 플로우	설명
봉투 관리	ServiceNow 기록에 DocuSign 봉투 첨부	봉투의 모든 문서를 기록에 첨부합니다 ServiceNow .
봉투 관리	DocuSign 필드 데이터 가져오기 및 설정	카탈로그 항목 변수 목록을 처리하고 각 변수 값으로 초안 봉투를 업데이트합니다.
사용자 관리	사용자 작성	권한 프로파일 및 그룹 구성원 자격을 포함하여 사용자를 작성합니다.
사용자 관리	사용자를 업데이트합니다	권한 프로파일 및 그룹 구성원 자격을 포함하여 사용자를 업데이트합니다.
템플릿 관리	계정당 템플릿 가져오기	Docusign 계정에서 템플릿을 검색하여 템플릿 테이블에 저장합니다.
기본값	Docusign 웹후크 샘플 하위 플로우	지정된 봉투에 대한 수신자 상세 정보를 검색합니다.
계정 관리	계정 가져오기	모든 계정과 관련된 Docusign 계정 및 템플릿을 검색하여 각각 계정 및 템플릿 테이블에 저장합니다.

스포크 작업

Docusign eSignature 스포크는 에서 ServiceNow이벤트가 발생할 때 DocuSign 작업을 자동화하는 작업을 제공합니다. 사용 가능한 작업은 다음과 같습니다.


범주	작업	설명
계정 관리	계정 서명 제공자 조회	지정된 계정에서 사용할 수 있는 서명 제공자 목록을 조회합니다.
	별칭으로 계정 조회	스포크 연결 및 자격 증명 별칭 기록과 연결된 계정을 조회합니다.
	역할 ID 조회	지정된 역할 이름에 대한 역할 ID를 검색합니다.
벌크 봉투 관리	대량 전송 목록 작성	대량 전송 목록을 작성합니다.
	대량 전송 요청 작성	봉투 또는 템플릿을 사용하여 기존 대량 전송 목록을 기반으로 대량 전송 요청을 생성합니다.
	테스트 요청 대량 전송 생성	기존 봉투 또는 템플릿과의 호환성을 테스트하기 위해 대량 전송 테스트 요청을 생성합니다.
	대량 전송 목록 삭제	지정된 대량 전송 목록을 삭제합니다.
	대량 전송 배치 봉투 스트림 조회	지정된 대량 전송 배치에서 봉투를 검색합니다.
	대량 전송 배치 상태 조회	성공 수, 보류 중 수, 오류 수 등과 같은 지정된 대량 전송 배치의 일반 상태를 조회합니다.
	대량 전송 배치 스트림 조회	대량 전송 배치의 정보를 조회합니다.
	대량 전송 목록 조회	지정된 대량 전송 목록을 조회합니다.
	대량 전송 목록 조회	대량 전송 목록의 목록을 조회합니다.
	대량 전송 배치 작업 업데이트	지정된 대량 전송 배치에 대해 대량 작업(다시 보내기, 수정 또는 무효화)을 수행합니다.
	대량 전송 배치 상태 업데이트	지정된 대량 전송 배치의 이름을 업데이트합니다.
	대량 전송 목록 업데이트	지정된 대량 전송 목록을 업데이트합니다.
문서 서명	포함된 서명 URL 조회	애플리케이션에 포함된 서명 URL을 만듭니다. 사용자는 응용 프로그램을 종료하지 않고 문서에 서명할 수 있습니다. 주: 서명 URL은 300초 동안 활성 상태이며 한 번에 한 명의 수신자에게 보낼 수 있습니다.
문서 서명	포함된 서명 URL 인라인 조회	Docusign의 수신자 뷰를 포함할 수 있는 URL을 검색합니다.
문서 관리	봉투에 문서 추가	봉투에 문서를 추가합니다.
	ServiceNow 기록에 결합된 문서 첨부	Docusign 문서를 ServiceNow 기록에 첨부합니다.
	기록에 ServiceNow DocuSign 문서 첨부	서명된 Docusign 문서를 검색하여 기록에 ServiceNow 첨부합니다.
	이름으로 문서 ID 조회	지정된 문서 이름을 사용하여 봉투에서 문서 ID를 검색합니다.
	봉투에 있는 문서 조회	지정된 Docusign 봉투에 ID와 이름이 있는 문서 목록을 반환합니다.
	봉투의 문서 바꾸기	봉투에 문서를 교체합니다.
봉투 관리	봉투에 수신자 추가	지정된 수신자를 지정된 봉투에 추가합니다. 주: 이 작업에 사용되는 수신자 ID는 봉투와 연결되어 있으며 모든 템플릿 필드 가져오기 작업에 사용되는 수신자 ID와 다릅니다. 관리자가 이 수신자 ID에 대해 숫자 값을 입력합니다.
	봉투에 수신자 추가	지정된 수신자를 지정된 봉투에 추가합니다.
	ServiceNow 기록에 Docusign 인증서 첨부	ServiceNow 기록에 Docusign 인증서를 첨부합니다.
	봉투 취소	진행 중인 봉투를 취소합니다.
	템플릿에서 초안 봉투 작성	기존 Docusign 템플릿에서 초안 봉투를 작성합니다.
	복합 템플릿에서 봉투 작성	기존 복합 템플릿에서 봉투를 작성합니다.
	필드 ID 조회	지정된 초안 봉투에서 지정된 필드의 ID를 검색합니다.
	필드 값 조회	지정된 봉투에서 지정된 필드의 값을 검색합니다.
	필드 조회	초안 봉투의 문서와 연결된 필드 목록을 검색합니다.
	역할 이름으로 수신자 ID 조회	지정된 봉투에서 지정된 역할 이름의 수신자 ID를 검색합니다.
	봉투의 수신자 조회	지정된 DocuSign 봉투에 수신자 ID와 역할 이름이 있는 수신자 목록을 반환합니다.
	봉투에서 수신자 제거	DocuSign 봉투에서 수신자를 삭제합니다.
	사용자에게 임시 서명 요청 보내기	지정된 ServiceNow 기록과 연결된 DocuSign 문서를 서명을 위해 지정된 수신자에게 보냅니다.
	사용자에게 임시 서명 요청 전송 - 인라인	ServiceNow 기록에서 업로드된 하나 이상의 문서를 여러 수신자에게 보냅니다.
	봉투 보내기	지정된 수신자에게 봉투를 보냅니다. 주: 봉투를 보내기 전에 모든 수신자 세부 정보를 제공해야 합니다.
	필드 값 설정	지정된 초안 봉투에서 지정된 필드의 값을 설정합니다.
	필드 값 설정	초안 봉투의 문서에 연결된 여러 필드의 값을 할당합니다.
	Docusign에서 서명 대기	지정된 문서가 서명되거나 거부될 때까지 플로우를 일시 중지합니다. 추가 처리를 위해 문서의 상태를 플로우로 반환합니다.
그룹 관리	그룹에 사용자 추가	그룹에서 사용자를 추가합니다.
	그룹 ID 조회	지정된 역할 이름에 대한 그룹 ID를 조회합니다.
	그룹에서 사용자 제거	그룹에서 지정된 사용자를 제거합니다.
템플릿 관리	계정당 템플릿 조회	지정된 Docusign 계정과 연결된 템플릿을 조회합니다.
	템플릿 필드 조회	수신자에 대해 정의된 템플릿의 모든 필드를 조회합니다. 주: 이 작업에 사용되는 수신자 ID는 템플릿과 연결되어 있으며 봉투에 수신자 추가 작업에 사용되는 수신자 ID와 다릅니다. 수신자 ID의 값은 고유한 시스템 생성 번호입니다.
	템플릿 수신자 조회	템플릿에 대해 정의된 모든 수신자를 조회합니다.
사용자 관리	사용자 작성	지정된 사용자 상세 정보로 Docusign 사용자를 작성합니다.
	사용자 상세 정보 조회	사용자에 대한 상세 정보를 조회합니다.
	사용자를 업데이트합니다	지정된 사용자를 업데이트합니다.
	사용자 제거	지정된 Docusign 사용자를 삭제합니다.

스포크 모듈

Docusign eSignature 스포크는 인스턴스에 Docusign 모듈을 ServiceNow 추가합니다. Docusign eSignature 스포크는 템플릿과 봉투를 ServiceNow동기화하고 에 저장합니다. Docusign eSignature 스포크에는 다음과 같은 테이블과 기록이 포함됩니다.


테이블/기록	설명
연결 별칭	Docusign 연결 별칭입니다.
예약된 작업	템플릿과 봉투를 Docusign 계정과 동기화하는 계정 및 템플릿 가져오기 예약된 작업입니다.
계정	인스턴스와 동기화된 DocuSign 계정입니다 ServiceNow . 계정을 동기화하려면 문서를 참조하십시오 Docusign과 ServiceNow 동기화. 계정 가져오기 하위 플로우는 Docusign에서 계정 및 관련 템플릿 목록을 검색한 다음 계정 [sn_docusign_spoke_accounts] 및 템플릿 [sn_docusign_spoke_docusign_templates] 테이블에 기록으로 삽입하거나 업데이트합니다.
템플릿	동기화된 Docusign 계정의 Docusign 템플릿입니다. 계정당 템플릿 가져오기 하위 플로우는 지정된 Docusign 계정과 연결된 템플릿을 검색한 다음 템플릿 [sn_docusign_spoke_docusign_templates] 테이블에 기록으로 삽입하거나 업데이트합니다.
봉투	동기화된 Docusign 계정의 DocuSign 봉투입니다. 봉투 테이블의 기록은 웹후크가 Docusign 계정에 대해 구성된 경우에만 업데이트됩니다.
DocuSign 웹후크 응답 하위 플로우

Docusign 전자 서명 스포크 테이블에는 이러한 필드가 포함됩니다.


테이블	필드
계정 [sn_docusign_spoke_accounts]	계정 ID 계정 이름 설명 이메일 별칭 표시 이름
템플릿 [sn_docusign_spoke_docusign_templates]	계정 템플릿 ID 이름 설명 마지막으로 수정된 표시 이름
봉투 [sn_docusign_spoke_envelopes]	계정 ID 상태 서명 날짜 거부 사유 표시 이름 포함된 서명 서명된 날짜 시간대 템플릿

스포크 트리거

ServiceNow 는 트리거를 생성하는 Docusign의 특정 이벤트를 지원합니다. 먼저 지원되는 트리거 정의를 사용하여 플로우를 구성해야 합니다. Docusign에서 이벤트(예: 푸시 요청)가 발생하면 웹후크를 통해 페이로드를 ServiceNow 인스턴스로 보냅니다. 이후에는 구성한 플로우가 인스턴스에서 트리거 ServiceNow 되어 워크플로우를 자동화합니다. 지원되는 이벤트는 다음과 같습니다.


범주	트리거	정의
봉투 관리	봉투 완료됨	트리거는 모든 수신자가 봉투를 완료하면 시작됩니다. 지정된 트리거 조건이 충족되는 경우에만 실행되도록 플로우를 구성합니다.
	봉투 거부됨	수신자 중 한 명이 봉투를 거부했을 때 트리거가 시작됩니다. 지정된 트리거 조건이 충족되는 경우에만 실행되도록 플로우를 구성합니다.
	봉투 삭제됨	트리거는 보낸 봉투가 삭제될 때 시작됩니다. 지정된 트리거 조건이 충족되는 경우에만 실행되도록 플로우를 구성합니다.
	봉투 배달됨	트리거는 모든 수신자가 Docusign 서명 웹 사이트를 통해 봉투를 열었을 때 시작됩니다. 지정된 트리거 조건이 충족되는 경우에만 실행되도록 플로우를 구성합니다.
	보낸 봉투	수신자에게 봉투가 전송되면 트리거가 시작됩니다. 지정된 트리거 조건이 충족되는 경우에만 실행되도록 플로우를 구성합니다.
	봉투 무효화	트리거는 보낸 사람에 의해 봉투가 무효화되었거나 만료되었을 때 시작됩니다. 지정된 트리거 조건이 충족되는 경우에만 실행되도록 플로우를 구성합니다.
받는 사람 관리	수신자 완료	트리거는 수신자가 봉투에 대한 작업을 완료하면 시작됩니다. 지정된 트리거 조건이 충족되는 경우에만 실행되도록 플로우를 구성합니다.
	받는 사람 거부됨	수신자가 봉투의 문서 서명을 거부할 때 트리거가 시작됩니다. 지정된 트리거 조건이 충족되는 경우에만 실행되도록 플로우를 구성합니다.
	수신자 제공됨	수신자가 Docusign 서명 웹 사이트를 통해 봉투의 문서를 본 경우 트리거가 시작됩니다. 지정된 트리거 조건이 충족되는 경우에만 실행되도록 플로우를 구성합니다.
	보낸 수신자	수신자가 봉투에 서명할 차례임을 나타내는 이메일 알림이 수신자에게 전송되면 트리거가 시작됩니다. 지정된 트리거 조건이 충족되는 경우에만 실행되도록 플로우를 구성합니다.

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

DocuSign 계정 요구 사항

Docusign eSignature 스포크를 사용하려면 OAuth 2.0 JWT 전달자 Grant 토큰을 생성하도록 Docusign 계정을 구성해야 합니다.

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

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

이 스포크는 Docusign 연결 및 자격 증명 별칭 기록을 사용하여 작업을 승인합니다.

중요사항:

인증 코드 권한 부여 또는 JWT 권한 부여를 사용하여 Docusign 스포크를 설정하도록 선택할 수 있습니다.
- 통합에서 브라우저 또는 클라이언트를 사용하여 웹 서버에 요청하는 경우 인증 코드 부여를 사용합니다.
- 통합의 각 사용자가 단일 시스템 계정을 사용하여 로그인할 경우 JWT Grant를 사용합니다.
설정 방법 중 하나를 선택해야 하는 시기에 대한 자세한 내용은 Docusign 개발자 설명서에서 OAuth 유형 선택을 참조하십시오.
회사에 Docusign을 사용하는 각 부서에 대한 Docusign 계정이 있을 수 있습니다. 이 스포크로 여러 계정을 사용하려면 각 계정에 대한 하위 별칭을 생성합니다. 또한 기본 별칭을 플로우의 하위 별칭으로 재정의해야 합니다. 런타임 시, 시스템은 계정과 연결된 하위 별칭을 식별하고 올바른 연결 및 자격 증명 정보를 요청에 전송합니다.
- 하위 별칭 및 기본 별칭 재정의에 대한 자세한 내용은 다음 문서를 참조하십시오 다중 연결 지원.
- 여러 계정 설정에 대한 자세한 내용은 다음 문서를 참조하십시오 추가 Docusign 계정에 대한 하위 별칭 생성.
회사에 계정이 하나만 있는 경우 스포크와 함께 제공된 기본 Docusign 별칭을 사용하고 인증 코드 권한 부여 또는 JWT 권한 부여를 사용하여 Docusign 스포크 설정을 진행할 수 있습니다.

MID 서버 요구 사항

이러한 작업은 인스턴스 또는 MID 서버에서 실행할 수 있는 REST 호출을 사용합니다. Docusign 별칭과 연결된 연결 기록을 사용하여 작업이 실행되는 위치를 구성하고 MID 서버 선택 속성을 설정합니다. 자세한 내용은 MID 서버를 참조하십시오.