Solucionando problemas de soluções do SharePoint

  • Artigo

Os seguintes problemas ou alertas que podem ocorrer quando você depurar soluções do SharePoint usando o Visual Studio depurador. Para obter mais informações, consulte Debugging SharePoint Workflow Solutions.

Este tópico contém as seguintes seções.

  • Restrições de caracteres no projeto e nomes de Item de projeto
  • Erros ao criar campos personalizados
  • Novas definições de Site do inglês não aparecem na página de criação de Site após a implantação
  • Erro aparece quando um projeto de fluxo de trabalho é implantado em um sistema limpo
  • Usuário deve atualizar a página de aplicativo no navegador enquanto a depuração de modo de exibição atualizado imagem
  • Erro: O local do Site Não É válido
  • Evento de Web de exclusão do site não ocorre no projeto de receptor de evento
  • Erro de implantação é exibida após o nome de um identificador em um projeto de modelo de conectividade de dados de negócios é alterado.
  • Um erro aparece quando você tenta exibir uma Visual Web Part no SharePoint
  • Erro aparece quando um fluxo de trabalho importado reutilizável que contém um campo de formulário da tarefa é executado.
  • Erro aparece quando uma instância de lista renomeado importado é executada.
  • Sessão encerrada pelo IIS de depuração do SharePoint
  • Auto-retração deixa órfãos instância de lista no SharePoint
  • Solução do SharePoint original é substituída por uma versão exportada
  • Erro aparece ao iniciar a depuração
  • Tópicos relacionados

Restrições de caracteres no projeto e nomes de Item de projeto

Projeto e nomes de item de projeto só podem conter caracteres que são válidos em um caminho de implantação do SharePoint 2010. Outros caracteres não são permitidos.

Mensagem de erro

Mensagem de erro "Caracteres inválidos".

Resolução

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

  • Caracteres alfanuméricos ASCII

  • Space

  • Ponto (.)

  • 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 está sendo implantada contém apenas esses caracteres válidos.

Erros ao criar campos personalizados

Os campos personalizados em Visual Studio 2010 são definidos no XML. Se um campo não estiver definido ou referenciado por meio de um formato específico, podem ocorrer erros.

Mensagem de erro

Mensagem de erro "Caracteres inválidos" no tempo de empacotamento.

Resolução

A identificação de uma definição de campo deve ser um GUID rodeado por chaves. Por exemplo,

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

Uma referência de campo em um tipo de conteúdo deve ser definida usando o formato de elemento vazio (<FieldRef/>), não por meio de elementos de início/fim (<FieldRef> </FieldRef>). Por exemplo:

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

Se houver um problema com o XML de origem para o campo, como está mal formado ou não um arquivo XML válido, em seguida, o erro "não é possível analisar o arquivo" ocorre.

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

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

Mensagem de erro

Nenhum.

Resolução

Esse problema ocorre devido a um valor incorreto no caminho a propriedade para o arquivo de configuração do webtemp site definição, como, por exemplo, webtemp_SiteDefinitionProject1.xml. No caminho propriedade para o arquivo webtemp, localizada sob o Local de implantação, alterar 1033 para a localidade apropriada ID. Por exemplo, para usar uma localidade Japonês alterar o valor para 1041. Para obter mais informações, consulte Identificações de localidade atribuído pela Microsoft no site do MSDN.

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

Esse problema ocorre se você implantar um projeto de fluxo de trabalho em Visual Studio 2010 em um sistema limpo. Um sistema limpo é um computador que possui a nova instalação do Visual Studio 2010 e SharePoint, mas sem projetos de fluxo de trabalho implantado.

Mensagem de erro

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

Resolução

Este erro ocorre devido uma lista de histórico do fluxo de trabalho ausente. Porque o ambiente de desenvolvimento é um sistema limpo, não há fluxos de trabalho são implantados e a lista do histórico do fluxo de trabalho ainda não existe. Para resolver esse problema, abra novamente o Assistente de fluxo de trabalho, o que faz com que a lista do histórico do fluxo de trabalho a ser criado.

Para digitar novamente o Assistente de fluxo de trabalho

  1. Selecione o nó de fluxo de trabalho no Solution Explorer.

  2. No Propriedades janela, clique no botão de reticências (…) em qualquer propriedade de um botão de reticências.

