Mapa de desenvolvimento dos serviços do Excel

2023-03-21

An important aspect of Excel Services is that solution developers can use its power programmatically from their applications. These applications can be line-of-business (LOB) products or custom enterprise solutions that an organization develops internally.

Os seguintes são exemplos desses aplicativos:

Aplicativos com vários níveis, com a camada de apresentação implementada como um aplicativo Web (por exemplo, um aplicativo do ASP.NET) que chama os Serviços Web do Excel.
Aplicativos no Microsoft SharePoint Server 2010 ou integrados a produtos de LOB.

Há cinco tipos de desenvolvimento possíveis usando os Serviços do Excel:

Desenvolver soluções usando os Serviços Web do Excel
Estender a biblioteca de funções do Microsoft Excel nos Serviços do Excel usando as funções definidas pelo usuário (UDFs)
Personalizar a Web Part do Excel Web Access
Desenvolver soluções usando ECMAScript (JavaScript, JScript)
Usar a API REST para realizar operações em pastas de trabalho do Excel

Excel Web Service

A seguir estão as principais situações para Serviços Web do Excel:

Cálculo do Excel do lado do servidor

This scenario is application-centric. In this scenario, you use models defined in Excel workbooks and calculated on the server as part of application logic.
Como automatizar as atualizações da pasta de trabalho no servidor

This scenario is file-centric. In this scenario, Excel Web Services processes a workbook, and saves copies of the workbook or snapshots.
Como abrir pastas de trabalho em sessões de edição

Excel Web Services supports opening workbooks in edit sessions in SharePoint Server 2010. In this scenario, you can use code to edit a workbook.

Cálculo do Excel do lado do servidor

For server-side Excel calculation, a custom application typically uses an Excel model as part of its logic. Instead of having to re-code Excel workbook business logic in a programming language, the business user can maintain the model in Excel in a server location. The developer never needs to change a line of code in the application that uses the model created by the business user.

In this scenario, the custom application repeatedly calls Excel Web Services, which sends the calls to a back-end calculation service. Excel Calculation Services does the following:

Carregam a pasta de trabalho especificada do Excel
Recebem entradas
Processam a pasta de trabalho (por exemplo, atualizam dados ou realizam cálculos)
Enviam os resultados para o aplicativo personalizado

Como automatizar as atualizações da pasta de trabalho no servidor

Quando os desenvolvedores automatizam a atualização das pastas de trabalho do Excel no servidor, elas geralmente têm dois objetivos:

Gerar arquivos do Excel ou modificar os modelos do Excel usando os Formatos de Arquivo Open XML e calcular o arquivo do Excel gerado.
Abrem periodicamente um arquivo do Excel para atualizar dados externos (uma ou, talvez, várias vezes por usuário) e calculam as pastas de trabalho resultantes e salvam ou enviam elas em mensagens de e-mail para vários usuários.

Nesse cenário, um aplicativo personalizado usa os Serviços Web do Excel para fazer o seguinte:

Carregar a pasta de trabalho especificada do Excel
Inserir parâmetros
Processar a pasta de trabalho (por exemplo, atualizar dados ou realizar cálculos)

O aplicativo personalizado recupera a versão ao vivo da pasta de trabalho ou do instantâneo e salva a pasta de trabalho ou o instantâneo usando os Serviços Web do Excel.

Observação

[!OBSERVAçãO] When you make changes to a workbookfor example, by setting values to a range by using Excel Web Servicesthe changes to the workbook are preserved only for that particular session. The changes are not saved or persisted back to the original workbook. Quando a sessão de pasta de trabalho atual termina (por exemplo, quando você chama o método CloseWorkbook ou quando a sessão acaba), as alterações feitas são perdidas.> Se quiser salvar as alterações feitas em uma pasta de trabalho, use o método GetWorkbook e salve a pasta de trabalho usando o método SaveWorkbook ou o método SaveWorkbookCopy . For more information about the Excel Web Services API, see Microsoft.Office.Excel.Server.WebServices .

Como usar os Serviços Web do Excel

