Resolver erros e avisos ao visualizar uma página no SharePoint
Após converter um arquivo HTML em uma página mestra do SharePoint ou depois de criar um layout de página, você pode visualizar essa página no navegador. Mas antes de uma página mestra ou o layout de página visualizar, talvez seja necessário resolver problemas que impedem a visualização do servidor de sua página de renderização.
Introdução à resolução de erros de visualização
Após converter um arquivo HTML em uma página mestra do SharePoint ou depois de criar um layout de página, você pode visualizar essa página no navegador. Ao editar e salvar sua página mestra HTML ou layout de página, você poderá atualizar a visualização para ver exatamente como o SharePoint renderiza sua página.
A visualização no Gerenciador de Design é uma visualização dinâmica do servidor, portanto, todos os trechos de código ou controles em sua página, como um controle de navegação ou uma web part controlada por pesquisa, usam dados dinâmicos. Além disso, ao visualizar uma página mestra ou layout de página, você poderá escolher uma visualização genérica apenas desse arquivo ou optar por visualizar como uma página específica em seu site é renderizada com essa página mestra ou layout de página. A visualização do servidor é uma ferramenta altamente útil que complementa a visualização em tempo de design em um editor HTML. Para obter mais informações, consulte Como alterar a página de visualização no Gerenciador de Design do SharePoint.
Mas antes de uma página mestra ou o layout de página visualizar, talvez seja necessário resolver problemas que impedem a visualização do servidor de sua página de renderização. Se a visualização do servidor não estiver funcionando, isso significa que a página mestra ou o layout de página também não funcionará depois que eles forem aplicados ao seu site. No Gerenciador de Design, depois de converter uma página mestre ou criar um layout de página, você poderá clicar no nome do arquivo ou no status da conversão para visualizar esse arquivo. Na página de visualização, a área de notificação na parte superior da página exibe erros ou avisos.
Aqui estão os erros e avisos de visualização que você poderá encontrar e ajuda sobre como resolvê-los.
O arquivo HTML não pode conter <marcas de formulário>
Mensagem
Sua Página Mestra tem uma ou mais marcas DE FORMULÁRIO> HTML<. Para que sua página mestra funcione, remova as marcas (mas você pode deixar o conteúdo nelas).
Resolução
As páginas do SharePoint já estão encapsuladas em uma <marca de formulário> para que ASP.NET possa fazer post-backs (especificamente, uma página do SharePoint.master contém a <marca SharePoint:SharePointForm> que cria uma marca de formulário> real< quando uma página de conteúdo associada é renderizada). Portanto, incluir uma <marca de formulário> em sua página mestra ou layout de página significa que haveria marcas de formulário> aninhadas< na renderização final da página, o que não é válido em HTML. No editor HTML, exclua todas as <marcas de formulário> , salve a página e atualize a visualização.
Se você quiser uma marca de formulário> HTML< no layout da página, deverá colocar o formulário dentro de um espaço reservado de conteúdo com o ID PlaceHolderUtilityContent adicionando este código ao layout da página HTML:
<!--CS: Start Create Snippets From Custom ASP.NET Markup Snippet-->
<!--SPM:<SharePoint:AjaxDelta id="DeltaPlaceHolderUtilityContent" runat="server">-->
<!--SPM:<asp:ContentPlaceHolder id="PlaceHolderUtilityContent" runat="server" />-->
<!--SPM:</SharePoint:AjaxDelta>-->
<!--CE: End Create Snippets From Custom ASP.NET Markup Snippet-->
Você também poderá adicionar a Web Part de Formulário HTML ou a Web Part de Formulário do InfoPath à sua página da Galeria de Trechos de Código. Para saber mais, consulte Trechos de código do Gerenciador de Design do SharePoint.
O arquivo HTML deve ser compatível com a linguagem XML
Mensagem
O SharePoint exige que os arquivos HTML sejam compatíveis com XML. Seu arquivo não é compatível com XML, provavelmente devido a propriedades de marca sem aspas, marcas de fechamento ausentes ou propriedades inválidas em marcas. {Tipo de erro, local do erro}. Ocorreu em: {Time}.
Resolução
Para que um arquivo HTML seja convertido no arquivo ASP.NET correspondente, o arquivo HTML deve estar em conformidade com XML. Esse erro identifica uma marcação específica no arquivo HTML que não está em conformidade com XML. Execute o arquivo HTML por meio de um validador XML, corrija quaisquer problemas no editor HTML, salve o arquivo e atualize a visualização.
Observação
Esse requisito substitui alguns padrões HTML 5. Por exemplo, em HTML 5 você pode especificar o doctype em minúsculas, mas no XML o doctype deve ser maiúsculas.
O arquivo HTML contém marcação problemática
Mensagem
O SharePoint não pode analisar esse arquivo, provavelmente devido a um snippet do SharePoint formatado incorretamente. A marcação no local a seguir está causando problemas. Edite a marcação manualmente para corrigi-la ou substitua-a por um novo snippet da Galeria snippet. {Tipo de erro, local do erro}. Ocorreu em: {Time}.
Resolução
Você verá esse erro quando houver um problema com um trecho de código do SharePoint em seu arquivo HTML. Para corrigir esse erro, desfaça qualquer alteração que tenha causado o erro ou substitua o trecho problemático por um novo, seja da Galeria de Trechos de Código ou de uma página mestra ou arquivo de layout de página diferente que tenha uma versão funcional do trecho. No editor HTML, depois de corrigir ou substituir o trecho, salve a página e atualize a visualização.## A página mestra de um layout de página foi alterada
Mensagem
A página mestra do layout desta página foi alterada, o que causará inconsistências em seu site. Clique aqui para atualizar as seções do layout da página que representam regiões de página mestra.
Resolução
Para que um layout de página funcione com uma determinada página mestra, os dois devem ter o mesmo conjunto de espaços reservados para conteúdo. Se você criar um layout de página com base em uma página mestra específica e editar essa página mestra HTML, verá essa mensagem. Mesmo que você saiba que as alterações na página mestra não adicionaram ou removeram os espaços reservados para conteúdo, você deverá atualizar as regiões de conteúdo do layout de página mesmo assim, para que possa visualizar as alterações da página mestra que possam afetar o layout de página.
Redefinir a visualização
Mensagem
Sua página mestra (layout de página) não tem avisos ou erros. Redefinir a visualização para o estado original.
Explicação
Esta mensagem simplesmente confirma que o processo de conversão funcionou sem erros ou problemas. No entanto, ao visualizar uma página, você pode sair dessa página específica ou alterar a visualização de alguma outra maneira. Se isso acontecer, você sempre poderá escolher Redefinir a visualização na área de mensagem. Isso atualiza a visualização para que ela use a página mestra específica ou o layout de página em que você está trabalhando e qualquer página selecionada na opção Alterar Página de Visualização no canto superior esquerdo.
Alterar a página de visualização
Mensagem
No momento, você está visualizando sua página mestra (layout de página) sem nenhum conteúdo. Você pode alterar a página que está visualizando no menu acima.
Explicação
Você vê esta mensagem quando não está usando uma página dinâmica do SharePoint para visualizar sua página mestra ou layout de página. Por exemplo, se você estiver visualizando um layout de página, poderá escolher Alterar Página de Visualização no canto superior esquerdo e, em seguida, selecionar uma página de conteúdo específica para visualizar com o layout de página. Dessa forma, você poderá visualizar o layout de página com o conteúdo real da página nos campos da página. Se quiser que a visualização mostre apenas as posições dos campos de página ou do ContentPlaceHolderMain, você sempre poderá usar a opção Alterar Página de Visualização para voltar para uma visualização genérica.