navigateTo (référence de l’API client)

Navigue vers la liste de tables spécifiée, l’enregistrement de table, la ressource Web HTML ou la page personnalisée.

Notes

Cette méthode est uniquement prise en charge sur Unified Interface.

Syntaxe

Xrm.Navigation.navigateTo(pageInput,navigationOptions).then(successCallback,errorCallback);

Paramètres

Nom	Type	Requis	Description
pageInput	Object	Oui	Entrée concernant la page vers laquelle naviguer. Voir Paramètre pageInput
navigationOptions	Object	Non	Options de navigations vers une page ; permettent de l’ouvrir en ligne ou dans une boîte de dialogue. Si vous ne spécifiez pas ce paramètre, la page est ouverte en ligne par défaut.
successCallback	function	Non	Une fonction à exécuter en cas de navigation réussie vers la page dans le cas de la navigation en ligne et lors de la fermeture de la boîte de dialogue dans le cas de la navigation vers une boîte de dialogue.
errorCallback	Function	Non	Fonction à exécuter lorsque l’opération échoue.

Paramètre pageInput

La définition de l’objet change en fonction du type de page vers laquelle naviguer : liste d’entités, enregistrement d’entité, tableau de bord, ressource Web HTML ou page personnalisée.

Liste d’entités

L’objet liste d’entités contient les valeurs suivantes.

Nom	Type	Description
pageType	String	Spécifier entitylist.
entityName	String	Le nom logique de la table à charger dans le contrôle de liste.
viewId	String	(Facultatif) ID de la vue à charger. Si vous ne le spécifiez pas, accède à la vue principale par défaut de la table.
viewType	String	(Facultatif) Type de vue à charger. Spécifiez savedquery ou userquery.

Enregistrement d’entité

L’objet d’enregistrement d’entité contient les valeurs suivantes.

Nom	Type	Description
pageType	String	Spécifier entityrecord.
entityName	String	Nom logique de la table pour laquelle afficher le formulaire.
entityId	String	ID de l’enregistrement de table pour lequel afficher le formulaire (facultatif). Si vous ne spécifiez pas cette valeur, le formulaire sera ouvert en mode création.
createFromEntity	Lookup	Désigne un enregistrement qui fournira des valeurs par défaut en fonction des valeurs de colonne mappées (facultatif). L’objet de recherche a les propriétés de chaîne suivantes : entityType, id et name (facultatif).
data	Object	Objet de dictionnaire qui transmet des paramètres supplémentaires au formulaire (facultatif). Les paramètres peuvent être des colonnes de table avec des valeurs par défaut qui sont définies sur les nouveaux formulaires (voir Définir des valeurs de colonne à l’aide de paramètres transmis à un formulaire), ou des paramètres personnalisés accessibles sur le formulaire à l’aide de formContext.data.attributes (voir Configurer un formulaire pour accepter les paramètres de chaîne de requête personnalisés, et formContext.data). Des paramètres non valides provoquent une erreur.
formId	String	ID de l’instance de formulaire à afficher (facultatif).
isCrossEntityNavigate	Valeur booléenne	Indique si le formulaire est accessible depuis une autre table à l’aide de la table croisée flux des processus d’entreprise (facultatif).
isOfflineSyncError	Valeur booléenne	Indique s’il existe des erreurs de synchronisation hors ligne (facultatif).
processId	String	ID du processus d’entreprise à afficher dans le formulaire (facultatif).
processInstanceId	String	ID de l’instance du processus d’entreprise à afficher dans le formulaire (facultatif).
relationship	Object	Définissez un objet de relation pour afficher les enregistrements associés dans le formulaire (facultatif). Voir relationship.
selectedStageId	String	ID de la phase sélectionnée dans l’instance de processus d’entreprise (facultatif).
tabName	String	Définit le focus sur l’onglet du formulaire (facultatif).

Objet de relation

L’objet de relation, utilisé dans l’enregistrement d’entité, contient les valeurs suivantes.

Nom	Type	Description
attributeName	String	Nom de la colonne utilisée pour la relation.
name	String	Nom de la relation.
navigationPropertyName	String	Nom de la propriété de navigation pour cette relation.
relationshipType	Chiffre	Type de relation. Spécifiez une des valeurs suivantes : 0 : OneToMany, 1 : ManyToMany.
roleType	Chiffre	Type de rôle dans la relation. Spécifiez l’une des valeurs suivantes : 1 : Referencing, 2 : AssociationEntity.

Tableau de bord

L’objet du tableau de bord contient les valeurs suivantes.

Nom	Type	Description
pageType	String	Spécifier dashboard.
dashboardId	String	ID du tableau de bord à charger. Si vous ne spécifiez pas l’ID, accède au tableau de bord par défaut.

Ressource Web HTML

L’objet de ressource Web HTML contient les valeurs suivantes.

Nom	Type	Description
pageType	String	Spécifier webresource.
webresourceName	String	Nom de la ressource Web à charger.
data	String	(Facultatif) Les données à transmettre à la ressource Web.

Page personnalisée

L’objet page personnalisée contient les valeurs suivantes.

