Freigeben über

OnRecordSelect-Rasterereignis (Client-API-Referenz)

  • Artikel

Das OnRecordSelect-Ereignis tritt auf, wenn eine einzelne Zeile ( Datensatz) in einem bearbeitbaren Raster ausgewählt ist. Dieses Ereignis tritt nicht auf, wenn ein Benutzer unterschiedliche Zellen in derselben Zeile oder mehrere Zeilen auswählt.

Beispiel: Das Standardverhalten zum Öffnen in modellgesteuerten Rastern außer Kraft setzen

Wenn Sie die Art und Weise anpassen möchten, wie ein Tabellendatensatz über das Power Apps-Rastersteuerelement geöffnet wird, können Sie mit einer dem Rasterereignis OnRecordSelect zugeordneten JavaScript-Funktion steuern, wie er geöffnet wird.

Das folgende Beispiel stellt sicher, dass der Datensatz mit dem durch den Wert pageInput formId angegebenen Formular mit der Xrm.Navigation.navigateTo-Methode geöffnet wird. In diesem Beispiel müssen das Formular und das Raster zur selben Entität gehören.

Schritt 1: Erstellen eines Webressource

Erstellen, speichern und veröffentlichen Sie eine JavaScript-Webressource (JS), die den folgenden Code enthält:

var Example = window.Example || {};
(function () {
this.OnSelect = function (executionContext) {
   var pageInput = {
      pageType: "entityrecord",
      entityName: executionContext.getEventSource().getEntityName(),
      entityId: executionContext.getEventSource().getId(),
      formId: "420786E3-D342-4A9A-914B-AA331FF2D25E"    
   };
   Xrm.Navigation.navigateTo(pageInput);
}
}).call(Example);

Weitere Informationen: Erstellen oder Bearbeiten von modellgesteuerten Webressourcen

Schritt 2: Power Apps-Rastersteuerelement aktivieren

Befolgen Sie diese Schritte, um das Power Apps-Rastersteuerelement als Hauptraster (Tabellenansicht) oder innerhalb eines modellgesteuerten Formularunterrasters zu aktivieren:

Schritt 3: Registrieren Sie das benutzerdefinierte Verhalten im OnRecordSelect-Ereignis

Wenn Sie das Power Apps-Rastersteuerelement aktivieren, wird eine Ereignisse-Registerkarte angezeigt. Wählen Sie die Registerkarte Ereignisse aus:

  1. Unter dem Abschnitt Formularbibliotheken fügen Sie die Formularbibliothek aus der erstellten Webressource hinzu.
  2. Unter dem Abschnitt Ereignishandler wählen Sie das Ereignis OnRecordSelect und Hinzufügen aus, und ein Popup erscheint.
  3. Wählen Sie im Popup die gerade hinzugefügte Formularbibliothek und den Funktionsnamen Example.OnSelect aus. Dies ist der Name der in der Webressource erstellten JavaScript-Funktion. Stellen Sie sicher, dass Sie die Option Ausführungskontext als ersten Parameter übergeben aktivieren.

Weitere Informationen: Power Apps-gird-Steuerelement

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).