Compartilhar via

Solucionar problemas de soluções do SharePoint

Os seguintes problemas ou alertas podem ocorrer quando você depura soluções do SharePoint usando o depurador do Visual Studio. Para obter mais informações, consulte Depurando soluções de fluxo de trabalho do SharePoint 2007.

Restrições de token em web parts visuais em área restrita

Web Parts visuais em soluções em área restrita não podem processar tokens padrão, como $SPUrl, compatíveis com o runtime do SharePoint. Como resultado, a URL não é resolvida e você não pode visualizar o conteúdo no modo Design no designer de Web Part visual se você se referir a ela diretamente em um elemento de script, como no exemplo a seguir:

<script src="<% $SPUrl:~site/SiteAssets/ListOperations.js %>"></script>

Para contornar essa limitação e desbloquear o token, consulte-o usando literais:

<asp:literal ID="Literal1" runat="server" Text="<script src='" />
<asp:literal ID="Literal2" runat="server" Text="<% $SPUrl:~site/SiteAssets/ListOperations.js %>" />
<asp:literal ID="Literal3" runat="server" Text="' type='text/javascript' ></script>" />

Restrições de caractere em nomes de projetos e itens de projeto

Nomes de projetos e itens de projeto podem conter apenas caracteres válidos em um caminho de implantação no SharePoint 2010. Nenhum outro caractere é permitido.

Mensagem de erro

Mensagem de erro "Caracteres inválidos".

Resolução

Para nomes de projetos do SharePoint e itens de projeto, use apenas os seguintes caracteres:

  • Caracteres ASCII alfanuméricos

  • Space

  • Período (.)

  • Vírgula (,)

  • Sublinhado (_)

  • Traço (-)

  • Barra invertida (\)

    Quando um projeto é empacotado, uma regra de validação verifica se a propriedade de caminho de implantação para cada arquivo que você está implantando contém apenas esses caracteres válidos.

Erros ao criar campos personalizados

No Visual Studio, os campos personalizados são definidos em XML. Erros poderão ocorrer se um campo não for definido ou referenciado usando um formato específico.

Mensagem de erro

Mensagem de erro "Caracteres inválidos" durante o empacotamento.

Resolução

O ID de uma definição de campo deve ser um GUID delimitado por chaves, como mostra o exemplo a seguir:

<Field ID="{5744d18c-305e-4632-8bd1-09d134f4830d}"
    Type="Note"
    Name="PatientName"
    DisplayName="Patient Name"
    Group="A Custom Group">
</Field>.

Como mostra o exemplo a seguir, uma referência de campo em um tipo de conteúdo deve ser definida usando o formato de elemento vazio (<FieldRef />), não usando elementos de início/término (<FieldRef></FieldRef>):

<FieldRef ID="{5744d18c-305e-4632-8bd1-09d134f4830d}"
    Name="PatientName"
    DisplayName="Patient Name"
    Required="TRUE"/>

Se o XML de origem para o campo estiver malformado, não for um arquivo XML válido ou exibir algum outro problema, ocorrerá o erro "Não é possível analisar o arquivo".

Novas definições de site não em inglês não aparecem na página de criação do site após a implantação

Depois de criar e implantar uma definição de site usando uma versão não em inglês do Visual Studio (ou seja, uma versão com uma ID de localidade diferente de 1033), a guia Personalizações do SharePoint não aparece na caixa Seleção de Modelo e o novo modelo de site não aparece na página Novo Site do SharePoint .

Mensagem de erro

Nenhum.

Resolução

Esse problema ocorre devido a um valor incorreto na propriedade Path para o arquivo de configuração de definição de site do webtemp, como webtemp_SiteDefinitionProject1.xml. Na propriedade Path do arquivo webtemp, localizada no Local de Implantação, altere 1033 para a ID de localidade apropriada. Por exemplo, para usar uma localidade japonesa, altere o valor para 1041. Para obter mais informações, consulte IDs de localidade atribuídas pela Microsoft.

Erro aparece quando um projeto de fluxo de trabalho é implantado em um sistema limpo

