Диаграмма microsoft graph как открыть

На этом шаге мы рассмотрим основные принципы создания и редактирования диаграмм.

Воспринимать информацию, содержащуюся в документе, намного легче, если он включает диаграммы, таблицы и иллюстрации. Диаграмма Microsoft Graph (MS Graph) позволяет создавать и встраивать в тексты таблицы и диаграммы.

Чтобы встроить в Word -документ объект (диаграмму) из MS Graph , следует установить курсор в позиции вставки и вызвать команду Объект меню Вставка .

Рис.1. Диалоговое окно вставки объекта

В диалоговом окне вставки объекта, в списке типов объектов нужно выбрать элемент Диаграмма Microsoft Graph . После нажатия кнопки ОК откроется окно программы MS Graph , содержащее некоторую диаграмму:

Рис.2. Вставляемые таблица и диаграмма

В этом окне расположено два окна: окно таблицы и окно диаграммы.

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

Для создания такой диаграммы необходимо заполнить таблицу. Верхняя строка таблицы должна содержать номера кварталов. При вводе символов с клавиатуры автоматически уничтожается старое содержимое ячейки. Для выбора шрифта предназначена команда Шрифт пункта меню Формат . Переход в следующую ячейку осуществляется с помощью клавиш управления курсором или мыши. После перехода в следующую ячейку изменения, произведенные в предыдущей ячейке, отражаются в диаграмме. На следующем рисунке приведена заполненная таблица:

Рис.3. Таблица данных

Диаграмма, созданная в MS Graph , в любой момент соответствует данным в таблице. По своему желанию пользователь может изменить тип диаграммы. Для этого необходимо выбрать команду Тип диаграммы в меню Диаграмма . В открывшемся диалоговом окне Тип диаграммы указать тип диаграммы (линейная, круговая и т.д.) и нажать кнопку ОК .

Рис.4. Выбор типа диаграммы

Может возникнуть необходимость изменить не только тип диаграммы, но и шрифт. Для изменения шрифта нужно выполнить двойной щелчок внутри легенды (смотри рисунок 5).

Рис.5. Расположение легенды диаграммы

В результате на экране появится диалоговое окно Формат легенды , содержащее раздел Шрифт .

Рис.6. Окно задания характеристик шрифта

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

Диалоговые окна для форматирования других элементов диаграммы открываются таким же способом — двойным щелчком мыши на нужном элементе.

Чтобы вставить полученную диаграмму в Word -документ, следует щелкнуть в документе (вне диаграммы). В результате диаграмма будет вставлена в документ. Размеры диаграммы можно изменять с помошью маркеров прямо в документе.

Рис.7. Пример вставленной диаграммы с измененными размерами

Для изменения диаграммы нужно маркировать ее и выполнить двойной щелчок, чтобы открыть прикладную программу MS Graph . После внесения изменений и возвращения в документ все изменения отразятся в нем автоматически.

На следующем шаге мы рассмотрим инструмент WordArt .

Разделы справки MS Graph

В этом разделе содержится список разделов справки MS Graph 2007, а также устаревших функций диаграмм, доступных в Access и Excel.

Примечание. В Microsoft 365 и Access 2019 появился новый способ добавления диаграмм в Access. Дополнительные сведения см. в статье Создание диаграммы в форме или отчете.

Форматирование

Добавление эффекта тени или трехмерного эффекта к объекту рисования
Добавление тени к объекту рисунка
Добавление объекта-документа WordArt
Добавление или изменение трехмерного эффекта объекта рисования
Выравнивание текста в заголовках диаграммы или осей
Изменение цветов, узоров, линий, заливок и границ на диаграммах
Изменение шрифта и размера текста на диаграмме
Изменение шрифта в таблице
Изменение формы диаграммы
Изменение текста в объекте-документе WordArt
Изменение нумерового формата ячеек таблицы или элементов диаграммы
Сжатие рисунка
Исправление ошибок орфографии и ввода в таблице при вводе
Создание пользовательских форматов чисел
Форматирование автофигуры
Параметры шрифта
Настройка параметров цвета на диаграмме

Работа с диаграммами и диаграммами

Добавление полос ошибок в ряд данных
Добавление легенды на диаграмму
Добавление заголовка к диаграмме или оси
Добавление меток данных в диаграмму
Добавление линии тренда в ряд данных
Выравнивание текста в заголовках диаграммы или осей
Изменение ширины столбца в таблице
Изменение параметров рядов данных
Изменение единицы отображения на оси значений
Изменение имени или содержимого записи автозамены
Изменение масштаба оси категории (x)
Изменение масштаба оси ряда (y)
Изменение масштаба оси значения (x)
Изменение масштаба оси значения (y)
Изменение масштаба оси значения (z)
Изменение масштаба оси категории (X) и значения (Y)
Изменение параметров линии тренда
Выбор лучшей линии тренда для данных
Управление способом построения пустых ячеек
Отображение или скрытие таблицы данных на диаграмме
Отображение или скрытие осей на диаграмме
Отображение или скрытие линий сетки на диаграмме
Ввод данных в таблицу
Уравнения для вычисления линий тренда
Уравнения для вычисления суммы ошибки
Полосы ошибок в диаграммах
Примеры типов диаграмм
Исключение или включение строк или столбцов таблицы из диаграммы
Получение сведений о версии Microsoft Graph
Вставка пустых ячеек, строк или столбцов в таблицу
Начертить ряд данных вдоль вторичной оси значений на двухуровневой диаграмме
Сохранение пользовательского типа диаграммы для применения к другим диаграммам
Выбор ячеек, диапазонов, строк и столбцов в таблице
Переключение между таблицей и диаграммой
Линии тренда в диаграммах
Способы выбора элементов диаграммы

Устранение неполадок

Не удается распечатать таблицу
Устранение неполадок с объектами рисования
Устранение неполадок с изображениями и импортированной графикой

Работа с Excel в Microsoft Graph

С помощью Microsoft Graph можно разрешать веб-приложениям и мобильным приложениям считывать и изменять книги Excel, хранящиеся в OneDrive для бизнеса, на сайте SharePoint или диске группы. Ресурс Workbook (или файл Excel) содержит все остальные ресурсы Excel благодаря отношениям. Можно получить доступ к книге через интерфейс API Drive, указав расположение файла в URL-адресе. Например:

Вы можете получить доступ к набору объектов Excel (например, Table, Range или Chart) с помощью стандартных REST API, чтобы выполнять с книгой операции CRUD (создание, чтение, обновление и удаление). Например, GET https://graph.microsoft.com/v1.0/me/drive/items//workbook/worksheets
возвращает коллекцию объектов листа, включенных в книгу.

REST API Excel поддерживает только книги в формате Office Open XML. Книги .xls расширений не поддерживаются.

Примечание. Поддержка книг, хранящихся в обычном OneDrive, по-прежнему недоступна. В настоящее время rest API Excel поддерживают только файлы, хранящиеся на бизнес-платформе.

Авторизация и области

Вы можете использовать платформа удостоверений Майкрософт для проверки подлинности API Excel. Для всех API требуется заголовок HTTP Authorization: Bearer .

Чтобы использовать ресурс Excel, требуется одно из следующих разрешений:

Files.Read (для чтения)
Files.ReadWrite (для чтения и записи)

Сеансы и сохраняемость

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

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

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

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

Вызов API для получения сеанса

Запрос

Передайте объект JSON, установив для параметра persistchanges значение true или false .

POST https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN/workbook/createSession content-type: Application/Json authorization: Bearer

Если для параметра задано persistChanges значение false , возвращается идентификатор сеанса, не относящееся к методу .

Отклик

HTTP code: 201 Created content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.sessionInfo", "id": "", "persistChanges": true >

Применение

Идентификатор сеанса, возвращенный из предыдущего вызова, передается в качестве заголовка при последующих запросах API в
заголовке HTTP workbook-session-id .

GET https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN/workbook/worksheets authorization: Bearer workbook-session-id:

Примечание. Если срок действия идентификатора сеанса истек, для сеанса будет возвращен код ошибки HTTP 404 . В таком случае вы можете создать другой сеанс и продолжить работу. Можно использовать другой подход — периодически обновлять сеанс, чтобы он не был завершен. Обычно срок действия сохраняемого сеанса истекает через 5 минут бездействия. Срок действия несохраняемого сеанса истекает через 7 минут бездействия.

Стандартные сценарии Excel

В этом разделе приводятся примеры использования стандартных операций для объектов Excel.

Операции с листами

Список листов, являющихся частью книги

GET https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN/workbook/worksheets accept: Application/Json authorization: Bearer workbook-session-id:

HTTP code: 200 OK content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN')/workbook/worksheets", "value": [ < "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN')/workbook/worksheets(%27%7B00000000-0001-0000-0000-000000000000%7D%27)", "id": "", "name": "Sheet1", "position": 0, "visibility": "Visible" >, < "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN')/workbook/worksheets(%27%7B00000000-0001-0000-0100-000000000000%7D%27)", "id": "", "name": "Sheet57664", "position": 1, "visibility": "Visible" > ] >

Добавление листа

POST //me/drive/root:/workbook/worksheets content-type: Application/Json authorization: Bearer workbook-session-id:

HTTP code: 201 Created content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com//$metadata#users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/root/$entity", "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN')/workbook/worksheets(%27%7B75A18F35-34AA-4F44-97CC-FDC3C05D9F40%7D%27)", "id": "", "name": "Sheet32243", "position": 5, "visibility": "Visible" >

Получение нового листа

Получение листа по его имени.

GET https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN/workbook/worksheets/Sheet32243 content-type: Application/Json authorization: Bearer workbook-session-id:

HTTP code: 200 OK content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN')/workbook/worksheets/$entity", "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN')/workbook/worksheets(%27%7B75A18F35-34AA-4F44-97CC-FDC3C05D9F40%7D%27)", "id": "", "name": "Sheet32243", "position": 5, "visibility": "Visible" >

** Примечание. Листы также можно получить с помощью идентификатора. Однако в настоящее время идентификатор содержит символы < и ">«, которые должны быть закодированы в URL-адресе, чтобы API работал. Пример. Чтобы получить лист с идентификатором , URL-адрес закодирует идентификатор в пути как /workbook/worksheets/%7B75A18F35-34AA-4F44-97CC-FDC3C05D9F40%7D .

Удаление листа

DELETE https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN/workbook/worksheets('%7B75A18F35-34AA-4F44-97CC-FDC3C05D9F40%7D') content-type: Application/Json authorization: Bearer workbook-session-id:

HTTP code: 204 No Content

Обновление свойств листа

PATCH https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN/workbook/worksheets/SheetA content-type: Application/Json accept: application/Json authorization: Bearer workbook-session-id:

HTTP code: 200 OK content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN')/workbook/worksheets/$entity", "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN')/workbook/worksheets(%27%7B00000000-0001-0000-0100-000000000000%7D%27)", "id": "", "name": "SheetA", "position": 3, "visibility": "Visible" >

Операции с диаграммами

Список диаграмм, являющихся частью листа

GET https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJB6K563VVUU2ZC2FJBAHLSZZQXL/workbook/worksheets('%7B00000000-0001-0000-0000-000000000000%7D')/charts accept: Application/Json authorization: Bearer workbook-session-id:

HTTP code: 200 OK content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJB6K563VVUU2ZC2FJBAHLSZZQXL')/workbook/worksheets('%7B00000000-0001-0000-0000-000000000000%7D')/charts", "value": [ < "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJB6K563VVUU2ZC2FJBAHLSZZQXL')/workbook/worksheets(%27%7B00000000-0001-0000-0000-000000000000%7D%27)/charts(%27%7B00000000-0008-0000-0100-000003000000%7D%27)", "height": 235.5, "id": "", "left": 276.0, "name": "Chart 2", "top": 0.0, "width": 401.25 > ] >

** Примечание. Идентификатор диаграммы содержит символы < и >(например, ), которые должны быть закодированы в URL-адресе, чтобы API работал. Пример. Чтобы получить объект диаграммы, URL-адрес закодирует идентификатор в пути как /charts/%7B00000000-0008-0000-0100-000003000000%7D .

Получение изображения диаграммы

GET https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJB6K563VVUU2ZC2FJBAHLSZZQXL/workbook/worksheets('%7B00000000-0001-0000-0000-000000000000%7D')/charts('%7B00000000-0008-0000-0100-000003000000%7D')/Image(width=0,height=0,fittingMode='fit') authorization: Bearer workbook-session-id:

