Adicionar uma web part a uma página em um suplemento do SharePoint hospedado pelo SharePoint

Esse é o quinto de uma série de artigos sobre as noções básicas de desenvolvimento de Suplementos do SharePoint hospedados no próprio SharePoint. Primeiro você deve se familiarizar com os Suplementos do SharePoint e os artigos anteriores dessa série, que você pode encontrar na Introdução à criação de Suplementos do SharePoint hospedados pelo SharePoint.

Observação

Se você trabalhou com esta série sobre suplementos hospedados pelo SharePoint, você terá uma solução do Visual Studio que pode ser usada para continuar com este tópico. Você também pode baixar o repositório em SharePoint_SP-hosted_Add-Ins_Tutorials e abrir o arquivo BeforeWebPart.sln.

Neste artigo, você adicionará uma web part à página padrão do suplemento do SharePoint para Orientação de Funcionários.

Adicionar uma web part a uma página

1. No Gerenciador de Soluções, abra o arquivo Default.aspx.

2. Como adicionaremos uma web part de modo de exibição de lista à página que mostra os novos funcionários em Seattle, não precisamos mais de um link para a página de modo de exibição de lista para a lista. Remova o <elemento asp:HyperLink> do <elemento asp:Content> cujo ContentPlaceHolderId é PlaceHolderMain.

3. Dentro do mesmo <elemento asp:Content> , adicione o seguinte WebPartZone.

     <WebPartPages:WebPartZone runat="server" FrameType="TitleBarOnly"
         ID="HomePage1" Title="loc:full" />
   

4. Salve e feche o arquivo.

5. No Gerenciador de Soluções, abra o arquivo elements.xml da página no nó Pages.

6. Se o elemento File tiver fechamento automático, remova o caractere "/" e adicione a marca de fim </File>.

7. No elemento File, adicione um elemento filho AllUsersWebPart e configure sua WebPartZoneID como a ID da zona de web part que você criou na página. Agora o conteúdo do arquivo deve ter a aparência a seguir. Essa marcação informa ao SharePoint para inserir uma AllUsersWebPart na zona de web part denominada "HomePage1".

   <Elements xmlns="http://schemas.microsoft.com/sharepoint/">
     <Module Name="Pages">
       <File Path="Pages\Default.aspx" Url="Pages/Default.aspx" ReplaceContent="TRUE" >
         <AllUsersWebPart WebPartZoneID="HomePage1" WebPartOrder="1">
   
         </AllUsersWebPart>
       </File>
     </Module>
   </Elements>
   
   

8. Adicione um elemento CDATA como filho da AllUsersWebPart e depois adicione um elemento webParts como filho do CDATA, conforme mostrado na marcação a seguir.

   <AllUsersWebPart WebPartZoneID="HomePage1" WebPartOrder="1">
     <![CDATA[
       <webParts>
   
       </webParts>
     ]]>
   </AllUsersWebPart>
   

9. Adicione a seguinte marcação de webPart como filho do elemento webParts. Essa marcação adiciona uma XsltListViewWebPart e informa à web part para mostrar a lista New Employees in Seattle. Observe que o valor da propriedade ViewContentTypeId é apenas 0x, não a ID real do tipo de conteúdo NewEmployee.

   <webPart xmlns="http://schemas.microsoft.com/WebPart/v3">
     <metaData>
       <type name="Microsoft.SharePoint.WebPartPages.XsltListViewWebPart,
                     Microsoft.SharePoint, Version=15.0.0.0, Culture=neutral,
                     PublicKeyToken=71e9bce111e9429c" />
     </metaData>
     <data>
       <properties>
         <property name="ListUrl">Lists/NewEmployeesInSeattle</property>
         <property name="IsIncluded">True</property>
         <property name="NoDefaultStyle">True</property>
         <property name="Title">New Employees in Seattle</property>
         <property name="PageType">PAGE_NORMALVIEW</property>
         <property name="Default">False</property>
         <property name="ViewContentTypeId">0x</property>
       </properties>
     </data>
   </webPart>
   

Executar e testar o suplemento

1. Use a tecla F5 para implantar e executar o suplemento. O Visual Studio faz uma instalação temporária do suplemento em seu site de teste do SharePoint e executa o suplemento imediatamente.

2. Ao abrir a página padrão do suplemento, a web part de modo de exibição de lista está contida nela, e a lista é exibida.

   Figura 1. Página padrão com web part de exibição de lista

   

3. Tente adicionar novos itens à lista ou editar itens existentes.

4. Para encerrar a sessão de depuração, feche a janela do navegador ou interrompa a depuração no Visual Studio. Sempre que você pressionar F5, o Visual Studio retirará a versão anterior do suplemento e instalará a mais recente.

5. Você lidará com esse suplemento e com a solução do Visual Studio em outros artigos, e recomenda-se retirar o suplemento uma última vez quando for deixar de trabalhar com ele por algum tempo. Clique com botão direito do mouse no projeto no Gerenciador de Soluções e escolha Retirar.

Próximas etapas

No próximo artigo desta série, você adicionará um fluxo de trabalho a um suplemento do SharePoint hospedado pelo próprio SharePoint.