Создание соединителей Teams
Соединитель Microsoft Teams — это пример приложения для управления задачами model-view-controller (MVC), созданный с помощью шаблона веб-приложения ASP.NET. Большая часть кода связана с базовой конфигурацией MVC или системой управления задачами. Вы можете добавить существующий соединитель для Группы Microsoft 365 или создать новый в Teams.
Типы кодов соединителей
- ConnectorController.cs. Настройка и сохранение действий.
- TaskController.cs: действия Create и обновления.
Основные функции соединителя Microsoft Teams
- Имитирует реальную систему управления задачами.
- Позволяет пользователям создавать и просматривать задачи.
- Создает содержимое случайным образом.
- Имитирует уведомление, отправляемые на канал Microsoft Teams.
Это пошаговое руководство поможет вам создать и протестировать соединитель в Microsoft Teams. Вы увидите следующие выходные данные:
Предварительные условия
Убедитесь, что установлены следующие средства и настроена среда разработки:
| Установка | Для использования... | |
|---|---|---|
| Microsoft Teams | Microsoft Teams позволяет сотрудничать со всеми пользователями, с которыми вы работаете, с помощью приложений для чата, собраний и звонков в одном месте. | |
| Visual Studio 2022 | Вы можете установить корпоративную версию в Visual Studio 2022, а также рабочие нагрузки ASP.NET и веб-разработки. Используйте последнюю версию. | |
| Пакет SDK для .NET Core | Настраиваемые привязки для локальной отладки и Функции Azure развертываний приложений. Используйте последнюю версию или установите переносимую версию. | |
| Туннель разработки | Функции приложений Teams (диалоговые боты, расширения сообщений и входящие веб-перехватчики) требуют входящих подключений. Туннель соединяет систему разработки с Teams. Туннель разработки — это мощный инструмент для безопасного открытия локального узла в Интернете и контроля доступа. Туннель разработки доступен в Visual Studio 2022 версии 17.7.0 или более поздней. или вы также можете использовать ngrok в качестве туннеля для подключения системы разработки к Teams. Он не требуется для приложений, которые содержат только вкладки. Этот пакет устанавливается в каталоге проекта (с помощью npm devDependencies). |
Примечание.
После скачивания ngrok зарегистрируйтесь и установите authtoken.
Настройка локальной среды
Откройте Microsoft-Teams-Samples.
Выберите Код.
В раскрывающемся меню выберите Открыть с помощью GitHub Desktop.
Выберите Клонировать.
Включение предварительной версии для разработчиков
Включите отправку приложений в консоли администрирования клиента.
Войдите в Центр администрирования Microsoft 365 со своими учетными данными администратора.
В левой области выберите Показать все.
Выберите Teams.
В левой области выберите Приложения Teams.
Выберите Настройка политик.
Выберите Глобальный (по умолчанию для всей организации).
Включите переключатель Отправка пользовательских приложений .
Выберите Сохранить.
Теперь тестовый клиент может разрешить отправку пользовательских приложений.
Совет
Отправка пользовательского приложения занимает некоторое время, чтобы стать активным.
Перейдите в Microsoft Teams.
В правом верхнем углу Teams выберите ....
Выберите О приложении>Предварительная версия для разработчиков.
Выберите Переключиться на предварительную версию для разработчиков.
Настройка соединителя
Откройте TeamsToDoAppconnector.sln в Visual Studio из клонированного репозитория.
Create туннеля
Откройте Visual Studio.
Выберите Create новый проект.
В поле поиска введите ASP.NET. В результатах поиска выберите ASP.NET Core Веб-приложение.
Нажмите кнопку Далее.
Введите имя проекта и нажмите кнопку Далее.
Нажмите Создать.
Откроется окно обзора.
В раскрывающемся списке отладки выберите Dev Tunnels (без активного туннеля)>Create tunnel....
Открывается всплывающее окно.
Обновите следующие сведения во всплывающем окне:
- Учетная запись. Введите учетную запись Майкрософт или GitHub.
- Имя: введите имя туннеля.
- Тип туннеля: в раскрывающемся списке выберите Временный.
- Доступ: в раскрывающемся списке выберите Общедоступный.
Нажмите OK.
Появится всплывающее окно, показывающее, что туннель разработки успешно создан.
Нажмите OK.
Созданный туннель можно найти в раскрывающемся списке отладки следующим образом:
Нажмите клавишу F5 , чтобы запустить приложение в режиме отладки.
Если появится диалоговое окно Предупреждение системы безопасности , выберите Да.
Открывается всплывающее окно.
Нажмите Продолжить.
В новом окне браузера откроется домашняя страница туннеля разработки, и туннель разработки теперь активен.
Перейдите в Visual Studio и выберите Просмотреть выходные > данные.
В раскрывающемся меню консоли вывода выберите Dev Tunnels (Туннели разработки).
В консоли вывода отображается URL-адрес туннеля разработки.
Перейдите на портал разработчика соединителя.
Выберите Новый соединитель.
Введите следующие сведения, чтобы зарегистрировать новый соединитель:
- Имя соединителя.
- Логотип
- Краткое описание приложения (не более 10 слов).
- Подробное описание действий соединителя (3–5 предложений).
- Веб-сайт компании.
- Страница конфигурации соединителя как
https://[BASE_URI]/connector/setup. - Задайте допустимые домены как
https>//[Base URI]. - Выберите Да , чтобы включить действие на карточках соединителя.
- Задайте для свойства URL-адрес действий значение
https://[BASE_URI]/Task/Update. - Выберите Я принимаю условия Соглашения с разработчиком приложений.
- Выберите Сохранить.
Вы успешно зарегистрировали новый соединитель. Откроется окно с зарегистрированным идентификатором соединителя.
Совет
Сохраните идентификатор соединителя для дальнейшего использования.
Откройте файл TeamsToDoAppConnector.csproj из клонированного репозитория.
В клонированных репозитория перейдите к microsoft-Teams-Samples>samples>connector-todo-notification>csharp.
Откройте файл appsettings.json в Visual Studio и выполните следующие обновления.
- Замените на
BASE_URLngork URLилиdev tunnel URL. - Замените
CONNECTOR_IDсозданным идентификатором соединителя.
- Замените на
В клонированном репозитории перейдите к microsoft-Teams-Samples>>connector-todo-notification>csharp>TeamsAppPackages.
Откройте файл manifest.json в Visual Studio и внесите следующие изменения:
Замените
CONNECTOR_IDсозданным идентификатором соединителя.Замените
VALID-DOMAINна домен ngrok OR dev tunnel, за исключением https://.
Нажмите клавишу F5 , чтобы запустить проект. Откроется веб-страница.
Тестирование соединителя в Microsoft Teams
Create файл .zip со следующими файлами, которые находятся в папке Manifest:
manifest.json
outline-icon.png
color-icon.png
Перейдите в Microsoft Teams.
В левой области щелкните значок Приложения .
Выберите Управление приложениями
Выберите Отправить приложение.
Найдите параметр Отправить пользовательское приложение.
Выберите файл .zip, созданный в папке Манифест , и нажмите кнопку Открыть.
Выберите Добавить в команду.
Выберите команду или название канала в списке.
Выберите Настроить соединитель.
В левой области найдите соединитель ToDo Teams в строке поиска и выберите Настроить.
Выберите Создано или Обновлено на странице регистрации и нажмите кнопку Сохранить.
После настройки вы увидите уведомление в канале со ссылкой на портал диспетчера задач.
Перейдите на портал диспетчера задач.
Выберите Create Создать.
Введите сведения о новой задаче:
- Название
- Описание
- Назначить
Выберите Сохранить.
Сообщение карта отображается в зарегистрированном канале Teams.
Совет
Вы можете попробовать интерактивные кнопки, доступные на карта сообщения.
Выполнение задачи
Ты придумала что-то вроде этого?
Поздравляем!
Вы завершили руководство, чтобы приступить к работе с соединителями Microsoft Teams!
Возникла проблема с этим разделом? Если это так, отправьте нам отзыв, чтобы мы исправили этот раздел.
Platform Docs
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по