Надстройка Word - как проверить, доступна ли функция createDocument ()?

Я использую Office JS для разработки надстройки Word.

Благодаря предыдущим ответам я обнаружил, что могу открыть новый документ в Word, выполнив следующие действия:

context.application.createDocument().open();

Однако похоже, что это работает только в настольной версии Office.

Если я попробую то же самое дополнение в онлайн-версии, я получаю сообщение об ошибке:

Sorry, this function isn’t available. Perform a runtime check on the Office add-in to find out whether the feature is supported by the host

Как я могу программно узнать, доступна ли эта функция, чтобы я мог настроить плагин по умолчанию на другое поведение, если это не так?

Кроме того, есть ли документация по функции createDocument? (Погуглил и ничего не нашел).


office-addins office365 ms-office office-js
person EsPl    schedule 03.07.2017    source источник

Ответы (1)


arrow_upward
2
arrow_downward

В общем случае вы должны использовать isSetSupported проверку API во время выполнения, чтобы увидеть, доступен ли конкретный метод. См. https://dev.office.com/docs/add-ins/develop/office-js-versioning

В этом конкретном случае вы сталкиваетесь с тем фактом, что createDocument является частью еще не выпущенного (только для предварительной версии) WordApi 1.4 (PREVIEW) набора API (вы можете увидеть это в IntelliSense, как в файле d.ts (TypeScript)) и vsdoc (JavaScript в VS 2015 и ранее). Например, в https://github.com/OfficeDev/office-js/blob/beta/dist/office.d.ts

введите здесь описание изображения

Поскольку это предварительный просмотр, это, к сожалению, означает, что isSetSupported вернет «false» независимо ... потому что он просто может быть еще нигде не надежно доступен (или, по крайней мере, команда не дала согласия на его выполнение и доступность). Итак, для этих API-интерфейсов предварительного просмотра он действительно предназначен только для вашего собственного тестирования разработчиков, а не для всего, что вы бы использовали в производстве.

person Michael Zlatkovsky - Microsoft    schedule 03.07.2017