Introduzione al connettore SalesforceGet started with the Salesforce connector

Il connettore Salesforce offre un'API per lavorare con gli oggetti Salesforce.The Salesforce Connector provides an API to work with Salesforce objects.

Per usare qualsiasi connettore, è necessario innanzitutto creare un'app per la logica.To use any connector, you first need to create a logic app. Come prima operazione creare un'app per la logica.You can get started by creating a logic app now.

Connettersi al connettore SalesforceConnect to Salesforce connector

Perché l'app per la logica possa accedere a qualsiasi servizio, è necessario creare una connessione al servizio.Before your logic app can access any service, you first need to create a connection to the service. Una connessione fornisce la connettività tra un'app per la logica e un altro servizio.A connection provides connectivity between a logic app and another service.

Creare una connessione al connettore SalesforceCreate a connection to Salesforce connector

PrerequisitiPrerequisites

Prima di poter usare l'account Salesforce in un'app per la logica, è necessario autorizzare l'app per la logica a connettersi all'account Salesforce. Fortunatamente, è possibile eseguire questa operazione in modo facile dalla propria app per la logica nel Portale di Azure.Before you can use your Salesforce account in a logic app, you must authorize the logic app to connect to your Salesforce account.Fortunately, you can do this easily from within your logic app on the Azure Portal.

Ecco i passaggi per autorizzare l'app per la logica a connettersi all'account Salesforce:Here are the steps to authorize your logic app to connect to your Salesforce account:

  1. Per creare una connessione a Salesforce, nella finestra di progettazione dell'app per la logica, selezionare Mostra API gestite da Microsoft nell'elenco a discesa e quindi immettere Salesforce nella casella di ricerca.To create a connection to Salesforce, in the logic app designer, select Show Microsoft managed APIs in the drop down list then enter Salesforce in the search box. Selezionare il trigger o l'azione che si desidera usare: Select the trigger or action you'll like to use:
    Immagine di connessione a Salesforce 1Salesforce connection image 1
  2. Se non sono mai state create connessioni a Salesforce prima d'ora, verrà chiesto di fornire le credenziali di Salesforce.If you haven't created any connections to Salesforce before, you'll get prompted to provide your Salesforce credentials. Queste credenziali verranno usate per autorizzare l'app per la logica a connettersi e ad accedere ai dati dell'account Salesforce:These credentials will be used to authorize your logic app to connect to, and access your Salesforce account's data:
    Immagine di connessione a Salesforce 2
  3. Fornire il nome utente e la password di Salesforce per autorizzare l'app per la logica:Provide your Salesforce user name and password to authorize your logic app:
    Immagine di connessione a Salesforce 3
  4. In questo modo sarà possibile connettersi a Salesforce:Allow us to connect to Salesforce:
    Immagine di connessione a Salesforce 4
  5. Si noti che la connessione è stata creata ed è ora possibile procedere con gli altri passaggi nell'app per la logica:Notice the connection has been created and you are now free to proceed with the other steps in your logic app:
    Immagine di connessione a Salesforce 5

Usare un trigger del connettore SalesforceUse a Salesforce connector trigger

Un trigger è un evento che può essere usato per avviare il flusso di lavoro definito in un'app per la logica.A trigger is an event that can be used to start the workflow defined in a logic app. Altre informazioni sui trigger.Learn more about triggers.

Questa procedura dettagliata descrive come utilizzare il trigger Salesforce - Quando viene creato un oggetto per avviare un flusso di lavoro dell'app per la logica quando viene creato un nuovo lead in Salesforce.In this walk-through, you will learn how to use the Salesforce - When an object is created trigger to initiate a logic app workflow when a new lead is created in your Salesforce.

Nota

All'utente viene chiesto di accedere al proprio account di Salesforce se non è ancora stata creata una connessione a Salesforce.You will get prompted to sign into your Salesforce account if you have not already created a connection to Salesforce.

  1. Immettere salesforce nella casella di ricerca della finestra di progettazione delle app per la logica e quindi selezionare il trigger Salesforce - Quando viene creato un oggetto.Enter salesforce in the search box on the logic apps designer then select the Salesforce - When an object is created trigger.
    Immagine del trigger Salesforce 1Salesforce trigger image 1
  2. Viene visualizzato il controllo Quando viene creato un oggetto .The When an object is created control is displayed.
    Immagine del trigger Salesforce 2Salesforce trigger image 2
  3. Selezionare Tipo di oggetto e Lead dall'elenco di oggetti.Select the Object Type then select Lead from the list of objects. In questo passaggio si indica che si sta creando un trigger che invierà una notifica all'app per la logica ogni volta che viene creato un nuovo lead in Salesforce.In this step you are indicating that you are creating a trigger that will notify your logic app whenever a new lead is created in Salesforce.
    Immagine del trigger Salesforce 3Salesforce trigger image 3
  4. È tutto.That's it. Il trigger è stato creato.You've created the trigger. Tuttavia, è necessario creare almeno un'azione per rendere valida questa app per la logica.However, you need to create at least one action in order to make this a valid logic app.
    Immagine del trigger Salesforce 4

