navigateTo (klient-API-reference)

Navigerer til den angivne tabelliste, tabelpost, HTML-webressource eller brugerdefineret side.

Syntaks

Brug følgende syntaks til at kalde Xrm.Navigation.navigateTo().

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

Parametre

Metoden accepterer følgende parametre.

pageInput Parameter

Objektdefinitionen ændres afhængigt af den type side, der skal navigeres til: objektliste, objektpost, dashboard, HTML-webressource, brugerdefineret side eller generativ side.

Objektliste

Objektlisteobjektet indeholder følgende værdier.

Objektpost

Objektpostobjektet indeholder følgende værdier.

Relationsobjekt

Relationsobjektet, der bruges i objektposten, indeholder følgende værdier.

Dashboard

Brug dette objekt som pageInput parameter, når du vil åbne et dashboard.

Dashboardobjektet indeholder følgende værdier.

HTML-webressource

Brug dette objekt som pageInput parameter, når du vil åbne en HTML-webressource.

HTML-webressourceobjektet indeholder følgende værdier.

Brugerdefineret side

Brug dette objekt som pageInput parameter, når du vil åbne en brugerdefineret side.

Det brugerdefinerede sideobjekt indeholder følgende værdier.

Generativ side

Brug dette objekt som pageInput parameter, når du vil åbne en generativ side.

Det generative sideobjekt indeholder følgende værdier.

navigationOptions Parameter

Objektet navigationOptions indeholder følgende værdier.

Returværdi

Returnerer et løfte. Den værdi, der overføres, når løftet løses, afhænger af målet:

• indbygget: Promise løses med det samme og returnerer ikke nogen værdi.

• dialog: Promise løses, når dialogboksen lukkes. Et objekt overføres kun, hvis pageType = entityRecord og du har åbnet formularen i oprettelsestilstand. Objektet har en savedEntityReference matrix med følgende egenskaber til at identificere den tabelpost, der er oprettet:

  • entityType: Det logiske navn på tabellen.
  • id: En strengrepræsentation af en GUID-værdi for posten.
  • name: Den primære kolonneværdi for den post, der vises eller oprettes.

Eksempel

I følgende eksempler vises navigering til forskellige sidetyper indbygget og i en dialogboks.

Eksempel 1: Åbn kontoliste

Åbner hovedkontolisten indbygget.

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

Eksempel 2: Åbn en eksisterende kontopost i en dialogboks

Åbner en eksisterende kontoformular i en dialogboks.

var pageInput = {
    pageType: "entityrecord",
    entityName: "account",
    entityId: "00aa00aa-bb11-cc22-dd33-44ee44ee44ee" //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
    }
);

Eksempel 3: Åbn en kontoformular i oprettelsestilstanden i en dialogboks

Åbner en kontoformular i oprettelsestilstand i en dialogboks og returnerer den oprettede postreference, når den gemmes.

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

Eksempel 4: Åbn en HTML-webressource i en dialogboks

Åbner en HTML-webressource i en dialogboks.

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

Relaterede artikler

Xrm.Navigation
Navigering til og fra en brugerdefineret side (prøveversion)