navigateTo (kliento API nuoroda)

Pereina į nurodytą lentelės sąrašą, lentelės įrašą, HTML žiniatinklio išteklių arba pasirinktinį puslapį.

Pastaba.

Šis metodas palaikomas tik vieningojoje sąsajoje.

Sintaksė

Iškvieskite Xrm.Navigation.navigateTo()naudodami šią sintaksę.

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

Parametrai

Metodas priima šiuos parametrus.

Pavadinimas	Tipas	Būtina	Aprašas
pageInput	Objektas	Taip	Įvesties apie puslapį, į kurį norite pereiti. Žr. pageInput parametrą
navigationOptions	Objektas	Ne	Puslapio naršymo parinktys: ar atidaryti įdėtuoju, ar dialogo langu. Jei nenurodysite šio parametro, pagal numatytuosius nustatymus metodas atidarys įdėtą puslapį.
`successCallback`	funkcija	Ne	Sėkmingo naršymo į puslapį, kai naršote eilutėje ir uždarant dialogo langą, kai pereinama į dialogo langą, funkcija.
`errorCallback`	Funkcija	Ne	Funkcija, kurią reikia vykdyti, kai operacija nepavyksta.

`pageInput` Parametras

Objekto apibrėžimas keičiasi atsižvelgiant į puslapio, į kurį norite pereiti, tipą: objektų sąrašą, objekto įrašą, ataskaitų sritį, HTML žiniatinklio išteklių, pasirinktinį puslapį arba generuojantį puslapį.

Objektų sąrašas

Objektų sąrašo objekte yra toliau nurodytos reikšmės.

Pavadinimas	Tipas	Aprašas
`pageType`	Eilutė	Nurodykite `entitylist`.
`entityName`	Eilutė	Loginis lentelės, kurią reikia įkelti į sąrašo valdiklį, pavadinimas.
`viewId`	Eilutė	(Pasirinktinai) Įkeliamas rodinio ID. Jei jos nenurodysite, taikomoji programa pereis į numatytąjį lentelės pagrindinį rodinį.
`viewType`	Eilutė	(Pasirinktinai) Įkeliamas rodinio tipas. Nurodykite `savedquery` arba `userquery`.

Objekto įrašas

Objekto įrašo objekte yra toliau nurodytos reikšmės.

Pavadinimas	Tipas	Aprašas
`pageType`	Eilutė	Nurodykite `entityrecord`.
`entityName`	Eilutė	Loginis lentelės pavadinimas, skirtas formai rodyti.
`entityId`	Eilutė	(Pasirinktinai) Lentelės įrašo ID, skirtas formai rodyti. Jei nenurodysite šios reikšmės, forma bus atidaryta kūrimo režimu.
`createFromEntity`	Peržvalga	(Pasirinktinai) Nurodo įrašą, kuris pateikia numatytąsias reikšmes, pagrįstas susietų stulpelių reikšmėmis. Peržvalgos objektas turi šias eilutės ypatybes: entityType, ID ir pavadinimas (pasirinktinai).
`data`	Objektas	(Pasirinktinai) Žodyno objektas, kuris į formą perduoda papildomus parametrus. Parametrai gali būti lentelės stulpeliai su numatytosiomis reikšmėmis, kurios nustatytos naujose formose (žr. Stulpelių reikšmių nustatymas naudojant į formą perduotus parametrus) arba pasirinktiniai parametrai, kurie pasiekiami formoje naudojant `formContext.data.attributes` (žr. Formos konfigūravimas priimti pasirinktinius užklausų eilutės parametrus ir formContext.data). Neleistini parametrai sukelia klaidą.
`formId`	Eilutė	(Pasirinktinai) Rodytinų formų egzemplioriaus ID.
`isCrossEntityNavigate`	Bulio logikos	(Pasirinktinai) Nurodo, ar forma perkeliama į kitą lentelę naudojant kelių lentelių verslo procesų srautą.
`isOfflineSyncError`	Bulio logikos	(Pasirinktinai) Nurodo, ar yra autonominio sinchronizavimo klaidų.
`processId`	Eilutė	(Pasirinktinai) Formoje rodomo verslo proceso ID.
`processInstanceId`	Eilutė	(Pasirinktinai) Verslo proceso egzemplioriaus, rodomo formoje, ID.
`relationship`	Objektas	(Pasirinktinai) Apibrėžkite ryšio objektą, kad formoje būtų rodomi susiję įrašai. Žr . ryšį.
`selectedStageId`	Eilutė	(Pasirinktinai) Verslo proceso egzemplioriaus pasirinkto etapo ID.
`tabName`	Eilutė	(Pasirinktinai) Nustato įvesties vietą formos skirtuke.

