Eseguire azioni predefinite sul modulo basato sul modello host da un'app canvas incorporata

Le app canvas incorporate forniscono la possibilità di eseguire azioni predefinite sul modulo basato sul modello host. Queste azioni consentono ai creatori di spostare, aggiornare e salvare il modulo basato sul modello host. Utilizzando queste azioni, un'app canvas incorporata può fungere da parte più integrale del modulo basato sul modello e dell'app basata sui modelli.

L'oggetto ModelDrivenFormIntegration include ora i nuovi metodi seguenti per consentire ai creatori di eseguire azioni nel modulo basato sul modello host.

Sposta il modulo basato sul modello host in un modulo principale e visualizza la riga specificata.

  • entityName - Un parametro stringa necessario che specifica la tabella padre del modulo principale.
  • formName - Un parametro stringa necessario che specifica il nome del modulo principale in cui spostarsi.
  • recordId - Un parametro stringa necessario, che specifica l'ID della riga da visualizzare nel modulo principale.

La chiamata del metodo NavigateToMainForm può visualizzare i seguenti messaggi di errore.

Messaggio di errore Istruzioni sulla risoluzione del problema
Tabella non trovata: [EntityName] Controllare il valore del parametro entityName e verificare che sia un nome di tabella valido e che l'utente vi abbia accesso.
Modulo non trovato: [FormName] Controllare il valore del parametro mainFormName e verificare che sia un nome di modulo valido e che l'utente vi abbia accesso.
Si è verificato un problema durante il caricamento della riga. Controllare il valore del parametro recordId e verificare che sia un ID riga valido e che l'utente vi abbia accesso.

Sposta il modulo basato sul modello host in una visualizzazione.

  • entityName - Un parametro stringa necessario che specifica la tabella padre della visualizzazione.
  • viewName - Un parametro stringa necessario che specifica il nome del modulo principale in cui spostarsi.

La chiamata del metodo NavigateToView può visualizzare i seguenti messaggi di errore.

Messaggio di errore Istruzioni sulla risoluzione del problema
Tabella non trovata: [EntityName] Controllare il valore del parametro entityName e verificare che sia un nome di tabella valido e che l'utente vi abbia accesso.
Visualizzazione non trovata: [ViewName] Controllare il valore del parametro viewName e verificare che sia un nome di visualizzazione valido e che l'utente vi abbia accesso.

OpenQuickCreateForm(entityName)

Apre il modulo di creazione rapida predefinito per una tabella.

  • entityName - Un parametro stringa necessario che specifica la tabella padre del modulo di creazione rapida.

La chiamata del metodo OpenQuickCreateForm può visualizzare i seguenti messaggi di errore.

Messaggio di errore Istruzioni sulla risoluzione del problema
Tabella non trovata: [EntityName] Controllare il valore del parametro entityName e verificare che sia un nome di tabella valido e che l'utente vi abbia accesso.

RefreshForm(showPrompt)

Aggiorna i dati nel modulo basato sul modello host.

  • showPrompt - Un parametro booleano necessario che indica se una richiesta di conferma deve essere visualizzata prima del salvataggio dei dati non salvati nel modulo basato sul modello host. I valori devono essere ""true" o "false".

La chiamata del metodo RefreshForm può visualizzare i seguenti messaggi di errore.

Messaggio di errore Istruzioni sulla risoluzione del problema
Utilizza "true" o "false" come valore del parametro. Verificare che il valore del parametro showPrompt sia "true" o "false".

SaveForm()

Salva i dati nel modulo basato sul modello host.

Nota

Se IntelliSense non è visibile per i metodi con cui eseguire azioni predefinite nelle app canvas incorporate create prima della funzionalità resa disponibile; salvare, chiudere e riaprire l'app.

Vedi anche

Incorporare un'app canvas in un modulo basato su modelli
Aggiungere un'app canvas incorporata in un modulo basato su modelli
Modificare un'app canvas incorporata in un modulo basato su modelli
Personalizzare le dimensioni e l'orientamento dello schermo di un'app canvasa incorporata in un modelo basato sul modello
Proprietà e azioni del controllo ModelDrivenFormIntegration
Condividere un'app canvas incorporata
Linee guida sull'utilizzo di app canvas incorporate
Migrazione delle app canvas incorporate su moduli basati sul modello creati mediante il rilascio della versione in anteprima pubblica all'ultima versione

Nota

Puoi indicarci le tue preferenze di lingua per la documentazione? Partecipa a un breve sondaggio. (il sondaggio è in inglese)

Il sondaggio richiederà circa sette minuti. Non viene raccolto alcun dato personale (Informativa sulla privacy).