Informazioni sui moduli di base

I moduli di base possono essere configurati nello studio di progettazione di Power Pages. Vedi Aggiungi un modulo per ulteriori informazioni.

Configurazione dei metadati del modulo di base

Creati come configurazione basata sui dati per consentire agli utenti finali di aggiungere un modulo per raccogliere i dati nel sito Web senza dover richiedere l'intervento di uno sviluppatore per creare il modulo nel sito, i moduli Dataverse vengono creati in Area di lavoro Dati e quindi utilizzati per creare componenti dei moduli di base che possono essere inseriti in pagine Web sul sito Web o utilizzati insieme a griglie secondarie ed elenchi di entità per creare applicazioni Web complete. Altre informazioni: Informazioni sugli elenchi.

Aggiunta di un modulo al sito Web

Il modulo di base contiene relazioni a pagine Web e altre proprietà per controllare l'inizializzazione del modulo nel portale. La relazione alle pagine Web consente il ripristino dinamico della definizione di modulo per un determinato nodo della pagina nel sito Web.

Per visualizzare i moduli di base esistenti o creare nuovi moduli di base, apri l'app Gestione del portale e accedi a Contenuto>Moduli di base.

Quando si crea un nuovo modulo di base il primo passaggio consiste nel decidere il Nome del modulo della Tabella e del Dataverse di cui verrà eseguito il rendering e la modalità: Inserisci, Modifica, o Sola lettura. La modalità selezionata determinerà se si sta creando un nuovo record dal portale, modificando un record esistente o solo visualizzando informazioni su un record nel portale.

Nota

Prima di continuare, assicurati di esaminare le considerazioni per i moduli di base.

Le pagine Web associate al modulo di base possono essere visualizzate selezionando il collegamento Pagine Web elencato nei collegamenti di navigazione Correlati nel menu più a sinistra.

Quando si crea o modifica una pagina Web, è possibile specificare un Modulo di base nel campo di ricerca fornito nel modulo della Pagina Web.

Aggiungi un modulo di base usando Liquid

L'opzione Aggiungi modulo di base può anche essere aggiunta a un sito Web aggiungendo il tag Liquid {% entityform name: '<<basic form name>>' %} ad un'area di contenuto come campo Copia pagina della pagina Web o a un modello Web.

Protezione dei moduli

Nota

Questo metodo di protezione dei moduli sarà presto deprecato. Pertanto, non deve essere utilizzato. Utilizza invece le autorizzazioni di tabella appropriate e l'impostazione del ruolo Web per fornire l'accesso agli utenti per tutti i dati. Ulteriori informazioni: Modifiche alle autorizzazioni di tabella per moduli ed elenchi nei nuovi portali

Per proteggere i moduli, devi creare autorizzazioni di tabella che determinano l'accesso e la proprietà dei record in base ai ruoli Web. Se un utente si trova in un modulo di base e non dispone delle autorizzazioni, riceverà un messaggio di errore. Inoltre, vedrai anche un avviso quando un modulo è configurato con autorizzazioni di tabella non abilitate:

"Le autorizzazioni di tabella devono essere abilitate per questo record o chiunque su Internet può visualizzare i dati.".

Per abilitare le autorizzazioni per un modulo di base, seleziona la casella di controllo Abilita autorizzazioni tabella. Per ulteriori informazioni, vedi Creare ruoli web.

Attributi e relazioni del modulo di base

