Provisionamento de soluções de identidade visual e de site para o SharePoint
A introdução do Modelo de Suplemento na Nuvem e Suplementos do SharePoint fornece alternativas a formas existentes e estabelecidas de identidade visual e provisionamento de sites do SharePoint.
Até agora, você pode ter usado a estrutura de recursos, modelos de sites, modelos da web e definições de sites do SharePoint para provisionar seus sites e conjuntos de sites.
Os artigos nesta seção fornecem informações sobre o uso de suplementos do SharePoint para provisionar e gerenciar a identidade visual do site, um padrão que às vezes é chamado de provisionamento remoto. O padrão de provisionamento remoto mostra como criar suplementos personalizados do SharePoint que provisionam a identidade visual do site e executam outras tarefas de provisionamento do site.
Esta diretriz se aplica ao SharePoint Server 2013, ao SharePoint Server 2016 e ao SharePoint Online.
O que você precisa saber sobre o SharePoint
Para usar os recursos de identidade visual e provisionamento de sites no SharePoint, você precisa estar familiarizado com o seguinte:
- Conceitos e termos-chave do SharePoint
- A hierarquia dos elementos estruturais do SharePoint
- Suplementos do SharePoint
- O sistema de arquivos e os bancos de dados de conteúdo, e como eles funcionam juntos
- Estados de personalização de arquivos e seu impacto a longo prazo nas atualizações
- Tipos de sites do SharePoint e por que você os usaria
- Programação do lado do cliente no SharePoint com o modelo de objeto do lado do cliente .NET (CSOM) e APIs REST
Termos e conceitos
A tabela a seguir lista os termos e conceitos úteis para saber quando você começa a trabalhar com o provisionamento de sites e identidade visual do SharePoint com o padrão de provisionamento remoto.
Tabela 1: Conceitos e termos-chave do SharePoint
| Termo ou conceito | Descrição | Para obter mais informações |
|---|---|---|
| Web app | O site a partir do qual um suplemento é implantado. | Hosts da web, sites de suplemento e componentes do SharePoint no SharePoint |
| Fluxo de trabalho de aprovação | Fluxos de trabalho específicos para a publicação de sites, que definem quem aprova a publicação de uma página e quando. | - Trabalhar com um fluxo de trabalho de aprovação de publicação - Introdução aos fluxos de trabalho no SharePoint 2013 |
| ClientContext | Um objeto central que serve como “centro de gravidade” para todas as operações CSOM e JSOM do SharePoint. | T:Microsoft.SharePoint.Client.ClientContext |
| Modelo de Suplementos na Nuvem | Os Suplementos do SharePoint são peças de funcionalidade autocontidas que ampliam as capacidades de um site do SharePoint. É possível usar o Modelo de Suplemento na Nuvem para criar e oferecer Suplementos do SharePoint seguros, confiáveis, flexíveis e consistentes. | Visão geral dos suplementos do SharePoint |
| Banco de dados de conteúdo | Os bancos de dados de conteúdo armazenam todo o conteúdo de um conjunto de sites, inclusive o seguinte: - Documentos e arquivos do site nas bibliotecas de documentos - Dados da lista - Propriedades da Web Part - Nomes de usuários e seus direitos |
Tipos e descrições dos bancos de dados no Servidor do SharePoint |
| CSOM | Modelo de objeto do lado do cliente. Um modelo para criar código no lado do cliente para o SharePoint usando a Estrutura .NET. | - Começar a usar o modelo de objeto do cliente com dados externos no SharePoint - [MS-CSOM]: Protocolo de Consulta do Cliente do SharePoint - Índice do Servidor .NET do SharePoint, CSOM, JSOM e API REST |
| Hive | Arquivos físicos do SharePoint; os arquivos no sistema de arquivos. Esses são diferentes do conteúdo armazenado em um banco de dados de conteúdo. A seguir apresentamos o local da hive. %program files%/Common Files/Microsoft Shared/Web Server Extensions/15/ |
|
| Host da web | O site em que um suplemento está instalado. | Hosts da web, sites de suplemento e componentes do SharePoint no SharePoint |
| OneDrive for Business | Uma biblioteca pessoal para armazenar e organizar documentos de trabalho que podem ser compartilhados em sua organização. | - O OneDrive for Business é diferente do OneDrive - O OneDrive for Business é diferente do seu site de equipe |
| Provisionamento remoto | Um modelo que provisiona sites usando modelos e códigos executados fora do SharePoint, em um suplemento hospedado em um provedor. | - Técnicas de provisionamento de site e provisionamento remoto no SharePoint 2013 - Provisionamento de sites de autoatendimento usando aplicativos para SharePoint 2013 |
| REST | Um estilo de arquitetura sem estados que remove os elementos da arquitetura e usa verbos HTTP para ler e gravar dados de páginas da Web que contêm arquivos XML. | Definir permissões personalizadas em uma lista usando a interface REST |
| Web raiz | A primeira web em um conjunto de sites. A web raiz também é, por vezes, conhecida como “Raiz do aplicativo Web”. | |
| Suplemento do SharePoint | (Anteriormente "aplicativo para o SharePoint") Aplicativos da web leves, que integram padrões e tecnologias populares da web para estender os recursos de um site do SharePoint usando o Modelo de Suplemento na Nuvem. | Suplementos do SharePoint |
| SharePoint Online | Oferta do SharePoint baseada em nuvem no Office 365. | Referência Geral do SharePoint Online |
| Site | Um grupo de sites que compartilham o mesmo proprietário e definições administrativas, como permissões. | T:Microsoft.SharePoint.Client.Web |
| Conjunto de sites | Um grupo de sites que compartilham as mesmas definições de proprietário e de administrador, como permissões. | Criar um conjunto de sites no Servidor do SharePoint |
| Provisionamento de site | Um processo para equipar sites com recursos, estrutura, marca e outras funcionalidades. | - Técnicas de provisionamento de site e provisionamento remoto no SharePoint 2013 - Provisionamento de sites de autoatendimento usando aplicativos para SharePoint 2013 |
| Subsite | Um único site do SharePoint em um conjunto de sites do SharePoint. Um subsite pode herdar a navegação e as permissões de um site pai, ou pode ter permissões e navegação exclusivas. É possível criar subsites baseados no conjunto de sites raiz, ou sites baseados em outros conjuntos de sites. Você pode optar por herdar as permissões do conjunto de sites ou especificar permissões exclusivas para o subsite. |
Hierarquia dos elementos estruturais
Conceitualmente, a hierarquia de objetos do SharePoint é expressa em termos de contêineres: os tipos de objetos e o tipo da hierarquia contêm todos os tipos de objetos sob eles na hierarquia. A Tabela 2 lista a hierarquia dos elementos estruturais do SharePoint.
Tabela 2. Hierarquia dos elementos estruturais do SharePoint
| Tipo de objeto (em ordem hierárquica) | Descrição |
|---|---|
| Aplicativos web | Os aplicativos existentes em um servidor e que respondem a solicitações de um navegador. Os aplicativos Web são a estrutura central dos Serviços de Informações da Internet (IIS). No SharePoint, um aplicativo web é um site com uma URL exclusiva e um banco de dados de conteúdo separado, armazenado no SQL Server. |
| Conjuntos de sites | Os contêineres de sites que definem as permissões e que podem definir alguns aspectos da identidade visual, dependendo das configurações, para todos os sites no contêiner. |
| Sites | Um conjunto de elementos de listas, bibliotecas, estrutura, navegação e aparência que geralmente são organizados em torno de um tema ou tópico central. Os sites filhos no mesmo conjunto de sites algumas vezes são chamados de subsites. Um subsite é um site armazenado em uma subpasta do site pai. Ele pode herdar as permissões e a estrutura de navegação do site pai, ou as permissões de criação e administração podem ser exclusivas. Subsites podem ter subsites filhos. |
| Bibliotecas de aplicativos, listas e documentos | Contêineres de conteúdo e dados organizados em estruturas específicas. A Galeria de Páginas Mestras é uma biblioteca especial de documentos nos sites de publicação do SharePoint 2010, onde todos os elementos de marca (páginas mestras, layouts de página, arquivos JavaScript, CSS e imagens) são armazenados por padrão. Cada site tem sua própria Galeria de Páginas Mestras. Em sites de equipe, a página mestra vem do site, não do conjunto de sites. |
| Itens | Partes individuais de conteúdo ou dados contidos em suplementos, listas e bibliotecas de documentos. |
Suplementos do SharePoint
Os Suplementos do SharePoint são soluções leves que não são instaladas no servidor host do SharePoint, o que significa que não fazem chamadas excessivas de API ao servidor host. Você pode criar Suplementos do SharePoint usando o Modelo de Suplemento na Nuvem. Os usuários podem descobrir e baixar suplementos do AppSource (anteriormente Office Store) ou do catálogo de aplicativos da empresa. Confira Visão geral dos Suplementos do SharePoint para obter mais informações.
Bancos de dados de sistema de arquivos e conteúdo
Para compreender as opções de identidade visual à sua disposição e as implicações que a personalização do site pode ter em uma atualização e em uma migração, é preciso compreender o sistema de arquivos e os bancos de dados de conteúdo do SharePoint, e como eles funcionam juntos.
Sistema de arquivos
O SharePoint armazena arquivos no sistema de arquivos ("hive").
No SharePoint Server 2013 e no SharePoint Server 2016, esse local é chamado de 15-hive ou 16-hive.
Este é o caminho para esse local:
SharePoint Server 2013: %program files%/Common Files/Microsoft Shared/Web Server Extensions/15/
SharePoint Server 2016: %program files%/Common Files/Microsoft Shared/Web Server Extensions/16/
O 15-hive e o 16-hive incluem diversas subpastas que armazenam os arquivos que você usará ao criar sua identidade visual e provisionar sites.
Bancos de dados de conteúdo
Os bancos de dados de conteúdo armazenam os objetos de conteúdo do SharePoint, como conjuntos de sites. Um banco de dados de conteúdo é instalado automaticamente para cada conjunto de sites quando você implanta o SharePoint Server 2013 ou SharePoint Server 2016. Todo o conteúdo de um conjunto de sites é armazenado em um banco de dados de conteúdo em um servidor. Entretanto, um banco de dados de conteúdo pode estar associado a mais de um conjunto de sites, e é possível vincular bancos de dados de conteúdo a um aplicativo web do SharePoint. Pode ser necessário mover o conteúdo de um banco de dados a outro, por exemplo quando o tamanho do conteúdo está prestes a exceder o tamanho do banco de dados.
Algumas características de um banco de dados de conteúdo variam dependendo de como o conjunto de sites é usado. Por exemplo, sites geralmente gravam muito conteúdo, enquanto outros tipos de conteúdo, como documentos somente leitura, são muito lidos. O uso do conteúdo afeta os aspectos do banco de dados de conteúdo, como o tamanho e o desempenho.
Estados de personalização de arquivos
O estado de arquivos e de conteúdo do SharePoint afeta a facilidade aplicar atualizações e controla se o SharePoint serve o arquivo a partir do banco de dados de conteúdo ou do sistema de arquivos. Por padrão, todos os arquivos do SharePoint não estão personalizados e têm arquivos fantasma; eles estão localizados em estados correspondentes no sistema de arquivos do SharePoint e no banco de dados de conteúdo. Quando um arquivo, uma entrada de banco de dados de conteúdo ou ambos são usados de formas específicas ou alterados, o estado do conteúdo pode ser afetado.
Tabela 3. Tabela 3. Estados de arquivos e conteúdos e seus efeitos na atualização
| Estado de arquivo ou de conteúdo | Definição | Comentário |
|---|---|---|
| uncustomized | Um atributo associado a um arquivo indicando que este não foi alterado. | Mais de uma cópia de um arquivo pode apontar para a mesma fonte. Isso faz com que seja mais fácil para os designers implementarem alterações. |
| personalizado | Um atributo associado a um arquivo indicando que este foi alterado. | Depois que um arquivo se torna personalizado, fica mais difícil aplicar atualizações amplas. Tome muito cuidado a respeito do que você personaliza. Como regra geral, é melhor usar os arquivos e recursos padrão do SharePoint do que personalizar arquivos do sistema ou introduzir personalizações que precisam ser manualmente atualizadas. |
| fantasma | Um arquivo com uma fonte é armazenado fora do banco de dados de conteúdo. | Há ainda um ponteiro no banco de dados de conteúdo (o fantasma do arquivo) que informa ao SharePoint para procurar pela fonte do arquivo no sistema de arquivos do servidor. |
| desconvertido de fantasma | Existe uma versão do arquivo de origem não personalizada no banco de dados conteúdo. | Exemplo: o Gerenciador design do SharePoint 2013 cria uma solução em área restrita para empacotar arquivos de identidade visual. Isso nunca é adicionado ao sistema de arquivos do servidor; portanto, por definição, seus arquivos são considerados desconvertidos de fantasmas. Mas os arquivos implantados ainda estão em um estado não personalizado. |
Observação
Se um arquivo tiver sido personalizado, ele não será atualizado quando você instalar novos service packs ou quando o serviço do SharePoint Online for atualizado.
Provisionamento de site e identidade visual com o Modelo de Suplemento na Nuvem
No Servidor do SharePoint 2013 ou no Servidor do SharePoint 2016, você pode usar o código CSOM personalizado nos Suplementos do SharePoint para provisionar conjuntos de sites, sites e subsites do SharePoint com elementos de identidade visual. Este padrão de provisionamento de site é chamado de provisionamento remoto. O SharePoint está cada vez mais concentrado em implantações baseadas na nuvem, então esse padrão foi criado para ajudá-lo a usar os recursos incorporados do SharePoint para provisionar a identidade visual do site de forma a reduzir as complexidades e os custos operacionais a longo prazo.
O que posso fazer com o Modelo de Suplemento na Nuvem?
Algumas vezes não há correlação entre os recursos do código de confiança total e o Modelo de Suplemento na Nuvem. Ao desenvolver uma personalização com base em SharePoint e no Modelo de Suplemento na Nuvem, considere uma abordagem alternativa, em vez de uma conversão direta, e tente manter as personalizações o mais simples possível. Aqui estão alguns exemplos:
- Substituir receptores de eventos por receptores de eventos remotos (consulte Criar um receptor de eventos remoto nos Suplementos do SharePoint).
- Substituir modelos de site, modelos Web e definições de site por provisionamento remoto. Isso funciona para subsites e conjuntos de sites.
- Substitua trabalhos de timer com o Microsoft Azure.
Algumas coisas, como módulos HTTP e manipuladores HTTP, não podem ser criados com o Modelo de Modelo de Suplemento na Nuvem. Antes de tentar replicar uma personalização existente no Modelo de Suplemento na Nuvem, considere primeiro por que essas personalizações foram criadas e se um recurso do SharePoint pronto para o uso pode funcionar.
Padrão de provisionamento remoto
O provisionamento remoto usa novos padrões de suplementos para mover por completo a lógica de provisionamento para fora do farm do SharePoint. Essa abordagem elimina a necessidade usar a estrutura de recursos ou outras personalizações no farm do SharePoint e, ao invés disso, possibilita controlar as personalizações de fora do SharePoint. Essa abordagem torna possível atualizar e alterar o mecanismo de provisionamento sem afetar a disponibilidade do SharePoint. Para obter mais informações sobre a estrutura de recursos, consulte Definições de Site e Provisionamento: a Estrutura de Recursos.
Os aspectos e a implementações do padrão de provisionamento remoto estão documentados em detalhes nesta seção. Pode ser útil começar pelas seguintes introduções ao padrão:
- Provisionamento de sites de autoatendimento usando aplicativos para SharePoint 2013
- Gravação de vídeo de apresentação de técnicas de provisionamento de site do SharePoint 2013
- Por que nós introduzimos o padrão de aplicativos do SharePoint?
Na implementação mais simples do padrão de provisionamento remoto, os requisitos de provisionamento são armazenados em um SQL Server, Banco de Dados SQL do Azure ou arquivo XML; um Suplemento do SharePoint, em seguida, lê os requisitos da fonte de dados, lê os elementos de identidade visual a partir de seu local de origem e aplica elementos de identidade visual ao site destino com base nos requisitos de provisionamento.
Os exemplos de código de identidade visual e provisionamento seguem essa sequência de eventos para mostrar o padrão de provisionamento remoto.
Tabela 4. Sequência básica de provisionamento remoto e exemplos associados
Observação
A Tabela 4 lista as etapas que podem ocorrer em um cenário de provisionamento remoto. Os exemplos que você usar dependem da abordagem que funciona melhor para sua empresa. Por exemplo, se você não tem uma necessidade comercial de criar um fluxo de trabalho de aprovação personalizado, não usará esse exemplo.
Exemplo de um fluxo de trabalho de provisionamento de site e criação de identidade visual usando o padrão de provisionamento remoto
Como o provisionamento remoto afeta o conteúdo do site pré-existente
Dependendo de quais elementos específicos do site você deseja provisionar, o seu código substituirá o conteúdo do site padrão ou pré-existente por um vínculo ao Suplemento do SharePoint de provisionamento remoto. O suplemento selecionará modelos de site e outros recursos com base nos requisitos de provisionamento armazenados no banco de dados, sem configurar nada no SharePoint.
O padrão básico de provisionamento remoto é o mesmo, independentemente dos requisitos adicionais. Entretanto, quando planejar usar esse padrão para provisionar a identidade visual de um site, mapeie sua estratégia desenvolvimento de identidade visual de acordo com o contexto dos recursos de personalização que as APIs REST, o CSOM e o JSOM do SharePoint oferecem (os exemplos de código descritos nesta seção usam o CSOM). Considere também:
- Arquitetura do site. Você está criando um site voltado para a Internet, um site de Intranet ou uma Extranet que requer que os usuários autorizados entrem através do site voltado para a Internet, a fim de acessarem os dados da empresa?
- O grau de controle que os usuários específicos têm para definir e solicitar requisitos de provisionamento. Esses usuários devem poder especificar opções personalizadas de provisionamento usando um formulário? As alterações são aplicadas ao site automaticamente, apenas após as pessoas com poder de decisão aprovarem as alterações ou serão gerenciadas por uma política de administração?
- Os tipos de personalizações de identidade visual que deseja aplicar (estruturais, aparência ou ambos).
Exemplos de código de provisionamento de site e de identidade visual
Os exemplos de código descritos nesta seção mostram o cenário principal e o ampliam para abranger casos de uso mais específicos. Os artigos desta seção também contêm alguns exemplos de código. As tabelas a seguir listam e descrevem os exemplos.
Tabela 5. Exemplos de provisionamento de site
| Amostra | Descrição | Artigo relacionado |
|---|---|---|
| Provisionamento em lote | Provisiona de conjuntos de sites em um aplicativo de console. | Soluções de provisionamento do site do SharePoint |
| Provisioning.Pages | Mostra como usar o modelo de provisionamento remoto para provisionar uma página wiki e adicionar web parts e HTML remotos a partir da página wiki. | Páginas do SharePoint e o modelo de página |
| SiteProvisioningWorkflow | Provisiona conjuntos de sites com um fluxo de trabalho no webhost e um receptor de eventos remoto. | Soluções de provisionamento do site do SharePoint |
| SiteProvisioningWorkflowAppWeb | Provisiona conjuntos de sites com um fluxo de trabalho no suplemento web e um receptor de eventos remoto. | Soluções de provisionamento do site do SharePoint |
Observação
Os exemplos BatchProvisioning, SiteProvisioningWorkflow e SiteProvisioningWorkflowAppWeb demonstram os conceitos e as funções principais do padrão de provisionamento remoto. O exemplo ProvisionWikiPages trata de um caso de uso específico (provisionamento de uma página wiki).
Tabela 6. Exemplos de identidade visual
| Amostra | Descrição | Artigo relacionado |
|---|---|---|
| Branding.Theme | Mostra como aplicar um tema (CSOM). | Identidade Visual de site do SharePoint e soluções de personalização de página |
| OD4B.Configuration.Async | Mostra como usar o modelo de provisionamento remoto para provisionar uma página wiki e adicionar web parts e HTML remotos a partir da página wiki. | Identidade Visual de site do SharePoint e soluções de personalização de página |
| Branding.AlternateCSSAndSiteLogo | Mostra como definir CSS personalizado para o site host usando uma ação do cliente do usuário e o JavaScript incorporado (CSOM). | Identidade Visual de site do SharePoint e soluções de personalização de página |
| Provisioning.OnPrem.Async | Mostra como usar um serviço para encapsular todas as informações no host da web do SharePoint para o Local | Soluções de provisionamento do site do SharePoint |
| Provisioning.SiteCol.OnPrem | Mostra como usar um serviço para encapsular todas as informações no host da web do SharePoint para o suplemento web, obter uma web, obter uma lista de conjuntos de sites em um aplicativo web especificado e criar um tipo de conteúdo com um ContentTypeId específico. Este exemplo é especialmente útil quando se deseja usar o padrão de provisionamento remoto para provisionar sites usando suplementos do SharePoint, mas o membro CSOM necessário para concluir seu cenário ainda não está disponível no CSOM. |
Soluções de provisionamento do site do SharePoint |
Fluxo de trabalho de identidade visual do SharePoint
Criar a identidade visual de um site do SharePoint é bastante parecido com fazê-lo para outros sites. Você usa tecnologias da web conhecidas, como HTML, CSS e JavaScript, para criar a estrutura, a aparência e o comportamento personalizado de seus sites. O SharePoint é também baseado em ASP.NET e usa um modelo de página muito similar ao modelo de página mestra/layout de página do ASP.NET. O modelo de página engloba a estrutura e fornece ganchos e lógica para aplicar elementos de aparência.
O SharePoint fornece várias web parts que você pode usar para incorporar exibições de dados, imagens, scripts, resultados de pesquisa e muito mais no design do seu site. As aparências compostas oferecem uma maneira fácil para os usuários personalizarem a aparências de seus sites, e reforçam o controle do designer e do departamento de TI sobre os detalhes design e as opções de aparência disponíveis. O mecanismo de tema e os recursos personalizados de CSS possibilitam personalizar ainda mais a identidade visual.
O fluxo de trabalho de design e desenvolvimento da identidade visual para sites do SharePoint assemelha-se bastante ao fluxo de trabalho de design que o mercado usa:
- Planejar a arquitetura e o design de seu site.
- Criar ativos de design usando ferramentas e tecnologias Web conhecidas.
- Criar o site usando ferramentas do SharePoint, como o Gerenciador design.
- Empacotar o design de seu site e usar os Suplementos do SharePoint e o padrão de provisionamento remoto para provisionar a identidade visual do site.
Observação
Aplicar a identidade visual no SharePoint significa alterar a aparência do site padrão do SharePoint. Isso pode incluir fazer alterações estruturais e cosméticas à aparência do site.
Custo e complexidade da identidade visual
As alterações de identidade visual vão das mais simples e baratas a mais caras e complexas. Através da interface de usuário, os usuários podem aplicar aparências compostas, que incluem uma imagem de plano de fundo, paleta de cores, fontes e uma página mestra associada a esses elementos, e um arquivo de visualização associado à página mestra. Você pode usar o mecanismo de temas do SharePoint para criar seus próprios temas, e pode criar CSSs personalizados para alterar a aparência do site.
Importante
Apesar de ser possível criar páginas mestras e outros elementos estruturais personalizados como parte de um projeto de personalização de identidade visual, o custo de suporte a longo prazo para personalizações estruturais pode ser alto, e pode ser ainda mais custoso à sua organização aplicar atualizações e suportar a longo prazo o propósito dos investimentos de curto prazo em personalização.
Identidade visual de sites do SharePoint hospedados localmente ou em um farm dedicado
Você pode usar o padrão de provisionamento remoto para criar a identidade visual de sites de equipe, sites de publicação e sites do OneDrive for Business hospedados localmente ou em um farm dedicado, tanto no nível do conjunto de sites, quanto no nível de subsites.
SharePoint Online
Parte do planejamento de um projeto de identidade visual do SharePoint é decidir que tipos de sites você deseja criar, personalizar e provisionar. O licenciamento do SharePoint afeta o fato de os recursos do site de publicação estarem disponíveis ou não para você. Nem todas as licenças oferecem recursos completos do site de publicação.
Tabela 7. Opções de site no SharePoint Online
| Edição Office 365 | Site de equipe | Site de publicação | Observações |
|---|---|---|---|
| Pequena empresa | Sim | Não | |
| Corporativo | Sim | Sim | Inclui um conjunto de sites de equipe no aplicativo web raiz para o domínio que não contém o site de publicação, e é possível criar novos conjuntos de sites de publicação neste aplicativo web raiz. |
Para obter mais informações, consulte Selecionar um plano do Office 365 para empresas e Modelo: Design e identidade visual no SharePoint 2013.
Quando devo personalizar?
A maioria dos recursos de que você precisa para atender às necessidades de sua empresa está incorporada ao SharePoint. Assim, antes de criar uma personalização, determine se há um caso de negócios real para criar a personalização, e quais seriam os custos a longo prazo para a empresa para criar e oferecer suporte a essa personalização. Como os recursos e funcionalidades são disponibilizados aos usuários? Considere primeiramente as metas de negócios e a experiência do usuário, ao invés da tecnologia.
Ao trabalhar com uma solução de personalização do SharePoint existente e pensar como e se você deve migrá-la para o Modelo de Suplemento na Nuvem, compreenda primeiro por que a personalização foi criada e qual é seu propósito.
Ao considerar mover uma personalização existente do código de confiança total para o Modelo de Suplemento na Nuvem, geralmente não há um relacionamento total entre os recursos e funcionalidades. Em vez de tentar encontrar uma correspondência exata entre o código do lado do servidor e o lado do cliente, considere abordagens alternativas. A Tabela 8 mapeia alguns conceitos e recursos comumente usados de soluções do SharePoint em relação a seus equivalentes nos Suplementos do SharePoint.
Tabela 8. Mapeamento de conceitos do SharePoint para suplementos
| Tarefa | Na solução do SharePoint | Em Suplementos do SharePoint | Orientação |
|---|---|---|---|
| Exibir informações em páginas do SharePoint | Web Parts | Partes de aplicativo | As web parts são executadas no Servidor do SharePoint com privilégios de permissão de usuário ou de permissão total/elevada. As partes de aplicativo são executadas no navegador ou em um servidor externo com uma identidade de aplicativo que contém permissões especificamente concedidas. São completamente isoladas no cliente em seu próprio domínio. As partes de suplementos são executadas fora do SharePoint e não causam impacto no desempenho do Servidor do SharePoint. Criar partes de suplementos para instalação com o seu suplemento do SharePoint |
| Criar e gerenciar notificações | Receptores de eventos e de recursos | Receptores de eventos remotos e receptores de eventos de suplementos | Os receptores de eventos e os receptores de recursos requerem código do lado do servidor e não podem notificar sistemas externos de eventos.
Os receptores de eventos remotos usam código do lado do cliente, podem ser usados em soluções do SharePoint ou dos Suplementos do SharePoint e podem notificar sistemas externos de eventos. Os receptores de eventos de aplicativos executam código quando os suplementos são instalados, desinstalados ou atualizados. - Lidar com eventos nos suplementos do SharePoint - Criar um receptor de eventos remotos em Suplementos do SharePoint |
| Dados do Access | Modelo de objeto do servidor (SSOM) .NET, modelo de objeto do cliente (CSOM) .NET e OData | Modelo de objeto de cliente .NET (CSOM, JSOM), OData, REST, bibliotecas de domínio cruzado | - Realizar operações básicas usando o código de biblioteca cliente do SharePoint - Como concluir operações básicas usando código da biblioteca do JavaScript no SharePoint - Conheça o serviço REST do SharePoint. - Índice do Servidor .NET do SharePoint, CSOM, JSOM e API REST |
| Empacotar e implantar | Pacotes de soluções (WSPs, pacotes de recursos) | Catálogo de aplicativos e AppSource (Office Store) | Pacotes de soluções são difíceis de implantar em um farm do SharePoint.
Você pode publicar um Suplemento do SharePoint no AppSource se quiser disponibilizá-lo publicamente ou vendê-lo. Use o catálogo de suplementos para disponibilizar um Suplemento do SharePoint em sua organização. Orientações e exemplos de códigos no pacote de soluções demonstram como usar os Suplementos do SharePoint para provisionar elementos de identidade visual em seu site do SharePoint. - Usar o catálogo de aplicativos do conjunto de sites - Disponibilizar suas soluções no AppSource e no Office - Escolher padrões para desenvolver e hospedar seu suplemento do SharePoint |
| Usar dados externos | Tipos de conteúdo externos | Tipos de conteúdo externo para aplicativos | Os administradores de site do SharePoint ou os usuários do SharePoint Designer devem criar e/ou instalar tipos de conteúdo externo, que podem ser instalados apenas no nível do farm.
Tipos de conteúdo externo para aplicativos aplicam-se somente ao Suplemento do SharePoint para o qual foram criados, não requerem administração e podem acessar fontes OData. - Adicionar no escopo tipos de conteúdo externo no SharePoint - Criar um tipo de documento externo de uma fonte de OData no SharePoint |
| Adicionar páginas personalizadas e páginas mestras | Páginas de aplicativos e de sites | Páginas hospedadas na Web | As páginas de aplicativos são compartilhadas por todos os sites no servidor e são hospedadas no SharePoint.
Páginas de site são hospedadas pelo SharePoint e requerem que os controles da página estejam listados em uma lista de controles segura. Embora as páginas de aplicativos sejam ideais para código personalizado, o código personalizado nas páginas do site será interrompido após a personalização. Em vez disso, use páginas hospedadas na web. Eles são projetados para serem personalizáveis, suportam o uso de web parts embutidas nas páginas do site, são hospedados externamente e estão disponíveis em qualquer lugar em que o suplemento estiver instalado. |