기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 기회 공유
<a name="custom-opportunity-sharing"></a>

## 가 기회를 AWS 공유하는 방법
<a name="how-aws-shares-opportunities"></a>

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
<a name="consuming-opportunities-from-aws"></a>

기회를 효과적으로 소비하려면 이러한 기능과의 사용자 지정 통합을 구축 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
<a name="sharing-updates-to-opportunities-with-aws"></a>

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를 초과해서는 안 되며 중복 파일은 처리되지 않습니다.