HTTP code: 200 OK content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Edm.String", "value": "" >

Добавление диаграммы

POST https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJB6K563VVUU2ZC2FJBAHLSZZQXL/workbook/worksheets(‘%7B00000000-0001-0000-0000-000000000000%7D’)/charts/Add content-type: Application/Json accept: application/Json authorization: Bearer

HTTP code: 201 Created content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#chart", "@odata.type": "#microsoft.graph.workbookChart", "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJB6K563VVUU2ZC2FJBAHLSZZQXL')/workbook/worksheets(%27%7B00000000-0001-0000-0000-000000000000%7D%27)/charts(%27%7B2D421098-FA19-41F7-8528-EE7B00E4BB42%7D%27)", "height": 216.0, "id": "", "left": 0.0, "name": "Chart 2", "top": 0.0, "width": 360.0 >

Обновление диаграммы

PATCH https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJB6K563VVUU2ZC2FJBAHLSZZQXL/workbook/worksheets(‘%7B00000000-0001-0000-0000-000000000000%7D’)/charts(‘%7B2D421098-FA19-41F7-8528-EE7B00E4BB42%7D’) content-type: Application/Json authorization: Bearer workbook-session-id:

HTTP code: 200 OK content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJB6K563VVUU2ZC2FJBAHLSZZQXL')/workbook/worksheets('%7B00000000-0001-0000-0000-000000000000%7D')/charts/$entity", "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJB6K563VVUU2ZC2FJBAHLSZZQXL')/workbook/worksheets(%27%7B00000000-0001-0000-0000-000000000000%7D%27)/charts(%27%7B2D421098-FA19-41F7-8528-EE7B00E4BB42%7D%27)", "height": 216.0, "id": "", "left": 0.0, "name": "NewName", "top": 0.0, "width": 360.0 >

Обновление исходных данных диаграммы

POST https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJB6K563VVUU2ZC2FJBAHLSZZQXL/workbook/worksheets(‘%7B00000000-0001-0000-0000-000000000000%7D’)/charts(‘%7B2D421098-FA19-41F7-8528-EE7B00E4BB42%7D’)/setData content-type: Application/Json accept: application/Json authorization: Bearer workbook-session-id:

HTTP code: 204 No Content

Операции с таблицей

Получение списка таблиц

GET https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJB6K563VVUU2ZC2FJBAHLSZZQXL/workbook/worksheets('%7B00000000-0001-0000-0000-000000000000%7D')/tables accept: Application/Json authorization: Bearer workbook-session-id:

HTTP code: 200 OK content-type: application/json;odata.metadata

Создание таблицы

POST https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4/workbook/tables//add content-type: Application/Json authorization: Bearer workbook-session-id:

HTTP code: 201 Created content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables/$entity", "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables(%272%27)", "id": "2", "name": "NewTableName", "showHeaders": true, "showTotals": false, "style": "TableStyleMedium4" >

Обновление таблицы

PATCH https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4/workbook/tables(‘2’) content-type: Application/Json authorization: Bearer workbook-session-id:

HTTP code: 200 OK content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables/$entity", "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables(%272%27)", "id": "2", "name": "NewTableName", "showHeaders": true, "showTotals": false, "style": "TableStyleMedium4" >

Получение списка строк таблицы

GET https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4/workbook/tables('4')/rows authorization: Bearer workbook-session-id:

HTTP code: 200 OK content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables('4')/rows", "value": [ < "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables(%274%27)/rows/itemAt(0)", "index": 0, "values": [ [ 42019, 53, 34 ] ] >, < "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables(%274%27)/rows/itemAt(1)", "index": 1, "values": [ [ 42020, 45, 39 ] ] >, < "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables(%274%27)/rows/itemAt(2)", "index": 2, "values": [ [ 42021, 50, 31 ] ] >, < "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables(%274%27)/rows/itemAt(3)", "index": 3, "values": [ [ 42022, 43, 39 ] ] >, < "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables(%274%27)/rows/itemAt(4)", "index": 4, "values": [ [ 42023, 45, 41 ] ] >, < "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables(%274%27)/rows/itemAt(5)", "index": 5, "values": [ [ 42024, 52, 40 ] ] >] >

