YouTube

1 Basisfuncties

2 Gebruik van Download met Joins

3 Download met Methode en Expressies

Activeren

De eerste keer dat ExsionBC gebruikt wordt moet deze worden geactiveerd.

Klik op “Activeren” in het ExsionBC menu om het licentie scherm te openen.

Klik op de knop “Activeren” om de activatie daadwerkelijk uit te voeren. Tijdens het activeren wordt een verbinding gemaakt via internet om de licentiegegevens te controleren en dit exemplaar van ExsionBC te registreren.

Menu opties

ExsionBC wordt bij het openen van Excel getoond als tab in het lint. Binnen het ExsionBC lint zijn de onderstaande menuopties te vinden.

Connectie
Bedrijf zoeken
Database structuur
Functie bibliotheek
Functie definitie
Formules naar waarden
Details weergeven
Dynamische download
Gegevens vernieuwen
Help
Info

Connectie

Om gegevens op te halen uit Microsoft Dynamics 365 BC moet er eerst een connectie worden aangemaakt. De eerste keer dat ExsionBC wordt gebruikt, zullen er nog geen connecties zijn aangemaakt en kunt u alleen kiezen voor de optie “Nieuwe connectie”.

Na een keuze vanuit dit submenu wordt het volgende scherm getoond:

Door op de knop “OK” te drukken wordt de connectie opgeslagen. Indien een bestaande connectie geopend wordt zal de knop “Verwijderen” deze verwijderen.

Veld	Beschrijving
Naam	Hier kan een naam aan de connectie gegeven worden.
Type	Keuze uit “Toegangssleutel”, “Windows” of “OAuth 2.0 (v2)”.
Gebruikersnaam	Gebruikers-ID.
Toegangssleutel voor webservice*	Toegangssleutel uit Microsoft Dynamics 365 BC.
Taal code	Taalkeuze voor het ophalen van tabel-/veldnamen.
Multi environment (beta)	Download: Helptekst Multi environment
SOAP-URL	URL van de extensie binnen Microsoft Dynamics 365 BC.
Webclient-URL*	Vul deze in als “Details weergeven” niet de juiste url opend.
SelectLatestVersion	Hiermee dwingt u het gebruik van de nieuwste versie van de database af. “Microsoft documentatie”
TransactionType	Keuze uit “Browse”, “Snapshot”, “UpdateNoLocks”, “Update” of “Report”. “Microsoft documentatie”
Download symbols	Download: Helptekst Download symbols
Developer Service-URL*
OAuth 2.0-Login Prompt	Vraagt opnieuw om inloggegevens na “OK”

* On-Prem

Bedrijf zoeken

Wanneer u op “Bedrijf zoeken” klikt opent er een scherm dat alle bedrijven uit de database zichtbaar maakt.

Vervolgens klikt u het bedrijf dat u mee wilt nemen in de rapportage en drukt u op “Kopiëren naar actieve cel” dit voegt u toe per cel, tot dat u alle bedrijven toegevoegd heeft.

Nu krijgt u de gekozen bedrijven te zien in de cel die u geselecteerd heeft. Wanneer in meerdere bedrijven selecteert zullen deze bedrijven allemaal in dezelfde cel geplaatst worden. Als u dit in aparte cellen wilt dient u één voor één de bedrijven toe te voegen, via de knop “Bedrijf zoeken”.

Let op! U dient wel de juiste cel te selecteren voor u op “Bedrijf zoeken” klikt. Wanneer u dit niet doet zal het bedrijf op de dan geselecteerde cel geplaatst worden.

Database structuur

Hiermee brengt u de complete database structuur in kaart, inclusief het maatwerk. Het werkt als een soort stratenboek van uw Microsoft Dynamics 365 BC applicatie. U kunt op deze manier inzicht krijgen in het datamodel van uw Microsoft Dynamics 365 BC omgeving.

Na op de knop “Database structuur” gedrukt te hebben, wordt de database structuur voor de gekozen connectie getoond.

Door op een tabelnaam te klikken krijgt U de detailinformatie van de tabel.

Kolom	Beschrijving
Kolom 1	De namen van de velden. In de eerste regel de naam van de tabel.
Kolom 2	De nummers van de velden. In de eerste regel het nummer van de tabel. Deze nummers kunnen worden gebruikt bij het zoeken naar tabellen binnen ExsionBC.
Type	Het datatype van het veld.
Size	De maximale grote van het veld.
Class	Of het veld een waarde moet bevatten.
Index	De verschillende indexen die aangemaakt zijn op de tabel.
SumFields	De verschillende SumFields die binnen de tabel vastgelegd zijn.

Functie bibliotheek

U kunt een bibliotheek van functies aanleggen die kunnen worden gebruikt in als expressie in de “Dynamische download”, die ongeacht in welk Excel bestand u werkt altijd aanwezig zullen zijn. Bij de installatie van ExsionBC kan worden gekozen om de functie bibliotheek op een centrale plaats neer te zetten, zodat alle gebruikers de beschikking hebben tot deze functies.

Na het opstarten van deze functie krijgt u een overzicht met functies uit de bibliotheek. Wanneer er geen functies zijn gedefinieerd is deze lijst leeg.

U kunt kiezen voor “Nieuw” om een nieuwe functie aan te maken of “Bewerken” om een bestaande functie te wijzigen.

Veld	Beschrijving
Tabel	De tabel waaruit de functie zijn gegevens haalt.
Veld	Het veld dat moet worden opgehaald via deze functie.
Methode	Keuze van de berekening op het veld (Som, Minimum, Maximum, Gemiddelde of Aantal).
Index	De index die moet worden gebruikt. De velden binnen de index worden als argumenten aan de functie toegevoegd.
Naam	Naam van de functie.
Omschrijving	Een korte omschrijving van de functie (deze omschrijving wordt in de functie wizard van Excel getoond).
Weergave	Keuze om de beschrijving van tabellen/velden te tonen of de namen uit de database.