Ryšio objektas

Ryšio objekte, naudojamame subjekto įraše, yra šios reikšmės.

Pavadinimas	Tipas	Aprašas
`attributeName`	Eilutė	Ryšio stulpelio pavadinimas.
`name`	Eilutė	Ryšio pavadinimas.
`navigationPropertyName`	Eilutė	Šio ryšio naršymo ypatybės pavadinimas.
`relationshipType`	Skaičius	Santykių tipas. Nurodykite vieną iš šių reikšmių: 0:OneToMany, 1:ManyToMany.
`roleType`	Skaičius	Vaidmens tipas ryšyje. Nurodykite vieną iš šių reikšmių: 1:Nuoroda, 2:AssociationEntity.

Ataskaitų sritis

Naudokite šį objektą kaip parametrą pageInput , kai norite atidaryti ataskaitų sritį.

Ataskaitų srities objekte yra šios reikšmės.

Pavadinimas	Tipas	Aprašas
`pageType`	Eilutė	Nurodykite `dashboard`.
`dashboardId`	Eilutė	Įkeliamos ataskaitų srities ID. Jei nenurodysite ID, taikomoji programa pereis į numatytąją ataskaitų sritį.

HTML žiniatinklio išteklius

Naudokite šį objektą kaip parametrą pageInput , kai norite atidaryti HTML žiniatinklio išteklių.

HTML žiniatinklio išteklių objekte yra šios reikšmės.

Pavadinimas	Tipas	Aprašas
`pageType`	Eilutė	Nurodykite `webresource`.
`webresourceName`	Eilutė	Tinklalapio išteklių, kurį reikia įkelti, pavadinimas.
`data`	Eilutė	(Pasirinktinai) Duomenys perduoti žiniatinklio ištekliui.

Pasirinktinis puslapis

Naudokite šį objektą kaip parametrą pageInput , kai norite atidaryti pasirinktinį puslapį.

Pasirinktiniame puslapio objekte yra šios reikšmės.

Pavadinimas	Tipas	Aprašas
`pageType`	Eilutė	Nurodykite `custom`.
`name`	Eilutė	Atidaromas pasirinktinio puslapio loginis pavadinimas.
`entityName`	Eilutė	(Pasirinktinai) Loginis lentelės pavadinimas, kurį galima naudoti pasirinktiniame puslapyje naudojant `Param("entityName")`.
`recordId`	Eilutė	(Pasirinktinai) Lentelės įrašo ID, kurį galima naudoti pasirinktiniame puslapyje naudojant `Param("recordId")`.

Generuojamas puslapis

Naudokite šį objektą kaip parametrą pageInput , kai norite atidaryti generuojamą puslapį.

Norint naudoti recordId, entityNamearba data, paskirties generuojamas puslapis turi būti nustatytas priimti įvesties parametrus.

Generuojamas puslapio objektas turi šias reikšmes.

Pavadinimas	Tipas	Aprašas
`pageType`	Eilutė	Nurodykite `generative`.
`pageId`	Eilutė	Atidaromas generuojamo puslapio ID.
`recordId`	Eilutė	(Pasirinktinai) Įrašo, kuris bus perduodamas į puslapį, GUID.
`entityName`	Eilutė	(Pasirinktinai) Loginis dataverse lentelės, atitinkančios `recordId`.
`data`	Objektas	(Pasirinktinai) JSON objektas su papildomais pasirinktiniais parametrais, kad būtų galima pereiti į puslapį.

Peržiūrėkite pavyzdžius, rodančius, kaip pereiti į generuojamą puslapį ir iš jo naudojant kliento API

`navigationOptions` Parametras

Objekte navigationOptions yra šios reikšmės.

