Cartões da Exibição de Quadro Mostram Campos em Branco: Causa e Solução

Os cartões da exibição de quadro no SharePoint e Microsoft Lists exibem campos em branco em vez dos dados esperados. Esse problema ocorre quando o layout do cartão referencia colunas que não existem ou quando a formatação JSON da exibição contém referências inválidas. Este artigo explica a causa técnica raiz dos campos em branco nos cartões e fornece correções passo a passo para restaurar seus dados.

Por que os Cartões da Exibição de Quadro Exibem Campos em Branco

A exibição de quadro no SharePoint e Lists agrupa itens por uma coluna escolhida e exibe layouts de cartão. Cada cartão pode mostrar campos da lista ou biblioteca. Quando um cartão exibe um campo em branco, a causa raiz é quase sempre uma incompatibilidade entre a definição do layout do cartão e o esquema real de colunas da lista ou biblioteca.

O layout do cartão é definido usando JSON (JavaScript Object Notation). Esse JSON informa ao SharePoint quais colunas exibir em cada cartão. Se uma coluna referenciada no JSON for excluída, renomeada ou movida, o SharePoint não consegue resolver a referência. Ele renderiza o campo como em branco em vez de mostrar um erro.

O Papel dos Nomes Internos de Colunas

Toda coluna em uma lista do SharePoint tem dois nomes: um nome de exibição (visível aos usuários) e um nome interno (usado pelo sistema). O JSON do layout do cartão usa o nome interno. Quando você renomeia uma coluna, seu nome interno permanece o mesmo. Mas se você excluir uma coluna e criar uma nova com o mesmo nome de exibição, o nome interno será diferente. O JSON antigo ainda referencia o nome interno antigo, e o cartão exibe um campo em branco.

Erros de Formatação JSON

Um único erro de sintaxe no JSON — como uma vírgula faltando, uma chave extra ou uma chave digitada incorretamente — pode fazer com que todo o layout do cartão falhe silenciosamente. O SharePoint pode recorrer a um layout padrão que exibe campos em branco. Isso é comum quando os usuários editam manualmente o JSON no painel Format current view.

Passos para Corrigir Campos em Branco em Cartões da Exibição de Quadro

Siga estes passos para identificar e reparar o JSON do layout do cartão. Execute estas etapas em uma lista do SharePoint ou Microsoft Lists que use a exibição de quadro.

1. Abra a lista ou biblioteca na exibição de quadro
   Vá para a lista ou biblioteca que exibe campos em branco nos cartões. No seletor de exibição no canto superior direito da página, escolha a exibição de quadro que apresenta o problema. Se a exibição não estiver selecionada, selecione-a.
2. Abra o painel Format current view
   Clique na seta suspensa ao lado do nome da exibição (ou nas opções Switch view). Selecione Format current view. Um painel é aberto no lado direito da página. Esse painel contém o JSON que define o layout do cartão.
3. Inspecione o JSON em busca de referências a colunas
   No painel Format current view, procure pela seção card ou fields. Cada objeto de campo deve ter uma propriedade como "internalName" ou "name". Compare cada nome interno com as colunas reais da sua lista. Para ver os nomes internos, vá para as configurações da lista, clique no nome de uma coluna e observe o parâmetro de URL Field=. O valor após Field= é o nome interno.
4. Substitua nomes internos incorretos ou ausentes
   Se um nome interno referenciado não corresponder a nenhuma coluna atual, substitua-o pelo nome interno correto. Se a coluna foi excluída, remova todo o objeto de campo do JSON. Tenha cuidado para preservar a sintaxe JSON válida — use um validador JSON, se necessário.
5. Aplique o JSON corrigido
   Após editar o JSON, clique no botão Preview (se disponível) para verificar se os campos do cartão exibem dados. Em seguida, clique em Save para aplicar as alterações. Atualize a página para confirmar que os campos em branco agora estão preenchidos.

Se os Cartões da Exibição de Quadro Ainda Exibirem Campos em Branco

Se a correção principal não resolver o problema, outros fatores podem causar campos em branco. Abaixo estão cenários comuns e suas correções específicas.

Cartão da Exibição de Quadro Exibe Campo em Branco Após Renomear uma Coluna

Renomear uma coluna não altera seu nome interno. O JSON deve continuar funcionando. Se campos em branco aparecerem após uma renomeação, verifique se há referências de nome de exibição codificadas no JSON. Alguns layouts de cartão mais antigos usavam nomes de exibição em vez de nomes internos. Substitua qualquer nome de exibição pelo nome interno correto.

Cartão da Exibição de Quadro Exibe Campo em Branco Após Importar uma Lista

Ao importar uma lista de um CSV ou arquivo Excel, as colunas podem ter nomes internos diferentes da lista original. Abra o painel Format current view e compare cada nome interno no JSON com as colunas da lista importada. Atualize o JSON para corresponder aos novos nomes internos.

Cartão da Exibição de Quadro Exibe Campo em Branco para uma Coluna de Pesquisa

Colunas de pesquisa exigem uma sintaxe específica no JSON. O nome interno deve incluir a coluna de origem da pesquisa, como LookupColumnName.ID ou LookupColumnName.Title. Se o JSON referenciar apenas o nome da coluna de pesquisa sem o subcampo, o cartão exibirá um campo em branco. Adicione o subcampo correto após um ponto.

Exibição de Quadro vs Exibição de Galeria: Comportamento dos Campos do Cartão

Item	Exibição de Quadro	Exibição de Galeria
Fonte do layout do cartão	JSON no painel Format current view	JSON no painel Format current view
Método de referência de campo	Nome interno no JSON	Nome interno no JSON
Comportamento de campo em branco	Espaço vazio no cartão	Espaço vazio no cartão
Causa comum de campos em branco	Colunas excluídas ou renomeadas	Colunas excluídas ou renomeadas
Local da correção	Painel Format current view	Painel Format current view

A causa raiz e a correção para campos em branco são idênticas na exibição de quadro e na exibição de galeria. Ambas as exibições usam o mesmo mecanismo de formatação JSON. Os passos deste artigo se aplicam a ambas as exibições sem modificação.

Após aplicar o JSON corrigido, sempre teste a exibição adicionando um novo item ou editando um existente. Se os campos em branco reaparecerem, verifique o JSON em busca de qualquer coluna que foi adicionada após a criação do layout. Remova ou atualize essas referências conforme necessário.

Para evitar campos em branco no futuro, sempre use nomes internos de colunas ao editar o JSON do layout do cartão. Antes de excluir uma coluna, remova sua referência de qualquer JSON de exibição de quadro ou galeria. Use o painel Format current view para exportar e fazer backup do JSON do layout do cartão antes de fazer alterações nas colunas da lista.