Na de knop “>>” worden de functie argumenten getoond (gekozen index):

Veld	Beschrijving
Naam	Standaard worden de veld beschrijvingen van de tabel gebruikt, maar kan hier gewijzigd worden om het gebruikersgemak te verhogen.
Omschrijving	Een korte omschrijving van het argument (deze omschrijving wordt in de functie wizard van Excel getoond).
Filter (vast)	Er kan een vast filter worden ingegeven, het argument wordt daarna niet meer getoond in de functie wizard van Excel.
Verbergen	Geeft aan of het argument verborgen moet zijn in de functie wizard van Excel.

Na het drukken op de knop “OK” is de functie toegevoegd aan de bibliotheek.

De aangemaakte functie is terug te vinden in de functie wizard van Excel onder de categorie “ExsionBC bibliotheek”:

Zie “Via een functie uit de bibliotheek” voor een voorbeeld.

Functie definitie

Het is mogelijk om een functie in een Excel bestand op te nemen. Deze functie kan vervolgens in de “Dynamische download” gebruikt worden om gegevens op te halen uit meerdere tabellen.

Expressie functies gebruiken als argument (definitie) een bereik waarin de tabel, indexvelden en de veldnaam waarvan de waarde moet worden opgehaald.

Om een definitie aan te maken om het bereik waarin de tabel en indexvelden zijn opgenomen moet u kiezen voor de optie “Functie definitie”. In dit scherm moeten achtereenvolgens de tabel, het veld en de index worden opgegeven.

Na het drukken op de “OK” knop vraagt ExsionBC om een naam aan de functie definitie te geven.

En wordt de tabel met de geselecteerde index gekopieerd naar de actieve cel in Excel.

Zie het hoofdstuk Expressie functies, voor een lijst met functies die gebruik maken van deze functie definitie.

Zie “Via een functie definitie” voor een voorbeeld.

Formules naar waarden

Via deze menu optie kunt u alle ExsionBC formules in uw rapport vervangen door waarden. De menu optie is bedoeld om ExsionBC rapporten uit te kunnen wisselen met andere Excel gebruikers die geen beschikking hebben tot ExsionBC.

Let op: wanneer deze optie is uitgevoerd, zullen de ExsionBC formules in het Excel bestand zijn gewist. Zonder ExsionBC formules kunnen de gegevens niet meer vernieuwd vanuit de database.

Om te voorkomen dat u de formules verliest kunt u het beste eerst het Excel bestand onder een andere naam opslaan (een kopie maken).

Details weergeven

Deze menu optie geeft u inzicht in details achter een ExsionBC formule van de huidige cel. De manier van weergeven van de details wordt bepaald door de instelling “Details weergeven” in het Info menu.

Indien voor deze instelling “Excel” gekozen is zal ExsionBC bij het “Details weergeven” een nieuwe werkmap aanmaken. In deze werkmap worden de details weergegeven.

Indien de instelling op “Webclient” staat, zal ExsionBC bij het “Details weergeven” direct Microsoft Dynamics 365 BC openen.

Dynamische download

Door middel van een dynamische download kunnen gegevens vanuit de database in Excel worden geplaatst. In tegenstelling tot het gebruik van functies kan met een download in één keer een grote hoeveelheid gegevens worden opgehaald. Wanneer de cursor in het uitvoerbereik van een bestaande downloaddefinitie staat wordt niet de hieronder beschreven interface geopend maar wordt de cursor geplaatst in de downloaddefinitie behorende bij dat uitvoerbereik.

Wanneer de functie voor de eerste keer wordt opgestart, zijn er nog geen tabellen en velden geselecteerd binnen de download definitie.

Veld	Beschrijving
Toevoegen	Geeft een lijst met tabellen vanuit de database.
Zoeken	Zoekmogelijkheid binnen de daarboven genoemde lijst.
Weergave	Keuze om de beschrijving van tabellen/velden te tonen of de namen uit de database.
Knoppen om te selecteren	Via de knop “>>” selecteert u alle velden. Door op de knop “>” te klikken selecteert u één veld. Via de knoppen “<” en “<<” de-selecteert u respectievelijk één veld of alle velden.
INS	Hiermee kan een lege kolom worden opgenomen in de download. Daarin kan dan naar wens een eigen berekening worden opgenomen.
JOIN	Wanneer er meerdere tabellen zijn geselecteerd, moeten er relaties tussen tabellen worden opgegeven. Dit kan door in het linker tabblad op een veld te gaan staan en op het rechter tabblad het relatie veld te kiezen.
[___]	Join type (INNER,OUTER,INNER TOP 1,OUTER TOP 1,NOT EXISTS of METHODE).
Velden	Een lijst met geselecteerde velden.
Naam	Standaard wordt het veldnaam van de tabel gebruikt, maar kan hier worden aangepast. De aangepaste naam wordt in de tabel of draaitabel getoond.
Methode	Keuze van de berekening op het veld (SOM, MIN, MAX, GEM, ANT, Jaar, Kwartaal, Maand, Week, Dag, Periode of INT).
Verbergen	Velden die niet in de download moeten worden getoond, kunnen hiermee worden verborgen. Dit kunnen velden zijn waarop gefilterd wordt en/of velden die relaties tussen tabellen aangeven.
Tabel/Veld	Bron tabel/veld uit de lijst velden.
Start draaitabelwizard voor deze download	Nadat een download is gebruikt voor de eerst keer, kan deze worden aangepast om te gebruiken voor het creëren van een draaitabel. Klik op een cel in de download definitie en vervolgens de Dynamic downloaden menu-optie om de bestaande download wijzigen. Selecteer: “Start draaitabelwizard voor deze download”.
OK	Door op“OK” te klikken geeft u aan dat u de downloaddefinitie wilt aanmaken. Het uitvoeren van de downloaddefinitie begint pas als u op de knop “Gegevens vernieuwen” klikt.

Vervolg boven staand scherm, nu met de opties vanuit het tabblad “Instellingen”.

Veld	Beschrijving
Type	Keuze uit “TABEL” of “DRAAITABEL”.
Unieke records	De optie unieke records zorgt er voor dat dubbele regels worden gefilterd uit de uitvoer van een download. Het is niet mogelijk om slechts op basis van een aantal geselecteerde velden te bepalen of een regel uniek is, dit wordt altijd bepaald door alle velden.
Exclusief veldnamen	Geen veldnamen boven de uitvoer tonen.
Sorteren op	Maximaal 3 velden waarop gesorteerd moet worden.
Aflopend	Of het veld aflopend moet worden gesorteerd.
Uitvoeren naar tabbladen	Naast het uitvoeren naar rijen is het mogelijk uit te voeren naar tabbladen. Wanneer deze optie aan staat wordt voor elk opgehaald record een tabblad gegenereerd aan de hand van een sjabloonblad dat u zelf kunt opmaken.
Sjabloon	Naam van het sjabloon.
Uitklappen	Voert het uitklappen uit op basis van het sjabloon.

Om een tabel toe te voegen moet u dubbel klikken op de tabel (binnen de lijst met tabellen in het “Toevoegen” tabblad). Hierna zal ExsionBC een nieuw tabblad aanmaken voor de toegevoegde tabel. Op dat tabblad kan vervolgens een selectie gemaakt worden uit de velden binnen die tabel.

Koppelen van tabellen

Bij het aanmaken van een download is het ook mogelijk om meerdere tabellen te koppelen (verder: joinen). Dat kan gedaan worden door in de download wizard op het tabblad “Toevoegen” een tweede tabel te selecteren (dubbelklikken).

Na het toevoegen van de 2de tabel komt er een voorstel met de tabel relaties:

Knop	Beschrijving
Velden om op te joinen	Verschillende velden waarop de tabellen gekoppeld kunnen worden.
Jointype	Verschillende Join types waaruit gekozen kan worden.
OK	De tabellen definitief koppelen.

Nadat het scherm is afgesloten keert u terug naar het vorig scherm.

Nadat de download met “OK” is afgesloten wordt onderstaande definitie getoond. Deze moet altijd in het rapport aanwezig blijven zodat de gegevens kunnen worden vernieuwd.

Veld	Beschrijving
Connectie	De connectie waarop de download is gebaseerd.
Tabel	Nummer van de tabellen die gebruikt worden binnen de download.
JOINTYPE	Indien meerdere tabellen gebruikt zijn wordt het gekozen jointype getoond.
FILTER	Een filter definitie voor het veld (zie Gebruik van filters).
VERBERGEN	Velden die niet in de download moeten worden getoond, kunnen hiermee worden verborgen. Dit kunnen velden zijn waarop gefilterd wordt en/of velden die relaties tussen tabellen aangeven.
SORTEREN	Een nummer van 1 t/m 3. Om aflopend te sorteren moet een negatief nummer worden opgegeven.
METHODE	Keuze van de berekening op het veld (SOM, MIN, MAX, GEM ANT, Jaar, Kwartaal, Maand, Week, Dag, Periode of INT).
EXPRESSIE	Hier kan een ExsionBC functie worden gebruikt om de download te vereenvoudigen.
Bedrijf	De eerste regel bevat altijd een dummy veld “Bedrijf” met als veldnummer “-2”. Dit veld kan gebruikt worden als er meerdere bedrijfen worden gebruikt om uit een specifiek bedrijf te rapporteren. Verander hiervoor het verbergen in “ONWAAR”, in de uitvoer wordt vervolgens het “Bedrijf” getoond waaruit de gegevens opgehaald worden.
Tabelvelden	Alle velden die geselecteerd zijn worden onder elkaar getoond.

Na het definiëren van een nieuwe download en op de knop “Gegevens vernieuwen” te hebben gedrukt, wordt de vraag gesteld waar de uitvoer van de download moet worden geplaatst.

Elke download definitie heeft een naam die begint met “EXSIONBC_DATA_” gevolgd door een tabelnaam.

Join types

Binnen ExsionBC zijn 6 jointypes te gebruiken. Twee hiervan kunnen direct worden gekozen via de wizard bij het koppelen van de tabellen. De andere vier kunnen handmatig worden ingevoerd in de download definitie.

Type join	Beschrijving
1=Inner	Alleen records opnemen waarvoor de gekoppelde velden uit beide tabellen identiek zijn.
2=Outer	Alle records uit de eerste tabel opnemen en alleen die records uit de tweede tabel waarvoor de gekoppelde velden identiek zijn.
3=Inner top 1	Geeft het eerste record waarvoor de gekoppelde velden uit beide tabellen identiek zijn. Wat het eerste record is kan worden beïnvloed door de sortering aflopend of oplopend in te stellen.
4=Outer top 1	Alle records uit de eerste tabel opnemen en alleen het eerste record uit de tweede tabel waarvoor de gekoppelde velden identiek zijn. Wat het eerste record is kan worden beïnvloed door de sortering aflopend of oplopend in te stellen.
5=Not Exists	Alleen records opnemen uit de tweede tabel waarin de gekoppelde velden niet identiek zijn.
6=Methode	TODO

Draaitabel

De uitvoer van ExsionBC kan automatisch in een draaitabel worden geplaatst. Hiervoor zal eerst een download moeten worden aangemaakt en zal doormiddel van de knop “Gegevens vernieuwen” een uitvoerbereik aangegeven worden.

