Ссылки на библиотеку API JavaScript для Office

  • Статья

Библиотека API JavaScript для Office предоставляет API- интерфейсы, которые надстройка может использовать для взаимодействия с приложением Office. Самый простой способ сослаться на библиотеку — использовать сеть доставки содержимого (CDN), добавив следующий <script> тег в <head> раздел HTML-страницы.

<head>
    ...
    <script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js" type="text/javascript"></script>
</head>

При первой загрузке надстройки будут загружены и кэшируются файлы API JavaScript для Office, чтобы убедиться, что она использует самую актуальную реализацию Office.js и связанные с ней файлы для указанной версии.

Важно!

Необходимо ссылаться на API JavaScript для Office из <head> раздела страницы, чтобы убедиться, что API полностью инициализирован перед любыми элементами текста.

Управление версиями API и обратная совместимость

В предыдущем фрагменте /1/office.js HTML перед в URL-адресе CDN указывается последний добавочный выпуск в версии 1 Office.js. Так как API JavaScript для Office поддерживает обратную совместимость, последний выпуск будет по-прежнему поддерживать члены API, представленные ранее в версии 1. Если вам нужно обновить существующий проект, см . статью Обновление версии API JavaScript для Office и файлов схемы манифеста.

Если вы планируете опубликовать надстройку Office из AppSource, необходимо использовать эту ссылку CDN. Локальные ссылки подходят только для внутренних сценариев, а также сценариев разработки и отладки.

Примечание.

Чтобы использовать API предварительных версий, требуется указать ссылку на предварительную версию библиотеки API JavaScript для Office в сети CDN: https://appsforoffice.microsoft.com/lib/beta/hosted/office.js.

Включение IntelliSense для проекта TypeScript

Помимо ссылки на API JavaScript для Office, как описано ранее, можно также включить проект надстройки IntelliSense для TypeScript с помощью определений типов из DefinitelyTyped. Для этого выполните следующую команду в системной командной строке с поддержкой узла (или окне git bash) из корневой папки проекта. У вас должен быть установлен Node.js (содержащий npm).

npm install --save-dev @types/office-js

Предварительная версия API

Новые API JavaScript сначала появляются в предварительной версии, а затем становятся частью определенного нумерованного набора требований после достаточного тестирования и получения отзывов пользователей.

Примечание.

API предварительной версии могут быть изменены и не предназначены для использования в рабочей среде. Рекомендуется использовать их только в тестовой среде и среде разработки. Не используйте API предварительной версии в рабочей среде или в важных деловых документах.

Чтобы использовать API предварительной версии:

Ссылки cdn для других сред Microsoft 365

21Vianet управляет службой Office 365 на основе лицензированных технологий Майкрософт для предоставления Office 365 услуг для Китая в соответствии с местными законами и нормативными актами. Надстройки, разработанные для использования в этой облачной среде, должны использовать соответствующую сеть CDN. Используйте https://appsforoffice.cdn.partner.office365.cn/appsforoffice/lib/1/hosted/office.js вместо стандартной ссылки CDN. Это обеспечивает постоянное соответствие требованиям и обеспечивает более высокую производительность надстроек.

См. также