Implementación e instalación de complementos de SharePoint: métodos y opciones
En este artículo, obtendrá más información sobre las opciones para publicar su complemento de SharePoint, así como cómo instalarlo y desinstalarlo.
Publicar en la Tienda Office o en el catálogo de complementos de una organización
Puede cargar el complemento de SharePoint en la Tienda Office pública o en el catálogo de complementos privado de una organización. Un catálogo de complementos privado es una colección de sitios dedicada en una aplicación web de SharePoint (o un inquilino de SharePoint Online) que hospeda bibliotecas de documentos para complementos de SharePoint y complementos de Office. Colocar el catálogo en su propia colección de sitios facilita al administrador de aplicaciones web o al administrador de inquilinos limitar los permisos al catálogo.
Si el complemento se carga en la Tienda Office, Microsoft ejecuta algunas comprobaciones de validación. Por ejemplo, comprueba si el marcado del manifiesto del complemento es válido, y verifica que cualquier paquete de soluciones de SharePoint incluido (archivos .wsp) no contenga elementos no permitidos o Características con un ámbito mayor que Web. El contenido del paquete también se inspecciona en busca de contenido inapropiado. Si el complemento supera todas las pruebas, el paquete se convierte en un archivo y Microsoft lo firma.
Nota:
Al desarrollar e implementar su complemento con Microsoft Office Developer Tools para Visual Studio, el complemento se instala directamente en el sitio de SharePoint de pruebas. Como no pasa por la Office Store, no se da la comprobación de validación descrita anteriormente.
Cargar un complemento de SharePoint en un catálogo de complementos de una organización es tan fácil como cargar un archivo en una biblioteca de documentos de SharePoint Foundation. Debe rellenar un formulario emergente en el cual se suministra la dirección URL local del paquete del complemento y otro tipo de información, como el nombre del complemento. Cuando se carga el complemento en el catálogo de complementos de una organización, existen comprobaciones similares y los complementos que no las pasan se marcan como no válidos o están deshabilitados en el catálogo.
Los administradores de inquilinos y administradores de aplicaciones web de SharePoint pueden comprar complementos de SharePoint en la Office Store. Para abrir la tienda Office, el administrador selecciona Agregar un complemento en la página Contenido del sitio y, a continuación, selecciona Tienda SharePoint en la página Sus complementos . Se abrirá una página de la Tienda SharePoint donde los administradores pueden descubrir y obtener más información sobre los complementos de SharePoint ofrecidos por los proveedores (también pueden hacerlo en office.com).
Los complementos que requieran un prerrequisito que no esté instalado en la aplicación web o el arrendamiento del administrador aparecerán atenuados y no podrán agregarse a la tienda de complementos. Por ejemplo, si un complemento requiere servicios de búsqueda y estos no están instalados, aparecerá atenuado. Administradores pueden ordenar, filtrar y desplazarse por la lista de complementos, obtener información sobre los complementos, ver críticas de los complementos y comprar licencias para un complemento.
Cuando un administrador decide comprar una licencia, debe aceptar los términos y condiciones de compra y los permisos que el complemento debe tener para funcionar, como el acceso de lectura a las listas o el control completo de acceso a la colección de sitios.
Cuando se compra una o más licencias para un complemento, éstas se descargan en la aplicación o en el arrendamiento web. El complemento no se descarga e instala automáticamente cuando se compra la licencia, aunque los administradores tienen la opción de combinar la instalación con la compra de la licencia.
Los usuarios instalan complementos desde la página Complementos . Esta página tiene una lista combinada de lo siguiente:
- Complementos de SharePoint desde el cat?logo de complementos de la organizaci?n de la aplicaci?n web (o del espacio empresarial).
- Las Complementos de SharePoint de la Tienda Office para las que la organización o arrendamiento ya dispone de una licencia de sitio o una licencia asignada al usuario.
Se muestran todos los complementos que el usuario puede instalar inmediatamente. Los usuarios pueden filtrar los complementos que se incluyen en la página para incluir solo complementos en el catálogo de complemento de la organización. Cuando se instala un complemento, aparece en la lista de complementos en la página Contenidos del sitio del sitio web en el que se instala.
Instalar complementos de SharePoint
Los propietarios de sitios web instalan Complementos de SharePoint de la página Sus complementos, tal y como se ha descrito en este tema. La instalación crea una instancia del complemento. Para obtener más información sobre la instalación de complementos, consulte Agregar complementos para SharePoint a un sitio de SharePoint.
Nota:
En ocasiones, una pérdida temporal de la conexión a la red puede bloquear la instalación. Si una instalación no se realiza correctamente por algún motivo, la infraestructura de la instalación reintentará la operación tres veces. Si no lo consigue, aparecerá un aviso de la falla en la IU. Los usuarios pueden reintentar hacer la instalación más adelante.
Desinstalar complementos de SharePoint
Los propietarios de sitios web pueden desinstalar una instancia de una Complemento de SharePoint mediante la interfaz de SharePoint. La desinstalación de una instancia de una Complementos de SharePoint es limpia. Eso significa que se quita todo lo que se instaló con el complemento.
Sin embargo, los componentes que usa un complemento, pero que se encuentran instalados por separado del complemento en sí, no se eliminan. Por ejemplo, suponga que un complemento tiene una página web remota con botones que crean listas en la web de host. Desinstalar el complemento elimina su icono de la página de Contenidos del sitio, que a su vez hace que la página remota deje de estar accesible o no se pueda usar. Pero no elimina las listas que se crearon con él. SharePoint no mantiene un registro en la web de host de las listas creadas con el complemento y de las creadas por los usuarios de la UI de SharePoint, por lo que no puede eliminar las listas creadas con el complemento. Esto es algo deseable a nivel general porque es posible que las listas contengan datos útiles para los usuarios incluso tras la retirada del complemento que creó las listas.
Si la Complemento de SharePoint incluye una web de complemento, ésta se elimina. Esto produce una desinstalación más limpia que desactivar sistemáticamente características e invertir la implementación del archivo interno .wsp del complemento.
Nota:
Cuando un usuario elimina un complemento, se mueve a la Papelera de reciclaje de primera fase. Al eliminarlo allí, pasa a la Papelera de reciclaje de segundo nivel. Si se elimina la Papelera de reciclaje de segundo nivel, se desinstala por completo y no se podrá restaurar.
Los permisos del complemento también se revocan cuando se desinstale (recicle), según estas reglas:
- Los permisos de ámbito de web siempre se revocan.
- Si no existe ninguna otra instancia del complemento en la colección de sitios, también se revocarán los permisos del ámbito de la colección.
- Si no hay ninguna otra instancia del complemento en la suscripción del sitio (espacio empresarial), también se revocarán los permisos del ámbito del espacio empresarial.
El servicio web UninstallingEventEndpoint, si se registró en el manifiesto del complemento, se ejecuta al principio del proceso de desinstalación (que se produce cuando el complemento se quita de la Papelera de reciclaje de segundo nivel). Se recomienda tener un servicio web UninstallingEventEndpoint si tiene un servicio web InstalledEventEndpoint y diseñar el servicio UninstallingEventEndpoint para revertir los cambios realizados en el servicio InstalledEventEndpoint. Para obtener más información, consulte Manejar los eventos en Complementos de SharePoint.