A importação de itens de um Site do SharePoint existente
O modelo de projeto ao conjunto de solução do SharePoint de importação permite que você reutilize elementos como tipos de conteúdo e campos de sites web do SharePoint existentes em uma nova solução de Visual Studio o SharePoint.Embora você possa executar a maioria das soluções importados sem alteração, há algumas restrições e problemas a serem consideradas, especialmente se você altera quaisquer itens após os importado.
.gif "Observação") Observação |
|---|
Para importar fluxos de trabalho reutilizáveis, use o modelo de projeto e de fluxo de trabalho de importação.Para obter mais informações, consulte Diretrizes para a importação de fluxos de trabalho reutilizáveis. |
Soluções suporte do SharePoint
Visual Studio 2012 totalmente suporta importar soluções criadas em SharePoint Foundation 2010 e em SharePoint Server 2010.
Visual Studio 2012 não suporta importar soluções criadas nos aplicativos:
Windows SharePoint Services 3.0
Microsoft Office SharePoint Server 2007
Visual Studio 2008
Designer da Microsoft 2007 SharePoint
Visual Studio 2010
Embora você possa geralmente com êxito importar as soluções criadas por esses aplicativos, essa funcionalidade não é testada e não é suportada.
Limitações de importação de item
Embora a maioria dos itens do SharePoint possam ser importados de um arquivo existente de .wsp, os seguintes itens não são suportados e podem exigir alterações funcionar corretamente:
entidades de BDC
Elementos de associação de fluxo de trabalho de código
Fluxos de trabalho de código
Visual Web (parte .ascx)
serviços Web (.asmx)
Associações de tipo de conteúdo
Recipientes de evento
Definições de lista (modelos)
Definições de site
Quando você exportar uma solução de SharePoint Foundation 2010 ou de SharePoint Server 2010, esses itens são excluídos automaticamente do arquivo de .wsp.Em o entanto, outros arquivos de .wsp gerados de ferramentas sem suporte podem conter esses itens.(Consulte “suportados soluções do SharePoint” anteriormente em este tópico.)
o que acontece quando você importar uma solução
Quando você importar uma solução com o modelo de pacote de solução do SharePoint de importação, Visual Studio copia todos o conteúdo do arquivo de .wsp e tenta-os reconciliar e manter tantas associações e referências entre elementos importados e os seus arquivos quanto possível.
Todos os itens importados copia pastas correspondentes em Gerenciador de Soluções.Por exemplo, os tipos de conteúdo aparecem sob a pasta Tipos de Conteúdo e instâncias de lista aparecem em Instâncias de lista.Os arquivos associados com um item importado também são copiados para a pasta do item.Por exemplo, uma instância importado de lista inclui os módulos, formulários, páginas e ASPX.
.gif "Ee231584.collapse_all(pt-br,VS.110).gif")
itens dependentes
Se você selecionar um item no assistente de pacote de solução do SharePoint de importação, mas não os itens dependentes, uma caixa de mensagem informa que os itens dependentes também devem ser selecionados antes de importar.
Recursos que são?
Os usuários do SharePoint Designer podem ver arquivos inesperados, recursoschamados, aparecem em suas soluções importados em O solution Explorer. Embora os recursos existissem na solução do SharePoint Designer, foram ocultos de exibição.Os recursos agora estão visíveis em Visual Studio.
Os recursos são contëineres para itens do SharePoint.Cada recurso mantém uma referência a cada item, como tipos de conteúdo e definições de lista, que contém.Quando você importar sua solução, Visual Studio configura os recursos para todos os elementos importados e tenta manter as relações de recurso-à- elemento para arquivos.Todos os arquivos cujas referências não podem ser resolvidas são colocados na pasta de outros arquivos importados .
Para obter mais informações sobre recursos, consulte Desenvolvimento de soluções do SharePoint e Trabalhando com recursos.
Manipulando casos especiais
Em alguns casos, o Visual Studio não pode reconciliar um item com seus arquivos dependentes.Todos os arquivos que Visual Studio não pode resolver aparecem sob a pasta outros arquivos importados.Além de isso, as propriedades de DeploymentType são definidas como NoDeployment para que não sejam implantados com a solução.
Por exemplo, se você importar a definição ExpenseForms da lista, uma definição de lista com esse nome aparece sob a pasta de Definições de lista em Gerenciador de Soluções juntamente com os arquivos de Elements.xml e de Schema.xml.Em o entanto, seus formulários associados ASPX e HTML podem ser colocados em uma pasta chamada ExpenseForms sob a pasta de outros arquivos importados .Para concluir a importação, para mover esses arquivos sob o ExpenseForms listar a definição em Gerenciador de Soluções e altere a propriedade de DeploymentType para cada arquivo de NoDeployment a ElementFile.
Importar recipientes de eventos, o arquivo de Elements.xml é copiado para o local correto, mas você deve incluir manualmente o assembly no pacote de solução para que implante com a solução.Para obter mais informações sobre como fazer isso, consulte Como: adicionar e remover Assemblies adicionais.
Importar fluxos de trabalho, os formulários de InfoPath são copiados para a pasta de outros arquivos importados .Se o arquivo de .wsp contém um modelo de Web, é definida como a página de inicialização em Gerenciador de Soluções.
Importando campos e sacos de propriedade
Quando você importar uma solução que contém vários campos, todas as definições de campo separadas são mescladas em um único arquivo de Elements.xml em um nó em Gerenciador de Soluções chamaram Campos.De a mesma forma, as entradas de saco de propriedade são mescladas em um arquivo de Elements.xml em um nó chamado PropertyBags.
Os campos no SharePoint são colunas de um tipo de dados especificado, como um texto, boolean, ou a pesquisa.Para obter mais informações, consulte Bloco de construção: colunas e tipos de campo.Os sacos de propriedade permite que você adicione as propriedades para objetos no SharePoint, tudo de um farm a uma lista em um site da web do SharePoint.Os sacos de propriedade são implementados como uma tabela de hash de nomes e valores de propriedade.Para obter mais informações, consulte Gerenciando a configuração do SharePoint ou Configurações de saco da propriedade do SharePoint.
Excluindo itens no projeto
A maioria dos itens em soluções do SharePoint têm um ou mais itens dependentes.Por exemplo, as instâncias de lista dependem dos tipos de conteúdo e os tipos de conteúdo dependem de campos.Depois que você importar uma solução do SharePoint, Visual Studio não o notifica de quaisquer problemas de referência se você excluir um item na solução, mas não de seus itens dependentes, até que você tente implantar a solução.Por exemplo, se uma solução importado tem uma instância de lista que dependesse de um tipo de conteúdo e você excluísse esse tipo de conteúdo, um erro pode ocorrer na implantação.O erro ocorre se o item dependente não está presente no servidor do SharePoint.De a mesma forma, se um item excluído também tem um saco relacionadas a propriedade, então exclua as entradas de saco da propriedade do arquivo de PropertyBags Elements.xml. Portanto, se você excluir quaisquer itens de solução e importado você obtém erros de implantação, verifique se qualquer item dependentes precisa ser excluído também.
Restaurando atributos ausentes de recurso
Importar soluções, alguns atributos são omitidos opcional de recurso de manifesto importado de recurso.Se você desejar restaurar esses atributos no novo recurso arquivo, identificam os atributos ausentes comparando o arquivo original de recursos no novo manifesto de recurso e siga as instruções no tópico Como: personalizar um recurso do SharePoint.
Detecção de conflito de implantação não é executada em instâncias internos de lista
Visual Studio não executa detecção de conflito de implantação em instâncias internos de lista (ou seja, as instâncias de lista padrão que vêm com o SharePoint.)Não executar detecção de conflito é feito para evitar substituir as instâncias interno da lista no SharePoint.As instâncias internos de lista ainda são implantados ou atualizados, mas nunca são excluídas ou substituídas. Para obter mais informações, consulte Solução de problemas de empacotamento do SharePoint e a implantação.
Importando fluxos de trabalho do SharePoint Server 2010
Se você importar um fluxo de trabalho criado em SharePoint Server 2010, não será executado corretamente após o implantá-lo.O fluxo de trabalho não executa corretamente como certos assemblies estão faltando e fluxos de trabalho de SharePoint Server 2010 contém os formulários de InfoPath que não são atualmente suportados em soluções do fluxo de trabalho Visual Studio .Em o entanto, os fluxos de trabalho importados de SharePoint Server 2010 podem ser feitos para funcionar corretamente após ter corrigido alguns itens, como adicionar referências aos conjuntos de SharePoint Server 2010 e reconectar os formulários de InfoPath.Para obter mais informações, consulte Importando fluxos de trabalho do SharePoint Server 2010.
Limite de nome de item
Visual Studio tem um limite de 260 caracteres total para nomes de projeto e de item de projeto, incluindo o caminho.Importar uma solução, se um nome de item excede esse limite, você obtém o erro:
O caminho especificado, o nome do arquivo ou ambos são muito longos.O nome de arquivo totalmente qualificado deve ter menos de 260 caracteres e o nome do diretório, menos de 248 caracteres.
Quando você obtém este erro, o item não é criado.Esse problema ocorre com mais freqüência com módulos importados.Para evitar esse problema, faça o seguinte:
Use nomes curtas para seu projeto quando você as digita na caixa de diálogo de Adicionar novo projeto .
Crie o projeto em um local tão próximo à pasta raiz como possível, para diminuir o caminho.
O atributo de SharePointProductVersion
Se você importar uma solução criada em uma versão anterior do SharePoint como Windows SharePoint Services 3.0 ou Microsoft Office SharePoint Server 2007, altere o valor do atributo de SharePointProductVersion no manifesto de pacote a 12,0, ou inserir um controle do gerenciador de script em todas as páginas da Web importados e deixe SharePointProductVersion definido como 14,0.Caso contrário, os membros formulários da Web não serão exibidos no SharePoint.
Plano de fundo
as soluções em SharePoint Foundation 2010 e SharePoint Server 2010 incluem um atributo chamado SharePointProductVersion.O SharePoint usa esse atributo em seus manifestos de pacote para determinar a versão do SharePoint que a solução é criada para.os dois valores válidos são 12,0 e 14,0.Um valor de 12,0 indica que o item é criado para Windows SharePoint Services 3.0 ou Microsoft Office SharePoint Server 2007; um valor de 14,0 indica que o item é criado para SharePoint Foundation 2010 ou SharePoint Server 2010.
Para a segurança avançada para processar páginas ASPX, SharePoint Foundation 2010 e SharePoint Server 2010 exigem que todos os ASPX ou páginas mestras contêm um controle do gerenciador de script.Para obter mais informações sobre o gerenciador de script, consulte Visão geral do controle ScriptManager.Porque o controle do gerenciador de script não estava disponível em Windows SharePoint Services 3.0 e em Microsoft Office SharePoint Server 2007, se deve ser adicionado a qualquer página de Windows SharePoint Services 3.0 ou de Microsoft Office SharePoint Server 2007 que é atualizada a SharePoint Foundation 2010 ou a SharePoint Server 2010.As páginas ASPX que usam uma página mestra padrão não requerem um controle do gerenciador de script como se ele já adicionado à página mestra padrão.Em o entanto, as páginas ASPX que não usam uma página mestra ou que usam uma página mestra personalizado deve adicionar um controle de script para trabalhar em SharePoint Foundation 2010 ou em SharePoint Server 2010.
A ausência de um controle do gerenciador de script pode ser um problema quando você importar um projeto de Windows SharePoint Services 3.0 ou de Microsoft Office SharePoint Server 2007 em Visual Studio 2010, porque o atributo de SharePointProductVersion de todos os novos projetos é definido como 14,0.Se você implantar um projeto atualizado que tenha um formulário da Web sem um gerente de script, o formulário não exibirá no SharePoint.
Consulte também
Tarefas
Passo a passo: Importar itens de um Site do SharePoint existente
Como: adicionar um arquivo de modelo BDC existente a um projeto do SharePoint
Conceitos
Diretrizes para a importação de fluxos de trabalho reutilizáveis