Поделиться через


openWebResource (справочник по API клиента)

Открывает веб-ресурс HTML в новом окне.

Синтаксис

Xrm.Navigation.openWebResource(webResourceName,windowOptions,data)

Параметры

Имя Тип Обязательно Description
webResourceName String Да Имя открытого веб-ресурса HTML.
windowOptions Object нет Параметры окна для открытия веб-ресурса. Объект содержит следующие значения:
- height: (необязательно) Число. Высота окна, открываемого в пикселях.
- width: (необязательно) Число. Ширина окна, открываемого в пикселях.
data String нет Данные, передаваемые в параметр данных.

Замечания

Этот метод необходимо использовать для отображения веб-ресурсов вместо нерекомендуемого метода Xrm.Utility.openWebResource .

Веб-ресурс HTML может принимать значения параметров, описанные в разделе "Передача параметров в веб-ресурсы HTML". Эта функция предоставляет только для передачи необязательного параметра данных. Чтобы передать значения для других допустимых параметров, их необходимо добавить в webResourceName параметр.

Замечание

Объект Xrm недоступен в веб-ресурсах HTML. Поэтому скрипты, Xrm.* содержащие методы, не поддерживаются в веб-ресурсах HTML. parent.Xrm.* Будет работать, если веб-ресурс HTML загружается в контейнер формы. Однако для других мест, таких как загрузка веб-ресурса HTML в составе SiteMap, parent.Xrm.* также не будет работать. Дополнительные сведения: функция GetGlobalContext и ClientGlobalContext.js.aspx

Примеры

  • Откройте веб-ресурс HTML с именем "new_webResource.htm":

    Xrm.Navigation.openWebResource("new_webResource.htm");

  • Откройте веб-ресурс HTML, задав окноOptions:

    var windowOptions = { height: 400, width: 400 };
    Xrm.Navigation.openWebResource("new_webResource.htm",windowOptions);
    
  • Открытие веб-ресурса HTML, включая один элемент данных для data параметра

    Xrm.Navigation.openWebResource("new_webResource.htm",null,"dataItemValue");

Xrm.Navigation