Схема разработки решений, в которых используются службы Excel

Статья
03/21/2023

An important aspect of Службы Excel 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.

Примеры таких приложений:

многоуровневые приложения с уровнем представления, реализованным в виде веб-приложения (например, приложения ASP.NET), которое вызывает веб-службы Excel;
приложения на сервере Microsoft SharePoint Server 2010 или интегрированные с бизнес-продуктами.

Службы Excel можно использовать для следующих типов разработки:

разработка решений с помощью веб-служб Excel;
расширение библиотеки функций Microsoft Excel в службах Excel с помощью пользовательских функций (UDF);
настройка веб-части Excel Web Access;
разработка решений с помощью ECMAScript (JavaScript, JScript);
использование REST API для выполнения операций с книгами Excel.

Excel Web Service

Основные сценарии использования веб-служб Excel:

Серверные вычисления Excel

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.
Автоматизация обновлений книги на сервере

This scenario is file-centric. In this scenario, Веб-службы Excel processes a workbook, and saves copies of the workbook or snapshots.
Открытие книг в сеансах изменения

Веб-службы Excel supports opening workbooks in edit sessions in SharePoint Server 2010. In this scenario, you can use code to edit a workbook.

Серверные вычисления Excel

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, which sends the calls to a back-end calculation service. Службы вычислений Excel does the following:

загружают указанную книгу Excel;
получают входные данные;
обрабатывают книгу (например, обновляют данные или выполняют вычисления);
отправляют результаты в пользовательское приложение.

Автоматизация обновлений книги на сервере

Когда разработчики автоматизируют обновление книг Excel на сервере, перед ними обычно стоит две задачи:

создание файлов Excel или изменение шаблонов Excel с помощью форматов файлов Open XML и последующее вычисление созданного файла Excel;
периодическое открытие файла Excel для обновления внешних данных (один или несколько раз на каждого пользователя), вычисление созданных книг и их сохранение или отправка пользователям по электронной почте.

В этом сценарии пользовательское приложение использует веб-службы Excel для следующего:

загрузка указанной книги Excel;
ввод параметров;
обработка книги (например, обновление данных или выполнение вычислений).

Пользовательское приложение получает актуальную версию книги или снимка, а затем сохраняет книгу или снимок с помощью веб-служб Excel.

Примечание.

[!Примечание] When you make changes to a workbookfor example, by setting values to a range by using Веб-службы Excelthe changes to the workbook are preserved only for that particular session. The changes are not saved or persisted back to the original workbook. По завершении текущего сеанса книги (например, при вызове метода CloseWorkbook или при его окончании) внесенные изменения будут потеряны.> Если вы хотите сохранить изменения, внесенные в книгу, можно использовать метод GetWorkbook , а затем сохранить книгу с помощью метода SaveWorkbook или SaveWorkbookCopy . For more information about the Веб-службы Excel API, see Microsoft.Office.Excel.Server.WebServices .

Использование веб-служб Excel

Вы можете использовать веб-службы Excel как:

обычную веб-службу, вызывая веб-методы по протоколу SOAP через HTTP;
локальную сборку, используя прямую ссылку на файл Microsoft.Office.Excel.Server.Webservices.dll.

Дополнительные сведения о том, когда следует ссылаться непосредственно на Microsoft.Office.Excel.Server.Webservices.dll, см. в разделе Циклильные вызовы SOAP и прямая компоновка.

Сведения об API веб-служб Excel см. в справочной документации по пространству имен Microsoft.Office.Excel.Server.Webservices . For an example of how to develop a custom application by using Веб-службы Excel, see Пошаговое руководство. Разработка настраиваемого приложения с помощью веб-служб Excel.

Пользовательские функции (UDF)

Службы Excel supports managed-code UDFs. Службы Excel 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.
загрузки на листы данных из специальных источников;
вызова веб-служб из UDF;
включения вызовов в существующие функции библиотеки машинного кода, например в существующие UDF Excel.

Дополнительные сведения о службы Excel определяемых пользователем функций см. в статье Общие сведения об службы Excel определяемых пользователем функций.

Использование UDF

Сведения об определениях службы Excel UDF см. в справочной документации по пространству имен Microsoft.Office.Excel.Server.Udf.

Пример создания определяемых пользователем функций с управляемым кодом см. в статье Пошаговое руководство. Разработка Managed-Code определяемой пользователем функции.

Excel Web Access

Вы можете использовать расширяемые свойства веб-части Excel Web Access для:

программной настройки Excel Web Access;
программного изменения свойств Excel Web Access;
применения темы или фирменного стиля страницы веб-частей с помощью каскадных таблиц стилей (CSS).

Использование расширяемости веб-части Excel Web Access

Информацию о:

расширяемых свойствах Excel Web Access см. в справочной документации по пространству имен Microsoft.Office.Excel.Server.WebUI.
CSS Excel Web Access см. в справочной документации по CSS.
программной настройке веб-части см. в пакете SDK SharePoint Foundation.

ECMAScript (JavaScript, JScript)

In SharePoint Server 2010, Службы Excel added support for JavaScript. Объектная модель JavaScript в службы Excel позволяет разработчикам автоматизировать, настраивать и взаимодействовать с элементом управления веб-части Excel Web Access на странице. С помощью объектной модели JavaScript можно создавать гибридные приложения и другие интегрированные решения, которые взаимодействуют с одним или несколькими элементами управления веб-части Excel Web Access на странице. It also enables you to add more capabilities to your workbooks and code around them.

Дополнительные сведения об объектной модели JavaScript в службы Excel см. в справочной документации по пространству имен Ewa.

Использование ECMAScript (JavaScript, JScript)

Дополнительную информацию о JavaScript см. по следующим ссылкам:

Дополнительные сведения об объектной модели JavaScript в службы Excel см. в справочной документации по пространству имен Ewa.
Пример взаимодействия с объектной моделью JavaScript в службы Excel с помощью веб-части Редактор содержимого см. в разделе Пошаговое руководство. Разработка с помощью веб-части Редактор содержимого.

API REST

The REST API in Службы Excel 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 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.

Дополнительные сведения см. в разделе службы Excel REST API.

Использование REST API