Utilizzare i plug-in con poco codice in Dataverse (anteprima)

[Questo argomento fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

Microsoft Dataverse offre una potente soluzione per ottenere un'architettura dati più efficiente e ridurre il carico di lavoro lato client tramite plug-in con poco codice. Questi plug-in sono flussi di lavoro riutilizzabili in tempo reale che eseguono una serie specifica di comandi all'interno di Dataverse, eseguiti lato server e attivati ​​da gestori di eventi personalizzati.

Tradizionalmente, i plug-in venivano creati come classi personalizzate compilate in un assembly .NET Framework, che venivano quindi caricate e registrate in Dataverse. Tuttavia, con l'introduzione di plug-in con poco codice, gli utenti possono creare questi gestori di eventi con una codifica minima o nessuna richiesta e senza la necessità di registrazione manuale.

I plug-in con poco codice vengono archiviati in un database Dataverse e possono essere perfettamente integrati in Power Apps e Power Automate. Il comportamento del flusso di lavoro è definito utilizzando il linguaggio di espressione Power Fx e può connettersi direttamente ai dati aziendali Dataverse e alle origini dati esterne tramite connettori Power Platform. Con i plug-in con poco codice, i produttori possono creare rapidamente flussi di lavoro complessi con competenze di codifica minime, ottenendo un'architettura dei dati più snella ed efficiente.

Vantaggi della logica lato server

La definizione della logica aziendale lato server offre numerosi vantaggi, tra cui:

• Sicurezza migliorata. Poiché la logica lato server viene eseguita sul server, può aiutare a prevenire l'accesso non autorizzato a dati o processi sensibili.
• Prestazioni migliorate. In esecuzione sul server, la logica aziendale può ridurre la quantità di dati che devono essere trasferiti tra il client e il server, con conseguente tempi di elaborazione più rapidi.
• Affidabilità e coerenza. La logica lato server garantisce che le regole di business vengano applicate in modo coerente su tutti i client, riducendo il rischio di errori o incoerenze.
• Manutenzione e aggiornamenti più semplici. Centralizzando la logica aziendale sul server, diventa più semplice la manutenzione e l'aggiornamento, poiché le modifiche possono essere apportate in un unico posto anziché dover aggiornare più client.
• Scalabilità. La logica lato server può essere scalata più facilmente rispetto alla logica lato client, consentendo prestazioni e gestione migliori di carichi di lavoro più grandi.

Plug-in con uso limitato di codice

Esistono due tipi di plug-in con con poco codice supportati in Dataverse:

Tutti i plug-in con poco codice hanno le seguenti proprietà comuni:

Autorizzazioni dei plug-in

Prerequisiti per la creazione di un plug-in con uso limitato di codice

Aggiornare l'Acceleratore Dataverse

1. Segui le istruzioni per visualizzare le app con licenza nel tuo ambiente.
2. Se l'Acceleratore Dataverse è già installato ed è disponibile un aggiornamento, è indicato nella tabella accanto alla voce.
3. Seleziona Acceleratore Dataverse, seleziona Aggiorna nella barra dei comandi.

Creare un plug-in istantaneo con uso limitato di codice

1. Riproduci l'app Acceleratore Dataverse.
2. Seleziona la scheda Crea plug-in istantaneo.
3. Fornisci un Nome visualizzato.
4. Eventualmente, definisci i parametri:
   • Seleziona Nuovo parametro di input o Nuovo parametro di output, quindi inserisci l'etichetta e il tipo di dati.
   • Aggiungi più parametri di input e output secondo necessità.
5. Immetti l'espressione Power Fx nell'editor delle Espressioni.
   • Fare riferimento ai parametri di input nella formula tramite il nome dell'etichetta.
   • I parametri di output devono essere indicati all'interno di parentesi graffe, ad esempio { Out: "Return value" }.
   • Fai riferimento a tabelle Dataverse utilizzando funzioni di raccolta dati, come Filter() e LookUp().
   • Se l'ambito è impostato su entità, utilizzare ThisRecord per accedere ai valori della colonna nella riga della tabella associata all'esecuzione del plug-in, ad esempio ThisRecord.'Account Name'.

   Suggerimento

   Annotare IntelliSense nella casella Espressione. Il rosso sottolineato non è valido. Il giallo ondulato indica che la tua logica potrebbe essere influenzata dai limiti di delega. Evita problemi di delega utilizzando funzioni delegabili.

6. Facoltativamente, espandi Opzioni avanzate per modificare soluzione, ambito o descrizione.
7. Seleziona Salva.
8. Metti alla prova il tuo plug-in istantaneo con poco codice.

Esempio: calcola la somma di due numeri interi.

• Crea due parametri di input, X e Y (entrambi di tipo intero) e un parametro di output, Z (tipo stringa).
• Usa la formula seguente: {Z: X + Y }

Creare un plug-in automatizzato con uso limitato di codice

1. Riproduci l'app Acceleratore Dataverse.
2. Seleziona la scheda Crea plug-in automatizzato.
3. Specifica i valori seguenti:
   • Nome: immetti un nome per il plug-in, ad esempio Convaluda di input.
   • Tabella : scegli una tabella a cui associare il plug-in, ad esempio Account.
   • Esegui questa regola per il plug-in quando la riga è. Specifica l'evento dati che richiama il plug-in.
4. Immetti l'espressione Power Fx nell'editor delle Espressioni.
   • Fai riferimento a tabelle Dataverse utilizzando funzioni di raccolta dati, come Filter() e LookUp().
   • Utilizzare ThisRecord per accedere ai valori della colonna nella riga della tabella associata all'esecuzione del plug-in, ad esempio ThisRecord.'Account Name'.
5. Eventualmente, espandi Opzioni avanzate per modificare la fase (quando dovrebbe essere eseguita) e la soluzione in cui viene salvato il plug-in.
6. Seleziona Salva.
7. Metti alla prova il tuo plug-in automatizzato con poco codice.

Utilizzare i connettori Power Platform nei plug-in con poco codice

I connettori Power Platform possono essere utilizzati in plug-in con poco codice per integrare facilmente dati e funzionalità da sistemi esterni in Dataverse, come SQL Server, Salesforce e SharePoint, senza la necessità di codifica o sviluppo personalizzato complessi.

Prerequisiti per l'utilizzo dei connettori nei plug-in con poco codice

Uso delle azioni dei connettori in plug-in con poco codice

Puoi utilizzare facilmente connettori e connettori personalizzati dall'interno di un plug-in con poco codice in una formula Power Fx.

1. Creare una connessione al connettore che desideri utilizzare.
2. Aggiungi un riferimento a una connessione alla connessione nell'ambiente Dataverse.
3. Nell'editor di espressioni del plug-in Power Fx con poco codice, digita il nome del riferimento a una connessione (il nome interno con un prefisso e un carattere di sottolineatura, come new_connectorName, non il nome visualizzato).
4. IntelliSense mostra le azioni disponibili. Seleziona l'azione desiderata, quindi inserisci i parametri richiesti.

Prima di utilizzare un connettore in un plug-in con poco codice, esamina la documentazione del connettore per assicurarti di passare correttamente i parametri di input e output.

Altre informazioni: esempio

Testare un plug-in con uso limitato di codice

Testare i plug-in istantanei

1. Dalla Schermata iniziale, seleziona un plug-in istantaneo dall'elenco, quindi seleziona Test sulla barra dei comandi. Puoi anche accedere a questa schermata dall'editor del plug-in istantaneo nella barra dei comandi dopo che è stata salvata.

2. Fornisci i valori per tutti i parametri di input definiti nel plug-in con uso limitato di codice, quindi seleziona Esegui.

Osserva la risposta.

Testare i plug-in automatizzati

Testa i plug-in automatizzati richiamando l'evento dati. Osserva se il plug-in è stato eseguito correttamente convalidando le modifiche previste definite nella formula.

Integrare un plug-in con uso limitato di codice

Richiama un plug-in istantaneo da un'app canvas o da una pagina personalizzata

1. Nell'app Acceleratore Dataverse:
   1. Seleziona plug-in istantaneo dall'elenco.
   2. Seleziona Copia frammento di codice sulla barra dei comandi.
   3. Incolla e salva la formula copiata in un editor di testo o in un blocco note (in una posizione a cui puoi facilmente fare riferimento).
2. In Power Apps:
   1. Crea o modifica un'app canvas (o una pagina personalizzata) nel file Power Apps Studio.
   2. Nella barra di spostamento a sinistra, nella scheda Origine dati, seleziona + Nuova origine dati e cerca l'opzione Ambiente dal connettore Dataverse.
   3. Inserisci i seguenti componenti nella canvas:
   • Aggiungi controlli di input che corrispondono al tipo di dati di ciascun parametro, ad esempio Input di testo per testo o numeri, Attiva/disattiva per booleani.
   • Se l'ambito del plug-in è associato a una tabella, aggiungi una casella combinata associata alla stessa tabella in modo da poter scegliere l'input.
   • Aggiungi un pulsante per richiamare il plug-in.
3. Incolla la formula del plug-in che hai copiato nella proprietà del pulsante OnSelect.
4. Mappare ciascun parametro di input Value affinché faccia riferimento ai controlli di input corrispondenti:
   • Se la formula è Environment.new_CalculateSum({ X: Value, Y: Value });, potrebbe essere riscritta come: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
   • Se la formula è stata limitata, sostituisci Environment con la tabella del nome visualizzato per accedere al plug-in.
5. Se è definito un parametro di output per il plug-in con poco codice:
   1. Cattura la risposta in uan formula Set() o UpdateContext(): Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Visualizza la variabile in un'etichetta. In alternativa utilizza la formula Notify() per visualizzare i dati in una notifica.
6. Riproduci l'app e seleziona il comando sulla barra dei comandi per eseguire il plug-in con poco codice.

Scopri di più su come chiamare le azioni Dataverse direttamente da Power Fx nelle app canvas.

Richiama un plug-in istantaneo da un flusso cloud di Power Automate

1. In un flusso cloud, aggiungi una nuova azione dal connettore Microsoft Dataverse.
2. Seleziona l'azione chiamata Esegui un'azione non associata o Esegui un'azione associata.
3. Seleziona il tuo plug-in (ha il nome univoco con un prefisso).
4. Fornisci i valori per tutti i parametri di input (se presenti).

Richiama un plug-in istantaneo dall'API Web Dataverse

Segui i passaggi per le sezioni Azione non associata o Funzione associata alla tabella in Invocazione di API personalizzate dalla documentazione dell'API Web (a seconda dell'ambito appropriato del plug-in).

