Структура базового URI и путь
В разделе рассказывается, как создавать структуру URI и путь для команд службы REST в службах Excel.
Примечание.
REST API служб Excel применим к локальным развертываниям SharePoint и SharePoint 2016. Для учетных записей Office 365 для образования, Office 365 бизнес и Office 365 корпоративный используйте REST API Excel, входящие в состав конечной точки Microsoft Graph.
Базовая структура и путь URI
API-Интерфейс REST в Службы Excel дает возможность получить доступ к ресурсам как диаграммы, сводные таблицы, таблиц и именованных диапазонов в книге непосредственно через URL-адрес. Каждый URL-адрес REST в Службы Excel построения из трех частей. Ниже представлена базовая структура URL-адреса для доступа к ресурсам в книге:
- REST aspx URI страницы Точка входа в страницу ASPX
- Расположение книги Путь к книге
- Расположение ресурсов Путь к запрошенному ресурсу внутри книги
Ниже приведен пример URL-адреса REST конкретного элемента в книге:
http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>/<ResourceLocation>
Ниже приведен пример вид URL-адреса REST в Службы Excel все три части в сочетании. В этом примере URL-адреса REST обращается к книги с названием «sampleWorkbook.xlsx», который содержит диаграммы, называется «SampleChart»:
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('SampleChart')
Книга хранится в библиотеке документов. Полный путь к книге — http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx.
Три части URL-адрес REST следующие:
- URI страницы REST aspx:
http://<имя_>сервера/_vti_bin/ExcelRest.aspx - Расположение книги:
/Docs/Documents/sampleWorkbook.xlsx - Расположение ресурса:
/model/Ranges('nameOfTheNamedRange')
Доступ с использованием пользовательского интерфейса обнаружения
Можно также получить доступ к диаграмме с помощью пользовательского интерфейса обнаружения. Сведения о доступе к ресурсам, таким как диаграммы, таблицы, сводные таблицы и диапазоны, с помощью механизма обнаружения, показанного на следующем снимке экрана, см. в статье Обнаружение в службы Excel REST API.
Путь маркера
Ниже приведен на aspx-странице для службы REST в Службы Excel:
http://<ServerName>/_vti_bin/ExcelRest.aspx
Чтобы получить доступ к службе REST в службы Excel, необходимо указать в url-адресе имяhttp://<_>/_vti_bin/ExcelRest.aspxсервера.
Расположение книги
Расположение книги это относительный путь к книге, которая содержит ресурсы, которые нуждаются в доступе к. Например предположим, что у вас есть книгу с именем sampleWorkbook.xlsx, сохраненный на надежной библиотеки документов SharePoint. В этом примере следующие это путь к папке sampleWorkbook.xlsx:
http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx
Выполните относительный путь к книге ( Docs/Documents/sampleWorkbook.xlsx) и добавьте к пути маркер. Ниже приведен URL-адрес с добавленным расположением книгу и путь маркер.
http://<ServerName>/_vti_bin/ExcelRest.aspx
Расположение ресурсов
Расположение ресурсов это путь внутри книги в элемент при запросе. Например, если вы хотите получить диаграмму, расположение ресурса будет таким же, как /model/Charts('Chart 1').
Полный URL-адрес добавьте это маркер путь и относительный путь к книге. Ниже приведен полный пример URL-адреса:
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('Chart 1')