Получение списка столбцов таблицы

GET https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4/workbook/tables('4')/columns authorization: Bearer workbook-session-id:

HTTP code: 200 OK content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables('4')/columns", "value": [ < "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables(%274%27)/columns(%271%27)", "id": "1", "index": 0, "name": "Date", "values": [ [ "Date" ], [ 42019 ], [ 42020 ], [ 42021 ], [ 42022 ], [ 42023 ], [ 42024 ] ] >, < "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables(%274%27)/columns(%272%27)", "id": "2", "index": 1, "name": "High (F)", "values": [ [ "High (F)" ], [ 53 ], [ 45 ], [ 50 ], [ 43 ], [ 45 ], [ 52 ] ] >, < "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables(%274%27)/columns(%273%27)", "id": "3", "index": 2, "name": "Low (F)", "values": [ [ "Low (F)" ], [ 34 ], [ 39 ], [ 31 ], [ 39 ], [ 41 ], [ 40 ] ] >] >

Добавление строки таблицы

POST https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4/workbook/tables(‘4’)/rows content-type: Application/Json authorization: Bearer workbook-session-id:

HTTP code: 201 Created content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables('4')/rows/$entity", "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables(%274%27)/rows(null)", "index": 6, "values": [ [ "Jan-15-2016", 49, 37 ] ] >

Добавление столбца таблицы

POST https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4/workbook/tables('2')/columns content-type: Application/Json accept: application/Json

HTTP code: 201 Created content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables('2')/columns/$entity", "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/tables(%272%27)/columns(%274%27)", "id": "4", "index": 2, "name": "Status", "values": [ [ "Status" ], [ "Open" ], [ "Closed" ] ] >

Удаление строки таблицы

DELETE https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4/workbook/tables('4')/rows/$/itemAt(index=6) authorization: Bearer workbook-session-id:

HTTP code: 204 No Content

Удаление столбца таблицы

DELETE https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4/workbook/tables('4')/columns('3') authorization: Bearer workbook-session-id:

HTTP code: 204 No Content

Преобразование таблицы в диапазон

POST https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4/workbook/tables('1')/convertToRange authorization: Bearer workbook-session-id:

HTTP code: 200 OK content-type: application/json;odata.metadata

Сортировка таблицы

POST https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN/workbook/worksheets('Sheet15799')/tables('table2')/sort/apply authorization: Bearer workbook-session-id:  < "fields" : [ < "key": 0, "ascending": true >] >

HTTP code: 204 No Content

Фильтрация таблицы

POST https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN/workbook/worksheets('Sheet15799')/tables('table2')/columns(id='2')/filter/apply authorization: Bearer workbook-session-id: < "criteria" : < "filterOn": "custom", "criterion1": ">15", "operator": "and", "criterion2": " >

HTTP code: 204 No Content

Очистка фильтра

POST https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN/workbook/worksheets('Sheet15799')/tables('table2')/columns(id='2')/filter/clear authorization: Bearer workbook-session-id:

HTTP code: 204 No Content

Операции с диапазоном

Получение диапазона

GET https://graph.microsoft.com/v1.0/me/drive/items//workbook/worksheets//range(address='A1:B2') authorization: Bearer workbook-session-id:

HTTP code: 200 OK content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#range", "@odata.type": "#microsoft.graph.workbookRange", "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/worksheets(%27%7B00000000-0001-0000-0300-000000000000%7D%27)/range(address=%27A1:B2%27)", "address": "test!A1:B2", "addressLocal": "test!A1:B2", "cellCount": 4, "columnCount": 2, "columnHidden": false, "columnIndex": 0, "formulas": [ [ "", "" ], [ "", "" ] ], "formulasLocal": [ [ "", "" ], [ "", "" ] ], "formulasR1C1": [ [ "", "" ], [ "", "" ] ], "hidden": false, "numberFormat": [ [ "General", "General" ], [ "General", "General" ] ], "rowCount": 2, "rowHidden": false, "rowIndex": 0, "text": [ [ "", "" ], [ "", "" ] ], "values": [ [ "", "" ], [ "", "" ] ], "valueTypes": [ [ "Empty", "Empty" ], [ "Empty", "Empty" ] ] >

Обновление диапазона

PATCH https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4/workbook/worksheets(‘test’)/range(address=’test!A1:B2′) authorization: Bearer workbook-session-id:

HTTP code: 200 OK content-type: application/json;odata.metadata < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#range", "@odata.type": "#microsoft.graph.workbookRange", "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/worksheets(%27%7B00000000-0001-0000-0300-000000000000%7D%27)/range(address=%27test!A1:B2%27)", "address": "test!A1:B2", "addressLocal": "test!A1:B2", "cellCount": 4, "columnCount": 2, "columnHidden": false, "columnIndex": 0, "formulas": [ [ "Test", "Value" ], [ "For", "Update" ] ], "formulasLocal": [ [ "Test", "Value" ], [ "For", "Update" ] ], "formulasR1C1": [ [ "Test", "Value" ], [ "For", "Update" ] ], "hidden": false, "numberFormat": [ [ "General", "General" ], [ "General", "General" ] ], "rowCount": 2, "rowHidden": false, "rowIndex": 0, "text": [ [ "Test", "Value" ], [ "For", "Update" ] ], "values": [ [ "Test", "Value" ], [ "For", "Update" ] ], "valueTypes": [ [ "String", "String" ], [ "String", "String" ] ] >

Сортировка диапазона

POST https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN/workbook/worksheets('Sheet15799')/usedRange/sort/apply authorization: Bearer workbook-session-id:  < "fields" : [ < "key": 0, "ascending": true >] >

HTTP code: 204 No Content

Именованные элементы

GET https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4/workbook/names authorization: Bearer workbook-session-id:

HTTP code: 200 OK content-type: application/json < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/names", "value": [ < "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/names(%27data%27)", "name": "data", "type": "Range", "value": "Range!$A$1:$D$3", "visible": true >, < "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/names(%27myrange%27)", "name": "myrange", "type": "Range", "value": "Range!$E$1:$F$7", "visible": true >, < "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJDYBLIGAE7G5FE3I4VO2XP7BLU4')/workbook/names(%27range1%27)", "name": "range1", "type": "Range", "value": "Range!$I$1:$M$11", "visible": true >] >

Работа со значениями null

Входное значение null в двумерном массиве

Входное значение null в двумерном массиве (для значений, числового формата, формулы) игнорируется в ресурсах Range и Table. Обновление предполагаемого целевого объекта (ячейки) не выполняется, когда null входные данные отправляются в виде значений или в числовом формате или сетке значений формул.

Например, чтобы обновить только определенные части Range, такие как числовой формат ячейки, и сохранить существующий числовой формат в других частях Range, установите числовой формат там, где это необходимо, и отправьте null для других ячеек.

В приведенном ниже запросе задаются только некоторые значения числового формата Range, в то время как в остальных случаях сохраняется имеющийся числовой формат (передаются значения null).

Входное значение null для свойства

null не является допустимым одним входным значением для всего свойства. Например, следующее недопустимо, так как для всех значений нельзя задать значение NULL или игнорироваться.

Здесь значение не допустимо, так как значение NULL не является допустимым значением цвета.

Отклик — null

Представление свойств форматирования, состоящее из неоднородных значений, приведет к возврату значения null в отклике.

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

Значение null также возвращается в отклике в указанных ниже случаях.

Если при попытке получить определенное свойство объекта возникает ошибка, и для такого свойства можно задать значение null, свойство может возвращать в отклике значение null.
Для объекта Range при получении диапазона для целой строки или целого столбца некоторые свойства могут возвращать значение null в качестве отклика. Если размер диапазона превышает верхнее ограничение (5M ячеек), некоторые свойства возвращают значение NULL в качестве значения.

Пустые входные и выходные данные

Пустые значения в запросах на обновление считаются указанием на очистку или сброс соответствующего свойства. Пустое значение представляется двумя двойными кавычками, не разделенными пробелом: «»

Для values значение диапазона очищено. Это аналогично очистке содержимого в приложении.
Для numberFormat числовому формату присвоено значение General .
Для formula и formulaLocale значения формулы очищены.

При операциях чтения будьте готовы получать пустые значения, если в ячейках нет содержимого. Если ячейка не содержит данных или значений, API возвращает пустое значение. Пустое значение представляется двумя двойными кавычками, не разделенными пробелом: «»

Range без ограничений

Чтение

Адрес Range без ограничений содержит только идентификаторы столбцов и строк, а также идентификаторы неопределенных строк и столбцов (соответственно). Пример:

C:C , A:F , A:XFD (содержит неопределенные строки).
2:2 , 1:4 , 1:1048546 (содержит неопределенные столбцы).

Когда API запрашивает Range без ограничений ( getRange(‘C:C’) ), отклик содержит значение null для свойств на уровне ячеек, например values , text , numberFormat или formula . Другие свойства Range, например address или cellCount , отражают неограниченный диапазон.

Запись

Задание свойств уровня ячеек (например, значений, numberFormat и т. д.) для Range без ограничений не допускается, так как запрос на ввод может оказаться слишком большим для обработки.

Например, следующий запрос на обновление не является допустимым, так как запрошенный диапазон не связан.

PATCH /me/drive/root/workbook/worksheets//range(address="A:B")

При попытке выполнить операцию обновления для такого диапазона API возвращает ошибку.

Большой диапазон

Большой диапазон — это объект Range, размер которого слишком велик для одного вызова API. Множество факторов, например количество ячеек, значений, объектов numberFormat и формул, могут сделать запрос настолько большим, что он станет неподходящим для взаимодействия с API. Интерфейс API делает все возможное для возврата запрашиваемых данных или записи в них. Но обработка крупного запроса может привести к ошибке API из-за чрезмерного использования ресурсов.

Чтобы избежать этого, рекомендуем выполнять операции чтения и записи для нескольких объектов Range меньшего размера.

Копирование одного входного значения

Для поддержки обновления диапазона с использованием одинаковых значений или числового формата либо для применения одной и той же формулы ко всему диапазону в установленном интерфейсе API используется следующее соглашение. В Excel этот принцип аналогичен вводу значений или формул в диапазон в режиме CTRL+ВВОД.

API ищет значение одной ячейки и, если измерение целевого диапазона не соответствует измерению диапазона входных данных, он применяет обновление ко всему диапазону в модели CTRL+ВВОД со значением или формулой, указанными в запросе.

Примеры

Следующий запрос добавляет в выбранный диапазон текст «Sample text». Диапазон содержит 200 ячеек, в то время как предоставленные входные данные имеют только одно значение ячейки.

PATCH /me/drive/root/workbook/worksheets//range(address="A1:B100")

Функции книги

Можно получить доступ к функциям книги через коллекцию функций, включенных в ресурс /Functions.

Запрос

https://graph.microsoft.com/v1.0/me/drive/root:/book1.xlsx:/workbook/functions/pmt content-type: Application/Json authorization: Bearer workbook-session-id:

Отклик

HTTP code: 200 OK content-type: application/json < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#workbookFunctionResult", "@odata.type": "#microsoft.graph.workbookFunctionResult", "@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/root/workbook/functions/pmt()", "error": null, "value": 5625.00000734125 >

Сведения об ошибках

Ошибки возвращаются с HTTP-кодом и объектом ошибки. Ошибки code и message объясняют причины возникновения ошибки.

Ниже приведен пример.

HTTP/1.1 400 Bad Request Content-Type: application/json < "error": < "code": "ItemAlreadyExists", "message": "A resource with the same name or identifier already exists.", "innerError": < "request-id": "214ca7ea-9ea4-442e-9c67-71fdda0a559c", "date": "2016-07-28T03:56:09" >> >

Что нового

Узнайте о новых функциях и обновлениях для этого набора API.

Chart: Image

Отрисовывает диаграмму в виде изображения с кодировкой base64, масштабируя ее в соответствии с указанным размером.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	❌

Разрешения

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

Тип разрешения	Разрешения с наименьшими привилегиями	Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись)	Files.ReadWrite	Недоступно.
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.	Не поддерживается.
Для приложений	Не поддерживается.	Не поддерживается.

HTTP-запрос

