navigateTo (asiakkaan ohjelmointirajapinnan viittaus)

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

Note

Tätä menetelmää tuetaan vain Unified Interfacessa.

Syntaksi

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

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

Parametrit

-menetelmä hyväksyy seuraavat parametrit.

Nimi	Tyyppi	Pakollinen	Description
pageInput	Objekti	Kyllä	Syöte siitä sivusta, johon haluat siirtyä. Katso pageInput-parametri
navigationOptions	Objekti	Ei	Sivulla siirtymisen asetukset: avataanko tekstiin vai valintaikkunaan. Jos et määritä tätä parametria, -menetelmä avaa sivun oletusarvoisesti sisäisesti.
`successCallback`	funktio	Ei	Funktio, joka suoritetaan onnistuneessa siirtymisessä sivulle, kun siirryt sisäisesti ja suljet valintaikkunan, kun siirryt valintaikkunaan.
`errorCallback`	Function	Ei	Toiminto, joka suoritetaan, kun toiminto epäonnistuu.

`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.

Nimi	Tyyppi	Description
`pageType`	Merkkijono	Määritä `entitylist`.
`entityName`	Merkkijono	Luettelo-ohjausobjektiin ladattavan taulukon looginen nimi.
`viewId`	Merkkijono	(Valinnainen) Ladattavan näkymän tunnus. Jos et määritä sitä, sovellus siirtyy taulukon oletuspäänäkymään.
`viewType`	Merkkijono	(Valinnainen) Ladattavan näkymän tyyppi. Määritä `savedquery` tai `userquery`.

Entiteettitietue

Entiteettitietueobjekti sisältää seuraavat arvot.

Nimi	Tyyppi	Description
`pageType`	Merkkijono	Määritä `entityrecord`.
`entityName`	Merkkijono	Sen taulukon looginen nimi, jonka lomakkeen näyttää.
`entityId`	Merkkijono	(Valinnainen) Sen taulukkotietueen tunnus, jonka lomakkeet näytetään. Jos et määritä tätä arvoa, lomake avautuu luontitilassa.
`createFromEntity`	Haku	(Valinnainen) Määrittää tietueen, joka tarjoaa oletusarvoja yhdistettyjen sarakearvojen perusteella. Hakuobjektilla on seuraavat Merkkijono-ominaisuudet: entityType, id ja name (valinnainen).
`data`	Objekti	(Valinnainen) Sanasto-objekti, joka välittää lomakkeeseen ylimääräisiä parametreja. Parametrit voivat olla taulukon sarakkeita, joissa on oletusarvoja, jotka on määritetty uusille lomakkeille (katso Sarakearvojen määrittäminen lomakkeeseen välitettävien parametrien avulla`formContext.data.attributes`) tai mukautettuja parametreja, joita käyttämällä voidaan käyttää lomakkeessa (katso Lomakkeen määrittäminen hyväksymään mukautettuja kyselymerkkijonon parametreja ja formContext.data). Virheelliset parametrit aiheuttavat virheen.
`formId`	Merkkijono	(Valinnainen) Näytettävän lomakeesiintymän tunnus.
`isCrossEntityNavigate`	totuusarvo	(Valinnainen) Ilmaisee, siirtyykö lomake eri taulukosta taulukoiden välisen liiketoimintaprosessin työnkulun avulla.
`isOfflineSyncError`	totuusarvo	(Valinnainen) Ilmaisee, onko offline-synkronoinnissa virheitä.
`processId`	Merkkijono	(Valinnainen) Lomakkeessa näytettävän liiketoimintaprosessin tunnus.
`processInstanceId`	Merkkijono	(Valinnainen) Lomakkeessa näytettävän liiketoimintaprosessin esiintymän tunnus.
`relationship`	Objekti	(Valinnainen) Määritä suhdeobjekti näyttämään liittyvät tietueet lomakkeessa. Katso suhde.
`selectedStageId`	Merkkijono	(Valinnainen) Liiketoimintaprosessin esiintymän valitun vaiheen tunnus.
`tabName`	Merkkijono	(Valinnainen) Määrittää kohdistuksen lomakkeen välilehdessä.

Suhdeobjekti

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

Nimi	Tyyppi	Description
`attributeName`	Merkkijono	Suhteessa käytetyn sarakkeen nimi.
`name`	Merkkijono	Suhteen nimi.
`navigationPropertyName`	Merkkijono	Tämän suhteen siirtymisominaisuuden nimi.
`relationshipType`	Numero	Suhteen tyyppi. Määritä jokin seuraavista arvoista: 0:OneToMany, 1:ManyToMany.
`roleType`	Numero	Roolityyppi suhteessa. Määritä jokin seuraavista arvoista: 1:Referencing, 2:AssociationEntity.

Raporttinäkymä

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

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

Nimi	Tyyppi	Description
`pageType`	Merkkijono	Määritä `dashboard`.
`dashboardId`	Merkkijono	Ladattavan koontinäytön tunnus. Jos et määritä tunnusta, sovellus siirtyy oletuskoontinäyttöön.

HTML-verkkoresurssi

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

HTML-verkkoresurssiobjekti sisältää seuraavat arvot.

Nimi	Tyyppi	Description
`pageType`	Merkkijono	Määritä `webresource`.
`webresourceName`	Merkkijono	Ladattavan verkkoresurssin nimi.
`data`	Merkkijono	(Valinnainen) Verkkoresurssiin siirrettävät tiedot.

Mukautettu sivu

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

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

Nimi	Tyyppi	Description
`pageType`	Merkkijono	Määritä `custom`.
`name`	Merkkijono	Avattavan mukautetun sivun looginen nimi.
`entityName`	Merkkijono	(Valinnainen) Mukautetulla sivulla käytettäväksi käytettävän taulukon looginen nimi :n kautta `Param("entityName")`.
`recordId`	Merkkijono	(Valinnainen) Sen taulukkotietueen tunnus, joka tulee saataville mukautetulle sivulle :n kautta `Param("recordId")`.

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.

Nimi	Tyyppi	Description
`pageType`	Merkkijono	Määritä `generative`.
`pageId`	Merkkijono	Avattavan generative-sivun tunnus.
`recordId`	Merkkijono	(Valinnainen) Sivulle välitettavan tietueen GUID-tunnus.
`entityName`	Merkkijono	(Valinnainen) Dataverse-taulukon looginen nimi, joka vastaa :a `recordId`.
`data`	Objekti	(Valinnainen) JSON-objekti, joka sisältää ylimääräisiä mukautettuja parametreja välitettäväksi sivulle.

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

`navigationOptions` parametri

Objekti navigationOptions sisältää seuraavat arvot.

Nimi	Tyyppi	Description
`target`	Numero	Määritä `1` , jos haluat avata sivun sisäisesti. Määritä `2` sivun avaamiseksi valintaikkunassa. Lisäksi muut arvot (leveys, korkeus ja sijainti) ovat kelvollisia vain, jos määrität `2` tämän arvon (avaa sivu valintaikkunassa). Huomautus: Voit avata vain tekstiin sidotut entiteettiluettelot. Voit avata entiteettitietueita, verkkoresursseja ja luovia sivuja joko sisäisessä tai valintaikkunassa.
`width`	Luku tai objekti	(Valinnainen) Valintaikkunan leveys. Jos haluat määrittää leveyden kuvapisteinä, kirjoita numeerinen arvo. Jos haluat määrittää leveyden prosenttilukuna, määritä SizeValue-tyyppinen objekti käyttäen seuraavia ominaisuuksia: - `value`: Luku-tyyppinen numeerinen arvo. - `unit`: Merkkijono-tyypin mittausyksikkö. Määritä `%` tai `px`. Oletusarvo on `px`.
`height`	Luku tai objekti	(Valinnainen) Valintaikkunan korkeus. Jos haluat määrittää korkeuden kuvapisteinä, kirjoita numeerinen arvo. Jos haluat määrittää leveyden prosenttilukuna, määritä SizeValue-tyyppinen objekti käyttäen seuraavia ominaisuuksia: - value: Tyyppiä Number oleva numeerinen arvo. - `unit`: Merkkijono-tyypin mittausyksikkö. Määritä `%` tai `px`. Oletusarvo on `px`.
`position`	Numero	(Valinnainen) Määritä `1` avaamaan valintaikkuna keskellä; `2` avaa valintaikkuna toisella puolella. Oletus on `1` (keskellä).
`title`	Merkkijono	(Valinnainen) Valintaikkunan otsikko keskimmäisen tai sivuvalintaikkunan yläosassa.

Palautusarvo

Palauttaa lupauksen. Arvo, joka välitetään, kun lupaus korjataan, riippuu kohteesta:

inline: Lupaus ratkeaa heti, eikä se palauta mitään arvoa.
dialogi: Lupaaminen ratkeaa, kun valintaikkuna sulkeutuu. Objekti välitetään vain, jos pageType = entityRecord ja avasit lomakkeen luontitilassa. -objektilla savedEntityReference on matriisi, jolla on seuraavat ominaisuudet luodun taulukkotietueen tunnistamiseksi:
- entityType: Taulukon looginen nimi.
- id: Tämä on tietueen GUID-arvon merkkijonoesitys.
- name: Näytettävän tai luodun tietueen ensisijainen sarakearvo.

Esimerkki

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

Esimerkki 1: Avaa tililuettelo

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

Esimerkki 2: Avaa olemassa oleva tilitietue valintaikkunassa

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

Esimerkki 3: Avaa tililomake luontitilassa valintaikkunassa

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

Esimerkki 4: Avaa HTML-verkkoresurssi 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
    }
);

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

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

Palaute

Onko tästä sivusta apua?

Last updated on 2026-04-10