Ottenere aiuto con i plug-in con poco codice

Se riscontri problemi durante la creazione o l'esecuzione del plug-in con poco codice, consulta questi suggerimenti per i problemi comuni che possono verificarsi: Microsoft Dataverse suggerimenti per plug-in con poco codice e problemi noti

Guida e supporto

Per problemi con l'installazione della soluzione Acceleratore Dataverse o plug-in con poco codice non trattati in Suggerimenti sui plug-in con poco codice e problemi noti in Microsoft Dataverse, ad esempio errori non documentati ricevuti, utilizza l'esperienza Guida e supporto e includi le seguenti informazioni:

• Tipo di problema: API Web e SDK di Dataverse
• Sottotipo di problema: kit acceleratore per Dataverse

Esempi di plug-in con uso limitato di codice che puoi creare

Per alcuni esempi su come creare un plug-in con poco codice, vai a Esempio di plug-in Dataverse con poco codice (anteprima)

Limiti

• L'oggetto linguaggio dell'ambiente deve essere riaggiunto per accedere ai nuovi plug-in all'interno delle app canvas esistenti. Per tutti i plug-in creati dopo aver aggiunto la tabella dell'ambiente origine dati a un'app canvas esistente, dovrai rimuovere e leggere l'oggetto del linguaggio dell'ambiente Power Fx. Quindi vedrai l'elenco aggiornato dei plug-in con poco codice come azioni.

