Поделиться в Teams из личного приложения или вкладки

  • Статья

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

На следующем рисунке показано всплывающее окно "Поделиться в Teams":

Кнопка "Включить общий доступ к Teams"

Примечание.

Убедитесь, что у вас есть клиентская библиотека JavaScript Microsoft Teams (@microsoft/teams-js@1.11.0-beta.7 или более поздняя версия), чтобы включить общий доступ к Teams для личного приложения или вкладки.

Чтобы включить общий доступ к Teams, выполните приведенные далее действия.

  1. Создайте личное приложение или вкладку с помощью клиентской библиотеки JavaScript для Teams.

  2. Создайте кнопку "Поделиться в Teams ".

  3. На кнопке Поделиться в Teams вызовите microsoftTeams.sharing.shareWebContent полезные данные содержимого.

В следующем примере объясняется, как создать полезные данные содержимого:

microsoftTeams.sharing.shareWebContent({
        content: [
          {
            type: 'URL',
            url: '<URL to be shared>',
            message: 'Default message to be loaded in the compose box',
            preview: true
          }
        ]
      });

Полезные данные содержат следующие параметры:

Имя свойства Назначение
type Тип должен иметь значение URL
url URL требуется предоставить общий доступ
message Сообщение по умолчанию для загрузки в поле создания
preview Задайте значение true , чтобы включить предварительный просмотр URL-адресов

На следующем рисунке показан параметр Поделиться в Teams:

Кнопка

Кнопка "Общий доступ к Teams" может быть размещена или внедрена в приложение, работающее в Teams. Вы можете добавить кнопку "Поделиться в Teams" в приложение, созданное с помощью клиентской библиотеки JavaScript Для Teams.

Примечание.

Общий доступ к Teams не поддерживается в модальном диалоговом окне (называемом модулями задач в TeamsJS версии 1.x) или в представлении этапов в веб-клиенте Teams. Вы не можете открыть модальное поверх другого модального.

Коды ответа

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

Код ответа Описание
100 API не поддерживается в текущей платформе.
404 Указанный файл не найден в заданном расположении.
500 Внутренняя ошибка, обнаруженная при выполнении требуемой операции.
501 API не поддерживается в текущем контексте.
1000 Разрешения, запрещенные пользователем.
2000 Проблема с сетью.
3000 Базовое оборудование не поддерживает такую возможность.
4000 Один или несколько недопустимых аргументов.
5000 Пользователь не авторизован для этой операции.
6000 Не удалось завершить операцию из-за нехватки ресурсов.
7000 Платформа регулирует запрос, так как API вызывается слишком часто.
8000 Пользователь прервал операцию.
9000 Код платформы устарел и не реализует этот API.
10000 Возвращаемое значение слишком велико и превысило наши границы размера.

Взаимодействие с конечным пользователем в Teams

После включения кнопки Поделиться в Teams в личном приложении или вкладке вы можете поделиться содержимым. Чтобы получить доступ, выполните следующие действия:

  1. Откройте личное приложение или вкладку и выберите Поделиться в Teams.

    Кнопка

  2. Добавьте другого пользователя или группу или канал для предоставления общего доступа к содержимому.

    add-recipient

  3. Нажмите Поделиться.

    заметка о надстройке

  4. Выберите Вид , чтобы связаться с беседой, в которой была предоставлена ссылка.

    share-to-teams-link-shared

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