Connettersi a Dynamics 365 da flussi di lavoro di app per la logicaConnect to Dynamics 365 from logic app workflows

Con il servizio App per la logica è possibile connettersi a Dynamics 365 (online) e creare flussi aziendali utili che restituiscono record, aggiornano elementi o restituiscono un elenco di record.With Logic Apps, you can connect to Dynamics 365 (online) and create useful business flows that create records, update items, or return a list of records. Con il connettore Dynamics 365, è possibile:With the Dynamics 365 connector, you can:

  • Creare un flusso aziendale in base ai dati ottenuti da Dynamics 365 (online).Build your business flow based on the data you get from Dynamics 365 (online).
  • Usare azioni che ottengono una risposta e quindi rendono disponibile l'output per altre azioni.Use actions that get a response and then make the output available for other actions. Ad esempio, quando viene aggiornato un elemento in Dynamics 365 (online), è possibile inviare un messaggio di posta elettronica con Office 365.For example, when an item is updated in Dynamics 365 (online), you can send an email using Office 365.

Questo argomento illustra come creare un'app per la logica che crea un'attività in Dynamics 365 ogni volta che viene creato un nuovo lead in Dynamics 365.This topic shows you how to create a logic app that creates a task in Dynamics 365 whenever a new lead is created in Dynamics 365.

prerequisitiPrerequisites

  • Un account Azure.An Azure account.
  • Un account Dynamics 365 (online).A Dynamics 365 (online) account.

Creare un'attività quando viene creato un nuovo lead in Dynamics 365Create a task when a new lead is created in Dynamics 365

  1. Accedere ad Azure.Sign in to Azure.

  2. Nella casella di ricerca di Azure digitare Logic apps e premere INVIO.In the Azure search box, type Logic apps, and press ENTER.

    Trovare App per la logica

  3. In App per la logica fare clic su Aggiungi.Under Logic apps, click Add.

    Aggiungere un'app per la logica

  4. Per creare l'app per la logica, completare i campi Nome, Sottoscrizione, Gruppo di risorse e Percorso e quindi fare clic su Crea.To create the logic app, complete the Name, Subscription, Resource Group, and Location fields, and then click Create.

  5. Selezionare la nuova app per la logica.Select the new logic app. Quando viene visualizzata la notifica La distribuzione è riuscita fare clic su Aggiorna.When you receive the Deployment Succeeded notification, click Refresh.

  6. In Strumenti di sviluppo fare clic su Progettazione app per la logica.Under Development Tools, click Logic App Designer. Nell'elenco dei modelli fare clic su App per la logica vuota.In the template list, click Blank Logic App.

  7. Nella casella di ricerca digitare Dynamics 365.In the search box, type Dynamics 365. Nell'elenco dei trigger di Dynamics 365 selezionare Dynamics 365 - Quando un record viene creato.From the Dynamics 365 triggers list, select Dynamics 365 – When a record is created.

  8. Se viene richiesto di accedere a Dynamics 365, eseguire l'operazione.If you are prompted to sign in to Dynamics 365, do so now.

  9. Nei dettagli del trigger immettere le informazioni seguenti:In the trigger details, enter the following information:

    • Nome organizzazione.Organization Name. Selezionare l'istanza di Dynamics 365 di cui l'app per la logica dovrà essere in ascolto.Select the Dynamics 365 instance that you want the logic app to listen to.

    • Nome entità.Entity Name. Selezionare l'entità che si vuole ascoltare.Select the entity that you want to listen to. Questo evento funge da trigger per avviare l'app per la logica.This event acts as a trigger to start the logic app. In questa procedura guidata si seleziona Lead.In this walkthrough, Leads is selected.

    • Specificare la frequenza in base a cui verificare gli elementi.How often do you want to check for items? Questi valori impostano la frequenza con cui l'app per la logica verificherà la presenza di aggiornamenti correlati al trigger.These values set how often the logic app checks for updates related to the trigger. L'impostazione predefinita prevede la verifica della presenza di aggiornamenti ogni tre minuti.The default setting is to check for updates every three minutes.

    • Frequenza.Frequency. Selezionare secondi, minuti, ore o giorni.Select seconds, minutes, hours, or days.

    • Intervallo.Interval. Immettere il numero di secondi, minuti, ore o giorni che deve trascorrere prima della verifica successiva.Enter the number of seconds, minutes, hours, or days that you want to pass before the next check.

      Dettagli del trigger dell'app per la logica

  10. Fare clic su Nuovo passaggio e quindi su Aggiungi un'azione.Click New step, and then click Add an action.

  11. Nella casella di ricerca digitare Dynamics 365.In the search box, type Dynamics 365. Nell'elenco di azioni selezionare Dynamics 365 - Crea un nuovo record.From the actions list, select Dynamics 365 – Create a new record.

  12. Immettere le seguenti informazioni:Enter the following information:

    • Nome organizzazione.Organization Name. Selezionare l'istanza di Dynamics 365 in cui si vuole che il flusso crei il record.Select the Dynamics 365 instance where you want the flow to create the record. Si noti che questa istanza non deve essere necessariamente la stessa da cui viene attivato l'evento.Notice that this instance doesn’t have to be the same instance where the event is triggered from.

    • Nome entità.Entity Name. Selezionare l'entità in cui si vuole che venga creato un record quando viene attivato l'evento.Select the entity that you want to create a record when the event is triggered. In questa procedura guidata si seleziona Attività.In this walkthrough, Tasks is selected.

  13. Fare clic nella casella Oggetto visualizzata.Click in the Subject box that appears. Nell'elenco del contenuto dinamico visualizzato è possibile selezionare uno di questi campi:From the dynamic content list that appears, you can select either of these fields:

    • Cognome.Last Name. La selezione di questo campo inserisce il cognome del lead nel campo Oggetto dell'attività, quando viene creato il record dell'attività.Selecting this field inserts the last name for the lead into the Subject field for the task, when the task record is created.
    • Argomento.Topic. La selezione di questo campo inserisce il campo dell'argomento per il lead nel campo Oggetto dell'attività, quando viene creato il record dell'attività.Selecting this field inserts the Topic field for the lead into the Subject field for the task, when the task record is created. Fare clic su Argomento per aggiungere questo campo alla casella Oggetto.Click Topic to add that to the Subject box.

      Dettagli per la creazione di un nuovo record nell'app per la logica

  14. Fare clic su Salva nella barra degli strumenti di Progettazione app per la logica.On the Logic App Designer toolbar, click Save.

    Salva nella barra degli strumenti di Progettazione app per la logica

  15. Per avviare l'app per la logica, fare clic su Esegui.To start the Logic App, click Run.

    Salva nella barra degli strumenti di Progettazione app per la logica

  16. Creare ora un record lead in Dynamics 365 for Sales e verificare il funzionamento del flusso.Now create a lead record in Dynamics 365 for Sales and see your flow in action!

