Implantação de soluções com escopo de locatários para soluções de Estrutura do SharePoint
Você pode configurar os componentes da Estrutura do SharePoint (SPFx) para ficarem imediatamente disponíveis no locatário quando o pacote de solução for instalado no catálogo de aplicativos do locatário. Isso pode ser configurado utilizando o atributo skipFeatureDeployment no arquivo ./config/package-solution.json.
Quando a solução tiver esse atributo habilitado, o administrador de locatários terá a opção de habilitar a solução para estar disponível automaticamente em todos os conjuntos de sites e sites no locatário quando o pacote de solução for instalado no catálogo de aplicativos do locatário.
Você também pode ver a opção de implantação em todo o locatário demonstrada assistindo ao seguinte vídeo no Canal do YouTube da Comunidade (PnP) da Plataforma Microsoft 365:
Observação
Será preciso atualizar para a última versão do modelo Yeoman da Estrutura do SharePoint para poder usar esse recurso. Você pode atualizar sua instalação global executando **npm install -g @microsoft/generator-sharepoint**.
A implantação em todo o locatário foi lançada no SPFx versão 1.4 e pode ser usada ao desenvolver webparts que serão implantadas no SharePoint 2019 e no SharePoint Online. Essa opção de implantação não está disponível no SharePoint 2016 Feature Pack 2, pois ele suporta somente o SPFx 1.1.
Se você estiver utilizando uma webpart SPFx anterior a 1.4, você pode atualizar com instruções por meio da CLI para Microsoft 365
Requisitos específicos da solução
Quando esta opção é usada, quaisquer definições de estrutura de recursos na solução Estrutura do SharePoint são ignoradas. Se a solução contém definições de estrutura de recursos, por exemplo, para criar uma lista personalizada, não se deve usar esta opção específica da solução.
Para saber mais, confira Provisionar ativos do SharePoint com seu pacote de solução.
Observação
As soluções que são configuradas para serem automaticamente implantadas nos locatários não ficam visíveis no recurso adicionar um aplicativo no nível de site.
Configurar a solução para ficar disponível no locatário
O modelo Yeoman da Estrutura do SharePoint faz uma pergunta específica relacionada a essa opção. Esta questão impacta diretamente no atributo skipFeatureDeployment no arquivo package-solution.json.
Na configuração de exemplo a seguir, skipFeatureDeployment é definido como true, o que indica que a solução pode ser implantada de forma centralizada em todo o locatário.
{
"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"
}
}
Como aprovar a implantação em todo o locatário no catálogo de aplicativos
Quando for implantada a solução com o atributo skipFeatureDeployment definido como true no catálogo de aplicativos do locatário, o administrador terá a opção de configurar a solução para implantação centralizada no locatário.
Por padrão, a caixa de seleção Tornar esta solução disponível para todos os sites da organização não está marcada. Se a caixa de seleção for marcada pelo administrador, os componentes nas soluções ficarão visíveis e disponíveis automaticamente no locatário.
Observe que, como as ações de upgrade específicas do site e da solução são disponibilizadas apenas quando você usa a estrutura de recurso, não há opção específica de upgrade para soluções centralmente implantadas. Essas soluções podem ser atualizadas com a atualização dos ativos específicos da solução na CDN e a atualização e implantação do pacote no catálogo de aplicativos. Isso atualiza automaticamente todas as instâncias de componente existentes no locatário para usar os últimos ativos do componente, como arquivos JavaScript e arquivos CSS atualizados.
Aviso
Para obter pacotes de solução contendo extensões do site, a marcação da caixa de seleção Disponibilizar esta solução para todos os sites da organização só será necessária para ativar as extensões do site pela primeira vez. Durante a atualização de pacotes de solução existentes, marcar a caixa de seleção durante a implantação poderá criar entradas duplicadas na lista Extensões Amplas de Locatários.
Visibilidade da web part do lado do cliente em sites do SharePoint
As web parts incluídas nas soluções que foram implantadas centralmente ficam imediatamente visíveis no seletor de web parts em páginas clássicas e modernas.
Impacto da configuração skipFeatureDeployment com extensões
As Extensões da Estrutura do SharePoint ficam imediatamente disponíveis para serem usadas em sites do SharePoint. Isso significa que eles podem estar associados a ClientSideComponentId propriedades nos elementos específicos do Microsoft Office SharePoint Online, como campos e ações personalizadas do usuário.
Além disso, se um administrador marcar a caixa de seleção Disponibilizar esta solução para todos os sites da organização durante a implantação, as automações no pacote de solução poderão criar entradas na lista Extensões Amplas de Locatário no catálogo de aplicativos. As entradas nesta lista gerenciam a ativação das extensões de site em todo o locatário. As automações são descritas pelo arquivo ClientSideInstance.xml conforme referenciado em ./config/package-solution.json.
Para saber mais, confira Implantação para todos os Locatários para Extensões da Estrutura do SharePoint.