navigateTo (klient-API-referens)

Navigerar till den angivna tabelllistan, tabellposten, HTML-webbresursen eller den anpassade sidan.

Syntax

Använd följande syntax för att anropa Xrm.Navigation.navigateTo().

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

Parameters

Metoden accepterar följande parametrar.

pageInput Parametern

Objektdefinitionen ändras beroende på vilken typ av sida som ska navigeras till: entitetslista, entitetspost, instrumentpanel, HTML-webbresurs, anpassad sida eller generativ sida.

Entitetslista

Objektet för entitetslistan innehåller följande värden.

Entitetspost

Entitetspostobjektet innehåller följande värden.

Relationsobjekt

Relationsobjektet, som används i entitetsposten, innehåller följande värden.

Instrumentpanel

Använd det här objektet som pageInput parameter när du vill öppna en instrumentpanel.

Instrumentpanelsobjektet innehåller följande värden.

HTML-webbresurs

Använd det här objektet som pageInput parameter när du vill öppna en HTML-webbresurs.

HTML-webbresursobjektet innehåller följande värden.

Anpassad sida

Använd det här objektet som pageInput parameter när du vill öppna en anpassad sida.

Det anpassade sidobjektet innehåller följande värden.

Generativ sida

Använd det här objektet som pageInput parameter när du vill öppna en generativ sida.

Om du vill använda recordId, entityName, eller datamåste den generativa målsidan konfigureras för att acceptera indataparametrar.

Det generativa sidobjektet innehåller följande värden.

Se exempel som visar hur du navigerar till och från en generativ sida med hjälp av klient-API

navigationOptions Parametern

Objektet navigationOptions innehåller följande värden.

Returvärde

Returnerar ett löfte. Värdet som skickas när löftet matchar beror på målet:

• infogad: Promise löser sig direkt och returnerar inget värde.

• dialogruta: Promise löses när dialogrutan stängs. Ett objekt skickas endast om pageType = entityRecord och du öppnade formuläret i skapa-läge. Objektet har en savedEntityReference matris med följande egenskaper för att identifiera den tabellpost som skapats:

  • entityType: Tabellens logiska namn.
  • id: En strängrepresentation av ett GUID-värde för posten.
  • name: Det primära kolumnvärdet för posten som visas eller skapas.

Example

I följande exempel visas hur du navigerar till olika sidtyper infogat och i en dialogruta.

Exempel 1: Öppna kontolista

Öppnar huvudkontolistan infogat.

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

Exempel 2: Öppna en befintlig kontopost i en dialogruta

Öppnar ett befintligt kontoformulär i en dialogruta.

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

Exempel 3: Öppna ett kontoformulär i läget skapa i en dialogruta

Öppnar ett kontoformulär i skapa-läge i en dialogruta och returnerar den skapade postreferensen när den sparas.

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

Exempel 4: Öppna en HTML-webbresurs i en dialogruta

Öppnar en HTML-webbresurs i en dialogruta.

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

Exempel 5: Öppna en generativ sida med indataparametrar i en dialogruta

Öppnar en generativ sida som en centrerad dialogruta som skickar ett post-ID, entitetsnamn och anpassade dataparametrar. Den generativa sidan måste konfigureras för att acceptera dessa parametrar.

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

Relaterade artiklar

Xrm.Navigation
Navigera till och från en generativ sida
Navigera till och från en anpassad sida (förhandsversion)