Xrm.Page.data.entity-Attribut (clientseitige Referenz)

Artikel
10/31/2017

Veröffentlicht: Januar 2017

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

Attribute enthalten die Daten im Formular. Verwenden Sie die Xrm.Page.data.entity.fbaf2e7a-db2f-448f-bd24-6b3ca1ccb28e#BKMK_entityattributes-Sammlung oder die Xrm.Page.getAttribute -Verknüpfungsmethode, um auf eine Sammlung von Attributen zuzugreifen. Weitere Informationen finden Sie unter Sammlungen (clíentseitige Referenz).

Attribut-Eigenschaften und -Methoden

Boolean- und OptionSet-Attributmethoden
Die getInitialValue-, getOption-, getOptions-, getSelectedOption- und getText-Methoden bieten Möglichkeiten zum Abrufen von Informationen zu Boolean- oder OptionSet-Attributen.
Steuerelemente
Zugriffssteuerungen, die Attributen zugeordnet sind.
getAttributeType
Ruft den Attributtyp ab.
getFormat
Ruft das Attributformat ab.
getIsDirty
Bestimmt, ob der Wert eines Attributs geändert wurde seit der letzten Speicherung.
getIsPartyList
Bestimmt, ob ein Suchattribut eine PartyList-Suche darstellt.
getMaxLength
Ruft die maximale Länge einer Zeichenfolge ab, die ein Attribut, die Zeichenfolgendaten speichert, aufweisen kann.
getName
Ruft den Namen des Attributs ab.
getParent
Ruft einen Verweis zum Xrm.Page.data.entity-Objekt ab, das das übergeordnete Element aller Attribute ist.
getUserPrivilege
Bestimmt, welche Rechte ein Benutzer für Felder mit der Sicherheit auf Feldebene hat.
Anzahlattributmethoden
Verwenden Sie die getMax-, getMin- und getPrecision-Methoden, um auf Informationen zu den Eigenschaften der Anzahlattribute zuzugreifen.
OnChange-Ereignis
Verwenden Sie die addOnChange-, removeOnChange- und fireOnChange-Methoden, um Ereignishandler für das OnChange-Ereignis zu verwalten.
RequiredLevel
Verwenden Sie die setRequiredLevel- und getRequiredLevel-Methoden, um zu steuern, ob ein Attribut einen Wert besitzen muss, um einen Datensatz zu speichern.
SubmitMode
Verwenden Sie die setSubmitMode- und getSubmitMode-Methoden, um zu steuern, ob der Wert eines Attributs gesendet wird, wenn ein Datensatz gespeichert wird.
Wert
Verwenden Sie die getValue- und setValue-Methoden, um die Werte zu bestimmen, die für ein Attribut festgelegt werden, und um den Wert zu ändern.

Boolean- und OptionSet-Attributmethoden

Die getInitialValue, getOption, getOptions, getSelectedOption und getText-Methoden bieten Möglichkeiten zum Abrufen von Informationen zu Boolean- oder OptionSet-Attributen.

getInitialValue

Gibt einen Wert zurück, der den Wert darstellt, der für ein OptionSet- oder Boolean-Attribut festgelegt ist, wenn das Formular geöffnet wird.

Attributtypen: Optionset und Boolean

Xrm.Page.getAttribute(arg).getInitialValue()

Rückgabewert
Typ: Anzahl. Der Anfangswert für das Attribut.

getOption

Gibt ein Optionsobjekt zurück, wobei der Wert mit dem Argument, das an die Methode übergeben wird, übereinstimmt.

Attributtypen: optionset

Xrm.Page.getAttribute(arg).getOption(value)

Argumente
Zeichenfolgen- oder Zahlenwert
Rückgabewert
Typ: Optionsobjekt mit text- und value-Eigenschaften.

getOptions

Gibt ein Array von Optionsobjekten zurück, welche die gültigen Optionen für ein optionset-Attribut darstellen.

Attributtypen: optionset

Xrm.Page.getAttribute(arg).getOptions()

Rückgabewert
Typ: Array von Optionsobjekten.

getSelectedOption

Gibt das Optionsobjekt zurück, das in einem optionset-Attribut ausgewählt ist.

Attributtypen: optionset

Xrm.Page.getAttribute(arg).getSelectedOption()

Rückgabewert
Typ: Optionsobjekt mit text- und value-Eigenschaften.

