navigateTo (asiakkaan ohjelmointirajapinnan viittaus)

Siirtyy määritettyyn taulukkoluetteloon, taulukkotietueisiin, HTML-verkkoresurssiin tai mukautettuun sivuun.

Syntaksi

Seuraavan syntaksin avulla voit kutsua -syntaksia Xrm.Navigation.navigateTo().

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

Parametrit

-menetelmä hyväksyy seuraavat parametrit.

pageInput parametri

Objektin määritys muuttuu sen mukaan, millaiseen sivuun siirrytään: entiteettiluettelo, entiteettitietue, koontinäyttö, HTML-verkkoresurssi, mukautettu sivu tai muodostava sivu.

Entiteettiluettelo

Entiteettiluettelo-objekti sisältää seuraavat arvot.

Entiteettitietue

Entiteettitietueobjekti sisältää seuraavat arvot.

Lue, miten voit avata päälomakkeen valintaikkunassa asiakkaan ohjelmointirajapinnan avulla

Suhdeobjekti

Entiteettitietueessa käytettävä suhdeobjekti sisältää seuraavat arvot.

Dashboard

Käytä tätä objektia pageInput parametrina, kun haluat avata koontinäytön.

Koontinäyttö-objekti sisältää seuraavat arvot.

HTML-verkkoresurssi

Käytä tätä objektia pageInput parametrina, kun haluat avata HTML-verkkoresurssin.

HTML-verkkoresurssiobjekti sisältää seuraavat arvot.

Mukautettu sivu

Käytä tätä objektia pageInput parametrina, kun haluat avata mukautetun sivun.

Mukautettu sivu -objekti sisältää seuraavat arvot.

Luotu sivu

Käytä tätä objektia pageInput parametrina, kun haluat avata muodostavan sivun.

Jotta voit käyttää recordId-, entityName- tai data-kohteita, syöteparametrien hyväksyminen edellyttää, että kohdesivu on määritetty.

Luotu sivu-objekti sisältää seuraavat arvot.

Katso esimerkkejä siitä, miten voit siirtyä luontisivulle ja sieltä asiakkaan ohjelmointirajapinnan avulla

navigationOptions parametri

Objekti navigationOptions sisältää seuraavat arvot.

Palautusarvo

Palauttaa lupauksen. Kun lupaus korjataan, välitetty arvo riippuu kohde- ja sivutyypistä:

• Sisäinen: Lupaus ratkeaa, kun siirtyminen on valmis, eikä se palauta arvoa.
• Dialogi: Lupaus ratkeaa, kun valintaikkuna sulkeutuu.
  • Luo-tilassa avatun entiteettitietueen lupaus ratkaistaan matriisin sisältävällä objektilla savedEntityReference .
  • Generatiivisen sivun kohdalla lupaus ratkaistaan objektilla, jonka -ominaisuus sisältää arvon, joka returnValue viimeksi välitettiin kohteeseen dataApi.setPageOutput(value). Jos luontisivu ei määritä tulostearvoa, valintaikkunan sulkeminen valitsemalla Peruuta tai sulje-painike tuottaa määrittämättömän returnValuearvon .
  • Muut sivutyypit eivät palauta arvoa, kun valintaikkuna sulkeutuu.

Entiteettitietueelle savedEntityReference palautettu matriisi sisältää seuraavat ominaisuudet:

• entityType: Taulukon looginen nimi.
• id: Tietueen GUID-tunnuksen merkkijonoesitys.
• name: Tietueen ensisijainen sarakearvo.

Esimerkkejä

Seuraavissa esimerkeissä esitellään siirtyminen eri sivutyyppeihin sisäisesti ja valintaikkunassa.

Avaa esimerkki tililuettelosta

Avaa sisäisen päätililuettelon.

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

Avaa olemassa oleva tilitietue valintaikkunassa esimerkki

Avaa aiemmin luodun tililomakkeen valintaikkunassa.

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

Lue, miten voit avata päälomakkeen valintaikkunassa asiakkaan ohjelmointirajapinnan avulla

Avaa tililomake luontitilassa valintaikkunassa esimerkki

Avaa tililomakkeen luontitilassa valintaikkunassa ja palauttaa luodun tietueviittauksen tallennuksen yhteydessä.

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

Lue, miten voit avata päälomakkeen valintaikkunassa asiakkaan ohjelmointirajapinnan avulla

HTML-verkkoresurssin avaaminen valintaikkunassa

Avaa HTML-verkkoresurssin valintaikkunassa.

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

Avaa dialogin esimerkissä generatiivinen sivu, joka sisältää syöteparametrit

Avaa muodostavan sivun keskitettynä valintaikkunana ja välittää tietuetunnuksen, entiteetin nimen ja mukautetut tietoparametrit. Luotu sivu on määritettävä hyväksymään nämä parametrit.

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

Liittyvät artikkelit

Xrm.Navigation
Siirry luontisivulle ja sieltä pois
Mukautettuun sivuun siirtyminen (esikatselu)