Définir les valeurs de champ utilisant les paramètres transmis à un formulaire

 

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Le contenu de cette rubrique peut être utilisé pour Microsoft Dynamics 365 (Online et local). Vous pouvez définir des valeurs par défaut pour les enregistrements créés par les utilisateurs en spécifiant des valeurs d’attribut dans l’URL utilisée pour ouvrir le formulaire. Par défaut, ces valeurs sont définies dans le formulaire, mais peuvent être modifiées par les utilisateurs avant qu’ils sauvegardent l’enregistrement.

Contenu de la rubrique

Transmission des paramètres pour définir des valeurs d’enregistrement de champ

Exemple : définissez la valeur des champs de chaîne

Définition des valeurs pour les champs de recherche

Exemple : définissez la valeur des champs de recherche

Exemple : définissez la valeur pour les champs de date

Exemple : définissez la valeur des champs de groupe d’options

Exemple : utilisation de Xrm.Utility.openEntityForm pour ouvrir une nouvelle fenêtre

Exemple : utilisation de window.open pour ouvrir une nouvelle fenêtre

Transmission des paramètres pour définir des valeurs d’enregistrement de champ

Notes

Vous pouvez transmettre les valeurs de paramètre au formulaire pour définir des valeurs de champ à l’aide de la fonction Xrm.Utility.openEntityForm. Vous trouverez un exemple dans Exemple : utilisation de Xrm.Utility.openEntityForm pour ouvrir une nouvelle fenêtre.

Lorsque vous ouvrez un nouveau formulaire à l’aide de l’adresse URL, vous pouvez inclure des arguments dans le paramètre extraqs pour définir des valeurs de champ. Les besoins suivants doivent être respectés :

  • Vous devez encoder les paramètres transmis dans le paramètre extraqs. Pour encoder les paramètres, utilisez encodeURIComponent.

  • Les noms des arguments de chaîne de requête doivent correspondre ou inclure les noms des attributs de l’entité.

  • Les valeurs transmises doivent être valides.

  • La valeur ne peut pas être un script.

Toute tentative de transmission d’un paramètre ou d’une valeur non valide génèrera une erreur.

  • Pour les champs booléens, utilisez une valeur entière 0 ou 1, ou une valeur de texte true ou false pour définir la valeur.

  • Pour les champs DateTime, utilisez la valeur de texte de la date.

Exemple : définissez la valeur des champs de chaîne

L’exemple suivant définit la valeur du champ Nom d’un nouvel enregistrement de compte sur « Nouveau compte ».

La valeur non codée pour le paramètre extraqs est « nom = Nouveau compte ».

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

Définition des valeurs pour les champs de recherche

Le tableau suivant décrit cinq types de champs de recherche. Pour obtenir des exemples utilisant les champs de recherche, voir Exemple : définissez la valeur des champs de recherche et Exemple : utilisation de Xrm.Utility.openEntityForm pour ouvrir une nouvelle fenêtre.

Type de recherche

Description

recherche simple

Permet une référence unique à un type d’entité.

recherche par le client

Permet une référence unique à un enregistrement de compte ou à un enregistrement de contact.

recherche par l’utilisateur

Permet une référence unique à un enregistrement d’équipe ou à un enregistrement d’utilisateur de système.

recherche PartyList

Permet plusieurs références à plusieurs entités.

concernant la recherche

Permet une référence unique à plusieurs entités.

Les instructions suivantes s’appliquent lors de la définition de la valeur d’une recherche dans un formulaire à l’aide d’un argument de chaîne de requête :

  • Pour les recherches simples, vous devez définir la valeur et le texte à afficher dans la recherche. Utilisez le suffixe « nom » avec le nom de l’attribut pour définir la valeur du texte.

    N’utilisez pas d’autres arguments.

  • Pour les recherches par le client et le propriétaire, vous devez définir la valeur et le nom de la même façon que vous les définissez pour des recherches simples. En outre, vous devez utiliser le suffixe « type » pour spécifier le type d’entité. Les valeurs autorisées sont accountcontactsystemuser et team.

  • Vous ne pouvez pas définir les valeurs pour partylist ou concernant les recherches.

Exemple : définissez la valeur des champs de recherche

Pour définir les valeurs des champs de recherche, utilisez la valeur de données, la valeur de nom et pour les recherches par le client et par le propriétaire uniquement, spécifiez la valeur type pour le champ respectif. L’exemple suivant définit le champ de propriétaire sur un utilisateur nommé « Mark Folkerts ».

La valeur non codée pour le paramètre extraqs correspond à « 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

L'exemple suivant définit le champ de contact principal sur une utilisatrice appelée « Yvonne McKay (sample) ». La valeur non codée du paramètre extraqs est « 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)

Notes

Pour une recherche simple telle que celle-ci, vous n'avez pas besoin de définir une valeur de type.

Exemple : définissez la valeur pour les champs de date

L'exemple suivant définit le champ Date de fermeture estimée d'une nouvelle opportunité au 31 janvier 2011. La valeur non codée du paramètre extraqs est « estimatedclosedate=31/01/11 ».

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

Exemple : définissez la valeur des champs de groupe d’options

Pour définir la valeur d’un champ Groupe d’options, définissez l’entier pour l’option. L’exemple suivant définit la valeur de champ Rôle sur « Décisionnaire » dans un nouvel enregistrement de contact.

La valeur non codée pour le paramètre extraqs est « accountrolecode=1 ».

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

Exemple : utilisation de Xrm.Utility.openEntityForm pour ouvrir une nouvelle fenêtre

L’exemple suivant définit les valeurs par défaut sur différents champs et montre comment utiliser la fonction Xrm.Utility.openEntityForm. Elle correspond à l’exemple précédent qui utilisait la méthode window.open.

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);
}

Exemple : utilisation de window.open pour ouvrir une nouvelle fenêtre

L’exemple suivant définit les valeurs par défaut sur différents champs et montre comment utiliser encodeURIComponent pour encoder la valeur du paramètre extraqs. Si vous utilisez la méthode window.open, vous pouvez contrôler les fonctionnalités de la fenêtre qui est ouverte.

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);
}

Voir aussi

Ouvre les formulaires, vues, boîtes de dialogue et rapports avec une URL
openEntityForm
Configurer un formulaire pour accepter les paramètres de chaîne de requête personnalisés

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright