Voor Excel en OData-clients
- Kies Basic authenticatie.
- Gebruik je Dashview e-mailadres als username.
- Gebruik je persoonlijke Dashview access key als password.
- Gebruik hier niet je normale Dashview wachtwoord.
External data access
Data Gateway en OData voor externe tools
De Dashview Data Gateway geeft externe tools alleen-lezen toegang tot tenant-scoped datasources. Gebruik het OData endpoint voor Excel, Power BI en andere OData-clients; scripts kunnen dezelfde access key ook als bearer token gebruiken.
1. OData service URL
Gebruik voor OData altijd de service root met /odata:
https://dashview-data-gateway-1097018975400.europe-west4.run.app/odata
De kale Cloud Run URL is niet het OData servicedocument. Excel en andere OData-clients moeten daarom de URL met
/odata gebruiken.
2. Authenticatie
Voor scripts en API-clients
Stuur dezelfde access key als bearer token.
Authorization: Bearer <DASHVIEW_ACCESS_KEY>Maak of roteer je persoonlijke access key in My account. De key blijft gekoppeld aan jouw tenant- en gebruikerscontext.
3. Excel koppelen
- Open Excel en kies Data → Get Data → From Other Sources → OData Feed.
- Vul de OData URL
https://dashview-data-gateway-1097018975400.europe-west4.run.app/odatain. - Kies Basic authenticatie.
- Gebruik je Dashview e-mailadres als username en je Dashview access key als password.
- Kies daarna de datasource entity set die je wilt laden.
Als Excel eerder verkeerde credentials heeft onthouden, wis dan de permissies in Data Source Settings
en maak de verbinding opnieuw aan.
4. Hoe datasources in OData verschijnen
- Het servicedocument toont een entity set per datasource die beschikbaar is voor jouw access key.
- Livestream-datasources worden uitgesloten, omdat OData-clients eindige, bevraagbare entity sets verwachten en geen open Dashview command streams kunnen verwerken.
- Datasource IDs worden OData-veilig gemaakt. Bijvoorbeeld:
sales-ordersverschijnt alssales_orders. - Kolommen komen uit het huidige datasource schema en worden waar nodig ook OData-veilig gemaakt.
- Rijdata wordt gelezen via het bestaande Dashview backend/data-worker pad. Tenantrechten, gebruikersrechten, forced filters en parquet-aware uitvoering blijven daardoor gelden.
- Wanneer een datasource een parquet cache heeft, gebruikt het onderliggende datasourcepad die cache op dezelfde manier als andere Dashview queryroutes.
5. Ondersteunde OData query opties
| Optie | Gebruik |
|---|---|
$top | Beperk het aantal rijen. |
$skip | Sla rijen over voor paging. |
$select | Kies specifieke OData properties/kolommen. |
$filter | Ondersteunt eq, ne, gt, ge, lt, le, and, or, haakjes, strings, nummers, booleans en null. |
$orderby | Sorteer op een of meer properties met optioneel asc of desc. |
$count=true | Vraag een totale count mee voor de gefilterde entity set. |
GET /odata/orders?$top=100&$select=amount,status&$filter=status eq 'open'6. Huidige scope
- De Data Gateway is alleen-lezen voor datasource reads en exports.
- OData schrijft geen rows terug naar Dashview en ondersteunt geen OData batch, actions of navigation properties.
- Een PostgreSQL wire-compatible endpoint is nog niet beschikbaar; gebruik OData voor Excel/Power BI en de gateway API voor scripts.
- De gateway geeft geen extra rechten. Alles blijft binnen de tenant, gebruikerstoegang en forced filters van de access key.
7. Troubleshooting
- Invalid credentials: controleer dat Excel Basic auth gebruikt, username je Dashview e-mailadres is en password je access key is. Wis eventueel oude Excel Data Source Settings.
- URL is geen OData service: gebruik de volledige URL met
/odata. - Datasource ontbreekt: controleer je datasource rechten, access key en of de datasource zichtbaar is voor jouw gebruiker.
- Laden duurt lang: controleer of de datasource groot is, of de parquet cache recent is en of je in Excel filters/selecties toepast om minder data te laden.
- Kolomnaam lijkt anders: OData property names worden veilig gemaakt voor clients; gebruik de kolomnamen die Excel in de Navigator toont.