Indien de download definitie vervolgens weer wordt geopend (binnen de definitie gaan staan en op de knop “Dynamische download” klikken) kan links onderin een vink gezet worden bij “Start draaitabelwizard voor deze download”.

Door op “OK” te klikken zal ExsionBC onderstaande locatie aanvragen. Geef hierbij een tabblad in het Excel document aan en klik op “OK”.

De draaitabel krijgt de naam “EXSIONBC_” en de tabelnaam. Hierdoor zal de draaitabel worden bijgewerkt als er op de knop “Gegevens vernieuwen” wordt gedrukt.

Gegevens vernieuwen

Met deze optie worden alle dynamische downloads en/of formules binnen uw Excel document opnieuw berekend. Deze optie kunt u gebruiken wanneer uw gegevens in het werkblad nog niet zijn bijgewerkt. De standaard functie van de knop is om alle dynamische downloads te vernieuwen.

Door op het pijltje te klikken kan er ook voor worden gekozen om alleen de downloaddefinitie waar de cursor in staat te vernieuwen. Dit kan handig zijn voor het snel testen van wijzigingen in de betreffende downloaddefinitie. In de kop van een downloaddefinitie kunt u altijd de datum en tijd zien wanneer deze voor het laatst vernieuwd is.

Help

Geeft u alle informatie die nodig is om ExsionBC te kunnen gebruiken.

Info

Tab

Beschrijving

Instellingen

Veld	Beschrijving
Taal	Keuze uit NL of EN. De taal instellingen worden opgeslagen per gebruiker.
Details weergeven	Keuze uit “Webclient” of “Excel”.
Bibliotheek directorie	Het pad waar de (gedeelde) bibliotheek functies worden opgeslagen. Als deze leeg is dan zal ExsionBC de directorie gebruiken die is opgegeven in het initialisatie bestand (ExsionBC.ini).

Support

Onze helpdesk kan op afstand support leveren via TeamViewer.

Versie

Veld	Beschrijving
Versie	De geïnstalleerde versie van ExsionBC.
ExsionBC	Toont de directorie waarin ExsionBC is geïnstalleerd.
Feedback	HB Software is permanent bezig zijn producten verder te verbeteren en te ontwikkelen. Daarom verzamelen we meta-data over het gebruik van ExsionBC. Met meta data bedoelen we gegevens over het gebruik van rapporten/Excel sheets. Daar proberen we trends en patronen in te ontdekken. We verzamelen nadrukkelijk niet de data van de rapporten en/of Excel sheets zelf. Die data krijgen wij ook niet binnen. De wijze waarop we informatie verzamelen heeft geen invloed op de werking en prestaties van het systeem. Mocht u niet willen meewerken aan dit verbeter progamma dan kunt u de settings van ExsionBC veranderen, zodat er geen meta data worden verzonden aan ons. De resultaten van onze verbeteringen worden gecommuniceerd via een nieuwsbrief die naar uw e-mailadres wordt gestuurd. Mocht u geen nieuwsbrief willen ontvangen dan kunt dat aan ons doorgeven aan office@hbsoftware.nl.
Release notes	De release notes van de meest actuele ExsionBC versie.

Licentie

Geeft het bedrijf waartoe een gebruikrecht is verleend en laat zien welke gebruikers een licentie hebben geactiveerd.

Functies

Standaard functies
Expressie functies

Standaard functies

Functie	Beschrijving
EXSIONBC_ANWSAL	Geeft het saldo van een analyseweergave weer.
EXSIONBC_BEDRIJF	Geeft de weergavenaam weer van een bedrijf.
EXSIONBC_DATUM	Geeft een datumfilter weer.
EXSIONBC_DI1OMS	Geeft de globale dimensie 1 naam weer.
EXSIONBC_DI2OMS	Geeft de globale dimensie 2 naam weer.
EXSIONBC_DIMOMS	Geeft de dimensienaam weer.
EXSIONBC_KLTOMS	Geeft de klantnaam weer.
EXSIONBC_KLTSAL	Geeft het openstaand saldo van een klant weer.
EXSIONBC_KLTWPL	Geeft de klantplaats weer.
EXSIONBC_LEVOMS	Geeft de leveranciernaam weer.
EXSIONBC_LEVSAL	Geeft het openstaand saldo van een leverancier weer.
EXSIONBC_LEVWPL	Geeft de leverancierplaats weer.
EXSIONBC_REKOMS	Geeft de grootboekrekeningnaam weer.
EXSIONBC_REKSAL	Geeft het saldo of budget van een grootboekrekening weer.
EXSIONBC_REKSAM	Geeft de samentelling van een grootboekrekening weer.
EXSIONBC_SAMENVOEGEN	Geeft een samengestelde tekst terug van een bereik.
EXSIONBC_WEEKNR	Geeft het weeknummer van een datum weer.

De functies zijn terug te vinden in de functie wizard van Excel onder de categorie “ExsionBC standaard”:

EXSIONBC_ANWSAL

Geeft het saldo van een analyseweergave weer.

Argument	Beschrijving
Bedrijf	Bedrijf.
Analyseweergavecode	Analyseweergavecode.
[Grootboekrekening]	Grootboekrekening (filter).
[Datumfilter]	Datum (filter).
[Budgetcode]	Budget.
[Dimensie 1]	Code dimensie 1 filter.
[Dimensie 2]	Code dimensie 2 filter.
[Dimensie 3]	Code dimensie 3 filter.
[Dimensie 4]	Code dimensie 4 filter.

EXSIONBC_BEDRIJF

Geeft de weergavenaam weer van een bedrijf.

Argument	Beschrijving
Bedrijf	Bedrijf.

EXSIONBC_DATUM

Geeft een datumfilter weer.

Argument	Beschrijving
Bedrijf	Bedrijf.
Type	Keuze uit 1=Dag, 2=Week, 3=Maand, 4=Kwartaal, 5=Jaar of 6=Boekhoudperiode.
[Cumulatief]	0=Nee, 1=Ja, of 2=YTD (Jaar t/m datum).
[Index]	Volgnummer van het type (bv Maand 1 t/m 12).
[Jaar]	Optioneel jaar (standaard is het huidige jaar).

EXSIONBC_DI1OMS

Geeft de globale dimensie 1 naam weer.

Argument	Beschrijving
Bedrijf	Bedrijf.
Dimensiecode	Dimensie 1.

EXSIONBC_DI2OMS

Geeft de globale dimensie 2 naam weer.

Argument	Beschrijving
Bedrijf	Bedrijf.
Dimensiecode	Dimensie 2.

EXSIONBC_DIMOMS

Geeft de dimensienaam weer.

Argument	Beschrijving
Bedrijf	Bedrijf.
Dimensiegroep	Dimensiegroep.
Dimensiecode	Dimensiewaarde.

EXSIONBC_KLTOMS

Geeft de klantnaam weer.

Argument	Beschrijving
Bedrijf	Bedrijf.
Klantcode	Klantnummer.

EXSIONBC_KLTSAL

Geeft het openstaand saldo van een klant weer.

Argument	Beschrijving
Bedrijf	Bedrijf.
Klantcode	Klantnummer.
[Datumfilter]	Datum (filter).
[Dimensie 1]	Code globale dimensie 1 filter.
[Dimensie 2]	Code globale dimensie 2 filter.

EXSIONBC_KLTWPL

Geeft de klantplaats weer.

Argument	Beschrijving
Bedrijf	Bedrijf.
Klantcode	Klantnummer.

EXSIONBC_LEVOMS

Geeft de leveranciernaam weer.

Argument	Beschrijving
Bedrijf	Bedrijf.
Leverancierscode	Leveranciernummer.

EXSIONBC_LEVSAL

Geeft het openstaand saldo van een leverancier weer.

Argument	Beschrijving
Bedrijf	Bedrijf.
Leverancierscode	Leveranciernummer.
[Datumfilter]	Datum (filter).
[Dimensie 1]	Code globale dimensie 1 filter.
[Dimensie 2]	Code globale dimensie 2 filter.

EXSIONBC_LEVWPL

Geeft de leverancierplaats weer.

Argument	Beschrijving
Bedrijf	Bedrijf.
Leverancierscode	Leveranciernummer.

EXSIONBC_REKOMS

Geeft de grootboekrekeningnaam weer.

Argument	Beschrijving
Bedrijf	Bedrijf.
Grootboekrekening	Grootboekrekening.

EXSIONBC_REKSAL

Geeft het saldo of budget van een grootboekrekening weer.

Argument	Beschrijving
Bedrijf	Bedrijf.
Grootboekrekening	Grootboekrekening (filter).
[Datumfilter]	Datum (filter).
[Budgetcode]	Budget.
[Dimensie 1]	Code globale dimensie 1 filter.
[Dimensie 2]	Code globale dimensie 2 filter.

EXSIONBC_REKSAM

Geeft de samentelling van een grootboekrekening weer.

Argument	Beschrijving
Bedrijf	Bedrijf.
Grootboekrekening	Grootboekrekening.

EXSIONBC_SAMENVOEGEN

Geeft een samengestelde tekst terug van een bereik..

Argument	Beschrijving
Bereik	Een bereik van cellen..
[Scheidingsteken]	Een scheidingsteken of tekst..
[Uniek]	Indien WAAR, dan worden alleen de unieke waardes samengevoegd..
[Lege cellen]	Indien WAAR, dan worden lege cellen opgenomen..

EXSIONBC_WEEKNR

Geeft het weeknummer van een datum weer.

Argument	Beschrijving
Datum	Voer een datum in..
[Formaat]	0=WW, 1=JJWW, 2=JJJJWW, 3=WWJJ, 4=WWJJJJ.
[Scheidingsteken]	0=geen, 1=spatie, 2=-, 3=\|, 4=/, 5=\.

Expressie functies

Functie	Beschrijving
EXSIONBC_ANT	Geeft het aantal records binnen de tabel die overeenkomt met de opgegeven filter(s).
EXSIONBC_GEM	Geeft de gemiddelde waarde van een veld binnen een tabel die overeenkomt met de opgegeven filter(s).
EXSIONBC_MAX	Geeft de grootste waarde van een veld binnen een tabel die overeenkomt met de opgegeven filter(s).
EXSIONBC_MIN	Geeft de kleinste waarde van een veld binnen een tabel die overeenkomt met de opgegeven filter(s).
EXSIONBC_OMS	Geeft de (eerste) waarde van een veld binnen een tabel die overeenkomt met de opgegeven filter(s).
EXSIONBC_SOM	Geeft de gesommeerde waarde van een veld binnen een tabel die overeenkomt met de opgegeven filter(s).

Gebruik van Expressie functies wordt aanbevolen voor functies die alleen betrekking hebben op één Excel bestand.

Deze functies zijn terug te vinden in de functie wizard van Excel onder de categorie “ExsionBC expressie”:

EXSIONBC_ANT

Geeft het aantal records binnen de tabel die overeenkomt met de opgegeven filter(s)..

Argument	Beschrijving
Factor	Factor waarmee de uitkomst moet worden vermenigvuldigd.
Functie definitie	Functie definitie (bereik).
[Filter 1]	Filter 1.
[Filter 2]	Filter 2.
[Filter 3]	Filter 3.
[Filter 4]	Filter 4.
[Filter 5]	Filter 5.
[Filter 6]	Filter 6.
[Filter 7]	Filter 7.
[Filter 8]	Filter 8.
[Filter 9]	Filter 9.
[Filter 10]	Filter 10.
[Filter 11]	Filter 11.
[Filter 12]	Filter 12.
[Filter 13]	Filter 13.
[Filter 14]	Filter 14.
[Filter 15]	Filter 15.
[Filter 16]	Filter 16.
[Filter 17]	Filter 17.
[Filter 18]	Filter 18.

EXSIONBC_GEM

Geeft de gemiddelde waarde van een veld binnen een tabel die overeenkomt met de opgegeven filter(s)..

Argument	Beschrijving
Factor	Factor waarmee de uitkomst moet worden vermenigvuldigd.
Functie definitie	Functie definitie (bereik).
[Filter 1]	Filter 1.
[Filter 2]	Filter 2.
[Filter 3]	Filter 3.
[Filter 4]	Filter 4.
[Filter 5]	Filter 5.
[Filter 6]	Filter 6.
[Filter 7]	Filter 7.
[Filter 8]	Filter 8.
[Filter 9]	Filter 9.
[Filter 10]	Filter 10.
[Filter 11]	Filter 11.
[Filter 12]	Filter 12.
[Filter 13]	Filter 13.
[Filter 14]	Filter 14.
[Filter 15]	Filter 15.
[Filter 16]	Filter 16.
[Filter 17]	Filter 17.
[Filter 18]	Filter 18.

EXSIONBC_MAX

Geeft de grootste waarde van een veld binnen een tabel die overeenkomt met de opgegeven filter(s)..

Argument	Beschrijving
Factor	Factor waarmee de uitkomst moet worden vermenigvuldigd.
Functie definitie	Functie definitie (bereik).
[Filter 1]	Filter 1.
[Filter 2]	Filter 2.
[Filter 3]	Filter 3.
[Filter 4]	Filter 4.
[Filter 5]	Filter 5.
[Filter 6]	Filter 6.
[Filter 7]	Filter 7.
[Filter 8]	Filter 8.
[Filter 9]	Filter 9.
[Filter 10]	Filter 10.
[Filter 11]	Filter 11.
[Filter 12]	Filter 12.
[Filter 13]	Filter 13.
[Filter 14]	Filter 14.
[Filter 15]	Filter 15.
[Filter 16]	Filter 16.
[Filter 17]	Filter 17.
[Filter 18]	Filter 18.

EXSIONBC_MIN

Geeft de kleinste waarde van een veld binnen een tabel die overeenkomt met de opgegeven filter(s)..

Argument	Beschrijving
Factor	Factor waarmee de uitkomst moet worden vermenigvuldigd.
Functie definitie	Functie definitie (bereik).
[Filter 1]	Filter 1.
[Filter 2]	Filter 2.
[Filter 3]	Filter 3.
[Filter 4]	Filter 4.
[Filter 5]	Filter 5.
[Filter 6]	Filter 6.
[Filter 7]	Filter 7.
[Filter 8]	Filter 8.
[Filter 9]	Filter 9.
[Filter 10]	Filter 10.
[Filter 11]	Filter 11.
[Filter 12]	Filter 12.
[Filter 13]	Filter 13.
[Filter 14]	Filter 14.
[Filter 15]	Filter 15.
[Filter 16]	Filter 16.
[Filter 17]	Filter 17.
[Filter 18]	Filter 18.

EXSIONBC_OMS

Geeft de (eerste) waarde van een veld binnen een tabel die overeenkomt met de opgegeven filter(s)..

Argument	Beschrijving
Factor	Factor waarmee de uitkomst moet worden vermenigvuldigd.
Functie definitie	Functie definitie (bereik).
[Filter 1]	Filter 1.
[Filter 2]	Filter 2.
[Filter 3]	Filter 3.
[Filter 4]	Filter 4.
[Filter 5]	Filter 5.
[Filter 6]	Filter 6.
[Filter 7]	Filter 7.
[Filter 8]	Filter 8.
[Filter 9]	Filter 9.
[Filter 10]	Filter 10.
[Filter 11]	Filter 11.
[Filter 12]	Filter 12.
[Filter 13]	Filter 13.
[Filter 14]	Filter 14.
[Filter 15]	Filter 15.
[Filter 16]	Filter 16.
[Filter 17]	Filter 17.
[Filter 18]	Filter 18.

EXSIONBC_SOM

Geeft de gesommeerde waarde van een veld binnen een tabel die overeenkomt met de opgegeven filter(s)..

Argument	Beschrijving
Factor	Factor waarmee de uitkomst moet worden vermenigvuldigd.
Functie definitie	Functie definitie (bereik).
[Filter 1]	Filter 1.
[Filter 2]	Filter 2.
[Filter 3]	Filter 3.
[Filter 4]	Filter 4.
[Filter 5]	Filter 5.
[Filter 6]	Filter 6.
[Filter 7]	Filter 7.
[Filter 8]	Filter 8.
[Filter 9]	Filter 9.
[Filter 10]	Filter 10.
[Filter 11]	Filter 11.
[Filter 12]	Filter 12.
[Filter 13]	Filter 13.
[Filter 14]	Filter 14.
[Filter 15]	Filter 15.
[Filter 16]	Filter 16.
[Filter 17]	Filter 17.
[Filter 18]	Filter 18.

Voorbeeld expressie functie

Een voorbeeld van een expressie functie is het ophalen van de totale kosten van een project, per projectnummer.
Hiervoor wordt een download definitie gemaakt op de projectpostentabel in combinatie met een gedefinieerde functie (Zie: Functie definitie)
De download definitie wordt, naast velden uit de tabel, tevens voorzien van een Expressieveld (Totale kosten met veldnummer -1):

De benodigde functie definitie is als volgt:

In de Totale kosten regel kan nu in de Expressiekolom de EXSIONBC_SOM functie worden gebruikt.

Deze is dan als volgt:

