Esportazione SharePoint in Excel: dove viene eseguito davvero l’aggiornamento
Seguite un’esportazione SharePoint-Excel attraverso il file di query, la richiesta HTTP di Office e l’aggiornamento salvato, e scoprite quale fase è davvero fallita.
L’esportazione in Excel produce tre artefatti diversi a seconda della distribuzione, e l’errore appartiene esattamente a uno di essi. Un file di query scaricato, un CSV statico e una tabella connessa che si aggiorna non sono lo stesso risultato, e ciascuno fallisce in una fase diversa. Sapere quale artefatto avete decide se il passo successivo spetta al team di rete, al team delle identità o al proprietario dell’elenco. Il meccanismo seguente segue il passaggio dal browser alla richiesta di Excel stessa.
Che cosa consegna davvero l’esportazione
Negli elenchi classici di SharePoint, Esporta in Excel scarica un piccolo file di testo il cui corpo è un URL, poi Excel legge quel file ed effettua una propria richiesta dei dati sottostanti. Il file scaricato è un puntatore, non l’elenco. Un’esportazione CSV, al contrario, contiene le righe stesse e non ha alcuna connessione per l’aggiornamento. Una tabella connessa più recente può incorporare la query direttamente nella cartella di lavoro, così nulla finisce nella cartella Download.
Ogni forma connessa è unidirezionale. L’aggiornamento porta le righe correnti dall’elenco alla cartella di lavoro, e modificare la tabella non restituisce nulla. Questa asimmetria conta per la diagnosi, perché una cartella di lavoro che si apre con le righe della settimana scorsa ha già dimostrato che il file esiste e che la connessione è stata salvata, pur non dicendo nulla sul fatto che l’aggiornamento funzioni oggi.
Dunque la prima domanda non è perché l’esportazione è fallita, ma quale artefatto si aspettava l’utente. La risposta restringe l’indagine a uno di tre processi.
Tre processi, tre identità diverse
Il download nel browser usa la sessione del browser, con i suoi cookie, la configurazione del proxy e lo stato di accesso. Excel che apre il file usa lo stack HTTP di Office, che in genere segue il proxy delle Opzioni Internet per utente anziché l’impostazione WinHTTP dell’intera macchina, e che si autentica con qualunque identità Office abbia l’utente. Un aggiornamento successivo riutilizza la connessione salvata e può prelevare credenziali memorizzate nella Gestione credenziali di Windows invece di chiedere.
Questi tre contesti possono essere in disaccordo su una sola macchina, ed è per questo che un browser che apre l’elenco senza problemi e un aggiornamento Excel che restituisce una richiesta di accesso sono un risultato coerente e non una contraddizione. Il tunnel cambia l’instradamento della macchina per tutti e tre, ma un file di configurazione automatica del proxy può comunque inviare le richieste di Office altrove.
Annotate l’identità usata in ogni fase prima di cambiarne una. Una correzione applicata al browser non può riparare una richiesta che Excel effettua con un altro account.
Leggete il file di passaggio prima di cambiare qualcosa
Il file scaricato è testo semplice e di solito breve, quindi leggetelo per primo. Indica l’host e l’endpoint che Excel chiamerà, e quell’host è quello che deve essere risolto e autenticato dalla macchina dell’utente, non necessariamente l’indirizzo visibile nella barra degli indirizzi del browser.
Get-Content "$env:USERPROFILE\Downloads\query.iqy"
Resolve-DnsName team.example.net
netsh winhttp show proxy
Confrontate l’host nel file con il sito da cui l’utente ritiene di avere esportato. Un reindirizzamento durante l’esportazione, una raccolta siti obsoleta o un elenco migrato possono lasciare un puntatore a un nome che non serve più i dati, e l’errore risultante sembra un guasto di rete. Se il nome si risolve e l’endpoint risponde, i candidati rimanenti sono l’autenticazione e la query stessa.
Non sostituite il nome host con un indirizzo IP per farlo funzionare. Questo rompe il controllo del nome del certificato e nasconde il problema reale dietro un espediente che fallisce al successivo rinnovo del certificato.
Separate i guasti di nome, di accesso e di query
Quattro esiti coprono quasi ogni segnalazione, e ciascuno ha un proprietario diverso. Un nome che non si risolve appartiene al DNS. Una connessione che va in timeout appartiene all’instradamento o a un proxy. Una richiesta di accesso o un 401 appartengono all’identità. Una risposta che arriva ma non può essere analizzata appartiene alla query o all’endpoint che l’elenco ora espone.
| 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 |
L’ultima riga è quella che le persone diagnosticano male. Un aggiornamento che si completa e restituisce le righe sbagliate ha già dimostrato che ogni livello di rete e di identità funziona, e la domanda che resta è quale vista o quale filtro porti la query. Inviare quel ticket al team di rete spreca una giornata.
Conservate il testo esatto dell’errore e l’ora del primo guasto. Decide in quale riga della tabella vi trovate, ed è l’unica prova su cui il proprietario dell’elenco può agire.
Riprovate l’aggiornamento sullo stesso elenco
Una volta identificata la fase che fallisce, ripetete l’operazione fallita e non una più economica. Aggiornate lo stesso elenco dall’ambiente Excel previsto, con l’account atteso e il percorso di rete approvato, e confermate che il conteggio delle righe o un valore modificato noto si aggiorni davvero. Aprire una cartella di lavoro salvata non dimostra nulla sulla connessione.
Resistete alle riparazioni ampie: cancellare tutte le credenziali salvate, eseguire Office con privilegi elevati o disattivare una funzione di sicurezza può cambiare il sintomo senza correggere la fase. Se l’autenticazione è il livello che fallisce, chiedete al proprietario dell’elenco di confermare l’account e il flusso di accesso supportato invece di indovinare sul client.
Offrite CSV solo quando un’istantanea disconnessa soddisfa l’attività e quell’esportazione è supportata per l’ambiente. Cambiare il formato di output cambia il flusso di lavoro e non spiega perché l’operazione connessa ha smesso di funzionare.