A questo punto, l'app per la logica è stata configurata con un trigger che avvierà l'esecuzione di altri trigger e altre azioni nel flusso di lavoro quando un nuovo elemento viene creato in Salesforce.At this point, your logic app has been configured with a trigger that will begin a run of the other triggers and actions in the workflow when a new item is created in your Salesforce.

Add a conditionAdd a condition

Questa condizione valuterà il campo dell'indirizzo di posta elettronica di ogni nuovo lead Salesforce.This condition will evaluate the email address field of each new Salesforce lead. Se l'indirizzo di posta elettronica contiene amazon.com, il risultato della condizione sarà True.If the email address contains amazon.com, the condition result will be True.

  1. Selezionare + nuovo passaggio.Select + New step.
    Immagine di condizione Salesforce 1Salesforce condition image 1
  2. Selezionare Aggiungi una condizione.Select Add a condition.
    Immagine di condizione Salesforce 2Salesforce condition image 2
  3. Selezionare Scegli un valore.Select Choose a value.
    Immagine di condizione Salesforce 3Salesforce condition image 3
  4. Selezionare il token E-mail dal lead del trigger.Select the Email token from the lead of the trigger.
    Immagine di condizione Salesforce 4Salesforce condition image 4
  5. Selezionare Contiene.Select Contains.
    Immagine di condizione Salesforce 5Salesforce condition image 5
  6. Selezionare Scegli un valore nella parte inferiore del controllo.Select Choose a value at the bottom of the control.
    Immagine di condizione Salesforce 6Salesforce condition image 6
  7. Immettere amazon.com come valore su cui valutare l'indirizzo di posta elettronica del nuovo lead.Enter amazon.com as the value you would like to evaluate the email address of the new lead for. Se l'indirizzo di posta elettronica contiene amazon.com, la condizione lo valuta come True ed è possibile procedere con gli altri passaggi nell'app per la logica.If the email address contains amazon.com, the condition will evaluate to True and the other steps in your logic app can proceed.
    Immagine di condizione Salesforce 7Salesforce condition image 7
  8. Salvare le app per la logica.Save your logic apps.

Usare un'azione del connettore SalesforceUse a Salesforce connector action

Un'azione è un'operazione eseguita dal flusso di lavoro e definita in un'app per la logica.An action is an operation carried out by the workflow defined in a logic app. Altre informazioni sulle azioni.Learn more about actions.

Dopo aver aggiunto una condizione, è possibile svolgere delle operazioni interessanti con i dati generati dal trigger.Now that you have added a condition, its time to do something interesting with the data that's generated by the trigger. Attenersi alla procedura seguente per aggiungere l'azione Salesforce - Ottenere oggetto .Follow these steps to add the Salesforce - Get object action. Questa azione consente di ottenere i dati ogni volta che viene creato un nuovo lead.This action will get the data each time a new lead is created. Si aggiungerà anche una seconda azione che utilizzerà i dati dall'azione Salesforce - Ottenere oggetto per inviare un messaggio di posta elettronica tramite il connettore di Office 365.You will also add a second action that will use the data from the Salesforce - Get an object action to send an email using the Office 365 connector.

Per configurare questa azione, è necessario fornire le informazioni indicate di seguito.To configure the this action, you will need to provide the following information. Si noterà che è facile usare i dati generati dal trigger come input per alcune proprietà del nuovo file:You will notice that it is easy to use data generated by the trigger as input for some of the properties for the new file:

Creare proprietà fileCreate file property DescrizioneDescription
Tipo di oggettoObject type Questo è il tipo di oggetto Salesforce a cui si è interessati.This is the type of Salesforce object you are interested in. Alcuni esempi sono Lead, Account, ecc.Examples are Lead, Account, etc.
ID oggettoObject ID Rappresenta un identificatore dell'oggetto.This represents an identifier for the object.
  1. Selezionare il collegamento Aggiungi un'azione .Select Add an action link. Viene aperta la casella di ricerca per cercare qualsiasi azione si desideri eseguire.This opens the search box where you can search for any action you would like to take. In questo esempio, l'interesse è rivolto alle azioni di Salesforce.For this example, Salesforce actions are of interest.
    Immagine di azione Salesforce 1Salesforce action image 1
  2. Immettere salesforce per cercare le azioni correlate a salesforce.Enter salesforce to search for actions related to salesforce.
  3. Selezionare Salesforce - Ottenere oggetto come azione da intraprendere.Select Salesforce - Get object as the action to take. Nota: verrà richiesto di autorizzare l'app per la logica ad accedere all'account di Salesforce, se non lo si è già fatto in precedenza.Note: you will be prompted to authorize your logic app to access your Salesforce account if you have not done so previously.
    Immagine di azione Salesforce 2Salesforce action image 2
  4. Viene visualizzato il controllo Ottenere oggetto .The Get object control opens.
  5. Selezionare lead come tipo di oggetto.Select lead as the object type.
  6. Selezionare il controllo ID oggetto .Select the Object ID control.
  7. Selezionare ... per espandere l'elenco dei token utilizzabili come input per le azioni.Select ... to expand the list of tokens that can be used as input for actions.
    Immagine di azione Salesforce 3Salesforce action image 3
  8. Selezionare il controllo ID lead per visualizzarlo.Select Lead ID control opens.
    Immagine di azione Salesforce 4Salesforce action image 4
  9. Il token dell'ID lead si trova ora nel controllo dell'ID oggetto, indicando che l'azione Ottieni oggetto cercherà un lead con un ID identico a quello del lead che ha attivato l'app per la logica.Notice that the Lead ID token is now in the Object ID control, indicating that the Get object action will search for a lead with an ID that is equal to the lead ID of lead that triggered this logic app.
    Immagine di azione Salesforce 5
  10. Salvare il lavoro.Save your work. A questo punto l'azione Ottenere oggetto è stata aggiunta all'app per la logica.That's it, you have added the Get object action to your logic app. Il controllo Ottenere oggetto dovrebbe assomigliare a: Your Get object control should look like this:
    Immagine di azione Salesforce 6

