Freigeben über


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

 

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

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright