Componentes do pacote de soluções
Atualizado em: 2008-01-17
Neste artigo:
Elemento Solution
Elemento FeatureManifest
Elemento Assembly
Elemento ApplicationResourceFile
Elemento CodeAccessSecurity
Elemento DwpFile
Elemento Resource
Elemento SiteDefinitionManifest
Elemento RootFile
Elemento TemplateFile
Este artigo trata da estrutura dos pacotes de soluções e fornece uma descrição do esquema de solução e dos elementos usados em um pacote de solução.
Um pacote de soluções é o pacote de distribuição que entrega o trabalho de desenvolvimento personalizado do Office SharePoint Server 2007 e do Windows SharePoint Services 3.0 para os servidores Web (e possivelmente para os servidores de aplicativos) em seu farm de servidores. Os componentes que podem ser distribuídos em um pacote de soluções são:
Assemblies do .NET Framework que envolvem o código que orienta a solução.
Arquivos de implantação, como arquivos de recursos, imagens ou outros arquivos auxiliares.
Muitas soluções envolvem a entrega de novos modelos e definições para sites, listas, bibliotecas, campos, tipos de conteúdo e muito mais. Essas definições estão na forma de arquivos XML baseados em CAML.
Configurações que devem ser executadas no nível do servidor Web — por exemplo, os arquivos Web.config para o registro de Web Parts.
Além disso, você precisa incluir o arquivo de manifesto para auxiliar o Office SharePoint Server 2007 no processo de implantação do pacote de soluções. O arquivo de manifesto contém a lista de todos os ativos incluídos em um pacote de soluções, juntamente com os locais de destino desses ativos e as várias configurações em que devem ocorrer. A definição do esquema do arquivo de manifesto está incluída no arquivo Wss.xsd localizado na pasta de sistema do Office SharePoint Server 2007.
Para obter mais informações sobre o pacote de soluções, consulte o artigo sobre pacotes de Web Parts e soluções (https://go.microsoft.com/fwlink/?linkid=106479\&clcid=0x416) no Software Development Kit (SDK) do Windows SharePoint Services 3.0 no MSDN.
Cada uma das seções a seguir descreve o elemento de um arquivo de pacote de soluções.
Elemento Solution
O elemento Solution é o elemento raiz do arquivo de manifesto. O atributo SolutionId é um elemento importante do arquivo que identifica a solução no armazenamento de soluções (que faz parte do banco de dados de configuração). Uma solução é identificada com um identificador global exclusivo (GUID) — por exemplo:
<Solution SolutionId="dda6427b-b880-46c0-a428-10c4bac0ce91" xmlns="https://schemas.microsoft.com/sharepoint/" >
</Solution>
DeploymentServerType e ResetWebServer são atributos opcionais. DeploymentServerType tem dois valores possíveis: ApplicationServer ou WebFrontEnd. Em geral, a maioria das soluções é direcionada aos servidores Web do farm. Exemplos de soluções direcionadas aos servidores de aplicativos — como servidores de índice, servidores que executam os Serviços do Excel, servidores de conversão de documentos e assim por diante — são as configurações personalizadas ou os conversores personalizados adicionais. Você pode usar o atributo IISReset para iniciar uma redefinição dos Serviços de Informações da Internet (IIS) quando a solução é implantada em um aplicativo Web do IIS específico.
Elemento FeatureManifest
Os elementos Feature desempenham um papel importante em muitas soluções dos Produtos e Tecnologias do SharePoint porque representam os componentes individuais da solução — por exemplo, um tipo de campo, uma Web Part, um fluxo de trabalho e assim por diante. Você precisa representar cada Feature incluído na solução com um elemento FeatureManifest. O exemplo de código a seguir contém o Feature que anuncia uma Web Part em um site do SharePoint:
<Solution SolutionId="dda6427b-b880-46c0-a428-10c4bac0ce91" xmlns="https://schemas.microsoft.com/sharepoint/" >
<FeatureManifests>
<FeatureManifest Location="HelloWorldWebPart_28c3eefe-2c03-4791-9f69-4405c80e1d92\feature.xml" />
</FeatureManifests>
…
</Solution>
Quando você implanta a solução em um servidor Web, todos os arquivos relacionados ao Feature são copiados para o local especificado.
Elemento Assembly
A maioria das soluções do SharePoint envolve um ou mais assemblies do .NET Framework. O elemento Assembly é usado no arquivo de manifesto para disponibilizar a biblioteca de vínculo dinâmico (DLL) no servidor de destino. Por exemplo:
<Solution SolutionId="dda6427b-b880-46c0-a428-10c4bac0ce91" xmlns="https://schemas.microsoft.com/sharepoint/" >
…
<Assemblies>
<Assembly Location="HelloWorldWebPart.dll" DeploymentTarget="GlobalAssemblyCache" >
<SafeControls>
<SafeControl Assembly="HelloWorldWebPart, Version=1.0.0.0, Culture=neutral, PublicKeyToken=9f4da00116c38ec5" Namespace="MSDN" TypeName="HelloWorldWebPart" Safe="True" />
</SafeControls>
</Assembly>
</Assemblies>
</Solution>
O primeiro atributo do elemento Assembly é Location, que armazena o caminho relativo da DLL no arquivo de solução. Depois, há o atributo DeploymentTarget, que tem dois valores possíveis: GlobalAssemblyCache ou WebApplication. GlobalAssemblyCache indica se o assembly deve ser implantado no cache de assembly global. WebApplication instrui Windows SharePoint Services 3.0 para que descarte o assembly na pasta de aplicativo privada do aplicativo Web do IIS. Conforme tratado mais adiante, WebApplication implica que a solução usada depende do nível de confiança que o administrador define no arquivo Web.config associado ao aplicativo Web do IIS. A implantação do assembly no cache de assembly global, que é um local totalmente confiável, significa que, como desenvolvedor, você não precisa se preocupar com a configuração desse nível de confiança.
As Web Parts na solução precisam ser registradas como controles seguros no arquivo Web.config. O elemento Assembly pode conter um ou mais elementos SafeControl (agrupados em um elemento SafeControls). Cada elemento SafeControl descreve a configuração que precisa ser feita no arquivo Web.config.
Outro possível conjunto de elementos filho do elemento Assembly são os elementos ClassResource (agrupados em um elemento ClassResources). Cada um representa um possível recurso necessário ao assembly implantado. Exemplos são os arquivos de recurso, os arquivos XML ou as imagens.
Elemento ApplicationResourceFile
Os arquivos de manifesto podem conter um ou mais elementos ApplicationResourceFile com um caminho relativo para um arquivo de recurso que precisa ser implantado. No momento da implantação, os arquivos de recurso são copiados para a pasta de recurso de aplicativo privada do aplicativo Web do IIS. Por exemplo:
<Solution SolutionId="8f37f0a7-ec35-4a63-9c3d-91205d9a2ac6"
xmlns="https://schemas.microsoft.com/sharepoint/" >
…
<ApplicationResourceFiles>
<ApplicationResourceFile Location="hellowp.resx"/>
<ApplicationResourceFile Location="hellowp.en-us.resx"/>
</ApplicationResourceFiles>
</Solution>
Elemento CodeAccessSecurity
É importante incluir o elemento CodeAccessSecurity no arquivo de manifesto quando você deseja conceder permissões específicas ao código. Em resumo, o elemento CodeAccessSecurity tem um ou mais elementos filho PolicyItem, sendo que cada um define os aspectos específicos em relação à diretiva de segurança de acesso ao código que deve ser aplicada para a solução. Há duas partes de um item de diretiva: a listagem das permissões que a constituem e os assemblies para os quais essas permissões devem desempenhar uma função.
A lista de permissões, cada uma representada em um elemento IPermission, é coletada em um elemento PermissionSet que é filho do elemento PolicyItem. Cada elemento IPermission define uma permissão de segurança do acesso ao código necessária para que o assembly seja executado corretamente.
Um ou mais elementos Assembly podem desempenhar uma função na segurança do acesso ao código. Você precisa defini-los um por um, identificando cada um por nome, versão e chave pública completa.
Elemento DwpFile
As Web Parts precisam ser disponibilizadas na galeria de Web Parts antes que possam ser descartadas nas páginas de Web Parts. Os arquivos XML, seja com extensão .dwp ou .webpart, armazenam as informações de metadados necessárias para disponibilizar as Web Parts. O arquivo de manifesto da solução pode conter um ou mais elementos DwpFile reunidos no elemento DwpFiles, sendo que cada um aponta para um desses arquivos. Por exemplo:
<DwpFiles>
<DwpFile FileName="hellowebpart.webpart" Location="hellowebpart.webpart"/>
</DwpFiles>
Elemento Resource
Você pode descartar os arquivos de recurso na pasta que contém o Feature e usá-lo desse local. Um elemento Resource representa esse recurso no arquivo de manifesto da solução. O único atributo a ser definido é o caminho relativo do pacote para o arquivo de recurso.
Elemento SiteDefinitionManifest
Use esse elemento ao implantar uma definição de site personalizada. O elemento SiteDefinitionManifest tem um atributo Location que seleciona todos os arquivos na pasta especificada e cria a pasta necessária na pasta \12\Template\SiteTemplates. O elemento filho WebTempFile implanta o arquivo webtemp*.xml para tornar o modelo conhecido para os Produtos e Tecnologias do SharePoint. Por exemplo:
<SiteDefinitionManifests>
<SiteDefinitionManifest Location="LitwareSiteTemplate">
<WebTempFile Location="1033\xml\webtempLitware.xml" />
</SiteDefinitionManifest>
</SiteDefinitionManifests>
Elemento RootFile
Os arquivos de solução podem ser copiados para uma pasta especificada diretamente subordinada à pasta \12 durante a implantação inserindo um elemento RootFile no arquivo de manifesto de solução.
Elemento TemplateFile
O elemento TemplateFile pode ser usado para definir os arquivos de modelo que precisam ser implantados subordinados à pasta \12\Template. Um exemplo do tipo de arquivo que você pode implantar dessa maneira é o arquivo fldtypes*.xml, que define os detalhes de um tipo de campo personalizado. Use o atributo Location para especificar o caminho relativo para o arquivo.
Baixar este manual
Este tópico está incluído no seguinte manual baixável para facilitar a leitura e a impressão:
Consulte a lista completa de manuais disponíveis nos manuais do Office SharePoint Server 2007 que podem ser baixados (em inglês).
Consulte também
Conceitos
Implantar personalizações
Implantando personalizações de elementos de site criados
Implantando personalizações de elementos em sites desenvolvidos