Impostare le opzioni avanzate per un passaggio dell'app per la logicaSet advanced options for a logic app step

Per specificare come filtrare i dati in un passaggio dell'app per la logica, fare clic su Visualizza opzioni avanzate in tale passaggio, quindi aggiungere un filtro o eseguire un ordinamento tramite una query.To specify how to filter data in a logic app step, click Show advanced options in that step, then add a filter or order by query.

Ad esempio, è possibile usare una query di filtro per recuperare solo gli account attivi ed eseguire l'ordinamento in base al nome dell'account.For example, you can use a filter query to get only active accounts and order by the account name. A tale scopo, immettere la query di filtro OData statuscode eq 1 e selezionare Nome account nel riquadro di contenuto dinamico.To perform this task, enter the OData filter query statuscode eq 1, and select Account Name from the dynamic content list. Per altre informazioni, vedere MSDN: $filter e $orderby.More information: MSDN: $filter and $orderby.

Opzioni avanzate delle app per la logica

Procedure consigliate per l'uso delle opzioni avanzateBest practices when using advanced options

Quando si aggiunge un valore a un campo, il tipo di campo deve corrispondere, indipendentemente dal fatto che il valore venga digitato o selezionato nell'elenco del contenuto dinamico.When you add a value to a field, you must match the field type whether you type a value or select a value from the dynamic content list.

Tipo di campoField type UtilizzoHow to use PosizioneWhere to find NOMEName Tipo di datiData type
Campi di testoText fields I campi di testo richiedono una singola riga di testo oppure contenuto dinamico costituito da un campo di tipo testo.Text fields require a single line of text or dynamic content that is a text type field. Ad esempio, i campi Categoria e Sottocategoria.Examples include the Category and Sub-Category fields. Impostazioni > Personalizzazioni > Personalizza il sistema > Entità > Attività > CampiSettings > Customizations > Customize the System > Entities > Task > Fields categorycategory Riga di testo singolaSingle Line of Text
Campi di tipo IntegerInteger fields Alcuni campi richiedono Integer oppure contenuto dinamico costituito da un campo di tipo Integer.Some fields require integer or dynamic content that is an integer type field. Ad esempio, Percentuale completamento e Durata.Examples include Percent Complete and Duration. Impostazioni > Personalizzazioni > Personalizza il sistema > Entità > Attività > CampiSettings > Customizations > Customize the System > Entities > Task > Fields percentcompletepercentcomplete Numero interoWhole Number
Campi di dataDate fields Alcuni campi richiedono una data immessa nel formato mm/gg/aaaa oppure contenuto dinamico costituito da un campo di tipo data.Some fields require a date entered in mm/dd/yyyy format or dynamic content that is a date type field. Ad esempio, Data creazione, Data di inizio, Inizio effettivo, Ultimo periodo sospensione, Fine effettiva e Scadenza.Examples include Created On, Start Date, Actual Start, Last on Hold Time, Actual End, and Due Date. Impostazioni > Personalizzazioni > Personalizza il sistema > Entità > Attività > CampiSettings > Customizations > Customize the System > Entities > Task > Fields createdoncreatedon Data e oraDate and Time
Campi che richiedono sia ID record che tipo di ricercaFields that require both a record ID and lookup type Alcuni campi che fanno riferimento a un altro record di entità richiedono sia l'ID record che il tipo di ricerca.Some fields that reference another entity record require both the record ID and the lookup type. Impostazioni > Personalizzazioni > Personalizza il sistema > Entità > Account > CampiSettings > Customizations > Customize the System > Entities > Account > Fields accountidaccountid Chiave primariaPrimary Key

