Integración de aplicaciones de servicio con la página Administrar aplicaciones de servicio
Última modificación: martes, 20 de abril de 2010
Hace referencia a: SharePoint Foundation 2010
En este artículo
Adición de un elemento de menú de aplicación de servicio al botón Nuevo
Habilitación del botón Conectar
Habilitación del botón Eliminar
Habilitación del botón Administrar
Habilitación del botón Administradores
Habilitación del botón Propiedades
Habilitación del botón Publicar
Habilitación del botón Permisos
Los administradoras usan la página Administrar aplicaciones de servicio en Administración central de SharePoint 2010 para administrar aplicaciones de servicio y servidores proxy.
La página Administrar aplicaciones de servicio incluye los botones de la cinta de opciones que hacen lo siguiente:
Nuevo: crea una aplicación de servicio.
Conectar: conecta a las aplicaciones de servicio publicadas por otros conjuntos o granjas de servidores.
Eliminar: elimina la aplicación de servicio o la conexión de la aplicación de servicio seleccionada.
Administrar: administra la configuración de la aplicación de servicio seleccionada.
Administradores: asigna administradores a la aplicación de servicio seleccionada.
Propiedades: edita las propiedades comunes.
Publicar: hace que la aplicación de servicio seleccionada esté disponible para otras granjas de servidores.
Permisos: determina qué cuentas pueden tener acceso a la aplicación de servicio seleccionada.
Para que la aplicación de servicio esté disponible en la página Administrar aplicaciones de servicio debe agregar la aplicación de servicio a la lista de aplicaciones de servicio disponibles, modificar los botones de la cinta de opciones en la página Administrar aplicación de servicio y crear una página de administración de aplicación de servicio para controlar cualquier entrada del usuario.
Adición de un elemento de menú de aplicación de servicio al botón Nuevo
El botón Nuevo de la cinta de opciones de la página Administrar aplicaciones de servicio siempre está habilitado. Al hacer clic en Nuevo, se muestra una lista de las aplicaciones de servicio que puede crear un administrador de la granja de servidores. Puede incluir su propia aplicación de servicio en esta lista.
Para incluir una aplicación de servicio en la lista de aplicaciones de servicio disponibles
Cree una página para recopilar cualquier entrada del usuario necesaria y cree una aplicación de servicio con el proxy local correspondiente.
Implemente la interfaz de IServiceAdministration en la clase derivada SPService
Invalide SPService::GetCreateApplicationLink para devolver un vínculo a la página que se creó en el paso 1.
En el ejemplo siguiente se muestra cómo agregar una aplicación de servicio a la lista de aplicaciones de servicio 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
Habilitación del botón Conectar
El botón Conectar de la cinta de opciones de la página Administrar aplicaciones de servicio se usa para conectarse a una aplicación de servicio. Internamente, esta operación crea a un proxy de aplicación de servicio.
Al hacer clic en la flecha que aparece en el botón Conectar, se muestra la lista de servidores proxy y servicios en ejecución actualmente.
Al hacer clic en el botón Conectar, se inicia el Asistente para la conexión a una aplicación de servicio remota. Este asistente permite a un administrador crear una conexión buscando en las aplicaciones de servicio publicadas desde una granja de servidores.
Para habilitar este botón cuando selecciona la aplicación de servicio, implemente ISharedServiceApplication en la clase derivada SPServiceApplication.
Nota
La clase base SPIisWebServiceApplication implementa ISharedServiceApplication, por lo que la publicación está habilitada de manera predeterminada.
Habilitación del botón Eliminar
El botón Eliminar de la cinta de opciones de la página Administrar aplicaciones de servicio está habilitado cuando se selecciona cualquier elemento de la página Administrar aplicación de servicio. Para el elemento seleccionado, esta operación hace lo siguiente:
Llama al método Unprovision con un valor true si los datos de usuario asociados con el elemento seleccionado deben eliminarse; en caso contrario, el valor es false.
Llama al método Delete.
Habilitación del botón Administrar
El botón Administrar de la cinta de opciones se usa para administrar la aplicación de servicio o el proxy seleccionados.
Para habilitar el botón Administrar cuando se selecciona la aplicación de servicio o el proxy
Cree una página en Administración central para administrar la aplicación de servicio o el proxy.
Invalide la propiedad ManageLink en la clase derivada SPServiceApplication o SPServiceApplicationProxy para vincular a la página creada en el paso 1.
En el ejemplo de código siguiente se muestra cómo se habilita el botón Administrar para la aplicación de servicio seleccionada.
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
Habilitación del botón Administradores
El botón Administradores de la cinta de opciones de la página Administrar aplicaciones de servicio se habilita cuando se selecciona una aplicación de servicio desde la página Administrar aplicación de servicio. Se usa para controlar los usuarios que tienen acceso de administración delegado a la aplicación de servicio.
Habilitación del botón Propiedades
El botón Propiedades se usa para editar la configuración del elemento seleccionado.
Nota
La configuración de esta página está destinada solo a los administradores de la granja de servidores.
Para habilitar el botón Propiedades cuando se selecciona la aplicación de servicio o el proxy
Cree una página en Administración central de SharePoint 2010 para editar las propiedades de la aplicación de servicio o el proxy.
Invalide la propiedad PropertiesLink en la clase derivada SPServiceApplication o SPServiceApplicationProxy para vincular a la página creada en el paso 1.
Habilitación del botón Publicar
Si está habilitado, el botón Publicar en la cinta de opciones de la página Administrar aplicaciones de servicio se usa para publicar una aplicación de servicio a otras granjas de servidores. Una vez que se publica una aplicación de servicio, los administradores de otras granjas de servidores de servicio pueden detectarla usando el botón Conectar de la cinta de opciones.
Para habilitar el botón Publicar cuando se selecciona la aplicación de servicio, implemente ISharedServiceApplication en la clase derivada SPServiceApplication.
Nota
La clase base SPIisWebServiceApplication implementa ISharedServiceApplication, por lo que la publicación está habilitada de manera predeterminada.
Habilitación del botón Permisos
El botón Permisos de la cinta de opciones de la página Administrar aplicación de servicio se usa para controlar el acceso a una aplicación de servicio. Por lo general, este botón se usa para habilitar una granja de servidores remota para conectarse a la aplicación de servicio.
Para habilitar el botón Permisos cuando se selecciona la aplicación de servicio
Cree una página en Administración central de SharePoint 2010 para especificar las cuentas u otras entidades de seguridad que tienen acceso para invocar la aplicación de servicio o el proxy.
Invalide la propiedad PermissionsLink en la clase derivada SPServiceApplication o SPServiceApplicationProxy para vincular a la página creada en el paso 1.