Desenvolver novas definições de site personalizadas e criar arquivos de definição de atualização (Windows SharePoint Services)

  • Artigo

Atualizado em: 2008-02-12

Neste artigo:

  • Antes de desenvolver novas definições personalizadas para o site

  • Desenvolver novas definições de site personalizadas

  • Sobre arquivos de definição de atualização

  • Criar arquivos de definição de atualização

  • Gravar as informações do arquivo de definição de atualização em uma planilha

Antes de desenvolver novas definições personalizadas para o site

Antes de atualizar sites com base em definições personalizadas, você deve realizar as seguintes etapas para garantir que as listas e páginas derivadas de suas definições de site personalizadas continuem funcionando após a atualização.

Dica

Se não estiver pronto para atualizar os sites com base em uma definição personalizada (por exemplo, se tiver obtido a definição do site de um provedor de soluções e uma nova versão dessa definição ainda não estiver disponível), você poderá usar uma atualização gradual para atualizar outros sites e deixar os sites com base na definição de site personalizada anterior funcionando no ambiente mais antigo. Posteriormente, quando tiver uma nova definição de site personalizada, você poderá criar o arquivo de definição de atualização e atualizar apenas os sites que se baseiam na nova definição de site personalizada.

  1. **Obtenha ou desenvolva novas definições de site personalizadas e elementos personalizados   **Se desejar manter a funcionalidade dos sites baseados em uma definição de site personalizada, você precisará de uma nova definição de site personalizada que inclua todas as funcionalidades necessárias, além dos novos recursos que você deseja usar. Se você tiver obtido uma definição de site personalizada ou elementos personalizados de um provedor de soluções, verifique se o provedor tem uma nova versão. Caso o seu provedor de soluções não forneça uma nova versão, talvez seja necessário desenvolver uma própria.

  2. **Crie um arquivo de definição de atualização de site   **Você também precisa criar um arquivo que mapeie os elementos personalizados da sua antiga definição de site personalizada para a nova definição de site personalizada, de tal modo que cada elemento do site (por exemplo, uma página personalizada) possa ser atualizada para o novo elemento apropriado.

Durante o processo de pré-atualização, você copia a nova definição de site personalizada e os arquivos de definição de atualização para o diretório de instalação, de modo que eles fiquem disponíveis quando os conjuntos de sites forem atualizados.

Desenvolver novas definições de site personalizadas

Use esse processo para criar definições de site personalizadas em um ambiente de desenvolvimento. Para obter mais informações, consulte o Software Development Kit (SDK) do Windows SharePoint Services no MSDN.

  1. Crie definições de site personalizadas com base em uma definição de site fornecida com o novo ambiente.

    • Definições de site são armazenadas na seguinte pasta:

      %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\TEMPLATE\SiteTemplates\NOME

      Em que NOME corresponde ao nome da definição do site (por exemplo, ACTION). Crie uma pasta para sua nova definição de site e nomeie a nova pasta com letras maiúsculas.

    • Os arquivos XML usados para registrar os modelos do site são armazenados no seguinte local:

      %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\TEMPLATE\LCID\XML\webtempnome.xml

      Em que nome corresponde ao nome da definição de site, exceto aquele que está em letras minúsculas (por exemplo, action), e LCID é o identificador de localidade para o idioma do modelo (por exemplo, 1033 para Inglês - Estados Unidos).

  2. Teste as suas definições de site no ambiente de desenvolvimento criando um novo site baseado na definição do site.

Depois de criar e testar suas novas definições de site, você poderá criar os arquivos de definição de atualização que mapeiam as definições de site anteriores para as novas definições de site.

Sobre arquivos de definição de atualização

Um arquivo de definição de atualização descreve como mapear uma definição de site personalizada anterior para uma nova. O objetivo de um arquivo de definição de atualização de site é oferecer aos desenvolvedores uma ferramenta para transformar seus sites antigos em equivalentes novos que se beneficiem de todos os avanços que o novo ambiente tem a oferecer.

Um arquivo de definição de atualização para a definição de um site contém as seguintes seções:

  • **WebTemplate   **Especifica as informações de atualização para o modelo da Web como um todo. Nessa seção, você precisa de uma marca WebTemplate por arquivo de definição de atualização.

  • **Listas   **Especifica informações de atualização para cada lista ou biblioteca no modelo. Na seção Listas, você precisa de uma marca de Lista por lista ou biblioteca.

  • **Arquivos   **Especifica informações de atualização para as páginas individuais do modelo. Na seção Arquivos, você precisa de uma marca de Arquivo para cada página fantasma (não personalizada) do modelo.

  • **AppliedSiteFeature   **Especifica informações de atualização para qualquer recurso no nível de conjunto de sites ou no nível de subsite incluído no modelo. Nas seções AppliedSiteFeature e AppliedWebFeature, você precisa de uma marca de Recurso para cada recurso desse nível no modelo.

  • **AppliedWebFeature   **Especifica informações de atualização para os recursos no nível de subsite incluídos no modelo. Na seção AppliedWebFeature, você precisa de uma marca de Recurso para cada recurso desse nível no modelo.

Criar arquivos de definição de atualização

Defina um nome exclusivo para o arquivo de definição de atualização começando com o nome da definição do site. Por exemplo, uma definição de site chamada "STS1" gera um arquivo de definição de atualização com o nome "STS1_upgrade.xml".

Arquivos de definição de atualização devem ser instalados na seguinte pasta:

%COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\Config\Upgrade

Para obter mais informações sobre como criar arquivos de definição de atualização, incluindo um exemplo de arquivo de definição de atualização, consulte os tópicos Arquivos de definição de atualização (https://go.microsoft.com/fwlink/?linkid=109945\&clcid=0x416) e Esquema de definição de atualização (https://go.microsoft.com/fwlink/?linkid=109946\&clcid=0x416) no SDK do Windows SharePoint Services 3.0 no MSDN.

Para obter mais informações sobre como implantar arquivos de definição de atualização e novas definições de site, consulte Implantar arquivos de definição de atualização e novas definições de site (Windows SharePoint Services). Para obter informações adicionais sobre como criar arquivos de definição de atualização, como o que incluir nos arquivos e no esquema, consulte Atualizando o Windows SharePoint Services (https://go.microsoft.com/fwlink/?linkid=98404\&clcid=0x416) no SDK do Windows SharePoint Services 3.0 no MSDN.

Gravar as informações do arquivo de definição de atualização em uma planilha

Grave os nomes dos arquivos e os caminhos para cada arquivo de definição de atualização que você precisa criar na planilha Arquivos de modelos e mapeamento personalizados (https://go.microsoft.com/fwlink/?linkid=73751\&clcid=0x416).

Baixar este manual

Este tópico está incluído no seguinte manual, que pode ser baixado para facilitar a leitura e a impressão:

Consulte a lista completa de manuais disponíveis na página de download de manuais do Windows SharePoint Services.