Implantação e instalação de suplementos do SharePoint: métodos e opções
Neste artigo você aprenderá mais sobre as opções para publicar, instalar e desinstalar o seu Suplemento do SharePoint.
Publicação na Office Store ou no catálogo de suplemento da organização
Você pode carregar seu Suplemento do SharePoint na Store Office pública ou no catálogo de suplementos particular de uma organização. Um catálogo de suplementos particular é um conjunto de sites dedicado em um aplicativo Web do SharePoint (ou em um locatário do SharePoint Online) que hospeda bibliotecas de documentos para suplementos do SharePoint e do Office. Colocar o catálogo em seu próprio conjunto de sites facilita para o administrador de aplicativos Web ou o administrador de locatários limitar as permissões do catálogo.
Se o suplemento for carregado na Office Store, a Microsoft executará algumas verificações de validação nele. Por exemplo, ela verifica se a marcação do manifesto do suplemento é válida e completa e verifica se os pacotes de solução do SharePoint (arquivos .wsp) incluem elementos não permitidos ou recursos com escopo mais amplo do que um escopo Web. O pacote também é inspecionado para verificar se há conteúdo impróprio. Se for aprovado em todos os testes, o pacote do suplemento é empacotado em um arquivo e assinado pela Microsoft.
Observação
Quando você estiver desenvolvendo o suplemento e o implantando com o Microsoft Office Developer Tools para Visual Studio, o suplemento será diretamente instalado no site do SharePoint para teste de destino. Como não passa pela Office Store, a verificação de validação descrita acima não ocorre.
Carregar um Suplemento do SharePoint no catálogo de suplementos da organização é tão fácil como carregar um arquivo para uma biblioteca de documentos do SharePoint Foundation. Preencha um formulário pop-up em que você fornece a URL local do pacote do suplemento e outras informações, como o nome. Quando o suplemento é carregado para o catálogo de suplementos de uma organização, verificações semelhantes ocorrem e os suplementos que não passam são marcados como inválidos ou desabilitados no catálogo.
Os administradores de locatários e de aplicativos Web do SharePoint podem comprar Suplementos do SharePoint na Office Store. Para abrir a Office Store, o administrador seleciona Adicionar um Suplemento na página Conteúdo do Site e seleciona SharePoint Store na página Seus Suplementos. Isso abre uma página da SharePoint Store, que os administradores podem usar para descobrir e saber mais sobre os suplementos do SharePoint que os fornecedores oferecem (o que eles também podem fazer no office.com).
Suplementos que exigem algum pré-requisito que não esteja instalado no aplicativo Web do administrador ou do locatário aparecem esmaecidos e ficam indisponíveis na loja de suplementos. Por exemplo, se um suplemento exigir os Serviços de Pesquisa que não estejam instalados, o suplemento aparecerá esmaecido. Os administradores podem classificar, filtrar e navegar pela lista de suplementos, ler suas descrições, consultar suas avaliações e comprar licenças para um suplemento.
Quando um administrador decide adquirir uma licença, deve aceitar os termos e as condições da compra e concordar com as permissões que o suplemento deve ter para executar, como acesso de leitura a listas ou acesso de controle total para o conjunto de sites.
Quando uma ou mais licenças de um suplemento são compradas, as licenças são baixadas para o aplicativo Web ou para um locatário. O suplemento não é baixado e instalado automaticamente quando a licença é comprada, embora os administradores tenham a opção de combinar a instalação com a compra das licenças.
Os usuários instalam os suplementos na página Seus Suplementos. Esta página tem uma lista mesclada do seguinte:
- Suplementos do SharePoint do catálogo de suplementos da organização do aplicativo da Web (ou do locatário).
- Os suplementos do SharePoint da Office Store para os quais a organização ou locatário já têm uma licença de site ou uma licença que foi atribuída ao usuário.
Todos os suplementos que o usuário pode instalar imediatamente são listados. Os usuários podem filtrar suplementos incluídos na página para incluir somente suplementos no catálogo de suplementos da organização. Quando um suplemento está instalado, é exibido na lista de suplementos na página Conteúdo do Site no qual ele está instalado.
Como instalar Suplementos do SharePoint
Os proprietários de sites instalam Suplementos do SharePoint na página Seus Suplementos, como descrito anteriormente neste tópico. A instalação cria uma instância do suplemento. Saiba mais sobre como instalar suplementos em Adicionar Suplementos do SharePoint a um site do SharePoint.
Observação
Às vezes, uma perda temporária de conexão de rede pode bloquear a instalação. Se houver falha na instalação por qualquer motivo, a infraestrutura de instalação tentará novamente por três vezes. Se não tiver sucesso, uma indicação da falha aparecerá na interface de usuário. Mais tarde os usuários podem tentar novamente executar a instalação.
Desinstalando Suplementos do SharePoint
Proprietários de sites podem desinstalar a instância de um Suplemento do SharePoint pela interface do usuário do SharePoint. A desinstalação da instância de um Suplemento do SharePoint é limpa. Ou seja, tudo que foi instalado pelo suplemento será desinstalado.
No entanto, não serão removidos os componentes que um suplemento usa, mas que foram instalados separadamente da instalação do suplemento. Por exemplo, suponha que um suplemento tem uma página da Web remota com os botões que criam listas no host da Web. A desinstalação do suplemento remove o bloco do suplemento da página Conteúdo do Site que, por sua vez, torna a página remota efetivamente inacessível ou inutilizável para usuários finais, mas não remove as listas criadas com o suplemento. O SharePoint não mantém um registro de quais listas no host da Web foram criadas com o suplemento e quais foram criados por usuários na interface do usuário do SharePoint; portanto, não é possível excluir listas criadas com o suplemento. Esse geralmente é um comportamento desejável porque as listas podem ter dados que permanecem úteis aos usuários, mesmo após a remoção do suplemento que criou as listas.
Se o Suplemento do SharePoint incluir um site de suplemento, ele será excluído. Isso fornece uma desinstalação mais limpa do que sistematicamente desativar recursos e reverter a implantação do arquivo .wsp interno do suplemento.
Observação
Quando um usuário remove um suplemento, ele é movido para a Lixeira de primeira estágio. Excluí-lo dali o moverá para a Lixeira de segundo estágio. Se for excluído da Lixeira de segundo estágio, será completamente desinstalado e não poderá ser restaurado.
As permissões do suplemento também são revogadas quando ele é removido (reciclado), de acordo com estas regras:
- As permissões de seu escopo Web sempre são revogadas.
- Se não houver outra instância do suplemento no conjunto de sites, as permissões do escopo do conjunto do site também serão revogadas.
- Se não houver outra instância do suplemento na assinatura do site (locatário), as permissões do escopo do locatário também serão revogadas.
O serviço da Web UninstallingEventEndpoint, se algum estiver registrado no manifesto do suplemento, é executado no início do processo de desinstalação (que ocorre quando o suplemento é removido da Lixeira de segundo estágio ). É uma prática recomendada ter um serviço da Web UninstallingEventEndpoint se você tiver um serviço da Web InstalledEventEndpoint e para projetar o serviço UninstallingEventEndpoint para reverter o que for feito no serviço InstalledEventEndpoint. Para saber mais, confira Lidar com eventos nos Suplementos do SharePoint.