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

Atualizado em: 2009-03-05

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 seguir as seguintes etapas para garantir que cada lista e página derivadas de suas definições de site personalizadas continuem funcionando depois da atualização.

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 definição de site personalizada antiga para a nova definição, assim, cada elemento do site (por exemplo, uma página personalizada) poderá ser atualizado para o novo elemento apropriado.

3. Crie arquivos de definição de atualização de modelo de página No Microsoft Office SharePoint Portal Server 2003, você também precisa criar arquivos de definição de atualização para converter os modelos de página, como o modelo de home page em novos layouts de página. Os layouts de página no Microsoft Office SharePoint Server 2007 substituem os modelos de página no SharePoint Portal Server 2003, e você precisa especificar qual layout de página deve ser usado para cada tipo de página. Para obter mais informações sobre layouts de páginas, consulte Planejar páginas da Web.

Durante o processo de pré-atualização, você copia a nova definição de site personalizada e qualquer arquivo de definição de atualização para o diretório de instalação, de forma que 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 iniciando com 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, a diferença é que ele 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. Crie uma nova versão do arquivo webtempnome.xml para cada definição de site personalizada que você tiver no SharePoint Portal Server 2003, em que nome é o nome da definição do site. Você pode criar arquivos webtempnome.xml a partir dos arquivos com as definições de site padrão fornecidas com o novo produto (ambiente).

3. Após concluir com êxito o processo de atualização, copie os modelos de página usados no SharePoint Portal Server 2003 para a pasta da galeria de páginas mestras na raiz de um conjunto de sites atualizado. Para obter mais informações, consulte Planejar páginas da Web.

   Além disso, crie layouts de página usando as páginas de aterrissagem personalizadas correspondentes do SharePoint Portal Server 2003 no estado em que se encontram. Antes de atualizar, salve uma cópia das páginas de aterrissagem personalizadas. Após concluir com êxito o processo de atualização, carregue essas páginas de layout na pasta da galeria de páginas mestras na raiz de um conjunto de sites.

4. 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 que possam transformar seus sites antigos em equivalentes novos que se beneficiem de todas as melhorias que o novo ambiente tem a oferecer.

No Microsoft Office SharePoint Server 2007, há arquivos de definição de atualização para modelos de página específicos. Um modelo de página é um arquivo ASPX que define a estrutura de uma página. A vantagem dos modelos de página é que você pode criar novas páginas com base no modelo de página, em vez de criar as páginas em um editor de páginas da Web que seja compatível com o Office SharePoint Server 2007. Os modelos de página são armazenados na raiz do conjunto de sites e são compartilhados no conjunto de sites.

No Office SharePoint Server 2007, os modelos de página são usados para a maioria das páginas no site do portal. Em outras palavras, todas as novas definições de site para o Office SharePoint Server 2007 incluem modelos de página, e muitas páginas do portal que eram baseadas na definição de site do portal padrão no produto (ambiente) anterior são baseadas em diferentes layouts de página no novo produto. O processo de atualização move as páginas do portal do produto anterior para as páginas que usam layouts de página no novo produto. Os modelos de página do produto anterior são movidos para o conjunto padrão de layouts de página fornecido com o novo produto. Se o conjunto padrão de layouts de página não se adequar às suas necessidades, você poderá criar um conjunto personalizado e fornecer um arquivo de definição de atualização para mapear as páginas de portal antigas para os novos layouts de página.

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.

O seguinte exemplo, tirado de um dos arquivos instalados no Office SharePoint Server 2007, descreve o formato de um arquivo de definição de atualização de modelo de página.

<SPSSiteUpgraderConfig>
    <PublishingPageLayoutMappings>
        <PublishingPageLayoutMapping WebTemplateId="20" PublishingPageLayout="/_catalogs/masterpage/defaultlayout.aspx"/>
        <PublishingPageLayoutMapping WebTemplateId="22" PublishingPageLayout="/_catalogs/masterpage/welcomelayout2.aspx"/>
    </PublishingPageLayoutMappings>
</SPSSiteUpgraderConfig>

Nesse exemplo, você pode ver que um modelo de site mapeia para um modelo de página. Em outras palavras, o modelo de site com ID=20 mapeia para o layout de página defaultlayout.aspx. Isso significa que cada site que usa o modelo com ID 20 terá uma home page (geralmente, default.aspx) utilizando um layout de página definido por defaultlayout.aspx.

Certifique-se de incluir entradas no arquivo de definição de atualização do modelo de página para as páginas de aterrissagem personalizadas do SharePoint Portal Server 2003 que você usará para layouts de página no Office SharePoint Server 2007. Essas entradas definem uma ID do modelo de site como o nome da página de aterrissagem do SharePoint Portal Server 2003 que você usará como layouts de página.

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".

Os 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 (Office SharePoint Server). Para obter informações adicionais sobre a criação de arquivos de definição de atualização, como o que incluir nos arquivos e no esquema, consulte Atualizando personalizações do SharePoint Portal Server 2003 para o SharePoint Server 2007 (em inglês) (https://go.microsoft.com/fwlink/?linkid=105294\&clcid=0x416) (em inglês) na Biblioteca 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 de arquivos de modelos e mapeamentos 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:

• Atualização para o Office SharePoint Server 2007 (em inglês)

Consulte a lista completa de manuais disponíveis na página de download de manuais do Office SharePoint Server 2007.