Esse problema ocorrerá se você implantar um projeto de fluxo de trabalho no Visual Studio em um sistema limpo. Um sistema limpo é um computador que tem uma nova instalação do Visual Studio e do SharePoint, mas sem projetos de fluxo de trabalho implantados.

Mensagem de erro

Não é possível localizar a lista do SharePoint: Histórico de fluxo de trabalho.

Resolução

Esse erro ocorre devido a uma lista de Histórico de Fluxo de Trabalho ausente. Como o ambiente de desenvolvimento é um sistema limpo, nenhum fluxo de trabalho é implantado e a lista histórico de fluxo de trabalho ainda não existe. Para resolver esse problema, reabra o assistente de fluxo de trabalho, o que fará com que a lista Histórico de Fluxo de Trabalho seja criada.

Para reentrar no assistente de fluxo de trabalho

  1. No Gerenciador de Soluções, escolha o nó de fluxo de trabalho.

  2. Na janela Propriedades, escolha o botão de reticências (...) em qualquer propriedade que tenha um botão de reticências.

O usuário deve atualizar a página do aplicativo no navegador durante a depuração para exibir a imagem atualizada

Se você estiver depurando uma solução do SharePoint que contenha uma página de aplicativo com um controle que exibe uma imagem, como um controle de imagem HTML, você deverá atualizar a página no navegador para exibir as alterações feitas na imagem.

Erro: o local do site não é válido

Esse problema poderá ocorrer se o SharePoint Server não estiver instalado. Também poderá ocorrer se você não tiver acesso de administrador ao site do SharePoint especificado no Assistente de Personalização do SharePoint.

Mensagem de erro

  • O local do site do SharePoint não é válido.

Resolução

O evento de exclusão de site na Web não ocorre no projeto de receptor de eventos

Quando você cria um projeto de receptor de eventos e seleciona determinados eventos da Web, como "um site está sendo excluído", o evento nunca ocorre.

Mensagem de erro

Nenhum.

Resolução

Esse problema ocorre porque o escopo do recurso deve ser "Site" para lidar com eventos no nível do site, mas o escopo de recurso padrão para projetos do receptor de eventos é "Web". Os eventos da Web afetados são:

  • Um site está sendo excluído (WebDeleting)

  • Um site foi excluído (WebDeleted)

  • Um site está sendo movido (WebMoving)

  • Um site foi movido (WebMoved)

    Para corrigir o problema, altere o escopo do recurso do receptor de eventos, da seguinte maneira.

Para alterar o escopo de funcionalidades do receptor de eventos

  1. No Gerenciador de Soluções, abra o arquivo .feature do receptor de eventos no Designer de Recursos clicando duas vezes no arquivo ou abrindo seu menu de atalho e escolhendo Abrir.

  2. Escolha a seta ao lado de Escopo e, em seguida, escolha Site na lista exibida.

O erro de implantação é exibido depois que o nome de um identificador em um projeto de modelo de conectividade de dados corporativos é alterado

Esse problema ocorrerá se você alterar o nome do identificador de uma entidade em um modelo de BDC (Conectividade de Dados Corporativos) e tentar implantar a solução.

Mensagens de erro

  • < nome do modelo> tem os seguintes erros de ativação de Tipo de Conteúdo Externo...

  • O IMetadataObject com o Nome '<nome do modelo>' tem um valor no campo 'nome' que está duplicado...

Resolução

Para resolver esse problema, exclua o modelo manualmente e implante a solução novamente. Você pode excluir o modelo usando uma das seguintes ferramentas:

  • Administração Central do SharePoint 2010. Para obter mais informações, consulte o Gerenciamento de Modelos do BDC no site do Microsoft TechNet.

  • Windows PowerShell. Você pode excluir o modelo digitando este comando no prompt de comando: Remove-SPBusinessDataCatalogModel. Para obter mais informações, consulte Cmdlets Gerais (SharePoint Server 2010) no site do Microsoft TechNet.

Erro de implantação ao tentar reciclar o Pool de Aplicativos do IIS no SharePoint Server

Esse problema ocorrerá se o recurso de compatibilidade WMI do IIS 6 e o .NET Framework 3.5 não estiverem instalados no computador do SharePoint Server.

Mensagens de erro

  • Erro na etapa de implantação 'Recycle IIS Application Pool': namespace inválido
  • Erro na etapa de implantação 'Recycle IIS Application Pool': uma tarefa foi cancelada.

Resolução

Para resolver esse problema, no computador do SharePoint Server, verifique se o recurso do Windows IIS 6 WMI Compatibility está instalado,

  • Windows PowerShell. Você pode verificar se o recurso está instalado executando este comando do PowerShell: get-windowsfeature -name Web-WMI. Se ele não aparecer como instalado, você poderá instalá-lo executando o seguinte comando do PowerShell: install-windowsfeature -name Web-WMI. Se você ainda vir erros ao tentar reciclar o Pool de Aplicativos, verifique se o .NET Framework 3.5 também está instalado no computador executando get-windowsfeature -name NET-Framework-Core e install-windowsfeature -name NET-Framework-Core se não estiver.

Um erro é exibido quando você tenta exibir uma Web Part visual no SharePoint

Esse problema ocorre quando a propriedade Path do controle de usuário não começa com a cadeia de caracteres "CONTROLTEMPLATES\".

Mensagens de erro

  • O arquivo '/_CONTROLTEMPLATES/<project name>/<Web Part name>/<user control name.ascx>' não existe.

  • Erro do servidor no aplicativo '/'.

Resolução

Para resolver esse problema

  1. No Gerenciador de Soluções, escolha o arquivo de controle do usuário, cuja extensão de nome de arquivo é .ascx.

  2. Na barra de menus, escolha Exibir>Janela Propriedades.

  3. Na janela Propriedades, expanda o nó Local de Implantação.

  4. Verifique se o valor da propriedade Path começa com a cadeia de caracteres "CONTROLTEMPLATES\".

O erro é exibido quando um fluxo de trabalho reutilizável importado que contém um campo de formulário de tarefa é executado

Esse problema ocorrerá se você importar um fluxo de trabalho que contenha um formulário de tarefa que tenha um campo e, em seguida, executar o novo fluxo de trabalho no mesmo sistema do qual você o importou.

Mensagem de erro

Erro na etapa de implantação 'Ativar Recursos': o campo com ID [Guid] definido no recurso [Guid] foi encontrado no conjunto de sites atual ou em um subsite.

Resolução

Esse erro é resultado de colisões de IDs de campo que ocorrem porque o projeto "Import Reusable Workflow" no Visual Studio não altera os IDs dos campos do formulário de tarefa. Se você implantar um fluxo de trabalho importado no mesmo servidor que contém o fluxo de trabalho original, ocorrerão colisões de ID de campo.

Para resolver esse problema, use o recurso Localizar e Substituir para alterar o valor do atributo ID de Campo em todos os arquivos de fluxo de trabalho importados.

O erro é exibido quando uma instância de lista importada renomeada é executada

Esse problema ocorrerá se você renomear uma instância de lista importada e executá-la no Visual Studio.

Mensagem de erro

Erro de build: erro na etapa de implantação 'Ativar Funcionalidades': O arquivo Template\Recursos\[importar projetorecursonome]\Files\Lists\[antiganome da lista]\Schema.xml não existe.

Resolução

Quando você importa uma instância de lista, um atributo chamado CustomSchema é adicionado ao arquivo Elements.xml da instância de lista. Elements.xml inclui o caminho de um schema.xml personalizado para a instância de lista. Quando você renomeia a instância de lista no Visual Studio, o caminho de implantação do schema.xml personalizado é alterado, mas o valor do caminho do atributo CustomSchema não é atualizado. Como resultado, a instância de lista não pode encontrar o arquivo schema.xml no caminho antigo especificado pelo atributo CustomSchema quando o recurso é ativado.

Para resolver esse problema, atualize o caminho do local de implantação do arquivo schema.xml no atributo CustomSchema.

Sessão de depuração do SharePoint encerrada pelo IIS

Esse problema ocorrerá se você definir um ponto de interrupção em uma solução do SharePoint do Visual Studio, escolher a chave F5 para executá-la e permanecer em um ponto de interrupção por mais de 90 segundos.

Mensagem de erro

O processo do servidor Web que estava sendo depurado foi encerrado pelo IIS (Serviços de Informações da Internet). Você pode evitar esse problema definindo as configurações de ping do Pool de Aplicativos no IIS. Consulte a ajuda para obter mais detalhes.

Resolução

Por padrão, o pool de aplicativos do IIS aguarda 90 segundos para que um aplicativo responda antes de fechar o aplicativo. Esse processo é conhecido como "ping" do aplicativo. Para resolver esse problema, você pode aumentar o tempo de espera ou desabilitar totalmente o ping do aplicativo.

Para acessar as configurações do pool de aplicativos do IIS

  1. Abra o Gerenciador do IIS.

  2. No painel Conexões, expanda o nó do servidor SharePoint e escolha o nó Pools de Aplicativos.

  3. Na página Pools de Aplicativos , escolha o pool de aplicativos do SharePoint (normalmente "SharePoint – 80" e, em seguida, no painel Ações , escolha o link Configurações Avançadas .

  4. Para aumentar o tempo de espera antes do tempo limite do IIS, altere o valor do Tempo Máximo de Resposta de Ping (segundos) para um valor maior que 90 segundos.

  5. Para desabilitar o ping do IIS, defina Ping Habilitado como False.

Retração automática deixa instância de lista órfã no SharePoint

Esse problema ocorrerá se você executar as etapas a seguir.

  1. Crie uma definição de lista que tenha uma instância de lista no Visual Studio.

  2. Escolha a chave F5 para executar a solução.

  3. Interrompa a depuração ou feche o site do SharePoint.

  4. Reabra o site do SharePoint e abra a instância da lista.

Mensagem de erro

Erro do servidor no aplicativo '/'.

Resolução

Isso acontece porque depois que você fecha uma sessão de depuração de uma solução do SharePoint, o recurso de retração automática retrai a solução. A retração exclui a definição de lista do SharePoint, mas não exclui a instância da lista. A definição de lista subjacente é exigida pela instância de lista.

Para resolver esse problema, implante a solução, na barra de menus, escolhendo Compilar>Implantação. (Não depure a solução escolhendo a chave F5 .) Em seguida, exclua a instância de lista no SharePoint.

A solução original do SharePoint é substituída por uma versão exportada

Se você exportar uma solução do SharePoint, importar a solução para o Visual Studio e, em seguida, implantar a solução de volta para o mesmo site do qual ela foi exportada, a solução original do SharePoint será substituída. Esse problema não ocorrerá se você implantar a solução em um servidor que não tenha a solução original ativada nele.

Mensagem de erro

Nenhum.

Resolução

Para evitar substituir uma solução no site do qual foi exportada, altere os GUIDs do SolutionID e dos IDs de Funcionalidade de todos os recursos importados no projeto do Visual Studio.

O erro é exibido quando a depuração é iniciada

Quando você começa a depurar uma solução do SharePoint no Visual Studio, um erro indica que o Visual Studio não pôde carregar o arquivo Web.config porque a chave fornecida não estava no dicionário.

Mensagem de erro

Não foi possível carregar o arquivo de configuração Web.config. Verifique se há elementos XML malformados no arquivo e tente novamente. Ocorreu o seguinte erro: a chave fornecida não estava presente no dicionário.

Resolução

Para resolver esse problema, verifique se o valor da propriedade URL do Site do projeto do SharePoint no Visual Studio corresponde à URL atribuída à Zona Padrão para os mapeamentos de acesso alternativos do aplicativo Web. Você não pode resolver o erro usando outra zona, como a Intranet, para a URL. A URL do site para o projeto e a URL na zona padrão devem corresponder. Para acessar mapeamentos de acesso alternativos, abra o utilitário de Administração Central do SharePoint 2010, escolha o link Gerenciamento de Aplicativos e, em Aplicativos Web, escolha o link Configurar mapeamentos de acesso alternativos . Para obter mais informações, consulte Criar zonas para aplicativos Web.

Conteúdo relacionado

  • Last updated on