Integrazione con Salesforce integrating-with-salesforce
L’integrazione di Salesforce con Adobe Experience Manager (AEM) fornisce funzionalità di gestione dei lead e utilizza le funzionalità esistenti fornite da Salesforce. Puoi configurare AEM per pubblicare i lead in Salesforce e creare componenti che accedono ai dati direttamente da Salesforce.
L’integrazione bidirezionale ed estensibile tra AEM e Salesforce consente di:
- Organizzazioni che utilizzano e modificano completamente i dati per migliorare l’esperienza del cliente.
- Coinvolgimento dalle attività di marketing alle attività di vendita.
- Organizzazioni per la trasmissione e la ricezione automatica di dati da un datastore Salesforce.
Questo documento descrive quanto segue:
- come configurare Salesforce Cloud Services (configurare AEM per l’integrazione con Salesforce).
- come utilizzare le informazioni sui contatti/lead di Salesforce in ClientContext e per Personalization.
- come utilizzare il modello di flusso di lavoro di Salesforce per pubblicare gli utenti AEM come lead in Salesforce.
- come creare un componente che mostra i dati di Salesforce.
Configurazione di AEM per l’integrazione con Salesforce configuring-aem-to-integrate-with-salesforce
Per configurare AEM per l’integrazione con Salesforce, devi prima configurare un’applicazione di accesso remoto in Salesforce. Quindi configurare Salesforce Cloud Service in modo che punti a questa applicazione di accesso remoto.
Per configurare AEM per l’integrazione con Salesforce:
-
In AEM, passa a Cloud Services. In Servizi di terze parti, fare clic su Configura ora in Salesforce.
-
Crea una configurazione, ad esempio sviluppatore.
note note NOTE La nuova configurazione reindirizza a una nuova pagina: http://localhost:4502/etc/cloudservices/salesforce/developer.html. Si tratta esattamente dello stesso valore che è necessario specificare nell'URL di richiamata durante la creazione dell'applicazione di accesso remoto in Salesforce. Questi valori devono corrispondere. -
Accedi al tuo account Salesforce (oppure, se non ne hai uno, creane uno all'indirizzo https://developer.salesforce.com.)
-
In Salesforce, passa a Crea > App per accedere a App collegate (nelle versioni precedenti di Salesforce, il flusso di lavoro era Distribuisci > Accesso remoto).
-
Fai clic su Nuovo per connettere AEM a Salesforce.
-
Immetti Nome app connessa, Nome API e E-mail contatto. Selezionare la casella di controllo Abilita impostazioni OAuth, immettere l'URL richiamata e aggiungere un ambito OAuth (ad esempio, accesso completo). L'URL di callback è simile al seguente:
http://localhost:4502/etc/cloudservices/salesforce/developer.htmlModifica il nome del server/numero di porta e il nome della pagina in modo che corrispondano alla configurazione.
-
Fai clic su Salva per salvare la configurazione di Salesforce. Salesforce crea una chiave consumer e un segreto consumer necessari per la configurazione di AEM.
note note NOTE Attendere alcuni minuti (fino a 15 minuti) per l'attivazione dell'applicazione di accesso remoto in Salesforce. -
In AEM, passa a Cloud Services e passa alla configurazione di Salesforce creata in precedenza, ad esempio sviluppatore. Fai clic su Modifica e immetti la chiave cliente e il segreto cliente da salesforce.com.
table 0-row-2 1-row-2 2-row-2 Url di accesso Questo è l’endpoint di autorizzazione di Salesforce. Il suo valore è precompilato e serve la maggior parte dei casi. Chiave cliente Immettere il valore ottenuto dalla pagina Registrazione applicazione di accesso remoto in salesforce.com Segreto cliente Immettere il valore ottenuto dalla pagina Registrazione applicazione di accesso remoto in salesforce.com -
Fare clic su Connetti a Salesforce per connettersi. Salesforce richiede di consentire alla configurazione di connettersi a Salesforce.
In AEM, viene visualizzata una finestra di dialogo di conferma che informa che la connessione è avvenuta correttamente.
-
Passa alla pagina principale del sito Web e fai clic su Proprietà pagina. Selezionare quindi Servizi cloud, aggiungere Salesforce e selezionare la configurazione corretta, ad esempio sviluppatore.
Ora puoi utilizzare il modello di flusso di lavoro per pubblicare i lead in Salesforce e creare componenti che accedono ai dati da Salesforce.
Esportazione di utenti AEM come lead di Salesforce exporting-aem-users-as-salesforce-leads
Se desideri esportare un utente di AEM come lead di Salesforce, configura il flusso di lavoro per pubblicare i lead in Salesforce.
Per esportare gli utenti di AEM come lead di Salesforce:
-
Passare al flusso di lavoro di Salesforce in
http://localhost:4502/workflowfacendo clic con il pulsante destro del mouse sul flusso di lavoro Salesforce.com Export e scegliendo Start.
-
Seleziona l'utente AEM che desideri creare come lead come Payload per questo flusso di lavoro (home > utenti). Accertati di selezionare il nodo del profilo dell'utente in quanto contiene informazioni come givenName e familyName, mappate ai campi FirstName e LastName del lead Salesforce.
note note NOTE Prima di avviare questo flusso di lavoro, è necessario disporre di alcuni campi obbligatori per un nodo lead in AEM prima di poter pubblicare il flusso di lavoro in Salesforce. Si tratta di givenName, familyName, company e email. Per visualizzare un elenco completo dei mapping tra l'utente di AEM e il lead di Salesforce, vedere Configurazione mapping tra l'utente di AEM e il lead di Salesforce. -
Fare clic su OK. Le informazioni utente vengono esportate in salesforce.com. Puoi verificarlo all’indirizzo salesforce.com.
note note NOTE I registri degli errori mostrano se un lead è importato. Per ulteriori informazioni, consulta il registro degli errori.
Configurazione del flusso di lavoro di esportazione Salesforce.com configuring-the-salesforce-com-export-workflow
Se necessario, configura il flusso di lavoro di esportazione Salesforce.com in modo che corrisponda alla configurazione Salesforce.com corretta o che apporti altre modifiche.
Per configurare il flusso di lavoro di esportazione Salesforce.com:
-
Passa a
http://localhost:4502/cf#/etc/workflow/models/salesforce-com-export.html.
-
Apri il passaggio di esportazione Salesforce.com, seleziona la scheda Argomenti, seleziona la configurazione corretta e fai clic su OK. Inoltre, se si desidera che il flusso di lavoro ricrei un lead eliminato in Salesforce, selezionare la casella di controllo.
-
Fai clic su Salva per salvare le modifiche.
Mappatura della configurazione tra l’utente di AEM e il lead di Salesforce mapping-configuration-between-aem-user-and-salesforce-lead
Per visualizzare o modificare la configurazione di mappatura corrente tra un utente di AEM e un lead di Salesforce, aprire Gestione configurazione: https://<hostname>:<port>/system/console/configMgr e cercare Configurazione mappatura lead di Salesforce.
-
Aprire Configuration Manager facendo clic su Console Web o accedendo direttamente a
https://<hostname>:<port>/system/console/configMgr. -
Cerca Configurazione mappatura lead Salesforce.
-
Modifica le mappature in base alle esigenze. La mappatura predefinita segue il pattern aemUserAttribute=sfLeadAttribute. Fai clic su Salva per salvare le modifiche.
Configurazione dell’archivio ClientContext di Salesforce configuring-salesforce-client-context-store
L’archivio contestuale del client Salesforce mostra informazioni aggiuntive sull’utente attualmente connesso rispetto a quelle già disponibili in AEM. Estrae queste informazioni aggiuntive da Salesforce a seconda della connessione dell’utente con Salesforce.
A questo scopo, configura quanto segue:
- Collega un utente AEM con un Salesforce ID tramite il componente Salesforce Connect.
- Aggiungi i dati del profilo di Salesforce nella pagina di contesto del client in modo da poter configurare le proprietà da visualizzare.
- (Facoltativo) Crea un segmento che utilizza i dati dell’archivio ClientContext di Salesforce.
Collegamento di un utente AEM a un Salesforce ID linking-an-aem-user-with-a-salesforce-id
Mappa un utente AEM con un Salesforce ID in modo da poterlo caricare nel contesto client. In uno scenario reale, il collegamento si basa sui dati utente noti con convalida. Per scopi dimostrativi, in questa procedura si utilizza il componente Salesforce Connect.
-
Passa a un sito Web in AEM, accedi e trascina il componente Salesforce Connect dalla barra laterale.
note note NOTE Se il componente Salesforce Connect non è disponibile, passare alla visualizzazione Progettazione e selezionarlo per renderlo disponibile nella visualizzazione Modifica. 
Quando trascini il componente nella pagina, viene visualizzato Link to Salesforce=Off.
note note NOTE Questo componente è solo a scopo dimostrativo. Per scenari reali, ci sarebbe un altro processo per collegare/abbinare gli utenti con i lead. -
Dopo aver trascinato il componente sulla pagina, aprilo per configurarlo. Selezionare la configurazione, il tipo di contatto e il lead o il contatto Salesforce, quindi fare clic su OK.
AEM collega l’utente con il contatto o il lead di Salesforce.
Aggiunta di dati Salesforce a ClientContext adding-salesforce-data-to-client-context
Puoi caricare i dati utente da Salesforce in ClientContext da utilizzare per la personalizzazione:
-
Aprire il contesto client che si desidera estendere spostandosi, ad esempio,
http://localhost:4502/etc/clientcontext/default/content.html.
-
Trascina il componente Dati profilo Salesforce nel contesto client.
-
Apri il componente facendo doppio clic su di esso. Selezionare Aggiungi elemento e selezionare una proprietà dall'elenco a discesa. Aggiungi tutte le proprietà desiderate e seleziona OK.
-
Ora le proprietà specifiche di Salesforce di Salesforce vengono visualizzate nel contesto client.
Creazione di un segmento utilizzando i dati dall’archivio ClientContext di Salesforce building-a-segment-using-data-from-salesforce-client-context-store
Puoi creare un segmento che utilizza i dati dell’archivio ClientContext di Salesforce. Per effettuare questo collegamento:
- Passa alla segmentazione in AEM andando su Strumenti > Segmentazione o andando su http://localhost:4502/miscadmin#/etc/segmentation.
- Crea o aggiorna un segmento per includere i dati da Salesforce. Per ulteriori informazioni, vedere Segmentazione.
Ricerca di lead searching-leads
AEM viene fornito con un componente di ricerca di esempio che cerca i lead in Salesforce in base ai criteri specificati. Questo componente mostra come utilizzare l’API REST di Salesforce per cercare oggetti Salesforce. Per attivare una chiamata a salesforce.com, collega una pagina a una configurazione di Salesforce.
Per utilizzare questo componente:
-
Passa alla pagina in cui desideri utilizzare questa configurazione. Apri le proprietà della pagina e seleziona Servizi cloud. Fare clic su Aggiungi servizi, selezionare Salesforce e la configurazione appropriata, quindi fare clic su OK.
-
Trascina il componente Salesforce Search nella pagina (se è stato abilitato). Per attivarla, passare alla modalità Progettazione e aggiungerla all'area appropriata).
-
Aprire il componente Ricerca e specificare i parametri di ricerca, quindi fare clic su OK.
-
In AEM vengono visualizzati i lead specificati nel componente di ricerca che corrispondono ai criteri specificati.
