Пять распространенных кодов ошибок API Office и что они означают

Краткие советы

• Коды ошибок Common Office API относятся к модели Common API, а не к частоте появления этих кодов.
• Вы можете столкнуться с десятками кодов ошибок Office API, каждый из которых имеет определенное исправление.
• Иногда исправить ситуацию так же просто, как изменить настройки Microsoft Edge или брандмауэра Windows.

Надстройки Office позволяют расширить стандартное решение Microsoft Office до чего-то большего. Что-то, что может изменить ваш подход к ведению бизнеса или оптимизировать приложения Office в соответствии с вашими потребностями. Но воспользоваться ими — значит научиться создавать API-интерфейсы Office, а вместе с этим возникает вероятность ошибок. На самом деле их несколько, поэтому мы собрали некоторые из наиболее распространенных кодов ошибок Office API и то, что вам следует делать, если вы с ними столкнетесь.

Пять общих кодов API

Когда мы говорим «общий», мы имеем в виду коды ошибок, с которыми вы можете столкнуться при работе в рамках модели Common API. Это не коды ошибок, специфичные для приложения, с которыми вы можете столкнуться, например, при работе с Word JavaScript API. Вот некоторые из них, на которые вам следует обратить внимание.

Код 1 – Код ошибки 1000

Error.code 1000 сообщает вам, что где-то в вашем коде указан недопустимый тип приведения. Excel дает нам хороший пример. Excel не поддерживает типы приведения HTML или OOXML, что делает этот код гарантированным, если вы попытаетесь принудительно его использовать. Если вы еще не знаете, приведение типов — это процесс, которому следуют приложения для преобразования одного типа объекта в другой. Если в этом преобразовании возник конфликт, вы, скорее всего, увидите этот код ошибки.

Код 2 — Ошибка.код 2009.

Этот код ошибки легко вывести, поскольку он касается объектов данных. Чем больше становятся эти объекты, тем больше вероятность того, что один из них выйдет за пределы данных, которые вы определили в своем приложении Office. Если вы видите этот код, решение состоит в том, чтобы уменьшить объект данных, вызывающий проблему.

Код 3 – Ошибка.код 4000

Любой программист скажет вам, что установка имен объектов является ключом к правильной работе программы. Если вы этого не сделаете, вы рискуете столкнуться с error.code 4000. Вы получаете этот код, когда указываете имя параметра, которого нет нигде в вашем коде API.

Код 4 — Ошибка.код 5002.

Доступ запрещен!

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

Код 5 – Ошибка.код 9021

Бывают ошибки подключения. Когда они это сделают, вы не сможете сохранить свой предмет на сервере. Вот что говорит вам error.code 9021 — где-то в вашей настройке возникла ошибка соединения, которую вам нужно исправить. Например, проблемы с «Онлайн-режимом» при использовании Outlook Desktop могут вызвать эту ошибку.

Быстрые исправления распространенных кодов ошибок API Office

Мы коснулись лишь нескольких распространенных кодов ошибок API Office, с которыми вы можете столкнуться в своей карьере разработчика. У каждого есть отдельные исправления, которые предполагают выяснение того, где ваш код пошёл не так, и что с этим делать. Но есть несколько быстрых потенциальных исправлений, которые вы можете попробовать во всех кодах.

Исправление 1. Проверьте настройки брандмауэра

Возможно, ваш брандмауэр мешает работе приложения, которое вы пытаетесь запустить. Отключение или проверка настроек брандмауэра, чтобы он не пытался заблокировать созданную вами программу, может дать вам быстрое решение.

Шаг 1. Введите «Безопасность Windows» в строку поиска внизу экрана и щелкните значок с тем же именем.

Шаг 2. Выберите «Брандмауэр и защита сети» из вариантов слева и просканируйте различные домены, чтобы увидеть их настройки брандмауэра. Отключение вашего домена или частных сетей может привести к запуску вашего кода API.

Шаг 3. Либо нажмите «Разрешить приложению через брандмауэр» и предоставьте созданному вами приложению разрешение преодолевать брандмауэр Windows.

Исправление 2. Отключите режим совместимости Microsoft Edge

Если вы получаете какие-либо ошибки, связанные с Интернетом, связанные с определяемыми вами свойствами, проблема может быть в Microsoft Edge, работающем в режиме совместимости. Вот как это отключить.

Шаг 1. Нажмите на многоточие — символ «…» — в правом верхнем углу Edge и выберите «Настройки».

Шаг 2. Перейдите на вкладку «Браузер по умолчанию» с помощью панели навигации.

Шаг 3. Выберите «Не разрешать» в раскрывающемся списке рядом с «Разрешить перезагрузку сайтов в режиме Internet Explorer (режим IE)».

Спасибо за ваш отзыв!