Dropbox 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 Dropbox-account, persoonlijk of zakelijk.
Voor een zakelijk account: de rol teambeheerder in het Dropbox-team.

Verbinden

Ga in APIboard naar Koppelen > Koppelingen.
Zoek Dropbox 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.
Kies bij de vraag of je een persoonlijk of zakelijk (team-)account koppelt: klik op Verbind persoonlijk account of Verbind zakelijk (team) account.
Er opent een inlogvenster van Dropbox. Log in met dat account en geef APIboard toestemming voor de gevraagde rechten.
APIboard haalt direct de eerste gegevens op (Data wordt opgehaald…). Daarna zie je Verbonden met Dropbox, 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.

Account of administratie kiezen

De keuze tussen persoonlijk en zakelijk is de enige keuze. Een zakelijke koppeling is op teamniveau en krijgt de teamnaam als naam; een persoonlijke koppeling krijgt je weergavenaam of e-mailadres. Je kunt de keuze achteraf niet wisselen zonder de koppeling te verwijderen.

Welke gegevens je krijgt

Onderwerp	Tabellen
Persoonlijk account	Bestanden, Gedeelde bestanden, Bestandsverzoeken, Opslaggebruik
Zakelijk (team) account	Teamleden, Opslaggebruik, Teambestanden, Deelgebeurtenissen, Gekoppelde apps, Gekoppelde apparaten

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

Hoe vaak vernieuwd

Bestanden, teambestanden en deelgebeurtenissen worden incrementeel opgehaald: APIboard volgt de wijzigingen die Dropbox bijhoudt. De overige tabellen worden elke ronde volledig opgehaald. Opslaggebruik is een meting per dag (bij een zakelijk account per teamlid). Verklaart Dropbox de wijzigingslijst ongeldig, dan laadt APIboard die tabel volledig opnieuw. De eerste vulling loopt over meerdere runs tot elke tabel een eerste volledige ronde heeft.

De eerste vulling van gegevens met een datum (zoals facturen, uren of mutaties) begint op 1 januari van het jaar dat bij je pakket hoort: Proefperiode en Basis dit kalenderjaar, Team ook vorig jaar, Pro ook twee jaar terug. Stamgegevens (zoals relaties of rekeningen) worden altijd volledig opgehaald. Wat al is opgehaald, verwijdert APIboard niet als je pakket kleiner wordt.

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

Goed om te weten

APIboard haalt nooit de inhoud van je bestanden op, alleen metadata zoals naam, pad, grootte en of een bestand gedeeld is.
Bij een zakelijk account vraagt APIboard extra rechten voor teamgegevens, zoals leden, teambestanden, activiteit en sessies. Dropbox toont ze in het toestemmingsscherm.
Dropbox beperkt het aantal aanroepen; APIboard laat tijd tussen de aanroepen en wacht bij een limiet.
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 kiest opnieuw persoonlijk of zakelijk en logt opnieuw in. 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

Koppelen mislukt. Controleer je gegevens en probeer het opnieuw. Dit is de standaardmelding. Mogelijke oorzaken: bij Verbind zakelijk (team) account is het account geen onderdeel van een team, of je bent geen teambeheerder (vraag een teambeheerder of kies Verbind persoonlijk account); je hebt niet alle gevraagde rechten gegeven; of Dropbox gaf geen vernieuwingstoken terug. Trek in die laatste twee gevallen de toegang van APIboard in via dropbox.com/account/connected_apps en verbind opnieuw met alle gevraagde rechten.
Je hebt geen toestemming gegeven. Probeer opnieuw en accepteer de gevraagde rechten. Je hebt in het venster van Dropbox de toestemming geweigerd. Start opnieuw en geef APIboard toestemming.
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 Dropbox.
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.