Name	Description
Nome	Nome descrittivo del record. Campo obbligatorio.
Nome tabella	Nome della tabella da cui il modulo verrà caricato. Campo obbligatorio.
Nome modulo	Nome del modulo nella tabella di destinazione di cui eseguire il rendering. Campo obbligatorio.
Nome scheda	Nome facoltativo di una scheda in un modulo per una tabella specificata di cui deve essere eseguito il rendering.
Modalità	Uno dei valori seguenti: Inserisci Modifica Sola lettura Se viene selezionato Inserisci ciò indica che il modulo deve inserire un nuovo record all'invio. Se viene specificato Modifica viene indicato che il modulo deve modificare un record esistente. Se viene selezionato Sola lettura indica che il modulo deve visualizzare un modulo non modificabile del record esistente. Modifica e ReadOnly richiede che esista un record di origine e i parametri specificati nei campi "Tipo di origine del record" e "Nome parametro ID record" per selezionare il record appropriato quando viene caricato il modulo nel portale.
Tipo origine record	Uno dei valori seguenti: Stringa di query Utente portale corrente Record associato a utente portale corrente Se viene selezionata Stringa di query è necessario un nome parametro che deve essere specificato nella stringa di query dell'URL nel modulo. Può essere specificato nel campo "Nome parametro ID record". Selezionando Utente portale corrente verrà recuperato il record utente del portale per l'utente autenticato corrente. Selezionando Record associato a utente portale corrente verrà recuperato il record utente del portale per l'utente autenticato corrente e quindi recupererà il record per la relazione specificata come indicato dal campo "Nome relazione".
Nome parametro ID record	Un nome di parametro fornito nella stringa di query dell'URL alla pagina Web che contiene il modulo di base.
Nome relazione	Obbligatorio quando il Tipo origine record è Record associato a utente portale corrente. Nome logico della relazione tra il record utente del portale corrente e il record di destinazione. Deve restituire lo stesso tipo di tabella specificato dal campo Nome tabella.
Consenti creazione se Null	Un valore booleano facoltativo disponibile quanto il Tipo origine record associato all'utente corrente portale. Indica che, se il record correlato non esiste, consente all'utente di crearlo per la prima volta, altrimenti verrà generata un'eccezione se il record non esiste già poiché il modulo ha bisogno di un record con cui eseguire il binding dei dati. NOTA: questa funzione non è disponibile nei moduli con più passaggi.
Abilita autorizzazioni tabella	Farà in modo che il modulo rispetti le autorizzazioni di tabella. Il valore predefinito è false per motivi di compatibilità con le versioni precedenti. Se impostato su true, sono NECESSARIE autorizzazioni esplicite per qualsiasi utente che desidera accedere al modulo. NOTA: questo metodo di protezione dei moduli sarà presto deprecato. Pertanto, non deve essere utilizzato. Utilizza invece le autorizzazioni di tabella appropriate e l'impostazione del ruolo Web per fornire l'accesso agli utenti per tutti i dati. Ulteriori informazioni: Modifiche alle autorizzazioni di tabella per moduli ed elenchi nei nuovi portali

Opzioni modulo

Nome	Descrizione
Aggiungi Captcha	Visualizza il captcha.
Mostra captcha per utenti autenticati	Visualizza il captcha per utenti autenticati.
Gruppo convalida	Nome del gruppo assegnato ai controlli dell'input per la valutazione di un inserimento valido di gruppi denominati.
Genera automaticamente passaggi dalle schede	Indica che verranno visualizzate più schede in un modulo di base con ogni scheda come passaggio sequenziale che inizia con la prima scheda e continua fino a che non si sono esplorate tutte le schede e fino a che non viene inserito il record di un invio finale. Per impostazione predefinita, non è selezionato. Il valore predefinito indica che deve essere il rendering solo di una scheda o di modulo per il passaggio corrente. Se il nome della scheda non è specificato allora viene visualizzata la prima scheda.
Esegui rendering di risorse Web inline	Elimina l'iframe che include una risorsa Web in un modulo di base.
Descrizione comando abilitata	La descrizione è impostata utilizzando la descrizione dell'attributo nella tabella di destinazione.
Mostra campi non supportati	Mostra o nascondi i nomi delle colonne con tipi di colonna Dataverse non supportati.
Imposta campi consigliati come richiesto	Rende tutti gli attributi necessari che hanno il livello di requisito del campo impostato su "Consigliato".
Rendi tutti i campi obbligatori	Rende tutti i campi obbligatori indipendentemente dal livello di requisiti del campo.
Classe CSS riepilogo convalida	Nome di una classe CSS assegnata al riepilogo di convalida. Il valore predefinito è "validation-summary alert alert-error alert-block"
Abilita collegamenti di riepilogo convalida	Un valore booleano true o false che indica se deve essere eseguito il rendering dei collegamenti dell'ancoraggio nel riepilogo di convalida per scorrere nel campo che contiene un errore. Il valore predefinito è true.
Testo collegamento riepilogo convalida	L'etichetta assegnata ai collegamenti del riepilogo di convalida. Il valore predefinito è "fai clic qui".
Testo intestazione riepilogo convalida	L'etichetta assegnata all'intestazione del riepilogo di convalida.
Istruzioni	Istruzioni per utilizzare il modulo.
Messaggio Record non trovato	Messaggio da visualizzare quando un record non viene trovato.

