Festlegen von Feldwerten mithilfe von Parametern, die an ein Formular übergeben werden

 

Veröffentlicht: November 2016

Gilt für: Dynamics CRM 2015

Der Inhalt dieses Themas kann für Microsoft Dynamics CRM 2015 und Microsoft Dynamics CRM Online 2015-Update verwendet werden. Sie können Standardwerte für benutzererstellte neue Datensätze festlegen, indem Sie Attributwerte in der URL angeben, die verwendet wird, um das Formular zu öffnen. Standardmäßig werden diese Werte im Formular festgelegt, können jedoch von Benutzern geändert werden, bevor sie den Datensatz speichern.

In diesem Thema

Parametern zum Festlegen von Feldwerten übergeben

Beispiel: Festlegen des Werts für Zeichenfolgenfelder

Werte für Suchfelder festlegen

Beispiel: Festlegen des Werts für Suchfelder

Beispiel: Festlegen des Werts für Datumsfelder

Beispiel: Festlegen des Werts für Optionssatzfelder

Beispiel: Verwenden von Xrm.Utility.openEntityForm zum Öffnen eines neuen Fensters

Beispiel: Verwenden von window.open zum Öffnen eines neuen Fensters

Parametern zum Festlegen von Feldwerten übergeben

Hinweis

Sie können Parameterwerte an das Formular übergeben, um mithilfe der Funktion Xrm.Utility.openEntityForm Feldwerte festzulegen. Ein Beispiel finden Sie unter Beispiel: Verwenden von Xrm.Utility.openEntityForm zum Öffnen eines neuen Fensters.

Wenn Sie ein neues Formular öffnen, indem Sie die URL-Adresse verwenden, können Sie Argumente in den Parameter extraqs einfügen, um Feldwerte festzulegen. Die folgenden Anforderungen müssen erfüllt sein:

  • Sie müssen den Parameter codieren, der im Parameter extraqs übergeben wird. Um die Parameter zu codieren, verwenden Sie encodeURIComponent.

  • Die Namen der Abfragezeichenfolgenargumente müssen mit den Namen der Attribute für die Entität übereinstimmen oder diese enthalten.

  • Die übergebenen Werte müssen gültig sein.

  • Der Wert kann kein Skript sein.

Jeder Versuch, einen ungültigen Parameter oder Wert zu übergeben, ergibt einen Fehler.

  • Verwenden Sie für boolesche Felder entweder einen Ganzzahlwert von 0 bzw. 1 oder einen Textwert von true bzw. false, um den Wert festzulegen.

  • Für Datum-Zeit-Felder verwenden Sie den Textwert des Datums.

Beispiel: Festlegen des Werts für Zeichenfolgenfelder

Im folgenden Beispiel wird der Wert für das Feld Name eines neuen Firmendatensatzes als "Neue Firma" festgelegt.

Der uncodierte Wert für den Parameter extraqs ist “name=Neue Firma".

/main.aspx?etn=account&extraqs=name%3DNew%20Account&pagetype=entityrecord

Werte für Suchfelder festlegen

Die folgende Tabelle beschreibt fünf Typen von Suchfeldern. Beispiele zur Verwendung von Suchfeldern finden Sie unter Beispiel: Festlegen des Werts für Suchfelder und Beispiel: Verwenden von Xrm.Utility.openEntityForm zum Öffnen eines neuen Fensters.

Suchtyp

Beschreibung

einfache Suche

Erlaubt einen einzelnen Verweis auf einen Entitätstyp.

Kundensuche

Erlaubt eine einzelne Referenz zu einem Konto- oder einem Kontaktdatensatz.

Besitzersuche

Erlaubt einen einzelnen Verweis auf einen Team- oder einen Systembenutzerdatensatz.

Partylist-Suche

Erlaubt mehrere Referenzen zu mehreren Entitäten.

Bezug-Suche

Erlaubt eine einzelne Referenz zu mehreren Entitäten.

Die folgenden Richtlinien treffen zu, wenn der Wert einer Suche in einem Formular mithilfe eines Abfragezeichenfolgenarguments festgelegt wird:

  • Bei einfachen Suchen müssen Sie den Wert und den Text festlegen, der in der Suche angezeigt werden soll. Verwenden Sie das Suffix "Name" mit dem Namen des Attributs, um den Wert für den Text festzulegen.

    Verwenden Sie keine anderen Argumente.

  • Bei Kunden- und Besitzersuchen müssen Sie den Wert und den Namen auf die gleiche Weise festlegen wie bei einfachen Suchen. Des Weiteren müssen Sie das Suffix "Typ" verwenden, um den Typ der Entität anzugeben. Zulässige Werte sind account, contact, systemuser und team.

  • Sie können die Werte für partylist- oder für Bezug-Suchen nicht festlegen.

Beispiel: Festlegen des Werts für Suchfelder

