Использование настраиваемых соединителей с элементом управления timeline

Статья
03/15/2023

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

Для получения информации о настройке и использовании временной шкалы см. следующие темы:

Записи, которые настраиваются в настраиваемых соединителях, представляют собой веб-ресурс JavaScript, соответствующий интерфейсу IRecordSource. Имя веб-ресурса, а также конструктор (имя, включая пространство имен) и необязательный путь к веб-ресурсу JSON могут быть добавлены как конфигурация параметра UClientRecordSourcesJSON в FormXML.

<UClientRecordSourcesJSON>
  {"recordSources": [{
    "name": "new_SecondaryRecordSource", 
    "constructor": "SampleNamespace.SecondaryRecordSource"}]
  }
</UClientRecordSourcesJSON>

Ожидается, что TimelineWallControl загрузит веб-ресурс JavaScript, а затем создаст экземпляр IRecordSource из настроенного конструктора.

Затем IRecordSource инициализируется (init) запросом страниц записей (getRecordsData), запросом сведений фильтра (getFilterDetails) и запросом UX-представления отдельной записи (getRecordUX).

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

Настройка пользовательского соединителя для элемента управления «временная шкала»

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

В элементе управления «временная шкала» выберите форму, для которой вы хотите добавить или отредактировать пользовательский соединитель.
Выполните один из следующих вариантов действий:
- Чтобы добавить новый пользовательский соединитель, на панели Свойства для таблицы временной шкалы в разделе Пользовательские соединители выберите Добавить соединитель. Отобразится панель Новый пользовательский соединитель.
- Чтобы отредактировать существующий пользовательский соединитель, который вы уже отправили, на панели Свойства для сущности временной шкалы выберите пользовательский соединитель, а затем выберите Изменить. Отобразится панель Изменение пользовательского соединителя.
Отредактируйте страницу, затем выберите Сохранить.

Поддержка фильтров

Поддержка фильтров настраиваемых соединителей включает следующие возможности.

Добавить новый тип фильтра в существующую группу фильтров
Добавить новую группу фильтров
Обновить количество существующих типов фильтров
Фильтр по ключу поиска

Пользовательские соединители должны использовать информацию о часовом поясе UserSettings из контекста, переданного в init(), чтобы обеспечить согласованность с отрисовкой временной шкалы.

Область

Настраиваемые соединители поддерживаются в односеансных и многосеансных табличных формах в приложениях модели клиента единого интерфейса.

Вне области

Для функции настраиваемых соединителей недоступны следующие функции:

Автономные и автономные по умолчанию сценарии
Панели мониторинга
Места, в которых TimelineWallControl недоступен (например, конвергентные приложения, приложения на основе холста, Power Pages, настраиваемые страницы и т. д.)

Известные ограничения

Настроенные веб-ресурсы формально не объявляются зависимыми от формы. Это означает, что экспорт формы не будет автоматически экспортировать веб-ресурсы, и их нужно будет добавить в этот экспорт вручную. Кроме того, эти веб-ресурсы легко случайно удалить.

Разработка источника записи

При разработке источника записи обязательно соблюдайте следующие правила:

Убедитесь, что вы получаете данные безопасно. Модель безопасности единого интерфейса рассматривает веб-ресурсы JS и JSON как ненадежные, и поэтому такие ресурсы не должны содержать в себе токены или секреты, поскольку они будут храниться в виде обычного текста.
Если данные находятся в пределах Dataverse, используйте объект контекста из поведения инициализации для выполнения запросов в Dataverse. Вызовы в Dataverse из контекста имеют запросы, проходящие через прокси с использованием безопасного iFrame. Вот как готовые источники записей в TimelineWallControl извлекают данные.
Если данные находятся за пределами Dataverse, используйте существующие механизмы платформы для извлечения внешних данных.
Локальное тестирование изменений с помощью Fiddler: повышение гибкости разработки и отладки веб-ресурсов JavaScript с помощью Fiddler AutoResponder. Больше информации: Написание скриптов для разработки веб-ресурсов с помощью Fiddler AutoResponder.
Снижение риска атак XSS: риск атак XSS возникает при добавлении/привязке HTML к DOM. По возможности используйте простой текст, чтобы снизить этот риск. Если требуется HTML, вы должны очистить это содержимое перед добавлением его в запись.
Следуйте общим рекомендациям по написанию клиентских сценариев. Больше информации: Клиентские скрипты в приложениях на основе модели
Обеспечьте инклюзивные методы разработки, включая использование инструментов автоматического тестирования, таких как Accessibility Insights.

Образец решения

Вы можете начать с образца решения для настраиваемых соединителей, у которого есть веб-ресурс SecondaryRecordSource, который настроен для форм "Организация для интерактивного взаимодействия" и "Организация для многосеансовой работы".

См. также

Использование временной шкалы
Настройка временной шкалы

Примечание

Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).

Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).

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