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.

Syntaxe

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

Paramètres

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.

Enregistrement d’entité

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

Objet de relation

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

Tableau de bord

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

Ressource Web HTML

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

Page personnalisée

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

Paramètre navigationOptions

L’objet navigationOptions contient les valeurs suivantes.

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)