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à.
Aggiornamento da Amazon S3 all'integrazione API-based
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 e Nozioni di base precedenti di questa guida.
Consigliato: completate prima queste attività in un ambiente sandbox, testatele accuratamente e poi distribuitele in produzione.
Questa sezione illustra come aggiornare il tuo AWS Partner CRM Connector da Amazon all'integrazione. S3-based API-based L' API-based integrazione sostituisce il precedente modello di bucket Amazon S3 con la sincronizzazione bidirezionale in tempo reale tramite ruoli e API IAM.
Per una procedura dettagliata completamente interattiva con schermate, consulta il workshop sull'aggiornamento di AWS Partner CRM Connector sul sito Web di AWS Workshops.
L'aggiornamento prevede i seguenti passaggi:
Prerequisiti
Ordine delle operazioni di migrazione
I partner spesso chiedono se migrare alla nuova esperienza Partner Central nella AWS Console o eseguire prima l'aggiornamento da Amazon S3 all'API. Ecco l'approccio consigliato:
| Scenario | Raccomandazione |
|---|---|
| Attualmente su Amazon S3, non ancora disponibile una nuova esperienza con Partner Central | Effettua prima la migrazione all'API, quindi alla nuova esperienza di Partner Central in parallelo o successivamente |
| Attualmente su Amazon S3, sto già utilizzando una nuova esperienza con Partner Central | Procedi direttamente con la migrazione delle API |
| Sei già attivo sull'API, non ancora sulla nuova esperienza con Partner Central | Effettua la migrazione alla nuova esperienza Partner Central quando preferisci |
Il collegamento dell'account è l'unico prerequisito fondamentale
Il collegamento degli account è l'unico prerequisito fondamentale per la migrazione ad Amazon. S3-to-API La migrazione alla nuova esperienza Partner Central NON è necessaria per avviare l'aggiornamento dell'API.
Informazioni chiave:
S3-based Le integrazioni Amazon sono obsolete e non sono più disponibili per i nuovi utenti.
I partner su Amazon S3 dovrebbero pianificare di completare la migrazione all'API il prima possibile per evitare il degrado del servizio.
Consulta la documentazione sull'integrazione del CRM per i AWS partner per la cronologia più recente sulla fine del ciclo di vita del backend di Amazon S3.
Assicurati che Partner Central sia collegato a un AWS account
Il S3-based connettore Amazon è stato autenticato utilizzando le autorizzazioni per un bucket Amazon S3 gestito nell'account di gestione. AWS Il API-based connettore si autentica invece tramite i ruoli IAM sull' AWS account collegato del partner per chiamare direttamente le API di Partner Central. Ecco perché il collegamento degli account è il prerequisito tecnico fondamentale: senza di esso, il connettore non ha modo di raggiungere le API di Partner Central con le autorizzazioni necessarie.
Perché questo potrebbe mancare
Quando è AWS stata rilasciata l'API Partner Central per la vendita nel novembre 2024, è stato introdotto il collegamento degli account per consentire ai partner di accedere a queste API in modo programmatico. A partire dalla versione 3.0 del connettore (anch'essa a novembre 2024), il collegamento dell'account è diventato un requisito per la sincronizzazione. API-based I partner che hanno configurato il proprio S3-based connettore Amazon prima di questa data non avrebbero completato il collegamento dell'account.
Collega il tuo account Partner Central al tuo AWS account principale. Scegli il tuo account con attenzione sin dall'inizio. Sebbene sia possibile scollegare e ricollegare un altro account, ciò crea problemi di persistenza dei dati e richiede interventi manuali di riconciliazione.
Regole di selezione dell'account: l'account deve essere: AWS
Un account a pagamento in regola (non Free Tier)
Di proprietà dell'azienda del partner (non dell'account di un distributore)
Disponi di un indirizzo di fatturazione corrispondente alla sede principale dell'attività del partner
NON sei una sandbox, uno sviluppatore, un account personale o un account management/payer
Il collegamento all'account è permanente
Il collegamento dell'account è permanente dopo la migrazione di Partner Central alla AWS Console. Tutte le risorse APN (opportunità ACE, cronologia, inviti con più partner) sono permanentemente collegate a questo account. Scegli con attenzione.
Risorse:
Sezione Account Linking del workshop di aggiornamento
sul sito web di AWS Workshops Scollegare gli account
sul sito Web di Partner Central
Facoltativo: esegui la migrazione alla nuova esperienza Partner Central in AWS Console
Questo passaggio non è richiesto per l'aggiornamento del S3-to-API connettore Amazon. Il solo collegamento dell'account fornisce le API-based funzionalità necessarie. Tuttavia, la migrazione alla nuova esperienza Partner Central consente al team di accedere a funzionalità aggiuntive:
Agenti di Partner Central (Co-Sell agente, agente di finanziamento, prospezione autonoma)
Un'esperienza di AWS console centralizzata per la gestione delle attività dei partner insieme alle tue risorse AWS
Maggiore visibilità sugli eventi del ciclo di vita delle opportunità direttamente nella console
Modifica del formato dell'ID della soluzione
Se esegui la migrazione alla nuova esperienza Partner Central e poi crei nuove soluzioni, tali soluzioni utilizzeranno il nuovo soln-* formato. Il connettore CRM non supporta ancora questo formato; richiede il S-* formato precedente per il solutionOffered campo. Le soluzioni precedenti create prima della migrazione mantengono il S-* formato e continuano a funzionare.
Per maggiori dettagli, consulta la guida alla migrazione di Partner Central.
Pre-migration pulizia dei dati
Prima di iniziare la migrazione, assicurati di aver completato l' S3-basedintegrazione con Amazon. Il passaggio più critico è la rimozione dei lavori programmati persistenti che possono interferire con il API-based connettore e il processo di backfill.
Quando si disattivano le pianificazioni di Amazon S3 tramite l'interfaccia utente del connettore, i processi pianificati Salesforce sottostanti (con prefisso APN) rimangono nel sistema. Se sono ancora presenti quando avvii il backfill o abiliti la API-based sincronizzazione, sia il vecchio scheduler che il nuovo connettore potrebbero scrivere sugli stessi record contemporaneamente, causando la creazione di opportunità duplicate o conflitti di dati.
La disattivazione nell'interfaccia utente non è sufficiente
La disattivazione delle pianificazioni nell'interfaccia utente del connettore non è sufficiente. È inoltre necessario eliminare le voci sottostanti del lavoro pianificato in Salesforce Setup. Consulta Rivedi e disabilita le pianificazioni per Amazon S3 la procedura dettagliata completa.
Configurazione AWS infrastruttura
Questa fase richiede che un amministratore di Salesforce collabori con un amministratore IT Cloud per configurare due nuovi componenti: un'app client esterna Salesforce e componenti dell' AWS infrastruttura (EventBridge regole e ruoli IAM).
Configura l'app Salesforce External Client
Con la versione Amazon S3, entrambe le direzioni di sincronizzazione sono passate attraverso un bucket Amazon S3 condiviso per partner. La versione API lo ribalta per gli aggiornamenti in entrata: Partner Central ora invia gli eventi direttamente alla tua organizzazione in tempo reale tramite. EventBridge L'app client esterna abilita un flusso di credenziali client OAuth 2.0 in modo da poter inviare notifiche non appena EventBridge si verificano.
L'amministratore di Salesforce deve seguire le istruzioni nella sezione Configurazione dell'app client esterno su Salesforce
Configurazione AWS componenti
L' AWS infrastruttura per la versione API include:
EventBridgeper l'elaborazione degli eventi in tempo reale
ruoli IAM per l'autenticazione sicura
Questi componenti sostituiscono il modello di accesso ai bucket di Amazon S3 utilizzato nella versione precedente.
L'IT Cloud Admin deve distribuire il CloudFormation modello seguendo le istruzioni nella sezione
Finalizza l'installazione e la configurazione all'interno di Salesforce
La configurazione rimanente viene eseguita da un amministratore di Salesforce. Completa prima le attività in Sandbox, esegui il test, quindi passa alla produzione.
Installa la versione più recente di AWS Partner CRM Connector da Salesforce AppExchange
Rivedi e modifica le tue mappature
Nella versione Amazon S3, la sincronizzazione in uscita si basava sui campi and. Sync with AWS Has Updates for AWS Questi non vengono più utilizzati nell'integrazione. API-based
Con la versione API, la sincronizzazione in uscita è controllata tramite l'impostazione Abilita condivisione con AWS integrazione nelle impostazioni personalizzate di AWS
Partner CRM Connector ()Companion_App_Settings__c. Se abilitata, le opportunità ACE vengono condivise automaticamente AWS ogni volta che si verifica un aggiornamento idoneo.
Punti chiave:
L'oggetto ACE Opportunity è consigliato come area di atterraggio: corrisponde ai dati sulle AWS opportunità in Partner Central e consente la mappatura automatica.
Se stavi già utilizzando ACE Opportunity per la mappatura dell'integrazione, la configurazione sottostante non cambia. Tuttavia, il pacchetto aggiornato introduce nuovi campi non presenti nelle versioni precedenti.
Controlla tutte le automazioni che fanno riferimento ai vecchi S3-era campi Amazon (
Sync_with_AWS__c,Has_Updates_for_AWS__c) per utilizzare i nuovi equivalenti.
Il modello di dati ACE Opportunity è disponibile sul sito web. GitHub
L'ultima versione del connettore include un modello di flusso per aiutarti a mappare l'opportunità standard rispetto all'opportunità ACE. Per maggiori dettagli, consulta i modelli di flusso.
Rivedi e aggiungi i campi e i pulsanti obbligatori
Il connettore ha introdotto nuovi campi e pulsanti a partire dalla versione 3.0+. È necessario aggiornare manualmente il layout della pagina Lightning Record.
Aggiungi i seguenti pulsanti alla pagina ACE Opportunity Lightning Record:
| Button | Scopo |
|---|---|
| Condividi con AWS | Invia manualmente l'opportunità a Partner Central tramite API. |
| Aggiorna da AWS | Raccoglie i dati più recenti di Partner Central in questo record ACE Opportunity. |
| Accept/Reject | Accetta o rifiuta le opportunità AWS segnalate. |
| Associate/Disassociate | Collega o scollega le soluzioni, i prodotti e le offerte del Marketplace AWS approvati dai partner. |
| Assign | Riassegna un'opportunità a un altro utente nel tuo account Partner Central. |
Rimuovi i seguenti pulsanti precedenti dalla pagina dei record dei fulmini di ACE Opportunity:
| Button | Motivo |
|---|---|
| Invia a AWS | Sostituito da Condividi con AWS. |
| Link: offerta privata | Sostituito da Associate/Disassociate. |
Aggiungi i seguenti pulsanti di visualizzazione dell'elenco alla scheda ACE Opportunity:
Accetta opportunità: Bulk-accept più opportunità AWS segnalate.
Assegna opportunità: Bulk-reassign molteplici opportunità.
Per i nuovi campi, controlla tutti i campi aggiunti dopo la versione 3.0 di Connector
Rivedi e disabilita le pianificazioni per Amazon S3
Con API-based questo approccio, non sono più necessari lavori pianificati: l'integrazione viene eseguita in tempo reale.
Per disattivare i lavori pianificati
Vai alla scheda Pianificazioni all'interno dell'app AWS Partner CRM Connector.
Scegli Disattiva tutti i lavori, quindi scegli nuovamente Disattiva.
Elimina anche i record pianificati. Per rimuovere i lavori pianificati APN rimanenti dal programma di installazione:
Per rimuovere i lavori pianificati APN dal programma di installazione
Vai a Configurazione. Cerca «Pianificato» e seleziona Lavori pianificati.
Controlla l'elenco per eventuali APN-related lavori. Scegli Del per eliminarli.
Continua a CustomLogInteractionBatch correre
Mantieni il CustomLogInteractionBatch lavoro in esecuzione (AppExchange App Analytics).
Elimina i lavori pianificati, non limitarti a disattivarli
Non lasciate i lavori nello stato «disattivati ma non eliminati». I lavori persistenti hanno causato la creazione di opportunità duplicate se combinati con API-based la sincronizzazione in tempo reale.
Pulizia
Disattiva le regole di convalida precedenti
Diverse regole di convalida precedenti devono essere disattivate e altre devono rimanere attive. Consulta questa sezione del workshop
Assicurati inoltre che i seguenti flussi precedenti siano stati disattivati:
Sincronizza ACE Opportunity con l'API Partner Central
Ricerca di offerte private
Notifica di errore di sincronizzazione APN
Aggiornamento del campo Offerta privata su ACE Opportunity
Aggiornamento del campo Opportunity Ace nel Sync Log Detail Record
Unified Standard-ACE Opportunity Sync Flow (modello)
Metti alla prova il tuo processo prima di passare alla produzione. Guarda i test dalle impostazioni
Rifornimento completo delle opportunità da AWS a Salesforce
Esegui un backfill per garantire la corrispondenza dei dati tra gli ambienti. Il awsapn__Last_Modified_Date__c campo su ACE Opportunity deve corrispondere alla data dell'ultima modifica in Partner Central per la sincronizzazione degli aggiornamenti futuri. L'integrazione con Amazon S3 non ha compilato questo campo, quindi le opportunità di migrazione da Amazon S3 lo lasceranno vuoto: il backfill lo riempie.
Il backfill offre tre modalità:
| Modalità | Cosa fa | Quando utilizzarlo |
|---|---|---|
| Aggiorna solo le opportunità mancanti della data dell'ultima modifica | Aggiorna solo i record in cui awsapn__Last_Modified_Date__c è vuoto | Consigliato per la S3-to-API migrazione ad Amazon |
| Solo AWS le opportunità di aggiornamento già esistenti in Salesforce | Aggiorna tutti i record che hanno già un ID APN CRM | Alternativa sicura per la migrazione |
| Aggiorna tutte le opportunità AWS | Inserisce l'intera pipeline di Partner Central in Salesforce | Da utilizzare solo su nuove installazioni |
Prima di eseguire il backfill:
Conferma che tutti i lavori pianificati APN siano eliminati (non solo disattivati).
Disattiva il flusso «Sync ACE Opportunity to Partner Central API», se attivo.
Disattiva Abilita condivisione con AWS integrazione nelle impostazioni personalizzate (
Companion_App_Settings__c).Completa la pulizia dei dati prima della migrazione descritta in. Pre-migration pulizia dei dati
Al termine del backfill:
Re-enable Abilita Condividi con AWS integrazione: questo favorisce la sincronizzazione continua.
Il flusso «Sync ACE Opportunity to Partner Central API» NON deve essere riattivato.
Verifica un campione di record per confermare che
awsapn__Last_Modified_Date__csia compilato.
Per maggiori dettagli, consulta la sezione
Post-migration: Monitoraggio degli eventi EventBridge
Dopo la migrazione, la tua organizzazione Salesforce riceve aggiornamenti in tempo reale da Partner Central tramite. EventBridge Per verificare che gli eventi scorrano:
CloudWatch Metriche: vai a CloudWatch > Metriche >. EventBridge Controlla le invocazioni e FailedInvocations la destinazione dell'API.
Registri di sincronizzazione di Salesforce: su qualsiasi ACE Opportunity, controlla l'elenco relativo al registro di sincronizzazione per le voci in entrata recenti.
EventBridge Monitoraggio delle regole: controlla la regola creata dal CloudFormation modello per gli eventi corrispondenti recenti.
| Caratteristiche | Causa probabile | Risoluzione |
|---|---|---|
| Nessun aggiornamento in entrata in Salesforce | Il token esterno dell'app client è scaduto | Re-authenticate l'app connessa; verifica le credenziali OAuth in API Destination EventBridge |
| Gli eventi si interrompono dopo il lavoro | Timeout della sessione Salesforce | Verifica lo stato di integrità della destinazione dell'API; EventBridge riconnettiti |
| Aggiornamenti parziali (mancano alcuni campi) | Mancata corrispondenza nella mappatura dei campi | Aggiornamento alla versione più recente del connettore; verifica le mappature dei campi |
Risoluzione dei problemi di migrazione più comuni
| Errore/sintomo | Causa principale | Risoluzione |
|---|---|---|
FIELD_CUSTOM_VALIDATION_EXCEPTIONquando si fa clic su «Aggiorna da AWS» | Le regole di convalida precedenti non sono disattivate | Disattiva e ACEOppNew_PreventUpdatesWhenPOSubmitted ACEOpp_PreventUpdatesWhenPOSubmitted |
| Opportunità duplicate | Lavori programmati persistenti o più utenti di integrazione | Elimina TUTTI i lavori pianificati APN. Verifica che solo un utente sia in grado di accettarlo. APN Business Admin |
| I record dei log di sincronizzazione crescono rapidamente | I record non superati vengono convalidati e riprovati a ogni ciclo | Identifica i record non riusciti tramite i registri di sincronizzazione. Correggi i campi obbligatori mancanti. |
| Il backfill supera i limiti di archiviazione | Troppi record contemporaneamente | Esegui in batch più piccoli. Archiviazione del monitor. |
| «Aggiorna da AWS" mostra dati obsoleti | awsapn__Last_Modified_Date__cmancata corrispondenza | Re-run backfill mirato utilizzando «Solo le opportunità di aggiornamento prive della data dell'ultima modifica» |
| Le opportunità offerte da Partner Central non vengono visualizzate | EventBridge problema di connessione o condivisione automatica disabilitata | Verifica lo stato EventBridge dell'API Destination. Conferma che «Abilita condivisione con AWS integrazione» sia abilitato. |
Utilizzo della guida
Se riscontri problemi che i passaggi precedenti non possono risolvere:
Apri un caso di supporto: Partner Central → Supporto → Apri un nuovo caso
→ Integrazione CRM Assistenza alla migrazione: per migrazioni complesse (oltre 500 opportunità, integrazioni personalizzate o precedenti incidenti di produzione), richiedi un'assistenza completa tramite Alliance Lead.