Um Werte für Suchfelder festzulegen, verwenden Sie den Datenwert, den Namenswert, und geben Sie nur bei Kunden- oder Besitzersuchen den Typwert für das jeweilige Feld an. Im folgenden Beispiel wird das Besitzerfeld auf einen Benutzer mit dem Namen "Mark Folkerts" festgelegt.

Der uncodierte Wert für den Parameter extraqs lautet "ownerid={B8C6E040-656E-DF11-B414-00155DB1891A}&owneridname=Mark Folkerts&owneridtype=systemuser".

/main.aspx?etn=lead&pagetype=entityrecord&extraqs=ownerid%3D%7bB8C6E040-656E-DF11-B414-00155DB1891A%7d%26owneridname%3DMark%20Folkerts%26owneridtype%3Dsystemuser

Im folgenden Beispiel wird das Feld für den primären Kontakt auf “Yvonne McKay (Beispiel)” festgelegt. Der nicht-kodierte Wert für den extraqs-Parameter ist “primarycontactid={43b58571-eefa-e311-80c1-00155d2a68c4}&primarycontactidname=Yvonne McKay (sample)”.

/main.aspx?etn=account&pagetype=entityrecord&extraqs=primarycontactid%3D%7B43b58571-eefa-e311-80c1-00155d2a68c4%7D%26primarycontactidname%3DYvonne%20McKay%20(sample)

Hinweis

Für eine einfache Suche wie diese müssen Sie keinen Typwert festlegen.

Beispiel: Festlegen des Werts für Datumsfelder

Im folgenden Beispiel wird für das Feld Vorauss. Abschlussdatum für eine neue Verkaufschance auf den 31. Januar 2011 festgelegt. Der uncodierte Wert für den Parameter extraqs lautet “estimatedclosedate=01/31/11”.

/main.aspx?etn=opportunity&extraqs=estimatedclosedate%3D01%2F31%2F11&pagetype=entityrecord

Beispiel: Festlegen des Werts für Optionssatzfelder

Um den Wert für ein Feld Optionssatz festzulegen, legen Sie den Ganzzahlwert für die Option fest. Im folgenden Beispiel wird der Feldwert Rolle in einem neuen Kontaktdatensatz auf "Entscheidungsträger" festgelegt.

Der uncodierte Wert für den Parameter extraqs lautet “accountrolecode=1”.

/main.aspx?etn=contact&extraqs=accountrolecode%3D1&pagetype=entityrecord

Beispiel: Verwenden von Xrm.Utility.openEntityForm zum Öffnen eines neuen Fensters

Das folgende Beispiel legt Standardwerte für verschiedene Felder fest und veranschaulicht, wie die Xrm.Utility.openEntityForm-Funktion verwendet wird. Es entspricht dem früheren Beispiel, das die Methode window.open verwendet hat.

function OpenNewContact() {
 var parameters = {};
 //Set the Parent Customer field value to “Contoso”.
 parameters["parentcustomerid"] = "2878282E-94D6-E111-9B1D-00155D9D700B";
 parameters["parentcustomeridname"] = "Contoso";
 parameters["parentcustomeridtype"] = "account";
 //Set the Address Type to “Primary”.
 parameters["address1_addresstypecode"] = "3";
 //Set text in the Description field.
 parameters["description"] = "Default values for this record were set programmatically.";
 //Set Do not allow E-mails to "Do Not Allow".
 parameters["donotemail"] = "1";

 // Open the window.
 Xrm.Utility.openEntityForm("contact", null, parameters);
}

Beispiel: Verwenden von window.open zum Öffnen eines neuen Fensters

Das folgende Beispiel legt Standardwerte für verschiedene Felder fest und veranschaulicht, wie encodeURIComponent verwendet wird, um den Wert des Parameters extraqs zu codieren. Wenn Sie die Methode window.open verwenden, können Sie die Funktionen des Fensters steuern, das geöffnet wird.

function OpenNewContact() {
    //Set the Parent Customer field value to “Contoso”.
    var extraqs = "parentcustomerid={F01F3F6D-896E-DF11-B414-00155DB1891A}";
    extraqs += "&parentcustomeridname=Contoso";
    extraqs += "&parentcustomeridtype=account";
    //Set the Address Type to “Primary”.
    extraqs += "&address1_addresstypecode=3";
    //Set text in the Description field.
    extraqs += "&description=Default values for this record were set programatically.";
    //Set Do not allow E-mails to "Do Not Allow".
    extraqs += "&donotemail=1";
    //Set features for how the window will appear.
    var features = "location=no,menubar=no,status=no,toolbar=no";
    // Open the window.
    window.open("/main.aspx?etn=contact&pagetype=entityrecord&extraqs=" +
     encodeURIComponent(extraqs), "_blank", features, false);
}

Siehe auch

Öffnen von Formularen, Ansichten, Dialogen und Berichten mit einer URL
openEntityForm
Ein Formular konfigurieren, um benutzerdefinierte Abfragezeichenfolgenparameter zu akzeptieren.

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright