Partager via

Intégration des applications de service à la Page Gérer les applications de service

  • Article

Dernière modification : mardi 20 avril 2010

S’applique à : SharePoint Foundation 2010

Dans cet article
Ajout d’un élément de menu d’application de service au bouton Nouveau
Activation du bouton Se connecter
Activation du bouton Supprimer
Activation du bouton Gérer
Activation du bouton Administrateurs
Activation du bouton Propriétés
Activation du bouton Publier
Activation du bouton Autorisations

La page Gérer les applications de service dans l’Administration centrale de SharePoint 2010 permet aux administrateurs de gérer les proxys et les applications de service.

Voici les boutons de Ruban que comprend la page Gérer les applications de service, ainsi que leur fonction correspondante :

  • Nouveau  Crée une application de service.

  • Se connecter  Se connecte aux applications de service publiées par les autres batteries de serveurs.

  • Supprimer  Supprime l’application de service ou la connexion d’application de service sélectionnée.

  • Gérer  Gère les paramètres de l’application de service sélectionnée.

  • Administrateurs  Affecte des administrateurs à l’application de service sélectionnée.

  • Propriétés  Modifie les propriétés courantes.

  • Publier  Met l’application de service sélectionnée à la disposition des autres batteries de serveurs.

  • Autorisations  Détermine les comptes qui ont accès à l’application de service sélectionnée.

Pour rendre votre application de service disponible à partir de la page Gérer les applications de service, vous devez au préalable l’ajouter à la liste des applications de service disponibles, modifier les boutons du Ruban dans la page Gérer les applications de service et créer une page d’administration de l’application de service pour gérer toutes les entrées utilisateur.

Ajout d’un élément de menu d’application de service au bouton Nouveau

Le bouton Nouveau du Ruban de la page Gérer les applications de service est toujours activé. Le fait de cliquer sur Nouveau permet d’afficher la liste des applications de service qu’un administrateur de batterie peut créer. Vous pouvez inclure votre propre application de service dans cette liste.

Pour inclure une application de service dans la liste des applications de service disponibles

  1. Créez une page pour collecter toutes les entrées utilisateur requises et créez une application de service avec un proxy local correspondant.

  2. Implémentez l’interface IServiceAdministration sur votre classe dérivée SPService.

  3. Substituez SPService::GetCreateApplicationLink pour retourner un lien vers la page créée à l’étape 1.

L’exemple suivant montre comment ajouter une application de service à la liste des applications de service disponibles.

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

Activation du bouton Se connecter

Le bouton Se connecter du Ruban de la page Gérer les applications de service permet de se connecter à une application de service. En interne, cette opération crée un proxy d’application de service.

Le fait de cliquer sur la flèche sous le bouton Se connecter permet d’afficher la liste des proxys et services en cours d’exécution.

Le fait de cliquer sur le bouton Se connecter proprement dit permet de démarrer l’Assistant Se connecter à une application de service distante. Cet Assistant permet à un administrateur de créer une connexion en parcourant les applications de service publiées à partir d’une batterie de serveurs.

Pour activer ce bouton lorsque votre application de service est sélectionnée, implémentez ISharedServiceApplication sur votre classe dérivée SPServiceApplication.

Notes

Étant donné que la classe de base SPIisWebServiceApplication implémente ISharedServiceApplication, la publication est activée par défaut.

Activation du bouton Supprimer

Le bouton Supprimer du Ruban de la page Gérer les applications de service est activé lorsqu’un élément est sélectionné dans la page Gérer les applications de service. Pour l’élément sélectionné, cette opération effectue les actions suivantes :

  • Elle appelle la méthode Unprovision avec la valeur true si des données utilisateur associées à l’élément sélectionné doivent être supprimées ; sinon, la valeur est false.

  • Elle appelle la méthode Delete.

Activation du bouton Gérer

Le bouton Gérer du Ruban permet de gérer le proxy ou l’application de service sélectionné.

Pour activer le bouton Gérer lorsque votre proxy ou application de service est sélectionné

  1. Créez une page dans l’Administration centrale pour gérer le proxy ou l’application de service.

  2. Substituez la propriété ManageLink sur la classe dérivée SPServiceApplication ou SPServiceApplicationProxy pour établir un lien vers la page créée à l’étape 1.

    L’exemple de code suivant montre comment le bouton Gérer est activé pour l’application de service sélectionnée.

    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

Activation du bouton Administrateurs

Le bouton Administrateurs du Ruban de la page Gérer les applications de service est activé lorsqu’une application de service est sélectionnée à partir de la page Gérer les applications de service. Il permet de déterminer quels sont les utilisateurs auxquels est accordé un accès d’administration à l’application de service.

Activation du bouton Propriétés

Le bouton Propriétés permet de modifier les paramètres de l’élément sélectionné.

Notes

Les paramètres qui se trouvent dans cette page sont uniquement destinés aux administrateurs de batterie.

Pour activer le bouton Propriétés lorsque votre proxy ou application de service est sélectionné

  1. Créez une page dans l’Administration centrale de SharePoint 2010 pour modifier les propriétés de votre proxy ou application de service.

  2. Substituez la propriété PropertiesLink sur la classe dérivée SPServiceApplication ou SPServiceApplicationProxy pour établir un lien vers la page créée à l’étape 1.

Activation du bouton Publier

S’il est activé, le bouton Publier du Ruban de la page Gérer les applications de service permet de publier une application de service sur les autres batteries de serveurs. Après qu’une application de service a été publiée, les administrateurs des autres batteries de serveurs peuvent la détecter en utilisant le bouton Se connecter du Ruban.

Pour activer le bouton Publier lorsque votre application de service est sélectionnée, implémentez ISharedServiceApplication sur votre classe dérivée SPServiceApplication.

Notes

Étant donné que la classe de base SPIisWebServiceApplication implémente ISharedServiceApplication, la publication est activée par défaut.

Activation du bouton Autorisations

Le bouton Autorisations du Ruban de la page Gérer les applications de service permet de contrôler l’accès à une application de service. En règle générale, vous utilisez ce bouton pour permettre à une batterie de serveurs distante de se connecter à l’application de service.

Pour activer le bouton Autorisations lorsque votre application de service est sélectionnée

  1. Créez une page dans l’Administration centrale de SharePoint 2010 pour spécifier les comptes ou les autres principaux qui peuvent appeler votre application de service.

  2. Substituez la propriété PermissionsLink sur la classe dérivée SPServiceApplication ou SPServiceApplicationProxy pour établir un lien vers la page créée à l’étape 1.