Impostazioni esito positivo

Nome	Descrizione
Esito positivo	Uno dei valori seguenti: Mostra messaggio di operazione completata (predefinito) Reindirizzamento
Nascondi modulo in caso di esito positivo	Richiede l'impostazione di Esito positivo su Mostra messaggio di operazione completata. Quando selezionato, il modulo viene nascosto in seguito all'invio corretto del modulo.
Messaggio di operazione completata	Richiede l'impostazione di Esito positivo su Mostra messaggio di operazione completata. Il messaggio visualizzato in seguito all'invio corretto. Se non viene specificato, verrà visualizzato un messaggio predefinito ("Invio completato correttamente"). Per ogni language pack installato e abilitato per l'organizzazione sarà disponibile un campo per inserire il messaggio nella lingua associata.
URL esterno	Richiede che Esito positivo sia impostato su Reindirizza. Specifica un URL in una risorsa esterna nel Web.
o pagina Web	Richiede che Esito positivo sia impostato su Reindirizza. Seleziona una pagina Web dal sito Web corrente.
Aggiungi stringa di query esistente	Richiede che Esito positivo sia impostato su Reindirizza. Quando selezionati, i parametri della stringa di query esistenti verranno aggiunti all'URL di destinazione prima del reindirizzamento.
Aggiungi ID record a stringa di query	Richiede che Esito positivo sia impostato su Reindirizza. Quando selezionato, l'ID del record creato è allegato alla stringa di query dell'URL a cui viene reindirizzato.
Nome parametro ID record	Richiede che Esito positivo sia impostato su Reindirizza. Il nome del parametro ID nella stringa di query dell'URL a cui viene reindirizzato.
Aggiungi stringa di query personalizzata	Richiede che Esito positivo sia impostato su Reindirizza. Stringa personalizzata che può essere aggiunta alla stringa di query esistente dell'URL di reindirizzamento.
Aggiungi valore attributo a stringa di query - Nome parametro	Richiede che Esito positivo sia impostato su Reindirizza. Un nome da fornire al parametro correlato al valore dell'attributo nella tabella di destinazione che viene allegato alla stringa di query dell'URL di reindirizzamento.
Aggiungi valore attributo a stringa di query - Nome logico attributo	Richiede che Esito positivo sia impostato su Reindirizza. Un nome logico di un attributo nella tabella di destinazione per ottenere un valore da allegare alla stringa di query dell'URL di reindirizzamento.

Impostazioni aggiuntive

