기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon S3에서 API 기반 통합으로 업그레이드
참고
이 섹션에서는 AWS 파트너 CRM 커넥터를 Amazon S3 기반 통합에서 API 기반 통합으로 업그레이드하는 방법을 안내합니다. API 기반 통합은 레거시 Amazon S3 버킷 모델을 IAM 역할 및 APIs.
스크린샷이 포함된 완전 대화형 연습은 AWS AWS 워크숍 웹 사이트의 파트너 CRM 커넥터 업그레이드
업그레이드에는 다음 단계가 포함됩니다.
사전 조건
마이그레이션 작업 순서
파트너는 AWS 콘솔에서 새로운 Partner Central 환경으로 마이그레이션할지 아니면 Amazon S3에서 API로 먼저 업그레이드할지 묻는 경우가 많습니다. 권장 접근 방식은 다음과 같습니다.
| 시나리오 | 권장 사항 |
|---|---|
| 현재 Amazon S3에 있으며 아직 새로운 Partner Central 환경에 있지 않음 | 먼저 API로 마이그레이션한 다음 병렬로 또는 이후에 새 Partner Central 환경으로 마이그레이션합니다. |
| 현재 Amazon S3, 이미 새로운 Partner Central 경험 | API 마이그레이션으로 직접 진행 |
| 아직 새로운 Partner Central 환경이 아닌 API에 이미 있음 | 편리한 시간에 새로운 Partner Central 환경으로 마이그레이션 |
계정 연결은 유일한 하드 사전 조건입니다.
계정 연결은 Amazon S3-API 마이그레이션을 위한 유일한 하드 사전 조건입니다. API 업그레이드를 시작하려면 새 Partner Central 환경으로 마이그레이션할 필요가 없습니다.
주요 정보:
Amazon S3 기반 통합은 더 이상 사용되지 않으며 새 사용자가 더 이상 사용할 수 없습니다.
Amazon S3의 파트너는 서비스 저하를 방지하기 위해 가능한 한 빨리 API로의 마이그레이션을 완료할 계획을 세워야 합니다.
Amazon S3 백엔드 수명 종료에 대한 최신 타임라인은 AWS 파트너 CRM 통합 설명서를 참조하세요. end-of-life
Partner Central이 AWS 계정에 연결되어 있는지 확인
AWS 관리 계정의 관리형 Amazon S3 버킷에 대한 권한을 사용하여 인증된 Amazon S3 기반 커넥터입니다. 대신 API 기반 커넥터는 파트너 자신의 연결된 AWS 계정에서 IAM 역할을 통해 인증하여 Partner Central APIs. 이러한 이유로 계정 연결이 엄격한 기술 사전 조건입니다. 계정이 없으면 커넥터는 필요한 권한을 사용하여 Partner Central APIs에 연결할 수 없습니다.
누락될 수 있는 이유
가 2024년 11월에 Partner Central API for Selling을 AWS 릴리스했을 때 파트너가 이러한 APIs에 프로그래밍 방식으로 액세스할 수 있도록 계정 연결이 도입되었습니다. 커넥터 버전 3.0(2024년 11월)부터 계정 연결은 API 기반 동기화의 요구 사항이 되었습니다. 이 날짜 이전에 Amazon S3 기반 커넥터를 설정한 파트너는 계정 연결을 완료하지 않았을 것입니다.
Partner Central 계정을 기본 AWS 계정에 연결합니다. 처음부터 계정을 신중하게 선택합니다. 다른 계정의 연결을 해제하고 다시 연결할 수 있지만 이렇게 하면 데이터 지속성 문제가 발생하고 수동 조정 작업이 필요합니다.
계정 선택 규칙 - AWS 계정은 다음과 같아야 합니다.
정상 상태의 유료 계정(프리 티어 아님)
파트너의 회사 소유(배포자의 계정이 아님)
파트너의 기본 비즈니스 위치와 일치하는 결제 주소가 있어야 합니다.
샌드박스, 개발자, 개인 또는 관리/지급인 계정이 아님
계정 연결은 영구적입니다.
계정 연결은 Partner Central을 AWS 콘솔로 마이그레이션한 후 영구적입니다. 모든 APN 리소스(ACE 기회, 기록, 다중 파트너 초대)는이 계정에 영구적으로 연결됩니다. 신중하게 선택합니다.
리소스:
Partner Central 웹 사이트에서 계정 연결 해제
선택 사항: AWS 콘솔에서 새로운 Partner Central 환경으로 마이그레이션
Amazon S3-API 커넥터 업그레이드에는이 단계가 필요하지 않습니다. 계정 연결만으로는 필요한 API 기반 기능을 제공합니다. 그러나 새로운 Partner Central 환경으로 마이그레이션하면 팀이 추가 기능에 액세스할 수 있습니다.
파트너 중앙 에이전트(공동 판매 에이전트, 자금 조달 에이전트, 자율 예측)
AWS 리소스와 함께 파트너 활동을 관리하기 위한 중앙 집중식 AWS 콘솔 환경
콘솔에서 직접 기회 수명 주기 이벤트에 대한 가시성 향상
솔루션 ID 형식 변경
새 Partner Central 환경으로 마이그레이션한 다음 새 솔루션을 생성하는 경우 해당 솔루션은 새 soln-* 형식을 사용합니다. CRM 커넥터는 아직이 형식을 지원하지 않습니다. solutionOffered 필드에 레거시 S-* 형식이 필요합니다. 마이그레이션 전에 생성된 레거시 솔루션은 S-* 형식을 유지하고 계속 작동합니다.
자세한 내용은 Partner Central 마이그레이션 가이드를 참조하세요.
마이그레이션 전 데이터 정리
마이그레이션을 시작하기 전에 Amazon S3 기반 통합에서 완전히 잘라내야 합니다. 가장 중요한 단계는 API 기반 커넥터 및 채우기 프로세스를 방해할 수 있는 남아 있는 예약된 작업을 제거하는 것입니다.
커넥터 UI를 통해 Amazon S3 일정을 비활성화하면 기본 Salesforce 예약 작업(APN 접두사 포함)이 시스템에 남아 있습니다. 채우기를 시작하거나 API 기반 동기화를 활성화할 때 여전히 존재하는 경우 이전 스케줄러와 새 커넥터 모두 동일한 레코드에 동시에 쓸 수 있으므로 중복 기회 생성 또는 데이터 충돌이 발생할 수 있습니다.
UI에서 비활성화하는 것만으로는 충분하지 않습니다.
커넥터 UI에서 일정을 비활성화하는 것만으로는 충분하지 않습니다. Salesforce 설정에서 기본 예약된 작업 항목도 삭제해야 합니다. 전체 step-by-step 내용은 Amazon S3 일정 검토 및 비활성화 단원을 참조하십시오.
AWS 인프라 설정
이 단계에서는 Salesforce 관리자가 IT 클라우드 관리자와 협력하여 Salesforce 외부 클라이언트 앱 및 AWS 인프라 구성 요소(EventBridge 규칙 및 IAM 역할)라는 두 가지 새로운 구성 요소를 설정해야 합니다.
Salesforce 외부 클라이언트 앱 설정
Amazon S3 버전에서는 두 동기화 방향이 파트너당 공유 Amazon S3 버킷을 통과했습니다. API 버전은 인바운드 업데이트를 위해 이를 뒤집습니다. 이제 Partner Central은 EventBridge를 통해 이벤트를 실시간으로 조직으로 직접 푸시합니다. 외부 클라이언트 앱은 OAuth 2.0 클라이언트 자격 증명 흐름을 활성화하므로 EventBridge가 알림을 즉시 전송할 수 있습니다.
Salesforce 관리자는 워크숍의 Salesforce에서 외부 클라이언트 앱 설정
AWS 구성 요소 설정
API 버전의 AWS 인프라에는 다음이 포함됩니다.
실시간 이벤트 처리를 위한 EventBridge
보안 인증을 위한 IAM 역할
이러한 구성 요소는 이전 버전에서 사용된 Amazon S3 버킷 액세스 모델을 대체합니다.
IT 클라우드 관리자는 워크숍의 AWS 구성 요소 설정
Salesforce 내에서 설정 및 구성 완료
나머지 구성은 Salesforce 관리자가 수행합니다. 먼저 샌드박스에서 활동을 완료하고 테스트한 다음 프로덕션으로 이동합니다.
Salesforce AppExchange
매핑 검토 및 조정
Amazon S3 버전에서는 아웃바운드 동기화가 Sync with AWS 및 Has Updates for AWS 필드에 의존했습니다. API 기반 통합에는 더 이상 사용되지 않습니다.
API 버전을 사용하면 파트너 CRM 커넥터 사용자 지정 설정()의 AWS 통합과 공유 활성화 설정을 통해 아웃바운드 동기화가 AWS 제어됩니다Companion_App_Settings__c. 활성화하면 적격 업데이트가 발생할 AWS 때마다 ACE 기회가와 자동으로 공유됩니다.
중요 사항:
ACE 기회 객체는 Partner Central의 AWS 기회 데이터 포인트와 일치하고 자동 매핑을 허용하는 랜딩 영역으로 권장됩니다.
통합 매핑에 이미 ACE 기회를 사용하고 있는 경우 기본 구성은 변경되지 않습니다. 그러나 업그레이드된 패키지에는 이전 버전에는 없는 새 필드가 도입되었습니다.
이전 Amazon S3-era 필드(
Sync_with_AWS__c,Has_Updates_for_AWS__c)를 참조하는 자동화를 검토하여 새로운 동등 항목을 사용합니다.
ACE 기회 데이터 모델은 GitHub 웹 사이트에서
최신 커넥터 버전에는 표준 기회를 ACE 기회에 매핑하는 데 도움이 되는 흐름 템플릿이 포함되어 있습니다. 자세한 내용은 흐름 템플릿을 참조하세요.
필수 필드 및 버튼 검토 및 추가
커넥터에는 버전 3.0 이상 이후 새로운 필드와 버튼이 도입되었습니다. 번개 레코드 페이지 레이아웃을 수동으로 업데이트해야 합니다.
ACE 기회 번개 레코드 페이지에 다음 버튼을 추가합니다.
| Button | 용도 |
|---|---|
| 와 공유 AWS | API를 통해 수동으로 Partner Central에 기회를 푸시합니다. |
| 에서 새로 고침 AWS | Partner Central의 최신 데이터를이 ACE 기회 레코드로 가져옵니다. |
| 수락/거부 | AWS추천 기회를 수락하거나 거부합니다. |
| 연결/연결 해제 | AWS승인된 파트너 솔루션, 제품 및 Marketplace 제안과 연결하거나 연결을 해제합니다. |
| Assign | Partner Central 계정의 다른 사용자에게 기회를 재할당합니다. |
ACE 기회 번개 레코드 페이지에서 다음 레거시 버튼을 제거합니다.
| Button | 이유 |
|---|---|
| 로 전송 AWS | 를 공유로 바꿉니다 AWS. |
| 비공개 제안 연결 | 연결/연결 해제로 대체됩니다. |
ACE 기회 탭에 다음 목록 보기 버튼을 추가합니다.
기회 수락 - 여러 추천 기회를 대량 수락 AWS합니다.
기회 할당 - 여러 기회를 대량 재할당합니다.
새 필드의 경우 커넥터 버전 3.0 이후에 추가된 모든 필드를
Amazon S3 일정 검토 및 비활성화
API 기반 접근 방식을 사용하면 더 이상 예약된 작업이 필요하지 않습니다. 통합은 실시간으로 실행됩니다.
예약된 작업을 비활성화하려면
AWS 파트너 CRM 커넥터 앱 내의 일정 탭으로 이동합니다.
모든 작업 비활성화를 선택한 다음 다시 비활성화를 선택합니다.
또한 예약된 레코드를 삭제합니다. 설정에서 나머지 APN 예약 작업을 제거하려면:
설정에서 APN 예약 작업을 제거하려면
설정으로 이동합니다. “예약됨”을 검색하고 예약된 작업을 선택합니다.
APN 관련 작업 목록을 검토합니다. 삭제하려면 Del을 선택합니다.
CustomLogInteractionBatch 실행 유지
CustomLogInteractionBatch 작업을 계속 실행합니다(AppExchange App Analytics).
예약된 작업 삭제, 비활성화만 하지 않음
작업을 "비활성화되었지만 삭제되지 않음" 상태로 두지 마십시오. 링어링 작업을 API 기반 실시간 동기화와 결합하면 중복 기회가 생성됩니다.
정리
레거시 검증 규칙 비활성화
여러 레거시 검증 규칙을 비활성화하고 다른 규칙은 활성 상태로 유지해야 합니다. 전체 step-by-step 및 검증 규칙 표는 워크숍의이 섹션을 참조하세요
또한 다음 레거시 흐름이 비활성화되었는지 확인합니다.
ACE 기회를 Partner Central API와 동기화
비공개 제안 조회
APN 동기화 실패 알림
ACE 기회에서 비공개 제안 필드 업데이트
동기화 로그 세부 정보 레코드의 Ace 기회 필드 업데이트
통합 표준 - ACE 기회 동기화 흐름(템플릿)
프로덕션으로 전환하기 전에 프로세스를 테스트합니다. 워크숍의 설정에서 테스트
에서 Salesforce AWS 로 기회 채우기 완료
채우기를 실행하여 환경 간에 데이터가 일치하는지 확인합니다. 향후 업데이트를 동기화하려면 ACE 기회의 awsapn__Last_Modified_Date__c 필드가 Partner Central의 마지막 수정 날짜와 일치해야 합니다. Amazon S3 통합은이 필드를 채우지 않았으므로 Amazon S3에서 마이그레이션할 경우 비워집니다. 채우기가 필드를 채웁니다.
채우기에는 세 가지 모드가 있습니다.
| Mode | 하는 일 | 사용해야 하는 경우 |
|---|---|---|
| 마지막 수정 날짜가 누락된 새로 고침 기회만 | 가 비어 있는 레코드만 업데이트합니다awsapn__Last_Modified_Date__c. | Amazon S3-API 마이그레이션에 권장 |
| Salesforce에 이미 존재하는 새로 고침 AWS 기회만 | APN CRM ID가 이미 있는 모든 레코드를 업데이트합니다. | 마이그레이션을 위한 안전한 대안 |
| 모든 AWS 기회 새로 고침 | 전체 Partner Central 파이프라인을 Salesforce로 가져옵니다. | 새 설치에만 사용 |
채우기를 실행하기 전에:
모든 APN 예약 작업이 삭제되었는지 확인합니다(비활성화된 작업뿐만 아니라).
활성화된 경우 "파트너 센트럴 API에 ACE 기회 동기화" 흐름을 비활성화합니다.
사용자 지정 설정(
Companion_App_Settings__c)에서 AWS 통합과 공유 활성화를 비활성화합니다.에 설명된 마이그레이션 전 데이터 정리를 완료합니다마이그레이션 전 데이터 정리.
채우기가 완료된 후:
AWS 통합으로 공유 활성화 다시 활성화 - 이를 통해 지속적인 동기화가 이루어집니다.
"파트너 센트럴 API에 ACE 기회 동기화" 흐름을 다시 활성화할 필요가 없습니다.
레코드 샘플이 채워졌
awsapn__Last_Modified_Date__c는지 확인합니다.
자세한 내용은 워크숍의 Partner Central에서 기회 채우기
마이그레이션 후: EventBridge 이벤트 모니터링
마이그레이션 후 Salesforce 조직은 EventBridge를 통해 Partner Central로부터 실시간 업데이트를 받습니다. 이벤트가 흐르고 있는지 확인하려면:
CloudWatch 지표: CloudWatch > 지표 > EventBridge로 이동합니다. API 대상에 대한 호출 및 FailedInvocations 확인합니다.
Salesforce 동기화 로그: 모든 ACE 기회에서 동기화 로그 관련 목록에서 최근 인바운드 항목을 확인합니다.
EventBridge 규칙 모니터링: CloudFormation 템플릿에서 생성한 규칙에 일치하는 최근 이벤트가 있는지 확인합니다.
| 증상 | 가능한 원인 | 해결 방법 |
|---|---|---|
| Salesforce에 인바운드 업데이트 없음 | 외부 클라이언트 앱 토큰 만료 | 연결된 앱을 다시 인증하고 EventBridge API 대상에서 OAuth 자격 증명을 확인합니다. |
| 작업 후 이벤트 중지 | Salesforce 세션 제한 시간 | EventBridge에서 API 대상 상태 확인, 다시 연결 |
| 부분 업데이트(일부 필드 누락) | 필드 매핑 불일치 | 최신 커넥터 버전으로 업그레이드, 필드 매핑 확인 |
일반적인 마이그레이션 문제 해결
| 오류 / 증상 | 근본 원인 | 해결 방법 |
|---|---|---|
FIELD_CUSTOM_VALIDATION_EXCEPTION "새로 고침"을 클릭할 때 AWS | 레거시 검증 규칙이 비활성화되지 않음 | 비활성화 ACEOppNew_PreventUpdatesWhenPOSubmitted 및 ACEOpp_PreventUpdatesWhenPOSubmitted |
| 중복 기회 | 예약된 작업 또는 여러 통합 사용자 링어링 | 모든 APN 예약 작업을 삭제합니다. 한 명의 사용자만를 보유하는지 확인합니다APN Business Admin. |
| 빠르게 증가하는 로그 레코드 동기화 | 주기마다 검증 재시도 실패 레코드 | 동기화 로그를 통해 실패한 레코드를 식별합니다. 누락된 필수 필드를 수정합니다. |
| 채우기 스토리지 제한 초과 | 한 번에 레코드가 너무 많음 | 더 작은 배치로를 실행합니다. 스토리지를 모니터링합니다. |
| "새로 고침 AWS"은 오래된 데이터를 표시합니다. | awsapn__Last_Modified_Date__c 불일치 | "마지막 수정 날짜가 누락된 새로 고침 기회만"을 사용하여 대상 채우기를 다시 실행합니다. |
| Partner Central의 기회가 표시되지 않음 | EventBridge 연결 문제 또는 자동 공유 비활성화됨 | EventBridge API 대상 상태를 확인합니다. " AWS 통합으로 공유 활성화"가 활성화되어 있는지 확인합니다. |
도움말 가져오기
이전 단계에서 해결할 수 없는 문제가 발생하는 경우:
지원 사례 열기: Partner Central → Support → Open New Case
→ CRM Integration 마이그레이션 지원: 복잡한 마이그레이션(500개 이상의 기회, 사용자 지정 통합 또는 이전 프로덕션 인시던트)의 경우 Alliance Lead를 통해 화이트 글로브 지원을 요청합니다.