getText

Gibt einen Zeichenfolgenwert des Texts für die aktuell ausgewählte Option für ein optionset-Attribut zurück.

Attributtypen: optionset

Xrm.Page.getAttribute(arg).getText()

Rückgabewert
Typ: Zeichenfolge. Der text-Wert der ausgewählten Option.

Hinweis

Wenn keine Option ausgewählt ist, gibt getText einen leeren Zeichenfolgenwert zurück.

Steuerelemente

Siehe Sammlungen (clíentseitige Referenz) für Informationen zu den Methoden, die durch Sammlungen verfügbar gemacht werden.

Da jedes Attribut mehr als einmal auf der Seite angezeigt werden kann, bietet die Steuerelement-Sammlung Zugriff auf alle Steuerelemente, die dieses Attribut darstellen. Wenn das Attribut nur durch ein Feld auf der Seite dargestellt wird, ist die Länger der Collection 1. Wenn Sie die control 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getName-Methode verwenden, ist der Name des ersten Steuerelements derselbe wie der Namen des Attributs. Die zweite Instanz eines Steuerelements für dieses Attribut ist ‘<attributeName>1’. Das Muster <attributeName>+N wird für jedes zusätzliche Steuerelement fortgesetzt, das dem Formular für ein bestimmtes Attribut hinzugefügt wird.

Wenn ein Formular ein Geschäftsprozessfluss-Steuerelement in der Kopfzeile anzeigt, werden zusätzliche Steuerelemente für jedes Attribut hinzugefügt, das im Geschäftsprozessfluss angezeigt wird. Diese Steuerelemente enthalten einen eindeutigen Namen, zum Beispiel: header_process_<attribute name>.

Wenn Aktionen für Steuerelemente ausgeführt werden, die an einem Attribut gebunden sind, sollten Sie immer bedenken, dass das Steuerelement möglicherweise mehrmals auf der Seite enthalten ist, und Sie sollten generell die gleichen Aktionen für jedes Steuerelement für das Attribut ausführen. Diesen Vorgang können Sie ausführen, indem Sie eine Schleife durch die gesamte Attributsteuerelementsammlung und die Aktionen für jedes Steuerelement ausführen.

Das folgende Beispiel stellt eine JavaScript-Bibliothek mit zwei wiederverwendbaren Funktionen dar, die die Attributsteuerelementsammlung verwenden, um Steuerelemente auszublenden und anzuzeigen:

SDK.Sample.hideAllAttributeControls: Blendet alle Steuerelemente für das Attribut aus.
SDK.Sample.showAllAttributeControls: Zeigt alle Steuerelemente für das Attribut an.

if (typeof (SDK) == "undefined")
{SDK = { __namespace: true }; }
SDK.Sample = { __namespace: true };
SDK.Sample.hideAllAttributeControls = function (attributeLogicalName) {
    /// <summary>
    /// Hides all controls for the attribute.
    /// </summary>
    /// <param name="attributeLogicalName" type="String" mayBeNull="false" optional="false" >
    /// The logical name of an attribute.
    /// </param>
    if ((typeof attributeLogicalName != "string") ||
        (attributeLogicalName.length <= 3))
    { throw new Error("SDK.Sample.hideAllAttributeControls attributeLogicalName parameter must be a string at least 4 characters long."); }
    Xrm.Page.getAttribute(attributeLogicalName).controls.forEach(
        function (control, i) {
            control.setVisible(false);
            }
        );
}
SDK.Sample.showAllAttributeControls = function (attributeLogicalName) {
    /// <summary>
    /// Shows all controls for the attribute.
    /// </summary>
    /// <param name="attributeLogicalName" type="String" mayBeNull="false" optional="false" >
    /// The logical name of an attribute.
    /// </param>
    if ((typeof attributeLogicalName != "string") ||
        (attributeLogicalName.length <= 3))
    { throw new Error("SDK.Sample.showAllAttributeControls attributeLogicalName parameter must be a string at least 4 characters long."); }
    Xrm.Page.getAttribute(attributeLogicalName).controls.forEach(
        function (control, i) {
            control.setVisible(true);
            }
        );
}

Um diese Funktionen zu verwenden, übergeben Sie den logischen Namen des Attributs wie hier gezeigt:

