Integrieren von Dienstanwendungen auf der Seite "Dienstanwendungen verwalten"

Artikel
09/24/2014

Letzte Änderung: Dienstag, 20. April 2010

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Hinzufügen eines Menüelements für die Dienstanwendung zur Schaltfläche "Neu"
Aktivieren der Schaltfläche "Verbinden"
Aktivieren der Schaltfläche "Löschen"
Aktivieren der Schaltfläche "Verwalten"
Aktivieren der Schaltfläche "Administratoren"
Aktivieren der Schaltfläche "Eigenschaften"
Aktivieren der Schaltfläche "Veröffentlichen"
Aktivieren der Schaltfläche "Berechtigungen"

Die Seite Dienstanwendungen verwalten in der SharePoint 2010-Zentraladministration wird von Administratoren zur Verwaltung von Dienstanwendungen und Proxys verwendet.

Die Seite Dienstanwendungen verwalten enthält Menübandschaltflächen mit folgenden Funktionen:

Neu Erstellt eine Dienstanwendung.
Verbinden Stellt eine Verbindung mit Dienstanwendungen her, die von anderen Farmen veröffentlicht wurden.
Löschen Löscht die ausgewählte Dienstanwendung oder Dienstanwendungsverbindung.
Verwalten Verwaltet die Einstellungen für die ausgewählte Dienstanwendung.
Administratoren Weist der ausgewählten Dienstanwendung Administratoren zu.
Eigenschaften Bearbeitet allgemeine Eigenschaften.
Veröffentlichen Macht die ausgewählte Dienstanwendung für andere Farmen verfügbar.
Berechtigungen Bestimmt, welche Konten auf die ausgewählte Dienstanwendung zugreifen können.

Wenn Sie eine Dienstanwendung auf der Seite Dienstanwendungen verwalten verfügbar machen möchten, müssen Sie die Dienstanwendung der Liste der verfügbaren Dienstanwendungen hinzufügen, die Schaltflächen auf dem Menüband der Seite Dienstanwendungen verwalten ändern und eine Seite zur Verwaltung der Dienstanwendung erstellen, um Benutzereingaben verarbeiten zu können.

Hinzufügen eines Menüelements für die Dienstanwendung zur Schaltfläche "Neu"

Die Schaltfläche Neu auf dem Menüband der Seite Dienstanwendungen verwalten ist immer aktiviert. Wenn Sie auf Neu klicken, wird eine Liste der Dienstanwendungen angezeigt, die ein Farmadministrator erstellen kann. Sie können Ihre eigene Dienstanwendung in diese Liste aufnehmen.

So nehmen Sie eine Dienstanwendung in die Liste der verfügbaren Dienstanwendungen auf

Erstellen Sie eine Seite zum Erfassen erforderlicher Benutzereingaben, und erstellen Sie eine Dienstanwendung mit einem entsprechenden lokalen Proxy.
Implementieren Sie die IServiceAdministration-Schnittstelle in Ihrer von SPService abgeleiteten Klasse.
Überschreiben Sie SPService::GetCreateApplicationLink so, dass ein Link zu der in Schritt 1 erstellten Seite zurückgegeben wird.

Im folgenden Beispiel wird veranschaulicht, wie eine Dienstanwendung der Liste der verfügbaren Dienstanwendungen hinzugefügt wird.

//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

Aktivieren der Schaltfläche "Verbinden"

Mit der Schaltfläche Verbinden auf dem Menüband der Seite Dienstanwendungen verwalten wird eine Verbindung mit einer Dienstanwendung hergestellt. Bei diesem Vorgang wird intern ein Dienstanwendungsproxy erstellt.

Wenn Sie auf den Pfeil unter der Schaltfläche Verbinden klicken, wird die Liste der aktuell ausgeführten Proxys und Dienste angezeigt.

Wenn Sie auf die Schaltfläche Verbinden klicken, wird der Assistent zum Herstellen einer Verbindung mit einer Remotedienstanwendung gestartet. Mit diesem Assistenten kann ein Administrator durch Durchsuchen der von einer Webfarm veröffentlichten Dienstanwendungen eine Verbindung herstellen.

Damit diese Schaltfläche aktiviert wird, wenn die Dienstanwendung ausgewählt wird, implementieren Sie ISharedServiceApplication in Ihrer von SPServiceApplication abgeleiteten Klasse.

Hinweis
Mit der SPIisWebServiceApplication-Basisklasse wird ISharedServiceApplication implementiert, weshalb die Veröffentlichung standardmäßig aktiviert ist.

Aktivieren der Schaltfläche "Löschen"

Die Schaltfläche Löschen auf dem Menüband der Seite Dienstanwendungen verwalten wird aktiviert, wenn ein Element auf der Seite Dienstanwendungen verwalten ausgewählt wird. Dieser Vorgang bewirkt für das ausgewählte Element Folgendes:

Die Unprovision-Methode wird mit dem Wert true aufgerufen, falls dem ausgewählten Element zugeordnete Benutzerdaten gelöscht werden sollen; andernfalls ist der Wert false.
Die Delete-Methode wird aufgerufen.

Aktivieren der Schaltfläche "Verwalten"

Mit der Schaltfläche Verwalten auf dem Menüband wird die ausgewählte Dienstanwendung oder der ausgewählte Proxy verwaltet.

So aktivieren Sie die Schaltfläche "Verwalten", wenn die Dienstanwendung oder der Proxy ausgewählt wird

Erstellen Sie in der Zentraladministration eine Seite für die Verwaltung der Dienstanwendung oder des Proxys.

Überschreiben Sie die ManageLink-Eigenschaft in der von SPServiceApplication oder SPServiceApplicationProxy abgeleiteten Klasse so, dass ein Link mit der in Schritt 1 erstellten Seite zurückgegeben wird.

Das folgenden Codebeispiel zeigt, wie die Schaltfläche Verwalten für die ausgewählte Dienstanwendung aktiviert wird.

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

Aktivieren der Schaltfläche "Administratoren"

Die Schaltfläche Administratoren auf dem Menüband der Seite Dienstanwendungen verwalten wird aktiviert, wenn eine Dienstanwendung auf der Seite Dienstanwendungen verwalten ausgewählt wird. Mit der Schaltfläche wird gesteuert, welche Benutzer über delegierten Verwaltungszugriff auf die Dienstanwendung verfügen.

Aktivieren der Schaltfläche "Eigenschaften"

Die Schaltfläche Eigenschaften wird verwendet, um die Einstellungen für das ausgewählte Element zu bearbeiten.

Hinweis
Die Einstellungen auf dieser Seite sind nur für Farmadministratoren vorgesehen.

So aktivieren Sie die Schaltfläche "Eigenschaften", wenn die Dienstanwendung oder der Proxy ausgewählt wird

Erstellen Sie in der SharePoint 2010-Zentraladministration eine Seite zum Bearbeiten der Eigenschaften der Dienstanwendung oder des Proxys.
Überschreiben Sie die PropertiesLink-Eigenschaft in der von SPServiceApplication oder SPServiceApplicationProxy abgeleiteten Klasse so, dass ein Link mit der in Schritt 1 erstellten Seite zurückgegeben wird.

Aktivieren der Schaltfläche "Veröffentlichen"

Wenn die Schaltfläche Veröffentlichen auf dem Menüband der Seite Dienstanwendungen verwalten aktiviert ist, kann mit der Schaltfläche eine Dienstanwendung für andere Farmen veröffentlicht werden. Nachdem eine Dienstanwendung veröffentlicht wurde, kann sie von Administratoren anderer Dienstfarmen mithilfe der Schaltfläche Verbinden auf dem Menüband ermittelt werden.

Damit die Schaltfläche Veröffentlichen aktiviert wird, wenn die Dienstanwendung ausgewählt wird, implementieren Sie ISharedServiceApplication in Ihrer von SPServiceApplication abgeleiteten Klasse.

Hinweis
Mit der SPIisWebServiceApplication-Basisklasse wird ISharedServiceApplication implementiert, weshalb die Veröffentlichung standardmäßig aktiviert ist.

Aktivieren der Schaltfläche "Berechtigungen"

Mit der Schaltfläche Berechtigungen auf dem Menüband der Seite Dienstanwendungen verwalten wird der Zugriff auf eine Dienstanwendung gesteuert. In der Regel verwenden Sie diese Schaltfläche, um einer Remoteserverfarm die Verbindung mit der Dienstanwendung zu ermöglichen.

So aktivieren Sie die Schaltfläche "Berechtigungen", wenn die Dienstanwendung ausgewählt wird

Erstellen Sie in der SharePoint 2010-Zentraladministration eine Seite zur Angabe der Konten oder anderer Prinzipale, die Zugriff auf den Aufruf der Dienstanwendung oder des Proxys haben.
Überschreiben Sie die PermissionsLink-Eigenschaft in der von SPServiceApplication oder SPServiceApplicationProxy abgeleiteten Klasse so, dass ein Link mit der in Schritt 1 erstellten Seite zurückgegeben wird.

Freigeben über