Создание страницы контента для вкладки

Страница контента — это веб-страница, отрисовка в Teams клиенте. Они являются частью:

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

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

Рекомендации по контенту и дизайну вкладок

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

Дополнительные сведения см. в рекомендациях по разработке вкладок и Microsoft Teams проверки хранения.

Интеграция кода с Teams

Чтобы ваша страница отображалась в Teams, необходимо включить Microsoft Teams клиента JavaScript sDK и включить вызов после загрузки microsoftTeams.initialize() страницы.

В следующем коде приводится пример взаимодействия страницы и Teams клиента:

<!DOCTYPE html>
<html>
<head>
...
    <script src= 'https://statics.teams.cdn.office.net/sdk/v1.10.0/js/MicrosoftTeams.min.js'></script>
...
</head>

<body>
...
    <script>
    microsoftTeams.initialize();
    </script>
...
</body>

Доступ к дополнительному контенту

Вы можете получить доступ к дополнительному контенту с помощью SDK для взаимодействия с Teams, создания глубоких ссылок, использования модулей задач и проверки того, включены ли URL-домены в validDomains массив.

Используйте SDK для взаимодействия с Teams

Клиентская Teams JavaScript SDK предоставляет множество дополнительных функций, которые можно найти полезными при разработке страницы контента.

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

Модули задач

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

Допустимые домены

Убедитесь, что все URL-домены, используемые в вкладке, включены в массив validDomains манифеста. Дополнительные сведения см. в справке по схеме манифеста validDomains.

Примечание

Основные функции вкладки существуют в Teams, а не за пределами Teams.

Показать индикатор загрузки

Начиная с схемы манифеста v1.7,можно предоставить индикаторзагрузки. Например, страница контента вкладок, страница конфигурации,страница удаленияи модули задач на вкладке.

Примечание

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

Если вы указываете в манифесте приложения, то все конфигурации вкладок, содержимое, страницы удаления и все модули задач на основе iframe должны следовать showLoadingIndicator : true следующим шагам:

Показать индикатор загрузки

  1. Добавьте "showLoadingIndicator": true в манифест.

  2. вызова метода microsoftTeams.initialize();;

  3. В качестве обязательного шага позвоните, чтобы уведомить Teams, что ваше приложение microsoftTeams.appInitialization.notifySuccess() успешно загружено. Teams затем скрывает индикатор загрузки, если это применимо. Если не вызвано в течение 30 секунд, предполагается, что ваше приложение ото времени и появится экран ошибок с параметром notifySuccess повторной проверки.

  4. Необязательно, если вы готовы печатать на экране и хотите лениво загрузить остальную часть контента приложения, вы можете вручную скрыть индикатор загрузки, microsoftTeams.appInitialization.notifyAppLoaded(); позвонив.

  5. Если приложение не загружается, вы можете позвонить, чтобы microsoftTeams.appInitialization.notifyFailure(reason); Teams, что произошла ошибка. Экран ошибки отображается пользователю. В следующем коде приводится пример причин отказа приложения:

    /* List of failure reasons */
    export const enum FailedReason {
        AuthFailed = "AuthFailed",
        Timeout = "Timeout",
        Other = "Other"
    }
    

Следующий этап

См. также