Estensione tramite script

  • 8 minuti

I siti Web Power Pages non supportano le regole di business lato client né i processi JavaScript personalizzati disponibili per i moduli basati su modello.

Elenchi, Moduli e Moduli con più passaggi includono una colonna JavaScript personalizzata che consente agli sviluppatori di aggiungere script per implementare le funzionalità richieste quando si carica un elenco o un modulo specifico.

Screenshot del codice JavaScript personalizzato aggiunto al modulo nell'app Power Pages Management.

Si può aggiungere codice JavaScript personalizzato direttamente a una pagina del sito Web con l'editor Visual Studio Code. Con l'app Power Pages Management si può anche includere lo script come parte di un modello Web, rendendo disponibile la funzionalità a qualsiasi pagina basata su tale modello.

Le funzionalità vanno dall'azione di nascondere i controlli e dalla sostituzione dei controlli di input con equivalenti semplici da usare, al richiamo di servizi Web esterni e all'implementazione di scenari di integrazione sofisticati.

Per impostazione predefinita, i siti Web Power Pages includono la libreria jQuery, che rende la modifica del contenuto e dell'aspetto delle pagine un'attività ragionevolmente semplice.

Controlli e colonne

Un modulo Contattaci predefinito crea una riga nella tabella Feedback in Microsoft Dataverse. Tale riga include una colonna Titolo obbligatoria visualizzata nel modulo con l'etichetta Oggetto. Questa colonna può confondere i visitatori del sito. Non è possibile usare CSS per nascondere il controllo perché rimane l'asterisco rosso indicante che la colonna è obbligatoria. JavaScript consente di nascondere la colonna in modo relativamente semplice. Per impostare questa colonna su un valore predefinito e quindi nasconderla, effettuare i seguenti passaggi:

  1. Aprire la pagina Contattaci nello studio di progettazione di Power Pages.

  2. Selezionare Modifica codice, quindi attendere l'apertura di Visual Studio Code.

  3. Selezionare il file Contact us.en-US.customjs.js.

    Importante

    Il nome del file include il codice della lingua che potrebbe essere diverso nell'ambiente in uso.

  4. Aggiungere il seguente script al file:

    $(document).ready
(
 function()
 {
 $("#title").val('Submitted from contact us form'); // sets the value
 $("#title").closest('tr').hide(); // hide the row containing the column
 }
);

    Nota

    Alcuni modelli Power Pages usano la tabella Feedback e la colonna Titolo. Alcuni modelli Microsoft Dynamics 365 potrebbero usare una tabella (ad esempio Lead) e una colonna diverse (ad esempio Oggetto). Controllare la pagina Contattaci e il modulo usato nel proprio sito Web e modificare lo script se richiesto.

    Screenshot dello script aggiunto al codice sorgente della pagina.

  5. Usare il tasto di scelta rapida Ctrl + S (⌘ + S su Mac) per salvare il file.

  6. Chiudere la scheda del browser con l'editor Visual Studio Code, quindi selezionare Sincronizza nella finestra di progettazione per sincronizzare le modifiche.

  7. Selezionare Anteprima > Desktop.

    Viene visualizzata una nuova finestra con il modulo Contattaci, con la colonna Argomento (etichetta Oggetto) nascosta.

JavaScript è un modo semplice per aggiungere comportamenti o funzionalità supplementari al sito Web Power Pages. Il codice può essere aggiunto direttamente a una pagina oppure alla configurazione di Modulo (tramite l'app Power Pages Management) o come parte di un modello Web, in base alle esigenze dell'ambito. Si può anche usare lo script nel modulo per completare le seguenti azioni:

  • Implementare regole di business.

  • Aggiungere dipendenze tra elementi, come le colonne di scelta dipendenti.

  • Eseguire un'altra convalida del modulo.

  • Chiamare API Web o servizi esterni dei portali.

Queste opzioni forniscono alternative ragionevoli alle regole di business lato client e agli script nei moduli basati su modello.

Per altre informazioni, consultare Aggiunta di JavaScript personalizzato a un modulo.