Страница единого интерфейса (размещенный элемент управления)

Статья
2025-05-08

Используйте тип размещенного элемента управления "Страница единого интерфейса" для загрузки URL-адреса или страницы из приложений с единым интерфейсом в приложениях, управляемых моделями. Когда страница приложения, управляемого моделью, загружается в размещенный элемент управления этого типа, он автоматически сканирует страницу на наличие данных из сущности и автоматически заполняет параметры замены.

Этот тип размещенного элемента управления предоставляет ряд предопределенных действий и событий UII, которые являются уникальными для обработки управляемых моделью приложений Windows, включая действие манипулирования списком и действие поиска для отображения страницы быстрого поиска или расширенного поиска.

Создание размещенного элемента управления на странице единого интерфейса

При создании нового размещенного элемента управления поля на экране Новый размещенный элемент управления будут различаться в зависимости от типа размещенного элемента управления, который вы хотите создать. В этом разделе содержатся сведения о конкретных полях, которые являются уникальными для типа размещенного элемента управления "Страница единого интерфейса".

На экране Новый размещенный элемент управления :

В области Unified Service Desk выберите Unified Interface Page (Страница единого интерфейса ) в раскрывающемся списке Unified Service Desk Component Type (Тип компонента Unified Service Desk ).
Выберите Предварительная выборка данных , чтобы загрузить связанную информацию для записи сущности в контексте вместе со страницей записи сущности, не дожидаясь загрузки полной веб-страницы сущности в клиентском приложении. Полученная информация о сущности заполняется в контексте Unified Service Desk, что позволяет любому размещенному элементу управления быстро отображать соответствующую информацию о сущности в клиентском приложении. Это может помочь операторам мгновенно действовать или начать обсуждение с клиентами, экономя время на взаимодействие.
В раскрывающемся списке Разрешить несколько страниц выберите Нет (по умолчанию), чтобы заменить отображаемую в данный момент страницу приложения на основе модели и обновить журнал браузера, когда Unified Service Desk получает вызов действия навигации или страница направляется на вкладку. Выберите Да, чтобы автоматически создавать раскрывающийся список при вызове второго URL-адреса или при переходе по окну на вкладку с помощью правила навигации по окну. Это позволяет пользователю быстро выполнять поиск между страницами приложения, управляемого моделью, которые подключены к этому элементу управления. Также при выборе Да становится доступным дополнительное поле Максимум браузеров, в котором можно указать максимальное количество отображаемых страниц в выпадающем списке.
В области Общие свойства установите флажок Приложение является глобальным , чтобы установить размещенный элемент управления как глобальный. Глобальные размещенные элементы управления могут отображаться вне сеанса клиента. Такие элементы управления, как панель управления агента, стена или поиск, являются распространенными способами использования глобальных размещенных элементов управления. Глобальные размещенные элементы управления не имеют состояния, зависящего от сеанса, поэтому при изменении сеанса эти же глобальные размещенные элементы управления сохраняются. Если этот флажок не установлен, размещенный элемент управления становится сессионным. Элементы управления на основе сеанса существуют в контексте сеанса клиента. Если пользователь переходит на другую сессию, все страницы из предыдущего сеанса скрываются.
В поле Display Group отображается панель, на которой будет отображаться этот размещенный элемент управления. MainPanel является наиболее распространенным выбором для этого типа размещенного элемента управления.

Дополнительные сведения: Создание или изменение размещенного элемента управления

Предопределенные действия UII

Ниже приведены предопределенные действия для этого типа размещенного элемента управления.

АссоциированныйПросмотр

Это действие загружает определенное связанное представление. Доступ к этим представлениям обычно осуществляется путем развертывания имени записи сущности на панели навигации и выбора связанных сущностей.

Параметр	Описание
ЭТН	Имя сущности, для которой требуется загрузить список записей связанной сущности. Это обязательный параметр.
Идентификатор	Идентификатор основной записи сущности, для которой будут отображаться связанные записи сущности.
navItemId	Идентификатор элемента навигации, соответствующего связанной сущности. Дополнительная информация: formContext.ui.navigation
hideCommandBar	Если для этого параметра задано значение False, страница будет отображаться вместе с панелью команд приложения, управляемого моделью.
hideNavigationBar	Если этот параметр указан и имеет значение False, страница будет отображаться вместе с панелью навигации приложения, управляемого моделью.

Закрывать

Это действие используется для закрытия размещенного элемента управления. В отличие от действия CloseActive , если на этой вкладке (размещенном элементе управления) отображается более одной страницы, это действие закроет все страницы, отображаемые на вкладке в приложении агента.

ЗакрытьАктивный

