Como criar uma página separada que transfere o ficheiro Core.js mas que não referencia o ficheiro Core.js num site SharePoint Server 2007

Este artigo descreve como utilizar o Microsoft Office SharePoint Designer 2007 para criar uma página separada que transfere o ficheiro Core.js mas que não referencia o ficheiro Core.js num site SharePoint Server 2007.

Num site com ligação directa à Internet, os utilizadores que estão em ligações de baixa largura de banda ou em ligações de latência elevada poderão um desempenho lento quando navegam pela primeira vez um site. Por exemplo, pode demorar muito tempo para a primeira página de um site para carregar devido os recursos adicionais que, por vezes, tem de ser transferidos. Apesar de recursos com frequência são partilhados entre páginas num site, e apesar destes recursos são colocados em cache no cliente, a primeira página de um site poderão ser lento a carregar.

Este artigo descreve um procedimento de optimização para o SharePoint Server 2007. Por predefinição, todas as páginas num site SharePoint Server 2007 contém uma referência ao ficheiro Core.js. O ficheiro Core.js, no respectivo formato comprimido, é 54 KB. Em muitas áreas, este ficheiro é crítica para o funcionamento do site. No entanto, existem algumas áreas em que este ficheiro não é necessário.

O procedimento de optimização, pode criar um novo esquema de página. Em seguida, criar uma nova página utilizando esse esquema de página. Na página nova, o ficheiro Core.js é removido da lista de recursos que têm de ser transferidas antes da página é composta para um utilizador anónimo. Quando o conteúdo da página é legível, o ficheiro Core.js é transferido em segundo plano.

importante O procedimento de optimização abordada neste artigo não é suportado.

Antes de executar este procedimento, certifique-se de que são cumpridos os seguintes critérios:

• A página principal do site difere da página principal do sistema.
  
  Para verificar isto, localize a seguinte página:
  http:// ServerName /_layouts/ChangeSiteMasterPage.aspx
  Em seguida, determine se a página principal do site e a página principal do sistema fazem referência ao mesmo ficheiro. Se que fazem referência ao mesmo ficheiro, a optimização neste procedimento não funcionará. Para a optimização funcionar, a página principal do site e a página principal do sistema tem de utilizar ficheiros diferentes.
  
  Páginas que utiliza a página principal do sistema encontram-se normalmente na pasta "_layouts". Por exemplo, uma página que utiliza a página principal do sistema pode ser chamada de "/ _layouts/Settings.aspx" página.
• A página principal do site não contém os seguintes controlos:
  • Controlos que estão visíveis para utilizadores anónimos
  • Controlos que requerem o ficheiro Core.js mas que não registar o ficheiro Core.js
  A optimização neste procedimento suprime o ficheiro Core.js uma página e suprime o ficheiro apenas para utilizadores anónimos. Para utilizadores anónimos, o ficheiro Core.js não é transferido para a página até depois da página legível. Para utilizadores autenticados, o ficheiro Core.js é transferido para a página antes da página é legível.
  
  Pode modificar o código que é mencionado no passo 2 do procedimento optimização para suprimir o ficheiro Core.js para utilizadores do que os utilizadores anónimos. Se o fizer, deve considerar também a página do site principal.
• Certifique-se de que a página principal do site não contém controlos ScriptLink que registe o ficheiro Core.js. O objectivo deste procedimento consiste em criar uma página que suprime o ficheiro Core.js.
  
  Nota Em circunstâncias normais, o ficheiro Core.js é registado pelo controlo SPWebPartManager.

Para criar uma nova página que transfere o ficheiro Core.js mas que não referencia o ficheiro Core.js, siga estes passos:

