教程 - 生成任务管理应用 - Teams

Microsoft Teams 连接器是模型-视图-控制器 (MVC) 示例任务管理应用程序，使用 ASP.NET Web 应用程序模板生成。大多数代码都与基本 MVC 配置或任务管理系统相关。可以为 Microsoft 365 组添加现有连接器，或在 Teams 中生成新连接器。

连接器代码的类型

ConnectorController.cs：设置和保存操作。
TaskController.cs：创建和更新操作。

Microsoft Teams 连接器的主要功能

模拟实际任务管理系统。
允许用户创建和查看任务。
随机生成内容。
模拟要发送到Microsoft Teams 通道的通知。

本分步指南可帮助你在 Microsoft Teams 中创建和测试连接器。你将看到以下输出：

成功完成分步指南后生成团队连接器输出的屏幕截图。

先决条件

剩余 10 分钟

确保安装以下工具并设置开发环境：

	安装	用于使用...
	Microsoft Teams	Microsoft Teams，在一个位置通过聊天、会议和通话应用与你合作的每个人进行协作。
	Visual Studio 2022	可以在 Visual Studio 2022 中安装企业版，并安装 ASP.NET 和 Web 开发工作负载。使用最新版本。
	.NET Core SDK	用于本地调试和 Azure Functions 应用部署的自定义绑定。使用最新版本或安装可移植版本。
	开发隧道	Teams 应用功能 (对话机器人、消息扩展和传入 Webhook) 需要入站连接。隧道将开发系统连接到 Teams。开发隧道是一种功能强大的工具，用于安全地将 localhost 打开到 Internet 并控制谁有权访问。 Visual Studio 2022 版本 17.7.0 或更高版本中提供了开发隧道。或者还可以使用 ngrok 作为隧道，将开发系统连接到 Teams。对于仅包含选项卡的应用，这不是必需的。此包使用 npm `devDependencies`) 安装在项目目录 (中。

注意

下载 ngrok 后，注册并安装 authtoken。

设置本地环境

剩余 9 分钟

打开 Microsoft-Teams-Samples。
选择“ 代码”。
在下拉菜单中，选择“ 使用 GitHub Desktop 打开”。
选择“ 克隆”。

启用开发人员预览版

剩余 8 分钟

在租户的管理控制台中启用应用上传。
1. 请使用管理员帐户登录到“Microsoft 365 管理中心”。
2. 在左窗格中，选择“ 全部显示”。
3. 选择 “Teams”。
在左窗格中，选择“ Teams 应用”。
选择 “设置策略”。
选择 “全局 (组织范围的默认) 。
打开 “上传自定义应用 ”切换。
选择“保存”。

测试租户现在可以允许自定义应用上传。

提示

自定义应用上传需要一些时间才能激活。
转到 Microsoft Teams。
在 Teams 的右上角，选择“ ...”。
选择“关于”>“开发人员预览”。
选择“ 切换到开发人员预览版”。

配置连接器

剩余 7 分钟

从克隆的存储库在 Visual Studio 中打开 TeamsToDoAppconnector.sln 。

创建隧道
- 开发隧道
- ngrok
1. 打开 Visual Studio。
2. 选择 “创建新项目”。
3. 在搜索框中，输入 “ASP.NET”。在搜索结果中，选择“ ASP.NET 核心 Web 应用”。
4. 选择 下一步。
5. 输入 “项目名称 ”，然后选择“ 下一步”。
6. 选择“创建”。
  
  此时会显示概述窗口。
7. 在调试下拉列表中，选择“ 开发隧道 (无活动隧道) >创建隧道...”。
  
  将出现一个弹出窗口。
8. 在弹出窗口中更新以下详细信息：
  1. 帐户：输入Microsoft或 GitHub 帐户。
  2. 名称：输入隧道的名称。
  3. 隧道类型：从下拉列表中选择“ 临时”。
  4. 访问：从下拉列表中选择“ 公共”。
9. 选择“确定”。
  
  此时会显示一个弹出窗口，显示已成功创建开发隧道。
10. 选择“确定”。
  
  可以在调试下拉列表中找到已创建的隧道，如下所示：
11. 选择 F5 以在调试模式下运行应用程序。
12. 如果出现 “安全警告 ”对话框，请选择“ 是”。
  
  将出现一个弹出窗口。
13. 选择继续。
  
  开发隧道主页将在新的浏览器窗口中打开，开发隧道现在处于活动状态。
14. 转到 Visual Studio，选择“ 查看 > 输出”。
15. 在 “输出 控制台”下拉菜单中，选择“ 开发隧道”。
  
  输出控制台显示开发隧道 URL。
使用 ngrok 或命令提示符创建到本地运行的 Web 服务器的公开可用 HTTPS 终结点的隧道。在 ngrok 中运行以下命令：
```
ngrok http --host-header=localhost 3978
```
提示

如果遇到 ERR_NGROK_4018，请按照命令提示符中提供的步骤注册并验证 ngrok。然后运行命令 ngrok http --host-header=localhost 3978 。

窗口显示 HTTPS URL。
转到连接器开发人员门户。
选择 "新建连接器。
输入以下详细信息以注册新连接器：
- 连接器名称。
- 商标
- 应用的简短说明 (10 个字或更少) 。
- 连接器的用途的详细说明 (3-5 个句子) 。
- 公司网站。
- 连接器的配置页 为 https://[BASE_URI]/connector/setup。
- 将 “有效域” 设置为 https>//[Base URI]。
- 选择“ 是 ”以对连接器卡启用操作。
- 将 “操作 URL ”设置为 https://[BASE_URI]/Task/Update。
- 选择“ 我接受应用开发人员协议的条款和条件”。
- 选择“保存”。
已成功注册新连接器。此时将显示带有已注册连接器 ID 的窗口。

提示

保存连接器 ID 以供将来参考。
从克隆的存储库中打开 TeamsToDoAppConnector.csproj 文件。
在克隆的存储库中，转到 Microsoft-Teams-Samples>示例>连接器-todo-notification>csharp。
在 Visual Studio 中打开 appsettings.json 文件并执行以下更新。
- 将 BASE_URL 替换为 ngork URL 或 dev tunnel URL。
- 将替换为 CONNECTOR_ID 创建的连接器 ID。
在克隆的存储库中，转到 Microsoft-Teams-Samples>示例>connector-todo-notification>csharp>TeamsAppPackages。
在 Visual Studio 中打开 manifest.json 文件，然后进行以下更改：
- 将替换为 CONNECTOR_ID 创建的连接器 ID。
- 将替换为 VALID-DOMAIN ngrok 或开发隧道域（不包括 https://）。
按 F5 运行项目。此时会打开一个网页。

Microsoft Teams 中的测试连接器

剩余 6 分钟

使用清单文件夹中存在的以下文件创建 .zip 文件：
- manifest.json
- outline-icon.png
- color-icon.png
转到 Microsoft Teams。
1. 在左窗格中，选择“ 应用” 图标。
2. 选择“管理应用”。
3. 选择 “上传应用”。
4. 查找“ 上传自定义应用”选项。
选择在 “清单” 文件夹中创建的 .zip 文件，然后选择“ 打开”。
选择“ 添加到团队”。
从列表中选择团队或频道名称。
选择 “设置连接器”。
在左窗格中，在搜索栏中搜索 Teams ToDo 连接器，然后选择“ 配置”。
在注册页上选择“ 已创建 ”或“ 更新 ”，然后选择“ 保存”。

配置后，可以在通道中看到通知，其中包含 指向任务管理器门户的链接。
转到 任务管理器门户。
选择“ 新建”。
输入新任务详细信息：
- 标题
- 说明
- 分配到
选择“保存”。

消息卡显示在已注册的 Teams 频道中。

提示

可以尝试消息卡上可用的可操作按钮。