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à.
# Tutorial: invia eventi a Salesforce da Amazon EventBridge
Puoi utilizzarlo EventBridge per indirizzare [gli eventi](eb-events.md) a servizi di terze parti, ad esempio. [https://www.salesforce.com/](https://www.salesforce.com/)
In questo tutorial, utilizzerai la EventBridge console per creare una connessioneSalesforce, una [destinazione API](eb-api-destinations.md) che punti e una [regola](eb-rules.md) a cui indirizzare gli eventiSalesforce. Salesforce
**Topics**
+ [Prerequisiti](#eb-sf-prereqs)
+ [Passaggio 1: creare una connessione](#eb-sf-create-connection)
+ [Passaggio 2: creare una destinazione API](#eb-dd-api-destination)
+ [Passaggio 3: creare una regola](#eb-dd-create-rule)
+ [Passaggio 4: testare la regola](#eb-dd-test-rule)
+ [Passaggio 5: eliminare le risorse](#cleanup)
## Prerequisiti
Per completare questo tutorial, avrai bisogno delle seguenti risorse:
+ Un [account Salesforce](https://login.salesforce.com/).
+ Un'[app connessa Salesforce](https://help.salesforce.com/s/articleView?id=sf.connected_app_create_basics.htm).
+ Un [token di sicurezza Salesforce](https://help.salesforce.com/s/articleView?id=sf.user_security_token.htm).
+ Un [evento di piattaforma personalizzato Salesforce](https://developer.salesforce.com/docs/atlas.en-us.234.0.platform_events.meta/platform_events/platform_events_define.htm).
+ Un EventBridge bucket [Amazon Simple Storage Service (Amazon S3) abilitato per Amazon](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html).
## Passaggio 1: creare una connessione
Per inviare eventi a Salesforce, devi prima stabilire una connessione all'API Salesforce.
**Per creare la connessione**
1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Nel riquadro di navigazione, scegli **Destinazioni API**.
1. Scegli la scheda **Connessioni**, quindi **Crea connessione**.
1. Immetti un nome e una descrizione per la connessione. Ad esempio, immetti **Salesforce** come nome e **Salesforce API Connection** come descrizione.
1. In **Tipo di destinazione**, scegli **Partner** e in **Destinazioni partner**, seleziona Salesforce dall'elenco a discesa.
1. In **Endpoint di autorizzazione**, immetti:
+ **https://*MyDomainName*.my.salesforce.com./services/oauth2/token** se utilizzi un'organizzazione di produzione
+ **https://*MyDomainName*--*SandboxName*.my. salesforce.com/services /oauth2/token** se utilizzi un ambiente di sperimentazione (sandbox) senza domini avanzati
+ **https://*MyDomainName*--* SandboxName*.sandbox.my.salesforce.com/services/oauth2/token** se utilizzi un ambiente di sperimentazione (sandbox) con domini avanzati
1. In **Metodo HTTP**, scegli **POST** dall'elenco a discesa.
1. In **ID client**, immetti l'ID client dell'app Salesforce connessa.
1. In **Segreto client**, immetti il segreto client dell'app Salesforce connessa.
1. Per **OAuth Http Parameters**, inserisci la seguente coppia chiave/valore:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/eventbridge/latest/userguide/eb-tutorial-salesforce.html)
1. Scegli **Create** (Crea).
## Passaggio 2: creare una destinazione API
Ora che hai creato la connessione, devi creare la destinazione API da utilizzare come [destinazione](eb-targets.md) della regola.
**Per creare la destinazione API**
1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Nel riquadro di navigazione, scegli **Destinazioni API**.
1. Scegli **Crea una destinazione API**.
1. Immetti un nome e una descrizione per la destinazione API. In questo esempio, immetti **SalesforceAD** come nome e **Salesforce API Destination** come descrizione.
1. In **Endpoint di destinazione API**, immetto **https://*MyDomainName*.my.salesforce.com/services/data/v54.0/sobjects/*MyEvent\$1\$1e*** dove **Myevent\$1\$1e** è l'evento della piattaforma a cui desideri inviare le informazioni.
1. In **Metodo HTTP**, scegli **POST** dall'elenco a discesa.
1. In **Limite di velocità di invocazione**, immetti **300**.
1. In **Connessione**, scegli **Utilizza una connessione esistente** e scegli la connessione `Salesforce` che hai creato in Passaggio 1.
1. Scegli **Create** (Crea).
## Passaggio 3: creare una regola
Ora creerai una regola per inviare eventi a Salesforce quando viene creato un oggetto Amazon S3.
**Per creare una regola**
1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Nel pannello di navigazione, scegli **Regole**.
1. Scegli **Create rule** (Crea regola).
1. Immettere un nome e una descrizione per la regola. In questo esempio, immetti **SalesforceRule** come nome e **Rule to send events to Salesforce for S3 object creation** come descrizione.
1. Per **Event bus** (Bus di eventi), scegli **default**.
1. Per **Rule type** (Tipo di regola), scegli **Rule with an event pattern** (Regola con un modello di eventi).
1. Scegli **Next (Successivo)**.
1. In **Event source** (Origine eventi), scegli **Other** (Altro).
1. In **Modello di eventi**, immetti quanto segue:
```
{
"source": ["aws.s3"]
}
```
1. Scegli **Next (Successivo)**.
1. Per i **tipi di Target**, scegli la **destinazione EventBridge dell'API**.
1. In **Destinazione API**, scegli **Utilizza una destinazione API esistente**, quindi scegli la destinazione `SalesforceAD` creata in Passaggio 2.
1. In **Ruolo di esecuzione**, scegli **Crea un nuovo ruolo per questa risorsa specifica**.
1. In **Impostazioni aggiuntive**, procedi come segue:
1. In **Configura l'input di destinazione**, scegli **Trasformatore di input** dall'elenco a discesa.
1. Scegli **Configura il trasformatore di input**.
1. In **Eventi di esempio**, immetti quanto segue:
```
{
"detail":[]
}
```
1. In **Trasformatore di input di destinazione**, procedi come segue:
1. In **Percorso di input**, immetti quanto segue:
```
{"detail":"$.detail"}
```
1. In **Modello di input**, immetti quanto segue:
```
{"message": }
```
1. Scegli **Conferma**.
1. Scegli **Next (Successivo)**.
1. Scegli **Next (Successivo)**.
1. Rivedi i dettagli della regola e scegli **Create rule** (Crea regola).
## Passaggio 4: testare la regola
Per testare la tua regola, crea un [oggetto Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html) caricando un file in un bucket abilitato. EventBridge Le informazioni sull'oggetto creato verranno inviate all'evento della piattaforma Salesforce.
## Passaggio 5: eliminare le risorse
Ora è possibile eliminare le risorse create per questo tutorial, a meno che non si voglia conservarle. Eliminando AWS le risorse che non utilizzi più, eviti addebiti inutili sul tuo account. AWS
**Per eliminare le EventBridge connessioni**
1. Apri la [pagina di destinazione dell'API](https://console.aws.amazon.com/events/home#/apidestinations) della EventBridge console.
1. Scegliere la scheda **Connessioni**.
1. Seleziona la connessione che hai creato.
1. Scegliere **Delete** (Elimina).
1. Immetti il nome della connessione e scegli **Elimina**.
**Per eliminare le destinazioni EventBridge API**
1. Apri la [pagina di destinazione dell'API](https://console.aws.amazon.com/events/home#/apidestinations) della EventBridge console.
1. Seleziona la destinazione API che hai creato.
1. Scegliere **Delete** (Elimina).
1. Immetti il nome della destinazione API e scegli **Elimina**.
**Per eliminare la/le EventBridge regola/e**
1. Apri la [pagina Regole](https://console.aws.amazon.com/events/home#/rules) della EventBridge console.
1. Seleziona la regola che hai creato.
1. Scegliere **Delete (Elimina)**.
1. Scegli **Delete** (Elimina).