Nome	Descrizione
Associa utente portale corrente	Indica che il record dell'utente al momento collegato deve essere associato al record della tabella di destinazione.
Colonna di ricerca utenti del portale	Nome logico dell'attributo nella tabella di destinazione in cui è archiviato l'utente del portale.
Partecipante impegno	Valore booleano indicante se la Colonna di ricerca utenti del portale è un tipo Partecipante impegno.
Allega file	Selezionare per includere nel modulo un controllo di caricamento del file nella parte inferiore del modulo per consentire a un file di essere allegato al record. Nota: i portali con la versione 9.2.2.x e successive non richiedono l'abilitazione Abilita autorizzazioni tabella nel modulo di base per allegare file. Tuttavia, se è stato selezionato, è necessario assicurarsi che siano forniti i privilegi appropriati nella tabella padre e nella tabella di annotazione per visualizzare il pulsante Allega file nel modulo. La tabella di annotazione deve avere almeno i privilegi Creazione e Aggiunta e la tabella padre deve avere il privilegio AppendTo corrispondente. A seconda che si disponga di un modulo di creazione o aggiornamento, potrebbe essere necessario disporre anche dei privilegi Creazione, Lettura e Scrittura per completare lo scenario del modulo. I file caricati possono essere visualizzati abilitando il controllo della sequenza temporale. Vedi Configurazione delle note per ulteriori dettagli.
Percorso di archiviazione file allegato	Opzioni: Allegato nota, Archivio BLOB di Azure. Se l'organizzazione è configurata per utilizzare Archiviazione di Azure, puoi scegliere di archiviare i file caricati per questo modulo di base. In caso contrario, i file verranno archiviati come allegati della nota.
Consenti più file	Valore booleano che indica se l'utente può caricare uno o più file o meno.
Accetta	L'attributo di accettazione specifica i tipi MIME di file che il server accetta con il caricamento del file. Per specificare più di un valore, separa i valori con una virgola (ad esempio audio/,video/,image/*).
Label	Testo visualizzato accanto al controllo di caricamento del file. Per ogni language pack installato e abilitato per l'organizzazione sarà disponibile un campo per inserire il messaggio nella lingua associata.
File allegato necessario	Rende necessario un allegato di un file per procedere.
Messaggio di errore richiesto	Messaggio visualizzato durante la convalida del modulo se Obbligatorio è true e l'utente non ha allegato un file. Per ogni language pack installato e abilitato per l'organizzazione sarà disponibile un campo per inserire il messaggio nella lingua associata.
Limita file ai tipi accettati	Forza la convalida nel campo Accetta. Se non selezionata, l'attributo Accetta verrà utilizzato solo come suggerimento per la finestra di dialogo Caricamento file.
Messaggio di errore tipo file	Il messaggio visualizzato durante la convalida del modulo se Limita file ai tipi accettati è vera e l'utente ha tentato di caricare un tipo di file non valido. Per ogni language pack installato e abilitato per l'organizzazione sarà disponibile un campo per inserire il messaggio nella lingua associata.
Dimensioni massime file (in kilobyte)	Forza la convalida della dimensione consentita massima del file caricato.
Messaggio di errore dimensioni file	Il messaggio visualizzato durante la convalida del modulo se Dimensioni massime file (in kilobyte) è vera e l'utente ha tentato di caricare un file che è troppo grande. Per ogni language pack installato e abilitato per l'organizzazione sarà disponibile un campo per inserire il messaggio nella lingua associata.
JavaScript personalizzato	Un blocco personalizzato di JavaScript che verrà aggiunto nella parte inferiore della pagina poco prima dell'elemento tag del modulo di chiusura. L'ID di input HTML di un campo di tabella è impostato sul nome logico dell'attributo. Ciò semplifica la selezione di un campo, dei valori di impostazione o di altre manipolazioni lato clienti con jQuery. $(document).ready(function() { $("#address1_stateorprovince").val("Saskatchewan");});

Riferimento tabella associata

I parametri seguenti si riferiscono all'impostazione del riferimento di tabella associata quando viene salvato il modulo.

Ciò offre un modo per associare il record corrente creato o aggiornato dal modulo con un altro record di destinazione. Ciò è utile in caso di più passaggi con i tipi di tabella multipli e per correlare i record risultanti o se la pagina viene passata a una stringa di query di un ID record che desidereresti associare. Ad esempio disponiamo di una pagina di carriere in cui sono elencati gli annunci di lavoro, ognuno con un collegamento a un'applicazione per il lavoro che contiene l'id dell'annuncio di lavoro al modulo di domanda in modo che quando viene creata l'applicazione, la registrazione del lavoro viene associata al record.

