Aggiungere componenti di codice a una pagina personalizzata per un'app basata su modello

Articolo
03/16/2023

Questo articolo descrive l'uso di componenti di codice creati da sviluppatori professionisti utilizzando il Power Apps component framework in una pagina personalizzata. Per l'estendibilità UX personalizzata con uso limitato di codice, vedi Aggiungere componenti canvas a una pagina personalizzata per un'app basata su modello.

Importante

Le pagine personalizzate sono una nuova funzionalità con modifiche significative al prodotto e attualmente presentano una serie di limitazioni note descritte in Problemi noti relativi alle pagine personalizzate.

Nota

Le pagine personalizzate supportano tutte le API del framework dei componenti attualmente supportate per le app canvas.
Alcune API specifiche per app basate su modello come WebAPI e Navigation hanno pubblicato supporto dell'app per pagine personalizzate. Queste API possono essere usate nel componente di codice per le pagine personalizzate e funzionano nell'app pubblicata finale.
Per lo stato del supporto di singole API in ogni piattaforma, vedi Riferimento API di Power Apps component framework

I componenti di codice offrono agli sviluppatori professionisti la possibilità di creare componenti di codice personalizzati da utilizzare in un'app. Questo meccanismo di estendibilità con uso intensivo di codice fornisce una gestione del ciclo di vita delle applicazioni (ALM) di prima classe per estendere senza problemi i componenti disponibili a tutti i creatori di app nell'organizzazione. I componenti di codice possono essere riutilizzati in pagine personalizzate, app canvas e app basate su modello. Possono essere aggiornati, inclusi in pacchetti e spostati centralmente utilizzando le soluzioni Microsoft Dataverse standard. Maggiori informazioni: Panoramica di Power Apps component framework

Abilitare Power Apps component framework per pagine personalizzate

Per utilizzare i componenti di codice in una pagina personalizzata, è necessario abilitare la funzionalità Power Apps component framework. Maggiori informazioni: Abilitare la funzionalità Power Apps component framework

Creare componenti di codice da usare in una pagina personalizzata

Questa sezione descrive come creare, importare e testare componenti di codice.

Creazione e importazione di componenti di codice in Dataverse

I componenti di codice per pagine personalizzate seguono lo stesso schema dell'app canvas. I componenti di codice devono essere implementati prima di poter essere aggiunti a una pagina personalizzata. Per creare un componente di codice, vedi Creare il primo componente.

Puoi anche provare componenti OOB di esempio per iniziare rapidamente. Una volta completata l'implementazione del componente di codice, può essere incluso in un pacchetto in una soluzione e aggiunto a Dataverse, rendendolo disponibile per l'uso in tutte le pagine personalizzate in linea con le app basate su modello e canvas. Altre informazioni: Gestione del ciclo di vita delle applicazioni (ALM) con i componenti di codice.

Importare e utilizzare un componente di codice in una pagina personalizzata

In un ambiente, le pagine personalizzate possono utilizzare tutti i componenti di codice precedentemente importati in Dataverse utilizzando soluzioni. Nel riquadro di sinistra, seleziona Aggiungi (+), quindi seleziona Recupera altri componenti nella parte inferiore della pagina. Vedrai una scheda del codice nel riquadro Importa componenti che mostra tutti i componenti di codice presenti nell'ambiente.

Nota

Se la scheda del codice non viene visualizzata nel riquadro Importa componente, verifica che l'impostazione della funzionalità Power Apps component framework per le app canvas sia abilitata. Maggiori informazioni: Abilitare la funzionalità Power Apps component framework
Inoltre, assicurati di utilizzare l'ultima versione di creazione di Canvas App Studio.

I componenti di codice appena aggiunti sono ora disponibili nella sezione Componenti di codice. Può essere aggiunta a una pagina personalizzata.

Testare il componente di codice in Studio e nell'app pubblicata

Come le app canvas, i componenti di codice sono interattivi e possono essere testati nell'ambiente di creazione di Studio di pagine personalizzate. Tuttavia, API specifiche come Web APIs e Navigation, che includono solo il supporto runtime per pagine personalizzate quando richiamato, mostreranno il messaggio di errore "Metodo non implementato".

Puoi ignorare questo errore e pubblicare la pagina personalizzata. Aggiungi quindi questa pagina personalizzata all'app basata su modello e pubblica l'app per vedere l'API Web della pagina personalizzata in azione.

L'immagine sotto mostra il controllo di esempio dell'API Web standard e il controllo dell'API Navigation aggiunto alla pagina personalizzata in un'app basata su modello pubblicata.