Salesforce용 Adobe Acrobat Sign: 업그레이드 안내서

v21.0부터 SIGN_Signed_Agreement__c 개체(레이블 이름: 서명된 계약")의 지원이 중단되었습니다.

서명된 계약 URL을 가져오려는 고객은 REST API 계약 호출 GET /agreements/{agreementId}/combinedDocument/url을 사용해야 합니다.

참고: API 호출에서 반환된 URL은 보안이 설정되고 제한된 시간 동안만 실행 가능합니다.

다음은 계약서 및 관련 개체가 업데이트되는 새 시퀀스(v21.0부터 해당)입니다.

1. 첨부 
2. 수신자 
3. 계약서(상태 및 계약서의 기타 특성)
4. 계약 이벤트
5. Chatter 피드

v21.x부터 자동 업데이트와 데이터 매핑을 포함하는 모든 비동기 프로세스가 향후 방법에서 Salesforce가 권장하는 새로운 접근 방식인 대기열 사용 가능으로 전환되었습니다.

이 변경으로 인해 자동 업데이트 및/또는 데이터 매핑 프로세스의 일부로서 Salesforce 대기열에 작업을 추가하는 구독자 조직의 모든 사용자 지정 작업은 실패하고 "System.LimitException: 너무 많은 대기열 사용 가능 작업이 대기열 2에 추가됨"이라는 오류가 표시됩니다.

이 오류는 대기열 사용 가능 프로세스가 Adobe Sign이 이미 차지한 하나의 대기열 사용 가능 하위 작업만 추가할 수 있기 때문(여기에서 "Queueable Apex Limits" 섹션 참조)에 발생합니다.

"작업들을 연결할 때에는 실행 중인 작업에서 하나의 작업만 System.enqueueJob을 사용하여 추가할 수 있으며, 이것은 각 상위 대기열 사용 가능 작업에 대해 하나의 하위 작업만 존재할 수 있음을 의미합니다. 동일한 대기열 사용 가능 작업에서 여러 하위 작업을 시작하는 기능은 지원되지 않습니다."

이 오류의 증상은 계약서 상태가 변경되지 않거나 데이터 매핑이 올바로 실행되지 않는 것입니다. 

이 오류를 해결하려면 문제가 되는 트리거, 프로세스 빌더 또는 작업 과정을 찾아 비활성화하거나, 동기 호출을 사용하도록 전환하거나, 나중에(예: 1시간 후) 예약하세요.

• 이제 문서와 수신자가 업데이트된 후 계약 상태가 업데이트됩니다.
  V 21 이전 버전의 경우 상태가 전에 설정되었습니다.

• 이미지 URL을 저장하는 서명된 계약서 개체는 이제 삽입되지 않습니다.
  v21에서는 다른 업데이트가 모두 완료된 후에 삽입되었습니다.
• 콜아웃 요청 또는 응답의 최대 크기는 Salesforce 관리자 제한에 따라 비동기 Apex의 경우 12MB로 제한됩니다(https://developer.salesforce.com/docs/atlas.en-us.210.0.apexcode.meta/apexcode/apex_gov_limits.htm
  ). 12MB보다 큰 문서는 위의 제한으로 인해 Sign에서 가져올 수 없습니다.

• 계약 이벤트 설명은 이제 Sign API가 감사 보고서와 함께 반환한 설명과 일치합니다.
• 업데이트 프로세스는 이제 Salesforce 내에서 기본 Apex 일괄 처리 프로세스(비동기 프로세스임)로 실행됩니다.
  전에는 Salesforce의 외부에서 API 호출을 사용하는 업데이트였습니다. 이미 실행 중인 비동기 프로세스에서 다른 비동기 프로세스를 호출하는 Salesforce 제한으로 인해 비동기 프로세스를 시작하는 이러한 상태 업데이트의 트리거가 더 이상 작동하지 않습니다.
• 이제 계약 개체가 하나의 트랜잭션에서 모두 업데이트됩니다.
  v21 이전에는 계약 속성 업데이트가 별도의 업데이트 호출로 분할되었습니다.
• 이제는 Sign 백엔드가 지정된 횟수 동안 실패한 이벤트를 자동으로 다시 시도하므로 업데이트가 더 안정적입니다.
  v21 전에는 실패한 계약만 Salesforce 내에서 수동 업데이트를 수행하여 재시도할 수 있었습니다.
• 이제 수동 업데이트는 관련 개체를 포함하여 계약의 모든 측면을 업데이트합니다.
• 푸시 계약은 이제 일반 업데이트와 동일하게 비동기 모드에서 실행되고, 다른 속성들은 일반 업데이트와 동일하게 업데이트됩니다.
• 계약의 다양한 측면에 대한 업데이트를 활성화 및 비활성화하는 새로운 설정이 도입되었습니다.
• 서명한 PDF가 Salesforce에 저장되면 PDF 파일 이름 끝에 더 이상 설명자(-signed 또는 -approved)가 추가되지 않습니다.

업그레이드가 완료되면 아래 단계에 따라 Acrobat Sign에 대한 OAuth 연결을 다시 설정합니다.

1. Adobe Acrobat Sign 관리자 탭을 선택합니다.
2. 자동 상태 업데이트 활성화를 선택합니다.
3. 활성화를 선택합니다.
4. 허용을 선택합니다.

v20에서 Salesforce의 콜백 사용자는 Adobe Sign 라이선스 사용자일 필요가 없었습니다. 

v21에서 푸시 매핑 기능을 개선하려면 콜백 사용자에게 Salesforce 조직에 연결된 Adobe Sign 계정의 활성 사용자 ID가 필요합니다.

푸시 매핑을 사용하는 v20 고객은 업그레이드 전에 콜백 사용자가 이미 Adobe Acrobat Sign에 프로비저닝되었는지 확인해야 합니다. 그러지 않으면 v21로 업그레이드한 후 푸시 매핑의 작동이 중지됩니다(사용자가 프로비저닝될 때까지).

‘연락처 계정/기회 복사’ 설정을 사용하여 관련 개체를 자동으로 연결하는 푸시 매핑 기능이 Salesforce에서 전송된 계약을 포함하도록 확장되었습니다.

• 예를 들어 Salesforce에서 전송한 계약은 전송한 계약에 연결된 계정/기회가 없는 경우 첫 번째 연락처 수신자 [기회] 조회를 계약의 [기회] 조회로 자동 복사하고, 첫 번째 연락처 수신사 [계정] 조회를 계약의 [계정] 조회로 복사합니다.

v21 이전에는 Salesforce 내에서 계약을 전송한 경우에만 Chatter 피드가 채워졌습니다.

이 업데이트는 Salesforce 외부에서 전송한 계약을 포함하도록 Chatter 피드를 확장합니다(계약 푸시).

v21 이전에는 [계약 보기]가 첫 번째 수신자가 동작을 완료한 뒤에 PDF 이미지와 URL만 업데이트했습니다.

이미지와 URL이 미리 작성 상태이거나 서명을 위해 전송됨 상태일 때 첫 번째 수신자에게 먼저 업데이트됩니다.

이 기능을 활성화하는 데 필요한 구성이 없습니다.

새 계약 상태인 나의 위임 대기 중이 도입되어 계약이 현재 수신자 권한을 위임하기 위해 전송자 대기 중 상태임을 보여줍니다.

이 상태를 활성화하는 데 필요한 구성이 없습니다.

계약 템플릿에는 [만료까지 남은 일 수] 필드(echosign_dev1__Days_Until_Expiration__c)가 있습니다.  이는 숫자 필드이며 v21에서 더 이상 사용되지 않습니다.

새로운 “만료까지 남은 일수” 필드(api name: echosign_dev1__Days_Until_Expiration2__c)가 추가되었지만 텍스트 필드이며 마스터 개체(예: {!Expiry_Date__c})의 다른 필드를 참조할 수 있습니다.

이전 버전에서 업그레이드할 때 기존 만료 필드에 매핑된 모든 양식 데이터가 자동으로 새 필드에 복사되므로 직접적인 조치가 필요하지 않습니다.

템플릿 페이지에서 계정, 기회 및 계약 필드는 더 이상 사용할 수 없습니다.

관리자는 데이터를 계약 필드에 매핑 기능을 사용하여 템플릿에서 이러한 필드를 구성할 수 있습니다.

이전에는 전송자가 서명 스택에서 “전송자가 먼저 서명” 또는 “전송자가 마지막으로 설명”으로 절대적 위치를 정의할 수 있었습니다.

이 필드는 새 템플릿 페이지에서 더 이상 사용할 수 없습니다. 전송자는 서명 스택의 모든 위치에 자신을 삽입할 수 있습니다.

전체 서명 흐름을 "순차적" 또는 "병렬"로 제어할 수 있는 토글이 제거되었습니다.

새 템플릿 스타일을 사용하면 서명 인덱스가 특정 작업 과정에 구성된 순차적(서명자 인덱스: 1 - 1+N), 병렬 (모든 서명자 인덱스: 1) 또는 순차적/병렬 혼합이 가능한 완전히 구성 가능한 작업 과정을 사용할 수 있습니다.

5개의 설정은 v21에서 더 이상 사용되지 않습니다. 모든 설정은 사용자 지정 설정의 Adobe Sign 설정 섹션에 있었습니다.

5개의 설정은 다음과 같습니다.

• 첨부 목록에 감사 PDF 추가 - 계약에 서명한 후 감사 내역 PDF를 계약 기록에 첨부하려면 이 설정을 활성화합니다.
• 서명된 PDF를 개별 첨부로 추가 - 하나의 트랜잭션으로 여러 문서가 전송된 경우 서명된 계약서의 PDF를 별도의 첨부 파일로 첨부하려면 이 설정을 활성화합니다. 서명된 계약서를 병합된 PDF로 받는 것을 중단하려면 Adobe 고객 지원 센터에 문의하세요.
• 첨부 목록에 지원 파일 추가 - 계약에 서명한 후 지원 문서의 PDF를 계약 기록에 첨부하려면 이 설정을 활성화합니다. 서명자는 계약서의 지원 문서 필드를 통해 지원 문서를 계약 트랜잭션에 업로드 및 첨부합니다.
• 푸시된 계약에 대해 서명된 PDF 링크 추가(기본적으로 활성화됨) - 이 설정은 Salesforce 외부에서 전송된 푸시된 계약에만 적용됩니다. 서명된 PDF에 대한 링크를 계약 기록에 추가하려면 이 설정을 활성화합니다.
• 푸시된 계약에 대해 서명된 PDF 추가(기본적으로 활성화됨) - 이 설정은 Salesforce 외부에서 전송되어 Salesforce에 푸시된 계약에만 적용됩니다. 서명된 PDF를 계약 기록에 첨부하려면 이 설정을 활성화합니다.

위의 설정을 사용하는 고객은 Adobe Sign 계약 업데이트 설정에서 새로운 설정을 구성할 수 있습니다.