Leggere in inglese

Condividi tramite


Usare Power Fx in Power Pages (anteprima)

[Questo argomento fa parte della documentazione di pre-rilascio, pertanto è soggetto a modifiche.]

Power Fx è il linguaggio con uso limitato di codice per esprimere la logica in Microsoft Power Platform. È un linguaggio di programmazione per utilizzo generico, fortemente tipizzato, dichiarativo e funzionale.

Power Fx è espresso in un testo di facile utilizzo. È un linguaggio a uso limitato di codice con cui i creatori possono lavorare direttamente in una barra della formula simile a Excel. L'uso limitato di codice è garantito dalla natura concisa e semplice del linguaggio, che semplifica le attività di programmazione comuni sia per i creatori che per gli sviluppatori.

Nota

Potresti trovare la sintassi per la creazione della formula Power Fx un po' diversa da quella a cui potresti essere abituato in Power Apps o Power Automate. Per iniziare un'espressione Power Fx, questa deve iniziare con "=" (segno di uguale), come in Excel. Per ulteriori informazioni, vedi Considerazioni importanti.

Power Fx consente l'intero spettro di sviluppo dagli autori senza codice senza alcuna conoscenza di programmazione fino alla codifica avanzata degli sviluppatori professionisti. Facilita la collaborazione tra team diversi, aiutandoli a risparmiare tempo e fatica.

Importante

  • Questa è una funzionalità di anteprima.
  • Le funzionalità di anteprima non sono destinate ad essere utilizzate per la produzione e sono soggette a restrizioni. Queste funzionalità sono disponibili prima di una versione ufficiale di modo che i clienti possano ottenere un accesso prioritario e fornire dei commenti.
  • La funzionalità è disponibile con Power Pages versione 9.6.5.x.

Utilizzare Power Fx in Power Pages

All'interno di un sito Web Power Pages, Power Fx è disponibile come linguaggio di espressione da utilizzare con i seguenti componenti e i relativi attributi. Questa funzionalità consente l'assegnazione dinamica di valori in base ai risultati delle espressioni Power Fx.

Componente Proprietà
Testo Testo
Image URL immagine, testo alternativo
Button URL pulsante, testo pulsante
iFrame URL iFrame

Usa la barra delle formule Power Fx

La barra degli strumenti include un nuovo comando fx per i componenti che supportano Power Fx:

Screenshot del comando Power Fx nella barra dei comandi di un controllo di testo.

Seleziona fx per accedere alla barra della formula Power Fx.

Componenti della barra della formula

Lo screenshot seguente evidenzia alcuni dei componenti importanti della barra della formula:

Screenshot della barra della formula Power Fx in Power Pages.

  1. Un menu a discesa consente di scegliere tra le proprietà dei componenti disponibili.

  2. Una casella di testo espandibile multilinea consente la creazione di formule Power Fx.

  3. Il pulsante Ripristina consente di ripristinare la proprietà predefinita di un componente.

  4. Il pulsante Salva mantiene la formula e le espressioni per la proprietà del componente. La canvas della finestra di progettazione viene immediatamente aggiornata se il valore risultante è disponibile e può essere visualizzato come nelle proprietà del testo.

Esperienze della barra della formula

Di seguito sono riportate alcune funzionalità incentrate sugli sviluppatori per una maggiore produttività:

  • Assistenza al completamento automatico: suggerisce formule, parametri, tabelle e oggetti. Seleziona CTRL + spazio per accedere manualmente a questa funzione.

    Screenshot dell'esperienza di completamento automatico in Power Fx.

  • Funzionalità di visualizzazione del problema: aiuta nella convalida e nel debug iniziali di formule ed espressioni.

    Screenshot dell'esperienza quando viene rilevato un problema in una formula Power Fx.

  • Finestra di dialogo Modifiche non salvate: viene visualizzata se esci dalla barra della formula quando sono presenti modifiche non salvate a una formula.

    Screenshot della finestra di dialogo delle modifiche non salvate con le opzioni Indietro o Ignora.

    Seleziona Indietro per continuare a modificare la formula oppure Ignora per annullare le modifiche.

Considerazioni importanti

Tieni presente le seguenti linee guida quando utilizzi la barra delle formule Power Fx in Power Pages:

  • Inizia con un segno di uguale: il testo può essere inserito direttamente come valore. Per iniziare un'espressione Power Fx, deve iniziare con un "=" (segno uguale) come nell'esempio seguente:

    =Concatenate("Hello, ", User.FullName)
    
  • Accesso sicuro alle tabelle: è possibile accedere alle tabelle Dataverse in modo sicuro utilizzando le formule. Verificare innanzitutto che le autorizzazioni della tabella siano configurate correttamente. Inoltre, il contesto di un utente del sito è disponibile utilizzando l'oggetto Utente. Ad esempio, l'espressione seguente recupera il valore DataverseUserId dell'utente attualmente autenticato.

    =Concatenate("Hello, ", First(Filter(Contacts,Contact = User.DataverseUserId)).'First Name' & "!")
    

    Nota

    L'oggetto Utente rappresenta un user Power Pages e quindi non supporta lo stesso insieme di proprietà della funzionalità Utente.

  • Inserimento di un valore all'interno del testo: per inserire un valore all'interno del testo, utilizzare la seguente sintassi.

    This text ${variable/ expression} includes a dynamic value.
    

    Ad esempio:

    The total number is ${Sum(10, 20)}
    

Funzioni Power Fx disponibili

Per l'elenco completo di tutte le funzioni disponibili in Power Pages, vai a Informazioni di riferimento sulle formule di Power Pages.

Problemi noti e limitazioni

  • Alcune funzioni Power Fx presentate tramite IntelliSense non sono attualmente supportate Power Pages. Tali funzioni visualizzano il seguente errore in fase di progettazione quando vengono utilizzate:

    Parameter 'Value': PowerFx type is not supported.

  • Il sistema non inizializza l'utente per utenti anonimi e genera il seguente errore quando viene utilizzato in qualsiasi modulo, incluso il controllo degli spazi vuoti. Questo problema sarà corretto in una versione futura.

    UserInfo object was not added to service

  • Alcuni utenti potrebbero riscontrare problemi con le proprietà del pulsante e dell'URL immagine che non funzionano quando il valore è impostato con formule Power Fx o espressioni che contengono virgolette doppie. Questo problema si verifica solo se disponi della versione 9.6.3.x e viene risolto quando il tuo sito Power Pages è stato aggiornato alla versione 9.6.5.x.

Domande frequenti

Dovrei usare Power Fx invece di Liquid?

Power Fx soddisfa determinati scenari di dati dinamici in modalità con poco codice che potrebbe essere ottenuto anche tramite codice Liquid con strumenti per sviluppatori professionisti. Power Fx, attualmente in fase di anteprima pubblica, è consigliato per valutazioni di siti di prova o di sviluppo. Accogliamo con favore il tuo feedback durante questa fase. Liquid è una funzionalità generalmente disponibile (GA) e offre più funzionalità. Utilizza Liquid per i tuoi siti Web di produzione, in particolare in scenari critici e complessi.

Vedi anche