1. No SharePoint Designer 2007, criar um novo esquema de página. Para efectuar este procedimento, copiar um esquema de página existente e, em seguida, colá-lo para a mesma pasta.
   
   Por exemplo, copie ArticleLeft.aspx e atribua o nome do novo esquema de página "ArticleLeftNoCore.aspx."
   
   Nota Para distinguir entre dois esquemas de página, poderá especificar uma nova descrição para o novo esquema de página que criou.
   
   Depois de criar o novo esquema de página, siga estes passos:
   1. Faça duplo clique no novo esquema de página. Por exemplo, faça duplo clique em ArticleLeftNoCore.aspx . Em seguida, na parte inferior da página, clique em código .
   2. Localize a tag PlaceHolderAdditionalPageHead e adicione o seguinte código à tag.

      <SharePointWebControls:ScriptLink runat="server"/>  
      

      quando o fizer, o servidor não referencia o ficheiro Core.js a menos que o ficheiro Core.js é registado por um controlo.
      
      Outras páginas principais podem utilizar um código diferente para referenciar o controlo ScriptLink. Por exemplo, a página de Default.master utiliza o código "SharePoint:ScriptLink" em vez do código "SharePointWebControls:ScriptLink".
      
      O código que referencia o controlo ScriptLink referencia o espaço de nomes Microsoft.SharePoint.WebControls. O código seguinte é um exemplo de tal uma tag.

      <%@ Register Tagprefix="SharePointWebControls" 
      Namespace="Microsoft.SharePoint.WebControls" 
      Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, 
      PublicKeyToken=PublicKeyToken" %> 

