navigateTo (справочник по КЛИЕНТСКОму API)

Переходит к указанному списку таблиц, записи таблицы, веб-ресурсу HTML или пользовательской странице.

Синтаксис

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

Параметры

параметр pageInput

Определение объекта изменяется в зависимости от типа страницы, на которой нужно перейти: список сущностей, запись сущностей, панель мониторинга, веб-ресурс HTML или пользовательская страница.

Список сущностей

Объект списка сущностей содержит следующие значения.

Запись сущности

Объект записи сущности содержит следующие значения.

Объект связи

Объект связи, используемый в записи сущности, содержит следующие значения.

Dashboard

Объект панели мониторинга содержит следующие значения.

Веб-ресурс HTML

Объект веб-ресурса HTML содержит следующие значения.

Настраиваемая страница

Объект пользовательской страницы содержит следующие значения.

Параметр navigationOptions

Объект navigationOptions содержит следующие значения.

Возвращаемое значение

Возвращает обещание. Значение, передаваемое при разрешении обещания, зависит от целевого объекта:

• встроенное: обещание разрешается сразу и не возвращает никакое значение.

• диалоговое окно: обещание разрешается при закрытии диалогового окна. Объект передается только в том случае, если pageType = entityRecord форма открыта в режиме создания. Объект содержит savedEntityReference массив со следующими свойствами, чтобы определить созданную запись таблицы:

  • entityType: логическое имя таблицы.
  • id: строковое представление значения GUID для записи.
  • имя: основное значение столбца отображаемой или созданной записи.

Example

Пример 1. Открытие списка учетных записей

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

Пример 2. Открытие существующей записи учетной записи в диалоговом окне

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. Открытие формы учетной записи в режиме создания в диалоговом окне

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. Открытие веб-ресурса HTML в диалоговом окне

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

Связанные статьи

Xrm.Navigation
Переход на пользовательскую страницу (предварительная версия) и на нее