• IntelliSense richiede una notazione esplicita nei plug-in automatizzati se si desidera fare riferimento a tabelle nella formula. Utilizza la seguente sintassi di disambiguazione come [@Accounts], utilizzando parentesi quadre e il simbolo @ (non Accounts).

• Supporto nidificato. I plug-in possono chiamare solo azioni proprietarie pubblicate da Microsoft da espressioni Power Fx.

• Alcuni scenari Collect richiedono Patch. In alcuni scenari Collect() non funziona. La soluzione consiste nell'utilizzare Patch() come mostrato nell'esempio di popolamento relativo alla colonna riportato di seguito. Se stai creando un plug-in automatico, anteponi @ a ogni tabella a cui si fa riferimento nella formula Power Fx.

  Patch(Faxes,
      Collect(Faxes, { Subject : "Sub1" } ),
      { Regarding : First(Accounts) }
  )
  

• Quando i plug-in con poco codice interagiscono con i connettori e viene utilizzato DLP, l'amministratore può bloccare la creazione di connessioni utilizzando DLP. Tuttavia, i riferimenti di connessione esistenti nell'ambiente Dataverse continuano a funzionare. Nel caso in cui l'amministratore debba bloccare tutte le interazioni dei plug-in con poco codice con qualsiasi connettore, può disabilitare l'impostazione dell'organizzazione Allowconnectorsonpowerfxactions. Questa impostazione è abilitata per impostazione predefinita e può essere disabilitata con i normali metodi SDK (WebAPI, SDK, PowerShell e così via). Puoi disabilitarla utilizzando un plug-in istantaneo con poco codice come segue:

  Patch(Organizations, First(Organizations), { 'Enable connectors on power fx actions.': 'Enable connectors on power fx actions. (Organizations)'.No })
  