GET /me/drive/items//workbook/worksheets//charts//image GET /me/drive/root:/:/workbook/worksheets//charts//image GET /me/drive/items//workbook/worksheets//charts//image(width=640) GET /me/drive/root:/:/workbook/worksheets//charts//image(width=640) GET /me/drive/items//workbook/worksheets//charts//image(width=640,height=480) GET /me/drive/root:/:/workbook/worksheets//charts//image(width=640,height=480) GET /me/drive/items//workbook/worksheets//charts//image(width=640,height=480,fittingMode='fit') GET /me/drive/root:/:/workbook/worksheets//charts//image(width=640,height=480,fittingMode='fit')

Заголовки запросов

Имя	Описание
Авторизация	Bearer . Обязательно.
Workbook-Session-Id	Идентификатор сеанса работы с книгой, определяющий, сохраняются ли изменения. Необязательный параметр.

Параметры пути

В тексте запроса предоставьте JSON-объект с указанными ниже параметрами.

Параметр	Тип	Описание
height	Int32	Нужная высота создаваемого изображения. Необязательный параметр.
ширина	Int32	Нужная ширина создаваемого изображения. Необязательный параметр.
fittingMode	string	Метод, используемый для масштабирования диаграммы до заданных измерений (если заданы высота и ширина).» Возможные значения: Fit , FitAndCenter , Fill .

Отклик

В случае успеха этот метод возвращает код отклика 200 OK и строку изображения с кодировкой base-64 в тексте отклика.

Пример

Ниже приведен пример вызова этого API.

Запрос

Ниже приведен пример запроса.

GET https://graph.microsoft.com/v1.0/me/drive/items//workbook/worksheets//charts//image(width=640,height=480,fittingMode='fit')

 // Code snippets are only available for the latest version. Current version is 5.x // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp var result = await graphClient.Drives[""].Items[""].Workbook.Worksheets[""].Charts[""].ImageWithWidthWithHeightWithFittingMode("",1,1).GetAsync();

 // THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY mgc drives items workbook worksheets charts image-with-width-with-height-with-fitting-mode get --width --height --fitting-mode --drive-id --drive-item-id --workbook-worksheet-id --workbook-chart-id

 import ( "context" msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" //other-imports ) graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) width := int32(1) height := int32(1) fittingMode := "" image, err := graphClient.Drives().ByDriveId("drive-id").Items().ByDriveItemId("driveItem-id").Workbook().Worksheets().ByWorkbookWorksheetId("workbookWorksheet-id").Charts().ByWorkbookChartId("workbookChart-id").ImageWithWidthWithHeightWithFittingMode(&width, &height, &fittingMode).Get(context.Background(), nil)

 GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient(); String string = graphClient.me().drive().items("").workbook().worksheets("").charts("") .image(WorkbookChartImageParameterSet .newBuilder() .withWidth(640) .withHeight(480) .withFittingMode("fit") .build()) .buildRequest() .get();

 const options = < authProvider, >; const client = Client.init(options); let string = await client.api('/me/drive/items//workbook/worksheets//charts//image(width=640,height=480,fittingMode='fit')') .get();

 drives()->byDriveId('drive-id')->items()->byDriveItemId('driveItem-id')->workbook()->worksheets()->byWorkbookWorksheetId('workbookWorksheet-id')->charts()->byWorkbookChartId('workbookChart-id')->imageWithWidthWithHeightWithFittingMode('', 1,1)->get()->wait();

 # THE PYTHON SDK IS IN PREVIEW. FOR NON-PRODUCTION USE ONLY graph_client = GraphServiceClient(credentials, scopes) result = await graph_client.drives.by_drive_id('drive-id').items.by_drive_item_id('driveItem-id').workbook.worksheets.by_workbook_worksheet_id('workbookWorksheet-id').charts.by_workbook_chart_id('workbookChart-id').image_with_width_with_height_with_fitting_mode("",1,1).get()

Отклик

Ниже приведен пример отклика. Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK Content-type: application/json;odata.metadata=minimal;odata.streaming=true

Применение

Снимок экрана: круговая диаграмма, отображаемая с помощью параметров по умолчанию и режима подгонки, заданного для соответствия.

Если вы хотите настроить отображение этого изображения, укажите высоту, ширину и режим подгонки. А вот как выглядит то же самое изображение диаграммы, если получить его с этими параметрами: Image(width=500,height=500,fittingMode=’Fill’) .

Диаграмма microsoft graph как открыть