Solucionando problemas de soluções do SharePoint

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

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

• Limitações simbólicas no Visual Web Parts de na área restrita
• Limitações de caracteres em nomes dos projetos e itens de projeto
• Erro ao criar campos personalizados
• As novas definições não inglês do site não aparece na página de design do site após a implantação
• O erro aparece quando um projeto de fluxo de trabalho é implantado em um sistema limpa
• O usuário deve atualizar a página de aplicativo no navegador durante a depuração para exibir a imagem atualizado
• Erro: O local de site não é válido
• O evento de Web de exclusão de site não ocorre no projeto de receptor de eventos
• O erro de implantação aparece após o nome de um identificador em um projecto-modelo de conectividade de dados comerciais é alterado
• Um erro aparece quando você tentar exibir Web parts visual no SharePoint
• O erro aparece quando um fluxo de trabalho e importado que contém um campo de formulário de tarefa é executado
• O erro aparece quando uma instância importado renomeada de lista é executada
• O SharePoint que depurar a sessão finalizada pelo IIS
• automática Retraia a instância orfandade de lista das folhas no SharePoint
• A solução original do SharePoint é substituída por uma versão exportada
• O erro aparece quando a depuração é iniciada
• Tópicos relacionados

Limitações simbólicas no Visual Web Parts de na área restrita

As partes visuais da Web em soluções na área restrita não podem processar tokens padrão, como $SPUrl, o tempo de execução do SharePoint suporta.Como resultado, a URL não é resolvido, e você não pode visualizar o conteúdo em modo design no designer visual a parte Web se você faz referência direta em um elemento de script, como no exemplo a seguir:

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

Para contornar esta limitação e resolver o símbolo, referem-lhe usando literais:

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

Limitações de caracteres em nomes dos projetos e itens de projeto

Os nomes dos projetos e itens de projeto podem conter apenas caracteres que são válidos em um caminho de implantação do SharePoint 2010.Qualquer outro caractere é permitido.

mensagem de erro

“Mensagem de erro de caracteres inválidos.”

resolução

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

• Caracteres ASCII alfanuméricos

• Space

• Ponto (.)

• vírgula (,)

• sublinhado (_)

• Sublinhado (-)

• barra invertida (\)

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

Erro ao criar campos personalizados

em Visual Studio, os campos personalizados são definidos em XML.Erros podem ocorrer se um campo não está definido ou não é referenciado usando um formato específico.

mensagem de erro

“Mensagem de erro de caracteres inválidos” no tempo.

resolução

A identificação de uma definição de campo deve ser GUID circundado 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 do elemento vazio (<FieldRef />), não usando elementos de início ou final (<FieldRef></FieldRef>):

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

Se a fonte XML para o campo é incorreto, não é um arquivo XML válido, exibe ou algum outro problema, o erro “não pode analisar o arquivo” ocorre.

As novas definições não inglês do site não aparece na página de design do site após a implantação

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

mensagem de erro

Nenhum.

resolução

Esse problema ocorre devido a um valor incorreto na propriedade de Caminho para o arquivo de configuração de definição do site de webtemp, como webtemp_SiteDefinitionProject1.xml.A propriedade de Caminho para o arquivo de webtemp, localizada sob Local de implantação, alterações 1033 para o local apropriado ID.Por exemplo, para usar uma localidade japonesa altere o valor para 1041.Para obter mais informações, consulte Identificações de localidade atribuídas pela Microsoft no site do MSDN.

O erro aparece quando um projeto de fluxo de trabalho é implantado em um sistema limpa

Esse problema ocorre se você implantar um projeto de fluxo de trabalho em Visual Studio em um sistema limpa.Um sistema limpa é um computador que tenha uma instalação do SharePoint e atualizado Visual Studio mas nenhum projetos implantados de fluxo de trabalho.

mensagem de erro

Não pode encontrar a lista do SharePoint: Histórico de fluxo de trabalho.

resolução

Esse erro ocorre devido a uma lista ausente histórico de fluxo de trabalho.Porque o ambiente de desenvolvimento é um sistema limpo, nenhum fluxo de trabalho é implantado e a lista histórico de fluxo de trabalho ainda não existir.Para resolver esse problema, reabra o assistente de fluxo de trabalho, o que faz com que a lista histórico de fluxo de trabalho a ser criada.

Para digitar novamente o assistente de fluxo de trabalho

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

2. Em a janela de Propriedades , escolha o botão reticências (…) em botão qualquer propriedade que tem um botão de reticências.

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

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 controle de imagem de HTML , você deve atualizar a página no navegador para exibir quaisquer alterações feitas à imagem.

Erro: O local de 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 tenha acesso ao administrador para o site da web do SharePoint que é especificado em Assistente de personalização do SharePoint.

mensagem de erro

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

resolução

• Instale o SharePoint Server 2010.

• Garanta que você tenha acesso de administrador para o site da web do SharePoint.Para obter mais informações, consulte a Office o artigo Acesso de Conceda ao site de portalMSDN.

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

Quando você cria um projeto de receptor do evento e você selecionar determinados eventos da Web como um site “está sendo excluída,” do evento não ocorre.

mensagem de erro

Nenhum.

resolução

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

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

• Um site foi excluída (WebDeleted)

• Um site está sendo movida (WebMoving)

• Um site foi movido (WebMoved)

Para corrigir o problema, altere o escopo de recurso de receptor de evento, como segue.

Para alterar o escopo de recurso de receptor de eventos