=EXSIONBC_SOM(1;PROJECTPOST_TOTALE_KOSTPRIJS_LV;$H$7)

Deze functie heeft dus in dit geval 3 parameters. Waarbij:

Parameter 1: De vermenigvuldigingsfactor ( 1 of -1)

Parameter 2: De naam van de Functie definitie.
Deze kan automatisch worden ingevuld door tijdens het maken van de expressiefunctie de veldnummer kolom van de Functie definitie te selecteren of door de juiste te kiezen na een druk op de F3 toets.
Dit laatste geeft een overzicht van de beschikbare functies.

Parameter 3: De cel in de download definitie waar het projectnummer gaat verschijnen.

Het aantal parameters dat kan worden gebruikt is afhankelijk van het aantal velden in de Functie definitie.

Na het invullen van de expressie functie ziet de download definitie er dan zo uit:

Na een druk op de knop “Gegevens vernieuwen” zal dit het resultaat zij op het uitvoerblad:

In een download definitie mogen meerdere expressie velden worden opgenomen met ieder hun eigen parameters.

De gegevens voor deze parameters mogen ook uit cellen buiten de download definitie komen.

Gebruik van filters

U kunt bij de invoer van een filter alle cijfers en letters gebruiken die u normaal ook kunt gebruiken. Daarnaast kunt u een aantal speciale symbolen en rekenkundige formules gebruiken.

Dit zijn de beschikbare notities:

Teken	Betekenis	Voorbeeld	Weergegeven records
=	Gelijk aan	377	Nummer 377.
		BLAUW	Records met de code BLAUW, zoals de magazijncode BLAUW.
		22-1-2016 10:00	Een exacte datum/tijd: 22-jan-2016 10:00:00.
..	Tussen	1100..2100	Nummers 1.100 t/m 2.100.
		..2.500	Tot en met 2500.
		..31-12-2015	Datums tot en met 31-dec-2015.
\|	of/of	1200\|1300	Records met nummer 1.200 of 1.300.
&	en	<2000&>1000	Nummers kleiner dan 2000 en groter dan 1000.
<>	Niet gelijk aan	<>0	Alle nummers behalve 0.
		<>A*	Niet gelijk aan tekst die begint met A.
>	Groter dan	>1200	Nummers groter dan 1.200
>=	Groter dan of gelijk aan	>=1200	Nummers groter dan of gelijk aan 1.200
<	Kleiner dan	<1200	Nummers kleiner dan 1.200
<=	Kleiner dan of gelijk aan	<=1200	Nummers kleiner dan of gelijk aan 1.200
*	Een onbeperkt aantal onbekende tekens	cem	Tekst met de letters “cem”
		cem*	Tekst die begint met “cem”
?	Een onbekende teken	?im	Tekst zoals Jim of Tim
()	Berekenen voor de rest	30\|(>=10&<=20)	Records met nummer 30 of met een nummer tussen 10 en 20 (het resultaat van de berekening tussen haakjes).

U kunt de verschillende notatiesoorten ook combineren:

Voorbeeld	Weergegeven records
5999\|8100..8490	Alle records met het nummer 5.999 of een uit het interval tussen 8.100 en 8.490.
..1299\|1400..	Records met een nummer kleiner dan of gelijk aan 1.299 of gelijk aan 1.400 en hoger. Met andere woorden: alle nummers behalve 1.300 tot en met 1.399.
>50&<100	Records met een nummer groter dan 50 en kleiner dan 100, ofwel nummers 51 tot en met 99.
C&D	Tekst met de tekens C en D.
bo?	Tekst die begint met “bo” zoals boek, boekhouding en geboekt. “bo” moet in de tekst voorkomen, gevolgd door ten minste één teken en kan worden omgesloten door een onbeperkt aantal tekens in de vorm van zowel hoofdletters als kleine letters.

Voorbeeld klant omzet

Hier zijn 3 manieren om een omzet overzicht te maken per klant/maand zoals hier weergegeven:

Via een methode

Dit is de meest moeilijke manier voor deze reden is alleen Feb en Mrt opgenomen als voorbeeld.

Per periode moet:

een kolom worden opgegeven (zie kolom 'C' en 'D'), waarbij de JOINTYPE '6' wordt gebruikt.
een regel als datumfilter worden opgegeven (zie regel '8' en '9').
en een uitkomst regel met de methode 'SOM' worden opgegeven (zie regel '11' en '12').

Via een functie uit de bibliotheek

Een zelf gedefinieerde functie uit de “Function bibliotheek” gebruiken in de expressie kolom:

Via een functie definitie

Een “Function definition” gebruiken in de expressie kolom:

VBA Tips

Als de mogelijkheden die Excel en ExsionBC standaard bieden nog niet genoeg zijn kunnen ze altijd nog in VBA gemaakt worden. ExsionBC heeft hiervoor events en functies die gebruikt kunnen worden om uw eigen VBA code en ExsionBC functies te combineren.

In de eerste paragraaf wordt dit uitgelegd. In de hoofdstukken daarna, volgen een aantal praktische tips en trucs die in het verleden door ons zijn toegepast en ook generiek te gebruiken zijn.

In de voorbeelden hierna wordt ‘ExsionBC.xlam’ gebruikt als verwijzing naar de ExsionBC invoegtoepassing.

Automatische procedures met VBA

ExsionBC biedt de mogelijkheid eigen VBA procedures uit te voeren voor of na het gegevens vernieuwen. Verder is het andersom mogelijk de functie gegevens vernieuwen uit te voeren vanuit de eigen procedure. Houdt er wel rekening mee dat fouten die optreden binnen de eigen procedure van invloed kunnen zijn op de werking van ExsionBC. Test bij eventuele problemen altijd eerst uit of de fout ook optreed met standaard gebruik van ExsionBC zonder eigen procedures.

Aanroep vanuit een eigen procedure