Usuário deve atualizar a página de aplicativo no navegador enquanto a depuração de modo de exibição atualizado imagem

Se você está depurando uma solução do SharePoint que contém uma página de aplicativo com um controle que exibe uma imagem, como um HTML o controle de imagem, você deve atualizar a página no navegador para exibir quaisquer alterações que foram feitas para a imagem.

Erro: O local do Site Não É válido

Esse problema pode ocorrer se SharePoint Server 2010 não está instalado. Também pode ocorrer se você não tem acesso de administrador para o site do SharePoint que está especificado no O Assistente para personalização do SharePoint.

Mensagem de erro

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

Resolução

  • Instalar SharePoint Server 2010.

  • Certifique-se de que você tem acesso de administrador para o site do SharePoint. Para obter mais informações, consulte o Office artigo Online conceder acesso ao site de portal.

Evento de Web de exclusão do site não ocorre no projeto de receptor de evento

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

Mensagem de erro

Nenhum.

Resolução

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

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

  • Um site foi excluído (WebDeleted)

  • Um site que está sendo movido (WebMoving)

  • Um site foi movido (WebMoved)

Para corrigir o problema, altere o escopo de recurso de receptor de eventos, como a seguir.

Para alterar o escopo de recurso do receptor do evento

  1. Abrir o recurso do receptor de evento a Recurso Designer. Para fazer isso, clique duas vezes em seu arquivo de .feature na Solution Explorer.

  2. Clique na seta suspensa ao lado de escopo.

  3. Selecione Site na lista drop-down.

Erro de implantação é exibida após o nome de um identificador em um projeto de modelo de conectividade de dados de negócios é alterado.

Esse problema ocorre se você alterar o nome do identificador de uma entidade em um modelo de conectividade de dados de negócios (BDC) e, em seguida, tente implantar a solução.

Mensagens de erro

  • <nome do modelo> tem os seguintes erros de ativação do tipo de conteúdo externo...

  • O IMetadataObject com nome ' <nome do modelo>' possui um valor em 'Nome do campo' que é duplicado...

Resolução

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

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

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

Um erro aparece quando você tenta exibir uma Visual Web Part no SharePoint

Esse problema ocorre quando o caminho a propriedade do controle de usuário não começa com a seqüência de caracteres "controltemplates\".

Mensagens de erro

  • O arquivo ' /_CONTROLTEMPLATES/< project name >/< nome de Web Part >/< nome do controle de usuário >. ascx ' não existe.

  • Erro de servidor no '/' Aplicativo.

Resolução

Para resolver esta questão

  1. Em Solution Explorer, selecione o arquivo de controle de usuário. Esse arquivo tem a extensão de nome de arquivo. ascx.

  2. Sobre o Exibir menu, clique em Janela Propriedades.

  3. No Propriedades janela, expanda o O local de implantação nó.

  4. Certifique-se de que o valor de caminho propriedade começa com a seqüência de caracteres "controltemplates\"

Erro aparece quando um fluxo de trabalho importado reutilizável que contém um campo de formulário da tarefa é executado.

Esse problema ocorre se você importar um fluxo de trabalho que contém um formulário de tarefas tem um campo e, em seguida, execute o novo fluxo de trabalho no mesmo sistema do qual você importou.

Mensagem de erro

Ocorreu um 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 é o resultado de colisões de identificação de campo que ocorrem porque o fluxo de trabalho reutilizável de importação de projeto Visual Studio não altera o campo de formulário de tarefas IDs. Se você implantar um fluxo de trabalho importado no mesmo servidor que contém o fluxo de trabalho original, ocorrem conflitos de ID de campo.

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

Erro aparece quando uma instância de lista renomeado importado é executada.

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

Mensagem de erro

Erro de compilação: Ocorreu um erro na etapa de implantação 'Ativar recursos': O arquivo Template\Features\ import project feature name] \Files\Lists\ [old list name] \Schema.xml não existe.

Resolução