//Hide the controls for the subject attribute.
SDK.Sample.hideAllAttributeControls("subject");
//Show the controls for the subject attribute.
SDK.Sample.showAllAttributeControls("subject");

getAttributeType

Gibt einen Zeichenfolgenwert zurück, die den Typ des Attributs darstellt.

Attributtypen: Alle

Xrm.Page.getAttribute(arg).getAttributeType()

Rückgabewert
Typ: Zeichenfolge

Diese Methode gibt einen der folgenden Zeichenfolgenwerte zurück:
- boolean
- datetime
- decimal
- double
- integer
- lookup
- memo
- money
- optionset
- string

getFormat

Gibt einen Zeichenfolgenwert zurück, die die Formatierungsoptionen des Attributs darstellt.

Attributtypen: Alle

Xrm.Page.getAttribute(arg).getFormat()

Rückgabewert
Typ: Zeichenfolge

Diese Methode gibt einen der folgenden Zeichenfolgenwerte oder null zurück:
- date
- datetime
- duration
- email
- language
- none
- phone
- text
- textarea
- tickersymbol
- timezone
- url

Hinweis

Diese Formatinformationen stellen im Allgemeinen die Formatoptionen des Anwendungsfelds dar. Formatoptionen für Boolesche Felder werden nicht zur Verfügung gestellt.

Die folgende Tabelle enthält die Formatzeichenfolgenwerte, die für jeden Typ des Attributschematyps und der Formatoption zu erwarten sind.

Anwendungsfeldtyp	Format-Option	Attributtyp	Formatwert
Datum und Uhrzeit	Nur Datum	datetime	Datum
Datum und Uhrzeit	Datum und Uhrzeit	datetime	datetime
Ganze Zahl	Dauer	integer	Dauer
Einzelne Textzeile	E-Mail	string	E-Mail
Ganze Zahl	Sprache	optionset	language
Ganze Zahl	keine	integer	Keine
Einzelne Textzeile	Textbereich	string	textarea
Einzelne Textzeile	Text	string	Text
Einzelne Textzeile	Tickersymbol	string	tickersymbol
Einzelne Textzeile	Telefon	string	-Smartphone
Ganze Zahl	Zeitzone	optionset	timezone
Einzelne Textzeile	URL	string	URL

getIsDirty

Gibt einen Booleschen Wert zurück, wenn es beim Attributwert nicht gespeicherte Änderungen gibt.

Attributtypen: Alle

Xrm.Page.getAttribute(arg).getIsDirty()

Rückgabewert
Typ: Boolesch. „True“, wenn es nicht gespeicherte Änderungen gibt; andernfalls „false“.

getIsPartyList

Gibt einen Booleschen Wert zurück, der angibt, ob die Suche eine PartyList-Suche darstellt. PartyList-Suchen ermöglichen das Festlegen mehrerer Datensätze, z. B. das An:-Feld für einen E-Mail-Entitätsdatensatz.

Attributtypen: lookup

Xrm.Page.getAttribute(arg).getIsPartyList()

Rückgabewert
Typ: Boolesch. „True“, wenn das Suchattribut eine PartyList ist; andernfalls „false“
Anmerkungen
Diese Methode ist nur für 41462684-3e5d-4858-8be4-1a7c4fcdeff6#BKMK_UpdatedEntties verfügbar.

getMaxLength

Gibt eine Zahl zurück, die die maximale Länge eines Zeichenfolgen- oder Memoattributs angibt.

Attributtypen: string, memo

Xrm.Page.getAttribute(arg).getMaxLength()

Rückgabewert
Typ: Anzahl. Die maximal zulässige Länge einer Zeichenfolge für dieses Attribut.

Hinweis

das description-E-Mail-Formularattribut ist ein Memoattribut, es enthält aber keine getMaxLength-Methode.

getName

Gibt eine Zeichenfolge zurück, die den logische Name des Attributs darstellt.

Attributtypen: Alle

Xrm.Page.getAttribute(arg).getName()

Rückgabewert
Typ: Zeichenfolge. Der logische Name des Attributs.

getParent

Gibt das Xrm.Page.data.entity-Objekt zurück, das das übergeordnete Element aller Attribute ist.

Diese Funktion existiert, um eine konsistente Benutzeroberfläche für andere Objekte zu bieten. In diesem Fall, da jedes Attribut das gleiche Objekt zurückgibt, gibt es nicht viele Fälle, bei denen es nützlich ist.