Vanuit een eigen VBA procedure kan de functie gegevens vernieuwen worden aangeroepen. Op de plaats waar u in uw eigen procedure de gegevens wilt vernieuwen voegt u de volgende regel toe in de code via de VBA editor (F11):

Application.Run "'ExsionBC.xlam'!ExsionBC_REFRESH"

De uitvoering van deze regel heeft exact hetzelfde effect als het drukken op het uitroepteken in het menu van ExsionBC.

Om de uitvoering niet afhankelijk te maken van ExsionBC kunt u het beste om de uitvoering van ExsionBC functies “On Local Error” regels toevoegen.

On Local Error Resume Next
Application.Run "'ExsionBC.xlam'!ExsionBC_REFRESH"
On Local Error GoTo 0

Naast gegevens vernieuwen kunt u ook de functie formules naar waarden automatisch uitvoeren. Neem hiervoor de volgende code op:

Application.Run "'ExsionBC.xlam'!ExsionBC_MNU_VALUES"

Indien u de vraag krijgt of de formules omgezet moeten worden naar waarden kunt u deze onderdrukken door meldingen tijdelijk uit te schakelen. Dat doet u door een regel voor en na de formules naar waarden actie te plaatsen. Eventueel kunt u de huidige instelling opslaan in een variabele om deze vervolgens weer terug te plaatsen.

Dim s_displayAlertsSetting As Boolean

s_displayAlertsSetting = Application.DisplayAlerts
Application.DisplayAlerts = False
On Local Error Resume Next
Application.Run "'ExsionBC.xlam'!ExsionBC_MNU_VALUES"
On Local Error GoTo 0
Application.DisplayAlerts = s_displayAlertsSetting

Uitvoering procedure voor gegevens vernieuwen

Het is mogelijk een procedure uit te voeren net voor het gegevens vernieuwen. Neem hiervoor de volgende code op in het project. Voer in plaats van [Naam eigen procedure] de naam in van de procedure die u wilt uitvoeren. Deze procedure dient binnen hetzelfde project aanwezig te zijn.

Sub ExsionBC_BeforeRefresh()
	Call [Naam eigen procedure]
End Sub

Om de gegevens te vernieuwen af te breken kan de volgende code worden gebruikt:

Sub ExsionBC_BeforeRefresh()
	If Cancel Then
		Err.Raise 513, "exsionbc_cancel"
		Exit Sub
	End If
End Sub

Uitvoering procedure na gegevens vernieuwen

Naast het uitvoeren van een procedure net voor het gegevens vernieuwen is het ook mogelijk iets uit te voeren net na het gegevens vernieuwen. Neem hiervoor onderstaande code op in het project. Voer in plaats van [Naam eigen procedure] weer de naam in van de procedure die u wilt uitvoeren.

Sub ExsionBC_AfterRefresh()
	Call [Naam eigen procedure]
End Sub

Automatisch verversen na wijziging parameter

Benoem de cel die u wijzigt met een logische naam. In het voorbeeld hieronder is dit ‘Subcategorie’. Indien u een andere naam gebruikt past u deze dan ook in onderstaande code aan.

Plaats vervolgens de volgende code in ThisWorkbook.

Private Sub Workbook_SheetChange(ByVal Sh As Object, ByVal Target As Range)
	If Target = ActiveSheet.Range("Subcategorie") Then
		Application.Run "'ExsionBC.xlam'!ExsionBC_REFRESH"
		ActiveSheet.Calculate
	End If
End Sub

Deactiveren van ExsionBC

Om ExsionBC te deactiveren dient u de invoegtoepassing voor de gebruiker te deactiveren. U kunt dit doen door de volgende stappen uit te voeren:

Druk op de knop “Bestand” (Links boven aan in het scherm).

Druk op de knop “Opties”.

Kies voor de optie “Invoegtoepassingen” en druk op start.

Haal het vink voor de invoegtoepassing ExsionBC weg en druk op “OK”.

Het ExsionBC menu is verwijderd uit het lint van Excel, en de gebruikers licentie is vrijgegeven.

Extensie verouderd

Als deze menu optie beschikbaar is, dan is er een nieuwe “Exsion Reporting” app beschikbaar. Deze moet dan worden bijgewerkt in “Dynamics 365 Business Central”.

Afhankelijk van Uw omgeving kan dit door één van de volgende procedures te volgen:

MS-Cloud
OnPrem

MS-Cloud

Om de “Exsion Reporting” App (extensie) bij te werken in de MS-Cloud, moet u rechten hebben om bij de “Dynamics 365 Business Central admin center” te komen.

Ga naar “Instellingen” en kies voor “Admin Center”:

U wordt naar de volgende URL “https://businesscentral.dynamics.com/[TENANT_ID]/admin” geleid.

Kies de omgeving waarin u de “Exsion Reporting” App wilt bijwerken. In dit voorbeeld is gekozen voor “Production”.

Kies voor “Apps”

Zoek naar “Exsion Reporting” en druk op “Install update”

Druk op “Yes” om de “Exsion Reporting” app bij te werken naar de laaste versie.

Druk herhaaldelijk op “Refresh” om te kijken of de “Available Update Action” veranderd naar “Up to Date”.

OnPrem

Open de “Business Central Administration Shell” omgeving en voor de volgende commando's uit.

cd \ExsionBC
Uninstall-NAVApp -ServerInstance BC220 -Name 'Exsion Reporting'
Unpublish-NAVApp -ServerInstance BC220 -Name 'Exsion Reporting'
Publish-NAVApp -ServerInstance BC220 -Path 'HB Software_Exsion Reporting.app'
Sync-NAVApp -ServerInstance BC220 -Name 'Exsion Reporting' -Mode ForceSync
Install-NAVApp -ServerInstance BC220 -Name 'Exsion Reporting' -Force