Microsoft OneDrive koppelen | Helpcentrum

Wat je nodig hebt

De rol Admin of Member in je organisatie. Viewers hebben geen toegang tot Koppelen. Zie Wie mag koppelen?.
Tweestapsverificatie (2FA) op je APIboard-account.
Een vrije plek in je pakket: Proefperiode en Basis 3 koppelingen, Team 7, Pro 10 (plus eventueel een gekochte extra koppeling).
Een Microsoft-werk- of schoolaccount. Persoonlijke Microsoft-accounts werken niet.
Toestemming van je organisatie: staat toestemming geven voor apps uit, dan moet een IT-beheerder APIboard eenmalig goedkeuren (zie hieronder).

Verbinden

Ga in APIboard naar Koppelen > Koppelingen.
Zoek Microsoft OneDrive bij Beschikbare koppelingen (of typ de naam in het zoekveld) en klik op de kaart. Er opent een venster dat je stap voor stap begeleidt.
Klik op Verbind met Microsoft OneDrive. Er opent een inlogvenster van Microsoft.
Log in met je Microsoft-werk- of schoolaccount en geef APIboard leestoegang tot je OneDrive.
APIboard haalt direct de eerste gegevens op (Data wordt opgehaald…). Daarna zie je Verbonden met Microsoft OneDrive, met de dashboards die klaarstaan. Op Koppelen > Koppelingen staat de pil Bezig met ophalen… tot de eerste volledige ronde klaar is; daarna staat er Actief.

Let op: APIboard leest alleen gegevens over je bestanden (naam, map, grootte, datums, deelstatus), nooit de inhoud. Alles wat jouw Microsoft-account kan zien, wordt zichtbaar voor je APIboard-team.

Toestemming van je IT-beheerder

Staat toestemming geven in jouw organisatie uit? Dan moet een IT-beheerder APIboard eenmalig goedkeuren. APIboard toont dan de melding “Je organisatie laat alleen een beheerder deze toestemming geven” met een blok Link voor je IT-beheerder en de knop Kopieer. Stuur die link naar je IT-beheerder. Die opent hem, geeft toestemming en ziet daarna Toestemming gegeven: “APIboard heeft nu toestemming voor Microsoft OneDrive in je organisatie. Je collega kan de koppeling nu maken in APIboard.” Daarna maak je zelf de koppeling opnieuw. Ziet de beheerder Toestemming niet gegeven, dan staat in de melding een foutcode (AADSTS…); probeer de link dan opnieuw of neem contact op met support.

Welke gegevens je krijgt

Onderwerp	Tabellen
Bestanden	Bestanden
Gebruik	Opslagtrend, Weergaven per dag

Je vraagt de gegevens op via de API en ziet ze in de Datawerkbank. Alle tabellen en velden staan in de API-documentatie van Microsoft OneDrive.

Hoe vaak vernieuwd

APIboard volgt de wijzigingen op je drive (Microsoft Graph delta), dus incrementeel. Een ronde bestaat uit de drive en het opslagquotum (een rij per dag), de bestanden en de weergaven per dag over de laatste 89 dagen. Bestanden die verwijderd zijn, worden als verwijderd gemarkeerd; rijen die in een volledige pas niet meer voorkomen, worden na afloop opgeruimd. Een ronde kan over meerdere runs lopen.

Hoe vaak dat gebeurt, hangt af van je pakket (Proefperiode, Basis, Team of Pro): zie Hoe vaak worden gegevens vernieuwd?.

Goed om te weten

De koppeling is leesrechten op je eigen OneDrive (Files.Read) en krijgt de naam “OneDrive van” plus je weergavenaam.
Een Microsoft-login kan maar één keer worden gekoppeld.
De deelstatus van een bestand loopt achter tot het bestand zelf weer wijzigt. Een bestand waar het account de toegang toe verliest, blijft staan tot een volledige pas.
Microsoft beperkt het aantal aanroepen per organisatie. Bij een limiet wacht APIboard en gaat daarna door.
Opnieuw verbinden vervangt alleen je inloggegevens. De koppeling, alle opgehaalde gegevens en de syncstand blijven staan, de status gaat terug naar Actief en de volgende synchronisatie haalt alleen wijzigingen op. Het verbindscherm opent direct, zonder bevestigingsvraag. Je logt opnieuw in bij Microsoft en geeft toestemming. Log je in met een ander account, dan weigert APIboard dat met de melding “Dit is een ander account dan de koppeling die je opnieuw verbindt. Log in met hetzelfde account.” Dan is het een nieuwe koppeling.
Je vindt Opnieuw verbinden (pijlicoon) in het zijpaneel dat opent als je op de kaart van de koppeling klikt.
Een koppeling of account verwijderen (Koppeling verwijderen of het verwijderpictogram bij een account) wist ook alle opgehaalde gegevens. Dat kan niet ongedaan worden gemaakt.

Problemen oplossen

Je organisatie laat alleen een beheerder deze toestemming geven. Stuur de link hieronder naar je IT-beheerder; na goedkeuring kun je opnieuw koppelen. Je organisatie staat niet toe dat gewone gebruikers apps toestemming geven. Kopieer de link onder Link voor je IT-beheerder met de knop Kopieer en stuur hem naar je IT-beheerder. Is die klaar, dan kun je opnieuw koppelen.
Verbinden met Microsoft is niet gelukt ({code}). Microsoft gaf een foutcode terug, met de eerste regel van de uitleg van Microsoft. Probeer het opnieuw; houdt het aan, neem dan contact op met support en geef de foutcode door.
Koppelen mislukt. Controleer je gegevens en probeer het opnieuw. Dit is de standaardmelding. Gaf Microsoft geen vernieuwingstoken terug, of zijn niet alle gevraagde rechten gegeven? Verbind dan opnieuw en accepteer alle gevraagde rechten.
OAuth-sessie verlopen, probeer opnieuw te verbinden. Je deed er langer dan 10 minuten over. Start de koppeling opnieuw en rond hem in één keer af, in dezelfde browser.
Kon geen popup-venster openen. Sta pop-ups toe voor deze site. Sta pop-ups toe voor APIboard in je browser en klik opnieuw op Verbind met Microsoft OneDrive.
Viewers kunnen geen koppelingen beheren. Je hebt de rol Viewer. Vraag een Admin van je organisatie om je de rol Member te geven, of om de koppeling te maken.
Dit account is al gekoppeld. Wat je probeert te koppelen, staat al in je organisatie. Zoek het op onder Koppelen > Koppelingen.
Je hebt je koppelingen-limiet bereikt voor je pakket. (of Je hebt je accounts-limiet bereikt voor je pakket.) Kies Bekijk abonnementen om te upgraden, of koop een extra koppeling of extra account.
De pil Fout bij de koppeling. Een synchronisatie is mislukt of de toegang is verlopen of ingetrokken. APIboard probeert het bij een tijdelijke fout later zelf opnieuw; bij een verlopen toegang gebruik je Opnieuw verbinden.