Freigeben über


Führen Sie vordefinierte Aktionen aus einer eingebetteten Canvas-App auf dem modellgesteuerten Hostformular aus

Eingebettete Canvas-Apps bieten die Möglichkeit, vordefinierte Aktionen im modellgesteuerten Hostformular auszuführen. Diese Aktionen ermöglichen es Herstellern, das modellgesteuerte Hostformular zu navigieren, zu aktualisieren und zu speichern. Mithilfe dieser Aktionen kann eine eingebettete Canvas-App als ein weiterer wesentlicher Bestandteil des modellgesteuerten Formulars und und der modellgesteuerten App agieren.

Das ModelDrivenFormIntegration-Objekt enthält nun die folgenden neuen Methoden, damit Hersteller Aktionen auf dem modellgesteuerten Hostformular ausführen können.

Navigiert das modellgesteuerte Hostformular zu einem Hauptformular und zeigt die angegebenen Zeile an.

  • entityName – Ein erforderlicher Zeichenfolgenparameter, der die übergeordnete Tabelle des Hauptformulars angibt.
  • formName - Ein erforderlicher Zeichenfolgenparameter, der den Namen des Hauptformulars angibt, zu dem navigiert wird.
  • recordId – Ein erforderlicher Zeichenfolgenparameter, der die ID der Zeile angibt, die im Hauptformular angezeigt wird.

Das Anrufen der NavigateToMainForm-Methode kann die folgende Fehlermeldungen anzeigen.

Fehlermeldung Leitfaden für Fehlerbehebung
Die Tabelle wurde nicht gefunden: [EntityName] Sehen Sie sich den Wert des Parameters entityName an und stellen Sie sicher, dass es ein gültiger Tabellenname ist und der Benutzer Zugriff darauf hat.
Formular nicht gefunden: [FormName] Sehen Sie sich den Wert des Parameters mainFormName an und stellen Sie sicher, dass es ein gültiger Hauptformularname ist und der Benutzer Zugriff daraf hat.
Beim Laden der Zeile ist ein Problem aufgetreten. Sehen Sie sich den Wert des Parameters recordId an und stellen Sie sicher, dass es eine gültige Zeilen-ID ist und der Benutzer Zugriff darauf hat.

Navigiert das modellgesteuerte Hostformular zu einer Ansicht.

  • entityName – Ein erforderlicher Zeichenfolgenparameter, der die übergeordnete Tabelle der Ansicht angibt.
  • viewName - Ein erforderlicher Zeichenfolgenparameter, der den Namen des Hauptformulars angibt, zu dem navigiert wird.

Das Anrufen der NavigateToView-Methode kann die folgende Fehlermeldungen anzeigen.

Fehlermeldung Leitfaden für Fehlerbehebung
Die Tabelle wurde nicht gefunden: [EntityName] Sehen Sie sich den Wert des Parameters entityName an und stellen Sie sicher, dass es ein gültiger Tabellenname ist und der Benutzer Zugriff darauf hat.
Ansicht nicht gefunden: [ViewName] Sehen Sie sich den Wert des Parameters viewName an und stellen Sie sicher, dass es ein gültiger Ansichtsname ist und der Benutzer Zugriff daraf hat.

OpenQuickCreateForm (entityName)

Öffnet das Standard-Schnellerfassungsformular für eine Tabelle.

  • entityName – Ein erforderlicher Zeichenfolgenparameter, der die übergeordnete Tabelle des Schnellerfassungsformulars angibt.

Das Anrufen der OpenQuickCreateForm-Methode kann die folgende Fehlermeldungen anzeigen.

Fehlermeldung Leitfaden für Fehlerbehebung
Die Tabelle wurde nicht gefunden: [EntityName] Sehen Sie sich den Wert des Parameters entityName an und stellen Sie sicher, dass es ein gültiger Tabellenname ist und der Benutzer Zugriff darauf hat.

RefreshForm (showPrompt)

Aktualisiert die Daten im modellgesteuerten Hostformular.

  • showPrompt – Ein erforderliches boolescher Parameter, der angibt, ob dem Benutzer eine Bestätigungseingabeaufforderung angezeigt wird, bevor nicht gespeicherten Daten im modellgesteuerten Hostformular gespeichert werden. Die Werte sollen "true" oder "false" lauten.

Das Anrufen der RefreshForm-Methode kann die folgende Fehlermeldungen anzeigen.

Fehlermeldung Leitfaden für Fehlerbehebung
Verwenden Sie "true" oder "false" als Parameterwert. Sehen Sie sich den Wert des Parameters showPrompt an und stellen Sie sicher, dass er entweder "true" oder "false" lautet.

SaveForm()

Speichert die Daten im modellgesteuerten Hostformular.

Hinweis

Wenn Sie IntelliSense für die Methoden zum Ausführen vordefinierter Aktionen nicht in eingebetteten Canvas-Apps finden, die erstellt wurden, bevor die Funktion zur Verfügung gestellt wurde, schließen Sie die App und öffnen Sie sie erneut.

Siehe auch

Einbetten einer Canvas-App in einem modellgesteuerten Formular
Hinzufügen einer eingebetteten Canvas-App in einem modellgesteuerten Formular
Bearbeiten einer Canvas-App, die in einem modellgesteuerten Formular eingebettet ist
Anpassen der Bildschirmgröße und Ausrichtung einer Canvas-App, die in einem modellgesteuerten Formular eingebettet ist
Eigenschaften und Aktionen des ModelDrivenFormIntegration-Steuerelements
Teilen einer eingebetteten Canvas-App
Richtlinien zum Arbeiten mit eingebetteten Canvas-Apps
Migrieren von eingebetteten Canvas-Apps in modellgesteuerten Formularen, die mithilfe der öffentlichen Vorschauversion als die neueste Version erstellt wurden

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).