Pavadinimas	Tipas	Aprašas
`target`	Skaičius	Nurodykite `1` , kad būtų atidarytas įdėtasis puslapis. Nurodykite `2` atidaryti puslapį dialogo lange. Be to, likusios reikšmės (plotis, aukštis ir padėtis) galioja tik tada, jei nurodote `2` šią reikšmę (atidaryti puslapį dialogo lange). Pastaba: objektų sąrašus galite atidaryti tik įterpimuose. Galite atidaryti objekto įrašus, žiniatinklio išteklius ir generuojančius puslapius įterpimuose arba dialogo lange.
`width`	Numeris arba objektas	(Pasirinktinai) Dialogo lango plotis. Norėdami nurodyti plotį pikseliais, įveskite skaitinę reikšmę. Norėdami nurodyti plotį procentais, nurodykite sizeValue tipo objektą su šiomis ypatybėmis: - `value`: Skaitinė skaičiaus tipo reikšmė. - `unit`: Eilutės tipo matavimo vienetas. Nurodykite `%` arba `px`. Numatytoji reikšmė yra `px`.
`height`	Numeris arba objektas	(Pasirinktinai) Dialogo lango aukštis. Norėdami nurodyti aukštį pikseliais, įveskite skaitinę reikšmę. Norėdami nurodyti plotį procentais, nurodykite sizeValue tipo objektą su šiomis ypatybėmis: - reikšmė: skaitinė skaičiaus tipo reikšmė. - `unit`: Eilutės tipo matavimo vienetas. Nurodykite `%` arba `px`. Numatytoji reikšmė yra `px`.
`position`	Skaičius	(Pasirinktinai) Nurodykite `1` atidaryti dialogo langą centre, `2` kad atidarytumėte dialogo langą tolimojoje pusėje. Numatytoji reikšmė yra `1` (centre).
`title`	Eilutė	(Pasirinktinai) Dialogo lango pavadinimas centre arba šone.

Pateikiama reikšmė

Grąžina pažadą. Reikšmė, perduota, kai pažadas išsprendžia, priklauso nuo tikslo:

įdėtasis: pažadas išsprendžiamas iš karto ir nepateikia jokios reikšmės.
dialogo langas: pažadas išsprendžiamas, kai dialogo langas uždaromas. Objektas perduodamas tik tada, jei pageType = entityRecord ir atidarėte formą kūrimo režimu. Objektas turi masyvą savedEntityReference su šiomis ypatybėmis, kad galėtų identifikuoti sukurtą lentelės įrašą:
- entityType: loginis lentelės pavadinimas.
- id: įrašo GUID reikšmės eilutės atvaizdavimas.
- pavadinimas: rodoma arba kuriamo įrašo pirminio stulpelio reikšmė.

Pavyzdžiui

Tolesniuose pavyzdžiuose parodyta, kaip naršyti skirtingus puslapių tipus įterpimuose ir dialogo lange.

1 pavyzdys: atidaryti paskyrų sąrašą

Atidaro įdėtą pagrindinės paskyros sąrašą.

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

2 pavyzdys: atidaryti esamą paskyros įrašą dialogo lange

Dialogo lange atidaro esamą abonemento formą.

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

3 pavyzdys: atidaryti paskyros formą kūrimo režimu dialogo lange

Atidaro abonemento formą kūrimo režimu dialogo lange ir įrašant pateikia sukurto įrašo nuorodą.

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

4 pavyzdys: HTML žiniatinklio ištekliaus atidarymas dialogo lange

Dialogo lange atidaromas HTML žiniatinklio išteklius.

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

5 pavyzdys: atidarykite generuojamą puslapį su įvesties parametrais dialogo lange

Atidaro generuojamą puslapį kaip centruotą dialogo langą, perduodantį įrašo ID, objekto pavadinimą ir pasirinktinius duomenų parametrus. Generuotinas puslapis turi būti nustatytas priimti šiuos parametrus.

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() {
            // Run code on success
    },
    function error() {
            // Handle errors
    }
);

Xrm.Navigation
Pereiti į generuojamą puslapį ir iš jo
Perėjimas į pasirinktinį puslapį ir iš jo (peržiūra)

Atsiliepimai

Ar šis puslapis buvo naudingas?

Last updated on 2026-05-01