Koppeling van Excel en Power BI met MobiCRM (OData)
Voorstelling
MobiCRM stelt een OData-feed ter beschikking waarmee u uw MobiCRM-gegevens in Microsoft Excel en Power BI kunt laden, om uw eigen tabellen en rapporten te maken.
De feed is alleen-lezen: hij kan de gegevens van MobiCRM niet wijzigen. Hij stelt de accounts, de contacten, de zaken, de producten van de zaken, de leads, de afspraken, de taken, de verslagen en de maandelijkse omzetten van de accounts ter beschikking.
Adres van de feed: https://odata.mobicrm.app/odata/v1
Vereisten
- Een toegangstoken voor de MobiCRM-API. Het aanmaken ervan vereist een recht: neem contact op met uw MobiCRM-beheerder als de sectie "Toegangstokens voor de API" niet in uw profiel verschijnt.
- De leesrechten op de te laden gegevens: accounts, contacten, zaken, leads, afspraken, taken, verslagen en omzetten.
De teruggegeven gegevens zijn de gegevens die u in MobiCRM ziet:
- alleen de accounts, contacten, zaken, leads, afspraken, taken, verslagen en omzetten binnen uw perimeter worden teruggegeven (accounts die u beheert, portefeuilles, teams die u leidt, afspraken en taken die u betreffen…), zoals in de toepassing;
- als uw gebruiker het globale overzicht heeft, worden alle gegevens teruggegeven;
- verwijderde gegevens worden nooit teruggegeven;
- zonder leesrecht op een type gegevens wordt dit niet teruggegeven, ook niet in de gekoppelde tabellen.
Aanmaken van het toegangstoken
- Open in MobiCRM "Mijn profiel" door op uw foto te klikken.

- Klik in de sectie "Toegangstokens voor de API" op +.

- Vul in het venster "Aanmaak van een toegangstoken" het volgende in:
- Naam van de toepassing: bijvoorbeeld
excelofpowerbi; - Geldigheidsduur: de periode waarin het token toegang geeft.
Klik vervolgens op Genereren.

