Spalten in modellgesteuerten Apps (Client-API-Referenz)

Spalten enthalten Daten im modellgesteuerte Apps-Formular oder den -Rastern. Verwenden Sie die formContext.data.entity.attributes-Sammlung oder die formContext.getAttribute-Verknüpfungsmethode, um auf eine Sammlung von Spalten zuzugreifen. Weitere Informationen über die Sammlungen finden Sie unter Sammlungen (Client-API-Referenz).

Um auf eine Spalte in der Auflistung zuzugreifen, übergeben Sie entweder den Namen (Zeichenfolge) oder den Indexwert (Zahl) der Spalte als Argument an die Methode. Beispiel: formContext.getAttribute(arg). Wenn Sie kein Argument angeben, gibt die Methode eine Auflistung aller Attribute im Formular zurück.

Spalten werden nach Typ kategorisiert. Verwenden Sie die getAttributeType-Methode , um den Typ der Spalte zu bestimmen. Bestimmte Spaltenmethoden sind nur für spezifische Spaltentypen verfügbar.

Dieser Artikel enthält Informationen zu den Methoden, die für jeden Spaltentyp verfügbar sind.

Alle Spaltentypen

Die Steuerelementeigenschaft stellt eine Auflistung von Steuerelementen bereit, die der Spalte zugeordnet sind.

Die folgenden Methoden sind für alle Spaltentypen verfügbar:

Method	Description
addOnChange	Fügt eine Funktion hinzu, die ausgeführt werden soll, wenn das Ereignis der Spalte OnChange eintritt.
fireOnChange	Löst das Ereignis der Spalte OnChange aus.
getAttributeType	Gibt den Spaltentyp zurück.
getFormat	Gibt das Format der Spalte zurück.
getIsDirty	Gibt zurück, ob die Spalte nicht gespeicherte Änderungen enthält.
getName	Gibt den logischen Namen der Spalte zurück.
getParent	Gibt das übergeordnete formContext.data.entity Objekt zurück.
getRequiredLevel	Gibt zurück, ob ein Spaltenwert erforderlich oder empfohlen wird.
getSubmitMode	Gibt zurück, wenn die Daten der Spalte beim Speichern übermittelt werden.
getUserPrivilege	Gibt die Berechtigungen des Benutzers zurück, um den Wert der Spalte zu erstellen, zu lesen oder zu aktualisieren.
getValue	Gibt den Datenwert der Spalte zurück.
isValid	Gibt zurück, ob der Wert der Spalte gültig ist.
removeOnChange	Entfernt eine Funktion aus den Ereignishandlern der Spalte OnChange .
setIsValid	Legt die Gültigkeit der Spalte und eine Fehlermeldung fest.
setRequiredLevel	Legt fest, ob vor dem Speichern ein Spaltenwert erforderlich oder empfohlen wird.
setSubmitMode	Legt fest, ob die Daten der Spalte beim Speichern übermittelt werden.
setValue	Legt den Datenwert der Spalte fest.

Boolescher Spaltentyp

Zusätzlich zu den methoden, die für alle Spaltentypen verfügbar sind, stellt der boolesche Spaltentyp die folgende Methode bereit:

Method	Description
getInitialValue	Gibt den Wert der Spalte zurück, wenn das Formular geöffnet wurde.

Name des Nachschlagespaltentyps

Zusätzlich zu den für alle Spaltentypen verfügbaren Methoden stellt der Nachschlagespaltentyp die folgende Methode bereit:

Method	Description
getIsPartyList	Gibt zurück, ob der Nachschlagevorgang mehrere Datensätze als Nachschlagevorgang einer Partyliste zulässt.

Auswahlmöglichkeiten und Auswahlspaltentypen

Zusätzlich zu den methoden, die für alle Spaltentypen verfügbar sind, stellen die Auswahl- und Auswahlspaltentypen die folgenden Methoden bereit:

Method	Description
getInitialValue	Gibt den Wert der Spalte zurück, wenn das Formular geöffnet wurde.
getOption	Gibt die Option zurück, die einer angegebenen Beschriftung oder einem angegebenen Wert entspricht.
getOptions	Gibt die gültigen Optionen der Spalte zurück.
getSelectedOption	Gibt die ausgewählte Option oder Optionen zurück.
getText	Gibt den Text der ausgewählten Option oder Optionen zurück.

Zahlspaltentyp (decimal, double, integer, money)

Die folgenden Methoden sind nur für die Spalten decimal, double und integer verfügbar:

Method	Description
getMax	Gibt den maximal zulässigen Wert der Spalte zurück.
getMin	Gibt den minimal zulässigen Wert der Spalte zurück.
getPrecision	Gibt die Anzahl der Nachkommastellen zurück, die nach dem Dezimalkomma zulässig sind.
setPrecision	Legt die Anzahl der Nachkommastellen fest, die nach dem Dezimalkomma zulässig sind.

Zeichenfolgenspaltentyp

Zusätzlich zu den Methoden, die für alle Spaltentypen verfügbar sind, wie früher erklärte wurde, ist die folgende Methode nur für die Zeichenfolge Spalten verfügbar:

Method	Description
getMaxLength	Gibt die maximale Zeichenfolgenlänge der Spalte zurück.

Ähnliche Artikel

Verständnis des Xrm-Objektmodells
Steuerelemente (Client-API-Referenz)