Получение диапазонов с помощью канала Atom и HTML-фрагмента
В этом разделе описываются два способа доступа к диапазонов канала Atom и HTML-фрагмента, с помощью API-Интерфейс REST в Службы Excel.
Примечание.
REST API служб Excel применим к локальным развертываниям SharePoint и SharePoint 2016. Для учетных записей Office 365 для образования, Office 365 бизнес и Office 365 корпоративный используйте REST API Excel, входящие в состав конечной точки Microsoft Graph.
Доступ к диапазонов
API-Интерфейс REST в Службы Excel поддерживает два механизма получение диапазонов. Первый используется главным образом для включения приложений для ко необработанные данные книги, то есть, чисел или значениями, полученными из листа. Второй для получения фрагментов HTML из в браузере.
Как описано в разделе Обнаружение в службы Excel REST API, URL-адрес REST для страницы модели с помощью обнаружения:
http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>/model
Таким образом, для книги с именем файла sampleWorkbook.xlsx , сохраненной в http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx
, ниже приведен URI страницы модели:
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model
При использовании механизма обнаружения, описанного в разделе Обнаружение в службы Excel REST API, если щелкнуть веб-канал Ranges Atom на странице модели на сервере (http://
<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model
), отобразится страница со всеми именоваными диапазонами в книге. SampleWorkbook.xlsx содержит один именованный диапазон, SampleNamedRange, как показано на следующем снимке экрана:
Важно!
[!Важно!] Также можно указать произвольный диапазонов и не только диапазоны, возвращаемые обнаружения. Двоеточие «:» должен быть заменен «|». Использовать, например «A1 | G5» вместо «Запись a1: G5».
Примечание.
Знаки, такие как «?» и «#» не поддерживаются. Правильность ссылок на имена листов, которые содержат специальные символы, основная рекомендация «Просмотр клиента Excel» при обращении формулу для таблицы с помощью специальных символов и следуйте этого примера.
Обнаружение именованного диапазона REST служб Excel
Доступ к диапазонов с помощью Atom веб-канала
Если SampleNamedRange нажмите на странице обнаружения диапазона, который последовательно выберите пункты следующий URL-адрес:
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Ranges('SampleNamedRange')?$format=atom
Обратите внимание, что в Internet Explorer страница с результатами выглядит как ошибка, как показано на следующем снимке экрана.
Обнаружение диапазона REST служб Excel с использованием Atom
Internet Explorer не удается показать одной операции элемента веб-канала Atom. Однако просмотр источник страницы показан XML-код, что веб-канала активности элемента содержит:
<?xml version="1.0" encoding="utf-8"?>
<entry xmlns:x="http://schemas.microsoft.com/office/2008/07/excelservices/rest" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservice" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">
<title type="text">SampleNamedRange</title>
<id>http://ServerName/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Ranges('SampleNamedRange')</id>
<updated>2010-01-20T21:28:10Z</updated>
<author>
<name />
</author>
<link rel="self" href="http://ServerName/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Ranges('SampleNamedRange')?$format=atom" title="SampleNamedRange" />
<category term="ExcelServices.Range" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<content type="application/xml">
<x:range name="SampleNamedRange">
<x:row>
<x:c>
<x:fv>Performance</x:fv>
</x:c>
<x:c>
<x:v>26</x:v>
<x:fv>26</x:fv>
</x:c>
<x:c />
</x:row>
<x:row>
<x:c>
<x:fv>Employment</x:fv>
</x:c>
<x:c>
<x:v>42</x:v>
<x:fv>42</x:fv>
</x:c>
<x:c />
</x:row>
<x:row>
<x:c>
<x:fv>Earnings And Job Quality</x:fv>
</x:c>
<x:c>
<x:v>22</x:v>
<x:fv>22</x:fv>
</x:c>
<x:c />
</x:row>
... XML truncated for brevity.
<x:row>
<x:c>
<x:fv>Innovation Assets</x:fv>
</x:c>
<x:c>
<x:v>43</x:v>
<x:fv>43</x:fv>
</x:c>
<x:c />
</x:row>
<x:row>
<x:c />
<x:c>
<x:fv>State</x:fv>
</x:c>
<x:c />
</x:row>
</x:range>
</content>
</entry>
Веб-канала активности элемент содержит XML, представляющий данные внутри диапазона. Ниже перечислены элементы XML интересов.
<range> — элемент range. Represents the container of the returned range.
<row> — элемент row. Represents each row in the range.
<c> Элемент cell. Represents each cell in a row.
<fv> — элемент отформатированного значения. Represents the value as it is formatted by Excel. Если значение имеет тип string в книге, то элемент форматирования value является единственным элементом в c<>.
<v> Элемент value. Represents a number value. If the value in the cell is a number instead of a string, the value element contains that information.
С помощью XML предоставляет простой способ получения данных из диапазона Excel, которые можно использовать в приложении.
Доступ к диапазонов с помощью HTML
Если вы посмотрите на URL-адрес для доступа к именованным диапазонам с помощью веб-канала Atom, обратите внимание, что заключительная часть URL-адреса содержит параметр с именем $format
, который имеет значение atom
. Этот параметр также может принимать значение html
. Если изменить значение на atom
html
, URL-адрес возвращает фрагмент HTML вместо веб-канала Atom. Ниже приведен пример URL-адреса:
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Ranges('SampleNamedRange')?$format=html
В Internet Explorer странице выглядит примерно на следующем рисунке.
Примечание.
[!Примечание] В этом HTML-код может использоваться непосредственно в IFRAMEили его можно использовать в JavaScript для более эффективной работы.