Esercitazione: utilizzo dei componenti di codice del set di dati

Nota

A partire dal 12 ottobre 2022, i portali Power Apps sono denominati Power Pages. Altre informazioni: Microsoft Power Pages è ora generalmente disponibile (blog)
A breve verrà eseguita la migrazione e l'unione della documentazione dei portali Power Apps con la documentazione di Power Pages.

In questa esercitazione creerai un componente di esempio utilizzando Power Apps component framework. Power Apps component framework consente agli sviluppatori professionisti e ai produttori di app di creare componenti di codice per app basate su modello e canvas. Questi componenti di codice possono fornire un'esperienza migliorata per gli utenti che lavorano con i dati su moduli, visualizzazioni e dashboard. Altre informazioni: utilizzare componenti di codice nei portali

Nota

• Questa esercitazione si basa sull'esercitazione esistente di Power Apps component framework che ti guida attraverso il componente controllo griglia Power Apps (anteprima) nell'elenco e nella griglia secondaria della pagina bianca. Puoi anche utilizzare qualsiasi componente nuovo o esistente e aggiungerlo a qualsiasi altra pagina Web per questa esercitazione. In questo caso, assicurati di utilizzare il tuo componente e la tua pagina web quando segui i passaggi di questa esercitazione.Per sapere quali componenti di codice sono supportati nei portali, vedi Utilizzare i componenti di codice nei portali. 

In questa esercitazione apprenderai a:

• Creare un componente di esempio utilizzando Power Apps component framework
• Creare un pacchetto del componente in un ambiente Microsoft Dataverse
• Configurare Power Pages per aggiungere il componente a una pagina Web
• Visitare la pagina web Power Pages per interagire con il componente

Prerequisiti

• Versione portale 9.4.9.xx o successiva. 
• Pacchetto portale di base Dataverse  9.3.2209.x  o versione successiva. 

Passaggio 1 - Creare il primo componente

Completa l'esercitazione Creare il primo componente.

Nota

Alla fine dell'esercitazione Creare il primo componente, avrai creato il pacchetto con un componente denominato TSLinearInputComponent e caricato nel tuo ambiente Dataverse.

Passaggio 2 - Aggiungere il componente di codice a visualizzazioni o griglie secondarie in un'app basata su modello

Per aggiungere il tuo componente alla tabella  Account, viste e griglie secondarie, segui i passaggi qui Convertire viste e griglie secondarie in griglie modificabili (anteprima) 

Passaggio 3: Aggiungere il componente di codice a un elenco e una griglia secondaria nel portale

In questo passaggio, creerai un nuovo modulo di base nei portali e quindi aggiungerai il componente al modulo di base creato. Puoi anche utilizzare un modulo di base esistente. 

Passaggio 3.1: Aggiungere il componente di codice agli elenchi

1. Apri l'app Gestione del portale.

2. Nel riquadro a sinistra, in  Contenuto, seleziona  Elenco. 

3. Seleziona  Nuovo. 

4. Immetti il  nome. Per esempio, Elenco account con componente di codice. 

5. Per  Nome tabella, seleziona la tabella a cui hai aggiunto il componente di codice in precedenza in questa esercitazione. 

6. Seleziona il  sito Web del portale. 

7. Imposta Utilizza un componente di codice configurato su Sì 

   

Passaggio 3.2: Aggiungere il componente di codice alle viste dell'elenco

Segui questi passaggi per abilitare il controllo nella visualizzazione entità in Dataverse. 

1. Apri l'app Gestione del portale.

2. Immetti il  nome. Per esempio, Elenco account con componente di codice. 

3. Per  Nome tabella, seleziona la tabella a cui hai aggiunto il componente di codice in precedenza in questa esercitazione. 

4. Seleziona il  sito Web del portale. 

5. Aggiungi le viste nella griglia delle impostazioni avanzate. 

   

6. Imposta Utilizza un componente di codice configurato su Sì 

Passaggio 3.3: Aggiungere il componente di codice alla griglia secondaria 

1. Apri l'app Gestione del portale.

2. Nel riquadro a sinistra, in Contenuto, seleziona Moduli di base. 

3. Seleziona il modulo di base che hai creato nel passaggio precedente. 

4. Seleziona Elementi correlati. 

5. Seleziona Metadati modulo di base. 

6. Seleziona Nuovi metadati modulo di base. 

7. Seleziona Tipo come Griglia secondaria. 

8. Seleziona Nome griglia secondaria. 

   

9. Per  Stile di controllo, seleziona  Componente di codice. 

   

Aggiungere un componente di codice basato su set di dati utilizzando il tag liquid

I componenti di codice basati su set di dati possono essere aggiunti utilizzando il tag modello Liquid  codecomponent . La chiave per denotare il componente di codice che deve essere caricato viene passata usando l'attributo nome. La chiave può essere il GUID (che è l'ID del componente di codice) o il nome del componente di codice importato in Microsoft Dataverse. 

I valori delle proprietà che il componente di codice si aspetta devono essere passati come coppia chiave/valore separati da ":" (due punti), dove la chiave è il nome della proprietà e il valore è il valore della stringa JSON. 

{% codecomponent name: <ID or name> <property1:value> <property2:value> %}

Per altre informazioni, vedi Tag modello Liquid per componenti di codice.

Limiti

Le azioni e la configurazione del filtro dei metadati negli elenchi e nella griglia secondaria non sono supportate con il comando della griglia Power Apps.

Vedi anche

Utilizzo dei componenti di codice nei portali Power Apps