Это действие используется для закрытия активного окна в этом размещенном элементе управления. Если активное окно является единственным окном, отображаемым в размещенном элементе управления, сам размещенный элемент управления будет закрыт. Для размещенных на страницах унифицированного интерфейса элементов управления, которые не разрешают несколько страниц (Разрешить несколько страниц = Нет), это действие эквивалентно действию Закрыть .

CloseAndPrompt

Это действие закрывает размещенный элемент управления, но предлагает пользователю сохранить или отменить свои изменения перед закрытием.

Поиск

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

Параметр	Описание
Посмотреть описание	Параметр data должен указывать логическое имя сущности представления списка быстрого поиска для отображения. Существуют некоторые значения в особом случае: - Используйте вариант или инцидент для отображения списка быстрого поиска для обращений. - Используйте действия или занятия для отображения списка быстрого поиска занятий.
hideNavigationBar	Установите значение True, чтобы скрыть панель навигации, в противном случае — False.
hideCommandBar	Установите значение True, чтобы скрыть панель команд, в противном случае — False.

Событие FireEvent

Запускает определяемое пользователем событие из этого размещенного элемента управления.

Параметр	Описание
имя	Имя определяемого пользователем события.

Все последующие пары имя/значение становятся параметрами события. Дополнительные сведения: Создание пользовательского события

GetSelectedIds (GetSelectedIds)

Это действие используется для извлечения выбранных идентификаторов из списков.

Параметр	Описание
Посмотреть описание	В параметре data должно быть указано имя списка, из которого будут захвачены выбранные идентификаторы.

Возвращаемое значение содержит список идентификаторов, разделенных точкой с запятой, содержащих выбранные элементы.

GetSelectedCount (GetSelectedCount)

Это действие извлекает количество выбранных элементов. Используйте действие GetSelectedIds , чтобы получить фактический список идентификаторов для сущности.

Параметр	Описание
Посмотреть описание	В параметре data должно быть указано имя списка, из которого будут извлечены выбранные идентификаторы.

Возвращаемое значение содержит число, представляющее количество выбранных товаров.

ВозвратДомой

Это действие переходит на начальный URL, указанный для данного экземпляра браузера.

Это действие эквивалентно нажатию кнопки «Назад» в экземпляре браузера.

ГоВперед

Это действие эквивалентно нажатию кнопки «Вперед» в экземпляре браузера.

Переместить кпанели

Это действие перемещает размещенный на странице унифицированного интерфейса элемент управления на другую панель во время выполнения.

Параметр	Описание
Посмотреть описание	В параметре data должно быть указано имя целевой панели, на которую будет перемещен размещенный элемент управления (например, FloatingPanel).

Перейти

Это действие используется для перехода по URL-адресу приложения, управляемого моделью. Идентификатор приложения для приложения, выбранного в окне «Выбор модуля приложения », добавляется автоматически.

Параметр	Описание
URL-адрес	URL-адрес для перехода. Это обязательный параметр.
HideCommandBar (СкрытьCommandBar)	Если этот параметр указан и имеет значение True, внутренняя рамка будет отображаться без загрузки панели команд приложения, управляемого моделью.
HideNavigationBar (Скрыть панель навигации)	Если этот параметр указан и имеет значение True, форма будет отображаться без загрузки панели навигации приложения, управляемого моделью.
Рамка	Если фреймы существуют на странице, этот параметр указывает имя фрейма для навигации, а не для навигации по главному окну.
Постданные	Данные, которые отправляются на сервер в рамках транзакции HTTP POST. Транзакция POST обычно используется для отправки данных, собранных HTML-страницей. В Unified Service Desk эти данные можно получить из любого события, сработавшего с помощью "''https://event/?". Пример: [[postdata]+] В качестве альтернативы данные могут быть переданы в виде закодированной строки с типом заголовка в нужном формате.
авторизации	Строковое значение, содержащее дополнительные HTTP-заголовки для отправки на сервер. Когда параметр postdata используется в действии Navigate , вы также должны указать соответствующее значение для параметра заголовка, например, Content-Type:application/x-www-form-urlencoded Если событие Unified Service Desk POST запускает действие Navigate , значение этого параметра по умолчанию должно быть header=[[header]+] Чтобы добавить несколько заголовков, значение этого параметра должно быть: `header=$Multiline(`Заголовки через переводную строку`)` Пример: `header=$Multiline(accessToken;dummyAccessToken==` `refreshToken;dummyRefreshToken===)`

New_CRM_Page

Создает страницу для создания новой записи указанной сущности и обрабатывает эту страницу как всплывающее окно из указанного размещенного элемента управления. Правила навигации по окну оцениваются для определения местоположения, в котором будет отображаться страница для создания записи сущности.

Параметр	Описание
Логическое имя	Логическое имя сущности для создания нового экземпляра.

Замечание

Остальные параметры должны состоять из пар имя/значение. Это дополнительные предварительно заполненные значения в форме для создания новой записи для указанной сущности.

Open_CRM_Page

Открывает существующий экземпляр сущности, указанной и идентифицированной по идентификатору, и обрабатывает страницу как всплывающее окно из указанного размещенного элемента управления. Правила навигации по окну оцениваются для определения места, где должно отображаться всплывающее окно.

Параметр	Описание
Логическое имя	Логическое имя открываемой сущности.
идентификатор	Идентификатор открываемой записи сущности.

"Всплывающий" URL-адрес из размещенного элемента управления и запускает для него правила навигации по окну для маршрутизации всплывающего окна в соответствующее местоположение.

Параметр	Описание
URL-адрес	Направляет всплывающее окно из этого размещенного элемента управления, используя этот URL-адрес, как если бы это было всплывающее окно, запрошенное из отображаемого элемента управления.
рамка	Рамка, из которой произошло это всплывающее окно.

Переровнять окно

Отображает размещенный элемент управления в указанном месте на мониторе. Размещенные элементы управления можно отображать на двух мониторах. Это действие применимо к размещенным экземплярам элемента управления, которые настроены на размещение на панели типа USDFloatingPanel или USDFloatingToolPanel.

Параметр	Описание
экран	Указывает экран, на котором будет отображаться размещенный элемент управления. Допустимые значения: 1 или 2. Если вы не укажете этот параметр, по умолчанию передается 1.
левый	Указывает положение в процентах слева от экрана на целевом мониторе, где должен отображаться размещенный элемент управления. Допустимые значения: от 0 до 100. Если вы не укажете этот параметр, по умолчанию передается 0.
Верх	Указывает положение в процентах от верхней части экрана на целевом мониторе, где должен отображаться размещенный элемент управления. Допустимые значения: от 0 до 100. Если вы не укажете этот параметр, по умолчанию передается 0.
Ширина	Указывает ширину в процентах размещенного окна управления на целевом мониторе. Допустимые значения от 1 до 100. Если вы не укажете этот параметр, по умолчанию передается 100.
высота	Указывает высоту в процентах размещенного окна управления на целевом мониторе. Допустимые значения от 1 до 100. Если вы не укажете этот параметр, по умолчанию передается 100.

Обновить

Это действие обновляет текущую страницу.

RunScript

Это действие внедряет JavaScript в основной фрейм приложения. С этим действием следует избегать использования вызовов клиентского пакета SDK Microsoft Dataverse. вместо этого используйте действие RunXrmCommand .

Параметр	Описание
Посмотреть описание	Параметр data — это JavaScript, который будет внедрен в форму. Заметка: Параметры замены могут быть использованы в скрипте, и они будут заменены перед выполнением скрипта.
Рамка	Если фреймы существуют на странице, этот параметр указывает имя фрейма, в который будет вставлен JavaScript.

RunXrmCommand (Команда RunXrm)

Это действие используется для запуска кода JavaScript, который использует справочник по клиентскому API управляемых моделями приложений на страницах унифицированного интерфейса (формы сущностей и сетки).

Необходимо настроить скрипт как функцию JavaScript webResource управляемых моделями приложений. Первый параметр функции — это параметр контекста (зарезервированный параметр), который может иметь одно из следующих значений:

FormContext на страницах форм сущностей
GridContext на страницах сетки сущностей
undefined на других страницах

Параметр	Описание
webResourceName	Имя веб-ресурса, в котором присутствует функция JavaScript, которую вы хотите выполнить.
functionName	Имя функции.

Другие параметры функции определяются пользователем и могут использоваться для передачи параметров замены Unified Service Desk во время выполнения. Это действие принимает список необязательных параметров без ключей. Список необязательных параметров передается в качестве аргументов в том же порядке со второй позиции после замены контекста во время выполнения.

Пример

Требуется выполнить действие RunXrmCommand для заполнения атрибутов формы сущности, в которой форма сущности размещается в размещенном элементе управления типа Unified Interface Page. Значение, которое требуется заполнить, с точки зрения Unified Service Desk, является параметром замены—[[$Context.Key1]].

Для выполнения действия нужно написать тип JavaScript веб-ресурс (скажем, webResource1), а затем написать функцию в веб-ресурсе.

function fillAttributeValue(context, attrValue)
{
 context.getAttribute(<attributeName>).setValue(attrValue);
}

Вам нужно настроить данные в вызове action следующим образом:

webResourceName = webResource1
functionName = fillAttributeValue
'[[$Context.Key1]]'

Замечание

В приведенном выше примере обратите внимание на одинарные кавычки вокруг параметра замены, [[$Context.Key1]]. Unified Service Desk учитывает только значение параметра (а не тип данных) и передает все символы в заменяемом значении контекста в функцию JavaScript. Вы должны быть осторожны и заботиться о типе данных при настройке.

SetSize (УстановитьРазмер)

Это действие явно задает ширину и высоту размещенного элемента управления. Это особенно полезно при использовании "auto" в макетах панелей.

Параметр	Описание
Ширина	Ширина размещенного элемента управления.
высота	Высота размещенного элемента управления.

СохранитьИЗакрыть

Это действие сохраняет «грязные» данные в форме приложения, управляемого моделью, и закрывает размещенный элемент управления.

Сохранить все

Это действие сохраняет все формы в размещенном элементе управления, который позволяет отображать несколько страниц (Разрешить несколько страниц = Да). Если размещенный элемент управления позволяет отображать только одну страницу (Разрешить несколько страниц = Нет), это эквивалентно действию Сохранить .

Сохранить

Это действие сохраняет текущую страницу единого интерфейса.

Предопределенные события

Следующие предопределенные события связаны с этим типом размещенного элемента управления.

АктивноЗакрыто

Происходит, когда активный размещенный элемент управления закрывается с помощью действия CloseActive .

Параметр	Описание
URL-адрес	URL-адрес, который отображался в размещенном элементе управления при его закрытии.

Готовность к работе с данными

Происходит, как только связанная информация о записи сущности загружается в контексте Unified Service Desk. Это событие происходит перед событием PageReadyFor . Если для управляющего экземпляра выбран параметр Pre-Fetch Data , это событие происходит, как только данные сущности извлекаются в отдельном параллельном вызове к серверу, и не будет ждать завершения загрузки всей страницы. Данные сущности предварительно загружаются, а событие DataReady также запускается для встроенной навигации.

Замечание

Для панелей мониторинга, веб-ресурсов и страниц поиска событие DataReady не запускается.

ОбновитьЗапрошено

Происходит, когда на текущей странице запрашивается обновление. Обновление может быть запрошено либо нажатием клавиши F5, либо вызовом действия Refresh приложением.

Параметр	Описание
URL-адрес	URL-адрес, отображаемый при запросе обновления.

Сохранено

Происходит после сохранения записи на странице приложения, управляемого моделью.

Параметр	Описание
newId	Идентификатор, присвоенный вновь созданной записи.

НавигацияЗапрошено

Происходит, когда навигация происходит в приложениях единого интерфейса.

Параметр	Описание
URL-адрес	URL-адрес страницы, на которую был осуществлен переход.

Готовность к работе со страницами

Происходит, когда страница завершила загрузку. В элементе управления типа "Страница унифицированного интерфейса" это событие происходит после сохранения данных в списке параметров замены.

Параметр	Описание
URL-адрес	URL-адрес страницы, загрузка которой завершилась.

Замечание

Для панелей мониторинга, веб-ресурсов и страниц поиска событие DataReady не запускается.

БраузерОконГотов

Событие BrowserWindowReady вызывается, когда окно браузера готово в клиентском приложении Unified Service Desk. Используйте BrowserWindowReady для панелей мониторинга и веб-ресурсов.

OnClickToAct

Событие OnClickToAct вызывается, когда пользователь выбирает поле исходящей связи (ClickToAct) в форме.

Вы также можете написать пользовательские элементы управления для вызова события окна ClickToAct в Channel Integration Framework и передачи любых eventData в соответствии с бизнес-требованиями.

Дополнительная информация: onclicktoact

OnSendKbСтатья

Событие OnSendKbArticle вызывается, когда пользователь выбирает команду Отправить в элементе управления базы знаний. eventData — это URL и название статьи базы знаний, которые необходимо передать.

Дополнительная информация: onsendkbarticle

Замечание

Мы не рекомендуем использовать window.IsUSD их в формах приложения, управляемых моделью, а вместо этого используйте PageReady или другие события, перечисленные в этом разделе.

См. также

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

Страница единого интерфейса (размещенный элемент управления)

Создание размещенного элемента управления на странице единого интерфейса

Предопределенные действия UII

АссоциированныйПросмотр

Закрывать

ЗакрытьАктивный

CloseAndPrompt

Поиск

Событие FireEvent

GetSelectedIds (GetSelectedIds)

GetSelectedCount (GetSelectedCount)

ВозвратДомой

Назад

ГоВперед

Переместить кпанели

Перейти

New_CRM_Page

Open_CRM_Page

Всплывающее окно

Переровнять окно

Обновить

RunScript

RunXrmCommand (Команда RunXrm)

Пример

SetSize (УстановитьРазмер)

СохранитьИЗакрыть

Сохранить все

Сохранить

Предопределенные события

АктивноЗакрыто

Готовность к работе с данными

ОбновитьЗапрошено

Сохранено

НавигацияЗапрошено

Готовность к работе со страницами

БраузерОконГотов

OnClickToAct

OnSendKbСтатья

См. также

Обратная связь

Дополнительные ресурсы