Quando você importa uma instância de lista, um atributo chamado CustomSchema é adicionado ao arquivo elements da instância de lista. Elements inclui o caminho de um Schema. XML a personalizado para a instância de lista. Quando você renomeia a instância de lista em Visual Studio, o caminho de implantação para o Schema. XML personalizado for alterado, mas o valor do atributo CustomSchema de caminho não é atualizado. Como resultado, a instância de lista não é possível localizar o arquivo Schema. XML no caminho antigo que é especificado pelo atributo CustomSchema quando o recurso está ativado.

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

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

Esse problema ocorre se você definir um ponto de interrupção em um Visual Studio solução do SharePoint, pressione F5 para executá-lo e então permanecer em um ponto de interrupção mais de 90 segundos.

Mensagem de erro

O processo do servidor Web que estava sendo depurado foi encerrado pelo Internet Information Services (IIS). Isso pode ser evitado definindo 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 espera de 90 segundos para um aplicativo para responder antes que ele fecha o aplicativo. Esse processo é conhecido como "ping" o aplicativo. Para resolver esse problema, você pode aumentar o tempo de espera ou desabilitar o aplicativo ping inteiramente.

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

  1. Abra o Gerenciador do IIS.

  2. No conexões painel, expanda o nó de servidor do SharePoint e clique em Pools de aplicativos.

  3. Sobre o Pools de aplicativos , selecione o pool de aplicativos do SharePoint (normalmente "SharePoint - 80") e, em seguida, no Ações painel, clique em Configurações avançadas.

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

  5. Para desativar o ping do IIS, defina Ping ativado para False.

Auto-retração deixa órfãos instância de lista no SharePoint

Esse problema ocorre se as seguintes etapas.

  1. Criar uma definição de lista que tem uma instância de lista em Visual Studio 2010.

  2. Execute a solução pressionando F5.

  3. Parar a depuração ou fechar o site do SharePoint.

  4. Reabra o site do SharePoint e abrir a instância de lista.

Mensagem de erro

Erro de servidor no '/' Aplicativo.

Resolução

Isso acontece porque, depois de fechar uma sessão de depuração de uma solução do SharePoint, o auto-retração recurso cancela a solução. O cancelamento exclui a definição de lista do SharePoint, mas não exclui a instância da lista. A definição de lista subjacente é necessária a instância de lista.

Para resolver esse problema, no Build menu, clique em Deploy para implantar a solução. (Não use F5 para depurá-lo.) Em seguida, exclua a instância de lista no SharePoint.

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

Se você exportar uma solução do SharePoint, importar a solução em Visual Studioe então implantar a solução do mesmo site do qual foi exportada, a solução do SharePoint original é substituída. Esse problema não ocorre se você implantar a solução para um servidor que não tem a solução original ativada.

Mensagem de erro

Nenhum.

Resolução

Para evitar a substituição de uma solução no site do qual foi exportada, alterar os GUIDs do SolutionID e as identificações de recurso de todos os recursos importados no Visual Studio project.

Erro aparece ao iniciar a depuração

Quando você iniciar a depuração de uma solução do SharePoint no Visual Studio, você obtém um erro que Visual Studio não foi possível carregar o arquivo de configuração porque a chave fornecida não estava presente no dicionário de Web. config.

Mensagem de erro

Não foi possível carregar o arquivo de configuração Web. config. Verifique o arquivo para todos os elementos XML malformados e tente novamente. Erro: A chave fornecida não estava presente no dicionário.

Resolução

Para resolver esse problema, certifique-se de que o valor da propriedade URL do Site do projeto SharePoint no Visual Studio corresponde a URL atribuída à zona padrão para os mapeamentos de acesso alternativo do aplicativo da web. Usando a outra zona, como, por exemplo, Intranet, para a URL não resolverá o erro. URL do Site do projeto e a URL na zona padrão devem ser o mesmo. Para acessar os mapeamentos de acesso alternativo, clique em Gerenciamento de aplicativos no utilitário de Administração Central do SharePoint 2010, em seguida, clique o configurar mapeamentos de acesso alternativo link localizado em Aplicativos da Web. Para obter mais informações, consulte zonas de criação para aplicativos da Web.

Consulte também

Conceitos

Solução de problemas de empacotamento do SharePoint e implantação

Outros recursos

Criação e depuração de soluções do SharePoint

Depuração no Visual Studio