Управление сеансами и сохраняемостью в Excel

  • Статья

Если приложению необходимо выполнить более одного или двух вызовов API Excel в Microsoft Graph, создайте сеанс и передайте идентификатор сеанса с каждым запросом. Наличие идентификатора сеанса в запросах гарантирует, что вы используете API Excel наиболее эффективным способом.

API Excel вызываются в одном из трех режимов:

  • Постоянный сеанс: Все изменения, внесенные в книгу, сохраняются (сохраняются) в книге. Это наиболее эффективный и производительный способ использования API Excel.

  • Непостоянный сеанс: Изменения, внесенные API, не сохраняются в исходном расположении. Вместо этого внутренний сервер Excel сохраняет временную копию файла, в которой отражены изменения, внесенные во время конкретного сеанса API. Когда истечет срок действия сеанса Excel, изменения будут потеряны. Этот режим удобен для приложений, которым нужно выполнять анализ или получать результаты вычислений или изображение диаграммы, не меняя состояние документа.

  • Без сеанса: Вызовы API не передают идентификатор сеанса. Серверы Excel должны найти серверную копию книги для каждой операции. Этот способ вызова API Excel неэффективен, но подходит для отправки некоторых изолированных запросов.

Чтобы представить сеанс в API, используйте заголовок workbook-session-id: {session-id}.

Примечание.

Заголовок сеанса не требуется для работы API Excel. Однако для повышения производительности рекомендуется использовать заголовок сеанса. Если вы не используете заголовок сеанса, изменения, внесенные во время вызова API, сохраняются в файле.

Типы запросов

Рекомендуемая обработка ошибок для API Excel основана на типе запроса, коде ошибки и коде состояния. Ниже приведены типы запросов.

  • CreateSession request: Используется для создания постоянного или непостояного сеанса. В успешном ответе идентификатор сеанса будет возвращен в свойстве id в тексте ответа. Дополнительные сведения см. в разделе Создание сеанса.
  • Сеансовый запрос: Последующие запросы, следующие за запросом CreateSession. Обычно они включают заголовок workbook-session-id: {session-id} . Исключением является запрос на состояние опроса, в котором используется шаблон длительных операций. Дополнительные сведения см. в статье Работа с API, которые занимают много времени.
  • Запрос без сеанса: Используется в режиме без сеанса. У этих запросов нет заголовка workbook-session-id: {session-id} .

Дальнейшие действия

Сведения о том, как создавать и использовать сеансы, см. в справочной статье о создании сеанса.

Связанные материалы