Bearbeitbare Rasterobjekte und Methoden (clientseitige Referenz)

  • Artikel

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Sie können Ereignishandler festlegen, um Ereignissen zu abonnieren, die für bearbeitbare Raster ausgelöst werden, wenn Daten in einem bearbeitbaren Raster ausgewählt, geändert oder gespeichert werden. Bearbeitbare Raster unterstützen die meisten clientseitigen Methoden, die von nicht-bearbeitbare Rastern unterstützt werden. Weitere Informationen: Bearbeitbare Raster in Dynamics 365 verwenden

Hinweis

Bearbeitbarer Raster wurde in Update für Dynamics 365 (online und lokal), Dezember 2016eingegeben.

In diesem Thema

Bearbeitbares Raster-Ereignis

Bearbeitbare Rastermethoden

Bearbeitbares Raster-Ereignis

Bearbeitbarer Raster unterstützt die folgenden Ereignisse, die Sie für das Registrieren und die Ausführung der clientseitigen Skripts verwenden können. Sie können für diese Ereignisse mithilfe der Registerkarte Ereignisse die Seite Microsoft Dynamics 365 registrieren, die verwendet wird, um in bearbeitbaren Rastern eine Entität oder einen schreibgeschützten Raster zu aktivieren:

  • OnRecordSelect

  • OnChange

  • OnSave

Wichtig

Verwenden Sie die Ausführungskontext getFormContext-Methode, um gemeinsame Ereignishandler zu erstellen, die entweder auf einem bearbeitbaren Raster GridCell oder Formularfeld abhängig vom Ereignishandler ausgeführt wird.Weitere Informationen:getFormContext

OnRecordSelect

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

OnChange

Das OnChange-Ereignis tritt auf, wenn ein Wert an einem Computerarbeitsplatz im bearbeitbaren Raster geändert wurde und die Zelle den Fokus verliert. Dieses Ereignis kann auch auftreten, wenn ein Attributwert mithilfe der setValue-Methode aktualisiert wird.

OnSave

Das OnSave-Ereignis tritt auf, bevor die aktualisierten Informationen an den Server gesendet werden und wenn einer der folgenden Aktionen erfolgt:

  • Es gibt eine Änderung in der Datensatz-Auswahl.

  • Der Benutzer startet explizit einen Speichervorgang mithilfe der Schaltfläche "Speichern" im bearbeitbaren Raster.

  • Der Benutzer wendet den Sortierungs-, Gruppen-, Paginierungs- oder Navigationsvorgang im bearbeitbaren Raster an, wenn es ausstehende Änderungen gibt.

Wichtige zu beachtende Punkte für das OnSave-Ereignis:

  • Wenn ein Benutzer mehrere Spalten desselben Datensatzes nacheinander bearbeitet, wird das OnSave-Ereignis nur einmal aufgerufen, um optimale Leistungs- und Formkompatibilität zu gewährleisten.

  • Bearbeitbare Raster und das übergeordnete Formular haben separate Speicherschaltflächen. Beim Klicken auf die eine Speicherschaltfläche werden keine Änderungen in der anderen gespeichert.

  • Bearbeitbare Raster speichern keine ausstehenden Änderungen, wenn Navigationsvorgänge außerhalb des Kontexts ausgeführt werden. Wenn das Steuerelement nicht gespeicherten Daten enthält, können die Daten möglicherweise verloren gehen. Daher löst das OnSave-Ereignis nichts aus. Beispielsweise kann dies vorkommen, wenn Sie zu einem anderen Datensatz navigieren und eine Formularsuchfeld verwenden oder über das Menüband gehen.

  • Das Drücken der Schaltfläche "Aktualisieren " im bearbeitbaren Raster, kann alle ausstehenden Änderungen verwerfen, und das OnSave-Ereignis wird nicht ausgelöst.

  • Bearbeitbare Rastersteuerelemente implementieren keinen Zeitgeber mit automatischer Speicherung.

  • Bearbeitbares Raster unterdrücken Duplikaterkennungsregeln.

Bearbeitbare Rastermethoden

Bearbeitbarer Raster unterstützen einige neue und die meisten vorhandenen Methoden, die für schreibgeschützte Raster unterstützt werden:

  • GridControl

  • Raster

  • GridRow

  • GridRowData

  • GridEntity

  • GridAttribute

  • GridCell

GridControl

Wenn Sie den Namen des bearbeitbaren Rastersteuerelements kennen, können Sie den folgenden Code verwenden. Beispielsweise um auf den KONTAKT-Unterraster im Standardfirmenformular zugreifen:

var contactsGrid = Xrm.Page.getControl("Contacts");

Tipp

Wenn Sie die Namen von Rastersteuerelementen im Formular identifizieren möchten, ohne den Formular-Editor zu öffnen, finden Sie Informationen unter Verwenden von Browserentwicklertools.

Bearbeitbare Raster unterstützen die folgenden schreibgeschützten Rastersteuerungsmethoden: getEntityName und getGrid.

Raster

Bearbeitbare Raster unterstützen folgende Methoden für die Grid von GridControl.getGrid zurückgegebene Methode: getRows, getSelectedRows, und getTotalRecordCount.

GridRow

Bearbeitbare Raster unterstützen diegetData Methode für GridRow, die vom Grid.getRows zurückgegeben werden und Grid.getSelectedRows Methoden

