Implementación de una solución con ámbito de inquilino para soluciones de SharePoint Framework

Configure los componentes de SharePoint Framework (SPFx) para que estén disponibles inmediatamente en todo el espacio empresarial cuando se instale el paquete de solución en el Catálogo de aplicaciones del espacio empresarial. Esto se puede configurar mediante el atributo skipFeatureDeployment en el archivo ./config/package-solution.json.

Al habilitar este atributo en la solución, el administrador de espacios empresariales puede habilitar la solución para que esté disponible automáticamente en todos los sitios y colecciones de sitios del espacio empresarial cuando se instale el paquete de solución en el Catálogo de aplicaciones del espacio empresarial.

También puede ver la opción de implementación en todo el inquilino que se muestra al ver el vídeo siguiente en el canal de YouTube de SharePoint PnP:

Nota

Para poder usar esta funcionalidad, tiene que actualizar a la versión más reciente de la plantilla de Yeoman de SharePoint Framework. Puede actualizar la instalación global ejecutando **npm install -g @microsoft/generator-sharepoint**.

La implementación en todo el espacio empresarial se lanza en SPFx versión 1.4 y se puede usar al desarrollar elementos web que se implementarán en SharePoint 2019 y SharePoint Online. Esta opción de implementación no está disponible para SharePoint 2016 Feature Pack 2, ya que solo admite SPFx 1.1.

Si utiliza un elemento web SPFx anterior a 1.4, puede actualizar con instrucciones mediante la CLI de Microsoft 365

Requisitos específicos de la solución

Cuando se usa esta opción, se omiten las definiciones del marco de características de la solución de SharePoint Framework. Si la solución contiene definiciones del marco de características (por ejemplo, para crear una lista personalizada), no se debe usar esta opción específica de la solución.

Para obtener más información, vea Aprovisionar activos de SharePoint con el paquete de solución.

Nota

Las soluciones configuradas para que se implementen automáticamente entre inquilinos no están visibles en la funcionalidad para agregar una aplicación en el nivel de sitio.

Configurar la solución para que esté disponible en todo el inquilino

La plantilla de Yeoman de SharePoint Framework le plantea una pregunta específica relacionada con esta opción. Esta pregunta afecta directamente al atributo skipFeatureDeployment del archivo package-solution.json.

Pregunta de Yeoman sobre la opción implementada en el espacio empresarial

En la siguiente configuración de ejemplo, skipFeatureDeployment se establece en true, lo que indica que la solución se puede implementar de forma centralizada en todo el espacio empresarial.

{
  "solution": {
    "name": "tenant-deploy-client-side-solution",
    "id": "dd4feca4-6f7e-47f1-a0e2-97de8890e3fa",
    "version": "1.0.0.0",
    "skipFeatureDeployment": true,
    "features": [
      {
        "title": "Application Extension - Deployment of custom action.",
        "description": "Deploys a custom action with ClientSideComponentId association",
        "id": "54f0dc0e-c190-439d-933b-2dd2809ed3c3",
        "version": "1.0.0.0",
        "assets": {
          "elementManifests": [
            "elements.xml",
            "ClientSideInstance.xml"
          ]
        }
      }
    ]
  },
  "paths": {
    "zippedPackage": "solution/tenant-deploy-true.sppkg"
  }
}

Aprobación de la implementación en todo el espacio empresarial en el catálogo de aplicaciones

En el Catálogo de aplicaciones del espacio empresarial, cuando se implementa una solución con el atributo skipFeatureDeployment establecido en true, el administrador puede configurar la solución para que se implemente de forma centralizada en todo el espacio empresarial.

De forma predeterminada, la casilla Hacer que esta solución esté disponible en todos los sitios de la organización no está activada. Si el administrador activa la casilla, los componentes de las soluciones están visibles y disponibles automáticamente en todo el inquilino.

Opción "Hacer que esta solución esté disponible en todos los sitios de la organización" visible cuando la solución se implementa en el catálogo de aplicaciones

Observe que, dado que la solución y las acciones de actualización específicas de un sitio solo están disponibles al usar el marco de características, no hay ninguna opción de actualización específica para las soluciones implementadas de forma centralizada. Para actualizar estas soluciones, actualice los recursos específicos de la solución en la red CDN y actualice e implemente el paquete en el catálogo de aplicaciones. Actualiza automáticamente todas las instancias de componentes existentes en todo el inquilino para usar los activos de componentes más recientes, como archivos JavaScript y archivos CSS actualizados.

Advertencia

En el caso de los paquetes de soluciones que contienen extensiones de sitio, solo tendrá que seleccionar la casilla Hacer que esta solución esté disponible en todos los sitios de la organización para activar inicialmente las extensiones de sitio. Al actualizar los paquetes de soluciones existentes, si selecciona la casilla durante la implementación, es posible que se creen entradas duplicadas en la lista Extensión de todo el inquilino.

Visibilidad de elementos web del lado cliente en sitios de SharePoint

Los elementos web incluidos en soluciones implementadas de forma centralizada están inmediatamente visibles en el selector de elementos web en las páginas clásicas y modernas.

Impacto de la opción skipFeatureDeployment con extensiones

SharePoint Framework Extensions está disponible inmediatamente para su uso en los sitios de SharePoint. Esto significa que puede asociarse a las propiedades ClientSideComponentId en los elementos específicos de SharePoint, tales como campos y acciones personalizadas de usuario.

Además, si un administrador selecciona la casilla Hacer que esta solución esté disponible en todos los sitios de la organización durante la implementación, la automatización del paquete de soluciones puede crear entradas en la lista Extensiones para todos los inquilinos del catálogo de aplicaciones. Las entradas en esta lista administran la activación de extensiones de sitio en todo el inquilino. Las automatizaciones se describen mediante el archivo ClientSideInstance.xml, como se indica en ./config/package-solution.json.

Para obtener más información, consulte Implementación en todo el inquilino de las Extensiones de SharePoint Framework.

Consulte también