Attributtypen: Alle

Xrm.Page.getAttribute(arg).getParent()

Rückgabewert
Typ:Xrm.Page.data.entity Objekt.

getUserPrivilege

Gibt ein Objekt mit drei Booleschen Eigenschaften zurück, entsprechend den Berechtigungen, die angeben, ob der Benutzer Datenwerte für ein Attribut erstellen, lesen oder aktualisieren kann. Diese Funktion ist für Szenarien vorgesehen, in denen die Sicherheit auf Feldebene die Berechtigungen eines Benutzers für ein bestimmtes Attribut ändert. Weitere Informationen finden Sie unter Wie Feldicherheit verwendet werden kann, um Zugriff auf Feldwerte in Microsoft Dynamics 365 zu steuern.

Attributtypen: Alle

Xrm.Page.getAttribute(arg).getUserPrivilege()

Rückgabewert
Typ:Objekt

Das Objekt besitzt drei Boolesche Eigenschaften:
- canRead
- canUpdate
- canCreate

Anzahlattributmethoden

Verwenden Sie die getMax-, getMin- und getPrecision-Methoden, um auf Informationen zu den Eigenschaften der Anzahlattribute zuzugreifen.

getMax

Gibt eine Zahl zurück, die den maximal zulässigen Wert für ein Attribut angibt.

Attributtypen: money, decimal, integer, double

Xrm.Page.getAttribute(arg).getMax()

Rückgabewert
Typ: Anzahl. Der maximal zulässige Wert für das Attribut.

getMin

Gibt eine Zahl zurück, die den minimal zulässigen Wert für ein Attribut angibt.

Attributtypen: money, decimal, integer, double

Xrm.Page.getAttribute(arg).getMin()

Rückgabewert
Typ: Anzahl. Der minimal zulässige Wert für das Attribut.

getPrecision

Gibt die Anzahl der zulässigen Dezimalstellen zurück.

Attributtypen: money, decimal, double und integer

Xrm.Page.getAttribute(arg).getPrecision()

Rückgabewert
Typ: Anzahl. Die Anzahl der zulässigen Dezimalstellen.

OnChange-Ereignis

Es gibt drei Möglichkeiten, die Sie verwenden können, um mithilfe des OnChange-Ereignisses für ein Attribut zu arbeiten:

addOnChange
removeOnChange
fireOnChange

addOnChange

Legt eine Funktion fest, die aufgerufen wird, wenn der Attributwert geändert wird.

Xrm.Page.getAttribute(arg).addOnChange([function reference])

Parameter
Typ: Funktionszeiger

Anmerkungen: Die Funktion wird unten auf der Ereignishandlerpipeline hinzugefügt. Der Ausführungskontext wird automatisch festgelegt als der erste Parameter, der an den Ereignishandler übergeben wird. Weitere Informationen finden Sie unter Ausführungskontext (clientseitige Referenz).

Beispiel:In diesem Beispiel enthält die JScript-Bibliothek zwei Funktionen. Das Hinzufügen der addMessageToOnChange-Funktion zum OnLoad-Formularereignis fügt die displayMessage-Funktion als Handler für das OnChange-Ereignis für das erste Attribut im Formular hinzu.
```
function addMessageToOnChange() 
{ 
   Xrm.Page.data.entity.attributes.get(0).addOnChange(displayOrgName);
}
function displayOrgName(execContext) 
{ 
   Xrm.Utility.alertDialog(execContext.getContext().getOrgUniqueName()); 
}
```

removeOnChange

Entfernt eine Funktion aus dem OnChange-Ereignishandler für ein Attribut.

Xrm.Page.getAttribute(arg).removeOnChange([function reference])

Parameter
Typ:-Funktionsverweis

Beispiel: In diesem Beispiel enthält die JScript-Bibliothek zwei Funktionen. Das Hinzufügen der removeMessageFromOnChange-Funktion zu einem anderen Formularereignis entfernt die displayOrgName-Funktion als Handler für das OnChange-Ereignis für das erste Attribut im Formular.
```
function removeMessageFromOnChange() 
{
   Xrm.Page.data.entity.attributes.get(0).removeOnChange(displayOrgName);
}
function displayOrgName(execContext) 
{ 
   Xrm.Utility.alertDialog(execContext.getContext().getOrgUniqueName()); 
}
```

