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à.
# Utilizzo di un CRM precedente con integrazione Amazon S3
**Importante**
AWS Partner Central ha smesso di accettare nuove richieste per questo tipo di integrazione nel 2024. Questa sezione si applica solo ai partner che utilizzano Amazon S3.
Per iniziare con una nuova integrazione CRM personalizzata, consulta l'[AWS Partner Central API Reference](https://docs.aws.amazon.com/partner-central/latest/APIReference/aws-partner-central-api-reference-guide.html).
**Topics**
+ [Aggiornamento da un CRM con integrazione Amazon S3 all'API Partner Central](upgrade-crm-api.md)
+ [Configurazione del connettore per un CRM con integrazione Amazon S3](s3-config.md)
+ [Risorse per l'integrazione](resources.md)
+ [Condivisione dei lead](custom-lead-sharing.md)
+ [Condivisione delle opportunità](custom-opportunity-sharing.md)
+ [Mappatura dei campi](custom-field-mapping.md)
+ [Creazione di pianificazioni di sincronizzazione](crm-connector-scheduling.md)
+ [Best practice](best-practices.md)
+ [Quote](quotas.md)
+ [Cronologia delle versioni](version-history.md)
+ [FAQs](faqs.md)
# Aggiornamento da un CRM con integrazione Amazon S3 all'API Partner Central
**Nota**
Gli argomenti di questa sezione presuppongono che tu abbia completato i prerequisiti per un'integrazione con AWS Partner Central, un'integrazione con AWS Marketplace o entrambe. Per ulteriori informazioni, consulta [Prerequisiti per l'integrazione](crm-integration-setting-up.md) le pagine [Nozioni di base](crm-integration-getting-started.md) precedenti di questa guida.
I passaggi nelle sezioni seguenti spiegano come eseguire l'aggiornamento da un CRM precedente con integrazione Amazon S3 all'API AWS Partner Central. L'aggiornamento elimina la necessità di diversi requisiti ACE, come la necessità di un utente di integrazione e la necessità di configurare pianificazioni di sincronizzazione.
**Topics**
+ [Funzionalità di aggiornamento](api-upgrade-features.md)
+ [Impostare credenziali denominate](set-up-api-credentials.md)
+ [Aggiungi il pulsante Stato di approvazione alla pagina Opportunity Lightning Record](add-approval-status-button.md)
+ [Aggiungi i pulsanti rimanenti](add-remaining-buttons.md)
+ [Aggiorna la scheda Offerte di soluzioni](refresh-the-solutions-from-the-solution-offerings-tab.md)
# Funzionalità di aggiornamento
L'aggiornamento offre le seguenti funzionalità:
+ Non è più necessario un set di autorizzazioni utente di integrazione ACE in Salesforce.
+ Non è più necessario creare una pianificazione per le opportunità ACE in Salesforce.
+ L'API Partner Central fornisce anche una serie di pulsanti che abilitano le seguenti azioni nella pagina **Opportunity Lightning Record**:
+ **Stato di approvazione**: accetta o rifiuta le opportunità AWS segnalate.
**Nota**
Questo pulsante sostituisce l'elenco **dello stato di accettazione dei partner**. È necessario utilizzare il pulsante per accettare le opportunità AWS generate.
+ **Condividi con AWS**: crea e aggiorna le opportunità.
+ **Associa o dissocia**: associa o dissocia un'opportunità dalle soluzioni, dai AWS prodotti e dalle Marketplace AWS offerte dei partner durante l'intero ciclo di vita dell'opportunità.
+ **Assegna: riassegna** un'opportunità a un altro utente nel tuo account Partner Central.
I pulsanti vengono aggiunti dopo aver impostato le credenziali denominate. I seguenti argomenti spiegano come completare queste attività.
# Impostare credenziali denominate
Per eseguire l'upgrade all'API Partner Central, devi prima configurare credenziali denominate. Il connettore CRM utilizza le credenziali dell'organizzazione Salesforce per l'autenticazione con Partner Central.
**Per configurare le credenziali**
1. Accedi a Salesforce come amministratore di sistema.
1. **In **Credenziali nominative**, scegli Nuovo in precedenza.**
1. Nel modulo **Nuove credenziali denominate**, immettete i valori della tabella seguente.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/partner-central/latest/crm/set-up-api-credentials.html)
1. Scegli **Save** (Salva).
1. Torna alla pagina di **configurazione AWS guidata**. Nella sezione **Dettagli di autenticazione**, scegli **Rivedi** e conferma le credenziali.
# Aggiungi il pulsante Stato di approvazione alla pagina Opportunity Lightning Record
I passaggi seguenti spiegano come aggiungere il pulsante **Stato di approvazione** alla pagina Opporuntiy Lightning Record. Il pulsante ti consente di vedere lo stato delle tue opportunità durante il processo di approvazione.
**Per aggiungere il pulsante**
1. Accedi alla tua organizzazione Salesforce come amministratore di sistema.
1. Vai alla pagina **Opportunity Lightning Record**.
1. Scegli il pannello evidenziato per aprire il pannello delle proprietà.
1. Seleziona **Aggiorna ora**.
1. Seleziona **Migra azioni esistenti**, quindi seleziona il layout di pagina da cui desideri aggiornare le azioni.
- OPPURE -
Inizia da zero e aggiungi le azioni manualmente.
1. Dall'elenco **Azioni**, scegli **Stato di approvazione**.
1. Scegli **Save** (Salva).
**Nota**
È sufficiente completare i passaggi 4 e 5 una sola volta.
Il pulsante **sullo stato di approvazione** viene visualizzato solo nella pagina **Opportunity Lightning Record** per le opportunità AWS segnalate.
# Aggiungi i pulsanti rimanenti
Puoi aggiungere alcuni o tutti i pulsanti elencati nei seguenti passaggi.
**Per aggiungere i pulsanti**
1. Accedi alla tua organizzazione Salesforce come amministratore di sistema.
1. Vai alla pagina **Opportunity Lightning Record**.
1. Scegli il pannello evidenziato per aprire il pannello delle proprietà.
1. Scegli **Assegna da Azioni**, quindi seleziona alcuni o tutti i seguenti elementi:
+ **Condividi con AWS**
+ **Associarsi o dissociarsi**
+ **Assegna**
Per ulteriori informazioni sulla funzione di ciascun pulsante, consulta la [Funzionalità di aggiornamento](api-upgrade-features.md) sezione precedente di questa guida.
1. Scegli **Save** (Salva).
# Aggiorna la scheda Offerte di soluzioni
I passaggi seguenti spiegano come aggiornare i dati nella scheda **Offerte di soluzioni**.
1. Accedi alla tua organizzazione Salesforce come amministratore di sistema.
1. Vai alla scheda Offerte di **soluzioni**.
1. Seleziona **Refresh Solutions**.
# Configurazione del connettore per un CRM con integrazione Amazon S3
**Importante**
A partire dal 2024, AWS Partner Central ha reso questo tipo di integrazione non disponibile per i nuovi utenti.
**Nota**
Gli argomenti di questa sezione presuppongono che tu abbia completato i prerequisiti per un'integrazione con AWS Partner Central, un'integrazione con AWS Marketplace o entrambe. Per ulteriori informazioni, consulta [Prerequisiti per l'integrazione](crm-integration-setting-up.md) le pagine [Nozioni di base](crm-integration-getting-started.md) precedenti di questa guida.
Il CRM obsoleto con integrazione Amazon S3 utilizza un bucket Amazon S3 per trasferire lead e opportunità. Consigliamo di utilizzare l'integrazione dell'API Partner Central, come illustrato nella sezione precedente, per creare e gestire opportunità. Tuttavia, puoi utilizzare questa configurazione se desideri utilizzare il connettore per gestire i lead in Salesforce.
**Topics**
+ [Inserimento dei dettagli di autenticazione della connessione](#apn-s3-authentication-details)
+ [Inserimento delle impostazioni di configurazione del sistema](#apn-s3-config-settings)
+ [Test della connessione](#apn-s3-testing)
+ [Invio e ricezione di opportunità e lead](#sending-receiving-opportunities-leads)
+ [Lista di controllo della produzione](ace-production-checklist.md)
+ [Aggiornamento del connettore AWS Partner CRM al nuovo modello di dati](connector-upgrade-plan.md)
+ [Test in sandbox con l'opportunità ACE personalizzata e gli oggetti principali ACE](custom-ace-opportunity.md)
+ [Collegamento delle offerte Marketplace AWS private alle opportunità ACE](#linking-private-offers-to-ace)
## Inserimento dei dettagli di autenticazione della connessione
I partner iniziano il processo di integrazione inserendo i dettagli necessari per connettersi al proprio endpoint Amazon S3. Segui ogni serie di passaggi nell'ordine elencato e completa ogni set prima di passare a quello successivo.
Le seguenti attività vengono eseguite dalla scheda di **configurazione AWS guidata**. Per informazioni sull'uso della scheda, consulta la sezione [Utilizzo della configurazione guidata](use-guided-setup.md) precedente di questa guida.
**Per inserire i dettagli di autenticazione**
1. In Salesforce, apri la scheda di **configurazione AWS guidata**. Per informazioni sull'apertura di quella scheda, consulta l'articolo [Utilizzo della configurazione guidata](use-guided-setup.md) precedente di questa guida.
1. Espandi **Passaggio 1: dettagli di autenticazione della AWS connessione** e scegli **Avvia.**
1. Nella pagina **Credenziali denominate**, scegli **Nuovo in precedenza**.
1. Nel modulo **Nuove credenziali denominate**, immettete i valori della tabella seguente.
| **Campo** | **Valore** |
| --- | --- |
| Etichetta | Connessione API APN |
| URL | [https://s3.us-west-2.amazonaws.com](https://s3.us-west-2.amazonaws.com) |
| Tipo di identità | Nominato Principal |
| Protocollo di autenticazione | AWS firma, versione 4 |
| AWS ID chiave di accesso | Cloud-Ops fornisce l'ID durante i passaggi preliminari |
| AWS chiave di accesso segreta | Cloud-Ops fornisce la chiave di accesso durante i passaggi prerequisiti |
| AWS Region | us-west-2 |
| AWS service | s3 |
| Genera un'intestazione di autorizzazione | checked |
| Consenti l'unione di campi nell'intestazione HTTP | non controllato |
| Consenti l'unione di campi nel corpo HTTP | non controllato |
1. Scegli **Save** (Salva).
1. Torna alla pagina di **configurazione AWS guidata**. Nella sezione **Dettagli di autenticazione**, scegli **Rivedi** e conferma le credenziali.
1. Tieni aperta la pagina **Configurazione AWS guidata** e procedi con i passaggi successivi.
## Inserimento delle impostazioni di configurazione del sistema
I passaggi seguenti spiegano come inserire le impostazioni di configurazione del sistema corrette per l'integrazione.
1. Espandi **Passaggio 2: Impostazioni di configurazione del sistema** e scegli **Avvia.**
1. Individua le **impostazioni del connettore AWS Partner CRM** e scegli **Gestisci**.
1. Scegli **Nuovo**, quindi inserisci i valori richiesti dalla tabella seguente.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/partner-central/latest/crm/s3-config.html)
1. Scegli **Save** (Salva).
1. Torna alla pagina di **configurazione AWS guidata**. Nella sezione **Dettagli di autenticazione**, scegli **Rivedi** e conferma le credenziali.
## Test della connessione
Prima di testare la connessione, assicurati di completare i passaggi nelle sezioni precedenti.
**Per verificare la connessione**
1. Espandi il **passaggio 3: Verifica la configurazione per l'API APN.**
1. Scegli **Test (Esegui test)**.
Se la connessione riesce, riceverai un messaggio di conferma.
## Invio e ricezione di opportunità e lead
Puoi inviare e ricevere opportunità e lead sincronizzandoli con Partner Central. **Per sincronizzare un'opportunità o un lead, è necessario impostare il campo **Sincronizza con Partner Central** su True.** I campi chiave aggiuntivi per l'integrazione includono i campi **Data ultima sincronizzazione APN** e **Idoneo per la sincronizzazione con APN**.
Questi campi sono inclusi per opportunità e lead standard. Tuttavia, è necessario crearli e mapparli per qualsiasi oggetto sorgente personalizzato.
+ **Sincronizzazione con Partner Central**: inclusa nell'app per opportunità e lead standard. Se un AWS Partner sceglie di mappare su oggetti personalizzati, deve essere creato un campo booleano personalizzato e mappato rispettivamente nelle mappature delle opportunità e dei lead.
+ **Data ultima sincronizzazione con APN**: indica l'ultima volta in cui il record è stato inviato o ricevuto correttamente da APN. Questo campo viene impostato automaticamente quando il record viene inviato correttamente all'APN o viene ricevuto un aggiornamento da APN.
+ **Idoneo alla sincronizzazione con APN**: un campo di formula che determina se il record è destinato a essere inviato ad APN nel prossimo lavoro pianificato. Calcolato in base al fatto che il record sia stato modificato dall'ultima volta in cui è stata eseguita la pianificazione in uscita e sia stato aggiornato da un utente diverso dall'utente di integrazione designato per l' AWS Partner organizzazione in questione.
# Lista di controllo della produzione
Segui questi passaggi per completare l'installazione di produzione del connettore AWS Partner CRM.
1. Conferma di aver completato il [processo di onboarding](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-getting-started.html) per l'integrazione CRM. Nella [fase 6](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html) di questo processo, configuri l'ambiente di produzione ed esegui la migrazione dei dati in modo da poter gestire le opportunità e i lead attraverso l'integrazione.
1. Installa e configura il connettore CRM. Per ulteriori informazioni, vedi [Installazione del connettore](install-connector.md).
1. Mappa le opportunità e guida gli oggetti scegliendo una delle seguenti opzioni di mappatura. Per riferimento, consulta questo elenco di [campi obbligatori](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv) su GitHub.
+ Utilizza l'oggetto personalizzato di opportunità AWS ACE fornito con il connettore AWS Partner CRM per registrare le opportunità e condividerle con AWS. Utilizzando questa opzione, puoi mappare automaticamente AWS i campi ai campi Salesforce.
+ Utilizzate l'oggetto Salesforce standard e mappate i campi obbligatori. AWS
+ Utilizza un oggetto di opportunità personalizzato ACE. Per prima cosa crei un flusso di lavoro per compilare una tabella intermedia di oggetti di opportunità ACE e quindi mappare i campi Salesforce su. AWS
1. Per ulteriori dettagli e indicazioni sulle opzioni di mappatura, fare riferimento a. [Mappatura degli oggetti ACE](crm-connector-mapping.md)
1. (Facoltativo) Imposta i piani di sincronizzazione in entrata e in uscita tra Network e Salesforce. AWS Partner Per i dettagli, fare riferimento a. [Creazione di pianificazioni di sincronizzazione](crm-connector-scheduling.md)
1. Per convalidare un'opportunità creata da un partner in fase di produzione, invia una richiesta di [assistenza](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-faq.html#troubleshooting) a Partner Central Operations (PCO) nel tuo account Partner Central. In questo processo, crei un'opportunità fittizia, la sincronizzi con AWS e chiedi all'agente dell' AWS assistenza di confermare di aver ricevuto l'opportunità. AWS Al termine del test, chiedi al tuo agente dell' AWS assistenza di rifiutare la richiesta di opportunità in modo da poterla eliminare dalla tua parte.
1. (Facoltativo) Esegui il backfill dei dati. Questo processo garantisce che sia i referral delle opportunità AWS originate che quelli provenienti dai partner possano essere identificati durante i futuri aggiornamenti. Per ulteriori informazioni, consulta la [Fase 6: Approvazione della produzione](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html) nel processo di onboarding del CRM.
1. Attiva l'integrazione di produzione per consentire lo scambio di file tramite il bucket Amazon S3. Per i dettagli, consulta [Stage 7:](https://docs.aws.amazon.com/partner-central/latest/crm/stage-7-launch.html) Launch.
# Aggiornamento del connettore AWS Partner CRM al nuovo modello di dati
**Importante**
Testa e approva l'aggiornamento del nuovo modello di dati nella tua organizzazione Sandbox di Salesforce prima di aggiornare il tuo ambiente di produzione. [Per il nuovo modello di dati e le modifiche tra il vecchio e il nuovo modello, fai riferimento al seguente aws-samples/ on: partner-crm-integration-samples](https://github.com/aws-samples/partner-crm-integration-samples/tree/main/opportunity-samples) GitHub
**FieldsAndStandardValuesOpportunità- - -v14.3.xlsx DiffWithPrevVersion**
**Opportunity-Fields.xlsx**
**StandardValuesOpportunità\$1-\$1 .xlsx**
## Prerequisiti
+ Utilizza le definizioni dei campi per le nuove linee guida del modello di dati dell'integrazione ACE CRM e migra tutte le opportunità aperte e i lead richiesti verso il nuovo modello di dati.
+ Aggiungi o rimuovi colonne negli oggetti personalizzati o standard (oggetti utilizzati nella mappatura).
+ Assicurati di utilizzare la versione 2.0 o successiva del connettore AWS Partner CRM.
**Per eseguire l'aggiornamento al nuovo modello di dati**
1. Accedi alla tua organizzazione Salesforce come amministratore di sistema.
1. Disattiva tutte le pianificazioni attive.
1. Scegli **Configurazione**, **Impostazioni personalizzate, Impostazioni del** **connettore AWS Partner CRM**, quindi aggiorna la versione alla **2.0 o successiva**.
**Nota**
A partire dalla versione 2.0, il campo **Versione** è obbligatorio. Questo campo specifica la versione del payload utilizzata dai partner per interagire con l'integrazione CRM. Quando i partner passano alla versione 2.0, devono adottarne appieno le specifiche. Il ripristino alle versioni precedenti non è consentito.
1. Scegli la scheda **ACE Mapping**.
1. Crea, rivedi e aggiorna tutte le mappature e i dettagli dei campi richiesti. Per i test in modalità sandbox, utilizza l'opportunità ACE personalizzata e l'oggetto principale ACE per testare le nuove funzionalità del modello di dati. Per ulteriori informazioni, vedi [Test in sandbox con l'opportunità ACE personalizzata e gli oggetti principali ACE](custom-ace-opportunity.md).
1. Attiva le pianificazioni per opportunità e lead.
1. Esamina i registri di sincronizzazione ACE per individuare eventuali errori di sincronizzazione e apporta eventuali correzioni.
1. Esamina le opportunità e i lead sincronizzati per garantire che la trasformazione dei dati sia accurata. In alternativa, esamina le opportunità e i lead di ACE per assicurarti che le nuove modifiche al modello di dati vengano acquisite con precisione.
1. Segui il processo di implementazione del prodotto per migrare le modifiche all'ambiente Salesforce di produzione.
**Nota**
Se hai bisogno di aiuto, consulta. [Utilizzo della guida](getting-help.md)
# Test in sandbox con l'opportunità ACE personalizzata e gli oggetti principali ACE
**Nota**
Se sei già un utente del connettore CRM, consulta. [Aggiornamento del connettore AWS Partner CRM al nuovo modello di dati](connector-upgrade-plan.md)
1. Accedi alla tua organizzazione Salesforce come amministratore di sistema.
1. **Scegli **Configurazione**, **Impostazioni personalizzate, Impostazioni del** **connettore AWS Partner CRM** e aggiorna la versione a 2.**
1. Scegli la scheda **ACE Mapping**.
1. Per **Opportunity**, mappalo all'oggetto personalizzato dell'**opportunità ACE**.
1. Scegliete **Auto Map (Mappa automatica) dell'oggetto ACE**.
**Nota**
Se desideri eseguire l'aggiornamento alla nuova versione del connettore CRM e desideri utilizzare l'opportunità ACE personalizzata e gli oggetti principali ACE del connettore per i test nella sandbox, ti consigliamo di eliminare manualmente tutti i record disponibili dal `Field Mappings` e `Field Mapping Details` gli oggetti dal database prima di utilizzare la funzione Mappa automatica degli oggetti ACE. È sufficiente eseguire questa operazione una sola volta.
1. Rivedi le mappature dei campi e i valori di mappatura dei campi per picklist e multipicklist.
1. Attiva le pianificazioni per opportunità e lead.
1. Esamina i registri di ACE Sync per individuare eventuali errori di sincronizzazione e apporta le correzioni necessarie.
1. Esamina le opportunità e i lead sincronizzati per garantire che la trasformazione dei dati sia accurata. In alternativa, esamina le opportunità e i lead di ACE per assicurarti che le nuove modifiche al modello di dati siano state acquisite con precisione.
## Visualizzazione dei record dei dettagli del registro di sincronizzazione per le opportunità ACE
È possibile visualizzare i dettagli del registro di sincronizzazione per le opportunità ACE AWS fornite nella scheda **Correlati** del record delle opportunità ACE.
**Nota**
Questi passaggi si applicano solo agli oggetti AWS di opportunità ACE forniti. Se esegui il mapping su oggetti standard o personalizzati nella tua organizzazione Salesforce, puoi visualizzare i dettagli del registro di sincronizzazione nella scheda **ACE Sync** Log.
1. Accedi alla tua organizzazione Salesforce.
1. **Nell'**App Launcher**, scegli AWS Partner il connettore CRM.**
1. Scegli la scheda **ACE Opportunities**.
1. Scegli un record di opportunità ACE.
1. Scegli la scheda **Correlati** per visualizzare i dettagli, tra cui **nome del registro di sincronizzazione**, **stato**, **messaggio di errore** e **data di creazione**.
## Collegamento delle offerte Marketplace AWS private alle opportunità ACE
Puoi collegare le offerte private direttamente dalla pagina di registrazione delle opportunità ACE AWS fornite.
1. Accedi alla tua organizzazione Salesforce.
1. **Nell'**App Launcher, scegli** il connettore CRM.AWS Partner **
1. Scegli la scheda **ACE Opportunities**.
1. Scegli un record di opportunità ACE.
1. Scegli **Link Private Offer**.
1. In **Offer ID Look Up**, scegli l'offerta privata.
1. Scegli **Save** (Salva).
# Risorse per l'integrazione
AWS fornisce le seguenti risorse per aiutarti a creare un'integrazione personalizzata.
**Topics**
+ [Definizioni dei campi](#custom-field-definitions)
+ [Valori standard](#standard-values)
+ [Esempi di file in entrata](#sample-inbound-files)
+ [Esempi di file in uscita](#sample-outbound-files)
+ [Esempio di risultati elaborati](#sample-processed-results)
+ [Esempi di casi di test](#sample-test-cases)
+ [Frammenti di codice di esempio](#sample-code-snippets)
## Definizioni dei campi
I collegamenti nelle sezioni seguenti elencano tutti i campi, spiegandone i tipi di dati, l'utilizzo ed eventuali vincoli o regole di formattazione applicabili. Servono da riferimento per garantire che quando i partner AWS scambiano dati, questi siano formattati e compresi correttamente.
I seguenti link ti portano a. GitHub
+ [Opportunità](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)
+ [Piombo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv)
## Valori standard
Questi elenchi descrivono i valori e le enumerazioni standard per vari campi. Contribuiscono a mantenere la coerenza dei dati scambiati e garantiscono che entrambe le parti abbiano una comprensione comune dei valori utilizzati.
I seguenti collegamenti consentono di accedere a. GitHub
+ [Opportunità](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity_-_StandardValues.csv)
+ [Piombo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead_-_StandardValues.csv)
## Esempi di file in entrata
I seguenti file di esempio mostrano la struttura del payload JSON per un file inviato da un partner a. AWS
I seguenti collegamenti consentono di accedere a. GitHub
+ [Opportunità](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Create-Inbound-Sample.json)
+ [Piombo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Update-Inbound-Sample.json)
## Esempi di file in uscita
I seguenti file di esempio mostrano la struttura del payload JSON per un file inviato AWS a un partner.
I seguenti collegamenti consentono di accedere a. GitHub
+ [Opportunità](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Outbound-Sample.json)
+ [Piombo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Outbound-Sample.json)
## Esempio di risultati elaborati
I seguenti file mostrano un risultato tipico dopo l' AWS elaborazione di un payload inviato da un partner.
I seguenti collegamenti consentono di accedere a. GitHub
+ [Opportunità](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
+ [Piombo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)
## Esempi di casi di test
I seguenti link ti portano a GitHub.
+ [Opportunità](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity%20-%20Testing%20Scenarios.xlsx)
+ [Piombo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead%20-%20Testing%20Scenarios.xlsx)
## Frammenti di codice di esempio
I seguenti collegamenti consentono di accedere a. 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\$1ode.cls API\$1C](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)
+ [Esempio\$1 .cls AceOutboundBatch](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)
# Condivisione dei lead
## In che modo AWS condivide i lead
1. **Esportazioni incrementali**: Amazon Web Services (AWS) esporta nuovi lead (e aggiornamenti) a cui si fa riferimento AWS, su base oraria.
1. **Creazione di file**: AWS genera file lead che aderiscono a un formato specifico. Per le specifiche dettagliate dei file, fare riferimento a. [Definizioni dei campi](resources.md#custom-field-definitions)
1. **Caricamento del file**: i file principali vengono caricati nella `lead-outbound` cartella.
## Consumo di lead da AWS
Per utilizzare in modo efficace i lead provenienti da AWS, crea un'integrazione personalizzata con le seguenti funzionalità.
1. **Recupero dei file**:
+ Scansiona regolarmente la `lead-outbound` cartella utilizzando un processo pianificato a un intervallo scelto.
+ Recupera i file principali per l'elaborazione.
1. **Trasformazione e mappatura dei dati**:
+ Dopo aver letto il contenuto di ogni file, trasformate e mappate i dati nei record principali del 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 del lead**:
+ Identifica in modo univoco ogni lead utilizzando `partnerCrmLeadId` o`apnCrmUniqueIdentifier`.
+ Se `partnerCrmLeadId` è vuoto ed `apnCrmUniqueIdentifier` è presente, il lead è un nuovo referral di AWS Partner Network (APN) Customer Engagement (ACE).
+ Se sono presenti entrambi gli identificatori, il record viene considerato come un aggiornamento di ACE.
1. Ingestione di **piombo:**
+ Inserisci nuovi lead o aggiorna i lead esistenti nel sistema CRM.
1. **Gestione dei file**:
+ Dopo aver elaborato correttamente ogni lead e i dati completi del file, elimina i file dalla cartella in uscita.
+ Ogni file viene archiviato automaticamente nella cartella`lead-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 sui lead con AWS
1. **Identifica i lead**: individua i lead 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 lead 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. `lead-inbound` Tutti i file condivisi con AWS vengono archiviati automaticamente nella `lead-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 [«Results Sample file.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-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 lead.
+ Questi risultati elaborati vengono inoltre archiviati nella cartella`lead-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.
# Condivisione delle opportunità
## Come AWS condivide le opportunità
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
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
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.
# Mappatura dei campi
La mappatura dei campi è una fase essenziale del processo di integrazione in cui i partner allineano i campi del loro sistema di gestione delle relazioni con i clienti (CRM) con quelli definiti da Amazon Web Services ().AWS Ciò garantisce che entrambe le parti si scambino e comprendano i dati in modo accurato. Di seguito sono riportate le linee guida per facilitare questo processo.
## Mappatura obbligatoria dei campi
+ Associa ogni campo obbligatorio al campo corrispondente nel tuo sistema CRM. È essenziale per il successo dello scambio di dati assicurarsi che tutti i campi obbligatori siano mappati. Per ulteriori informazioni, fare riferimento a [Definizioni dei campi](resources.md#custom-field-definitions)
+ [Opportunità](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)
+ [Piombo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv)
## Gestione dei campi opzionali
+ Comprendi il ruolo dei campi opzionali nel processo di integrazione. Decidi se vuoi mappare questi campi in base ai tuoi requisiti aziendali e sii consapevole delle possibili implicazioni derivanti dal lasciarli non mappati.
## Mappatura dei valori
+ Allinea ogni valore di campo nel tuo CRM al valore di elenco AWS Partner Network (APN) Customer Engagement (ACE) richiesto, come specificato in. [Definizioni dei campi](resources.md#custom-field-definitions) Questo è importante per mantenere la coerenza e l'integrità dei dati.
## Convalida del tipo e del formato dei dati
+ *Verifica che i tipi e i formati di dati dei campi del tuo sistema CRM siano allineati a quelli specificati nelle definizioni dei AWS campi.* È essenziale mantenere la coerenza nei tipi e nei formati di dati per prevenire il danneggiamento dei dati e garantire un'integrazione perfetta.
## Lunghezza e limiti del campo
+ Notate le restrizioni sulla lunghezza dei campi e altre limitazioni. Assicurati che i dati del tuo sistema CRM rientrino nei campi corrispondenti AWS senza che vengano troncati o causino errori.
## Convalida del tipo e del formato dei dati
+ Verifica che i tipi e i formati dei dati di campo nel tuo sistema CRM siano conformi a quelli specificati in. [Definizioni dei campi](resources.md#custom-field-definitions) È fondamentale prevenire il danneggiamento dei dati e garantire una perfetta integrazione con coerenza nei tipi e nei formati di dati.
## Revisione e aggiornamento periodici
+ Rivedi e aggiorna regolarmente le mappature dei campi per adattarle alle modifiche del sistema o dei requisiti CRM. AWS Questo approccio proattivo garantisce l'accuratezza e l'efficienza dello scambio continuo dei dati.
## Documentazione sulla mappatura dei campi
+ Conserva una documentazione completa sulla mappatura dei campi. Questa pratica aiuta nella risoluzione dei problemi, negli aggiornamenti futuri e garantisce la chiarezza sul modo in cui i dati vengono trasferiti tra i sistemi.
## Test e convalida
+ Esegui test approfonditi sulle mappature sul campo per verificare che i dati vengano trasferiti e trasformati in modo accurato. Risolvi immediatamente eventuali discrepanze o problemi per garantire l'integrità dei dati.
## Gestione delle sovrascritture indesiderate
+ Per evitare che AWS i dati sovrascrivano campi CRM specifici, considera quanto segue:
+ Creazione di un campo CRM personalizzato per i dati che desideri proteggere.
+ Far esaminare questo campo personalizzato da un rappresentante di vendita.
+ Una volta approvato il campo personalizzato, aggiungilo al record di opportunità e alla pipeline.
+ Ciò è particolarmente importante per campi come `MRR` or`Stage`, soprattutto se indicano che un prodotto è stato lanciato.
## Gestione delle dipendenze a valle
+ Se nel sistema sono presenti dipendenze a valle che si basano sullo scambio di dati, considera quanto segue:
+ Creazione di nuovi campi nel CRM per contenere i dati. AWS
+ Riallineamento dei processi aziendali, se necessario, per garantire un'integrazione e un flusso di dati senza interruzioni.
# Creazione di pianificazioni di sincronizzazione
**Nota**
Gli argomenti di questa sezione presuppongono che tu abbia completato i prerequisiti per un'integrazione con AWS Partner Central, un'integrazione con AWS Marketplace o entrambe. Per ulteriori informazioni, consulta [Prerequisiti per l'integrazione](crm-integration-setting-up.md) le pagine [Nozioni di base](crm-integration-getting-started.md) precedenti di questa guida.
Puoi creare pianificazioni di sincronizzazione in entrata e in uscita tra Salesforce e AWS Partner Central. I passaggi nelle seguenti sezioni spiegano come.
**Topics**
+ [Prerequisiti](#scheduling-prerequisites)
+ [Creazione di una pianificazione](#creating-a-schedule)
+ [Disattivazione di un lavoro pianificato](#deactivating-a-scheduled-job)
+ [Visualizzazione di tutte le pianificazioni](#viewing-all-schedules)
## Prerequisiti
Assicuratevi di completare quanto segue prima di creare una pianificazione di sincronizzazione:
+ [Mappa](crm-connector-mapping.md) tutti i campi obbligatori su almeno un oggetto, un'opportunità o un lead.
+ Crea un [utente di integrazione del sistema](#system-integration-user) in Salesforce.
### Creazione di un utente per l'integrazione del sistema
Prima di poter creare una pianificazione di sincronizzazione, è necessario utilizzare Salesforce per creare un utente di integrazione di sistema con autorizzazioni di integrazione APN. Per creare pianificazioni di sincronizzazione, è necessario accedere a Salesforce come utente di integrazione del sistema. La creazione di una pianificazione senza le autorizzazioni utente per l'integrazione APN può interrompere l'integrazione APN.
**Per creare un utente per l'integrazione del sistema**
1. Accedi alla tua organizzazione Salesforce come amministratore di sistema.
1. Crea un utente nella tua organizzazione Salesforce. Assegna un profilo all'utente con accesso agli oggetti richiesti nella tua organizzazione Salesforce. Per ulteriori informazioni, consulta [Aggiungere un singolo](https://help.salesforce.com/s/articleView?id=sf.adding_new_users.htm) utente.
1. Assegna all'utente il set di autorizzazioni **APN Integration User**. Per ulteriori informazioni, consulta [Assegnare il set di autorizzazioni](https://help.salesforce.com/s/articleView?id=sf.assign_permission_set_to_user.htm) agli utenti.
## Creazione di una pianificazione
Dopo aver completato i [prerequisiti](#scheduling-prerequisites), puoi creare pianificazioni di sincronizzazione tra Salesforce e APN.
**Per creare una pianificazione di sincronizzazione con APN**
1. Accedi a Salesforce come utente con autorizzazioni utente per l'integrazione del sistema.
1. **Nella scheda **Pianificazioni**, scegli Nuovo.**
1. Scegliete gli oggetti da programmare. Puoi impostare pianificazioni per lead e opportunità o per un singolo oggetto.
1. Scegli la frequenza del programma, da un minimo di cinque minuti a un massimo di una volta al giorno.
1. Seleziona **Schedule** (Pianifica).
**Nota**
Può essere attiva una sola pianificazione per oggetto alla volta. La creazione di una nuova pianificazione per lo stesso oggetto disattiva la pianificazione esistente.
Per disabilitare l'integrazione in entrata durante la creazione di una pianificazione, scegli **Disabilita integrazione in entrata**, Pianifica.
La creazione di una pianificazione senza le autorizzazioni utente per l'integrazione APN può interrompere l'integrazione APN.
## Disattivazione di un lavoro pianificato
1. Nella pagina **Pianificazione**, scegli **Disattiva tutti i lavori per disattivare tutte le** pianificazioni attive.
1. Procedi attraverso la schermata di conferma per disattivare la pianificazione della sincronizzazione.
## Visualizzazione di tutte le pianificazioni
Dalla scheda **Pianificazioni**, utilizza i filtri di visualizzazione dell'elenco per passare dalle pianificazioni di sincronizzazione **attive, **inattive**** e **Tutte** le pianificazioni di sincronizzazione.
# Best practice
Utilizza queste best practice per ottimizzare lo sviluppo e la manutenzione dell'integrazione personalizzata.
## Best practice generali
1. Mappa tutti i campi *obbligatori* perché sono i campi obbligatori del modulo di invio AWS Partner Network (APN) Customer Engagement (ACE).
1. Connettiti con il tuo attuale utente di ACE Pipeline Manager per capire come si presenta il processo. Immortala tutti processes/field gli usi unici, in modo da poterli integrare nella tua esperienza.
1. Prendi in considerazione la creazione di fasi di vendita separate per le fasi di vendita riportate da Amazon Web Services (AWS) (ad esempio: Stage, Data di chiusura prevista, AWS entrate mensili previste, Next Steps). Se abbiamo definizioni di fase diverse, potremmo sostituire le tue fasi di vendita. La creazione di fasi di vendita separate consente di gestire la pipeline in modo appropriato, ma allo stesso tempo di avere visibilità sulle previsioni. AWS
1. Per le opportunità segnalate dai partner, il team ACE deve approve/reject verificarle prima di accettare qualsiasi aggiornamento.
1. Per le opportunità AWS segnalate, il partner deve accettare o rifiutare le opportunità.
## Protocolli di scambio di dati
1. **Convenzioni di input**: separa le voci dell'elenco a selezione multipla con punto e virgola e spazi di omissione.
1. **Attenzione ai dettagli**: i nomi e i valori dei campi fanno distinzione tra maiuscole e minuscole, quindi mantieni la precisione.
1. **Procedure di eliminazione**: esegui la rimozione dei campi trasmettendo il valore `null` per il campo selezionato.
1. **Sincronizzazione**: i processi di sincronizzazione funzionano su base oraria, causando potenziali ritardi nelle riflessioni dei dati. Gli aggiornamenti AWS possono richiedere fino a un'ora prima che si riflettano nella gestione delle relazioni con i AWS clienti (CRM). Evita di inviare più documenti all'ora.
## Best practice specifiche per il settore
1. **Modifiche in entrata**: per proteggere l'integrità dei dati, disabilita le modifiche per campi come, e. `stage` `closedDate` `closedLostReason` Per tenere traccia AWS dei valori senza influire sui valori locali di Salesforce, utilizza questi campi di sola lettura:, e. `awsStage` `awsCloseDate` `awsClosedLostReason`
1. **Mappatura e convalida dei clienti**: garantisci l'accuratezza del sito Web dei clienti perché è fondamentale per la mappatura CRM. AWS Associalo al nome del cliente per una mappatura ottimale degli account CRM.
1. **Chiarezza della descrizione del progetto**: fornisci una descrizione chiara che descriva in dettaglio le sfide dei clienti e gli allineamenti delle soluzioni. AWS lo usa per convalidare l'opportunità.
1. **Fornitura:** (Facoltativo) Quando si forniscono informazioni specifiche di contatto con il cliente finale, è possibile AWS rintracciare lead e campagne. Ciò porta a migliori verdetti di finanziamento.
## Best practice aggiuntive
1. Rispetta le più recenti linee guida per la definizione dei campi di payload.
1. Mantieni la coerenza dei nomi dei bucket sandbox con il formato specificato.
1. Utilizza lo schema di denominazione consigliato per il bucket di produzione.
1. Dai priorità ai test dell'ambiente sandbox prima della distribuzione live.
1. Mantieni identificatori distinti per i record tra e i partner. AWS CRMs
1. Dopo l'elaborazione, elimina i file nella cartella Amazon Simple Storage Service (Amazon S3) in uscita. Gli originali rimangono negli archivi.
1. Per evitare errori, imposta le convalide a livello di campo all'origine.
# Quote
## File in entrata su Amazon Web Services ()AWS
| Operazione | Limite |
| --- | --- |
| Opportunità massime | 500 per file |
| Dimensione massima dei file | 1 MB |
| Frequenza di sincronizzazione | Quasi in tempo reale |
| Numero massimo di file inviati | 10.000 per periodo di 24 ore |
## File in uscita da inviare al partner
| Operazione | Limite |
| --- | --- |
| Dimensione massima dei file | 5 MB |
| Frequenza di sincronizzazione | Orario |
# Cronologia delle versioni
Versione attuale dei campi: 14 (15 novembre 2023)
La tabella seguente descrive le modifiche importanti ai campi di integrazione personalizzati per lead e opportunità dopo il 2020. Per ricevere notifiche sui futuri aggiornamenti, iscriviti al feed RSS.
| Modifica | Versione | Data |
| --- | --- | --- |
| Aggiornamento delle quote Amazon S3 | 14 | 17/01/2024 |
| **Modifiche ai campi delle opportunità di integrazione:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/partner-central/latest/crm/version-history.html) | 14 | 15/11/2023 |
| **Modifiche ai campi delle opportunità di integrazione:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/partner-central/latest/crm/version-history.html) | 13 | 29/03/2023 |
| **Modifiche ai campi delle opportunità di integrazione:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/partner-central/latest/crm/version-history.html) **Modifiche ai valori standard sulle opportunità:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/partner-central/latest/crm/version-history.html) | 12 | 09/01/2022 |
| **Modifiche ai campi delle opportunità di integrazione:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/partner-central/latest/crm/version-history.html) **Modifiche ai valori standard nei campi delle opportunità:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/partner-central/latest/crm/version-history.html) | 11 | 21/03/2022 |
| **Modifiche ai campi delle opportunità di integrazione:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/partner-central/latest/crm/version-history.html) **Modifiche ai valori standard sulle opportunità:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/partner-central/latest/crm/version-history.html) | 10 | 26/01/2022 |
| **Modifiche ai valori standard nei campi lead:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/partner-central/latest/crm/version-history.html) **Modifiche ai campi principali di integrazione:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/partner-central/latest/crm/version-history.html) **Modifiche ai campi delle opportunità di integrazione:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/partner-central/latest/crm/version-history.html) | 9 | 16/09/2021 |
| Aggiorna i codici motivo di Closed Lost | 8 | 24/06/2021 |
# FAQs
Usa queste domande e risposte comuni per aiutarti nell'integrazione personalizzata.
**Topics**
+ [Domande frequenti generali](general-faq.md)
+ [Domande frequenti tecniche: campi](technical-faq-fields.md)
+ [Domande frequenti tecniche: Amazon S3](technical-faq-s3.md)
+ [Domande frequenti tecniche: lead e opportunità](technical-faq-leads-and-opps.md)
+ [Domande frequenti tecniche: controllo delle versioni e compatibilità con le versioni precedenti](technical-faq-versioning.md)
# Domande frequenti generali
## Come funziona l'integrazione?
**D: Posso accedere al bucket Amazon Simple Storage Service (Amazon S3) usato per inviare e ricevere i file?**
Sì. I partner possono accedere programmaticamente al bucket Amazon S3 utilizzando secret/access la chiave di (IAM) che ha accesso AWS Identity and Access Management al bucket. I partner non avranno accesso da console ai bucket Amazon S3 perché questi bucket si trovano nell'account di Amazon Web Services (AWS).
**D: Di quali competenze ha bisogno lo sviluppatore del partner?**
Lo sviluppatore del partner deve conoscere il proprio sistema di gestione delle relazioni con i clienti (CRM) e Amazon S3.
**D: I file di codice di esempio includono codice completo o il partner deve scrivere il codice?**
Il partner deve scrivere il codice in base ai file di codice di esempio forniti.
**D: Se il partner sviluppa la propria soluzione in Python, Golang o in qualsiasi altro linguaggio, AWS Partner Network (APN) Customer Engagement (ACE) fornisce un kit di sviluppo software (SDK) in quelle lingue per questa integrazione?**
No.
**D: Qual è il processo di sincronizzazione dal bucket Amazon S3 all'ACE interno?**
Ogni ora viene eseguito un processo in batch per raccogliere i file e sincronizzare le informazioni. Qualsiasi aggiornamento registrato dal team di AWS vendita può richiedere fino a un'ora per essere inviato al bucket del partner. I partner possono ricevere immediatamente una notifica via e-mail sugli aggiornamenti, ma gli aggiornamenti AWS potrebbero comunque subire un ritardo di un'ora.
**D: Qual è la frequenza con cui ACE carica i file relativi a lead e opportunità?**
ACE invia i dati su lead e opportunità ogni ora.
**D: Esiste un ambiente sandbox per ACE?**
Sì. Disponiamo di un ambiente sandbox per ACE, ma non possiamo fornire l'accesso ai partner per motivi di sicurezza. Invia una richiesta di assistenza su Partner Central se desideri ricevere nuove opportunità o nuovi lead.
**D: Come gestiamo gli identificatori nel CRM e nell'APN del partner?**
Per offrire maggiore flessibilità ai nostri partner, utilizziamo due set di identificatori nel nostro sistema.
1. `apnCrmUniqueIdentifier`: AWS gestisce questo identificatore. Inizia con le `OXXXXXX` opportunità e `LXXXXXX` i lead.
1. `PartnerCrmUniqueIdentifier`/`partnerCrmLeadId`: Il partner gestisce questo identificatore rispettivamente sulle opportunità e sui lead all'interno del proprio CRM. I partner devono aggiungere questo identificatore mentre acquisiscono nuove opportunità per tracciare gli aggiornamenti nel proprio CRM.
Quando un'opportunità viene inviata senza `apnCrmUniqueIdentifier` o`partnerCrmUniqueIdentifier`, la AWS considera una nuova opportunità e ne assegna una nuova. `apnCrmUniqueIdentifier`
Quando un'opportunità viene inviata con un `apnCrmUniqueIdentifier` or`partnerCrmUniqueIdentifier`, la AWS considera come un'azione di aggiornamento e aggiorna l'opportunità esistente con i dati del payload.
**D: Come posso evitare la creazione di record duplicati in entrambi i sistemi?**
Dal punto di vista del CRM per i partner, deve esserci un identificatore univoco per ogni record inviato ad ACE, che viene chiamato. `partnerCrmUniqueIdentifier` Allo stesso modo, ACE mantiene anche un identificatore univoco per ogni record, che viene chiamato. `apnCrmUniqueIdentifier` Quando i dati vengono inviati, sia ACE che il partner devono includere questi due campi, il che aiuta a identificare se il record è una nuova opportunità (se vuoto) o un'opportunità esistente (se compilato).
# Domande frequenti tecniche: campi
**D: L'integrazione supporta il formato CSV?**
No. L'integrazione accetta solo formati di file JSON.
**D: Quando devono essere eliminati i file dalle cartelle in uscita?**
Elimina i file solo dopo averli elaborati correttamente.
**D: Se elimino accidentalmente i file dalle cartelle in uscita, dove posso trovare i file originali?**
I file sono disponibili nelle cartelle `opportunity-outbound-archive` and`lead-outbound-archive`.
**D: Cosa devo fare per fornire assistenza durante lo sviluppo?**
Per assistenza durante lo sviluppo, contatta l'assistenza AWS Partner Network (APN) su Partner Central.
**D: Qual è la differenza tra `opportunityOwnerName` e`opportunityOwnerEmail`?**
+ `opportunityOwnerName`: il nome del proprietario dell'opportunità nell'organizzazione partner. Deve essere un utente Partner Central.
+ `opportunityOwnerEmail`: l'indirizzo e-mail del proprietario dell'opportunità nell'organizzazione partner. Deve essere un utente Partner Central. Se non viene fornita, l'opportunità viene creata con Partner Central Alliance Lead come proprietario.
**D: Qual è il fuso orario per tutti i campi relativi alla data (`targetCloseDate``lastModifiedDate`,`createdDate`, e`acceptBy`)?**
Il fuso orario per i campi data è l'ora media di Greenwich (GMT).
**D: I file JSON in entrata hanno una versione?**
No. Amazon Web Services (AWS) non supporta il controllo delle versioni dei file. APN Customer Engagement (ACE) elabora il file immediatamente dopo la ricezione, quindi lo elimina una volta completata l'elaborazione. Se riceviamo nuovamente lo stesso nome di file, viene rifiutato.
**D: Quali campi del file JSON di Amazon Simple Storage Service (Amazon S3) indicano la data di creazione e l'ultimo aggiornamento di un particolare lead e opportunità?**
`createdDate` e `lastModifiedDate`.
**D: Come si determina se un'opportunità è nuova o esistente?**
Il campo `PartnerCrmUniqueIdentifier` è un identificatore univoco per ogni opportunità che richiediamo al partner. Questo identificatore deve essere definito nel CRM di origine del sistema del partner. Lo usiamo per determinare se esiste un'opportunità in. AWS Se esiste, aggiorniamo l'opportunità con le informazioni condivise. In caso contrario, creiamo una nuova opportunità.
Quando inviamo dati al partner, includiamo entrambi `PartnerCrmUniqueIdentifier` e`apnCrmUniqueIdentifier`. Se l'opportunità condivisa da AWS viene inviata per la prima volta, non vedrai alcun valore per`PartnerCrmUniqueIdentifier`. Questo ti aiuta a considerare l'opportunità come nuova offerta da ACE. Dopo averlo inserito nel tuo CRM, ci invii gli aggiornamenti con entrambi `PartnerCrmUniqueIdentifier` e. `apnCrmUniqueIdentifier`
**D: È possibile avere più di un file JSON in uscita e di risultato in Amazon S3?**
Sì. A volte possiamo generare più file nella cartella in uscita. Allo stesso modo, se invii file alla cartella in entrata, li elaboriamo e conserviamo i file dei risultati nella cartella dei risultati. È necessario etichettare o eliminare i file dei risultati dopo l'elaborazione.
**D: Il file in uscita contiene più di un record?**
Sì. Il file in uscita può contenere più record.
**D: Se vengono inviate 20 opportunità in entrata in un unico file JSON di input nella sezione opportunità e una delle opportunità non è conforme allo standard APN, cosa succede?**
Se il formato non è corretto, indipendentemente dal caso, l'intero file viene rifiutato. Se il formato è corretto ma non è possibile elaborare solo un'opportunità da parte nostra, il file dei risultati include tutte le 20 opportunità e il relativo stato, oltre al messaggio di errore relativo all'opportunità non riuscita.
**D: Quali sono gli attributi chiave da verificare se il file JSON è stato elaborato correttamente?**
Questi sono gli attributi chiave che consentono di capire se il file JSON è stato elaborato correttamente.
```
{
"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
}
]
}
```
**D: Cosa succede se invio un codice JSON non valido?**
Riceverai questa risposta di errore: "non `[{input JSON}]` è di tipo`object`».
**D: Quanti lead/opportunity record possono essere inclusi in un singolo file JSON in entrata?**
Un massimo di 50 record possono essere contenuti in un unico file.
# Domande frequenti tecniche: Amazon S3
**D: Dove posso trovare la documentazione dell'API REST di Amazon Simple Storage Service (Amazon S3)?**
Per ulteriori informazioni, consulta l'introduzione all'[API REST di Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html).
**D: Come posso ottenere i dettagli chiave di Amazon Web Services AWS Key Management Service (AWS KMS) per l'autenticazione per accedere al bucket Amazon S3?**
AWS Partner Network (APN) condivide una policy che include il nome della chiave.
**D: Come posso autenticare Amazon S3 da Salesforce.com (SFDC)?**
Utilizza il file di codice di esempio [S3\$1Authentication.cls per autenticare](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls) Amazon S3 da SFDC.
**D: Come faccio a caricare il file dal kit di sviluppo software (SDK) su S3? AWS **
Usa il seguente comando AWS CLI per caricare il file su S3.
```
aws s3 cp example.json s3://awsexamplebucket/opportunity- inbound/filename.json --acl bucket-owner-full-control
```
Il file di codice di esempio [Sample\$1 AceOutboundBatch .cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls) contiene il codice per caricare il file di dati da SFDC.
**D: Chi possiede il bucket Amazon S3?**
AWS possiede e gestisce il bucket Amazon S3. Hai accesso programmatico al tuo bucket Amazon S3 con AWS Identity and Access Management l'utente (IAM).
**D: Esistono cartelle o bucket separati per la ricezione e l'invio di file?**
C'è un bucket con diverse cartelle per ricevere e inviare i file. Consulta la guida per l'utente per ulteriori dettagli sulle cartelle.
**D: Devo accedere al bucket Amazon S3 utilizzando o posso accedervi direttamente utilizzando AWS Lambda il sistema di gestione delle relazioni con i clienti (CRM)?**
Puoi accedervi in entrambi i modi.
**D: Il bucket Amazon S3 è protetto o crittografato?**
Sì. Abilitiamo il meccanismo di crittografia predefinito offerto da Amazon S3.
**D: È possibile abilitare Amazon Simple Notification Service (Amazon SNS) ad ascoltare il bucket Amazon S3, in modo da poter agire solo in base all'evento, anziché effettuare sondaggi periodici?**
No. Attualmente, APN Customer Engagement (ACE) non supporta questa funzionalità.
**D: A quali cartelle ho accesso e qual è lo scopo di ciascuna cartella?**
Puoi trovare l'elenco delle cartelle Amazon S3 in. [Prerequisiti per l'integrazione](crm-integration-setting-up.md)
# Domande frequenti tecniche: lead e opportunità
## Invia e ricevi lead e opportunità
**D: Esiste una convenzione per la denominazione dei file?**
Ogni nome di file deve essere unico. Consigliamo il nome del file`PartnerProvided FileName+{timestamp}.json`.
**D: Qual è la struttura dei risultati?**
I file di esempio dei risultati (operazione riuscita ed errore) possono essere scaricati dai seguenti percorsi:
+ [Lead Results Success Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)
+ [Opportunità, risultati, successo, Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
+ [Ottieni risultati con errori Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results_With-Errors-Sample.json)
+ [Risultati delle opportunità con errori Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results_With-Errors-Sample.json)
**D: Qual è la convenzione di denominazione dei risultati?**
`PartnerProvidedFileName_result.json`
**D: Cosa succede se invio un secondo file JSON con lo stesso nome?**
Il file non verrà elaborato e il file verrà spostato nella cartella di archivio.
**D: Qual è il limite di dimensione dei file in entrata?**
Il limite di dimensione del file in entrata è di 1 MB.
**D: Esiste un numero massimo di opportunità e lead che possono essere raggruppati in un unico file JSON?**
Dato il limite di 1 MB, ti consigliamo di avere un'opportunità o un lead per file.
**D: Ricevo un messaggio di errore di accesso negato, quindi non riesco a caricare i file. Cosa devo fare?**
I partner ricevono un messaggio di *accesso negato* per due motivi.
1. Hai caricato il file nella `outbound` cartella anziché nella `inbound` cartella. Carica il file nella `inbound` cartella.
1. È necessario fornire una lista di controllo degli accessi (ACL). Utilizza il seguente comando CLI di Amazon Web Services (AWS) per caricare il file di dati:
```
aws s3 cp example.json s3://awsexamplebucket --acl bucket-owner-full-control
```
**D: Cosa succede se vengono caricati file con estensioni come `.pdf``.docx`, o qualcosa di diverso`.json`?**
Rifiutiamo i file e generiamo un `*.error.json` file con i dettagli del motivo.
**D: Cosa devo fare dopo aver ricevuto un messaggio di errore relativo a un problema di dati durante la produzione?**
1. Se i dati devono essere corretti nel sistema CRM (Customer Relationship Management) del partner, dopo averli corretti, invia il file modificato ad Amazon Simple Storage Service (Amazon S3).
1. Se hai bisogno di chiarimenti sui dati, contatta il tuo Partner Development Manager (PDM).
1. Per qualsiasi altro tipo di supporto tecnico, invia una richiesta di assistenza AWS Partner Network (APN) nel portale APN.
**D: Dove posso trovare i file dei risultati e per quanto tempo sono disponibili?**
I file dei risultati si trovano nelle `opportunity-inbound-results` cartelle `lead-inbound-results` and. Sono disponibili finché non li elimini. È possibile eliminare i file dopo aver eseguito correttamente l'estrazione.
**D: Se ho bisogno di trovare un file dei risultati dopo averlo eliminato, dove possiamo trovarlo?**
Puoi trovare i file dei risultati nelle `opportunity-inbound-results-archive/YYYY/MM/DD` cartelle `lead-inbound-results-archive/YYYY/MM/DD` and.
**D: Se si verifica un errore nell'elaborazione del file da parte di APN, come posso ricevere una notifica?**
APN dispone di allarmi che creano automaticamente ticket Sev2 per tenere traccia degli errori di elaborazione. Li esaminiamo, risolviamo e li comunichiamo ai partner.
**D: Quali campi possono essere aggiornati dopo il lancio dell'opportunità?**
I seguenti campi possono essere aggiornati solo da Independent Software Vendor (ISV) Accelerate Partners:
+ `isThisForMarketplace`
+ `isNetNewBusinessForCompany`
+ `deliveryModel`
+ `awsFieldEngagement`
+ `additionalComments`
**D: Ho ricevuto un errore *Record not editable*. Cosa significa?**
Quando invii un'opportunità presentata a un nuovo partner, questa viene sottoposta a un processo di convalida e il team APN Customer Engagement (ACE) deve approvarla o rifiutarla. Sebbene l'opportunità sia in fase di revisione e non sia stata ancora convalidata, non puoi aggiornare il record e ricevi questo errore.
**D: Cosa succede se non c'è alcuna attività da parte mia (esempio: non sto elaborando il file o non sto inviando alcuna opportunità in entrata)?**
Se non invii alcuna informazione o non stai elaborando i file che forniamo, al momento non disponiamo di un meccanismo per avvisarti. Ti invitiamo a monitorare il tuo sistema per assicurarti che le informazioni arrivino ad APN.
**D: Dopo quanto tempo i risultati JSON saranno disponibili nella cartella dei risultati dopo l'invio di un'opportunità/lead in entrata? new/updated **
L'elaborazione è quasi in tempo reale. Dovresti ricevere i file in meno di cinque minuti.
**D: Se invio un CRM per opportunità in entrata che non è conforme alla format/length restrizione dello standard APN, come lo gestisce il sistema? Genera la segnalazione degli errori?**
Se il file non è nel formato di definizione del campo, il file dei risultati di APN richiama il file.
**D: Non ho un ID AWS account al momento del lancio. Cosa devo fare?**
Secondo il processo ACE, `Launched` significa che il carico di lavoro è stato completato e la fatturazione è iniziata. Ciò richiede un ID AWS account. Per ulteriori informazioni, consulta il [programma ACE FAQs](https://partnercentral.awspartner.com/partnercentral2/s/resources?Id=0690h000003xjjXAAQ).
**D: Dopo lo User Acceptance Testing (UAT), come devono essere gestiti i dati storici durante il passaggio alla produzione?**
Per impostazione predefinita, quando vengono effettuati aggiornamenti in ACE, inviamo tali opportunità al bucket Amazon S3. Per i dati storici che non desideri elaborare, devi fornire loro valori fittizi, ad esempio `X0001, X0002….X000N` nell'estratto, per ciò che non desideri elaborare nel tuo sistema. `partnerCrmUniqueIdentifier` È necessario scrivere codice per riconoscere questi identificatori ed elaborarli di conseguenza. Il resto delle opportunità fornisce il `partnerCrmUniqueIdentifier` valore corretto. Ciò garantisce il pieno controllo su cosa elaborare e cosa non elaborare nel sistema.
**D: Il file in uscita contiene più di un record?**
Sì. Il file in uscita può contenere più di un record.
**D: Perché i dati *inviano Accept alla visualizzazione* di alcuni campi?**
Per un'opportunità o un lead AWS segnalato, tutti i campi PII sono mascherati con l'etichetta *Accept per essere visualizzati fino a* quando l'opportunità o il lead non vengono accettati dall'utente. Una volta accettati, riceverai tutti i campi dati nel ciclo di sincronizzazione successivo.
**D: Cosa devo fare quando una nuova opportunità o lead AWS segnalato viene sincronizzato per la prima volta?**
Quando una nuova opportunità o lead viene sincronizzato per la prima volta, devi accettarlo o rifiutarlo per ottenere dati aggiuntivi (ad esempio: contatti con i clienti).
## Creazione e aggiornamento di opportunità/lead
**D: Come posso inserire nuove opportunità offerte dai *partner (originate)* in ACE attraverso l'integrazione?**
Per creare nuove opportunità in ACE attraverso l'integrazione, è necessario inserire nella cartella le informazioni sulle opportunità richieste nel formato JSON definito. `opportunity-inbound` AWS elabora queste informazioni, crea una nuova opportunità in ACE e condivide i risultati di un'operazione di successful/failed creazione nella `opportunity-inbound-processed-results` cartella.
**D: In che modo l'integrazione distingue tra l'invio di nuove opportunità e gli aggiornamenti?**
Il campo `PartnerCrmUniqueIdentifier` relativo a ciascuna opportunità è un identificatore univoco obbligatorio. Questo identificatore deve essere definito nel CRM di origine del sistema. AWS lo utilizza per determinare se esiste già un'opportunità in ACE. Se è disponibile in ACE, utilizziamo le informazioni condivise per aggiornare l'opportunità, ma se non sono disponibili in ACE, utilizziamo le informazioni condivise per creare una nuova opportunità.
**D: Se ho già implementato la funzionalità di aggiornamento tramite l'integrazione, cosa devo fare per utilizzare l'integrazione per presentare (creare) nuove opportunità?**
È necessario apportare le seguenti modifiche all'integrazione esistente:
1. Inizia a inserire nuove opportunità di creazione nella cartella`opportunity-inbound`. Fornisci aggiornamenti nella stessa cartella.
1. Assicurati che i campi obbligatori richiesti per la creazione siano disponibili nell'Opportunity JSON shared.
1. Verifica che ogni nuova opportunità ne abbia un'unica `PartnerCrmUniqueIdentifier` che non esiste in ACE/Partner Central. Un'importante best practice per il go-live consiste nel mappare e aggiornare i dati esistenti in ACE per ciascuno del tuo CRM, `PartnerCrmUniqueIdentifier` in modo da non creare duplicati quando riceviamo gli aggiornamenti. Per assistenza, contatta ACE.
**D: Nell'ambito del processo di attivazione, come posso aggiornare le opportunità esistenti in ACE con le mie? `PartnerCrmUniqueIdentifier`**
Il team ACE ti fornisce un elenco di tutte le opportunità aperte per aiutarti a prepararti al lancio della produzione. È necessario mappare queste opportunità esistenti in ACE alle rispettive `PartnerCrmUniqueIdentifier` e restituire il file aggiornato ad ACE per l'integrazione nel CRM AWS di ACE.
Se scegli di sincronizzare solo un sottoinsieme delle AWS opportunità offerte, devi sviluppare una logica per aggirare AWS gli aggiornamenti per tutte le opportunità che non desideri elaborare. Questo approccio dovrebbe essere applicato anche alle opportunità future, dopo l'onboarding. È necessario fornire le opportunità associate che richiedono `partnerCrmUniqueIdentifier` un allineamento tra entrambe. CRMs Inoltre, devi indicare quali opportunità non aggiornerai (ad esempio: contrassegnare le opportunità chiuse perse o vinte) per escluderle dagli aggiornamenti. È importante che a tutte le opportunità aperte/attive che condividi e che accetti venga AWS assegnato un. `partnerCrmUniqueIdentifier`
**D: Posso aggiornare solo campi specifici nell'opportunità o nel lead?**
Sì. Puoi fornire solo i campi che richiedono aggiornamenti, insieme agli identificatori necessari.
**D: È possibile modificare il *ApnCrmUniqueIdentifier***?
No. Questo identificatore rimane costante AWS e identifica in modo univoco ogni opportunità.
**D: Cosa succede se fornisco un** *identificatore errato? partnerCrmUnique*
Se si fornisce un identificatore errato, viene creata una nuova opportunità. Garantisci l'accuratezza per evitare la duplicazione dei dati.
**D: Posso aggiornare le opportunità AWS inviate?**
Sì. Puoi aggiornare le opportunità AWS inviate utilizzando il codice corretto`partnerCrmUniqueIdentifier`.
**D: Entro quanto tempo posso aspettarmi i risultati delle opportunità presentate?**
L'elaborazione è quasi in tempo reale e i risultati sono generalmente disponibili entro pochi minuti nella `opportunity-inbound-processed-results` cartella.
**D: Cosa devo fare in caso di errori di elaborazione per le opportunità inviate?**
Controlla i dettagli degli errori nei file dei risultati, risolvi i problemi e richiedi ulteriore assistenza al team di supporto ACE.
**D: Posso eliminare un'opportunità tramite l'integrazione?**
No. L'eliminazione diretta non è supportata. È possibile aggiornare un'opportunità in modo che rifletta lo stato *Chiuso*.
**D: Cosa significa l'errore *Record non modificabile*?**
Questo errore si verifica se si tenta di aggiornare un'opportunità in ACE Review. Queste opportunità non possono essere modificate fino alla convalida.
**D: Cosa succede se non invio aggiornamenti o nuove opportunità?**
Nessun nuovo dato viene ricevuto ed elaborato se non invii aggiornamenti o nuove opportunità tramite l'integrazione.
**D: Per quanto tempo sono disponibili i file dei risultati?**
I file dei risultati sono disponibili per un periodo di tempo ragionevole. È necessario recuperarli e gestirli tempestivamente.
# Domande frequenti tecniche: controllo delle versioni e compatibilità con le versioni precedenti
**D: Cos'è un payload nello scambio di dati di Amazon Web Services (AWS)?**
Un payload è un dato strutturato formattato in JSON, inviato in entrata o in uscita da. AWS AWS*Ogni chiave in questa struttura JSON viene definita campo e ogni *campo* ha un valore associato.*
**D: Come viene determinata la versione del payload?**
La versione del payload è specificata nel `version` campo del payload stesso. I payload che aderiscono alla definizione di campo v13 sono considerati Payload versione 1.0, mentre quelli che seguono il formato definito nella definizione del campo v14 o superiore sono denominati Payload Version 2.0.
**D: Cosa significa compatibilità con le versioni precedenti in questo contesto e come viene gestita?**
La compatibilità con le versioni precedenti garantisce che le opportunità esistenti non vengano meno quando vengono introdotti nuovi campi obbligatori nelle versioni più recenti del payload. AWS mantiene ciò assegnando automaticamente i valori predefiniti ai campi richiesti nella nuova versione. Potresti notare nell'interfaccia utente AWS Partner Network (APN) Customer Engagement (ACE) dei valori che non hai fornito esplicitamente tramite l'integrazione Customer Relationship Management (CRM). I dettagli e le condizioni di ogni campo sono spiegati nella descrizione del campo o nei dettagli aggiuntivi sul campo.
**D: La compatibilità con le versioni precedenti è una funzionalità permanente?**
No La compatibilità con le versioni precedenti è limitata nel tempo, progettata per offrire la flessibilità necessaria per pianificare e implementare le modifiche imminenti. Smette di funzionare oltre una data limite specificata, che sarà annunciata più avanti nel corso dell'anno come parte di un lancio più ampio.
**D: Cosa succede quando inizio a inviare payload con la versione 2.0?**
Una volta inviato un payload con la versione 2.0, il sistema presuppone che tutte le modifiche necessarie siano state implementate e le convalide per la nuova versione del payload si applicano a tutte le modifiche successive. È essenziale non implementare le funzionalità parzialmente tra i payload della versione 1.0 e della versione 2.0.
**D: Posso tornare alla versione 1.0 del payload dopo l'aggiornamento alla versione 2.0?**
No. La transizione alla versione 2.0 del payload è un processo unidirezionale. Una volta effettuato l'aggiornamento alla versione 2.0, non è possibile tornare alla versione 1.0 del payload.