Tutorial: Configurare il controllo editor di testo avanzato in Power Pages

Nell'esercitazione, configurerai il componente dell'editor RTF su un modulo Microsoft Dataverse e abiliterai l'editor RTF in modo che sia visibile su una pagina Web.

Questa esercitazione utilizzerà la tabella Feedback e la pagina Web Contattaci disponibile nei modelli Layout per principianti.

Prerequisiti

• Un sito che utilizza uno dei modelliLayout per principianti.

Passaggio 1: Aggiungere un componente di codice a un campo in un modulo

1. Nello studio di progettazione seleziona l'area di lavoro Dati.

2. Seleziona la tabella Commenti.

3. Seleziona Moduli quindi scegli di modificare il modulo di contatto semplice.

4. Seleziona il campo Messaggio.

5. Scegli + Componente e seleziona il componente Inserimento numero.

   

6. Seleziona Fatto.

7. Seleziona Salva e scegli Pubblica modulo.

Passaggio 2. Configurare il componente editor di testo formattato nella pagina web

Nei seguenti passaggi configureremo la pagina di commenti esistente, puoi anche creare la tua pagina e aggiungere il tuo componente modulo.

1. Nell'area di lavoro Pagine, seleziona la pagina Contattaci.

2. Il campo Messaggio verrà visualizzato nel modulo con il messaggio Abilita il componente personalizzato per vedere questo campo in anteprima.

3. Seleziona il campo e scegli Modifica campo.

4. Seleziona il campo Abilita campo componente.

   

5. Seleziona OK.

6. Selezionate Sincronizza.

Nota

Potrebbe essere necessario aumentare la dimensione dei caratteri delle colonne di testo per accogliere le informazioni aggiuntive e visualizzare i dati come testo RTF.

Passaggio 3.1: aggiungere autorizzazioni di tabella per la tabella degli allegati RTF

Per utilizzare e archiviare le immagini nell'editor di testo RTF nel portale, dovrai aggiungere autorizzazioni di tabella alla tabella Allegato RTF (msdyn_richtextfile).

1. Aprire lo studio di progettazione e selezionare l'area di lavoro Sicurezza .

2. Seleziona Autorizzazioni di tabella.

3. Seleziona + Nuova autorizzazione per creare una nuova autorizzazione di tabella per la tabella allegata RTF. Il nome può essere qualsiasi cosa, in questo esempio usiamo Allegato RTE.

4. Per Tipo di accesso seleziona Accesso globale.

   Nota

   Il tipo Accesso globale viene scelto in quanto non esiste alcuna relazione tra la tabella configurata per l'uso del controllo Rich text editor e la tabella degli allegati RTF.

5. Seleziona le caselle di controllo Lettura, Scrittura, Creazione ed Eliminazione in Autorizzazione per.

6. Assegna un ruolo Web appropriato all'autorizzazione di tabella.

Importante

Se desideri archiviare immagini come stringhe base 64 direttamente nella colonna configurata per utilizzare il controllo Rich text editor, è necessario configurare il controllo utilizzando un file di configurazione JSON. Imposta disableImages e disableDefaultImageProcessing su True per consentire il rendering coerente delle immagini in tutti i client. L'uso di questo metodo non richiede l'autorizzazione globale per la tabella degli allegati di testo RTF (msdyn_richtextfile).

Passaggio 3.2: Aggiungere l'impostazione del sito dell'API web

Per salvare e accedere agli allegati di immagini e file nel controllo dell'editor di testo RTF, aggiungere le seguenti impostazioni del sito.

1. Apri l'app Gestione portali.

2. Vai a Impostazioni sito.

3. Creare le impostazioni del sito seguenti. Se una delle due impostazioni del sito esiste già per il sito Web, aggiornare il record esistente invece di creare un duplicato. Immettere il nome, selezionare il sito Web, immettere il valore specificato e quindi selezionare Salva e chiudi.

   Nome dell'impostazione del sito	Valore
   Webapi/msdyn_richtextfile/enabled	true
   Webapi/msdyn_richtextfile/fields	msdyn_richtextfileid,msdyn_name,msdyn_imageblob,msdyn_fileblob,msdyn_parententityname,msdyn_parententity_fieldname,msdyn_parentid,statecode,statuscode

Importante

Usare l'elenco di colonne esplicite completo visualizzato per Webapi/msdyn_richtextfile/fields. La msdyn_fileblob colonna è necessaria per accedere agli allegati di file anche se si tratta di una colonna di sola lettura. Un elenco incompleto potrebbe consentire il funzionamento degli allegati di immagini mentre gli allegati di file hanno esito negativo.

Passaggio 4: Visualizza l'anteprima del sito.

1. Nello studio di progettazione, seleziona Sincronizza.

2. Seleziona Anteprima, quindi seleziona Desktop, vai a Contattaci, dovresti vedere il componente personalizzato abilitato.

   

Editor di testo RTF in un modulo di sola lettura

In un modulo di sola lettura, l'editor di testo avanzato visualizza il contenuto con la formattazione e le immagini. Il contenuto può essere letto, ma non modificato o aggiornato.

Nota

Per il trascinamento sono supportati solo i formati di file .PNG, .JPG. o .GIF.

Rendering del campo del contenuto dell'editor RTF utilizzando Liquid o l'API Web di Pages

Il campo contenuto dell'editor di testo RTF può essere visualizzato tramite Liquid o l'API Web di Pages. Se il campo contiene file di immagine, avranno un percorso di riferimento dell'API Web Dataverse. Per visualizzare queste immagini su una pagina Web di Pages, è necessario sostituire il percorso corrente con il percorso API di Pages corrispondente.

Esempio:

L'elemento dell'immagine all'interno del campo del contenuto dell'editor RTF verrà visualizzato come segue, contenendo un riferimento al percorso dell'API Web Dataverse:

   <img loading="lazy" src="/api/data/v9.0/msdyn_richtextfiles(d0a473a4-9e95-ee11-be37-000d3a5c393e)/msdyn_imageblob/$value?size=full" style="height:61px; width:376px">

Per aggiornare l'elemento immagine, sostituisci /api/data/v9.0 con /_api come mostrato di seguito:

   <img loading="lazy" src="/_api/msdyn_richtextfiles(d0a473a4-9e95-ee11-be37-000d3a5c393e)/msdyn_imageblob/$value?size=full" style="height:61px; width:376px">

Vedi anche

• Panoramica del framework dei componenti di Power Apps
• Crea il tuo primo componente
• Aggiungere componenti di codice a un campo o tabella nelle app basate su modello