SharePoint-bestanden in je Azure datawarehouse en Power BI
Bestanden uit SharePoint-documentbibliotheken
Yres haalt bestanden uit SharePoint Online op via Microsoft Graph. Je registreert een app in Microsoft Entra ID, geeft die de applicatiepermissie Sites.Read.All met admin consent en vult tenant, client-ID en client secret in. Per bestand wijs je de site, de documentbibliotheek en het pad aan. Yres kopieert het bestand eerst naar de opslag van je eigen omgeving, leest het daar in en ruimt de tussenkopie op. Daarna staat de inhoud als tabel in je Azure SQL-database, klaar voor Power BI.
In het kort
- Verbinding
- Microsoft Graph, met een app-registratie in Microsoft Entra ID (app-only, zonder ingelogde gebruiker)
- Benodigde rechten
- Applicatiepermissie Sites.Read.All op Microsoft Graph, met admin consent. De oude route via appinv.aspx werkt niet meer
- Soort bron
- Bestandsbron: je selecteert bestanden in een documentbibliotheek; er is geen tabellenlijst die Yres ophaalt
- Hoe een bestand wordt gevonden
- Site → documentbibliotheek → pad. Het eerste deel van de bestandslocatie moet de naam van de bibliotheek zijn, bijvoorbeeld "Gedeelde documenten/Financieel/"
- Soorten sites
- Sites onder /sites, /teams en /personal, of een adres zonder achtervoegsel
- Waar draait het
- SharePoint Online is publiek bereikbaar, dus de cloud-runtime van Azure Data Factory volstaat. Een self-hosted integration runtime is alleen nodig bij een afgeschermd netwerk
- Geheimen
- Client-ID, client secret en tenantgegevens staan in de Key Vault van je eigen Azure-omgeving; de webapplicatie bewaart ze niet
Wat je zelf regelt
- 1Registreer een app in Microsoft Entra ID (App registrations → New registration) en noteer de Application (client) ID en de Directory (tenant) ID.
- 2Maak onder Certificates & secrets een client secret aan en kopieer de waarde meteen; die wordt maar één keer getoond.
- 3Voeg onder API permissions de Microsoft Graph-applicatiepermissie Sites.Read.All toe en laat een beheerder admin consent verlenen.
- 4Voeg in Yres de bron SharePoint toe met tenantnaam, het soort site (sites, teams, personal of leeg), tenant-ID, client-ID en secret.
- 5Kies de bestanden en geef als locatie het pad op dat begint met de naam van de documentbibliotheek.
Wanneer heb je dit nodig — en wanneer niet
Een losse connector is genoeg als…
Leest één rapport één Excel-bestand uit SharePoint, dan is de SharePoint-connector van Power BI zelf genoeg. Daar heb je geen datawarehouse voor nodig.
Yres voegt iets toe als…
Yres wordt zinvol wanneer de business begrotingen, targets of mappingtabellen in SharePoint bijhoudt en die cijfers naast je ERP-data moeten staan. Het bestand wordt dan een gewone tabel in het datawarehouse, met dezelfde planning en controle als je andere bronnen.
Veelgestelde vragen: SharePoint
Mijn SharePoint-koppeling werkte en faalt nu. Waar ligt dat aan?
Waarschijnlijk aan de rechten. Tot versie 1.55 kreeg de app toegang via appinv.aspx en Azure ACS. Microsoft heeft die app-only-flow uitgezet. Vanaf versie 1.56 werkt Yres via Microsoft Graph. De velden die je invult zijn gelijk gebleven, maar de app heeft nu Sites.Read.All op Microsoft Graph nodig, met admin consent.
Waarom vindt Yres mijn bestand niet, terwijl de map klopt?
Yres leest het eerste deel van de bestandslocatie als de naam van de documentbibliotheek. Staat er alleen een mapnaam, zonder bibliotheek ervoor, dan is er geen bibliotheek te vinden en faalt de stap. Begin het pad dus met bijvoorbeeld "Gedeelde documenten/" en zet daarachter de mappen.
Kan ik ook bestanden laden uit een Teams-site of van een persoonlijke site?
Ja. Bij het toevoegen van de bron kies je het soort site: sites, teams, personal of leeg. Yres stelt daarmee het siteadres samen uit je tenantnaam en gebruikt hetzelfde onderscheid bij het ophalen van de bestanden.
Blijft er ergens een kopie van mijn SharePoint-bestand achter?
Nee. Het laden gaat in twee stappen: eerst een binaire kopie naar de Blob Storage van je eigen omgeving, daarna het inlezen in de stagingtabellen. Na afloop ruimt Yres die tussenkopie automatisch op. Het origineel in SharePoint blijft onaangeroerd, want de app heeft alleen leesrechten.
Volledige technische beschrijving in de kennisbank →·Laatst gecontroleerd:
Datawarehouse-automatisering die in je eigen Azure draait
Gebouwd voor organisaties op Azure en Power BI. Yres koppelt je bronnen, bewaart de historie en rolt wijzigingen gecontroleerd uit, zonder handwerk.