SharePoint-export naar Excel: waar het verversen werkelijk gebeurt

Een export naar Excel levert afhankelijk van de implementatie drie verschillende artefacten op, en de fout hoort bij precies één daarvan. Een gedownload querybestand, een statische CSV en een gekoppelde tabel die ververst zijn niet hetzelfde resultaat, en elk daarvan faalt in een andere fase. Weten welk artefact u hebt, bepaalt of de volgende stap bij het netwerkteam, het identiteitsteam of de lijsteigenaar hoort. Het mechanisme hieronder volgt de overdracht van de browser naar de eigen aanvraag van Excel.

Wat de export werkelijk overdraagt

Bij klassieke SharePoint-lijsten downloadt Exporteren naar Excel een klein tekstbestand waarvan de inhoud een URL is; Excel leest dat bestand en doet vervolgens een eigen aanvraag voor de gegevens erachter. Het gedownloade bestand is een verwijzing, niet de lijst. Een CSV-export bevat daarentegen de rijen zelf en heeft geen verbinding om te verversen. Een nieuwere gekoppelde tabel kan de query rechtstreeks in de werkmap opnemen, zodat er helemaal niets in de map Downloads terechtkomt.

Elke gekoppelde vorm is eenrichtingsverkeer. Verversen haalt actuele rijen uit de lijst naar de werkmap, en het bewerken van de tabel stuurt niets terug. Die asymmetrie is belangrijk voor de diagnose, want een werkmap die opent met de rijen van vorige week heeft al bewezen dat het bestand bestaat en de verbinding is opgeslagen, terwijl hij niets zegt over of verversen vandaag werkt.

De eerste vraag is dus niet waarom de export is mislukt, maar welk artefact de gebruiker verwachtte. Het antwoord beperkt het onderzoek tot een van drie processen.

Drie processen, drie verschillende identiteiten

De download in de browser gebruikt de browsersessie, met zijn eigen cookies, proxyconfiguratie en aanmeldstatus. Excel dat het bestand opent, gebruikt de HTTP-stack van Office, die doorgaans de proxy uit Internetopties per gebruiker volgt in plaats van de machinebrede WinHTTP-instelling, en die zich authenticeert met welke Office-identiteit de gebruiker ook heeft. Een latere verversing hergebruikt de opgeslagen verbinding en kan in plaats van te vragen inloggegevens uit Windows Verificatiebeheer oppakken.

Die drie contexten kunnen het op één machine oneens zijn, en daarom is een browser die de lijst prima opent en een Excel-verversing die om aanmelding vraagt een samenhangend resultaat en geen tegenspraak. De tunnel verandert de routing van de machine voor alle drie, maar een proxy-autoconfiguratiebestand kan Office-aanvragen nog steeds ergens anders heen sturen.

Noteer de identiteit die in elke fase wordt gebruikt voordat u er een wijzigt. Een oplossing die op de browser wordt toegepast, kan een aanvraag die Excel onder een ander account doet niet repareren.

Lees het overdrachtsbestand voordat u iets wijzigt

Het gedownloade bestand is platte tekst en meestal kort, dus lees het eerst. Het noemt de host en het eindpunt die Excel gaat aanroepen, en die host is degene die vanaf de machine van de gebruiker moet resolven en authenticeren, niet noodzakelijk het adres dat in de adresbalk van de browser zichtbaar is.

Get-Content "$env:USERPROFILE\Downloads\query.iqy"
Resolve-DnsName team.example.net
netsh winhttp show proxy

Vergelijk de host in het bestand met de site waarvan de gebruiker denkt dat hij heeft geëxporteerd. Een omleiding tijdens de export, een oude siteverzameling of een gemigreerde lijst kan een verwijzing achterlaten naar een naam die de gegevens niet meer levert, en de resulterende fout ziet eruit als een netwerkstoring. Als de naam resolvet en het eindpunt antwoordt, zijn de overgebleven kandidaten de authenticatie en de query zelf.

Vervang de hostnaam niet door een IP-adres om het werkend te krijgen. Dat breekt de naamcontrole van het certificaat en verbergt het echte probleem achter een workaround die bij de volgende certificaatvernieuwing faalt.

Naam-, aanmeld- en queryfouten scheiden

Vier uitkomsten dekken bijna elk rapport, en elk ervan heeft een andere eigenaar. Een naam die niet resolvet, hoort bij DNS. Een verbinding die een time-out geeft, hoort bij routing of een proxy. Een aanmeldprompt of een 401 hoort bij identiteit. Een antwoord dat aankomt maar niet kan worden verwerkt, hoort bij de query of het eindpunt dat de lijst nu aanbiedt.

De laatste rij is degene die mensen verkeerd diagnosticeren. Een verversing die voltooit en de verkeerde rijen teruggeeft, heeft bewezen dat elke netwerk- en identiteitslaag werkt, en de resterende vraag is welke weergave of welk filter de query meevoert. Dat ticket naar het netwerkteam sturen kost een dag.

Bewaar de exacte fouttekst en het tijdstip van de eerste storing. Die bepaalt in welke rij van de tabel u zit, en het is het enige bewijs waarop de lijsteigenaar kan handelen.

Test de verversing opnieuw op dezelfde lijst

Zodra de falende fase is geïdentificeerd, herhaal dan de bewerking die faalde en niet een goedkopere. Ververs dezelfde lijst vanuit de bedoelde Excel-omgeving, met het verwachte account en het goedgekeurde netwerkpad, en bevestig dat het aantal rijen of een bekende gewijzigde waarde daadwerkelijk bijwerkt. Een opgeslagen werkmap openen bewijst niets over de verbinding.

Weersta de brede reparaties: alle opgeslagen inloggegevens wissen, Office verhoogd uitvoeren of een beveiligingsfunctie uitschakelen kan het symptoom veranderen zonder de fase te repareren. Als authenticatie de falende laag is, vraag de lijsteigenaar dan het account en de ondersteunde aanmeldingsstroom te bevestigen in plaats van op de client te gokken.

Bied CSV alleen aan wanneer een losgekoppelde momentopname de taak vervult en die export voor de omgeving wordt ondersteund. Het uitvoerformaat wijzigen verandert de werkwijze en verklaart niet waarom de gekoppelde bewerking is gestopt met werken.