Nome	Descrizione
Imposta riferimento tabella al salvataggio	Sì o no. Un valore uguale a sì indica che un riferimento alle tabella associata deve essere assegnato quando viene salvato il modulo, in caso contrario non verrà impostato nulla.
Nome relazione	Il nome di definizione della relazione per una relazione specificata tra due tipi di tabella.
Nome logico della tabella	Nome logico della tabella di riferimento.
Nome logico attributo di tipo lookup di destinazione	Nome logico dell'attributo di tipo lookup nella tabella di destinazione creata o aggiornata.
Popola campo di tipo lookup	Se la ricerca relativa alla tabella di riferimento si trova nel modulo, il controllo di questo valore popolerà il campo nel modulo con il valore recuperato utilizzando l'impostazione seguente.
Tipo di origine	Uno dei valori seguenti: Stringa di query Se viene selezionata Stringa di query è necessario un nome parametro che deve essere specificato nella stringa di query dell'URL nel modulo. Può essere specificato nel campo Nome stringa di query. Se questo parametro è la chiave primaria, selezionare Sì per la Stringa di query è la chiave primaria, in caso contrario selezionare No e fornire il nome logico dell'attributo nella tabella di destinazione per eseguire la query specificata nel campo Nome logico attributo query. Utente portale corrente Selezionando Utente portale corrente verrà recuperato il record del contatto per l'utente autenticato corrente.
Passaggio tabella di riferimento	Il record Passaggio modulo con più passaggi di un passaggio precedente per recuperare la tabella creata o modificata in quel passaggio per associarla al record per questo passaggio corrente.
Nome stringa di query	Nome del parametro fornito nella Stringa di query dell'URL alla pagina Web che contiene il modulo con più passaggi.
La stringa di query è la chiave primaria	Sì indica che il valore Stringa di query è il valore della chiave primaria. Non indica che il valore Stringa di query è un tipo di attributo diverso dalla Chiave primaria.
Nome logico attributo query	Nome logico dell'attributo per eseguire la query al record.
Mostra dettagli ReadOnly	Indica che deve essere eseguito il rendering di un modulo nella parte superiore della pagina che visualizza informazioni in sola lettura che relative al record di riferimento. È necessario un nome modulo.
Nome modulo	Nome del modulo nella tabella di riferimento che deve essere utilizzato per visualizzare i dettagli di sola lettura.

Configurazione dell'azione Modulo di base

Per impostazione predefinita un modulo di base consentirà di leggere o aggiornare un record esistente o di inserire un nuovo record. Tuttavia, puoi facilmente abilitare e configurare anche ulteriori azioni per i record in un modulo di base (eliminazione, attivazione, disattivazione e così via). È anche possibile sostituire le etichette predefinite, le dimensioni e altri attributi che verranno visualizzati se vi sono azioni abilitate.

Queste impostazioni si trovano nella sezione Impostazioni aggiuntive del modulo di base. Per impostazione predefinita, verranno visualizzate solo le Impostazioni di base. Puoi selezionare Impostazioni avanzate per visualizzare ulteriori impostazioni.

Puoi aggiungere pulsanti azione per le azioni applicabili per un singolo record, che verranno visualizzati per ogni riga della griglia ammesso che sia stato concesso il privilegio appropriato da autorizzazioni di tabella. Di seguito vengono visualizzate le azioni disponibili:

• CANC
• Flusso di lavoro
• Crea record correlato
• Attivazione
• Disattivazione

Se fai clic su una di queste opzioni verrà visualizzata un'area di configurazione per tale azione. Inoltre, alcune tabelle hanno azioni speciali disponibili in base alla tabella:

• Calcolare il valore dell'opportunità (opportunity)
• Azione di annullamento caso (incident)
• Azione di chiusura (risoluzione) caso (incident)
• Converti offerta in ordine (quote)
• Converti ordine in fattura (salesorder)
• Genera offerta da opportunità (opportunity)
• Azione di perdita opportunità (opportunity)
• Azione di acquisizione opportunità (opportunity)
• Azione di riapertura caso (incident)
• Sospendi opportunità (opportunity)

Nota

Si consiglia di creare un flusso di lavoro anziché aggiungere un pulsante Attiva o Disattiva per tabelle predefinite dopo aver definito specifici valori stato e codice stato che necessitano per processi aziendali. Ad esempio, Incidente (opzioni di stato), Opportunità (opzioni di stato), Diritti (opzioni di stato).

Configurazione della georilevazione per i moduli di base