fireOnChange

Veranlasst das Auftreten des OnChange-Ereignisses für das Attribut, sodass ein Skript, das dem Ereignis zugeordnet ist, ausgeführt werden kann.

Attributtypen: Alle

Xrm.Page.getAttribute(arg).fireOnChange()

RequiredLevel

Sie können steuern, ob die Anwendung erfordert, dass ein Feld Daten enthält, bevor ein Datensatz werden kann. Verwenden Sie die getRequiredLevel- und setRequiredLevel-Methoden, um diese Anforderungen anzupassen.

getRequiredLevel

Gibt einen Zeichenfolgenwert zurück, der angibt, ob ein Wert für das Attribut erforderlich oder empfohlen ist.

Attributtypen: Alle

Xrm.Page.getAttribute(arg).getRequiredLevel()

Rückgabewert
Typ: Zeichenfolge

Gibt einen der drei möglichen Werte zurück:
- none
- required
- recommended

setRequiredLevel

Legt fest, ob Daten für das Attribut erforderlich oder empfohlen sind, bevor der Datensatz gespeichert werden kann.

Wichtig

Das Verringern der erforderlichen Ebene eines Attributes kann einen Fehler verursachen, wenn die Seite gespeichert wird. Wenn das Attribut vom Server erforderlich ist, tritt ein Fehler auf, wenn kein Wert für das Attribut vorhanden ist.

Diese Methode wird nur für Felder in einem Formular nicht unterstützt. Sie können diese Methode mit Attributen nicht verwenden, die im Geschäftsprozessflussprotokoll angezeigt werden, um die Erforderlichkeitsstufe eines Geschäftsprozessflussschrittes festzulegen. Informationen zu den clientseitigen Methoden, die für Geschäftsprozessflussschritt verfügbar sind, finden Sie unter Schrittmethoden

Attributtypen: Alle

Xrm.Page.getAttribute(arg).setRequiredLevel(requirementLevel)

Argumente
Typ: Zeichenfolge

Einer der folgenden Werte:
- none
- required
- recommended

SubmitMode

Sie können steuern, wann Daten für ein Attribut gesendet werden, wenn ein Datensatz erstellt oder gespeichert wird. Beispielsweise verfügen Sie über ein Feld im Formular, das nur zum Steuern der Logik im Formular vorgesehen ist. Sie sind nicht interessiert, die Daten darin zu erfassen. Sie legen es so fest, dass die Daten nicht gespeichert werden. Oder sie haben ein Plug-In registriert, das davon abhängt, dass der Wert immer enthalten ist. Sie möchten das Attribut so festlegen, dass es immer enthalten ist. Attribute, die nicht aktualisiert werden nach dem ersten Speichern des Datensatzes, wie z. B. createdby, werden so festgelegt, dass diese beim Speichern nicht gesendet werden. Um zu erzwingen, dass ein Attributwert gesendet wird, egal ob er geändert wurde oder nicht, verwenden Sie die setSubmitMode-Funktion mit dem auf „immer“ festgelegten Modusparameter.

Wenn Sie setSubmitMode verwenden, stehen Ihnen drei Optionen zur Verfügung:

always: Der Wert wird immer gesendet.
never: Der Wert wird niemals gesendet. Wenn diese Option festgelegt ist, können keine Daten für Felder im Formular für dieses Attribut bearbeitet werden.
dirty (Standard): Der Wert wird beim Erstellen gesendet, wenn er nicht NULL ist, und beim Speichern nur dann, wenn er geändert wird.

Verwenden Sie getSubmitMode, um die aktuelle Einstellung festzulegen.

getSubmitMode

Gibt eine Zeichenfolge zurück, die angibt, wann Daten vom Attribut gesendet werden, wenn der Datensatz gespeichert wird.

Attributtypen: Alle

Xrm.Page.getAttribute(arg).getSubmitMode()

Rückgabewert
Typ: Zeichenfolge

Gibt einen der drei möglichen Werte zurück:
- always
- never
- dirty
Der Standardwert für bearbeitbare Felder ist ‘dirty’, d. h. dass der Wert nur dann zum Server gesendet wird, wenn dieser Datenwert geändert wird.

setSubmitMode

Legt fest, ob Daten vom Attribut gesendet werden, wenn der Datensatz gespeichert wird.

