Интеграция серверных приложений со страницей приложений управления службами

Статья
04/21/2015

Дата последнего изменения: 20 апреля 2010 г.

Применимо к: SharePoint Foundation 2010

В этой статье
Добавление элемента меню управления приложениями-службами в кнопку "Создать"
Включение кнопки "Подключить"
Включение кнопки "Удалить"
Включение кнопки "Управление"
Включение кнопки "Администраторы"
Включение кнопки "Свойства"
Включение кнопки "Опубликовать"
Включение кнопки "Разрешения"

Администраторы используют страницу Управление приложениями-службами в центре администрирования SharePoint 2010 для управления приложениями-службами и прокси-серверами.

На странице "Управление приложениями-службами" размещены кнопки, которые выполняют следующие действия.

Создать. Создает приложение-службу.
Подключить. Подключается к приложениям-службам, опубликованным другими фермами.
Удалить. Удаляет выбранное приложение-службу или подключение к приложению-службе.
Управление. Управление параметрами для выбранного приложения-службы.
Администраторы. Назначает администраторов для выбранного приложения-службы.
Свойства. Изменение общих свойств.
Опубликовать. Делает выбранное приложение-службу доступной для других ферм.
Разрешения. Определяет, какие учетные записи могут получать доступ к выбранному приложению-службе.

При предоставлении доступа к приложению-службе для других форм на странице "Управление приложениями-службами" приложение-служба добавляется в список доступных приложений-служб, изменяются кнопки на ленте на странице "Управление приложениями-службами" и создается страница администрирования приложением-службой для обработки данных, вводимых пользователем.

Добавление элемента меню управления приложениями-службами в кнопку "Создать"

Кнопка Создать на ленте страницы "Управление приложениями-службами" всегда активировано. Если нажать кнопку Создать, появится список приложений-служб, которые может создать администратор фермы. В этот список можно добавить собственное приложение-службу.

Добавление приложения-службы в список доступных приложений-служб

Создайте страницу для сбора необходимых данных, вводимых пользователем, и создайте приложение-службу с соответствующим локальным прокси-сервером.
Реализуйте интерфейс IServiceAdministration в классе, производном от SPService.
Переопределите свойство SPService::GetCreateApplicationLink для возвращения ссылки на страницу, созданную на этапе 1.

В следующем примере показано, как добавить приложение-службу в список доступных приложений-служб.