• I plug-in che utilizzano connettori possono restituire risultati solo da campi specifici. Per questo motivo, è necessario mappare valori primitivi specifici dalla risposta del connettore ai valori di output.

Plug-in a basso codice con limitazioni dei connettori personalizzati

Se disponi di plug-in a basso codice con connettori personalizzati, i connettori personalizzati devono essere importati per primi, prima dei riferimenti o dei flussi di connessione.

Se il tuo ambiente non contiene il connettore personalizzato in una soluzione, importa una soluzione separata con solo i connettori personalizzati. Esegui questa importazione prima di importare la soluzione effettiva. Devi eseguire questa operazione prima perché Azure deve registrare il connettore personalizzato prima che gli altri componenti della soluzione possano essere importati.

Se si importa una soluzione che contiene connettori e flussi personalizzati, Azure non sarà in grado di registrare il connettore personalizzato mentre registra i riferimenti o i flussi di connessione. Questo vale anche per i riferimenti di connessione per il connettore personalizzato che non è stato precedentemente importato in una soluzione separata. Se Azure non ha registrato il connettore personalizzato, l'importazione avrà esito negativo o non sarà possibile avviare l'importazione.

Ulteriori informazioni: Creare connettori personalizzati nelle soluzioni: limitazioni note

Vedi anche

Plug-in con uso limitato di codice Power Fx (anteprima)

Usare una richiesta predefinita in un plug-in con poco codice Dataverse in Power Apps

Creare un plug-in automatizzato con poco codice con Power Apps (video)

Creare un plug-in istantaneo icon poco codice con Power Apps (video)