Attributtypen: Alle

Xrm.Page.getAttribute(arg).setSubmitMode()

Argumente
Typ: Zeichenfolge

Einer der folgenden Werte:
- always: Die Daten werden immer beim Speichern gesendet.
- never: Die Daten werden niemals beim Speichern gesendet. Wenn diese Option festgelegt ist, können Felder im Formular für dieses Attribut nicht bearbeitet werden.
- dirty: Standardverhalten. Die Daten werden beim Speichern gesendet, wenn sie geändert wurden.

Wert

Das Zugreifen auf den Wert von Attributen oder sein Festlegen sind die meist ausgeführten Aktionen in den Formularskripten.

getValue

Ruft den Datenwert für ein Attribut ab.

Attributtypen: Alle

Xrm.Page.getAttribute(arg).getValue()

Rückgabewert
Typ: Abhängig vom Typ des Attributs.

Attributtyp	Rückgabetyp
boolean	Boolescher Wert
datetime	Datum Um die Zeichenfolgenversion eines Datums unter Verwendung des bevorzugten Microsoft Dynamics 365-Gebietsschemas des Benutzers abzurufen, verwenden Sie die format- und localeFormat-Methoden. Andere Methoden formatieren Datumsangaben mithilfe des Betriebssystemgebietsschemas anstelle des bevorzugten Microsoft Dynamics 365-Gebietsschemas des Benutzers.
Dezimalzahl	Nummer
Double	Nummer
integer	Nummer
Suche	Array Ein Array von Suchobjekten. Hinweis Bestimmte Suchen ermöglichen das Zuordnen mehrerer Datensätze in einer Suche, z. B. das „An:“-Feld für einen E-Mail-Entitätsdatensatz. Daher verwenden alle Suchdatenwerte ein Suchobjekt-Array, auch wenn das Suchattribut nicht mehr als einen hinzugefügten Datensatzverweis unterstützt. Jede Suche bietet folgende Eigenschaften: entityType Zeichenfolge: der Name der Entität, der in der Suche angezeigt wird ID Zeichenfolge: die Zeichenfolgendarstellung des GUID-Werts für den Datensatz, der in der Suche angezeigt wird. Name Zeichenfolge: Der Text, der den in der Suche anzuzeigenden Datensatz darstellt.
memo	Zeichenfolge
Zahlung	Nummer
optionset	Nummer
Zeichenfolge	Zeichenfolge

setValue

Legt den Datenwert für ein Attribut fest.

Attributtypen: Alle

Xrm.Page.getAttribute(arg).setValue()

Argumente
Abhängig vom Typ des Attributs.

Attributtyp	Argumenttyp
boolean	Boolescher Wert
datetime	Datum
Dezimalzahl	Nummer
double	Nummer
Integer	Nummer
Suche	Array Ein Array von Suchobjekten. Hinweis Bestimmte Suchen, sogenannte PartyList-Suchen, ermöglichen das Zuordnen mehrerer Datensätze in einer Suche, z. B. das An:-Feld für einen E-Mail-Entitätsdatensatz. Daher verwenden alle Suchdatenwerte ein Suchobjekt-Array, auch wenn das Suchattribut nicht mehr als einen hinzugefügten Datensatzverweis unterstützt. Jeder Suchwert bietet folgende Eigenschaften: entityType Zeichenfolge: der logische Name der Entität, der in der Suche dargestellt wird. ID Zeichenfolge: die Zeichenfolgendarstellung des GUID-Werts für den Datensatz, der in der Suche angezeigt wird. Der Wert muss folgendem Format entsprechen: {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}. Name Zeichenfolge: Der Text, der den in der Suche anzuzeigenden Datensatz darstellt. Normalerweise das primäre Attribut für die Entität. Siehe Festlegen des Lookup-Attributwerts als Beispiel einer Hilfsfunktion, die Sie erstellen können, um einfache Suchattributwerte festzulegen.
memo	Zeichenfolge
Zahlung	Nummer
optionset	Nummer Hinweis Die getOptions-Methode gibt Optionswerte als Zeichenfolgen zurück. Sie müssen parseInt verwenden, um sie in Zahlen zu konvertieren, bevor Sie diese Werte verwenden können, um den Wert eines optionset-Attributs festzulegen. Gültige statuscode (Statusgrund)-Optionen hängen vom aktuellen Zustandscode des Datensatzes ab. Das statecode (Status)-Feld kann nicht in den Formularskripten festgelegt werden. Um zu wissen, welche statecode-Werte gültig sind, lesen Sie die Metadaten für die Attribute. Siehe TechNet: Standardstatus und Statusgrundwerte für eine Liste mit den Standardwerten für Systementitäten. Für benutzerdefinierte Entitäten verwenden Sie den Entitäts-Metadatenbrowser, der in Durchsuchen der Metadaten für die Organisation beschrieben ist. Anschließend sollten Sie auch benutzerdefinierte Statusübergänge, die auf das Feld angewendet wurden, berücksichtigen.Weitere Informationen:TechNet: Statusgrundübergänge definieren.
Zeichenfolge	Zeichenfolge Hinweis Ein Zeichenfolgenfeld mit dem E-Mail-Format erfordert, dass die Zeichenfolge eine gültige E-Mail-Adresse darstellt.