//Placeholder for the actual GUID.
[Guid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")]
public sealed class SampleWebService
    : SPIisWebService, IServiceAdministration
{
    public Type[] GetApplicationTypes()
    {
        return new Type[] { typeof(SampleWebServiceApplication) };
    }
 
    public SPPersistedTypeDescription GetApplicationTypeDescription(
        Type serviceApplicationType)
    {
        if (serviceApplicationType != typeof(SampleWebServiceApplication))
        {
            throw new NotSupportedException();
        }
 
        return new SPPersistedTypeDescription(
            "Sample Web Service",
            "A sample web service.");
    }
 
    public override SPAdministrationLink GetCreateApplicationLink(
        Type serviceApplicationType)
    {
        // NOTE: Because there can be only one instance of this service,
        // and there is only one application type, the target page 
        // does not require any query string parameters.
        return new SPAdministrationLink("/_admin/SampleCreate.aspx");
    }
}

// Placeholder for your actual GUID <System.Runtime.InteropServices.GuidAttribute("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")>
Public NotInheritable Class SampleWebService
    Inherits SPIisWebService
    Implements IServiceAdministration
    Public Function GetApplicationTypes() As Type()
        Return New Type() {GetType(SampleWebServiceApplication)}
    End Function

    Public Function GetApplicationTypeDescription(ByVal serviceApplicationType As Type) As SPPersistedTypeDescription
        If serviceApplicationType IsNot GetType(SampleWebServiceApplication) Then
            Throw New NotSupportedException()
        End If

        Return New SPPersistedTypeDescription("Sample Web Service", "A sample web service.")
    End Function

    Public Overrides Function GetCreateApplicationLink(ByVal serviceApplicationType As Type) As SPAdministrationLink
        ' NOTE: Because there can be only one instance of this service,
        ' and there is only one application type, the target page 
        ' does not require any query string parameters.
        Return New SPAdministrationLink("/_admin/SampleCreate.aspx")
    End Function
End Class

Включение кнопки "Подключить"

Кнопка Подключить на ленте страницы "Управление приложениями-службами" используется для подключения к приложению-службе. На внутреннем уровне эта операция создает прокси-сервер приложения-службы.

Если щелкнуть стрелку под кнопкой Подключить, появится список работающих прокси-серверов и служб, работающих в данный момент.

Если нажать саму кнопку Подключить, откроется мастер подключения к удаленному приложению-службе. Этот мастер позволяет администратору создать подключение, выбрав приложение-службу из списка приложений, опубликованных в ферме.

Чтобы включить эту кнопку при выборе приложения-службы, реализуйте класс ISharedServiceApplication в классе, производном от SPServiceApplication.

Примечание
Базовый класс SPIisWebServiceApplication реализует интерфейс ISharedServiceApplication, поэтому публикация включена по умолчанию.

Включение кнопки "Удалить"

Кнопка Удалить на ленте страницы "Управление приложениями-службами" активирована, если какой-либо элемент выбран на странице "Управление приложениями-службами". Для выбранного элемента эта операция выполняет следующие действия.

Вызывает метод Unprovision со значением true, если данные пользователя, связанные с выбранным элементом, требуется удалить. В противном случае значение равно false.
Вызывает метод Delete.

Включение кнопки "Управление"

Кнопка Управление на ленте используется для управления выбранным приложением-службой или прокси-сервером.

Включение кнопки "Управление" для выбранного приложения-службы или прокси-сервера

Создайте страницу в центре администрирования для управления приложением-службой или прокси-сервером.
Чтобы подключиться к странице, созданной на шаге 1, переопределите свойство ManageLink производного класса SPServiceApplication или SPServiceApplicationProxy.

В следующем примере кода показано, как кнопка Управление включается для выбранного приложения-службы.
```
public override SPAdministrationLink ManageLink
{
    get
    {
        return new SPAdministrationLink(
            "/_admin/SampleManage.aspx?id=" + this.Id.ToString());
    }
}
```
```
Public Overrides ReadOnly Property ManageLink() As SPAdministrationLink
        Get
            Return New SPAdministrationLink("/_admin/SampleManage.aspx?id=" & Me.Id.ToString())
        End Get
End Property
```

Включение кнопки "Администраторы"

Кнопка Администраторы на ленте страницы "Управление приложениями-службами" активирована, если приложение-служба выбрана на странице "Управление приложениями-службами". Она используется для управление тем, каким пользователям предоставляются права администратора для доступа к приложению-службе.

Включение кнопки "Свойства"

Кнопка Свойства используется для изменения параметров выбранного элемента.

Примечание
Параметры на этой странице предназначены только для администраторов.

Включение кнопки "Свойства", если выбрано приложение-служба или прокси-сервер

Создайте страницу в центре администрирования SharePoint 2010 для изменения свойств приложения-службы или прокси-сервера
Чтобы подключиться к странице, созданной на шаге 1, переопределите свойство PropertiesLink производного класса SPServiceApplication или SPServiceApplicationProxy.

Включение кнопки "Опубликовать"

Если кнопка Опубликовать включена на ленте страницы "Управление приложениями-службами", она используется для публикации приложения-службы. После его публикации администраторы других ферм серверов могут обнаруживать его с помощью кнопки Подключить на ленте.

Чтобы включить кнопку "Опубликовать" при выборе приложения-службы, реализуйте класс ISharedServiceApplication в классе, производном от SPServiceApplication.

Примечание
Базовый класс SPIisWebServiceApplication реализует интерфейс ISharedServiceApplication, поэтому публикация включена по умолчанию.

Включение кнопки "Разрешения"

Кнопка Разрешения на ленте страницы "Управление приложениями-службами" используется для управления доступом к приложению-службе. Обычно эта кнопка используется, чтобы позволить удаленной ферме серверов подключиться к приложению-службе.

Включение кнопки "Разрешения", если выбрано приложение-служба

Создайте страницу в центре администрирования SharePoint 2010 для указания учетных записей и других участников, обладающих доступом для вызова приложения-службы или прокси-сервера.
Чтобы подключиться к странице, созданной на шаге 1, переопределите свойство PermissionsLink производного класса SPServiceApplication или SPServiceApplicationProxy.

Поделиться через