Alcuni esempi di campi che richiedono sia ID record che tipo di ricercaMore examples of fields that require both a record ID and lookup type

A integrazione della tabella precedente, di seguito sono riportati alcuni esempi di campi a cui non sono applicabili valori selezionati dall'elenco di contenuto dinamico.Expanding on the previous table, here are more examples of fields that don't work with values selected from the dynamic content list. È invece necessario immettere sia un ID record che un tipo di ricerca nei campi in PowerApps.Instead, these fields require both a record ID and lookup type entered into the fields in PowerApps.

  • Proprietario e Tipo di proprietario.Owner and Owner Type. Il campo Proprietario deve contenere un ID record utente o team valido.The Owner field must be a valid user or team record ID. Tipo di proprietario deve contenere systemusers o teams.The Owner Type must be either systemusers or teams.
  • Cliente e Tipo di cliente.Customer and Customer Type. Il campo Cliente deve contenere un ID record account o contatto valido.The Customer field must be a valid account or contact record ID. Tipo di proprietario deve contenere accounts o contacts.The Owner Type must be either accounts or contacts.
  • Tema e Tipo relativo.Regarding and Regarding Type. Il campo Tema deve contenere un ID record valido, ad esempio un ID record account o contatto.The Regarding field must be a valid record ID, such as an account or contact record ID. Tipo relativo deve contenere il tipo di ricerca per il record, ad esempio accounts o contacts.The Regarding Type must be the lookup type for the record, such as accounts or contacts.

L'esempio seguente di azione di creazione di un'attività aggiunge un record account corrispondente all'ID record aggiungendolo al campo Tema dell'attività.The following task creation action example adds an account record that corresponds to the record ID adding it to the regarding field of the task.

ID record e tipo account nel flusso

Questo esempio assegna anche l'attività a un utente specifico in base all'ID record dell'utente.This example also assigns the task to a specific user based on the user's record ID.

ID record e tipo account nel flusso

Per trovare l'ID di un record, vedere la sezione Trovare l'ID recordTo find a record's ID, see the following section: Find the record ID

Trovare l'ID recordFind the record ID

  1. Aprire un record, ad esempio un record account.Open a record, such as an account record.

  2. Sulla barra degli strumenti Azioni fare clic su Apri nuova finestra Apertura di una nuova finestra nel record.On the actions toolbar, click Pop Out popout record. In alternativa, sulla barra degli strumenti delle azioni fare clic su Invia link tramite messaggio e-mail per copiare l'URL completo nel programma di posta elettronica predefinito.Alternatively, on the actions toolbar, to copy the full URL into your default email program, click EMAIL A LINK.

    L'ID record viene visualizzato tra i caratteri di codifica %7b e %7d dell'URL.The record ID is displayed in between the %7b and %7d encoding characters of the URL.

    ID record e tipo account nel flusso

risoluzione dei problemiTroubleshooting

Per risolvere i problemi relativi a un passaggio non riuscito in un'app per la logica, visualizzare i dettagli dello stato dell'evento.To troubleshoot a failed step in a logic app, view the status details of the event.

  1. In App per la logica, selezionare l'app per la logica e quindi fare clic su Panoramica.Under Logic Apps, select your logic app, and then click Overview.

    Verrà visualizzata l'area Riepilogo, in cui è riportato lo stato di esecuzione dell'app per la logica.The Summary area is shown and provides the run status for the logic app.

    Stato di esecuzione dell'app per la logica

  2. Per altre informazioni su esecuzioni non riuscite, fare clic sull'evento con esito negativo.To view more information about any failed runs, click the failed event. Per espandere un passaggio non riuscito, fare clic su tale passaggio.To expand a failed step, click that step.

    Espandere un passaggio non riuscito

    Vengono visualizzati i dettagli del passaggio, che consentono di risolvere la causa dell'errore.The step details appear and can help troubleshoot the cause of the failure.

    Dettagli del passaggio non riuscito

Per altre informazioni sulla risoluzione dei problemi delle app per la logica, vedere Diagnosi degli errori delle app per la logica.For more information about troubleshooting logic apps, see Diagnosing logic app failures.

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

Esplorare gli altri connettori disponibili nelle app per la logica nell' elenco delle API.Explore the other available connectors in Logic Apps at our APIs list.