Nom	Type	Description
pageType	String	Spécifier custom.
name	String	Nom logique de la page personnalisée à ouvrir.
entityName	String	(facultatif) Le nom logique de la table à rendre disponible dans la page personnalisée via Param("entityName").
recordId	String	(Facultatif) L’ID de l’enregistrement de la table à rendre disponible dans la page personnalisée via Param("recordId").

Paramètre navigationOptions

L’objet navigationOptions contient les valeurs suivantes.

Nom	Type	Description
target	Chiffre	Spécifiez 1 pour ouvrir la page en ligne ; 2 pour ouvrir la page dans une boîte de dialogue. De plus, le reste des valeurs (largeur, taille, et position) ne sont valides que si vous avez spécifié 2 dans cette valeur (ouvrir la page dans une boîte de dialogue). Remarque : Les listes d’entités ne peuvent être ouvertes qu’en ligne ; les enregistrements d’entité et les ressources Web peuvent être ouverts en ligne ou dans une boîte de dialogue.
width	Nombre ou Objet	(Facultatif) Largeur de la boîte de dialogue. Pour spécifier la largeur en pixels, entrez simplement une valeur numérique. Pour spécifier la largeur en pourcentage, spécifiez un objet de type SizeValue avec les propriétés suivantes : - value : la valeur numérique de type Nombre. - unit : L’unité de mesure de type Chaîne. Spécifiez % ou px. La valeur par défaut est px.
height	Nombre ou Objet	(Facultatif) Hauteur de la boîte de dialogue. Pour spécifier la hauteur en pixels, entrez simplement une valeur numérique. Pour spécifier la largeur en pourcentage, spécifiez un objet de type SizeValue avec les propriétés suivantes : - valeur : la valeur numérique de type Nombre. - unit : L’unité de mesure de type Chaîne. Spécifiez % ou px. La valeur par défaut est px.
position	Chiffre	(Facultatif) Spécifiez 1 pour ouvrir la boîte de dialogue au centre ; 2 pour ouvrir la boîte de dialogue de l’autre côté. La valeur par défaut est 1 (au centre).
title	String	(Facultatif) Le titre de la boîte de dialogue en haut de la boîte de dialogue centrale ou latérale.

Valeur renvoyée

Renvoie une promesse. La valeur transmise une fois la promesse résolue dépend de la cible :

• en ligne : la promesse est résolue immédiatement et ne renvoie aucune valeur.

• boîte de dialogue : la promesse se résout lorsque la boîte de dialogue est fermée. Un objet est transmis uniquement si le pageType = entityRecord et que vous avez ouvert le formulaire en mode création. L’objet possède un tableau savedEntityReference avec les propriétés suivantes pour identifier l’enregistrement de table créé :

  • entityType : nom logique de la table.
  • id : Représentation sous forme de chaîne d’une valeur GUID de l’enregistrement.
  • nom : valeur de colonne principale de l’enregistrement affiché ou créé.

Exemple

Exemple 1 : Ouvrir une liste de comptes

var pageInput = {
    pageType: "entitylist",
    entityName: "account"
};
Xrm.Navigation.navigateTo(pageInput).then(
    function success() {
            // Run code on success
    },
    function error() {
            // Handle errors
    }
);

Exemple 2 : Ouvrir un enregistrement de compte existant dans une boîte de dialogue

var pageInput = {
    pageType: "entityrecord",
    entityName: "account",
    entityId: "5a57f2c3-5672-ea11-a812-000d3a339706" //replace with actual ID
};
var navigationOptions = {
    target: 2,
    height: {value: 80, unit:"%"},
    width: {value: 70, unit:"%"},
    position: 1
};
Xrm.Navigation.navigateTo(pageInput, navigationOptions).then(
    function success() {
            // Run code on success
    },
    function error() {
            // Handle errors
    }
);

Exemple 3 : ouvrir un formulaire de compte en mode création dans une boîte de dialogue

var pageInput = {
    pageType: "entityrecord",
    entityName: "account"    
};
var navigationOptions = {
    target: 2,
    height: {value: 80, unit:"%"},
    width: {value: 70, unit:"%"},
    position: 1
};
Xrm.Navigation.navigateTo(pageInput, navigationOptions).then(
    function success(result) {
            console.log("Record created with ID: " + result.savedEntityReference[0].id + 
            " Name: " + result.savedEntityReference[0].name)
            // Handle dialog closed
    },
    function error() {
            // Handle errors
    }
);

Exemple 4 : ouvrir une ressource Web HTML dans une boîte de dialogue

var pageInput = {
    pageType: "webresource",
    webresourceName: "new_sample_webresource.htm"
};
var navigationOptions = {
    target: 2,
    width: 500, // value specified in pixel
    height: 400, // value specified in pixel
    position: 1
};
Xrm.Navigation.navigateTo(pageInput, navigationOptions).then(
    function success() {
            // Run code on success
    },
    function error() {
            // Handle errors
    }
);

Articles associés

Xrm.Navigation
Navigation vers et depuis une page personnalisée (aperçu)

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).