ServiceNow용 Adobe Acrobat Sign: 설치 및 구성 안내서 (V 2.2)

마지막 업데이트 날짜 2025년 6월 2일

개요

ServiceNow용 Adobe Acrobat Sign 애플리케이션을 사용하면 ServiceNow 플랫폼의 기본 기능을 통해 서명용 문서를 보낼 수 있습니다.Acrobat Sign과 ServiceNow의 통합을 통해 다음 기능에 액세스할 수 있습니다:

  • 여러 수신자에게 서명용 문서를 보냅니다. 
  • 수명 주기 전반에 걸쳐 서명 처리를 추적하고 각 단계에서 예상되는 서명자를 식별합니다.
  • 포함된 또는 별도의 감사 추적 문서와 함께 서명된 문서를 가져옵니다.
  • 서명 처리 전 또는 중에 문서에 입력된 양식 데이터를 가져옵니다.
  • 초기 검토 및 후속 제출을 위한 서명 처리 초안을 만듭니다.제출 전 서명자에 대한 모든 수정 사항이 ServiceNow로 동기화됩니다.
  • 서명 처리 중에 개인에게 이메일 알림을 생성하고 보냅니다.
  • ServiceNow의 로컬 파일 또는 외부 소스에서 서명용 문서를 가져옵니다.
  • 제출 전에 ServiceNow 레코드의 데이터를 사용하여 채울 수 있는 필드가 있는 문서 템플릿을 사용합니다.선택된 주제 레코드(예: 문제 또는 Service Request)를 기반으로 사용자별 문서를 생성하는 단일 템플릿을 사용할 수 있습니다.
  • ServiceNow에 동기화되어 제출 프로세스 중 선택할 수 있는 Acrobat Sign 계정의 라이브러리 템플릿을 사용합니다.

ServiceNow용 Adobe Acrobat Sign: 설치 및 맞춤화 안내서에서는 다음 작업에 대한 지침을 제공합니다:

ServiceNow 애플리케이션용 Acrobat Sign을 설치하고 구성하면 계약서를 전송, 서명, 추적 및 관리할 수 있습니다.ServiceNow 용 Adobe Acrobat Sign: 사용 안내서를 참조하십시오.

ServiceNow용 Acrobat Sign 애플리케이션 설치

ServiceNow에 애플리케이션을 설치하려면 Adobe Acrobat Sign 관리자이면서 ServiceNow 시스템 관리자(admin)여야 합니다.  

ServiceNow Store 페이지로 이동하여 Adobe Acrobat Sign을 검색하십시오.  

servicenow-store-search

검색 결과에서 Adobe Acrobat Sign을 선택한 후 가져오기를 선택하십시오.

메모

앱 설치 중에는 팝업 차단기를 비활성화하십시오.

get-sign-app

메시지가 표시되면 ServiceNow 관리자 자격 증명으로 로그인하고 설치 단계를 따르십시오.

설치를 확인하려면 ServiceNow 인스턴스의 상단 메뉴에서 전체 > 시스템 애플리케이션 > 내 회사 애플리케이션을 선택한 다음 설치됨 탭을 선택합니다. Adobe Acrobat Sign 최신 버전이 표시됩니다.

installed-apps

메모

ServiceNow용 Adobe Acrobat Sign 플러그인은 다음 도메인과 함께 작동하도록 구성되어 있습니다:

  • service-now.com
  • servicenowservices.com

servicenowservices.comGovernment Cloud 고객을 위한 것이며 추가 시스템 속성 설정이 필요합니다.도메인이 servicenowservices.com 도메인에 있는 경우, 시스템 속성 x_adosy_as.oauth_redirect_host 을 인스턴스의 전체 하위 도메인(mydomain.servicenowservices.com{17}과 같은)으로 생성/설정해야 합니다.{18}

'셀프 서비스' 메뉴에는 다음 두 모듈로 구성된 새로운 Adobe Acrobat Sign 옵션이 표시됩니다:

  • 내 서명 문서 - 로그인한 사용자가 요청자이거나 서명자인 완료 상태의 계약 목록을 포함합니다.
  • 서명 대기 중 – 로그인한 사용자의 서명을 기다리는 계약 목록을 포함합니다.계약은 '서명을 위해 전송' 또는 '승인을 위해 전송' 상태입니다.

참고: 셀프 서비스 메뉴는 서명자(x_adosy_as.adobe_sign_signer) 역할을 가진 사용자에게만 표시됩니다.  

menu-acrobat-sign

모든 애플리케이션 메뉴에는 다음 모듈을 포함하는 Adobe Acrobat Sign 옵션이 있습니다:

  • 서명을 위해 전송 - 계약을 생성하고 제출할 수 있는 레코드 생성기를 엽니다.
  • 내 계약 - 로그인한 사용자가 요청자이거나 서명자인 모든 계약의 목록입니다.
  • 내 서명 - 로그인한 사용자가 계약의 참가자(서명자)인 레코드의 세부사항입니다.

운영

  • 계약 - 서명 프로세스의 백엔드 세부사항입니다.  수신되어 처리되는 모든 Adobe Acrobat Sign 이벤트뿐만 아니라 JSON도 포함합니다.
  • 소스 문서 - 계약에 추가할 수 있는 문서를 나타냅니다.로컬 또는 라이브러리가 될 수 있습니다
  • 참가자 - 서명자 및 서명 프로세스의 세부사항입니다.
  • 이벤트 - 각 Adobe Acrobat Sign 이벤트별로 전송되고 수신되는 내용의 백엔드 세부사항입니다.
  • 양식 데이터 - 계약이 서명된 후 반환되는 양식 데이터를 보관하는 테이블입니다.문서 및 해당 필드 데이터에 대한 보고에 사용할 수 있습니다.

관리

  • Acrobat Sign에 연결 - 유효한 Adobe Acrobat Sign 계정을 ServiceNow에 연결할 수 있는 화면입니다.
  • Acrobat Sign 그룹 - Acrobat Sign 그룹의 이름과 ID 목록이 포함되어 있습니다.
  • Acrobat Sign 사용자 - Acrobat Sign 사용자의 세부 정보가 포함되어 있습니다.
  • 전자 인감 -
  • 문서 템플릿 - 계약서에 추가할 수 있는 템플릿 문서입니다. 로컬 또는 라이브러리일 수 있습니다.
  • 문서 필드 - 템플릿 문서에 포함된 양식 필드의 세부 정보입니다.
  • 병합 규칙 - 문서 템플릿을 ServiceNow 내의 특정 주제 레코드 유형과 연결합니다.
  • 병합 필드 - 주제 레코드의 필드를 관련 문서 템플릿에 포함된 필드와 연결하는 레코드입니다.
  • 속성 - 서명 후 URI 리디렉션, 알림, 감사 기록에 대한 Adobe Acrobat Sign 기본 설정입니다.

도움말 및 지원 - Adobe Acrobat Sign 도움말 링크입니다.

메모
  • '서명을 위해 전송', '내 계약서', '내 서명' 모듈은 발신자(x_adosy_as.adobe_sign_sender) 역할을 가진 사용자에게 표시됩니다. 
  • '운영' 및 '관리' 메뉴는 Admin(x_adosy_as.adobe_sign_admin) 역할 또는 Manager(x_adosy_as.adobe_sign_manager) 역할을 가진 사용자에게만 표시됩니다.

서비스 포털 위젯

Adobe Acrobat Sign을 서비스 포털에 추가하려면 /adobe_sign URL에서 데모를 확인할 수 있습니다.

이 포털은 'x_adosy_as.adobe_sign_sender' 및 'x_adosy_as.adobe_sign_signer' 역할로 제한됩니다.

이 기능을 자체 포털에 추가하려면 위젯을 복제하고 필요에 맞게 역할을 수정하십시오.

  • Adobe Acrobat 대시보드 항목 목록 - 계약서 목록 헤더 위젯에서 사용하는 항목 목록입니다.
  • Adobe Acrobat Sign 서명을 위해 전송 - 템플릿 또는 파일에서 새 계약서를 만들기 위한 위젯입니다.
  • Adobe Acrobat Sign 계약서 목록 - 계약서 목록을 보기 위한 위젯입니다.

서비스 포털 페이지

  • Adobe Acrobat Sign - Adobe Acrobat Sign 팝업 위젯이 포함되어 있으며 ServiceNow의 레코드에서 새로운 계약서를 즉석에서 생성하는 데 사용할 수 있습니다.
  • Adobe Acrobat Sign 홈페이지 - 애플리케이션에 포함된 데모 서비스 포털의 홈페이지입니다.

애플리케이션에는 네 가지 역할이 포함되어 있습니다:

  • 서명자 (x_adosy_as.adobe_sign_signer)
    • x_adosy_as.adobe_sign_signer 역할을 가진 ServiceNow 사용자는 Adobe Acrobat Sign 셀프 서비스 모듈에 대한 액세스 권한이 부여됩니다
    • 또한 사용자 서비스 포털 위젯에 대한 액세스 권한도 부여됩니다
    • 이 역할은 문서/계약에 서명해야 하는 모든 사용자/그룹에 추가되어야 합니다
  • 발송자 (x_adosy_as.adobe_sign_sender)
    • x_adosy_as.adobe_sign_sender 역할을 가진 ServiceNow 사용자는 애플리케이션이 작동할 수 있도록 액세스 권한이 부여됩니다
    • 이 역할은 자신이 요청했거나 서명해야 하는 문서/계약을 추적할 수 있어야 하는 모든 사용자/그룹에 추가되어야 합니다
  • 관리자 (x_adosy_as.adobe_sign_manager)
    • 'x_adosy_as.adobe_sign_manager' 역할을 가진 ServiceNow 사용자는 Acrobat Sign 기능에 대한 관리자 레벨 액세스 권한을 갖습니다
    • 관리자는 모든 발송자가 만든 계약을 관리할 수 있습니다
    • 이 역할은 다른 사용자가 만든 계약을 취소할 수 있는 권한을 부여합니다
  • Admin (x_adosy_as.adobe_sign_admin)
    • 'x_adosy_as.adobe_sign_admin' 역할을 가진 ServiceNow 사용자는 모든 기능에 대한 전체 액세스 권한을 갖습니다

기본적으로 애플리케이션은 문서에 서명할 수 있는 사용자에게 할당해야 하는 역할과 함께 제공됩니다모든 사용자에게 문서 서명 액세스 권한을 부여하려면 설정을 업데이트해야 합니다

주의

애플리케이션 파일을 변경하면 향후 업데이트가 적용되지 않을 수 있습니다

업데이트 세트에 대한 변경 사항을 캡처하여 애플리케이션 업데이트 후 해당 변경 사항을 다시 적용할 수 있도록 하십시오

프로덕션에 적용하기 전에 항상 전용 테스트 환경에서 모든 사용자 지정 사항을 테스트하십시오.

Acrobat Sign에 연결

ServiceNow용 Adobe Acrobat Sign 애플리케이션은 상용 및 정부(FedRAMP) 계정 모두에서 작동하도록 설계되었습니다.보유한 계정이 무엇인지 확실하지 않은 경우 상용 클라우드 고객을 위한 지침을 따르십시오

상용 클라우드 고객의 경우:

Adobe Acrobat Sign 애플리케이션이 ServiceNow에 설치되면, Adobe Acrobat Sign 그룹 또는 계정 관리자는 아래 단계를 사용하여 ServiceNow를 Adobe Acrobat Sign Commercial Cloud에 연결해야 합니다:

Adobe Acrobat Sign > 관리 > Adobe Acrobat Sign에 연결으로 이동합니다.

나타나는 대화 상자에서 연결을 선택합니다

connect-sign-1

관리자 자격 증명을 사용하여 Acrobat Sign 계정에 로그인하십시오. 

connect-sign-2

나타나는 권한 대화상자에서 액세스 허용을 선택하여 권한을 부여하고 연결을 설정하십시오. 

connect-sign-3

메모

인증은 팝업 창에서 진행됩니다.  인증 패널이 표시되지 않으면 팝업 차단기가 비활성화되어 있는지 확인하십시오.

연결이 완료되면 연결된 Acrobat Sign 계정과 해당 계정에 연결된 ServiceNow 계정이 표시된 확인 메시지가 나타납니다.

Commercial Cloud에 연결된 Acrobat Sign

Government Cloud 고객의 경우:

ServiceNow에 Adobe Acrobat Sign 애플리케이션이 설치되면 Adobe Acrobat Sign Government Cloud 그룹 또는 계정 관리 사용자가 ServiceNow를 Adobe Acrobat Sign Government Cloud에 연결할 수 있습니다.

왼쪽 패널에서 Adobe Acrobat Sign > 관리 > 속성을 선택하십시오.

ServiceNow용 Sign에서 fedramp를 활성화하십시오.

열리는 애플리케이션 속성 페이지에서:

  1. Adobe Acrobat Sign Government Cloud 사용 토글을 활성화하십시오.
  2. 연결 로그인 힌트라는 속성을 찾아 Adobe Acrobat Sign Government Cloud에 로그인할 때 사용할 이메일 주소로 값을 설정하십시오.
  3. 저장을 선택합니다.

Adobe Acrobat Sign > 관리 > Acrobat Sign에 연결로 이동하십시오.

나타나는 페이지에서 연결을 선택하십시오.

fedramp-2

메시지가 표시되면 Adobe Acrobat Sign Government Cloud 계정에 로그인하십시오.

연결이 설정되면 애플리케이션이 ServiceNow로 다시 리디렉션되고 연결 상태가 자동으로 업데이트됩니다.

fedramp-3

ServiceNow 애플리케이션용 Acrobat Sign 구성

애플리케이션 속성 설정

애플리케이션 속성에 액세스하고 설정하려면 Adobe Acrobat Sign > 관리 > 속성으로 이동하십시오.

다음과 같은 기본 설정이 표시됩니다:

  • 호스트 이름 [x_adosy_as.redirect_host]: 사용자 정의 인스턴스 URL이 있는 경우 OAuth 및 API 콜백(예: 웹훅)을 위한 리디렉션 URI에서 사용할 정규화된 호스트를 지정하십시오.
    기본적으로 이 값은 빈 상태이고, 호스트는 "glide.servlet.uri" 시스템 속성에 저장된 값입니다.
    ServiceNow 인스턴스 리디렉션에만 적용됩니다. 서명자가 서명 후 다른 호스트로 리디렉션되도록 하려면 서명자 리디렉션 URI(post_sign_uri) 속성에 해당 호스트를 제공하십시오.
  • 기본 서명 후 URL [x_adosy_as.post_sign_uri]: Acrobat Sign에서 문서에 서명한 후 사용자를 리디렉션할 기본 위치입니다. 계약 생성 중에 서명 후 URI가 지정되지 않은 경우에 사용됩니다. 이 URI는 지정된 인스턴스 이름에 상대적이지만 https://www.adobe.com/)과 같은 프로토콜을 포함하여 재정의할 수 있으며, 이를 통해 서명 후 리디렉션을 이 ServiceNow 인스턴스가 아닌 다른 곳으로 할 수 있습니다. 생성된 계약의 sys_id는 URL에서 "{sys_id}"를 사용하여 삽입할 수 있습니다. 기본값은 "/x_adosy_as_agreement_list.do?sysparm_query=requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5EORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5Estate=Complete%5EORDERBYDESCsys_created_on"이며, 사용자를 완료된 계약 목록으로 이동시킵니다.
  • 서명자 리디렉션 지연 [x_adosy_as.post_sign_delay]: Acrobat Sign에서 문서에 서명한 후 사용자가 리디렉션되기 전까지의 지연 시간(초)입니다. 기본값은 3입니다.
  • 클릭재킹 방어 [x_adosy_as.clickjacking_domains]: 서명을 위해 전송된 문서가 iframe 내에 포함될 수 있는 상위 도메인 URL의 쉼표로 구분된 목록을 제공하십시오. 예: service-now.com.
    정부 클라우드 고객에게 필요합니다. 이 필드를 비워두면 프레임 내에 표시될 때 Acrobat Sign에서 빈 페이지가 나타날 수 있습니다.
  • Acrobat Sign으로부터 이메일 허용 [x_adosy_as.send_adobe_sign_emails]: 서명 과정 중에 Acrobat Sign에서 알림 이메일을 보낼지 여부를 제어합니다. 기본값은 false입니다.
  • 팝아웃 초안 계약 [x_adosy_as.popout_draft]: 기본적으로 계약의 [검토 세부사항] 버튼을 클릭하면 같은 브라우저 창에서 Acrobat Sign의 초안이 열립니다.
    대신 새 창을 열려면 이 옵션을 true로 설정하세요.기본값은 false입니다.
  • 감사 포함 [x_adosy_as.include_audit]: 서명된 문서에 포함되는 감사 추적을 제어합니다.기본 값은 참입니다.
  • Adobe Acrobat Sign Government Cloud 사용 [x_adosy_as.fedramp]: Adobe Government Cloud 고객은 ServiceNow용 Acrobat Sign이 Acrobat Sign Government Cloud 서비스를 사용하도록 이 속성을 활성화해야 합니다.기본 값은 거짓입니다.
  • 연결 로그인 힌트 [x_adosy_as.login_hint]: Adobe Acrobat Sign Government 클라우드에 처음 연결할 때 사용되는 login_hint 값입니다.이것은 일반적으로 계정 관리자 사용자의 이메일인 "Acrobat Sign에 연결" 페이지를 자동으로 채웁니다. 기본값은 비어 있습니다.
  • 계약 활동 포매터 필드 [glide.ui.x_adosy_as_agreement_activity.fields]: 계약 레코드에 표시되는 활동 형식에 표시할 필드를 설정합니다.
    기본값은 "name, state, status,agreement_id,compose_url,post_sign_uri,etag"입니다.
  • "내 계약" 쿼리 [x_adosy_as.my_agreements_query]: 포털과 같은 장소에서 내 계약을 표시할 때 사용할 쿼리입니다. 기본값은 "requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe^ORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe"로, 사용자가 요청자이거나 서명자인 계약을 반환합니다.
  • 멀티파트 파일 확장자 [x_adosy_as.multipart_extension]: 임시 멀티파트 파일 첨부의 파일명 확장자입니다. 기본(권장) 값은 "mpfd"입니다.
  • 애플리케이션 로깅 [x_adosy_as.logging.verbosity]: 시스템 로깅을 컨트롤합니다. 기본 값은 "info"입니다.
  • 디버그 연결 [x_adosy_as.connect_debug]: Acrobat Sign에 연결할 때 진단 경고를 표시합니다. 기본값은 false입니다.

기본 리디렉션 URL 속성은 '사후 서명 URI' 필드의 값이 설정되지 않은 모든 계약에 적용됩니다.

메모

리디렉션 URL에서는 인코딩되지 않은 특수 문자나 공백이 지원되지 않습니다. 따라서 애플리케이션 속성 내의 '기본 사후 서명 URL'에 캐럿 기호(^)가 포함되어 있는 경우, %5E로 인코딩해야 합니다.

예를 들어, /x_adosy_as_agreement_list.do?sysparm_query=requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe^ORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe^state=Complete^ORDERBYDESCsys_created_on 을 다음과 같이 변경해야 합니다:

/x_adosy_as_agreement_list.do?sysparm_query=requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5EORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5Estate=Complete%5EORDERBYDESCsys_created_on

나머지 속성은 서명 프로세스 중에 Acrobat Sign에서 알림을 보낼지 여부(기본값 = 아니요)와 감사 추적을 서명된 문서에 포함할지 여부(기본값 = 예)를 관리합니다.

사용자 정의 구성 요소 설정

Adobe Acrobat Sign 애플리케이션에는 요구 사항에 따라 구성할 수 있는 사용자 정의 구성 요소가 포함되어 있습니다.아래 구성 요소 목록을 참조하여 각각을 수정하는 방법을 알아보세요.

'Sign with Adobe Acrobat'은 작업 [task] 테이블의 UI 액션 버튼입니다.발송자 역할(x_adosy_as.adobe_sign_sender)을 가진 사용자만 액세스할 수 있습니다.발송자가 계약에 문서와 서명자를 추가하고 첨부된 문서를 서명을 위해 Adobe Acrobat Sign에 제출할 수 있습니다.

ui-action-1

시스템 관리자는 다음과 같이 'Sign with Adobe Acrobat' 작업을 다른 테이블에 추가할 수 있습니다:

  1. 다음 두 방법 중 하나를 사용하여 기존 'Sign with Adobe Acrobat' 작업을 열어보세요:
    • 작업에서 확장된 모든 양식(예: 사고)에서 마우스 오른쪽 버튼을 클릭한 후 > UI 작업 구성을 선택하세요.
    • 시스템 정의 > UI 작업으로 이동한 다음 Sign with Adobe Acrobat을 검색하세요. 
  2. 필요에 따라 테이블 이름을 변경하세요.
  3. 상단 작업 표시줄에서 마우스 오른쪽 버튼을 클릭하고 삽입 후 유지 를 선택하여 새 테이블로 기존 레코드의 사본을 만드세요.

'Adobe Acrobat Sign 관련 목록'은 목록이 구성된 레코드와 관련된 계약을 표시합니다. 계약의 요청자나 서명자인 사용자 역할(x_adosy_as.adobe_sign_user)을 가진 사용자만 관련 목록에서 계약을 볼 수 있습니다.

시스템 관리자나 'personalize_form' 역할을 가진 사용자는 양식과 관련 목록 레이아웃을 구성할 수 있습니다.

Forms에 관련 목록 추가

  1. 해당 양식에서 마우스 오른쪽 버튼을 클릭하고 구성 > 관련 목록으로 이동하세요.
  2. 사용 가능 목록에서 Adobe Acrobat Sign을 선택하세요. 
  3. 오른쪽 화살표를 선택하여 선택됨 목록에 추가하세요.
  4. 저장을 선택합니다.

구성하고 있는 양식으로 이동하며 양식 하단에 'Adobe Acrobat Sign' 관련 목록이 표시됩니다.

관련 목록 3

서비스 포털 구성 요소 구성

ServiceNow용 Adobe Acrobat Sign 애플리케이션에는 사용자의 서비스 포털에서 사용하거나 복사할 수 있는 다음 서비스 포털 요소가 포함되어 있습니다.

애플리케이션에 포함된 Adobe Acrobat Sign 서비스 포털은 사용하거나 확장할 목적으로 제공되지 않습니다. 서명을 위해 전송 인터페이스만 지원합니다.

포털은 /adobe_sign에서 액세스할 수 있습니다.

애플리케이션에는 두 개의 서비스 포털 페이지가 포함되어 있습니다:

  • Adobe Acrobat Sign (x_adosy_as_send)
  • Adobe Acrobat Sign 홈 페이지 (x_adosy_as_home)

Adobe Acrobat Sign (x_adosy_as_send) 페이지는 서명을 위해 전송 인터페이스 전용으로 사용되며 수정해서는 안 됩니다.

Adobe Sign 홈페이지 (x_adosy_as_home)는 서비스 포털 홈페이지로 지정되며 포함된 위젯의 시연을 위해 제공됩니다.

요구 사항에 따라 애플리케이션에 포함된 위젯을 사용할 수 있습니다. 위젯 변경 사항을 추적하고 애플리케이션에서 업데이트를 받으려면 위젯의 복제본에서만 변경해야 합니다.

  • Adobe Acrobat Sign 서명을 위해 전송: 템플릿 및/또는 업로드된 파일에서 계약을 만드는 데 사용됩니다. 서명을 위해 전송 메뉴 항목과 Adobe Acrobat으로 서명 UI 작업으로 액세스되며 발송자 역할을 가진 사용자가 사용할 수 있습니다.

위젯 옵션: 위젯은 위젯 인스턴스 옵션 또는 URL 매개 변수를 통해 필요에 따라 맞춤 설정할 수 있도록 설계되었습니다. 문서 템플릿 및 병합 규칙을 사용하여 양식 데이터를 자동으로 채우십시오. URL 매개 변수를 사용할 때 불린 옵션을 "true" 또는 "1"로 설정할 수 있습니다.

이름

유형

설명

subject_table

문자열

계약이 속한 테이블의 이름입니다.

subject_id

문자열

계약이 속한 레코드의 sys_id입니다.

agreement_name

문자열

새 계약의 이름입니다.

첨부 파일

문자열

계약에서 사용할 첨부 sys_id 목록입니다.

템플릿

문자열

계약에서 사용할 문서 템플릿 sys_id 목록입니다.

서명자

문자열

서명자로 추가할 사용자 또는 이메일 목록입니다.

참조

문자열

참조 항목으로 추가할 사용자 또는 이메일 목록입니다.

password_protect

부울

사용자가 계약을 보호하기 위해 암호를 설정하도록 요구합니다. hide_options 또는 lock_options가 참이어도 사용자는 암호를 설정해야 합니다.

send_emails

부울

서명 처리 중에 Adobe가 이메일 알림을 보내도록 합니다.

submit_as_draft

부울

즉시 서명을 위해 제출하는 대신 초안 계약을 작성하세요.

copy_to_subject

부울

서명된 계약 파일을 주제 레코드에 복사합니다. 유효한 subject_table 및 subject_id를 제공해야 합니다.

post_sign_uri

문자열

서명자가 서명을 완료할 때 사용자 정의 리디렉션을 제공하세요.기본 리디렉션은 사용자를 계약 레코드로 보냅니다.

옵션 숨기기

문자열

숨길 옵션의 쉼표로 구분된 목록(password_protect, send_emails, submit_as_draft, copy_to_subject)입니다. 사용자로부터 모든 옵션을 숨기려면 참으로 설정하십시오.

lock_options

문자열

읽기 전용으로 설정할 옵션의 쉼표로 구분된 목록(password_protect, send_emails, submit_as_draft, copy_to_subject)입니다. 사용자가 모든 옵션을 변경하지 못하게 하려면 참으로 설정하십시오.

hide_subject

부울

주제의 첨부를 선택하지 못하게 합니다.

skip_documents

부울

초기 문서 패널을 건너뜁니다. 이는 첨부나 템플릿이 미리 선택된 경우에만 적용됩니다.

  • Adobe Acrobat 대시보드 항목 목록: 직원 또는 고객 서비스 포털에 서명이 필요한 현재 계약 목록을 추가하는 데 사용할 수 있습니다. 이 목록은 Adobe Sign 홈페이지의 할 일 기능에서 사용됩니다.
    이 목록에 표시된 레코드에 액세스하려면 셀프 서비스 > Adobe Acrobat Sign > 서명용으로 이동하십시오.
  • Adobe Acrobat Sign 헤더: Adobe Acrobat Sign 홈페이지에서 할 일 기능을 보여주는 데 사용됩니다.
위젯

문서 템플릿 만들기

문서 템플릿은 계약에 포함하도록 선택할 수 있는 템플릿을 정의합니다. 템플릿은 많은 개인 계약에 재사용할 수 있는 표준 문서를 제공하는 데 사용할 수 있습니다. '소스 문서' 레코드는 템플릿을 참조하여 관련 계약에서 해당 템플릿의 기능을 사용할 수 있게 합니다.

템플릿은 ServiceNow 인스턴스의 로컬 템플릿이거나 연결된 Adobe Acrobat Sign 계정에서 세부 정보가 동기화된 라이브러리 템플릿일 수 있습니다.

라이브러리 템플릿 동기화

애플리케이션이 설치 및 구성된 후, 관리자는 라이브러리 템플릿을 동기화할 수 있습니다. Adobe Acrobat Sign 라이브러리 템플릿은 Acrobat Sign 계정 내에서 정의되며 그 세부 정보가 ServiceNow로 동기화됩니다. 라이브러리 템플릿의 정의 문서는 연결된 Acrobat Sign 계정에도 저장되므로 제출을 위한 업로드가 필요하지 않습니다.

라이브러리 템플릿을 ServiceNow로 동기화하려면:

  1. Adobe Acrobat Sign > 관리 > 문서 템플릿으로 이동합니다.
  2. 라이브러리 새로 고침을 선택합니다.

연결된 Acrobat Sign 계정의 라이브러리 템플릿으로 목록 보기가 업데이트됩니다.

refresh-library

로컬 템플릿 만들기

로컬 템플릿의 정의 문서는 ServiceNow 내에서 첨부 레코드로 보관되며 제출 프로세스의 일부로 Acrobat Sign에 업로드해야 합니다.

템플릿의 문서에는 계약의 주체 레코드 데이터를 사용하여 미리 채워야 하는 양식 필드가 포함되어 있을 수도 있고 없을 수도 있습니다. 문서에 이러한 양식 필드가 포함되어 있는 경우 템플릿을 사용해야 합니다.

  1. Acrobat Sign > 관리 > 문서 템플릿으로 이동합니다.
  2. 새로 만들기를 선택합니다. 
  3. 템플릿 새 레코드 페이지에서:
    1. 템플릿에 이름을 지정합니다.
    2. 유형을 로컬로 설정합니다.
    3. 마우스 오른쪽 버튼을 클릭한 다음 저장을 선택합니다.
  4. 문서를 템플릿과 연결하려면 파일을 선택하여 템플릿 레코드로 끌어다 놓거나 헤더의 클립 아이콘을 선택하고 파일을 선택합니다. 파일이 추가되면 X 아이콘을 선택하여 대화 상자를 닫습니다.

문서 템플릿에 문서가 첨부되고 '문서' 필드에서 참조됩니다.

create-template-without-field-1

create-template-without-field-2

create-template-without-field-3

필드가 없는 템플릿 만들기에 설명된 것과 동일한 단계를 따라야 합니다. 하지만 문서를 연결한 후에는 필요에 따라 다음 추가 구성 단계를 완료해야 합니다.

  • [Fillable] 필드가 참으로 설정되어 있는지 확인하세요. 

입력 가능한 필드가 포함된 문서가 템플릿과 연결되면 자동으로 선택됩니다.

  • 문서 필드 레코드를 만들어 주세요.

마스터 문서 템플릿에 대한 문서 필드 레코드를 만들고 템플릿의 문서에 포함된 양식 필드의 세부사항을 정의해야 합니다.

이렇게 하려면 문서 템플릿 레코드를 save하고 필드 새로고침을 선택하세요.

첨부된 문서의 입력 가능한 양식 필드에 해당하는 레코드로 '문서 필드' 관련 목록을 채웁니다.

create-template-with-fields

  • 병합 규칙 구성하기

병합 규칙은 문서 템플릿을 ServiceNow 내의 특정 유형의 주제 레코드와 연결합니다.

단일 문서 템플릿에는 여러 병합 규칙이 연결될 수 있습니다(템플릿 필드를 미리 채우는 데 사용된 각 주제 레코드 유형당 하나씩).

예를 들어, 문제, 서비스 요청 또는 변경 요청 레코드의 데이터를 사용해 템플릿을 채울 수 있습니다(이 경우 템플릿에는 각 주제 테이블당 하나씩 세 개의 병합 규칙이 있습니다).

병합 규칙을 구성하려면:

  1. 병합 규칙 관련 목록으로 이동하세요.
  2. 새로 만들기를 선택합니다.
  3. 테이블(예: 문제)을 선택하세요.
  4. 마우스 오른쪽 버튼을 클릭하고 저장을 선택하세요.
merge-rule

  • 병합 필드 구성하기

병합 필드 레코드는 주제 레코드의 필드를 관련 문서 템플릿 내에 포함된 필드와 연결합니다. 병합 규칙을 구성할 때는 병합 필드를 수동으로 만들어야 합니다.

병합 필드 레코드를 만들려면:

  1. Adobe Acrobat Sign > 관리 > 병합 규칙으로 이동합니다.
  2. 병합 규칙 레코드에서 필드 새로고침을 선택하세요.
    '병합 필드' 포함 목록에 문서 필드를 채웁니다.  
  3. 관련 문서 필드를 해당 레코드 필드에 연결하려면 매핑하려는 문서 필드의 해당 레코드 필드 에 대한 링크를 선택합니다(예: 이름).
  4. 드롭다운 메뉴에서 관련 레코드 필드 (예: 발신자)를 선택합니다. 
  5. 업데이트를 선택합니다.

병합 규칙 레코드로 다시 리디렉션됩니다. 병합 필드 관련 목록에는 이전 단계에서 선택한 레코드 필드의 값이 포함됩니다.

깔끔함을 위해 매핑되지 않을 나머지 병합 필드를 삭제하고 확인하여 병합 필드 포함 목록에 매핑되는 값만 포함되도록 합니다.

merge-fields-1

서비스 카탈로그 항목 만들기

ServiceNow용 Acrobat Sign을 사용하면 레코드 생성자를 만들어 사용자가 서비스 카탈로그를 통해 액세스할 수 있는 새 계약을 만들 수 있습니다. 레코드 생성자를 구성하여 문서에 병합할 데이터를 수집하고 자동으로 계약을 만들어 사용자에게 전송할 수 있습니다. 

catalog_admin 또는 admin 권한이 있는 사용자는 카탈로그 항목을 만들 수 있습니다.아래 단계에서는 Record Producer라는 카탈로그 항목을 만드는 방법을 설명합니다.다른 카탈로그 항목을 만드는 단계를 복제할 수 있습니다.

참고: 인스턴스를 구성할 때 Adobe Acrobat Sign 애플리케이션이 선택되지 않았는지 확인하세요.

각 레코드 생성자를 만드는 프로세스는 문서 필드, 템플릿, 변수 등의 특정 요구 사항에 따라 다를 수 있지만 동일한 원칙이 적용됩니다. 이 안내서의 예제에서는 주차 허가 계약을 만드는 방법을 보여줍니다. 

레코드 생성자를 만들려면:

서비스 카탈로그 > 카탈로그 정의 > Record Producers로 이동한 다음 새로 만들기를 선택합니다.

열리는 새 레코드 생성자 페이지에서:

  1. 레코드에 이름을 지정하십시오.
  2. 테이블 이름을 계약[x_adosy_as_agreement]으로 설정합니다.
  3. 간단한 설명을 입력하십시오.
  4. '리디렉션 대상' 필드를 생성된 작업 레코드로 설정하십시오.
작업 레코드 생성

접근성 탭을 선택하고 필요에 따라 카탈로그, 범주, 가용성 필드를 설정하십시오.그런 다음 헤더 표시줄을 마우스 오른쪽 버튼으로 클릭하고 저장을 선택하십시오.

'범주' 및 '카탈로그' 관련 목록을 사용하여 이러한 필드를 설정할 수 있습니다. 

접근성 탭

변수 관련 목록을 사용하여 문서 필드와 일치하도록 필요한 변수를 추가하십시오. 

이 예제에서는 이름, 직원 및 관리자 필드를 추가합니다.

변수 탭

메모

'허가증 이름' 질문 변수의 기본값은 'javascript:'Parking Permit for ' + gs.getUserDisplayName()'입니다.

변수를 가져와서 서명을 위해 전송할 계약서를 생성하는 레코드 프로듀서 스크립트를 구성하십시오.'스크립트' 필드에서:

  1. 카탈로그 항목 변수를 읽는 다음 스크립트를 복사하여 붙여넣으십시오.
  2. 프로듀서에서 정보를 수집하도록 변수 정의를 업데이트하십시오.
  3. 사용 중인 문서 템플릿 sys_id를 업데이트하십시오.
  4. 서명 후 사용자가 다른 곳으로 이동하도록 하려면 post_sign_uri를 업데이트하십시오.

 

// 주차 허가증 템플릿용 Adobe Acrobat Sign 레코드 프로듀서 예제

(function() {

// 사용자가 입력한 변수에서 필요한 정보를 수집합니다

var employee_id = producer.employee + '';

var employee_name = producer.employee.getDisplayValue() + '';

var manager_id = producer.manager + '';

var manager_name = producer.manager.getDisplayValue() + '';

var agreement_name = "Parking permit for " + employee_name;

// 사용 중인 문서 템플릿의 하드코딩된 sys_id

var document_template = '5a2e0131db4c7c10c39151fcd39619af'; // Parking Permit

// 위의 문서 템플릿과 병합할 데이터를 설정합니다.

// 각 속성은 매핑하려는 문서 필드의 이름입니다.

var merge_data = {

name : agreement_name,

employeename : employee_name,

managername : manager_name,

  };

  // 새 계약 설정

var agreement = new x_adosy_as.Agreement(current);

 

  // 서명받을 문서를 추가하세요

agreement.addDocument(document_template, merge_data);

  // 서명자 추가

agreement.addSigner(employee_id);

agreement.addSigner(manager_id);

// 계약 이름을 설정합니다

current.name = agreement_name;

// 서명 후 서명자가 리디렉션될 URL을 설정합니다

current.post_sign_uri = '/x_adosy_as_agreement.do?sys_id=' + current.sys_id;

// 상태를 '준비됨'으로 설정하여 즉시 서명을 위해 전송

current.state = 'Ready';

})();

워크플로 활동에서 계약 만들기

기존 카탈로그 항목에 서명용 문서를 추가하려면 계약을 생성하는 작업을 워크플로에 추가하고 사용자에게 서명하도록 할당하는 카탈로그 작업을 추가할 수 있습니다.

다음 예제는 Acrobat Sign 애플리케이션을 사용하는 방법을 보여주지만, 구성 단계의 세부사항은 프로세스 요구사항에 따라 달라질 수 있습니다.

워크플로 활동에서 계약을 만들려면 다음 구성 요소를 설정해야 합니다:

  • 카탈로그 작업: 계약을 만들고, 서명을 위해 제출하며, 서명자에게 작업을 할당합니다.
  • 스크립트 작업: 계약이 서명될 때 발생하는 이벤트에 응답하여 작업을 종료하고, 피드백 루프를 제공하며 워크플로가 진행되도록 합니다. 

카탈로그 작업을 만들려면:

  1. 워크플로 편집기에서 코어 탭을 선택합니다.
  2. 코어 활동 > 작업으로 이동한 다음 카탈로그 작업 활동을 워크플로의 적절한 위치로 끌어옵니다.
  3. 작업에 이름을 지정하고 우선순위를 설정합니다.
  4. 완료 대기를 참으로 설정합니다.
  5. 스크립트 섹션에서 고급 플래그를 참으로 설정한 다음 고급 스크립트 필드에 코드를 작성합니다. 예제 코드는 아래와 같습니다.
  6. 업데이트를 선택합니다.
워크플로 활동에서 계약 만들기

// 예제 작업 워크플로 활동 생성

(function () {

// 계약에 서명해야 하는 사용자

var signer_id = current.request.requested_for + '';

var signer_name = current.request.requested_for.getDisplayValue() + '';

// 계약 이름

var agreement_name = current.short_description + ' for ' + signer_name;

// 이 작업을 위한 Adobe Sign 문서 템플릿의 하드코딩된 sys_id

// 이것은 실제로 데이터 기반으로 작동하는 워크플로 변수여야 합니다.

var document_template = '2a9b1f57db508810257e73278c9619dc'; // My Template

// newRecord()를 호출하지 않고 GUID 설정 - 계약 제목에 필요

task.setNewGuid(gs.generateGUID(task.getTableName()));

// 작업 설정

task.short_description = current.short_description;

task.assigned_to = signer_id;

task.description = 'Agreement: ' + '\'' + agreement_name + '\'' +

' 서명을 위해 제출되었습니다.\n' +

'서명하려면 다음 중 하나를 선택하십시오:\n' +

'- 다음으로 이동: \'Self-Service > Adobe Sign > For Signature\', 또는\n' +

    - 'Adobe Acrobat Sign'의 계약 링크를 클릭합니다.

    관련 목록(아래).

// 계약 옵션 (계약 레코드의 필드)

var options = {

submit_as_draft: true // 전송하기 전에 Adobe에서 계약 검토

  };

// 서명 프로세스를 지원하기 위한 객체 만들기

var adobe = new x_adosy_as.AdobeSign();

// 계약을 만들기하고 작업 레코드를 제목으로 제공

adobe.createAgreement(agreement_name, task, options);

// 문서 템플릿 추가.

adobe.addDocument(document_template);

// 서명자 추가. 이는 사용자 sys_id 또는 이메일 주소일 수 있습니다.

adobe.addSigner(signer_id);

// Adobe에 계약서를 제출합니다.

adobe.submitAgreement();

})();

이제 계약이 완료되었을 때 카탈로그 작업을 자동으로 완료 종료 상태로 설정하는 스크립트 액션을 설정할 수 있습니다. 계약 테이블에서 x_adosy_as.agreement.complete 이벤트에 의해 트리거되도록 스크립트 액션을 구성해야 합니다.

새로운 스크립트 액션을 만들려면:

  1. 시스템 정책 > 이벤트 > 스크립트 액션으로 이동하여 신규를 클릭합니다.
  2. 새로운 스크립트 액션 페이지에서:
    1. 스크립트 액션에 이름을 지정합니다.
    2. 이벤트 이름을 x_adosy_as.agreement.complete로 설정합니다.
    3. 활성 확인란을 선택합니다. 
    4. 스크립트 필드에 아래 스크립트 액션: 샘플 코드의 스크립트를 복사하여 붙여넣습니다.
  3. 헤더 바를 마우스 우클릭하고 저장을 선택합니다.
worflow-actitivty-script-action

스크립트 액션: 샘플 코드

// 카탈로그 작업 상태를 완료 종료로 설정하는 스크립트 액션

(function () {

var catalog_task = current.subject_id.getRefRecord();

if (!catalog_task.isValidRecord() || catalog_task.getTableName() != 'sc_task') {

return;

  }

catalog_task.state = 3; // 완료 종료

catalog_task.update();

})();

계약 관리와 함께 Acrobat Sign 사용

위에서 설명한 작업 기반 레코드 외에 다른 레코드와 함께 Acrobat Sign을 사용할 수 있습니다 사용자 정의 구성 요소에서. 다음 지침에서는 계약 관리를 위해 Acrobat Sign을 사용하는 방법을 설명합니다.구성 단계의 세부 사항은 프로세스 요구 사항에 따라 다를 수 있습니다.

계약 관리를 위해 Acrobat Sign을 사용하려면 다음 두 가지 구성 요소를 구성해야 합니다.

  • UI 작업: 계약을 만들고 서명을 위해 제출합니다. 계약이 서명되면 이벤트가 실행됩니다. 
  • 스크립트 작업: 이벤트에 응답하고 피드백 루프를 제공하여 프로세스를 진행하고 계약을 업데이트합니다. 

메모: 'ui_action_admin' 또는 'admin' 역할을 가진 사용자만 UI 작업을 정의할 수 있습니다.'admin' 역할을 가진 사용자는 스크립트 작업만 정의할 수 있습니다.

UI 작업 만들기

계약 [ast_contract] 양식에서 UI 작업을 만들려면

시스템 정의 > UI 작업으로 이동한 후 새로 만들기를 선택합니다.

또는 계약 [ast_contract] 양식에서 마우스 오른쪽 버튼을 클릭한 후 구성 > UI 작업 > 새로 만들기를 선택합니다.

UI 작업 새 레코드 페이지에서 다음 세부 사항을 입력합니다.

  1. Table이 'Contract [ast_contract]'인지 확인합니다. 
  2. 이름 필드에 레코드의 이름을 입력합니다.
  3. 테이블 드롭다운 메뉴에서 테이블을 선택합니다.
  4. 순서를 입력합니다.
  5. 활성 확인란을 선택합니다.
  6. 삽입 표시 확인란을 선택합니다.
  7. 업데이트 표시 확인란을 선택합니다.
  8. 양식 버튼 확인란을 선택합니다.
  9. 완료되면 상위 표시줄을 마우스 오른쪽 버튼으로 클릭한 후 저장을 선택합니다. 

폼을 저장하고 다시 로드합니다.

ui-action-new-record

[조건] 필드에 UI 작업을 표시하기 위한 조건을 입력합니다. 

현재 예시에서는 조건을 다음과 같이 선택합니다: 'current.state == 'draft' andand current.substate == 'under_review' andand !current.approver.nil()'.  

조건

[스크립트] 필드에 계약 레코드를 생성하고, 특정 필드 값을 설정하며, Adobe Acrobat Sign에 제출하는 코드를 입력합니다(아래 예시 코드 참조). 

제공하는 코드는 특정 요구 사항에 따라 달라질 수 있지만 일반적인 원칙은 동일합니다.

메모

서 템플릿의 하드코딩된 sys_id는 예시에서 사용하는 템플릿을 참조합니다. 

실제로는 직접 생성한 템플릿을 사용하게 됩니다(템플릿 생성 방법에 대한 자세한 내용은 로컬 템플릿 만들기 참조).

// 새 Adobe Acrobat Sign 계약을 생성하는 UI 작업 예시

(function() {

// 계약 이름

var agreement_name = 'Contract: ' + current.short_description;

// 이 작업에 대한 문서 템플릿의 하드코딩된 sys_id

var document_template = '6d0cdc26db708c50257e73278c9619c4'; // 계약

// 서명 프로세스를 지원하는 객체 생성

var adobe = new x_adosy_as.AdobeSign();

// 계약을 생성하고 현재 레코드를 주제로 제공

adobe.createAgreement(agreement_name, current);

// 문서 템플릿을 추가합니다. 첨부 sys_id일 수도 있습니다.

adobe.addDocument(document_template);

// 서명자를 추가합니다. 사용자 sys_id 또는 이메일 주소일 수 있습니다.

adobe.addSigner(current.approver);

// 계약서를 Adobe에 제출합니다.

adobe.submitAgreement();

// 사용자를 이 레코드로 리디렉션합니다.

action.setRedirectURL(current);

})();

스크립트 작업 만들기

이벤트만으로 스크립트 작업을 트리거할 수 있습니다. 스크립트 액션은 Adobe Acrobat Sign과 함께 제공되는 계약 테이블의 이벤트 중 하나에 의해 트리거되도록 구성됩니다: x_adosy_as.agreement.complete

새 스크립트 작업을 만들려면:

시스템 정책 > 이벤트 > 스크립트 작업으로 이동합니다.

새로 만들기를 선택합니다.

스크립트 작업 새 레코드 페이지에서:

  1. 스크립트 이름을 입력합니다.
  2. 스크립트 작업을 트리거하는 이벤트 이름을 선택합니다.
  3. 활성 확인란을 선택합니다.
  4. 코드를 작성합니다. 아래 예제 코드를 참조하십시오.
스크립트 액션에 이름 지정하기

이 코드에서는 현재 계약서의 subject_id 필드에서 계약을 가져와 계약 테이블의 유효한 레코드인지 확인합니다. 그럴 경우 상태를 활성으로 변경하고 업데이트합니다.

제출을 선택합니다.

스크립팅 API 사용

내부 API를 사용하여 Adobe Acrobat Sign 애플리케이션을 모든 프로세스와 쉽게 연동할 수 있습니다. API는 x_adosy_as 네임스페이스를 통해 사용할 수 있습니다.

AdobeSign()

AdobeSign 인스턴스를 만듭니다.

예:

// AdobeSign의 새로운 인스턴스를 만들기

var adobe = new x_adosy_as.AdobeSign();

#addCcUser(String user_id)

참여하지 않는 사용자와 공유하기 위해 현재 계약에 CC 항목을 추가합니다. ServiceNow 사용자로 등록되지 않은 사용자는 이메일을 제공하여 추가할 수 있습니다.

매개변수:

이름

유형

상태

설명

user_id

문자열

필수

사용자의 sys_id 또는 이메일입니다.

반환:

유형

설명

void

메서드는 값을 반환하지 않습니다

예:

// 계약에 CC 사용자 추가

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('My Agreement');

adobe.addCcUser(current.requested_by);

adobe.addCcUser('abel.tuter@example.com');

#addDocument(String doc_selector, Object merge_data)

현재 계약에 문서 또는 템플릿을 추가하세요.

매개변수:

이름

유형

상태

설명

doc_selector

문자열

필수

템플릿의 이름 또는 템플릿이나 첨부의 sys_id입니다.

merge_data

개체

선택 사항

문서 필드 이름과 문서 필드 값을 매핑하는 키-값 오브젝트입니다.

반환:

유형

설명

문자열

성공하면 만들어진 소스 문서 레코드의 sys_id입니다.

예:

// 템플릿으로 계약 만들기

var template_id = '2a9b1f57db508810257e73278c9619dc';

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('My Agreement');
adobe.addDocument(template_id);

#addElectronicSeal(String seal_id)

현재 계약에 전자 봉인을 추가합니다.

매개변수:

이름

유형

상태

설명

seal_id

문자열

필수

추가할 전자 봉인의 sys_id, 이름 또는 봉인 ID입니다.

반환값:

유형

설명

String|Boolean

새 참가자 레코드의 sys_id이거나 씰을 찾을 수 없는 경우 false입니다.

예:

// 계약에 전자 봉인 추가

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('My Agreement');

adobe.addElectronicSeal('<SEAL>');

#addParticipant(String user_id, String participant_role)

addSigner()의 대체 메서드를 사용하면 지정된 역할을 가진 참가자를 계약에 추가할 수 있습니다.ServiceNow 사용자로 등록되지 않은 참가자는 이메일을 제공하여 추가할 수 있습니다.

참고: 이 방법은 데이터베이스에 저장된 기존 계약 레코드에서만 사용해야 합니다.

매개변수:

이름

유형

상태

설명

user_id

문자열

필수

사용자의 sys_id 또는 이메일 주소입니다.

role

문자열

선택 사항

계약 내에서 참가자의 역할입니다. 기본값은 SIGNER입니다. 다른 값으로는 APPROVER, ACCEPTOR, CERTIFIED_RECIPIENT, FORM_FILLER가 있습니다.

반환값:

유형

설명

문자열|Boolean

새 참가자 레코드의 sys_id 또는 사용자 레코드를 찾을 수 없거나 이메일이 없는 경우 거짓입니다.

예:

// 계약에 참가자 추가

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('My Agreement');

adobe.addParticipant('abel.tuter@example.com', 'APPROVER');

#addSigner(String user_id)

현재 계약에 서명자를 추가합니다. ServiceNow 사용자로 등록되지 않은 서명자는 이메일을 제공하여 추가할 수 있습니다.

매개변수:

이름

유형

상태

설명

user_id

문자열

필수

사용자의 sys_id 또는 이메일 주소입니다.

반환값:

유형

설명

void

메서드는 값을 반환하지 않습니다.

예:

// 계약에 참가자 추가

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('My Agreement');

adobe.addSigner('abel.tuter@example.com');

#copySignedDocumentToRecord(GlideRecord record)

계약의 서명된 문서를 다른 레코드로 복사합니다.

매개변수:

이름

유형

상태

설명

녹음

GlideRecord

필수

서명된 문서를 복사할 대상 레코드입니다.

반환값:

유형

설명

String|Boolean

새 첨부 파일의 sys_id 또는 작업이 실패한 경우 false입니다.

예:

// 대상 레코드 가져오기

var target = new GlideRecord('...');

// 계약에서 대상으로 서명된 문서 복사
var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);

adobe.copySignedDocumentToRecord(target);

#copySignedDocumentToSubject()

계약의 서명된 문서를 해당 대상 레코드에 복사합니다.

반환값:

유형

설명

String|Boolean

새 첨부 파일의 sys_id 또는 작업이 실패한 경우 false입니다.

예:

// 계약에서 서명된 문서를 대상 레코드로 복사
var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);

adobe.copySignedDocumentToSubject();

#createAgreement(String name, GlideRecord subject, Object option

계약을 만듭니다.새 계약을 설정해야 하는 스크립트에서 사용할 수 있습니다.

매개변수:

이름

유형

상태

설명

이름

문자열

필수

계약 이름입니다.

subject

GlideRecord

선택 사항

대상 레코드(예: 계약 또는 요청)

옵션

개체

선택 사항

계약 레코드 필드 이름과 값의 키-값 객체입니다.

반환:

유형

설명

String|null

새 계약의 sys_id 또는 null입니다.

예:

// 새 초안 계약 만들기

var options = {

submit_as_draft: true

};

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement("My Agreement", current, options);

#getAgreement()

현재 범위에 있는 Agreement 인스턴스를 가져옵니다.

반환:

유형

설명

Agreement|null

Agreement 인스턴스 또는 null입니다.

예:

// 계약 인스턴스 가져오기

var adobe = new x_adosy_as.AdobeSign();
adobe.createAgreement("My Agreement", current, options);
var agreement = adobe.getAgreement();

#getAgreementRecord()

현재 계약 레코드를 반환합니다.

반환:

유형

설명

GlideRecord|null

현재 계약 레코드 또는 null입니다.

예:

// 계약 레코드 가져오기

var adobe = new x_adosy_as.AdobeSign();
adobe.createAgreement("My Agreement", current, options);
var agreement = adobe.getAgreementRecord();

#saveAgreement(String state)

현재 계약 레코드를 저장하세요.계약 상태가 선택적으로 전달될 수 있습니다. 상태 매개변수가 "Ready"로 설정되지 않으면 Adobe Acrobat Sign으로의 제출이 트리거되지 않습니다.

매개변수:

이름

유형

상태

설명

상태

문자열

선택 사항

계약의 상태입니다.

반환:

유형

설명

문자열

저장된 계약 기록의 sys_id 또는 null입니다.

예:

// 계약 만들기

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('My Agreement');

adobe.addSigner('abel.tuter@example.com');

adobe.saveAgreement();

#setAgreementRecord(String|GlideRecord agreement)

계약 컨텍스트를 지정된 레코드로 설정합니다.

매개변수:

이름

유형

상태

설명

계약

GlideRecord|String

필수

계약 기록입니다.

반환:

유형

설명

void

메서드가 값을 반환하지 않습니다.

예:

// 계약 작업

var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);

#setSubject(GlideRecord subject

계약의 주제 기록을 설정합니다.

매개변수:

이름

유형

상태

설명

제목

GlideRecord

필수

제목 레코드.

반환:

유형

설명

void

메서드는 값을 반환하지 않습니다.

예:

// 제목 레코드 가져오기
var subject = new GlideRecord('...')

// 계약의 제목 업데이트

var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);
adobe.setSubject(subject);
adobe.saveAgreement();

#submitAgreement()

현재 계약을 저장하고 상태를 "준비됨"으로 설정하여 Adobe Acrobat Sign에 제출합니다.

반환:

유형

설명

문자열

저장된 계약 레코드의 sys_id 또는 null.

예:

// 계약 제출

var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);
adobe.submitAgreement();

.canSend()

현재 사용자가 'Adobe Acrobat으로 서명' UI 작업을 사용할 수 있는지 확인합니다. 인스턴스가 FedRAMP가 아니거나 현재 사용자가 발신자 역할을 가지고 있는 경우 전송이 허용됩니다.

반환:

유형

설명

부울

사용자가 전송할 수 있는 경우 참.

예:

// 현재 사용자가 서명을 위해 전송할 수 있는지 확인

if(AdobeSign.canSend()) {

gs.addInfoMessage('이 사용자는 서명 처리를 사용할 수 있습니다.');

} else {

gs.addErrorMessage('이 사용자는 서명 처리를 사용할 권한이 없습니다.');

}

.getAgreements(String subject_table, String subject_id)

대상과 관련된 계약의 GlideRecord 인스턴스를 가져옵니다.

매개변수:

이름

유형

상태

설명

subject_table

String|GlideRecord

필수

주제 테이블 이름 또는 주제 레코드 자체입니다.

subject_id

문자열

선택 사항

테이블 이름을 전달할 때 주제의 sys_id입니다.

반환값:

유형

설명

GlideRecord

주제와 관련된 계약의 GlideRecord 인스턴스입니다.

예:

// 테이블 이름과 sys_id를 사용하여 계약 가져오기

var agreement = x_adosy_as.AdobeSign.getAgreements('sc_req_item', '<sys_id>');

while (agreement.next()) {

gs.addInfoMessage(agreement.getDisplayValue());

}

// GlideRecord를 사용하여 계약 가져오기

var req_item = new GlideRecord('sc_req_item');

req_item.get('<sys_id>');

var agreement = x_adosy_as.AdobeSign.getAgreements(req_item);

while (agreement.next()) {

gs.addInfoMessage(agreement.getDisplayValue());

}

.getMyAgreements(String query)

사용자에게 속한 계약의 GlideRecord 인스턴스를 가져옵니다. 이 메서드는 초기 쿼리에 x_adosy_as.my_agreements_query 속성을 사용합니다. 쿼리 매개변수를 사용하여 추가 쿼리 필터를 추가할 수 있습니다.

매개변수:

이름

유형

상태

설명

쿼리

문자열

선택 사항

계약 목록을 추가로 제한하는 선택적 인코딩된 쿼리입니다.

         

반환:

유형

설명

GlideRecord

사용자에게 속한 계약입니다.

예:

// 현재 사용자에 대해 완료된 계약을 가져옵니다
var query = 'state=Complete^ORDERBYsys_created_on';

var agreement = x_adosy_as.AdobeSign.getMyAgreements(query);

while (agreement.next()) {

gs.addInfoMessage(agreement.getDisplayValue());

}

.isFedRamp()

시스템이 Adobe FedRAMP(정부 클라우드)에 연결되어 있는지 확인합니다.

반환:

유형

설명

부울

x_adosy_as.fedramp 속성이 "true"로 설정된 경우 참입니다.

예:

// FedRAMP 연결을 사용 중인지 확인합니다

if(x_adosy_as.AdobeSign.isFedRamp()) {

gs.addInfoMessage('Acrobat Sign이 정부 클라우드 연결을 사용 중입니다.');

} else {

gs.addErrorMessage('Acrobat Sign이 정부 클라우드 연결을 사용하지 않습니다.');

}