Hinweis

Die Aktualisierung eines Attributs mithilfe von setValue führt nicht dazu, dass OnChange-Ereignishandler ausgeführt werden. Sollen die OnChange-Ereignishandler ausgeführt werden, müssen Sie fireOnChange zusätzlich zu setValue verwenden.
Wenn Microsoft Dynamics 365 für Tablets nicht mit dem Server verbunden ist, funktioniert setValue nicht.
Sie können nicht den Wert von zusammengesetzten Attributen festlegen.Weitere Informationen:Schreiben von Skripts für zusammengesetzte Attribute.

Festlegen des Lookup-Attributwerts

Das folgende Bespiel zeigt die Definition einer setSimpleLookupValue-Hilfsfunktion an, die den Wert für einfache Suchattribute festlegt.

function setSimpleLookupValue(LookupId, Type, Id, Name) {
   /// <summary>
   /// Sets the value for lookup attributes that accept only a single entity reference.
   /// Use of this function to set lookups that allow for multiple references, 
   /// a.k.a 'partylist' lookups, will remove any other existing references and 
   /// replace it with just the single reference specified.
   /// </summary>
   /// <param name="LookupId" type="String" mayBeNull="false" optional="false" >
   /// The lookup attribute logical name
   /// </param>
   /// <param name="Type" type="String" mayBeNull="false" optional="false" >
   /// The logical name of the entity being set.
   /// </param>
   /// <param name="Id" type="String" mayBeNull="false" optional="false" >
   /// A string representation of the GUID value for the record being set.
   /// The expected format is "{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}".
   /// </param>
   /// <param name="Name" type="String" mayBeNull="false" optional="false" >
   /// The text to be displayed in the lookup.
   /// </param>
   var lookupReference = [];
   lookupReference[0] = {};
   lookupReference[0].id = Id;
   lookupReference[0].entityType = Type;
   lookupReference[0].name = Name;
   Xrm.Page.getAttribute(LookupId).setValue(lookupReference);
  }

Im Folgenden finden Sie ein Beispiel unter Verwendung der setSimpleLookupValue-Funktion zum Festlegen des primarycontactid-Attributwerts für ein Firmenformular:

setSimpleLookupValue("primarycontactid", "contact", "{6D9D4FCF-F4D3-E011-9D26-00155DBA3819}", "Brian Lamee");

Siehe auch

Cclientseitige Programmierreferenz
Kurzübersicht zum Formularskripting
Schreiben von Code für Microsoft Dynamics 365-Formulare
Verwenden des Xrm.Page-Objektmodells

Microsoft Dynamics 365

Share via

Xrm.Page.data.entity-Attribut (clientseitige Referenz)

Attribut-Eigenschaften und -Methoden

Boolean- und OptionSet-Attributmethoden

getInitialValue

getOption

getOptions

getSelectedOption

getText

Steuerelemente

getAttributeType

getFormat

getIsDirty

getIsPartyList

getMaxLength

getName

getParent

getUserPrivilege

Anzahlattributmethoden

getMax

getMin

getPrecision

OnChange-Ereignis

addOnChange

removeOnChange

fireOnChange

RequiredLevel

getRequiredLevel

setRequiredLevel

SubmitMode

getSubmitMode

setSubmitMode

Wert

getValue

setValue

Festlegen des Lookup-Attributwerts

Siehe auch

Zusätzliche Ressourcen