2. Crie um novo binário que se baseia o seguinte código. Por exemplo, criar um novo binário denominado "PerfTools.dll."

   using System;
   using System.Collections.Generic;
   using System.ComponentModel;
   using System.Text;
   using System.Web;
   using System.Web.UI;
   using System.Web.UI.WebControls;
   using Microsoft.SharePoint;
    
   namespace WebControls
   
   {
       [DefaultProperty("Text")]
       [ToolboxData("<{0}:RegisterCoreWhenAuthenticatedControl runat=server></
   {0}:RegisterCoreWhenAuthenticatedControl>")]
       public class RegisterCoreWhenAuthenticatedControl : WebControl
       {
           protected override void OnInit(EventArgs e)
           {
               if (HttpContext.Current.Request.IsAuthenticated)
               {
                   Microsoft.SharePoint.WebControls.ScriptLink.RegisterCore(this.Page, true);
               }
               base.OnInit(e);
           }
       }
   }

   este código indica ao servidor para referenciar o ficheiro Core.js se o utilizador não for anónimo. Esta operação é executada uma vez que o menu de Acções do site requer o ficheiro Core.js. Por predefinição, muitos utilizadores autenticados têm acesso ao menu de Acções do site no site.
   
   O ambiente pode requerer que suprime o ficheiro Core.js circunstâncias diferentes. Neste ambiente, utilize o código adequado às suas necessidades.
   
   Tenha em atenção que o método OnInit é executado sempre que a página é carregada. Assim, certifique-se de que não adicione o código que afecta negativamente o débito no servidor. Por exemplo, se adicionar o código que acessa o componente SpListItem actual, uma viagem round a base de dados do Microsoft SQL Server é provável que ocorra.
   
   Depois de criar o binário novo, siga estes passos:
   1. Defina a versão do ficheiro binário para 1.0.0.0.
   2. Adicione o ficheiro binário à cache de assemblagem global no servidor.
3. Abrir o ficheiro Web.config no servidor e, em seguida, adicione o seguinte código ao conjunto de controlos SafeControls.

   <SafeControl Assembly="PerfTools, Version=1.0.0.0, Culture=neutral, PublicKeyToken=PublicKeyToken" Namespace="WebControls" TypeName="*" Safe="True" />

4. No novo esquema de página que criou no passo 1, siga estes passos:
   1. Adicione uma marca para registar o ficheiro binário. O código seguinte é um exemplo de tal um tag.

      <%@ Register TagPrefix="PerfTools" Namespace="WebControls" 
      Assembly="PerfTools, Version=1.0.0.0, Culture=neutral, 
      PublicKeyToken=PublicKeyToken" %>

   2. Na linha após o código que adicionou no passo 1b, adicione o seguinte código.

      <PerfTools:RegisterCoreWhenAuthenticatedControl runat="server"/>

5. Crie uma nova página com o nome "CorePreLoad.aspx" e, em seguida, copie-lo para a pasta "_layouts" no servidor.
   
   Utilize o seguinte código para criar a página.

   <%@ Register Tagprefix="SharePoint" Namespace="Microsoft.SharePoint.WebControls" 
   Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, 
   PublicKeyToken=71e9bce111e9429c" %>
   <html>
   <head>
   <title>Pre-Load Core.js</title>
   </head>
   <body>
   <SharePoint:ScriptLink name="core.js" runat="server" />
   
   <script language="javascript">
    DisableRefreshOnFocus();
   </script>
   
   </body>
   </html>
   

   esta página faz referência a uma função no ficheiro Core.js. Além disso, a página transfere o ficheiro Core.js antes de executar o ficheiro.
6. Abra a página principal e, em seguida, adicione o código seguinte depois do </form> tag e antes do </body> tag.

   <asp:ContentPlaceHolder id="PlaceHolderBottomIFrame" 
   runat="server" />

7. No novo esquema de página que criou no passo 1, adicione o seguinte código ao fim da página.

   <asp:Content ContentPlaceholderID="PlaceHolderBottomIFrame" 
   runat="server">
                   <iframe 
   src="http://blogs.msdn.com/_layouts/CorePreLoad.aspx" 
   style="display:none"/>
   </asp:Content>
   

   este código permite que o novo esquema da página fazer referência a página CorePreLoad.aspx. Todos os itens na página são apresentados antes do ficheiro CorePreLoad.aspx é carregado para executar a função.
8. Verifique no novo esquema de página e, em seguida, publicá-lo.
9. Utilize o novo esquema de página para criar uma nova página.
   
   Quando os utilizadores anónimos procurar a nova página, o ficheiro Core.js não tem de ser transferidas antes do utilizador pode visualizar a página ou antes do utilizador pode interagir com a página.
   
   Por exemplo, utilizar ArticleLeft.aspx para criar uma nova página e, em seguida, utilizar ArticleLeftNoCore.aspx para criar outra nova página. Apesar de ambas as páginas novas forem idênticas, uma nova página referencia o ficheiro Core.js e outra nova página não.
10. Teste a página nova que criou para se certificar de que todos os controlos funcionam correctamente.
    
    Se controlos não funcionam quando os utilizadores anónimos procuras na página, remova os controlos da página nova. Em alternativa, remove os controlos no novo esquema de página. A optimização neste procedimento assume que a nova página não é necessário o ficheiro Core.js porque não existem itens da página requerem o ficheiro Core.js.
11. Certifique-se que o ficheiro Core.js ainda é apresentado em outras páginas no site. Procure outras páginas no site para verificar que o ficheiro Core.js aparece nessas páginas.

Para verificar que a optimização neste procedimento funcione correctamente, procure a nova página como um utilizador anónimo e, em seguida, ver o código de origem na página. Confirme que não existe uma referência ao ficheiro Core.js. Em seguida, visualiza a cache. Confirme que o ficheiro Core.js é transferido para o servidor. Apenas a página criados a partir do novo esquema de página não referencia o ficheiro Core.js. Outras páginas no site continuará a referenciar o ficheiro Core.js.

Para mais informações sobre este procedimento, visite o seguinte Web site da Microsoft:A Microsoft fornece exemplos de programação apenas, para fins sem garantia expressa ou implícita. Isto inclui, mas não está limitado a, as garantias implícitas de comercialização ou adequação a um fim específico. Este artigo pressupõe que está familiarizado com a linguagem de programação apresentada e as ferramentas que são utilizadas para criar e depurar procedimentos. Os técnicos de suporte da Microsoft podem ajudar a explicar a funcionalidade de um determinado procedimento. No entanto, não modificarão estes exemplos para proporcionarem funcionalidades adicionais nem criarão procedimentos adaptados às necessidades específicas do utilizador.