安装加载项时自动打开任务窗格

可以将加载项的任务窗格配置为在安装后立即启动。 此功能会增加使用量。

默认情况下, 不包含 任何 外接程序命令 的任务窗格加载项在安装后立即打开任务窗格。 但是,当加载项具有一个或多个外接程序命令时,系统会通知用户新加载项,但外接程序不会自动启动。 此历史默认行为正在更改,因此在某些情况下,具有外接程序命令的加载项将自动启动。 此外,如果外接程序有多个任务窗格页,则可以控制加载项在安装时是否启动,如果是,则可以控制在任务窗格中打开哪个页面。

注意

  • 此功能仅适用于最终用户安装的加载项,不适用于集中部署的加载项。
  • 此功能不适用于内容加载项或邮件 (Outlook) 加载项。
  • 此功能仅适用于至少具有一个 类型为“任务窗格命令”的外接程序。

新行为

新行为如下所示:

  • 如果外接程序只有一个 任务窗格命令,则会选择加载项的功能区选项卡,并在安装时自动打开任务窗格。 无需配置任何内容。
  • 如果外接程序具有多个任务窗格命令,并且其中一个命令配置为默认 (请参阅 配置默认任务窗格) ,则选择加载项的功能区选项卡,并在安装时自动打开默认任务窗格。
  • 如果外接程序具有多个任务窗格命令,但未配置为默认的,则安装时会自动选择加载项的功能区选项卡,并在加载项附近显示一个标注,通知用户新加载项,但不会打开任何任务窗格。 这与历史默认行为相同。

注意

如果出于任何原因,启动任务窗格的加载项命令在启动时无法由用户手动选择(例如,在启动时 配置为禁用 ),则无论配置如何,都不会自动打开该命令。

清单中的“配置默认任务”窗格

指定默认任务窗格的过程取决于外接程序使用的清单类型。

注意

Microsoft 365 的统一清单可用于生产 Outlook 加载项。它仅作为 Excel、PowerPoint 和 Word 加载项的预览版提供。

若要指定默认任务窗格,请在“runtimes”数组中找到运行时对象,其“code.page”属性设置为要成为默认页面的 URL。 确保同一运行时对象中的“actions”数组至少有一个“type”值为“openPage”的作。 将“view”属性添加到此作对象,并将其设置为“Office.AutoShowTaskpaneWithDocument”。 只能在一个作对象上设置此值,并且该值必须是类型为“openPage”的作。 如果在多个作上设置此值,则会将该值的第一个匹配项识别为默认值,并忽略其他值。

以下示例显示了设置为“Office.AutoShowTaskpaneWithDocument”的“view”值。

"runtimes": [
    {
        ...
        "code": {
            "page": "https://contoso.com/taskpane.html"
        },
        "actions": [
            {
                "id": "ShowTaskPane",
                "type": "openPage",
                "view": "Office.AutoShowTaskpaneWithDocument"
            }
        ]
    }
]

提示

如果希望加载项在用户重新打开文档时自动启动,则需要执行进一步的配置步骤。 有关何时使用此功能的详细信息和建议,请参阅 自动打开包含文档的任务窗格

另请参阅