Работа с расширенными переопределениями манифеста

  • Статья

Некоторые функции расширения надстроек Office настраиваются с помощью JSON-файлов, размещенных на сервере, а не с XML-манифестом надстройки.

Примечание.

В этой статье предполагается, что вы знакомы с манифестами надстроек Office и их ролью в надстройках. Прочитайте манифест надстроек Office, если вы еще не сделали этого в последнее время.

В следующей таблице указаны функции расширяемости, для которых требуется расширенное переопределение, а также ссылки на документацию по компоненту.

Возможность Инструкции по разработке
Сочетания клавиш Добавление настраиваемых сочетаний клавиш в надстройки Office

Схема, которая определяет формат JSON, является схемой расширенного манифеста.

Совет

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

Сообщите Office, где найти JSON-файл

Используйте манифест, чтобы сообщить Office, где найти JSON-файл. Непосредственно под элементом <VersionOverrides> (не внутри) в манифесте добавьте элемент ExtendedOverrides . Задайте для атрибута Url полный URL-адрес JSON-файла. Ниже приведен пример простейших возможных <элементов ExtendedOverrides> .

    ...
    </VersionOverrides>  
    <ExtendedOverrides Url="https://contoso.com/addin/extended-overrides.json"></ExtendedOverrides>
</OfficeApp>

Ниже приведен пример очень простого json-файла расширенных переопределений. Он назначает сочетание клавиш CTRL+SHIFT+A функции (определенной в другом месте), которая открывает область задач надстройки.

{
    "actions": [
        {
            "id": "SHOWTASKPANE",
            "type": "ExecuteFunction",
            "name": "Show task pane for add-in"
        }
    ],
    "shortcuts": [
        {
            "action": "SHOWTASKPANE",
            "key": {
                "default": "CTRL+SHIFT+A"
            }
        }
    ]
}

Локализация файла расширенных переопределений

Если надстройка поддерживает несколько языковых стандартов, можно использовать ResourceUrl атрибут <элемента ExtendedOverrides> , чтобы указать Office на файл локализованных ресурсов. Ниже приведен пример.

    ...
    </VersionOverrides>  
    <ExtendedOverrides Url="https://contoso.com/addin/extended-overrides.json" 
                       ResourceUrl="https://contoso.com/addin/my-resources.json">
    </ExtendedOverrides>
</OfficeApp>

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