Integrazione con Salesforce

L’integrazione di Salesforce con l’AEM fornisce funzionalità di gestione dei lead e sfrutta le funzionalità esistenti fornite da Salesforce come soluzione preconfigurata. Puoi configurare l’AEM in modo da pubblicare i lead in Salesforce e creare componenti che accedano ai dati direttamente da Salesforce.

L’integrazione bidirezionale ed estensibile tra AEM e Salesforce consente di:

• Le organizzazioni possono utilizzare e aggiornare completamente i dati per migliorare l’esperienza del cliente.
• Coinvolgimento dalle attività di marketing alle attività di vendita.
• Organizzazioni per trasmettere e ricevere automaticamente i dati da un archivio dati Salesforce.

Questo documento descrive quanto segue:

• come configurare i Cloud Services Salesforce (configurare AEM per l’integrazione con Salesforce).
• come utilizzare le informazioni di contatto/lead Salesforce in ClientContext e per la personalizzazione.
• come utilizzare il modello di flusso di lavoro Salesforce per pubblicare gli utenti AEM come lead per Salesforce.
• come creare un componente che mostra i dati di Salesforce.

Configurazione dell’AEM per l’integrazione con Salesforce

Per configurare l’AEM per l’integrazione con Salesforce, devi prima configurare un’applicazione di accesso remoto in Salesforce. Quindi configura il servizio cloud Salesforce in modo che punti a questa applicazione di accesso remoto.

Per configurare l’AEM per l’integrazione con Salesforce:

1. In AEM, vai a Cloud Services. In Servizi di terze parti, fai clic su Configura ora in Salesforce.

   

2. Crea una nuova configurazione, ad esempio: sviluppatore.

   NOTA

   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.

3. Accedi al tuo account Salesforce (oppure, se non ne hai uno, creane uno all’indirizzo https://developer.force.com.)

4. In Salesforce, vai a Crea > App per accedere a App collegate (nelle versioni precedenti di salesforce, il flusso di lavoro era Distribuisci > Accesso remoto).

5. Clic Nuovo per collegare AEM con Salesforce.

   

6. Inserisci il Nome app connessa, Nome API, e E-mail di contatto. Seleziona la Abilita impostazioni OAuth e immettere il URL callback e aggiungi un ambito OAuth (ad esempio, accesso completo). L'URL di callback è simile al seguente: http://localhost:4502/etc/cloudservices/salesforce/developer.html

   Modifica il nome del server/numero di porta e il nome della pagina in modo che corrispondano alla configurazione.

   

7. Clic Salva per salvare la configurazione di salesforce. Salesforce crea un chiave consumer e segreto consumer, necessario per la configurazione dell’AEM.

   

   NOTA

   Per attivare l’applicazione di accesso remoto in Salesforce, potrebbe essere necessario attendere diversi minuti (fino a 15 minuti).

8. In AEM, vai a Cloud Services e passa alla configurazione di salesforce creata in precedenza (ad esempio, sviluppatore). Clic Modifica e inserisci la chiave cliente e il segreto cliente da salesforce.com.

   

   Url di accesso	Questo è l’endpoint di autorizzazione 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

9. Clic 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 è stata eseguita correttamente.

10. Passa alla pagina principale del sito web e fai clic su Proprietà pagina. Quindi seleziona Cloud Services e aggiungi 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 Salesforce

Se desideri esportare un utente AEM come lead di Salesforce, devi configurare il flusso di lavoro in modo che pubblichi i lead in Salesforce.

Per esportare gli utenti AEM come lead di Salesforce:

1. Passa al flusso di lavoro Salesforce all’indirizzo http://localhost:4502/workflow facendo clic con il pulsante destro del mouse sul workflow Esportazione Salesforce.com e clic Inizio.

   

2. Selezionare l'utente AEM che si desidera 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, familyName, e così via, mappati sul lead di Salesforce FirstName e Cognome campi.

   

   NOTA

   Prima di avviare questo flusso di lavoro, è necessario disporre di alcuni campi obbligatori per un nodo lead in AEM prima di poter pubblicare il prodotto in Salesforce. Questi sono givenName, familyName, azienda e email. Per un elenco completo dei mapping tra l’utente AEM e il lead Salesforce, consulta Mappatura della configurazione tra l'utente AEM e il lead Slaesforce.

3. Fai clic su OK. Le informazioni utente vengono esportate in salesforce.com. Puoi verificarlo all’indirizzo salesforce.com.

   NOTA

   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

Potrebbe essere necessario configurare il flusso di lavoro di esportazione Salesforce.com in modo che corrisponda alla configurazione Salesforce.com corretta o per apportare altre modifiche.

Per configurare il flusso di lavoro di esportazione Salesforce.com:

1. Accedi a http://localhost:4502/cf#/etc/workflow/models/salesforce-com-export.html.

   

2. Apri il passaggio Esportazione Salesforce.com, seleziona la Argomenti e selezionare la configurazione corretta e fare clic su OK. Inoltre, se desideri che il flusso di lavoro ricrei un lead eliminato in Salesforce, seleziona la casella di controllo.

   

3. Clic Salva per salvare le modifiche.

   

Mappatura della configurazione tra l’utente AEM e il lead Salesforce

Per visualizzare o modificare la configurazione di mappatura corrente tra un utente AEM e un lead Salesforce, apri Configuration Manager: https://<hostname>:<port>/system/console/configMgr e cerca Configurazione mappatura lead Salesforce.

1. Aprire Configuration Manager facendo clic su Console web o andando direttamente a https://<hostname>:<port>/system/console/configMgr.

2. Cerca Configurazione mappatura lead Salesforce.

   

3. Modifica le mappature in base alle esigenze. La mappatura di default segue il pattern aemUserAttribute=sfLeadAttribute. Clic Salva per salvare le modifiche.

Configurazione dell’archivio ClientContext Salesforce

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, devi configurare quanto segue:

1. Collega un utente AEM con un ID Salesforce tramite il componente Salesforce Connect.
2. Aggiungi i dati profilo Salesforce nella pagina di contesto client per configurare le proprietà da visualizzare.
3. (Facoltativo) Crea un segmento che utilizza i dati dell’archivio Salesforce Client Context.

Collegamento di un utente AEM a un ID Salesforce

È necessario mappare un utente AEM con un ID Salesforce per caricarlo nel contesto client. In uno scenario reale, il collegamento si basa sui dati utente noti con convalida. Ai fini della dimostrazione, in questa procedura utilizzi il Salesforce Connect componente.

1. Accedi a un sito Web in AEM, accedi, trascina e rilascia la Salesforce Connect componente dalla barra laterale.

   NOTA

   Se il Salesforce Connect il componente non è disponibile, vai a Progettazione visualizzarlo e selezionarlo per renderlo disponibile in Modifica visualizzazione.

   

   Quando trascini il componente nella pagina, questo viene visualizzato Link to Salesforce=Disattivato.

   

   NOTA

   Questo componente è solo a scopo dimostrativo. Per scenari reali, ci sarebbe un altro processo per collegare/abbinare gli utenti con i lead.

2. Dopo aver trascinato il componente sulla pagina, aprilo per configurarlo. Seleziona la configurazione, il tipo di contatto e il lead o contatto Salesforce, quindi fai clic su OK.

   

   L’AEM collega l’utente al contatto o al lead Salesforce.

   

Aggiunta di dati Salesforce a ClientContext

Puoi caricare i dati utente da Salesforce in ClientContext da utilizzare per la personalizzazione:

1. Apri il contesto client che desideri estendere spostandoti, ad esempio: http://localhost:4502/etc/clientcontext/default/content.html.

   

2. Trascina Dati profilo Salesforce componente nel contesto client.

   

3. Fai doppio clic sul componente per aprirlo. Seleziona Aggiungi elemento e seleziona una proprietà dall’elenco a discesa. Aggiungi tutte le proprietà che desideri e seleziona OK.

   

4. Ora puoi vedere le proprietà specifiche di Salesforce di Salesforce visualizzate nel contesto client.

   

Creazione di un segmento utilizzando i dati dall’archivio ClientContext Salesforce

Puoi creare un segmento che utilizza i dati dell’archivio Salesforce ClientContext. Per effettuare questo collegamento:

1. Passa alla segmentazione in AEM andando su Strumenti > Segmentazione o per andare http://localhost:4502/miscadmin#/etc/segmentation.
2. Crea o aggiorna un segmento per includere i dati di Salesforce. Per ulteriori informazioni, consulta Segmentazione.

Ricerca di lead

L’AEM viene fornito con un componente di ricerca di esempio che cerca i lead in Salesforce in base ai criteri forniti. Questo componente mostra come utilizzare l’API REST Salesforce per cercare oggetti Salesforce. Per attivare una chiamata a salesforce.com, devi collegare una pagina a una configurazione Salesforce.

Per utilizzare questo componente:

1. Passa alla pagina in cui desideri utilizzare questa configurazione. Apri le proprietà della pagina e seleziona Cloud Services. Clic Aggiungi servizi e seleziona Salesforce e la configurazione appropriata, quindi fai clic su OK.

   

2. Trascina nella pagina il componente di ricerca Salesforce (se attivato). Per attivarla, passare alla modalità Progettazione e aggiungerla all'area appropriata).

   

3. Apri il componente Ricerca e specifica i parametri di ricerca, quindi fai clic su OK.

   

4. In AEM vengono visualizzati i lead specificati nel componente di ricerca che corrispondono ai criteri specificati.

   

Risorse Business.Adobe.com

Style System Content Intelligence Embedded Charts Theme Editor Managed Cloud Web Content Management