GridRow unterstützt auch die data Sammlung, die Möglichkeiten bietet, mit einer bearbeitbaren Rasterzeile zu arbeiten. Siehe Sammlungen (clíentseitige Referenz) für Informationen zu Methoden zum Zugreifen auf Daten in einer Sammlung.

GridRowData

Bearbeitbare Raster unterstützen die getEntity Methode für die GridRowData , die von der GridRow.getData Methode zurückgegeben werden.

GridRowData enthält Methoden zum Abrufen von Informationen, die für den in einer bearbeitbaren Rasterzeile angezeigten Datensatz spezifisch sind, die Speichermethode und eine Sammlung aller im Formular enthaltenen Attribute. Attributdaten sind auf die Spalten begrenzt, die im bearbeitbaren Raster angezeigt werden. Siehe Sammlungen (clíentseitige Referenz) für Informationen zu Methoden zum Zugreifen auf Daten in einer Sammlung.

GridEntity

Bearbeitbare Raster unterstützen folgende Methoden für die GridEntity, die von der GridRowData.getEntity Methode zurückgegeben werden.

Abgesehen von der Verwendung GridRowData.getEntity-Methode können Sie die GridEntity anzeigen, indem Sie GridRowData.entity direkt auf das Objekt zugreifen.

GridEntity Außerdem unterstützt die attributes Sammlung, die eine Sammlung von Arbeitsmethodiken von Attributen für eine Entität im bearbeitbaren Raster bereitstellt. Jedes Attribut (GridAttribute) vertritt die Daten in der Zelle eines bearbeitbaren Rasters und umfasst einen Verweis auf alle gewünschten Zellen, die dem Attribut zugeordnet werden. Siehe Sammlungen (clíentseitige Referenz) für Informationen zu Methoden zum Zugreifen auf Daten in einer Sammlung.

GridAttribute

GridAttribute unterstützt die folgenden Arten für Attribute einer ausgewählten Rasterzeile: getName, getRequiredLevel, setRequiredLevel, getValue und setValue.

Verwenden Sie die Grid.getSelectedRows Methode, um die ausgewählten Zeile in einem bearbeitbaren Raster abzurufen.

GridAttribute unterstützt auch die controls Sammlung für Attribute einer ausgewählten Rasterzeile, die Methoden bereitstellen, um mit einer Sammlung Zellen von Zellen zu arbeiten, die einem Attribut zugewiesen sind. Jede Zelle (GridCell) einer ausgewählten Rasterzeile ist ein vergleichbares Steuerelement in einem Formular, das mit einem Attribut in einem bearbeitbaren Raster zusammenhängt. Siehe Sammlungen (clíentseitige Referenz) für Informationen zu Methoden zum Zugreifen auf Daten in einer Sammlung.

Tipp

Aus Leistungsgründen ist eine Zeile (Datensatz) in einem bearbeitbaren Raster nicht bearbeitet, bis der Datensatz ausgewählt ist. Benutzer müssen einen einzelnen Datensatz in einem Raster auswählen, um ihn zu bearbeiten. Sobald ein Datensatz in einen bearbeitbaren Raster ausgewählt ist, wertet Dynamics 365 intern eine Reihe von Punkten aus, einschließlich Benutzerzugriff zum Datensatz, ob der Datensatz aktiv ist und die Feldüberprüfungen, um sicherzustellen, dass die Datensicherheit und Gültigkeit berücksichtigt werden, wenn Sie die Daten bearbeiten. Sie können das OnRecordSelect Ereignis mit der getFormContext Methode verwenden, um auf Datensätze im Raster zuzugreifen, die einen bearbeitbaren Status aufweisen.

GridCell

Zusätzlich zu setNotification und clearNotification unterstützt die GridCell folgende Methoden für die Steuerung:

Hinweis

Bearbeitbare Raster können nicht gleichzeitig mehrere Benachrichtigungen enthalten.

getDisabled

Gibt zurück, ob die Zelle deaktiviert ist (schreibgeschützt).

gridCellObj.getDisabled()
  • Rückgabewert
    Typ: Boolesch. "True", wenn die Zelle deaktiviert ist, andernfalls "false".

setDisabled

Legt fest, ob die Zelle deaktiviert ist.

gridCellObj.setDisabled(bool)

  • Argumente
    Typ: Boolesch. "True", wenn die Zelle deaktiviert werden soll, andernfalls "false".

  • Anmerkungen
    Durch die Aktivierung einer schreibgeschützten Zelle zum Bearbeiten kann ein Fehler verursacht werden, wenn der Datensatz gespeichert wird. Wenn das Feld vom Server als schreibgeschützt betrachtet wird, kann unter Umständen ein Fehler angezeigt werden, wenn der Wert geändert wird. Dies tritt möglicherweise in den Szenarien auf, für die der Benutzer keine Schreibrechte für den Datensatz besitzt, der Datensatz deaktiviert ist, oder der Benutzer nicht über die erforderlichen Feldebenen-Sicherheitsrechte verfügt.

getLabel

Gibt die Beschriftung der Spalte zurück, die die Zelle enthält.

gridCellObj.getLabel()
  • Rückgabewert
    Typ: Zeichenfolge. Die Beschriftung der Spalte.

Siehe auch

Rasterobjekte (schreibgeschützt)und -Methoden (clientseitige Referenz)
Bearbeitbare Raster in Dynamics 365 verwenden

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright