基于事件的 Outlook 加载项的 AppSource 列表选项

加载项必须由组织的管理员部署,最终用户才能访问 基于事件的激活 功能。 如果最终用户直接从 AppSource 获取加载项,则基于事件的激活受到限制。 例如,如果 Contoso 外接程序包含基于事件的函数,则仅当加载项由其组织的管理员为最终用户安装时,才会自动调用加载项。否则,将阻止加载项的自动调用。

最终用户或管理员可以通过 AppSource 或应用内 Microsoft 365 和 Copilot 应用商店获取加载项。 如果外接程序的主要方案或工作流需要基于事件的激活,则你可能希望将加载项限制为管理员部署。 若要启用该限制,可以在 AppSource 中为加载项提供外部测试版代码 URL。 由于外部测试版代码,只有具有这些特殊 URL 的最终用户才能访问列表。 下面是一个示例 URL。

https://appsource.microsoft.com/product/office/WA200002862?flightCodes=EventBasedTest1

启用外部测试版代码后,用户和管理员无法在 AppSource 或应用内 Microsoft 365 和 Copilot 存储中按其名称显式搜索加载项。 作为加载项创建者,你可以与组织管理员私下共享这些外部测试版代码,以便进行加载项部署。

注意

虽然最终用户可以使用外部测试版代码安装加载项,但外接程序不包括基于事件的激活。

重要

如果清单的发送模式属性设置为提示用户软阻止选项,则使用智能警报功能的加载项只能发布到 AppSource。 如果加载项的发送模式属性设置为 阻止,则只能由组织的管理员部署,因为它将失败 AppSource 验证。

指定外部测试版代码

若要为外接程序指定外部测试版代码,请在发布外接程序时在 认证说明 中共享代码。 重要提示:外部测试代码区分大小写。

发布过程中,认证说明屏幕中的外部测试代码示例请求。

使用外部测试版代码部署外接程序

设置外部测试代码后,你将收到来自应用认证团队的 URL。 然后,可以私下与管理员共享 URL。

若要部署加载项,管理员可以使用以下步骤。

  • 使用 Microsoft 365 管理员帐户登录到 admin.microsoft.com 或 AppSource.com。 如果加载项启用了单一登录 (SSO) ,则需要全局管理员凭据。
  • 在 Web 浏览器中打开外部测试版代码 URL。
  • 在加载项列表页上,选择“ 立即获取”。 应重定向到集成应用门户。

不受限制的 AppSource 列表

如果你的外接程序没有将基于事件的激活用于关键方案 (即,外接程序在没有自动调用) 的情况下运行良好,请考虑在 AppSource 中列出你的加载项,而不使用任何特殊的外部测试代码。 如果最终用户从 AppSource 获取加载项,则不会为该用户自动激活。 但是,他们可以使用加载项的其他组件,例如任务窗格或函数命令。

重要

这是一个临时限制。 将来,我们计划为直接获取加载项的最终用户启用基于事件的加载项激活。

更新现有加载项以包含基于事件的激活

你可以更新现有外接程序以包含基于事件的激活,然后重新提交它进行验证,并决定是需要受限还是不受限制的 AppSource 列表。

更新的加载项获得批准后,以前部署加载项的组织管理员将在管理中心的 “集成应用 ”部分中收到更新消息。 该消息告知管理员有关基于事件的激活更改。 管理员接受更改后,更新将部署到最终用户。 若要详细了解管理员同意过程,请参阅管理员同意安装基于事件的加载项

“集成应用”屏幕上的应用更新通知。

对于自行安装加载项的最终用户,即使加载项已更新,基于事件的激活功能也不起作用。

每当从 “集成应用” 屏幕部署基于事件的外接程序时,管理员都会在部署向导中获取有关外接程序基于事件的激活功能的详细信息。 详细信息将显示在 “应用权限和功能 ”部分中。 管理员应看到加载项可以自动激活的所有事件。

部署新应用时,“接受权限请求”屏幕。

同样,当现有加载项更新为基于事件的功能时,管理员将在加载项上看到“更新挂起”状态。 仅当管理员同意 应用权限和功能 部分中所述的更改(包括加载项可自动激活的事件集)时,才会部署更新的加载项。

每次向外接程序添加任何新的基于事件的激活函数时,管理员都会在管理门户中看到更新流,并且需要同意其他事件。 若要详细了解更新和同意过程,请参阅 在集成应用门户中管理应用

部署更新的应用时的“汇报”流。

另请参阅