Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Condivisione delle opportunità
<a name="custom-opportunity-sharing"></a>

## Come AWS condivide le opportunità
<a name="how-aws-shares-opportunities"></a>

1. **Esportazioni incrementali**: Amazon Web Services (AWS) esporta nuove opportunità (e aggiornamenti) a cui fa riferimento AWS, su base oraria.

1. **Creazione di file**: AWS genera file di opportunità che aderiscono a un formato specifico. Per le specifiche dettagliate dei file, consulta [Definizioni dei campi Opportunità](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv).

1. **Caricamento file**: i file Opportunity vengono caricati nella `opportunity-outbound` cartella.

## Opportunità di consumo provenienti da AWS
<a name="consuming-opportunities-from-aws"></a>

Per sfruttare efficacemente le opportunità offerte AWS, è necessario creare un'integrazione personalizzata con queste funzionalità.

1. **Recupero dei file**:
   + Utilizza un processo pianificato per scansionare regolarmente la `opportunity-outbound` cartella, a un intervallo di tua scelta.
   + Recupera i file delle opportunità per l'elaborazione.

1. **Trasformazione e mappatura dei dati**:
   + Dopo aver letto il contenuto di ogni file, trasformate e mappate i dati nei record delle opportunità nel vostro sistema di gestione delle relazioni con i clienti (CRM).
   + Per indicazioni sulla mappatura dei campi, fare riferimento a. [Mappatura dei campi](custom-field-mapping.md)

1.  **Identificazione delle opportunità**:
   + Identifica in modo univoco ogni opportunità utilizzando `partnerCrmOpportunityId` o`apnCrmUniqueIdentifier`.
   + Se `partnerCrmOpportunityId` è vuoto ed `apnCrmUniqueIdentifier` è presente, l'opportunità è una nuova segnalazione da parte di AWS Partner Network (APN) Customer Engagement (ACE).
   + Se sono presenti entrambi gli identificatori, il record viene considerato come un aggiornamento di ACE.

1. **Acquisizione di opportunità**: acquisisci nuove opportunità o aggiorna le opportunità esistenti nel sistema CRM.

1. **Gestione** dei file:
   + Dopo aver elaborato correttamente ogni opportunità e i dati completi del file, elimina i file dalla cartella in uscita.
   + Ogni file viene archiviato automaticamente nella cartella`opportunity-outbound-archive`.

**Integrazione e riferimento al codice:**
+  Per leggere i file caricati nel bucket Amazon Simple Storage Service (Amazon S3), puoi AWS Lambda utilizzare o leggere direttamente dal tuo sistema CRM.
+ Utilizza i codici di esempio seguenti per l'API REST di Lambda e Salesforce per convalidare e aggiornare i record CRM.
  + **Lambda per la convalida dei file**[: ace\$1read\$1s3.py.](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
  + **API REST di Salesforce: APEX\$1sample\$1REST\$1** [ode.cls. API\$1C](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)
+ Se utilizzi un sistema CRM diverso da Salesforce, devi fornire un codice specifico per il tuo sistema per aggiornare i dati.

## Condivisione degli aggiornamenti sulle opportunità con AWS
<a name="sharing-updates-to-opportunities-with-aws"></a>

1. **Identifica le opportunità**: individua le opportunità con aggiornamenti da condividere AWS.

1. **Trasformazione dei dati**: converti i dati nel AWS formato, come indicato in[Definizioni dei campi](resources.md#custom-field-definitions).

1.  **Creazione di file**: 
   + Genera file di opportunità in formato JSON.
   + Aggiungi un timestamp a ciascun file, assicurandoti che tutti i nomi dei file siano unici e seguano il formato:. `{name}_MMDDYYYY24HHMMSS.json`

1.  **Autentica** e carica: 
   + Effettua l'autenticazione nel bucket ACE Amazon S3.
   + Carica il file nella cartella. `opportunity-inbound` Tutti i file condivisi con AWS vengono archiviati automaticamente nella `opportunity-inbound-archive` cartella.
   + Quando carichi file su S3, assicurati di fornire l'accesso completo al proprietario del bucket:

     ```
     aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control
     ```

      Guarda un esempio di risultato dell'esecuzione di questo comando in [Opportunity Results Success](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json) Sample.json.

1. **Elaborazione dei file:** 
   + Al ricevimento, elabora AWS automaticamente i file.
   + I risultati dell'elaborazione vengono caricati `lead-inbound-processed-results` nella cartella del bucket Amazon S3. Ciò include lo stato dei successi e degli errori, nonché eventuali messaggi di errore per ogni opportunità.
   + Questi risultati elaborati vengono inoltre archiviati nella cartella`opportunity-inbound-processed-results-archive`.
   + Per ulteriori informazioni, fare riferimento a. [Domande frequenti tecniche: lead e opportunità](technical-faq-leads-and-opps.md)

1. **Gestione delle risposte**:
   + È necessario sviluppare una logica per utilizzare queste risposte, esaminare i record errati, correggere eventuali errori e inviare nuovamente i dati ad ACE.
   + Puoi trovare esempi di errori nelle sezioni Domande frequenti e Risoluzione dei problemi.
   + Per caricare un file su Amazon S3 da CRM:
     + Fai riferimento alla versione della firma. AWS 
     + Utilizza una richiesta HTTPS per caricare il file.
   + Come riferimento, usa i seguenti file per caricare un file nel bucket Amazon S3: 
     + **[Per autenticare un bucket S3: S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)**
     + **[Per caricare file in un bucket S3: Sample\$1 .cls AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)**
   + **NOTA:** i file non devono superare 1 MB di dimensione e i file duplicati non verranno elaborati.