기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon S3 통합과 함께 이전 CRM 사용
**중요**
AWS Partner Central은 2024년에 이러한 유형의 통합에 대한 새 요청 수락을 중단했습니다. 이 섹션은 Amazon S3를 사용하는 파트너에게만 적용됩니다.
새 사용자 지정 CRM 통합을 시작하려면 [AWS Partner Central API 참조](https://docs.aws.amazon.com/partner-central/latest/APIReference/aws-partner-central-api-reference-guide.html)를 참조하세요.
**Topics**
+ [Amazon S3 통합을 사용하는 CRM에서 Partner Central API로 업그레이드](upgrade-crm-api.md)
+ [Amazon S3 통합을 사용하여 CRM용 커넥터 구성](s3-config.md)
+ [통합 리소스](resources.md)
+ [리드 공유](custom-lead-sharing.md)
+ [기회 공유](custom-opportunity-sharing.md)
+ [필드 매핑](custom-field-mapping.md)
+ [동기화 일정 생성](crm-connector-scheduling.md)
+ [모범 사례](best-practices.md)
+ [할당량](quotas.md)
+ [버전 기록](version-history.md)
+ [FAQ](faqs.md)
# Amazon S3 통합을 사용하는 CRM에서 Partner Central API로 업그레이드
**참고**
이 섹션의 주제에서는 AWS Partner Central 통합, AWS Marketplace 통합 또는 둘 다에 대한 사전 조건을 완료했다고 가정합니다. 자세한 내용은이 가이드 [시작하기](crm-integration-getting-started.md) 앞부분의 [통합 사전 조건](crm-integration-setting-up.md) 및 섹션을 참조하세요.
다음 섹션의 단계에서는 Amazon S3 통합을 사용하는 이전 CRM에서 AWS Partner Central API로 업그레이드하는 방법을 설명합니다. 업그레이드하면 통합 사용자의 필요성, 동기화 일정 설정 필요성 등 여러 ACE 요구 사항이 필요하지 않습니다.
**Topics**
+ [기능 업그레이드](api-upgrade-features.md)
+ [명명된 자격 증명 설정](set-up-api-credentials.md)
+ [기회 번개 레코드 페이지에 승인 상태 버튼 추가](add-approval-status-button.md)
+ [나머지 버튼 추가](add-remaining-buttons.md)
+ [솔루션 상품 탭 새로 고침](refresh-the-solutions-from-the-solution-offerings-tab.md)
# 기능 업그레이드
업그레이드는 다음과 같은 기능을 제공합니다.
+ Salesforce에서 더 이상 ACE 통합 사용자 권한 세트가 필요하지 않습니다.
+ Salesforce에서 더 이상 ACE 기회에 대한 일정을 생성할 필요가 없습니다.
+ Partner Central API는 **Opportunity Lightning Record** 페이지에서 다음 작업을 활성화하는 버튼 세트도 제공합니다.
+ **승인 상태** - AWS 참조된 기회를 수락하거나 거부합니다.
**참고**
이 버튼은 **파트너 수락 상태** 목록을 대체합니다. 버튼을 사용하여 AWS시작된 기회를 수락해야 합니다.
+ **공유 대상 AWS** - 기회를 생성하고 업데이트합니다.
+ **연결 또는 연결 해제** - 기회 수명 주기 동안 파트너 솔루션, AWS 제품 및 AWS Marketplace 제안과 기회를 연결하거나 연결 해제합니다.
+ **할당** - Partner Central 계정의 다른 사용자에게 기회를 재할당합니다.
명명된 자격 증명을 설정한 후 버튼을 추가합니다. 다음 주제에서는 이러한 작업을 완료하는 방법을 설명합니다.
# 명명된 자격 증명 설정
Partner Central API로 업그레이드하려면 먼저 명명된 자격 증명을 설정합니다. CRM 커넥터는 Salesforce 조직 자격 증명을 사용하여 Partner Central에 인증합니다.
**자격 증명을 설정하려면**
1. Salesforce에 시스템 관리자로 로그인합니다.
1. **명명된 자격 증명**에서 **이전에 새로 만들기**를 선택합니다.
1. **명명된 새 자격 증명** 양식에 다음 표의 값을 입력합니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/partner-central/latest/crm/set-up-api-credentials.html)
1. **저장**을 선택합니다.
1. **AWS안내 설정** 페이지로 돌아갑니다. **인증 세부 정보** 섹션에서 **검토를** 선택하고 자격 증명을 확인합니다.
# 기회 번개 레코드 페이지에 승인 상태 버튼 추가
다음 단계에서는 Opporuntiy Lightning Record 페이지에 **승인 상태** 버튼을 추가하는 방법을 설명합니다. 버튼을 사용하면 승인 프로세스를 거치는 동안 기회의 상태를 볼 수 있습니다.
**버튼을 추가하려면**
1. Salesforce 조직에 시스템 관리자로 로그인합니다.
1. **기회 번개 레코드** 페이지로 이동합니다.
1. 강조 표시된 패널을 선택하여 속성 창을 엽니다.
1. **지금 업그레이드를** 선택합니다.
1. **기존 작업 마이그레이션**을 선택한 다음 작업을 업그레이드할 페이지 레이아웃을 선택합니다.
—또는—
처음부터 시작하여 작업을 수동으로 추가합니다.
1. **작업** 목록에서 **승인 상태를** 선택합니다.
1. **저장**을 선택합니다.
**참고**
4단계와 5단계를 한 번만 완료하면 됩니다.
**승인 상태** 버튼은 AWS추천 기회에 대한 **기회 번개 레코드** 페이지에만 표시됩니다.
# 나머지 버튼 추가
다음 단계에 나열된 버튼 중 일부 또는 전부를 추가할 수 있습니다.
**버튼을 추가하려면**
1. Salesforce 조직에 시스템 관리자로 로그인합니다.
1. **기회 번개 레코드 페이지로** 이동합니다.
1. 강조 표시된 패널을 선택하여 속성 창을 엽니다.
1. **작업에서 할당**을 선택한 다음 다음 항목 중 일부 또는 전부를 선택합니다.
+ **와 공유 AWS**
+ **연결 또는 연결 해제**
+ **할당**
각 버튼의 기능에 대한 자세한 내용은이 가이드 [기능 업그레이드](api-upgrade-features.md)앞부분의 단원을 참조하십시오.
1. **저장**을 선택합니다.
# 솔루션 상품 탭 새로 고침
다음 단계에서는 **솔루션 상품** 탭에서 데이터를 새로 고치는 방법을 설명합니다.
1. Salesforce 조직에 시스템 관리자로 로그인합니다.
1. **솔루션 상품** 탭으로 이동합니다.
1. **솔루션 새로 고침**을 선택합니다.
# Amazon S3 통합을 사용하여 CRM용 커넥터 구성
**중요**
2024년부터 AWS Partner Central은 새 사용자가이 통합 유형을 사용할 수 없도록 했습니다.
**참고**
이 섹션의 주제에서는 AWS Partner Central 통합, AWS Marketplace 통합 또는 둘 다에 대한 사전 조건을 완료했다고 가정합니다. 자세한 내용은이 가이드 [시작하기](crm-integration-getting-started.md) 앞부분의 [통합 사전 조건](crm-integration-setting-up.md) 및 섹션을 참조하세요.
Amazon S3 통합이 적용된 더 이상 사용되지 않는 CRM은 Amazon S3 버킷을 사용하여 리드와 기회를 이전합니다. 기회를 생성하고 관리하려면 이전 섹션에 표시된 대로 Partner Central API 통합을 사용하는 것이 좋습니다. 그러나 커넥터를 사용하여 Salesforce에서 리드를 관리하려는 경우이 구성을 사용할 수 있습니다.
**Topics**
+ [연결 인증 세부 정보 입력](#apn-s3-authentication-details)
+ [시스템 구성 설정 입력](#apn-s3-config-settings)
+ [연결 테스트](#apn-s3-testing)
+ [기회 및 리드 전송 및 수신](#sending-receiving-opportunities-leads)
+ [프로덕션 체크리스트](ace-production-checklist.md)
+ [AWS Partner CRM 커넥터를 새 데이터 모델로 업그레이드](connector-upgrade-plan.md)
+ [사용자 지정 ACE 기회 및 ACE 리드 객체를 사용한 샌드박스 테스트](custom-ace-opportunity.md)
+ [AWS Marketplace 비공개 제안을 ACE 기회에 연결](#linking-private-offers-to-ace)
## 연결 인증 세부 정보 입력
파트너는 Amazon S3 엔드포인트에 연결하는 데 필요한 세부 정보를 입력하여 통합 프로세스를 시작합니다. 나열된 순서대로 각 단계 세트를 따르고 다음 단계로 진행하기 전에 각 세트를 완료합니다.
다음 작업은 **AWS 안내** 설정 탭에서 수행됩니다. 탭 사용에 대한 자세한 내용은이 가이드 [가이드 설정 사용](use-guided-setup.md) 앞부분의 섹션을 참조하세요.
**인증 세부 정보를 입력하려면**
1. Salesforce에서 **AWS 안내** 설정 탭을 엽니다. 이 탭을 여는 방법에 대한 자세한 내용은이 가이드 [가이드 설정 사용](use-guided-setup.md) 앞부분의 섹션을 참조하세요.
1. **1단계: AWS 연결 인증 세부 정보를** 확장하고 **시작을 선택합니다.**
1. **명명된 자격 증명** 페이지에서 **이전에 새로** 만들기를 선택합니다.
1. **새로 명명된 자격 증명** 양식에 다음 표의 값을 입력합니다.
| **필드** | **값** |
| --- | --- |
| Label | APN API 연결 |
| URL | [https://s3.us-west-2.amazonaws.com](https://s3.us-west-2.amazonaws.com) |
| 자격 증명 유형 | 명명된 보안 주체 |
| 인증 프로토콜 | AWS 서명 버전 4 |
| AWS 액세스 키 ID | Cloud-Ops는 사전 조건 단계에서 ID를 제공합니다. |
| AWS 보안 액세스 키 | Cloud-Ops는 사전 조건 단계에서 액세스 키를 제공합니다. |
| AWS 리전 | us-west-2 |
| AWS 서비스 | s3 |
| 권한 부여 헤더 생성 | checked |
| HTTP 헤더에서 병합 필드 허용 | 선택되지 않음 |
| HTTP 본문에서 병합 필드 허용 | 선택되지 않음 |
1. **저장**을 선택합니다.
1. **AWS안내 설정** 페이지로 돌아갑니다. **인증 세부 정보** 섹션에서 **검토를** 선택하고 자격 증명을 확인합니다.
1. **AWS가이드 설정** 페이지를 열어 두고 다음 단계로 이동합니다.
## 시스템 구성 설정 입력
다음 단계에서는 통합에 대한 올바른 시스템 구성 설정을 입력하는 방법을 설명합니다.
1. **2단계: 시스템 구성 설정을** 확장하고 **시작을 선택합니다.**
1. **AWS 파트너 CRM 커넥터 설정을** 찾아 **관리를** 선택합니다.
1. **새로** 만들기를 선택한 다음 다음 표에서 필요한 값을 입력합니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/partner-central/latest/crm/s3-config.html)
1. **저장**을 선택합니다.
1. **AWS안내 설정** 페이지로 돌아갑니다. **인증 세부 정보** 섹션에서 **검토를** 선택하고 자격 증명을 확인합니다.
## 연결 테스트
연결을 테스트하기 전에 이전 섹션의 단계를 완료해야 합니다.
**연결을 테스트하려면**
1. **3단계: APN API에 대한 구성 테스트를** 확장합니다.
1. **테스트**를 선택합니다.
연결이 성공하면 확인 메시지가 표시됩니다.
## 기회 및 리드 전송 및 수신
기회와 리드를 Partner Central과 동기화하여 보내고 받습니다. 기회 또는 리드를 동기화하려면 **Partner Central과 동기화** 필드를 **True**로 설정해야 합니다. 통합을 위한 추가 키 필드에는 **마지막 APN 동기화 날짜와** **APN과 동기화할 수 있는 자격** 필드가 포함됩니다.
이러한 필드는 표준 기회 및 리드에 포함됩니다. 그러나 모든 사용자 지정 소스 객체에 대해 해당 객체를 생성하고 매핑해야 합니다.
+ **Partner Central과 동기화** - 표준 기회 및 리드를 위해 앱에 포함됩니다. 가 사용자 지정 객체에 매핑하기로 AWS Partner 선택한 경우 각각 기회 및 리드 매핑에서 사용자 지정 부울 필드를 생성하고 매핑해야 합니다.
+ **APN과의 마지막 동기화 날짜** - 레코드가 APN으로 성공적으로 전송되거나 APN에서 수신된 마지막 시간을 나타냅니다. 레코드가 APN으로 성공적으로 전송되거나 APN에서 업데이트가 수신되면이 필드가 자동으로 설정됩니다.
+ **APN과 동기화 가능** - 레코드가 다음 예약된 작업에서 APN으로 전송되도록 대상 지정되었는지 여부를 결정하는 공식 필드입니다. 아웃바운드 일정이 마지막으로 실행된 이후 레코드가 수정되었는지 여부와 AWS Partner의 조직에 지정된 통합 사용자가 아닌 사용자가 레코드를 업데이트했는지 여부를 기준으로 계산됩니다.
# 프로덕션 체크리스트
다음 단계에 따라 AWS Partner CRM 커넥터의 프로덕션 설치를 완료합니다.
1. CRM 통합에 대한 [온보딩 프로세스를](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-getting-started.html) 완료했는지 확인합니다. 이 프로세스의 [6단계](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html)에서는 프로덕션 환경을 설정하고 데이터 마이그레이션을 수행하여 통합을 통해 기회와 리드를 관리할 수 있습니다.
1. CRM 커넥터를 설치하고 구성합니다. 자세한 정보는 [커넥터 설치](install-connector.md) 섹션을 참조하세요.
1. 다음 매핑 옵션 중 하나를 선택하여 기회를 매핑하고 객체를 리드합니다. 참조는 GitHub의이 [필수 필드](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv) 목록을 참조하세요.
+ AWS Partner CRM 커넥터와 함께 제공된 AWS ACE 기회 사용자 지정 객체를 사용하여 기회를 기록하고 공유합니다 AWS. 이 옵션을 사용하면 AWS 필드를 Salesforce 필드에 자동으로 매핑할 수 있습니다.
+ 표준 Salesforce 객체를 사용하고 필수 AWS 필드를 매핑합니다.
+ ACE 사용자 지정 기회 객체를 사용합니다. 먼저 워크플로를 생성하여 ACE 기회 객체의 중간 테이블을 채운 다음 Salesforce 필드를에 매핑합니다 AWS.
1. 매핑 옵션에 대한 추가 세부 정보 및 지침은 섹션을 참조하세요[ACE 객체 매핑](crm-connector-mapping.md).
1. (선택 사항) 네트워크와 Salesforce 간의 AWS Partner 인바운드 및 아웃바운드 동기화 일정을 설정합니다. 자세한 내용은 [동기화 일정 생성](crm-connector-scheduling.md) 섹션을 참조하세요.
1. 파트너 생성 프로덕션 기회를 검증하려면 Partner Central 계정에서 파트너 중앙 운영(PCO)에 [지원 사례를](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-faq.html#troubleshooting) 제기하세요. 이 프로세스에서는 더미 기회를 생성하고, 동기화하고 AWS, 지원 에이전트에게가 AWS 기회를 AWS 받았는지 확인하도록 요청합니다. 테스트가 끝나면 AWS 지원 에이전트에게 기회 요청을 거부하도록 요청하여 사용자 측에서 삭제할 수 있습니다.
1. (선택 사항) 데이터 채우기를 수행합니다. 이 프로세스를 통해 향후 업데이트 중에 AWS 오리진 기회 추천과 파트너 오리진 기회 추천을 모두 식별할 수 있습니다. 자세한 내용은 CRM 온보딩 프로세스의 [6단계: 프로덕션 승인을](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html) 참조하세요.
1. 프로덕션 통합을 활성화하여 Amazon S3 버킷을 통해 파일을 교환할 수 있도록 합니다. 자세한 내용은 [7단계: 시작](https://docs.aws.amazon.com/partner-central/latest/crm/stage-7-launch.html)을 참조하세요.
# AWS Partner CRM 커넥터를 새 데이터 모델로 업그레이드
**중요**
프로덕션 환경을 업그레이드하기 전에 샌드박스 Salesforce 조직에서 새 데이터 모델 업그레이드를 테스트하고 승인합니다. 새 데이터 모델과 이전 모델과 새 모델 간의 변경 사항은 GitHub에서 다음 [aws-samples/partner-crm-integration-samples](https://github.com/aws-samples/partner-crm-integration-samples/tree/main/opportunity-samples)를 참조하세요.
**Opportunity-FieldsAndStandardValues-DiffWithPrevVersion-V14.3.xlsx**
**Opportunity-Fields.xlsx**
**Opportunity\$1-\$1StandardValues.xlsx**
## 사전 조건
+ ACE CRM 통합의 새 데이터 모델 지침에 필드 정의를 사용하고 필요한 열린 기회를 마이그레이션하여 새 데이터 모델로 이끕니다.
+ 사용자 지정 또는 표준 객체(매핑에 사용되는 객체)에서 열을 추가하거나 제거합니다.
+ AWS Partner CRM 커넥터 버전 2.0 이상을 사용하고 있는지 확인합니다.
**새 데이터 모델로 업그레이드하려면**
1. Salesforce 조직에 시스템 관리자로 로그인합니다.
1. 활성 일정을 비활성화합니다.
1. **설정**, **사용자 지정 설정**, **AWS Partner CRM 커넥터 설정을** 선택한 다음 버전을 **2.0** 이상으로 업데이트합니다.
**참고**
버전 2.0부터 **버전** 필드는 필수입니다. 이 필드는 파트너가 CRM 통합과 상호 작용하는 데 사용하는 페이로드 버전을 지정합니다. 파트너가 버전 2.0으로 전환하면 사양을 완전히 채택해야 합니다. 이전 버전으로 되돌리는 것은 허용되지 않습니다.
1. **ACE 매핑** 탭을 선택합니다.
1. 모든 필수 필드 매핑 및 세부 정보를 생성, 검토 및 업데이트합니다. 샌드박스 테스트의 경우 사용자 지정 ACE 기회 및 ACE 리드 객체를 사용하여 새 데이터 모델 기능을 테스트합니다. 자세한 정보는 [사용자 지정 ACE 기회 및 ACE 리드 객체를 사용한 샌드박스 테스트](custom-ace-opportunity.md) 섹션을 참조하세요.
1. 기회 및 리드에 대한 일정을 활성화합니다.
1. ACE 동기화 로그에서 동기화 오류를 검토하고 수정합니다.
1. 동기화된 기회와 리드를 검토하여 데이터 변환이 정확한지 확인합니다. 또는 ACE의 기회와 리드를 검토하여 새 데이터 모델 변경 사항이 정확하게 캡처되는지 확인합니다.
1. 제품 배포 프로세스에 따라 변경 사항을 프로덕션 Salesforce 환경으로 마이그레이션합니다.
**참고**
도움이 필요한 경우 단원을 참조하십시오[도움말 가져오기](getting-help.md).
# 사용자 지정 ACE 기회 및 ACE 리드 객체를 사용한 샌드박스 테스트
**참고**
기존 CRM 커넥터 사용자인 경우 섹션을 참조하세요[AWS Partner CRM 커넥터를 새 데이터 모델로 업그레이드](connector-upgrade-plan.md).
1. Salesforce 조직에 시스템 관리자로 로그인합니다.
1. **설정**, **사용자 지정 설정**, **AWS Partner CRM 커넥터 설정을** 선택하고 버전을 **2**로 업데이트합니다.
1. **ACE 매핑** 탭을 선택합니다.
1. **기회**의 경우 **ACE 기회** 사용자 지정 객체에 매핑합니다.
1. **ACE 객체 자동 매핑을** 선택합니다.
**참고**
샌드박스 테스트를 위해 커넥터에서 사용자 지정 ACE 기회 및 ACE 리드 객체를 사용하려는 CRM 커넥터의 새 버전으로 업그레이드하려면 Auto Map ACE `Field Mapping Details` 객체 기능을 사용하기 전에 데이터베이스에서 `Field Mappings` 및 객체에서 사용 가능한 레코드를 수동으로 삭제하는 것이 좋습니다. 이 작업은 한 번만 수행하면 됩니다.
1. 선택 목록 및 다중 선택 목록에 대한 필드 매핑 및 필드 매핑 값을 검토합니다.
1. 기회 및 리드에 대한 일정을 활성화합니다.
1. ACE 동기화 로그에서 동기화 오류를 검토하고 필요한 수정을 수행합니다.
1. 동기화된 기회와 리드를 검토하여 데이터 변환이 정확한지 확인합니다. 또는 ACE의 기회와 리드를 검토하여 새 데이터 모델 변경 사항이 정확하게 캡처되었는지 확인합니다.
## ACE 기회에 대한 동기화 로그 세부 정보 레코드 보기
ACE 기회 레코드의 **관련** 탭에서 AWS전달된 ACE 기회에 대한 동기화 로그 세부 정보를 볼 수 있습니다.
**참고**
이 단계는 AWS전송된 ACE 기회 객체에만 적용됩니다. Salesforce 조직의 표준 또는 사용자 지정 객체에 매핑하는 경우 **ACE 동기화 로그 탭에서 동기화 로그** 세부 정보를 볼 수 있습니다.
1. Salesforce 조직에 로그인합니다.
1. **App Launcher**에서 **AWS Partner CRM 커넥터를** 선택합니다.
1. **ACE 기회** 탭을 선택합니다.
1. ACE 기회 레코드를 선택합니다.
1. **관련** 탭을 선택하면 **동기화 로그 이름**, **상태**, **오류 메시지**, **생성 날짜** 등의 세부 정보를 볼 수 있습니다.
## AWS Marketplace 비공개 제안을 ACE 기회에 연결
AWS 제공된 ACE 기회 레코드 페이지에서 비공개 제안을 직접 연결할 수 있습니다.
1. Salesforce 조직에 로그인합니다.
1. **App Launcher**에서 **AWS Partner CRM 커넥터를** 선택합니다.
1. **ACE 기회** 탭을 선택합니다.
1. ACE 기회 레코드를 선택합니다.
1. **비공개 제안 연결을** 선택합니다.
1. **제안 ID 조회**에서 비공개 제안을 선택합니다.
1. **저장**을 선택합니다.
# 통합 리소스
AWS 는 사용자 지정 통합을 생성하는 데 도움이 되는 다음 리소스를 제공합니다.
**Topics**
+ [필드 정의](#custom-field-definitions)
+ [표준 값](#standard-values)
+ [샘플 인바운드 파일](#sample-inbound-files)
+ [샘플 아웃바운드 파일](#sample-outbound-files)
+ [처리된 결과 샘플](#sample-processed-results)
+ [샘플 테스트 사례](#sample-test-cases)
+ [샘플 코드 조각](#sample-code-snippets)
## 필드 정의
다음 섹션의 링크에는 데이터 유형, 사용량, 적용되는 제약 조건 또는 형식 지정 규칙을 설명하는 모든 필드가 나열됩니다. 파트너 및가 데이터를 AWS 교환할 때 올바른 형식이 지정되고 이해되도록 하는 참조 역할을 합니다.
다음 링크를 클릭하면 GitHub로 이동합니다.
+ [Opportunity](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)
+ [리드](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv)
## 표준 값
이 목록에는 다양한 필드의 표준 값과 열거형이 요약되어 있습니다. 이를 통해 교환되는 데이터의 일관성을 유지하고 양 당사자가 사용된 값을 공통으로 이해할 수 있습니다.
다음 링크를 클릭하면 GitHub로 이동합니다.
+ [Opportunity](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity_-_StandardValues.csv)
+ [리드](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead_-_StandardValues.csv)
## 샘플 인바운드 파일
다음 샘플 파일은 파트너가 보낸 파일의 JSON 페이로드 구조를 보여줍니다 AWS.
다음 링크를 클릭하면 GitHub로 이동합니다.
+ [Opportunity](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Create-Inbound-Sample.json)
+ [리드](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Update-Inbound-Sample.json)
## 샘플 아웃바운드 파일
다음 샘플 파일은에서 파트너로 전송된 파일의 JSON AWS 페이로드 구조를 보여줍니다.
다음 링크를 클릭하면 GitHub로 이동합니다.
+ [Opportunity](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Outbound-Sample.json)
+ [리드](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Outbound-Sample.json)
## 처리된 결과 샘플
다음 파일은가 파트너가 보낸 페이로드를 AWS 처리한 후의 일반적인 결과를 보여줍니다.
다음 링크를 클릭하면 GitHub로 이동합니다.
+ [Opportunity](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
+ [리드](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)
## 샘플 테스트 사례
다음 링크를 클릭하면 GitHub로 이동합니다.
+ [Opportunity](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity%20-%20Testing%20Scenarios.xlsx)
+ [리드](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead%20-%20Testing%20Scenarios.xlsx)
## 샘플 코드 조각
다음 링크를 클릭하면 GitHub로 이동합니다.
+ [ace\$1read\$1s3.py](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
+ [Apex\$1Sample\$1REST\$1API\$1Code.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)
+ [S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
+ [Sample\$1AceOutboundBatch.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ [SFDC apex s3 sample.txt](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/SFDC_apex_s3_sample.txt)
+ [Apex\$1get\$1files\$1from\$1s3\$1ace\$1partner\$1test.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_get_files_from_s3_ace_partner_test.cls)
+ [s3\$1ace\$1partner\$1test.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/s3_ace_partner_test.cls)
# 리드 공유
## AWS 가 리드를 공유하는 방법
1. **증분 내보내기**: Amazon Web Services(AWS)는 AWS에서 참조하는 새 리드(및 업데이트)를 시간별로 내보냅니다.
1. **파일 생성**: AWS 특정 형식을 준수하는 리드 파일을 생성합니다. 자세한 파일 사양은 섹션을 참조하세요[필드 정의](resources.md#custom-field-definitions).
1. **파일 업로드**: 리드 파일이 `lead-outbound` 폴더에 업로드됩니다.
## 에서 리드 사용 AWS
리드를 효과적으로 사용하려면 다음 기능과 사용자 지정 통합을 AWS구축합니다.
1. **파일 검색**:
+ 선택한 간격으로 예약된 작업을 사용하여 `lead-outbound` 폴더를 정기적으로 스캔합니다.
+ 처리할 리드 파일을 검색합니다.
1. **데이터 변환 및 매핑**:
+ 각 파일의 내용을 읽은 후 데이터를 변환하고 고객 관계 관리(CRM) 시스템의 리드 레코드에 매핑합니다.
+ 필드 매핑에 대한 지침은 섹션을 참조하세요[필드 매핑](custom-field-mapping.md).
1. **리드 식별**:
+ `partnerCrmLeadId` 또는를 사용하여 각 리드를 고유하게 식별합니다`apnCrmUniqueIdentifier`.
+ `partnerCrmLeadId`가 비어 있고 `apnCrmUniqueIdentifier`가 있는 경우 리드는 AWS Partner Network (APN) Customer Engagement(ACE)의 새로운 추천입니다.
+ 두 식별자가 모두 있는 경우 레코드는 ACE의 업데이트로 처리됩니다.
1. **리드 수집**:
+ CRM 시스템에서 새 리드를 수집하거나 기존 리드를 업데이트합니다.
1. **파일 관리**:
+ 각 리드와 전체 파일 데이터를 성공적으로 처리한 후 아웃바운드 폴더에서 파일을 삭제합니다.
+ 각 파일은 `lead-outbound-archive` 폴더에 자동으로 보관됩니다.
**통합 및 코드 참조**:
+ Amazon Simple Storage Service(Amazon S3) 버킷에 업로드된 파일을 읽으려면를 사용하거나 CRM 시스템에서 직접 AWS Lambda 읽을 수 있습니다.
+ Lambda 및 Salesforce REST API에 대한 아래 샘플 코드를 사용하여 CRM 레코드를 검증하고 업데이트합니다.
+ **파일 검증을 위한 Lambda**: [ace\$1read\$1s3.py](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py).
+ **Salesforce REST API**: [Apex\$1Sample\$1REST\$1API\$1Code.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls).
+ Salesforce 이외의 CRM 시스템을 사용하는 경우 데이터를 업데이트하려면 시스템별 코드를 제공해야 합니다.
## 와 리드에 대한 업데이트 공유 AWS
1. **리드 식별**: 공유할 업데이트가 있는 리드를 찾습니다 AWS.
1. **데이터 변환**:에 설명된 대로 데이터를 AWS 형식으로 변환합니다[필드 정의](resources.md#custom-field-definitions).
1. **파일 생성**:
+ JSON 형식으로 리드 파일을 생성합니다.
+ 각 파일에 타임스탬프를 추가하여 모든 파일 이름이 고유한지 확인하고 형식을 따릅니다`{name}_MMDDYYYY24HHMMSS.json`.
1. **인증 및 업로드**:
+ ACE Amazon S3 버킷에 인증합니다.
+ 파일을 `lead-inbound` 폴더에 업로드합니다. 와 공유된 모든 파일은 `lead-inbound-archive` 폴더에 자동으로 보관 AWS 됩니다.
+ S3에 파일을 업로드할 때 버킷 소유자에게 전체 액세스 권한을 제공해야 합니다.
```
aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control
```
["Results Sample file.json"](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)에서이 명령을 실행한 샘플 결과를 참조하십시오.
1. **파일 처리**:
+ 수신 시는 파일을 AWS 자동으로 처리합니다.
+ 처리 결과는 Amazon S3 버킷의 `lead-inbound-processed-results` 폴더에 업로드됩니다. 여기에는 성공 및 오류 상태와 각 리드에 대한 오류 메시지가 포함됩니다.
+ 이러한 처리된 결과도 `lead-inbound-processed-results-archive` 폴더에 보관됩니다.
+ 자세한 내용은 단원을 참조하십시오[기술 FAQ - 리드 및 기회](technical-faq-leads-and-opps.md).
1. **응답 처리**:
+ 이러한 응답을 사용하고, 잘못된 레코드를 검토하고, 오류를 수정하고, 데이터를 ACE로 재전송하는 로직을 개발해야 합니다.
+ FAQ 및 문제 해결 섹션에서 샘플 오류를 찾을 수 있습니다.
+ CRM에서 Amazon S3에 파일을 업로드하려면:
+ AWS 서명 버전을 참조합니다.
+ HTTPS 요청을 사용하여 파일을 업로드합니다.
+ 참조용으로 다음 파일을 사용하여 Amazon S3 버킷에 파일을 업로드합니다.
+ **S3 버킷 인증**: [S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
+ **S3 버킷에 파일을 업로드하는 경우**: [Sample\$1AceOutboundBatch.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ **참고:** 파일은 크기가 1MB를 초과해서는 안 되며 중복 파일은 처리되지 않습니다.
# 기회 공유
## 가 기회를 AWS 공유하는 방법
1. **증분 내보내기**: Amazon Web Services(AWS)는 AWS에서 참조하는 새로운 기회(및 업데이트)를 시간별로 내보냅니다.
1. **파일 생성**: AWS 는 특정 형식을 준수하는 기회 파일을 생성합니다. 자세한 파일 사양은 [기회 필드 정의를](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv) 참조하세요.
1. **파일 업로드**: 기회 파일이 `opportunity-outbound` 폴더에 업로드됩니다.
## 에서 기회 사용 AWS
기회를 효과적으로 소비하려면 이러한 기능과의 사용자 지정 통합을 구축 AWS해야 합니다.
1. **파일 검색**:
+ 선택한 간격으로 예약된 작업을 사용하여 `opportunity-outbound` 폴더를 정기적으로 스캔합니다.
+ 처리할 기회 파일을 검색합니다.
1. **데이터 변환 및 매핑**:
+ 각 파일의 내용을 읽은 후 데이터를 변환하고 고객 관계 관리(CRM) 시스템의 기회 레코드에 매핑합니다.
+ 필드 매핑에 대한 지침은 섹션을 참조하세요[필드 매핑](custom-field-mapping.md).
1. **기회 식별**:
+ `partnerCrmOpportunityId` 또는 중 하나를 사용하여 각 기회를 고유하게 식별합니다`apnCrmUniqueIdentifier`.
+ `partnerCrmOpportunityId`가 비어 있고 `apnCrmUniqueIdentifier`가 있는 경우 기회는 AWS Partner Network (APN) Customer Engagement(ACE)의 새로운 추천입니다.
+ 두 식별자가 모두 있는 경우 레코드는 ACE의 업데이트로 처리됩니다.
1. **기회 수집**: CRM 시스템에서 새로운 기회를 수집하거나 기존 기회를 업데이트합니다.
1. **파일 관리**:
+ 각 기회와 전체 파일 데이터를 성공적으로 처리한 후 아웃바운드 폴더에서 파일을 삭제합니다.
+ 각 파일은 `opportunity-outbound-archive` 폴더에 자동으로 보관됩니다.
**통합 및 코드 참조**:
+ Amazon Simple Storage Service(Amazon S3) 버킷에 업로드된 파일을 읽으려면를 사용하거나 CRM 시스템에서 직접 AWS Lambda 읽을 수 있습니다.
+ Lambda 및 Salesforce REST API에 대한 아래 샘플 코드를 사용하여 CRM 레코드를 검증하고 업데이트합니다.
+ **파일 검증을 위한 Lambda**: [ace\$1read\$1s3.py](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py).
+ **Salesforce REST API**: [Apex\$1Sample\$1REST\$1API\$1Code.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls).
+ Salesforce 이외의 CRM 시스템을 사용하는 경우 데이터를 업데이트하려면 시스템별 코드를 제공해야 합니다.
## 와 기회에 대한 업데이트 공유 AWS
1. **기회 식별**:와 공유할 업데이트가 있는 기회를 찾습니다 AWS.
1. **데이터 변환**:에 설명된 대로 데이터를 AWS 형식으로 변환합니다[필드 정의](resources.md#custom-field-definitions).
1. **파일 생성**:
+ 기회 파일을 JSON 형식으로 생성합니다.
+ 각 파일에 타임스탬프를 추가하여 모든 파일 이름이 고유한지 확인하고 형식을 따릅니다`{name}_MMDDYYYY24HHMMSS.json`.
1. **인증 및 업로드**:
+ ACE Amazon S3 버킷에 인증합니다.
+ 파일을 `opportunity-inbound` 폴더에 업로드합니다. 와 공유된 모든 파일은 `opportunity-inbound-archive` 폴더에 자동으로 보관 AWS 됩니다.
+ S3에 파일을 업로드할 때 버킷 소유자에게 전체 액세스 권한을 제공해야 합니다.
```
aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control
```
[기회 결과 성공 Sample.json에서이 명령을 실행한 샘플 결과를](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json) 참조하세요.
1. **파일 처리**:
+ 수신 시는 파일을 AWS 자동으로 처리합니다.
+ 처리 결과는 Amazon S3 버킷의 `lead-inbound-processed-results` 폴더에 업로드됩니다. 여기에는 성공 및 오류 상태와 각 기회에 대한 오류 메시지가 포함됩니다.
+ 이러한 처리된 결과도 `opportunity-inbound-processed-results-archive` 폴더에 보관됩니다.
+ 자세한 내용은 단원을 참조하십시오[기술 FAQ - 리드 및 기회](technical-faq-leads-and-opps.md).
1. **응답 처리**:
+ 이러한 응답을 사용하고, 잘못된 레코드를 검토하고, 오류를 수정하고, 데이터를 ACE로 재전송하는 로직을 개발해야 합니다.
+ FAQ 및 문제 해결 섹션에서 샘플 오류를 찾을 수 있습니다.
+ CRM에서 Amazon S3에 파일을 업로드하려면:
+ AWS 서명 버전을 참조합니다.
+ HTTPS 요청을 사용하여 파일을 업로드합니다.
+ 참조용으로 다음 파일을 사용하여 Amazon S3 버킷에 파일을 업로드합니다.
+ **S3 버킷 인증**: [S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
+ **S3 버킷에 파일을 업로드하는 경우**: [Sample\$1AceOutboundBatch.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ **참고:** 파일은 크기가 1MB를 초과해서는 안 되며 중복 파일은 처리되지 않습니다.
# 필드 매핑
필드 매핑은 파트너가 고객 관계 관리(CRM) 시스템의 필드를 Amazon Web Services()에서 정의한 필드와 일치시키는 통합 프로세스의 필수 단계입니다AWS. 이렇게 하면 양 당사자가 데이터를 정확하게 교환하고 이해할 수 있습니다. 다음은이 프로세스에 도움이 되는 지침입니다.
## 필수 필드 매핑
+ 각 필수 필드를 CRM 시스템의 해당 필드에 매핑합니다. 모든 필수 필드가 매핑되었는지 확인할 때 성공적인 데이터 교환에 필수적입니다. 자세한 정보는 [필드 정의](resources.md#custom-field-definitions) 섹션을 참조하세요.
+ [Opportunity](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)
+ [리드](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv)
## 선택적 필드 처리
+ 통합 프로세스에서 선택적 필드의 역할을 이해합니다. 비즈니스 요구 사항에 따라 이러한 필드를 매핑할지 여부를 결정하고 매핑되지 않은 상태로 두면 발생할 수 있는 영향을 인식합니다.
## 값 매핑
+ 에 지정된 대로 CRM의 각 필드 값을 필수 AWS Partner Network (APN) 고객 참여(ACE) 목록 값과 정렬합니다[필드 정의](resources.md#custom-field-definitions). 이는 데이터 일관성과 무결성을 유지하는 데 중요합니다.
## 데이터 유형 및 형식 검증
+ CRM 시스템 필드의 데이터 형식과 형식이 AWS *필드 정의*에 지정된 형식과 일치하는지 확인합니다. 데이터 손상을 방지하고 원활한 통합을 위해서는 데이터 유형 및 형식의 일관성을 유지하는 것이 필수적입니다.
## 필드 길이 및 제한 사항
+ 필드 길이 제한 및 기타 제한 사항에 유의하십시오. CRM 시스템의 데이터가 잘리거나 오류를 일으키지 AWS 않고의 해당 필드에 맞는지 확인합니다.
## 데이터 유형 및 형식 검증
+ CRM 시스템의 필드 데이터 형식이에 지정된 형식과 일치하는지 확인합니다[필드 정의](resources.md#custom-field-definitions). 데이터 손상을 방지하고 데이터 유형 및 형식의 일관성과 원활한 통합을 보장하는 것이 중요합니다.
## 정기 검토 및 업데이트
+ CRM 시스템 또는 AWS 요구 사항의 변경 사항을 수용할 수 있도록 필드 매핑을 정기적으로 검토하고 업데이트합니다. 이 선제적 접근 방식은 지속적인 데이터 교환 정확도와 효율성을 보장합니다.
## 필드 매핑 설명서
+ 포괄적인 필드 매핑 설명서를 유지 관리합니다. 이 방법은 문제 해결, 향후 업데이트 및 시스템 간 데이터 전송 방식의 명확성을 보장하는 데 도움이 됩니다.
## 테스트 및 검증
+ 철저한 필드 매핑 테스트를 수행하여 데이터가 정확하게 전송되고 변환되고 있는지 확인합니다. 데이터 무결성을 보장하기 위해 불일치 또는 문제를 즉시 해결합니다.
## 원치 않는 덮어쓰기 처리
+ AWS 데이터가 특정 CRM 필드를 덮어쓰지 않도록 하려면 다음을 고려하세요.
+ 보호하려는 데이터에 대한 사용자 지정 CRM 필드를 생성합니다.
+ 영업 담당자가이 사용자 지정 필드를 검토하도록 합니다.
+ 사용자 지정 필드가 승인되면 기회 레코드 및 파이프라인에 추가합니다.
+ 이는 `MRR` 또는 `Stage`와 같은 필드에 특히 중요합니다. 특히 제품이 출시되었음을 나타내는 경우 더욱 그렇습니다.
## 다운스트림 종속성 관리
+ 시스템에 데이터 교환에 의존하는 다운스트림 종속성이 있는 경우 다음을 고려하세요.
+ AWS 데이터를 수용하기 위해 CRM에 새 필드를 생성합니다.
+ 필요에 따라 비즈니스 프로세스를 재정렬하여 원활한 통합 및 데이터 흐름을 보장합니다.
# 동기화 일정 생성
**참고**
이 섹션의 주제에서는 AWS Partner Central 통합, AWS Marketplace 통합 또는 둘 다에 대한 사전 조건을 완료했다고 가정합니다. 자세한 내용은이 가이드 [시작하기](crm-integration-getting-started.md) 앞부분의 [통합 사전 조건](crm-integration-setting-up.md) 및 섹션을 참조하세요.
Salesforce와 AWS Partner Central 간에 인바운드 및 아웃바운드 동기화 일정을 생성할 수 있습니다. 다음 섹션의 단계에서는 방법을 설명합니다.
**Topics**
+ [사전 조건](#scheduling-prerequisites)
+ [예약 생성](#creating-a-schedule)
+ [예약된 작업 비활성화](#deactivating-a-scheduled-job)
+ [모든 일정 보기](#viewing-all-schedules)
## 사전 조건
동기화 일정을 생성하기 전에 다음을 완료해야 합니다.
+ 하나 이상의 객체, 기회 또는 리드에 모든 필수 필드를 [매핑](crm-connector-mapping.md)합니다.
+ Salesforce에서 [시스템 통합 사용자를](#system-integration-user) 생성합니다.
### 시스템 통합 사용자 생성
동기화 일정을 생성하려면 먼저 Salesforce를 사용하여 APN 통합 권한이 있는 시스템 통합 사용자를 생성해야 합니다. 동기화 일정을 생성하려면 시스템 통합 사용자로 Salesforce에 로그인해야 합니다. APN 통합 사용자 권한 없이 일정을 생성하면 APN 통합이 중단될 수 있습니다.
**시스템 통합 사용자를 생성하려면**
1. Salesforce 조직에 시스템 관리자로 로그인합니다.
1. Salesforce 조직에서 사용자를 생성합니다. Salesforce 조직의 필수 객체에 액세스할 수 있는 사용자에게 프로필을 할당합니다. 자세한 내용은 [단일 사용자 추가를](https://help.salesforce.com/s/articleView?id=sf.adding_new_users.htm) 참조하세요.
1. 사용자에게 **APN 통합 사용자** 권한 세트를 할당합니다. 자세한 내용은 [사용자에게 권한 세트 할당을 참조하세요](https://help.salesforce.com/s/articleView?id=sf.assign_permission_set_to_user.htm).
## 예약 생성
[사전 조건을](#scheduling-prerequisites) 완료한 후 Salesforce와 APN 간에 동기화 일정을 생성할 수 있습니다.
**APN을 사용하여 동기화 일정을 생성하려면**
1. 시스템 통합 사용자 권한이 있는 사용자로 Salesforce에 로그인합니다.
1. **일정** 탭에서 **새로** 만들기를 선택합니다.
1. 예약할 객체를 선택합니다. 리드 및 기회 또는 단일 객체에 대한 일정을 설정할 수 있습니다.
1. 최소 5분에서 최대 1일 1회까지 일정 빈도를 선택합니다.
1. **일정**을 선택합니다.
**참고**
객체당 하나의 일정만 한 번에 활성화할 수 있습니다. 동일한 객체에 대해 새 일정을 생성하면 기존 일정이 비활성화됩니다.
일정을 생성할 때 인바운드 통합을 비활성화하려면 **인바운드 통합 비활성화, 일정을** 선택합니다.
APN 통합 사용자 권한 없이 일정을 생성하면 APN 통합이 중단될 수 있습니다.
## 예약된 작업 비활성화
1. **일정** 페이지에서 **모든 작업 비활성화를** 선택하여 활성 일정을 끕니다.
1. 확인 화면을 진행하여 동기화 일정을 비활성화합니다.
## 모든 일정 보기
**일정** 탭에서 목록 보기 필터를 사용하여 **활성**, **비활성** 및 **모든 동기화** 일정을 전환합니다.
# 모범 사례
이러한 모범 사례를 사용하여 사용자 지정 통합 개발 및 유지 관리를 최적화합니다.
## 일반 모범 사례
1. *(*APN) Customer Engagement AWS Partner Network (ACE) 제출 양식의 필수 필드이므로 모든 필수 필드를 매핑합니다.
1. 현재 ACE Pipeline Manager 사용자와 연결하여 프로세스가 어떻게 보이는지 이해합니다. 고유한 프로세스/필드 사용을 캡처하여 환경에 구축할 수 있습니다.
1. Amazon Web Services(AWS)에서 보고하는 판매 단계(예: 단계, 목표 종료일, 예상 월별 AWS 수익, 다음 단계)에 대해 별도의 판매 파이프라인 단계를 생성하는 것이 좋습니다. 단계 정의가 다른 경우 판매 단계를 재정의할 수 있습니다. 별도의 판매 단계를 생성하면 파이프라인을 적절하게 관리할 수 있지만 AWS 예상되는 내용을 계속 파악할 수 있습니다.
1. 파트너 추천 기회의 경우 ACE 팀은 업데이트를 수락하기 전에 승인/거부해야 합니다.
1. AWS 추천된 기회의 경우 파트너는 기회를 수락하거나 거부해야 합니다.
## 데이터 교환 프로토콜
1. **입력 규칙**: 세미콜론과 생략 공백으로 다중 선택 선택 선택 목록 항목을 구분합니다.
1. **세부 정보 주의 사항**: 필드 이름과 값은 대/소문자를 구분하므로 정확도를 유지합니다.
1. **삭제 절차**: 선택한 필드의 값을 전송하여 필드 제거`null`를 실행합니다.
1. **동기화**: 동기화 프로세스는 시간별로 작동하므로 데이터 반영이 지연될 수 있습니다. 에 대한 업데이트는 고객 관계 관리(CRM)에 반영되는 데 최대 1시간이 AWS 걸릴 AWS 수 있습니다. 시간당 여러 문서를 보내지 마세요.
## 필드별 모범 사례
1. **인바운드 수정**: 데이터의 무결성을 보호하려면 , `closedDate`및와 같은 필드에 대한 수정`stage`을 비활성화합니다`closedLostReason`. 로컬 Salesforce AWS 값에 영향을 주지 않고 값을 추적하려면 , `awsStage` `awsCloseDate`및 읽기 전용 필드를 사용합니다`awsClosedLostReason`.
1. **고객 매핑 및 검증**: AWS CRM 매핑의 핵심이므로 고객 웹 사이트 정확도를 보장합니다. 우수한 CRM 계정 매핑을 위해 고객 이름과 페어링합니다.
1. **프로젝트 설명 명확성**: 고객 과제 및 솔루션 정렬을 자세히 설명하는 명확한 설명을 제공합니다. 이를 AWS 사용하여 기회를 검증합니다.
1. **프로비저닝**: (선택 사항) 최종 고객 고객 응대 세부 정보를 프로비저닝하면가 리드 및 캠페인을 재추적 AWS 할 수 있습니다. 이로 인해 자금 결정이 향상됩니다.
## 추가 모범 사례
1. 최신 페이로드 필드 정의 지침을 준수합니다.
1. 샌드박스 버킷 이름 지정 일관성을 지정된 형식으로 유지합니다.
1. 프로덕션 버킷에 권장되는 이름 지정 패턴을 사용합니다.
1. 라이브 배포 전에 샌드박스 환경 테스트의 우선순위를 지정합니다.
1. AWS 및 파트너 CRMs 간의 레코드에 대한 고유 식별자를 유지 관리합니다.
1. 후처리, 아웃바운드 Amazon Simple Storage Service(Amazon S3) 폴더에서 파일을 삭제합니다. 원본은 아카이브에 남아 있습니다.
1. 오류를 방지하려면 소스에서 필드 수준 검증을 설정합니다.
# 할당량
## Amazon Web Services에 대한 인바운드 파일(AWS)
| Operation | Limit |
| --- | --- |
| 최대 기회 | 파일당 500개 |
| 최대 파일 크기 | 1MB |
| 동기화 빈도 | 거의 실시간 |
| 제출된 파일의 최대 수 | 24시간당 10,000 |
## 파트너에 대한 아웃바운드 파일
| Operation | Limit |
| --- | --- |
| 최대 파일 크기 | 5MB |
| 동기화 빈도 | 시간당 |
# 버전 기록
현재 필드 버전: 14(2023년 11월 15일)
다음 표에서는 2020년 이후 리드 및 기회에 대한 사용자 지정 통합 필드의 중요한 변경 사항을 설명합니다. 향후 업데이트에 대한 알림을 받으려면 RSS 피드를 구독하세요.
| 변경 사항 | 버전 | 날짜 |
| --- | --- | --- |
| Amazon S3 할당량 업데이트 | 14 | 1/17/2024 |
| **통합 기회 필드에 대한 변경 사항:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/partner-central/latest/crm/version-history.html) | 14 | 11/15/2023 |
| **통합 기회 필드에 대한 변경 사항:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/partner-central/latest/crm/version-history.html) | 13 | 03/29/2023 |
| **통합 기회 필드에 대한 변경 사항:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/partner-central/latest/crm/version-history.html) **기회에 대한 표준 값 변경:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/partner-central/latest/crm/version-history.html) | 12 | 09/01/2022 |
| **통합 기회 필드에 대한 변경 사항:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/partner-central/latest/crm/version-history.html) **기회 필드의 표준 값에 대한 변경 사항:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/partner-central/latest/crm/version-history.html) | 11 | 03/21/2022 |
| **통합 기회 필드에 대한 변경 사항:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/partner-central/latest/crm/version-history.html) **기회에 대한 표준 값 변경:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/partner-central/latest/crm/version-history.html) | 10 | 01/26/2022 |
| **리드 필드의 표준 값 변경:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/partner-central/latest/crm/version-history.html) **통합 리드 필드의 변경 사항:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/partner-central/latest/crm/version-history.html) **통합 기회 필드에 대한 변경 사항:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/partner-central/latest/crm/version-history.html) | 9 | 9/16/2021 |
| 종결된 손실 사유 코드 업데이트 | 8 | 6/24/2021 |
# FAQ
이러한 일반적인 질문과 답변을 사용하여 사용자 지정 통합을 지원합니다.
**Topics**
+ [일반 FAQ](general-faq.md)
+ [기술 FAQ - 필드](technical-faq-fields.md)
+ [기술 FAQ - Amazon S3](technical-faq-s3.md)
+ [기술 FAQ - 리드 및 기회](technical-faq-leads-and-opps.md)
+ [기술 FAQ - 버전 관리 및 이전 버전과의 호환성](technical-faq-versioning.md)
# 일반 FAQ
## 통합은 어떻게 작동하나요?
**Q: 파일을 보내고 받는 데 사용되는 Amazon Simple Storage Service(Amazon S3) 버킷에 액세스할 수 있습니까?**
예. 파트너는 버킷에 액세스할 수 있는 AWS Identity and Access Management (IAM)의 보안 암호/액세스 키를 사용하여 프로그래밍 방식으로 Amazon S3 버킷에 액세스할 수 있습니다. 파트너는 Amazon S3 버킷에 대한 콘솔 액세스 권한이 없습니다. 이러한 버킷은 Amazon Web Services(AWS)의 자체 계정에 있기 때문입니다.
**Q: 파트너의 개발자가 필요로 하는 스킬 세트는 무엇입니까?**
파트너의 개발자는 고객 관계 관리(CRM) 시스템과 Amazon S3에 익숙해야 합니다.
**Q: 샘플 코드 파일에 전체 코드가 포함되어 있습니까? 아니면 파트너가 코드를 작성해야 합니까?**
파트너는 제공된 샘플 코드 파일을 기반으로 코드를 작성해야 합니다.
**Q: 파트너가 Python, Golang 또는 기타 언어로 솔루션을 개발하는 경우 ( AWS Partner Network APN) Customer Engagement(ACE)는이 통합을 위해 해당 언어로 소프트웨어 개발 키트(SDK)를 제공합니까?**
아니요.
**Q: Amazon S3 버킷에서 내부 ACE로의 동기화 프로세스는 무엇입니까?**
매시간 배치 프로세스가 실행되어 파일을 선택하고 정보를 동기화합니다. AWS 영업 팀이 레코드를 업데이트하면 파트너의 버킷으로 전송하는 데 최대 1시간이 걸릴 수 있습니다. 파트너는 업데이트에 대한 이메일 알림을 즉시 받을 수 있지만의 업데이트는 여전히 1시간 지연될 AWS 수 있습니다.
**Q: ACE에서 리드 및 기회 파일을 업로드하는 빈도는 어떻게 됩니까?**
ACE는 1시간마다 리드 및 기회 데이터를 전송합니다.
**Q: ACE용 샌드박스 환경이 있나요?**
예. ACE용 샌드박스 환경이 있지만 보안상의 이유로 파트너에게 액세스를 제공할 수 없습니다. 버킷에 새로운 기회나 리드를 푸시하려면 Partner Central에서 지원 사례를 제기하세요.
**Q: 파트너의 CRM 및 APN에서 식별자를 유지 관리하려면 어떻게 해야 하나요?**
파트너에게 더 많은 유연성을 제공하기 위해 시스템에서 두 가지 식별자 세트를 사용합니다.
1. `apnCrmUniqueIdentifier`:이 식별자를 AWS 관리합니다. 기회의 `OXXXXXX` 경우 , 리드`LXXXXXX`의 경우 로 시작합니다.
1. `PartnerCrmUniqueIdentifier`/`partnerCrmLeadId`: 파트너는 CRM 내에서 각각 기회와 리드에 대해이 식별자를 관리합니다. 파트너는 업데이트를 CRM으로 다시 추적할 수 있는 새로운 기회를 수집하는 동안이 식별자를 추가해야 합니다.
`apnCrmUniqueIdentifier` 또는 없이 기회가 전송되면는 이를 새 기회로 `partnerCrmUniqueIdentifier` AWS 처리하고 기회에 `apnCrmUniqueIdentifier` 새를 할당합니다.
`apnCrmUniqueIdentifier` 또는와 함께 기회가 전송되면는 이를 업데이트 작업으로 `partnerCrmUniqueIdentifier` AWS 처리하고 기존 기회를 페이로드 데이터로 업데이트합니다.
**Q: 두 시스템 모두에서 중복 레코드가 생성되지 않도록 하려면 어떻게 해야 하나요?**
파트너 CRM 측에는 ACE로 전송되는 각 레코드에 대한 고유 식별자가 있어야 합니다. 이를 라고 합니다`partnerCrmUniqueIdentifier`. 마찬가지로 ACE는 라고 하는 각 레코드에 대한 고유 식별자도 유지합니다`apnCrmUniqueIdentifier`. 데이터가 전송되면 ACE와 파트너 모두 이러한 두 필드를 포함해야 합니다. 이렇게 하면 레코드가 새 기회(비어 있는 경우)인지 기존 기회( 채워진 경우)인지 식별하는 데 도움이 됩니다.
# 기술 FAQ - 필드
**Q: 통합이 CSV 형식을 지원하나요?**
아니요. 통합은 JSON 파일 형식만 허용합니다.
**Q: 아웃바운드 폴더에서 파일을 삭제해야 하는 경우는 언제인가요?**
파일을 성공적으로 처리한 후에만 삭제합니다.
**Q: 실수로 아웃바운드 폴더에서 파일을 삭제한 경우 원본 파일을 어디에서 찾을 수 있습니까?**
파일은 `opportunity-outbound-archive` 및 `lead-outbound-archive` 폴더에서 사용할 수 있습니다.
**Q: 개발 중에 지원을 받으려면 어떻게 해야 하나요?**
개발 중에 도움이 필요하면 Partner Central의 AWS Partner Network (APN) 지원팀에 문의하십시오.
**Q: `opportunityOwnerName`와의 차이점은 무엇인가요`opportunityOwnerEmail`?**
+ `opportunityOwnerName`: 파트너 조직의 기회 소유자 이름입니다. 이는 Partner Central 사용자여야 합니다.
+ `opportunityOwnerEmail`: 파트너 조직에 있는 기회 소유자의 이메일입니다. 이는 Partner Central 사용자여야 합니다. 제공되지 않으면 Partner Central Alliance 책임자를 소유자로 하여 기회가 생성됩니다.
**Q: 모든 날짜 필드(`targetCloseDate`, `lastModifiedDate`, `createdDate`및 `acceptBy`)의 시간대는 어떻게 됩니까?**
날짜 필드의 시간대는 그리니치 표준시(GMT)입니다.
**Q: 인바운드 JSON 파일의 버전이 지정되나요?**
아니요. Amazon Web Services(AWS)는 파일 버전 관리를 지원하지 않습니다. APN Customer Engagement(ACE)는 수신 직후 파일을 처리한 다음 성공적으로 처리한 후 파일을 삭제합니다. 동일한 파일 이름을 다시 받으면 거부됩니다.
**Q: Amazon Simple Storage Service(Amazon S3) JSON 파일의 어떤 필드가 특정 리드 및 기회의 생성 및 최신 업데이트 날짜를 표시하나요?**
`createdDate` 및 `lastModifiedDate`.
**Q: 기회가 신규인지 기존인지 어떻게 확인하나요?**
필드는 파트너에게 필요한 각 기회의 고유 식별자`PartnerCrmUniqueIdentifier`입니다. 이 식별자는 파트너 시스템의 소스 CRM에 정의되어야 합니다. 이를 사용하여 기회가 존재하는지 확인합니다 AWS. 존재하는 경우 공유 정보로 기회를 업데이트합니다. 그렇지 않으면 새 기회가 생성됩니다.
파트너에게 데이터를 보내면 `PartnerCrmUniqueIdentifier` 및가 모두 포함됩니다`apnCrmUniqueIdentifier`. 에서 공유하는 기회가 처음으로 AWS 전송되는 경우에 대한 값이 표시되지 않습니다`PartnerCrmUniqueIdentifier`. 이렇게 하면 기회를 ACE의 새로운 기회로 취급할 수 있습니다. CRM에 수집하면 `PartnerCrmUniqueIdentifier` 및를 모두 사용하여 업데이트를 다시 보냅니다`apnCrmUniqueIdentifier`.
**Q: Amazon S3에 아웃바운드 및 결과 JSON 파일이 두 개 이상 있을 수 있나요?**
예. 아웃바운드 폴더에 더 많은 파일을 생성할 수도 있습니다. 마찬가지로 인바운드 폴더로 파일을 보내는 경우 해당 파일을 처리하고 결과 파일을 결과 폴더에 보관합니다. 처리 후 결과 파일에 태그를 지정하거나 삭제해야 합니다.
**Q: 아웃바운드 파일에 레코드가 두 개 이상 포함되어 있습니까?**
예. 아웃바운드 파일에는 여러 레코드가 포함될 수 있습니다.
**Q: 기회 섹션 아래의 단일 입력 JSON 파일로 20개의 인바운드 기회가 전송되고 기회 중 하나가 APN 표준을 준수하지 않는 경우 어떻게 되나요?**
형식이 잘못된 경우 사례에 관계없이 전체 파일이 거부됩니다. 형식이 올바르지만 하나의 기회만 처리할 수 없는 경우 결과 파일에는 실패한 기회에 대한 오류 메시지와 함께 20개의 기회와 상태가 모두 포함됩니다.
**Q: JSON 파일이 성공적으로 처리되었는지 확인할 키 속성은 무엇입니까?**
다음은 JSON 파일이 성공적으로 처리되었는지 이해하는 데 도움이 되는 주요 속성입니다.
```
{
"inboundApiResults": [
{
"warnings": null, // no warnings
"partnerCrmUniqueIdentifier": "XXXX", //uniqueId from Partner side
"isSuccess": true, // file successfully processed
"errors": null, //no errors reported
"apnCrmUniqueIdentifier": "OXXXX" //uniqueId from AWS side
}
]
}
```
**Q: 잘못된 JSON을 보내면 어떻게 되나요?**
"`[{input JSON}]`는 유형이 아닙니다"라는 오류 응답이 수신됩니다`object`.
**Q: 단일 인바운드 JSON 파일에 포함할 수 있는 리드/기회 레코드 수는 몇 개입니까?**
하나의 파일에는 최대 50개의 레코드가 있을 수 있습니다.
# 기술 FAQ - Amazon S3
**Q: Amazon Simple Storage Service(Amazon S3) REST API 설명서는 어디에서 얻을 수 있나요?**
자세한 내용은 [Amazon S3 REST API 소개](https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html)를 참조하세요.
**Q: Amazon S3 버킷에 액세스하기 위해 인증할 Amazon Web Services AWS Key Management Service (AWS KMS) 키 세부 정보는 어떻게 얻나요?**
AWS Partner Network (APN)는 키 이름을 포함하는 정책을 공유합니다.
**Q: Salesforce.com(SFDC)에서 Amazon S3를 인증하려면 어떻게 해야 하나요?**
샘플 코드 파일 [S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)를 사용하여 SFDC에서 Amazon S3를 인증합니다.
**Q: 소프트웨어 개발 키트(SDK)에서 AWS S3로 파일을 업로드하려면 어떻게 해야 합니까?**
다음 AWS CLI 명령을 사용하여 파일을 S3에 업로드합니다.
```
aws s3 cp example.json s3://awsexamplebucket/opportunity- inbound/filename.json --acl bucket-owner-full-control
```
샘플 코드 파일 [Sample\$1AceOutboundBatch.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)에는 SFDC에서 데이터 파일을 업로드하는 코드가 포함되어 있습니다.
**Q: Amazon S3 버킷을 소유한 사람은 누구입니까?**
AWS 는 Amazon S3 버킷을 소유하고 관리합니다. AWS Identity and Access Management (IAM) 사용자를 통해 자체 Amazon S3 버킷에 프로그래밍 방식으로 액세스할 수 있습니다.
**Q: 파일을 수신하고 전송하기 위한 별도의 폴더 또는 버킷이 있습니까?**
파일을 수신하고 전송하기 위한 폴더가 서로 다른 버킷이 하나 있습니다. 폴더에 대한 자세한 내용은 사용 설명서를 참조하세요.
**Q:를 사용하여 Amazon S3 버킷에 액세스해야 합니까 AWS Lambda? 아니면 고객 관계 관리(CRM) 시스템을 사용하여 직접 액세스할 수 있습니까?**
두 가지 방법으로 액세스할 수 있습니다.
**Q: Amazon S3 버킷이 보안 또는 암호화되어 있습니까?**
예. Amazon S3에서 제공하는 기본 암호화 메커니즘을 활성화합니다.
**Q: 주기적으로 폴링하는 대신 이벤트에 대해서만 조치를 취할 수 있도록 Amazon Simple Notification Service(Amazon SNS)가 Amazon S3 버킷을 수신하도록 할 수 있나요?**
아니요. 현재 APN Customer Engagement(ACE)는이 기능을 지원하지 않습니다.
**Q: 어떤 폴더에 액세스할 수 있으며 각 폴더의 용도는 무엇입니까?**
에서 Amazon S3 폴더 목록을 찾을 수 있습니다[통합 사전 조건](crm-integration-setting-up.md).
# 기술 FAQ - 리드 및 기회
## 리드 및 기회 전송 및 수신
**Q: 파일 이름 지정 규칙이 있나요?**
각 파일 이름은 고유해야 합니다. 파일 이름를 사용하는 것이 좋습니다`PartnerProvided FileName+{timestamp}.json`.
**Q: 결과의 구조는 무엇입니까?**
결과(성공 및 오류)에 대한 샘플 파일은 다음 위치에서 다운로드할 수 있습니다.
+ [리드 결과 성공 Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)
+ [기회 결과 성공 Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
+ [오류가 있는 리드 결과 Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results_With-Errors-Sample.json)
+ [오류가 있는 기회 결과 Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results_With-Errors-Sample.json)
**Q: 결과의 명명 규칙은 무엇인가요?**
`PartnerProvidedFileName_result.json`
**Q: 동일한 이름의 두 번째 JSON 파일을 제출하면 어떻게 되나요?**
파일을 처리하지 않으며 파일이 아카이브 폴더로 이동합니다.
**Q: 인바운드 파일 크기 제한은 얼마입니까?**
인바운드 파일 크기 제한은 1MB입니다.
**Q: 하나의 JSON 파일로 일괄 처리할 수 있는 최대 기회 및 리드 수가 있습니까?**
1MB 제한을 고려할 때 파일당 기회 또는 리드가 하나씩 있는 것이 좋습니다.
**Q: 액세스 거부 오류 메시지가 표시되므로 파일을 업로드할 수 없습니다. 어떻게 해야 합니까?**
파트너는 두 가지 이유로 *액세스 거부* 메시지를 받습니다.
1. `inbound` 폴더 대신 `outbound` 폴더에 파일을 업로드했습니다. 파일을 `inbound` 폴더에 업로드합니다.
1. 액세스 제어 목록(ACL)을 제공해야 합니다. 다음 Amazon Web Services(AWS) CLI 명령을 사용하여 데이터 파일을 업로드합니다.
```
aws s3 cp example.json s3://awsexamplebucket --acl bucket-owner-full-control
```
**Q: `.pdf`, `.docx`또는 이외의 확장자가 있는 파일이 `.json` 업로드되면 어떻게 되나요?**
파일을 거부하고 사유 세부 정보가 포함된 `*.error.json` 파일을 생성합니다.
**Q: 프로덕션 환경에서 데이터 문제 오류 메시지를 받은 후 어떻게 해야 하나요?**
1. 파트너의 고객 관계 관리(CRM) 시스템에서 데이터를 수정해야 하는 경우 데이터를 수정한 후 수정된 파일을 Amazon Simple Storage Service(Amazon S3)로 전송합니다.
1. 데이터에 대한 설명이 필요한 경우 파트너 개발 관리자(PDM)에게 문의하십시오.
1. 다른 기술 지원을 받으려면 APN 포털에서 AWS Partner Network (APN) 지원 사례를 제기하십시오.
**Q: 결과 파일은 어디에서 찾을 수 있으며 얼마나 오래 사용할 수 있나요?**
결과 파일은 `lead-inbound-results` 및 `opportunity-inbound-results` 폴더에 있습니다. 삭제할 때까지 사용할 수 있습니다. 가져오기에 성공한 후 파일을 삭제할 수 있습니다.
**Q: 결과 파일을 삭제한 후 찾아야 하는 경우 어디에서 찾을 수 있습니까?**
결과 파일은 `lead-inbound-results-archive/YYYY/MM/DD` 및 `opportunity-inbound-results-archive/YYYY/MM/DD` 폴더에서 찾을 수 있습니다.
**Q: 파일을 처리하는 APN에 장애가 있는 경우 어떻게 알림을 받나요?**
APN에는 처리 오류를 추적하기 위해 Sev2 티켓을 자동으로 생성하는 경보가 있습니다. 이를 검토하고 해결하여 파트너에게 전달합니다.
**Q: 기회가 시작된 후 업데이트할 수 있는 필드는 무엇입니까?**
다음 필드는 독립 소프트웨어 공급업체(ISV) Accelerate 파트너만 업데이트할 수 있습니다.
+ `isThisForMarketplace`
+ `isNetNewBusinessForCompany`
+ `deliveryModel`
+ `awsFieldEngagement`
+ `additionalComments`
**Q: *편집할 수 없는 레코드* 오류가 발생했습니다. 이는 무엇을 의미하나요?**
새 파트너 추천 기회를 보내면 검증 프로세스를 거치고 APN 고객 참여(ACE) 팀이 이를 승인하거나 거부해야 합니다. 기회가 검토 중이고 아직 검증되지 않은 동안에는 레코드를 업데이트할 수 없으며이 오류가 발생합니다.
**Q: 내 측에 활동이 없으면 어떻게 되나요(예: 파일을 처리하지 않거나 인바운드 기회를 보내지 않음)?**
정보를 보내지 않거나 제공하는 파일을 처리하지 않는 경우 현재 사용자에게 알리는 메커니즘이 마련되어 있지 않습니다. 시스템을 모니터링하여 정보가 APN으로 전달되고 있는지 확인하는 것이 좋습니다.
**Q: 신규/업데이트된 인바운드 기회/리드를 제출한 후 결과 폴더에서 JSON 결과를 얼마나 빨리 사용할 수 있나요?**
처리는 거의 실시간으로 이루어집니다. 5분 이내에 파일을 수신해야 합니다.
**Q: APN 표준의 형식/길이 제한을 준수하지 않는 인바운드 기회 CRM을 보내는 경우 시스템에서 이를 어떻게 처리하나요? 오류 보고서를 생성하나요?**
파일이 필드 정의 형식이 아닌 경우 APN의 결과 파일은 파일을 호출합니다.
**Q: 시작 시 AWS 계정 ID가 없습니다. 어떻게 해야 하나요?**
ACE 프로세스에 따라는 워크로드가 완료되고 청구가 시작되었음을 `Launched` 의미합니다. 이를 위해서는 AWS 계정 ID가 필요합니다. 자세한 내용은 [ACE 프로그램 FAQs](https://partnercentral.awspartner.com/partnercentral2/s/resources?Id=0690h000003xjjXAAQ).
**Q: UAT(User Acceptance Testing)에 따라 프로덕션으로 전환하는 동안 기록 데이터를 어떻게 처리해야 합니까?**
기본적으로 ACE에서 업데이트가 발생하면 해당 기회를 Amazon S3 버킷으로 보냅니다. 처리하지 않으려는 기록 데이터의 경우 시스템에서 처리하지 않으려는 항목에 대한 추출`X0001, X0002….X000N`과 같은 `partnerCrmUniqueIdentifier` 더미 값을에 제공해야 합니다. 이러한 식별자를 인식하고 그에 따라 처리하는 코드를 작성해야 합니다. 나머지 기회는 올바른 `partnerCrmUniqueIdentifier` 값을 제공합니다. 이렇게 하면 시스템에서 처리할 항목과 처리하지 않을 항목을 완벽하게 제어할 수 있습니다.
**Q: 아웃바운드 파일에 레코드가 두 개 이상 포함되어 있습니까?**
예. 아웃바운드 파일에는 둘 이상의 레코드가 포함될 수 있습니다.
**Q: 일부 필드를 *보려면 데이터가 수락을* 보내는 이유는 무엇입니까?**
AWS 참조된 기회 또는 리드의 경우 모든 PII 필드는 기회 또는 리드가 수락될 때까지 *보기 수락* 레이블로 마스킹됩니다. 수락되면 다음 동기화 주기에서 모든 데이터 필드를 수신합니다.
**Q: 새로운 AWS 추천 기회 또는 리드가 처음 동기화되면 어떻게 해야 하나요?**
새 기회 또는 리드가 처음 동기화되면 추가 데이터(예: 고객 연락처)를 가져오려면 이를 수락하거나 거부해야 합니다.
## 기회/리드 생성 및 업데이트
**Q: 통합을 통해 ACE에 새로운 *파트너 추천(원본)* 기회를 수집하려면 어떻게 해야 하나요?**
통합을 통해 ACE에서 새 기회를 생성하려면 정의된 JSON 형식의 필수 기회 정보를 `opportunity-inbound` 폴더에 수집해야 합니다.는이 정보를 AWS 처리하고, ACE에서 새 기회를 생성하고, `opportunity-inbound-processed-results` 폴더에서 성공/실패한 생성 작업의 결과를 공유합니다.
**Q: 통합은 새로운 기회 제출과 업데이트를 어떻게 구분하나요?**
각 기회`PartnerCrmUniqueIdentifier`의 필드는 필수 고유 식별자입니다. 이 식별자는 시스템 소스 CRM에 정의되어야 합니다. AWS 는 이를 사용하여 ACE에 기회가 이미 존재하는지 확인합니다. ACE에서 사용할 수 있는 경우 공유된 정보를 사용하여 기회를 업데이트하지만 ACE에서 사용할 수 없는 경우 공유된 정보를 사용하여 새 기회를 생성합니다.
**Q: 통합을 통해 업데이트 기능을 이미 구현한 경우 통합을 사용하여 새 기회를 제출(생성)하려면 어떻게 해야 하나요?**
기존 통합을 다음과 같이 변경해야 합니다.
1. `opportunity-inbound` 폴더에 새로운 생성 기회를 수집하기 시작합니다. 동일한 폴더에 업데이트를 제공합니다.
1. 생성하는 데 필요한 필수 필드를 공유된 기회 JSON에서 사용할 수 있는지 확인합니다.
1. 각 새 기회에 ACE/Partner Central에 존재하지 `PartnerCrmUniqueIdentifier` 않는 고유한가 있는지 확인합니다. 중요한 가동 모범 사례는 업데이트를 받을 때 중복을 생성하지 않도록 ACE의 기존 데이터를 CRM`PartnerCrmUniqueIdentifier`의 각에 매핑하고 업데이트하는 것입니다. 도움이 필요하면 ACE에 문의하십시오.
**Q: 가동 프로세스의 일환으로를 사용하여 ACE의 기존 기회를 업데이트하려면 어떻게 해야 하나요`PartnerCrmUniqueIdentifier`?**
ACE 팀은 프로덕션 출시를 준비하는 데 도움이 되는 모든 열린 기회 목록을 제공합니다. ACE의 이러한 기존 기회를 해당에 매핑`PartnerCrmUniqueIdentifier`하고 업데이트된 파일을 ACE에 반환하여 AWS CRM에 통합해야 합니다.
에서 제공하는 기회 AWS 의 하위 집합만 동기화하도록 선택한 경우 처리하지 않으려는 모든 기회에 대한 AWS 업데이트를 우회하는 로직을 개발해야 합니다. 이 접근 방식은 온보딩 후 향후 기회에도 적용해야 합니다. 두 CRMs 간에 조정이 필요한 기회에 `partnerCrmUniqueIdentifier` 연결된를 제공해야 합니다. 또한 업데이트에서 제외할 수 있도록 업데이트하지 않을 기회(예: 닫힌 손실 또는 닫힌 기회 표시)를 표시해야 합니다. 를 AWS 공유하고 수락하는 모든 공개/활성 기회에를 할당하는 것이 중요합니다`partnerCrmUniqueIdentifier`.
**Q: 기회 또는 리드의 특정 필드만 업데이트할 수 있나요?**
예. 필요한 식별자와 함께 업데이트가 필요한 필드만 제공할 수 있습니다.
**Q: *ApnCrmUniqueIdentifier*를 변경할 수 있나요**?
아니요.이 식별자는에 대해 일정하게 유지 AWS 되며 각 기회를 고유하게 식별합니다.
**Q: 잘못된 *partnerCrmUniqueIdentifier*를 제공하면 어떻게 되나요**?
잘못된 식별자를 제공하면 새 기회가 생성됩니다. 데이터 중복을 방지하기 위해 정확성을 보장합니다.
**Q: AWS 제출된 기회를 업데이트할 수 있나요?**
예. 올바른를 사용하여 제출된 기회를 AWS 업데이트할 수 있습니다`partnerCrmUniqueIdentifier`.
**Q: 제출된 기회에 대한 결과는 얼마나 빨리 예상할 수 있습니까?**
처리는 거의 실시간으로 이루어지며 결과는 일반적으로 `opportunity-inbound-processed-results` 폴더에서 몇 분 이내에 사용할 수 있습니다.
**Q: 제출된 기회에 대한 처리 오류가 있는 경우 어떻게 해야 합니까?**
결과 파일의 오류 세부 정보를 검토하고, 문제를 해결하고, ACE 지원 팀에 추가 지원을 요청하세요.
**Q: 통합을 통해 기회를 삭제할 수 있나요?**
아니요. 직접 삭제는 지원되지 않습니다. *종료*됨 상태를 반영하도록 기회를 업데이트할 수 있습니다.
**Q: *레코드를 편집할 수 없음* 오류는 무엇을 의미하나요?**
이 오류는 ACE 검토에서 기회를 업데이트하려고 할 때 발생합니다. 이러한 기회는 검증될 때까지 편집할 수 없습니다.
**Q:가 업데이트나 새로운 기회를 보내지 않으면 어떻게 되나요?**
통합을 통해 업데이트나 새로운 기회를 보내지 않으면 새 데이터가 수신되고 처리되지 않습니다.
**Q: 결과 파일을 사용할 수 있는 기간은 얼마나 됩니까?**
결과 파일은 적절한 기간 동안 사용할 수 있습니다. 즉시 검색하고 관리해야 합니다.
# 기술 FAQ - 버전 관리 및 이전 버전과의 호환성
**Q: Amazon Web Services(AWS) 데이터 교환의 페이로드란 무엇입니까?**
페이로드는 JSON 형식의 정형 데이터로, 로 인바운드 AWS 또는에서 아웃바운드로 전송됩니다 AWS. 이 JSON 구조의 각 키를 *필드*라고 하며 각 필드에는 연결된 *값이 있습니다.*
**Q: 페이로드 버전은 어떻게 결정되나요?**
페이로드 버전은 페이로드 자체의 `version` 필드 내에 지정됩니다. 필드 정의 v13을 준수하는 페이로드는 페이로드 버전 1.0으로 간주되는 반면, 필드 정의 v14 이상에 정의된 형식을 따르는 페이로드 버전 2.0이라고 합니다.
**Q:이 컨텍스트에서 이전 버전과의 호환성은 무엇을 의미하고 어떻게 처리되나요?**
이전 버전과의 호환성을 통해 새 페이로드 버전에 새 필드와 필수 필드가 도입될 때 기존 기회가 실패하지 않도록 합니다.는 새 버전에 필요한 필드에 기본값을 자동으로 할당하여 이를 AWS 유지합니다. Customer Relationship Management(CRM) 통합을 통해 명시적으로 제공하지 않은 AWS Partner Network (APN) Customer Engagement(ACE) UI의 값을 확인할 수 있습니다. 각 필드의 세부 정보 및 조건은 필드 설명 또는 필드에 대한 추가 세부 정보에 설명되어 있습니다.
**Q: 이전 버전과의 호환성이 영구적인 기능인가요?**
아니요. 이전 버전과의 호환성은 시간 제한이 있으며 향후 변경 사항을 계획하고 구현할 수 있는 유연성을 제공하도록 설계되었습니다. 지정된 마감 날짜 이후의 작업은 중지되며, 이는 더 광범위한 출시의 일환으로 올해 후반에 발표될 예정입니다.
**Q: 버전 2.0으로 페이로드 전송을 시작하면 어떻게 되나요?**
버전 2.0으로 페이로드를 전송하면 시스템은 필요한 모든 변경 사항이 구현되었다고 가정하고 새 페이로드 버전에 대한 검증이 이후의 모든 변경 사항에 적용됩니다. 버전 1.0과 버전 2.0 페이로드 사이에 부분적으로 기능을 구현하지 않는 것이 중요합니다.
**Q: 버전 2.0으로 업데이트한 후 페이로드 버전 1.0으로 되돌릴 수 있나요?**
아니요. 페이로드 버전 2.0으로 전환하는 것은 단방향 프로세스입니다. 버전 2.0으로 업데이트한 후에는 페이로드 버전 1.0으로 되돌릴 수 없습니다.