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

Aggiorna l'acceleratore Dataverse

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

Creare un plug-in istantaneo con uso limitato di codice

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

   Suggerimento

   Notare l'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 i problemi di delega utilizzando funzioni delegabili.

6. Facoltativamente, espandere Opzioni avanzate per modificare la soluzione, ambito o descrizione.
7. Seleziona Salva.
8. 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 (di tipo stringa).
• Utilizzare la seguente formula: {Z: X + Y }

Creare un plug-in automatizzato con uso limitato di codice

1. Riproduci l'app Acceleratore Dataverse.
2. Seleziona the Crea plug-in automatizzato scheda.
3. Fornire i seguenti valori:
   • Nome: inserisci un nome per il plug-in, ad esempio Convalida input.
   • Tabella: seleziona una tabella a cui associare il plug-in, ad esempio Account.
   • Esegui questa regola del plug-in quando la riga è. Specifica l'evento dati che richiama il plug-in.
4. Inserisci l' Power Fx espressione nell'editor Espressione .
   • Tabelle di riferimento Dataverse che utilizzano funzioni di raccolta dati, come Filter() e LookUp().
   • Utilizzare ThisRecord per accedere ai valori delle colonne nella riga della tabella associata all'esecuzione del plug-in, ad esempio ThisRecord.'Account Name'.
5. Facoltativamente, 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. 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

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

1. Creare una connessione al connettore che desideri utilizzare.
2. Aggiungere riferimento a una connessione alla connessione in Dataverse ambiente.
3. Nell'editor di espressioni del plug-in con poco codice Power Fx , digitare il nome di riferimento a una connessione (il nome interno con un prefisso e un carattere di sottolineatura, ad esempio new_connectorName, non 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, rivedere la documentazione del connettore per assicurarsi di passare correttamente i parametri di input e output.

Ulteriori informazioni: esempio

Testare un plug-in con uso limitato di codice

Testare i plug-in istantanei

1. Dalla schermata Home, 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. Fornire valori per tutti i parametri di input definiti nel plug-in con poco 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 Dataverse Acceleratore :
   1. Seleziona plug-in istantaneo dall'elenco.
   2. Seleziona Copia il codice frammento 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. Nella Power Apps:
   1. Crea o modifica un'app canvas (o una pagina personalizzata) nel file Power Apps Studio.
   2. Nella navigazione a sinistra, sotto la scheda Origini dati , Seleziona + Nuovo origine dati e cerca l'opzione ambiente dal connettore Dataverse .
   3. Inserisci i seguenti componenti nella canvas:
   • Aggiungere controlli di input che corrispondono al tipo di dati di ciascun parametro, ad esempio Input di testo per testo o numeri, Toggle per booleano.
   • 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.
   • Aggiungere un pulsante per richiamare il plug-in.
3. Incolla la formula del plug-in che hai copiato nella proprietà del pulsante. OnSelect
4. Mappare ogni parametro di input Value per fare riferimento ai controlli di input corrispondenti:
   • Se la formula fosse Environment.new_CalculateSum({ X: Value, Y: Value });, potrebbe essere riscritta come: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
   • Se la formula è stata vincolata, sostituisci Environment con la tabella nome visualizzato per accedere al plug-in.
5. Se è definito un parametro di output per il plug-in con poco codice:
   1. Cattura risposta in una Set() o UpdateContext() formula: Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Visualizza la variabile in un'etichetta. In alternativa, utilizzare 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 puoi chiamare Dataverse azioni direttamente dalle Power Fx 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 ha eseguito l'azione denominata Esegui un'azione non vincolata o Esegui un'azione vincolata.
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

Seguire i passaggi per le sezioni Azione non associata o Funzione associata alla tabella nella Richiamo 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 e problemi noti sui plug-in con poco codice

Guida e supporto

Per problemi con l' Dataverse installazione della soluzione Accelerator o con i plug-in con poco codice non trattati nei Microsoft Dataverse suggerimenti e problemi noti sui plug-in con poco codice, come errori non documentati ricevuti, utilizza l'esperienza di 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 Dataverse Plug-in 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. Utilizzare la seguente sintassi di disambiguazione, ad esempio [@Accounts], utilizzando le 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 richiedono Collect . Patch Ci sono alcuni scenari in cui Collect() non funziona. La soluzione alternativa è quella di utilizzare Patch() come mostrato nell'esempio di compilazione della colonna sottostante. 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 abbia bisogno di bloccare tutte le interazioni del plug-in con poco codice con qualsiasi connettore, può disattivare 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

con poco codice plug-in Power Fx (anteprima)

Utilizzare un prompt predefinito in un plug-in Dataverse con poco codice in Power Apps