Поделиться через

Автоматическое открытие области задач при установке надстройки

Вы можете настроить запуск области задач надстройки сразу после ее установки. Эта функция увеличивает использование.

По умолчанию надстройки области задач, которые не содержат никаких команд надстроек , открывают область задач сразу после установки. Однако если надстройка содержит одну или несколько команд надстройки, пользователь получает уведомление о новой надстройке, но она не запускается автоматически. Это историческое поведение по умолчанию меняется, поэтому надстройки с командами надстроек будут запускаться автоматически в некоторых ситуациях. Кроме того, если надстройка содержит несколько страниц области задач, вы можете управлять запуском надстройки после установки и, если да, какая страница откроется в области задач.

Примечание.

  • Эта функция применяется только к надстройкам, установленным конечным пользователем, но не к централизованно развернутым надстройкам.
  • Эта функция не применяется к контентным надстройкам или надстройкам Почты (Outlook).
  • Эта функция применяется только к надстройкам, имеющим по крайней мере одну команду надстройки типа "команда области задач".

Новое поведение

Новое поведение выглядит следующим образом:

  • Если надстройка содержит только одну команду области задач, то вкладка ленты надстройки выбирается и область задач открывается автоматически после установки. Вам не нужно ничего настраивать.
  • Если надстройка содержит несколько команд области задач и одна из них настроена по умолчанию (см . раздел Настройка области задач по умолчанию), то вкладка ленты надстройки выбирается и область задач по умолчанию открывается автоматически после установки.
  • Если надстройка содержит несколько команд области задач, но ни одна из них не настроена для использования по умолчанию, то вкладка ленты надстройки выбирается автоматически при установке, а рядом с ней появится выноска с уведомлением пользователя о новой надстройке, но область задач не открывается. Это то же самое, что и историческое поведение по умолчанию.

Примечание.

Если по какой-либо причине команда надстройки, которая запускает область задач, не может быть выбрана пользователем вручную при запуске, например, если она настроена для отключения при запуске, то она не будет автоматически открыта независимо от конфигурации.

Настройка области задач по умолчанию в манифесте

Процесс указания области задач по умолчанию зависит от типа манифеста, используемого надстройкой.

Примечание.

Унифицированный манифест для Microsoft 365 можно использовать в рабочих надстройках Outlook. Он доступен только в качестве предварительной версии для надстроек Excel, PowerPoint и Word.

Чтобы указать область задач по умолчанию, найдите объект среды выполнения в массиве "runtimes" , для свойства которого "code.page" задан URL-адрес страницы, которую вы хотите использовать по умолчанию. Убедитесь, что "actions" массив в этом же объекте среды выполнения содержит по крайней мере одно действие со "type" значением "openPage". "view" Добавьте свойство в объект действия и задайте для него значение "Office.AutoShowTaskpaneWithDocument". Это значение можно задать только для одного объекта действия, и оно должно быть действием типа "openPage". Если задать это значение для нескольких действий, первое вхождение значения будет распознано как значение по умолчанию, а остальные будут игнорироваться.

В следующем примере показано "view" значение "Office.AutoShowTaskpaneWithDocument".

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

Совет

Если вы хотите, чтобы надстройка автоматически запускала каждый раз, когда пользователь повторно открывает документ, необходимо выполнить дальнейшие действия по настройке. Дополнительные сведения и советы по использованию этой функции см. в статье Автоматическое открытие области задач с документом.

См. также

  • Last updated on