navigateTo (dokumentacja interfejsu API klienta)

Przechodzi do określonej listy tabel, rekordu tabeli, zasobu internetowego HTML lub strony niestandardowej.

Składnia

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

Parametry

pageInput parametr

Definicja obiektu zmienia się w zależności od typu strony, do których ma przejść: lista jednostek, rekord jednostki, pulpit nawigacyjny, zasób internetowy HTML lub strona niestandardowa.

Lista encji

Obiekt listy jednostek zawiera następujące wartości.

Rekord encji

Obiekt rekordu jednostki zawiera następujące wartości.

Obiekt relacji

Obiekt relacji używany w rekordzie jednostki zawiera następujące wartości.

Dashboard

Obiekt pulpitu nawigacyjnego zawiera następujące wartości.

Zasób internetowy HTML

Obiekt zasobu internetowego HTML zawiera następujące wartości.

Strona niestandardowa

Obiekt strony niestandardowej zawiera następujące wartości.

navigationOptions , parametr

Obiekt navigationOptions zawiera następujące wartości.

Wartość zwracana

Zwraca obietnicę. Wartość przekazywana, gdy obietnica zostanie rozpoznana, jest zależna od celu:

• wbudowany: obietnica jest rozpoznawana od razu i nie zwraca żadnej wartości.

• okno dialogowe: Obietnica jest rozpoznawana po zamknięciu okna dialogowego. Obiekt jest przekazywany tylko wtedy, gdy pageType = entityRecord obiekt i został otwarty w trybie tworzenia. Obiekt ma tablicę savedEntityReference z następującymi właściwościami, aby zidentyfikować utworzony rekord tabeli:

  • entityType: logiczna nazwa tabeli.
  • id: ciąg reprezentujący wartość identyfikatora GUID dla rekordu.
  • name: wartość kolumny podstawowej wyświetlanego lub utworzonego rekordu.

Example

Przykład 1. Otwieranie listy kont

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

Przykład 2: Otwieranie istniejącego rekordu konta w oknie dialogowym

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

Przykład 3: Otwieranie formularza konta w trybie tworzenia w oknie dialogowym

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

Przykład 4. Otwieranie zasobu internetowego HTML w oknie dialogowym

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

Powiązane artykuły

Xrm.Navigation
Przechodzenie do i ze strony niestandardowej (wersja zapoznawcza)