Você pode usar os Serviços Web do Excel como:

Um serviço Web regular, chamando os métodos Web pelo SOAP sobre HTTP.
Um assembly local, vinculando diretamente a Microsoft.Office.Excel.Server.Webservices.dll.

Para obter mais informações sobre quando você deve se vincular diretamente ao Microsoft.Office.Excel.Server.Webservices.dll, consulte Chamadas soap de loop-back e vinculação direta.

Para obter informações sobre a API dos Serviços Web do Excel, consulte a documentação de referência do namespace Microsoft.Office.Excel.Server.Webservices . For an example of how to develop a custom application by using Excel Web Services, see Passo a passo: Desenvolvendo um aplicativo personalizado usando Web Services do Excel.

Funções definidas pelo usuário (UDFs)

Excel Services supports managed-code UDFs. Excel Services UDFs give you the ability to use formulas in cells to call custom functions written in managed code and deployed to SharePoint Server 2010. You can create UDFs to:

Call custom mathematical functions.
Obter dados de fontes de dados personalizadas para planilhas.
Chamar os serviços Web de UDFs.
Quebrar chamadas para funções da biblioteca de códigos nativos existente — por exemplo, UDFs existentes do Excel.

Para obter mais informações sobre Serviços do Excel UDFs, consulte Noções básicas Serviços do Excel UDFs.

Using UDFs

Para obter informações sobre Serviços do Excel definições de UDF, consulte a documentação de referência do namespace microsoft.Office.Excel.Server.Udf.

Para obter um exemplo de como criar UDFs de código gerenciado, consulte Passo a passo: Desenvolvendo um Managed-Code UDF.

Excel Web Access

Você pode usar as propriedades extensíveis da Web Part do Excel Web Access para:

Configurar o Excel Web Access de forma programática.
Alterar as propriedades do Excel Web Access de forma programática.
Aplicar um tema ou marcar uma página de Web Part usando folhas de estilos em cascata (CSS).

Como usar a extensibilidade da Web Part do Excel Web Access

Para obter informações sobre:

Confira as propriedades extensíveis do Excel Web Access na documentação de referência de namespace do Microsoft.Office.Excel.Server.WebUI.
CSS do Excel Web Access, confira a documentação de referência de CSS.
Confira como configurar uma Web Part de forma programática no SDK do SharePoint Foundation.

ECMAScript (JavaScript, JScript)

In SharePoint Server 2010, Excel Services added support for JavaScript. O modelo de objeto JavaScript no Serviços do Excel permite que os desenvolvedores automatizem, personalizem e interajam com o controle web part do Excel Access em uma página. Usando o modelo de objeto JavaScript, você pode criar mashups e outras soluções integradas que interagem com um ou mais controles web part do Excel Access em uma página. It also enables you to add more capabilities to your workbooks and code around them.

Para obter mais informações sobre o modelo de objeto JavaScript no Serviços do Excel, consulte a documentação de referência do namespace Ewa.

Using ECMAScript (JavaScript, JScript)

Confira mais informações sobre o JavaScript nos seguintes links:

Para obter mais informações sobre o modelo de objeto JavaScript no Serviços do Excel, consulte a documentação de referência do namespace Ewa.
Para obter um exemplo de como interagir com o modelo de objeto JavaScript no Serviços do Excel usando o Conteúdo Editor Web Part, consulte Passo a passo: Desenvolvendo usando o conteúdo Editor Web Part.

API do REST

The REST API in Excel Services is new in SharePoint Server 2010. By using the REST API, you can access workbook parts or elements directly through a URL.

The discovery mechanisms built into the Excel Services REST API also enable developers and users to explore the content of a workbook manually or programmatically, by supplying Atom feeds that contain information about the elements that reside in a specific workbook. The resources that you can access through the REST API are ranges, charts, tables, and PivotTables.

Using the Atom feed provided by the REST API enables an easier way to get to the data that you care about. The feed contains traversable elements that allow any piece of code to discover what elements exist in a workbook.

Para obter mais informações, consulte Serviços do Excel API REST.

Usar a API REST