Dopo aver aggiunto un'azione per ottenere un lead, è possibile effettuare operazione interessanti con il lead appena creato.Now that you have added an action to get a lead, you may want to do something interesting with the newly created lead. In un'azienda, si può voler inviare un messaggio di posta elettronica per notificare a un elenco di distribuzione che è stato creato un nuovo lead.In an enterprise, you may want to send an email to notify a distribution list that a new lead has been created. Il connettore Office 365 viene utilizzato per inviare un messaggio di posta elettronica con alcune delle informazioni pertinenti dal nuovo oggetto lead presente in Salesforce.Let's use the Office 365 connector to send an email with some of the relevant information from the new lead object in Salesforce.

  1. Selezionare Aggiungi un'azione e digitare messaggio di posta elettronica nel controllo di ricercaSelect Add an action then enter email in the search control. per filtrare le azioni e visualizzare solo quelle correlate all'invio e alla ricezione di messaggi di posta elettronica.This filters the actions to those that are related to sending and receiving email.
  2. Selezionare la voce di elenco Office 365 Outlook - Inviare un messaggio di posta elettronica .Select the Office 365 Outlook - Send an email list item. Se non è ancora stata creata una connessione all'account di Office 365, verrà richiesto di immettere le credenziali di Office 365 per crearla adesso.If you haven't already created a connection to your Office 365 account, you will be prompted to enter your Office 365 credentials to create it now. Al termine dell'operazione, viene visualizzato il controllo Inviare un messaggio di posta elettronica .After you are done, the Send an email control opens.
    Immagine di azione Salesforce 7Salesforce action image 7
  3. Immettere l'indirizzo di posta elettronica a cui inviare il messaggio nel controllo A .Enter the email address that you'd like to send email to in the To control.
  4. Nel controllo Subject (Oggetto) immettere New Lead created (Nuovo lead creato) e quindi selezionare il token Company (Azienda).In the Subject control, enter New Lead created - then select the Company token. Verrà visualizzato il campo Azienda dal nuovo lead creato in Salesforce.This will display the company field from the new lead created in Salesforce.
  5. Nel controllo Corpo messaggio , è possibile selezionare qualsiasi token dal nuovo oggetto lead ed è inoltre possibile immettere qualunque testo che si desidera far apparire nel corpo del messaggio di posta elettronica.In the body control, you can select any of the tokens from the new lead object and you can also enter whatever text you would like to display in the body of the email. Ecco un esempio: Here's an example:
    Immagine di azione Salesforce 8Salesforce action image 8
  6. Salvare il flusso di lavoro.Save your workflow.

È tutto.That's it. Ora l'app per la logica è completa.Your logic app is now complete.

Ora è possibile testare l'app per la logica: in Salesforce, creare un nuovo lead che soddisfi la condizione creata.Now, you can test your logic app: in Salesforce, create a new lead that meets the condition you created. Se ci si è attenuti pienamente a questa procedura dettagliata, è sufficiente creare un lead con un indirizzo di posta elettronica che contenga la dicitura amazon.com .If you followed this walk-through fully, just create a lead with an email address that contains amazon.com in it. L'app per la logica dovrebbe attivarsi in pochi secondi e il risultato dovrebbe essere simile a: After a few seconds your logic app should be triggered and the results may look similar to this:
Immagine di azione Salesforce 9Salesforce action image 9

Dettagli specifici del connettoreConnector-specific details

Per visualizzare eventuali azioni e trigger definiti in Swagger ed eventuali limiti, vedere i dettagli del connettore.View any triggers and actions defined in the swagger, and also see any limits in the connector details.

Passaggi successiviNext steps

Creare un'app per la logicaCreate a logic app