navigateTo (klient-API-referanse)

Navigerer til den angitte tabelllisten, tabellposten, HTML-nettressursen eller den egendefinerte siden.

Syntaks

Bruk følgende syntaks til å ringe Xrm.Navigation.navigateTo().

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

Parametere

Metoden godtar følgende parametere.

pageInput Parameteren

Objektdefinisjonen endres avhengig av sidetypen du vil navigere til: enhetsliste, enhetsoppføring, instrumentbord, HTML-nettressurs, egendefinert side eller generativ side.

Enhetsliste

Objektet for enhetsliste inneholder følgende verdier.

Enhetsoppføring

Enhetspostobjektet inneholder følgende verdier.

Lær hvordan du åpner hovedskjemaet i en dialogboks ved hjelp av klient-API

Relasjonsobjekt

Relasjonsobjektet, som brukes i enhetsposten, inneholder følgende verdier.

Instrumentbord

Bruk dette objektet som pageInput parameter når du vil åpne et instrumentbord.

Instrumentbordobjektet inneholder følgende verdier.

HTML-nettressurs

Bruk dette objektet som pageInput parameter når du vil åpne en HTML-nettressurs.

HTML-nettressursobjektet inneholder følgende verdier.

Egendefinert side

Bruk dette objektet som pageInput parameter når du vil åpne en egendefinert side.

Det egendefinerte sideobjektet inneholder følgende verdier.

Genereringsside

Bruk dette objektet som pageInput parameter når du vil åpne en generativ side.

Hvis du vil bruke recordId, entityNameeller data, må målgenereringssiden konfigureres til å godta inndataparametere.

Det generative sideobjektet inneholder følgende verdier.

Se eksempler som viser hvordan du navigerer til og fra en generativ side ved hjelp av klient-API

navigationOptions Parameteren

Objektet navigationOptions inneholder følgende verdier.

returverdi

Returnerer et løfte. Verdien som sendes når løftet løses, avhenger av målet og sidetypen:

• Linjebundet: Løftet løses når navigasjonen fullføres og returnerer ikke en verdi.
• Dialogboks: Løftet løses når dialogboksen lukkes.
  • For en enhetsoppføring som er åpnet i opprettingsmodus, løses løftet med et objekt som inneholder en savedEntityReference matrise.
  • For en generativ side løses løftet med et objekt der returnValue egenskapen inneholder verdien som sist ble sendt til dataApi.setPageOutput(value). Hvis den generative siden ikke angir en utdataverdi, vil det å lukke dialogboksen ved å velge Avbryt eller lukkeknappen resultere i en udefinert returnValue.
  • Andre sidetyper returnerer ikke en verdi når dialogboksen lukkes.

Matrisen savedEntityReference som returneres for en enhetspost, inneholder disse egenskapene:

• entityType: Det logiske navnet på tabellen.
• ID: En strengpresentasjon av post-GUIDen.
• navn: Den primære kolonneverdien for posten.

Eksempler

Eksemplene nedenfor viser navigering til ulike sidetyper innebygd og i en dialogboks.

Åpne eksempel på kontoliste

Åpner den innebygde hovedkontolisten.

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

Åpne en eksisterende kontopost i et dialogbokseksempel

Åpner et eksisterende kontoskjema 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
    }
);

Lær hvordan du åpner hovedskjemaet i en dialogboks ved hjelp av klient-API

Åpne et kontoskjema i opprettingsmodus i et dialogbokseksempel

Åpner et kontoskjema i opprettingsmodus i en dialogboks og returnerer den opprettede postreferansen når den lagres.

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

Lær hvordan du åpner hovedskjemaet i en dialogboks ved hjelp av klient-API

Åpne en HTML-nettressurs i et eksempel på en dialogboks

Åpner en HTML-nettressurs 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
    }
);

Åpne en generativ side med inndataparametere i et dialogbokseksempel

Åpner en generativ side som en midtstilt dialogboks, og sender en post-ID, enhetsnavn og egendefinerte dataparametere. Den generative siden må være konfigurert til å godta disse parameterne.

var pageInput = {
    pageType: "generative",
    pageId: "<genPageID>", // replace with the ID of your generative page
    recordId: "00aa00aa-bb11-cc22-dd33-44ee44ee44ee", // replace with actual record GUID
    entityName: "account",
    data: { status: "active", category: "premium" }
};
var navigationOptions = {
    target: 2,
    height: {value: 80, unit: "%"},
    width: {value: 70, unit: "%"},
    position: 1
};
Xrm.Navigation.navigateTo(pageInput, navigationOptions).then(
    function success(result) {
        const output = result?.returnValue;
        if (output) {
            console.log("Value returned by generative page:", output);
        }
    },
    function error(error) {
        console.log(error.message);
    }
);

Relaterte artikler

Xrm.Navigation
Gå til og fra en generativ side
Navigere til og fra en egendefinert side (forhåndsvisning)