Let op: het token wordt niet opnieuw getoond. Kopieer het en bewaar het op een veilige plaats, buiten MobiCRM. Het token geeft toegang tot uw gegevens: deel het niet.
Om de toegang in te trekken, verwijdert u het token in de sectie "Toegangstokens voor de API" van uw profiel.
Verbinding vanuit Excel
- Open in Excel het tabblad Gegevens en vervolgens Gegevens ophalen > Uit andere bronnen > Uit OData-feed.
- Voer het adres
https://odata.mobicrm.app/odata/v1in en klik op OK. - Kies de verificatie Basis:
- Gebruikersnaam: voer een willekeurige tekst in, bijvoorbeeld
mobicrm; - Wachtwoord: plak uw toegangstoken.
- Gebruikersnaam: voer een willekeurige tekst in, bijvoorbeeld
- Selecteer in de navigator de te laden tabellen (bijvoorbeeld
Accounts) en klik op Laden.
Gebruik Gegevens > Alles vernieuwen om de gegevens bij te werken.
Verbinding vanuit Power BI
Power BI Desktop
- Klik op Gegevens ophalen > OData-feed.
- Voer het adres
https://odata.mobicrm.app/odata/v1in en klik op OK. - Kies de verificatie Basis, met een willekeurige gebruikersnaam en uw toegangstoken als wachtwoord.
- Selecteer de te laden tabellen, bijvoorbeeld
Accounts,Contacts,BusinessesenBusinessProducts.
De tabellen zijn gekoppeld via hun id's: Contacts.AccountId, Businesses.AccountId, BusinessProducts.BusinessId, Leads.AccountId, Leads.ContactId, Appointments.AccountId, Appointments.BusinessId, Todos.AccountId, Todos.BusinessId, Todos.ContactId, Minutes.AccountId, Minutes.BusinessId, Minutes.ContactId, Minutes.AppointmentId en AccountTurnovers.AccountId komen overeen met de kolom Id van de gekoppelde tabel. U kunt deze relaties aanmaken in de modelweergave van Power BI.
Power BI-service
Voer na de publicatie van het rapport dezelfde referenties in (basisverificatie, token als wachtwoord) in de gegevensbroninstellingen van het semantische model om de vernieuwing te plannen. Er is geen gateway nodig: de feed is via internet bereikbaar.
Wanneer het token verloopt of wordt verwijderd, mislukt de vernieuwing: maak een nieuw token aan en werk de referenties bij.
Beschikbare gegevens
| Tabel | Inhoud |
|---|---|
Accounts | Accounts: bedrijfsnaam, type, status, categorie, sector, grootte, herkomst, potentieel, omzet, SIRET, SIREN, btw-nummer, APE-code, accountbeheerder, bovenliggend account, aanmaak- en wijzigingsdata en -auteurs, adressen, aangepaste velden. |
Contacts | Contacten: aanspreektitel, achternaam, voornaam, functie, geboortedatum, account, contactbeheerder, sociale netwerken, toestemmingen, e-mails, telefoonnummers, aangepaste velden. |
Businesses | Zaken: naam, account, status, bedrag, geschat bedrag, type, herkomst, zaakbeheerder, ondertekenings-, winst-, verval- en offerteverzenddatum, betrouwbaarheidsindex, contacten, producten, aangepaste velden. |
BusinessProducts | Producten van de zaken: zaak, product, referentie, productlijn, hoeveelheid, eenheidsprijs, bedrag, marge, abonnementsinformatie. |
Leads | Leads: titel, achternaam, voornaam, bedrijf, functie, telefoon, e-mail, status, herkomst, beheerder, account, contact, data en auteurs van aanmaak en wijziging. |
Appointments | Afspraken: titel, opmerking, type, aard, data, tijdzone, adres, telefoon, link naar de videoconferentie, eigenaar, account, zaak, contacten, aantal verslagen, herhaling (reeksen worden ongewijzigd teruggegeven, zonder de afspraken te genereren), data en auteurs van aanmaak en wijziging. |
Todos | Taken: detail, status, type, belangrijkheid, urgentie, deadline, afrondingsdatum, eigenaar, account, zaak, contact, data en auteurs van aanmaak en wijziging. |
Minutes | Verslagen: titel, datum, belangrijkheid, notities, AI-samenvatting, sjabloon, account, zaak, contact, afspraak, besproken punten, aangepaste velden, volgende afspraken, taken, data en auteurs van aanmaak en wijziging. |
CustomFields | Definitie van de aangepaste velden van de accounts, contacten en zaken: label, type, categorie, lijstwaarden. |
AccountTurnovers | Maandelijkse omzetten van de accounts: account, jaar, maand, bedrag, marge, hoeveelheid, beheerder, productlijn, categorie, data van aanmaak en wijziging. |
De labels van de referentiegegevens (status, categorie, sector, type, herkomst…) en de namen van de beheerders staan rechtstreeks in elke tabel. Elke rij bevat ook een link OpenUrl naar de overeenkomstige fiche in MobiCRM.
De aangepaste velden van een account, een contact of een zaak staan in de kolom CustomValues, met één rij per ingevuld veld: CustomFieldLabel geeft de naam van het veld en DisplayValue de leesbare waarde (lijstlabels, gebruikersnamen). Om in Power BI één kolom per veld te krijgen, vouwt u CustomValues uit en gebruikt u vervolgens Transformeren > Draaitabelkolom op CustomFieldLabel met DisplayValue als waarden. Alleen de velden van de categorieën die openstaan voor uw verkoopteams worden teruggegeven, zoals in de toepassing.
De bedragen zijn decimale getallen: hun sommen in Excel en Power BI zijn exact.
Beperkingen
- De gegevens worden verzonden in pagina's van 1.000 rijen. Excel en Power BI laden alle pagina's automatisch.
- Het aantal verzoeken is beperkt tot 600 per minuut en per gebruiker. Daarboven antwoordt de feed tijdelijk "te veel verzoeken"; de volgende vernieuwing werkt normaal.
- De feed is alleen-lezen.
