Usar páginas de aplicativos de parte única no SharePoint Online

  • Artigo

As páginas do aplicativo de parte única fornecem um recurso para hospedar web parts da Estrutura do SharePoint ou aplicativos do Microsoft Teams no Microsoft Office SharePoint Online com um layout bloqueado. Os usuários finais não podem modificar ou configurar a página que está usando o layout de Página do Aplicativo de Parte Simples.

As páginas de aplicativos têm as seguintes características:

  • Páginas de aplicativo de parte única não podem ser editadas por usuários finais usando um navegador
  • No momento, é compatível com a hospedagem somente em web parts únicas ou aplicativos do Microsoft Teams
  • Os usuários finais podem criar novas páginas de aplicativos usando a experiência Nova>Página disponível em sites modernos.
  • Os desenvolvedores podem alterar o layout da página programaticamente a partir do layout de página normal para uma Página de Aplicativo de ´Página Simples
  • Não há nenhuma Nova experiência em uma página de aplicativo de página única. Os usuários finais podem criar páginas de artigo ou páginas de aplicativos de página única usando Nova/experiência de página, presente na faixa de opções de quaisquer páginas de artigo modernas.

As páginas de aplicativos são expostas como uma opção no recurso de criação de páginas modernas quando você escolhe o layout de página usado para sua página. Todas as web parts que foram configuradas para estar disponíveis também como uma página de aplicativo estão disponíveis no recurso Criar página.

A Web Part pode ser configurada para ser exposta como uma página de aplicativo. Essa configuração é feita no arquivo de manifesto da web part ajustando o valor de supportedHosts. Se o valor supportedHosts contiver o valor "SharePointFullPage", a Web Part será exposta como uma opção na interface do usuário do futuro selecionador de páginas do aplicativo.

O seguinte manifesto da Web Part demonstra o cenário em que a Web Part é incluída para estar presente em todas as plataformas com suporte atualizando todos os valores diferentes para o parâmetro supportedHosts.

{
  // ...

  "requiresCustomScript": false,
  "supportedHosts": ["SharePointWebPart", "SharePointFullPage", "TeamsTab"],

  "preconfiguredEntries": [{
    // ...
  }]
}

Como provisionar a página de aplicativo de parte única no seu locatário

Como desenvolvedor, as duas maneiras mais comuns de provisionar páginas de aplicativo de parte única é usar PnP PowerShell ou CLI para Microsoft 365.

Também é possível usar o PnP PowerShell para atualizar o layout da página existente com o script a seguir.

Observação

O PnP PowerShell é uma solução de software livre com uma comunidade ativa de suporte. Não há nenhuma SLA para o suporte da ferramenta de software livre por parte da Microsoft.

Você também pode usar CLI para Microsoft 365 para atualizar o layout de página para a página existente com o seguinte script.

Observação

A CLI do Microsoft 365 é uma solução de software livre com uma comunidade ativa oferecendo suporte. Não há nenhuma SLA para o suporte da ferramenta de software livre por parte da Microsoft.

Connect-PnPOnline -Url https://contoso.sharepoint.com/sites/marketing
Set-PnPPage -Identity "Page" -LayoutType SingleWebPartAppPage

Consulte a Documentos do PnP PowerShell para obter detalhes completos e exemplos neste cmdlet.

Você precisará ajustar o locatário e o nome da página com base em seu ambiente.