È possibile configurare un modulo per visualizzare un controllo mappa per visualizzare una posizione esistente come un segnaposto su una mappa o per consentire a un utente di specificare una posizione. Vedi Aggiungere la georilevazione.

Per il controllo mappa del modulo è necessaria una configurazione aggiuntiva per indicare gli ID dei diversi campi di posizione al fine di assegnare/recuperare i valori. Nel record del modulo di base è presente una sezione di configurazione che definisce i mapping di campo da specificare. I nomi dei campi varieranno in base allo schema creato.

Nota

• Il campo di indirizzo di un modulo di base di sola lettura viene sostituito con la mappa quando è abilitata la georilevazione.
• La mappa verrà sottoposta al rendering solo quando si visualizza il modulo in una finestra modale.
• La sezione di georilevazione non è visibile nell'ambiente del cloud sovrano tedesco. Se un utente ha abilitato la georilevazione utilizzando un modulo differente, ciò non viene visualizzato durante il rendering nel portale.

Convalida della richiesta

Convalida della richiesta, una caratteristica di ASP.NET dalla versione 1.1, impedisce al server di accettare contenuti contenenti HTML non codificato. Questa funzionalità è progettata per aiutare ad evitare alcuni attacchi intrusivi di script in base ai quali il codice di script client o HTML può essere inconsapevolmente inviato a un server, archiviato e quindi presentato ad altri utenti. Raccomandiamo ancora vivamente di convalidare tutti i dati di input e di codificarli HTML quando appropriato.

Per impostazione predefinita, la convalida della richiesta è abilitata nel portale con conseguente errore generico se si immette codice script senza codifica HTML all'interno dei campi del modulo di base:

Found field(s) submitted with potentially dangerous value(s) such as HTML, or script. Please review the field value(s) and try again.

Per disabilitare la convalida della richiesta, attieniti alla seguente procedura:

1. Apri l'app Gestione del portale

2. Vai a Impostazioni sito.

3. Seleziona Nuovo.

4. Digita il nome come DisableValidationWebTemplate.

5. Seleziona il record del sito Web appropriato.

6. Digita il valore come vero. Per impostazione predefinita, l'impostazione è falso che abilita la convalida della richiesta.

7. Digita la descrizione appropriata.

8. Selezionare Salva e chiudi.

Attenzione

Quando la convalida della richiesta è disabilitata, il contenuto può essere inviato a una pagina. È necessario assicurarsi che il contenuto sia codificato o elaborato correttamente.

Considerazioni

• Un modulo di base deve essere associato a una pagina Web di un determinato sito Web per visualizzare il modulo all'interno del sito.
• Le griglie secondarie della tabella Connessione non sono supportate nei moduli di base. Se si aggiunge una griglia secondaria della tabella Connessione nel modulo mediante progettazione moduli, verranno visualizzati messaggi di errore quando si esegue il rendering del modulo nel portale e si utilizza la tabella Connessione.
• I campi duplicati, i campi Elenco parti e le regole aziendali non sono supportati nei moduli di base.
• I componenti di codice a livello di campo e possono essere aggiunti ai moduli. Altre informazioni: Utilizzare componenti di codice
• Le regole aziendali e l'API del client possono consentire ai campi bloccati in un modulo di sola lettura.
• Se crei un modulo di base in modalità Inserisci, non puoi modificare l'allineamento di un pulsante o posizionare un pulsante di azione sopra il modulo di base.
• Se si esegue il rendering di un controllo di ricerca come elenco a discesa nel modulo, il filtro di record correlato non funziona.
• Le colonne di rollup nei moduli a volte possono essere visualizzate come modificabili sebbene siano destinate alla sola lettura. Per garantire che queste colonne rimangano di sola lettura, contrassegna la colonna come Sola lettura nel modulo dell'app basata su modello Dataverse.

Vedi anche

• App Gestione del portale
• Proprietà dei moduli con più passaggi
• Passaggi moduli con più passaggi
• Metadati modulo con più passaggi
• Configurazione di una griglia secondaria del modulo con più passaggi
• Configurazione di note per moduli di base e moduli con più passaggi