Exportar SharePoint para Excel: onde a atualização realmente é executada
Acompanhe uma exportação SharePoint-Excel pelo arquivo de consulta, pela própria solicitação HTTP do Office e pela atualização guardada, e descubra qual etapa falhou de fato.
A exportação para Excel produz três artefatos diferentes conforme a implantação, e a falha pertence exatamente a um deles. Um arquivo de consulta baixado, um CSV estático e uma tabela conectada que se atualiza não são o mesmo resultado, e cada um falha em uma etapa diferente. Saber qual artefato você tem decide se o próximo passo pertence à equipe de rede, à equipe de identidade ou ao proprietário da lista. O mecanismo abaixo acompanha a passagem do navegador para a própria solicitação do Excel.
O que a exportação realmente entrega
Nas listas clássicas do SharePoint, Exportar para Excel baixa um pequeno arquivo de texto cujo corpo é uma URL; em seguida, o Excel lê esse arquivo e faz sua própria solicitação dos dados por trás dele. O arquivo baixado é um ponteiro, não a lista. Uma exportação CSV, por outro lado, contém as próprias linhas e não tem conexão para atualizar. Uma tabela conectada mais recente pode incorporar a consulta diretamente na pasta de trabalho, de modo que nada chega à pasta Downloads.
Toda forma conectada é unidirecional. A atualização traz as linhas atuais da lista para a pasta de trabalho, e editar a tabela não envia nada de volta. Essa assimetria importa para o diagnóstico, porque uma pasta de trabalho que abre com as linhas da semana passada já provou que o arquivo existe e que a conexão foi salva, embora não diga nada sobre se a atualização funciona hoje.
Portanto, a primeira pergunta não é por que a exportação falhou, mas qual artefato o usuário esperava. A resposta restringe a investigação a um de três processos.
Três processos, três identidades diferentes
O download no navegador usa a sessão do navegador, com seus próprios cookies, configuração de proxy e estado de login. O Excel ao abrir o arquivo usa a pilha HTTP do Office, que geralmente segue o proxy das Opções da Internet por usuário em vez da configuração WinHTTP de toda a máquina, e que se autentica com qualquer identidade do Office que o usuário tenha. Uma atualização posterior reutiliza a conexão salva e pode buscar credenciais em cache do Gerenciador de Credenciais do Windows em vez de perguntar.
Esses três contextos podem discordar em uma única máquina, e é por isso que um navegador que abre a lista sem problemas e uma atualização do Excel que retorna um pedido de login são um resultado coerente e não uma contradição. O túnel muda o roteamento da máquina para os três, mas um arquivo de configuração automática de proxy ainda pode enviar as solicitações do Office para outro lugar.
Registre a identidade usada em cada etapa antes de alterar qualquer uma delas. Uma correção aplicada ao navegador não consegue reparar uma solicitação que o Excel faz com outra conta.
Leia o arquivo de passagem antes de mudar qualquer coisa
O arquivo baixado é texto simples e costuma ser curto, então leia-o primeiro. Ele nomeia o host e o ponto de extremidade que o Excel chamará, e esse host é o que precisa ser resolvido e autenticado a partir da máquina do usuário, não necessariamente o endereço visível na barra de endereços do navegador.
Get-Content "$env:USERPROFILE\Downloads\query.iqy"
Resolve-DnsName team.example.net
netsh winhttp show proxy
Compare o host no arquivo com o site de onde o usuário acha que exportou. Um redirecionamento durante a exportação, uma coleção de sites antiga ou uma lista migrada podem deixar um ponteiro para um nome que não serve mais os dados, e o erro resultante parece uma falha de rede. Se o nome resolver e o ponto de extremidade responder, os candidatos restantes são a autenticação e a própria consulta.
Não substitua o nome do host por um endereço IP para fazê-lo funcionar. Isso quebra a verificação do nome do certificado e esconde o problema real atrás de uma solução improvisada que falha na próxima renovação do certificado.
Separe falhas de nome, de login e de consulta
Quatro resultados cobrem quase todo relato, e cada um tem um dono diferente. Um nome que não resolve pertence ao DNS. Uma conexão que expira pertence ao roteamento ou a um proxy. Um pedido de login ou um 401 pertencem à identidade. Uma resposta que chega mas não pode ser analisada pertence à consulta ou ao ponto de extremidade que a lista agora expõe.
| What the user sees | Stage that failed |
|---|---|
| Data source could not be found | Name resolution or the pointer in the file |
| Repeated sign-in prompt | Office identity or cached credential |
| Timeout while refreshing | Route, proxy or the VPN path |
| Refresh succeeds, rows look wrong | Query scope or list view, not connectivity |
A última linha é a que as pessoas diagnosticam mal. Uma atualização que termina e devolve as linhas erradas já provou que cada camada de rede e de identidade funciona, e a pergunta restante é qual exibição ou qual filtro a consulta carrega. Enviar esse ticket para a equipe de rede desperdiça um dia.
Guarde o texto exato do erro e o horário da primeira falha. Ele decide em qual linha da tabela você está, e é a única evidência sobre a qual o proprietário da lista pode agir.
Teste a atualização novamente na mesma lista
Uma vez identificada a etapa que falha, repita a operação que falhou e não uma mais barata. Atualize a mesma lista a partir do ambiente do Excel pretendido, com a conta esperada e o caminho de rede aprovado, e confirme que a contagem de linhas ou um valor alterado conhecido realmente é atualizado. Abrir uma pasta de trabalho salva não prova nada sobre a conexão.
Resista aos reparos amplos: apagar todas as credenciais salvas, executar o Office com privilégios elevados ou desativar um recurso de segurança pode mudar o sintoma sem consertar a etapa. Se a autenticação for a camada que falha, peça ao proprietário da lista que confirme a conta e o fluxo de login suportado em vez de adivinhar no cliente.
Ofereça CSV apenas quando um instantâneo desconectado atender à tarefa e essa exportação for suportada para o ambiente. Alterar o formato de saída altera o fluxo de trabalho e não explica por que a operação conectada parou de funcionar.