Share via


Atualizar os componentes do host da Web no SharePoint

Antes de começar, familiarize-se com os suplementos do SharePoint e os pré-requisitos e os conceitos principais listados nele.

Seu suplemento pode instalar dois tipos de componentes em uma Web host com marcação descritiva no Suplemento do SharePoint: ações personalizadas e partes de suplemento. Atualizar esses componentes é mais fácil na Web do host do que na Web de suplemento. Você não precisa de nenhuma semântica de atualização. Basta adicionar/alterar as ações personalizadas e as partes de suplemento. Quando o Suplemento do SharePoint é atualizado, o SharePoint sempre aplica arquivos de manifesto de elemento novo e reaplica todos os arquivos de manifesto de elemento alterados com a versão mais recente. Nenhum dano é feito na reaplicação; por exemplo, um botão de faixa de opções para uma ação personalizada não será adicionado várias vezes à faixa de opções.

Quando você atualiza uma parte de suplemento, o SharePoint substitui a versão antiga pela nova versão na Galeria de Web Part. Certifique-se de alterar a propriedade Name do objeto ClientWebPart ao atualizar uma parte do suplemento. Fazer isso garante que, quando o suplemento for atualizado, o SharePoint removerá a versão antiga da parte de suplemento (que não faz mais parte do aplicativo) de todas as páginas às quais ele foi adicionado. Os usuários precisarão adicionar novamente a nova versão às páginas.

Se você deixar a propriedade Name inalterada, a versão antiga permanecerá nas páginas em que ela foi adicionada, o que torna improvável que os usuários estejam cientes de que uma nova versão da parte de suplemento está disponível. Além disso, quando a parte de suplemento é adicionada a outras páginas, ela é a nova versão que é adicionada, portanto, a mesma versão de um Suplemento do SharePoint teria partes de suplemento diferentes em páginas diferentes.

Você pode implantar outros tipos de componentes Web do host programaticamente usando um receptor de eventos remoto que você registra no manifesto de suplemento com um elemento InstalledEventEndpoint . Você deve usar um receptor UpgradedEventEndpoint para atualizar componentes que foram originalmente implantados com um receptor InstalledEventEndpoint . Os receptores UpgradedEventEndpoint são descritos em Criar um manipulador para o evento de atualização nos Suplementos do SharePoint.

Próximas etapas

Vá para As principais etapas na atualização de um suplemento ou vá diretamente para um dos artigos a seguir para saber como atualizar o próximo componente principal do suplemento do SharePoint.

Confira também