1. Em Gerenciador de Soluções, abra o arquivo de .feature de receptor de evento em Designer de recursos clicando duas vezes no arquivo ou abrindo o menu de atalho e então escolha Abrir.

2. Escolha a seta ao lado de Escopo, e então escolha Site que aparece na lista.

O erro de implantação aparece após o nome de um identificador em um projecto-modelo de conectividade de dados comerciais é alterado

Esse problema ocorre se você alterar o nome do identificador de uma entidade em um modelo de (BDC) de conectividade de dados comerciais e o tentar implantar na solução.

Mensagens de erro

• <nome modelo> possui os seguintes erros externos de ativação de tipo de conteúdo…

• O IMetadataObject com nome “<nome modelo>” tem um valor no campo “nome” que é duplicado…

resolução

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

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

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

Um erro aparece quando você tentar exibir Web parts visual no SharePoint

Esse problema ocorre quando a propriedade de Caminho de 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 de servidor em “/” aplicativo.

resolução

Para resolver esta questão

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

2. Em a barra de menu, escolha Modo de Visualização, Janela de propriedades.

3. Em a janela de Propriedades , expanda o nó de Local de implantação .

4. Certifique-se de que o valor da propriedade de Caminho começa com a cadeia de caracteres “CONTROLTEMPLATES \”.

O erro aparece quando um fluxo de trabalho e importado que contém um campo de formulário de tarefa é executado

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

mensagem de erro

O erro ocorreu ao passo de implantação “ativa recursos: O campo com a identificação []Guiddefinida no recurso []Guidfoi encontrado na coleção atual do site ou em uma subsite.

resolução

Este erro é o resultado de conflitos de identificação do campo que ocorrem porque o projeto e de fluxo de trabalho de importação em Visual Studio não altera IDs do campo de formulário de tarefas.Se você implantar um fluxo de trabalho importado no mesmo servidor que contém o fluxo de trabalho original, as conflitos de identificação do campo ocorrem.

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

O erro aparece quando uma instância importado renomeada de lista é executada

Esse problema ocorre se você renomear uma instância importado da lista e execute em Visual Studio.

mensagem de erro

Erro de compilação: O erro ocorreu ao passo de implantação 'Ativar Recursos': O arquivo Template\Features\[import projectfeaturename]\Files\Lists\[oldlist name]\Schema.xml não existe.

resolução

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

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

O SharePoint que depurar a sessão finalizada pelo IIS

Esse problema ocorre se você definir um ponto de interrupção em uma solução de Visual Studio o SharePoint, escolha a tecla F5 para executar o, e permanece em um ponto de interrupção mais de 90 segundos.

mensagem de erro

O processo que foi depurado foi finalizada pelo Internet information services (IIS).Você pode evitar esse problema configurando definiçõ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 90 segundos espera por um aplicativo responder antes que fecha o aplicativo.Esse processo é conhecido como “ping” executando o aplicativo.Para resolver esse problema, você pode aumentar o tempo de espera ou desativar o aplicativo que pinga inteiramente.

Para acessar as configurações do pool do IIS app

1. Abra o Gerenciador do IIS.

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

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

4. Para aumentar o tempo de espera antes do tempo limite do IIS, altere o valor da Pingar o tempo de resposta máximo (os segundos) um valor que é maior que 90 segundos.

5. Para desativar o IIS que pinga, defina Ping Habilitado a False.

automática Retraia a instância orfandade de lista das folhas no SharePoint

Esse problema ocorre se você toma as seguintes etapas.

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

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

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

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

mensagem de erro

Erro de servidor em “/” aplicativo.

resolução

Isso acontece porque depois que você fechar uma sessão de depuração de uma solução do SharePoint, o recurso de incrementos retraimanto 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 subjacente da lista é necessária por instância de lista.

Para resolver esse problema, implantar a solução por, na barra de menus, escolhendo Compilar, Implementar.(Não a depuração da solução escolhendo a tecla F5.) Em seguida, exclua a instância da 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 em Visual Studio, e implantar na solução de volta para a mesma site que foi exportada, a solução do SharePoint original é substituído.Esse problema não ocorre se você implantar a solução a um servidor que não tenha a solução original ativada em ele.

mensagem de erro

Nenhum.

resolução

Para evitar substituir uma solução no site da web que foi exportada, altere os GUIDs de SolutionID e identificações de recurso de todos os recursos membros em Visual Studio projeto.

O erro aparece quando a depuração é iniciada

Quando você começar a criar uma solução do SharePoint no Visual Studio, um erro indica que o Visual Studio não pode carregar o arquivo Web.config porque a chave determinada não estava no dicionário.

mensagem de erro

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

resolução

Para resolver esse problema, certifique-se de que o valor de propriedade URL do site do projeto do SharePoint no Visual Studio corresponde a URL que é atribuído à zona padrão para os mapeamentos alternativas de acesso de aplicativo da web.Você não pode resolver o erro usando outra zona, como intranet, para o URL.O URL do site para o projeto e o URL na zona padrão devem coincidir.Para acessar mapeamentos alternativas de acesso, abra o utilitário de administração central do SharePoint 2010, escolha o link de Gerenciamento de Aplicativos e, em seguida, em Aplicativos Web, clique no link de Configurar mapeamentos alternativos de acesso .Para obter mais informações, consulte Criar zonas para aplicativos da Web.

Consulte também

Conceitos

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

Outros recursos

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

Depuração no Visual Studio