Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Este tópico discute os mecanismos de descoberta incorporados ao Serviços do Excel API REST.
Observação
A API REST de serviços do Excel aplica-se ao SharePoint e SharePoint 2016 no local. Para contas do Office 365 Education, Business e Enterprise, use as APIs REAST do Excel que fazem parte do ponto de extremidade do Microsoft Graph.
Exemplo de descoberta e a URL Base de descoberta
Descoberta habilita desenvolvedores e usuários para descobrir informações sobre e o conteúdo de uma pasta de trabalho manualmente ou programaticamente. O mecanismo de deteção fornece o feed Atom que contém informações sobre os recursos num livro. Usando a descoberta, você pode explorar e exibir os recursos na pasta de trabalho. Recursos que você pode explorar e acessar estão intervalos, gráficos, tabelas e tabelas dinâmicas.
A seguir é a construção do URL REST para um elemento específico em uma pasta de trabalho:
http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>/<ResourceLocation>
Conforme descrito no tópico Estrutura e Caminho do URI Básico , segue-se o URL REST para aceder a um livro com o nomesampleWorkbook.xlsx e ver o gráfico denominado SampleChart:
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('SampleChart')
Para iniciar e explore os recursos na pasta de trabalho e exibir os recursos usando a descoberta, vá para a página de modelo usando um URI que segue este exemplo:
http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>/model
Com o exemplo sampleWorkbook.xlsx, segue-se o URI:
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model
A seguir está uma captura de tela da página de modelo.
URL do modelo de REST de serviços do Excel
A URL para a página de modelo é onde você começar a descoberta. A página de modelo exibe quatro conjuntos de recursos que suporta atualmente o Serviços do Excel API REST. Os conjuntos de recursos são intervalos, gráficos, tabelas ou tabelas dinâmicas. Você pode explorar esses recursos em uma pasta de trabalho específica clicando em intervalos, gráficos, tabelas ou tabelas dinâmicas na página de modelo.
Por exemplo, para acessar o gráfico na pasta de trabalho usando a descoberta, faça o seguinte:
Na página do modelo, clique em gráficos. Clique no link de gráficos traz o feed Atom outro este feed resultante lista todos os gráficos que estão disponíveis na pasta de trabalho sampleWorkbook.xlsx. A pasta de trabalho sampleWorkbook.xlsx contém três gráficos denominados Chart 1, 3 de gráfico e SampleChart. Portanto, três nomes de gráfico são listados, conforme mostrado na captura de tela a seguir.
Lista de gráfico de descoberta do REST de serviços do Excel
Na página do modelo, clique em SampleChart. O gráfico chamado SampleChart que reside no sampleWorkbook.xlsx, conforme mostrado na captura de tela a seguir será exibida.
Exibição de gráfico usando REST
Da mesma forma, clicando em 1 de gráfico ou gráfico 3 exibe o gráfico com o nome correspondente. Clicar em SampleChart navega até a URL do gráfico real. A seguir é o URL da imagem SampleChart (como pode ser visto na captura de tela):
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('SampleChart%20')?$format=image
Feed Atom
Utilizar o feed Atom fornecido pela API REST dá-lhe uma forma mais fácil de aceder aos dados em que está interessado. Se vir a origem da página Web, obterá o XML. Um exemplo de gráficos na sampleWorkbook.xlsx é mostrado abaixo.
Como pode ser visto no XML, o feed contém elementos navegável que permitem o código para descobrir quais elementos existam na pasta de trabalho. Cada entrada Atom corresponde a um gráfico que pode ser acessado. Esse mecanismo mesmo se aplica a descobrir intervalos, tabelas e tabelas dinâmicas.
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<feed xmlns="http://www.w3.org/2005/Atom"
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">
<title type="text">Charts</title>
<id>http://ServerName/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts</id>
<updated>2010-01-19T19:32:53Z</updated>
<author>
<name />
</author>
<link rel="self" href="http://ServerName/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts?$format=atom" title="Charts" />
<entry>
<category term="ExcelServices.Chart" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<title>Chart 1</title>
<id>http://ServerName/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('Chart%201')</id>
<updated>2010-01-19T19:32:53Z</updated>
<author>
<name />
</author>
<link rel="alternate" title="Chart 1" href="http://ServerName/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('Chart%201')?$format=image" />
<content type="image/png" src="http://ServerName/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('Chart%201')?$format=image" />
</entry>
<entry>
<category term="ExcelServices.Chart" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<title>Chart 3</title>
<id>http://ServerName/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('Chart%203')</id>
<updated>2010-01-19T19:32:53Z</updated>
<author>
<name />
</author>
<link rel="alternate" title="Chart 3" href="http://ServerName/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('Chart%203')?$format=image" />
<content type="image/png" src="http://ServerName/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('Chart%203')?$format=image" />
</entry>
<entry>
<category term="ExcelServices.Chart" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<title>SampleChart </title>
<id>http://ServerName/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('SampleChart%20')</id>
<updated>2010-01-19T19:32:53Z</updated>
<author>
<name />
</author>
<link rel="alternate" title="SampleChart" href="http://ServerName/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('SampleChart%20')?$format=image" />
<content type="image/png" src="http://ServerName/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('SampleChart%20')?$format=image" />
</entry>
</feed>