Rapportage

Titel rapport

Dit is de naam die bovenaan je rapportpagina en in het Rapportbeheer-blok zal verschijnen.

-

Abstract

Een korte samenvatting van het rapport dat wordt weergegeven in de gebruikersrapportlijst.

Het opnemen van een Abstract helpt gebruikers in één oogopslag te begrijpen waar het rapport voor is, waardoor ze het rapport kunnen vinden dat ze nodig hebben en voorkomen dat er dubbele rapporten worden gemaakt.

Beschrijving

Wanneer een rapportbeschrijving wordt gemaakt, wordt de informatie weergegeven aan gebruikers in een vak boven de zoekfilters op de rapportpagina.

Het veld Omschrijving moet worden gebruikt om te beschrijven wat er in het rapport wordt getoond en wanneer/hoe het moet worden gebruikt.

Bron

De bron voor dit rapport wordt weergegeven.

Eenmaal opgeslagen, kan een rapportbron niet meer worden gewijzigd. Om een andere rapportbron te gebruiken, moet een nieuw rapport worden gemaakt.

Verberg op de lijst met gebruikersrapporten

Indien ingeschakeld, wordt dit rapport niet weergegeven op de pagina Mijn rapporten voor gebruikers, maar is het toegankelijk via de URL.

-

• Cursus voltooien
• Cursusvoltooiing inclusief geschiedenis
• Cursuslidmaatschap
• Uitvoeringen
• Aanmeldingen voor de bijeenkomst
• Inschrijfblad voor de bijeenkomst
• Bijeenkomst sessies

Aantal pogingen per pagina

Geef het aantal rijen op dat op elke pagina van het rapport zal verschijnen. Onderaan elke pagina kan de gebruiker klikken om de volgende pagina met gegevens te bekijken. Dit bepaalt ook het aantal rijen dat getoond zal worden in het rapport tabel blok.

-

Rapporttype

Dit is een informatieveld dat toont of dit een gebruikersrapport of een ingebed rapport is.

-

Kolom

Gegevens die beschikbaar zijn voor rapporten zijn afhankelijk van de bron, maar kunnen het volgende omvatten:

• Gebruikersprofielinformatie
• Competentiedetails en voltooiingsstatus
• Cursusdetails en voltooiingsstatus
• Bijeenkomstdetails en aanwezigheid
• Opdracht inzendingen
• Doelgroepen
• Programmadetails en voltooiingsstatus

Zie Rapportbronnen voor meer informatie over beschikbare gegevensbronnen en kolomopties.

Alle extra velden zullen automatisch beschikbaar zijn in de relevante rapportkolom.

Er zal een waarschuwing verschijnen als je een combinatie van kolommen en/of aggregatiemethodes gebruikt die niet compatibel zijn met elkaar. Om het probleem op te lossen, verander je één van de kolommen of aggregatiemethodes die in de waarschuwing zijn gemarkeerd. 

Aggregatie of groepering

Voor elke record die dezelfde waarde heeft, kan een berekening die verband houdt met het kolomveldtype worden gekozen, dit omvat:

• Aantal voor elk record, aantal unieke waarden in het veld
• Gemiddelde, totaal, maximum, minimum voor numerieke kolommen
• Tijdsperiode van uren, dagen, weken, maanden voor tijdkolommen

Sommige rapporten gebruiken gegevensaggregatie al intern, in welk geval er een waarschuwing wordt weergegeven onder het tabblad Kolommen van het rapport.

Zie meer over aggregatie en groeperingen, inclusief voorbeelden.

Kop aanpassen

Vink naast elke kolom het selectievakje aan onder de kop Aanpassen en voer een nieuwe kolomtitel in als je de bestaande titel wilt overschrijven.

-

Opties

Met deze kolom kun je een aantal acties uitvoeren:

• Tonen/verbergen: Gebruik het oogicoontje om een kolom in het rapport te tonen of te verbergen
  • Open oog betekent dat de kolom zichtbaar is ()
  • Doorgestreept oog betekent dat het verborgen is ()
• Verwijder: Gebruik het kruisicoontje () om een kolom uit het rapport te verwijderen
• Rangschik: Gebruik de pijlen omhoog () en omlaag () om de volgorde van de rapportkolommen van links naar rechts te rangschikken

-

Sorteren

Met de sectie Sorteren kun je standaardgedrag instellen voor het sorteren van kolommen.

• Standaardkolom: Kies de standaardkolom om te sorteren
• Standaardvolgorde: Stel de volgorde in om op te sorteren

Als je bijvoorbeeld de volledige naam van de gebruiker selecteerde als de standaardkolom en Oplopend (A tot Z, 1 tot 9) als de standaardvolgorde, dan zou het rapport standaard gesorteerd worden met behulp van de oplopende alfabetische volgorde van de kolom met de volledige naam van de gebruiker. 

Let op dat de gebruiker die het rapport uitvoert ook kan sorteren op andere kolommen door op de kolomkop te klikken.

• Kolom
• Lijn
• Horizontale balk
• Pie
• Verspreid
• Zone
• Donut
• Voortgangsdonut (werkt alleen in ChartJS)

• Gegevensreeks in kolommen: Rapportbouwer zal rapportkolommen behandelen als gegevensreeks. In de meeste gevallen is dit wat je wil. 
• Gegevensreeks in rijen: De rapportontwerpfunctie behandelt elk onderdeel in de kolom als een afzonderlijke gegevensreeks - gegevensrijen worden behandeld als gegevenspunten. Gewoonlijk wil je deze optie alleen selecteren als je meer kolommen in je rapport hebt dan rijen.

Zoekveld

Gebruik de zoekveldopties om de velden te selecteren waarop gebruikers mogen zoeken. Extra filters kunnen toegevoegd worden door te klikken op het dropdownmenu Nog een filter toevoegen.

-

Veldnaam aanpassen

Vink naast elk filter het selectievakje aan onder Veldnaam aanpassen en voer een nieuw label in dat naast het filter wordt weergegeven wanneer het rapport wordt uitgevoerd.

-

Geavanceerd?

Vink het vakje Geavanceerd? aan naast alle zoekopties die beschikbaar moeten zijn als de gebruiker op de knop Geavanceerd tonen klikt in het rapport. Deze optie is nuttig om niet vaak gebruikte zoekopties beschikbaar te maken, maar is standaard verborgen.

-

Filteren vereist

Vink het vakje Filteren vereist aan om een zoekveld verplicht te maken. Dit betekent dat gebruikers een optie voor dit zoekveld moeten selecteren voordat ze het rapport kunnen uitvoeren en bekijken.

De optie Filteren vereist kan worden gebruikt om ervoor te zorgen dat rapportviewers geen rapporten uitvoeren die een enorm aantal resultaten opleveren. Door van de kijkers te eisen dat ze het aantal resultaten beperken (door opties voor de vereiste velden te selecteren), kun je ervoor zorgen dat dit niet gebeurt.

Opties

Om een filter uit het rapport te verwijderen, klik je op het icoontje verwijderen onder de kolom Opties. Om de volgorde van de filters op de pagina te wijzigen, klik je op de pijlen omhoog en omlaag. De filters verschijnen in het Zoek op-vak in de volgorde waarin ze staan.

-

Zoekveld

Gebruik de zoekveldopties om de velden te selecteren waarop gebruikers mogen zoeken. Extra filters kunnen toegevoegd worden door te klikken op het dropdown menu Nog een filter toevoegen.

Veldnaam aanpassen

Vink naast elk filter het selectievakje aan onder Veldnaam aanpassen en voer een nieuw label in dat naast het filter wordt weergegeven wanneer het rapport wordt uitgevoerd.

Geavanceerd?

Vink het vakje Geavanceerd? aan naast alle zoekopties die beschikbaar moeten zijn als de gebruiker op de knop Geavanceerd tonen klikt in het rapport. Deze optie is nuttig om niet vaak gebruikte zoekopties beschikbaar te maken, maar is standaard verborgen.

Werkbalk zoekvak

Met het zoekveld op de werkbalk kunnen gebruikers meerdere velden per tekst zoeken in plaats van afzonderlijke velden te filteren.

Schakel het zoekveld op de werkbalk uit

Door dit vakje aan te vinken zal het zoekveld niet bovenaan de pagina verschijnen.

Zoekveld

Gebruik de zoekveldopties om de velden te selecteren waarop gebruikers mogen zoeken. Extra filters kunnen toegevoegd worden door te klikken op de dropdown kolom "Nog een zoekopdracht toevoegen".

Opties

Om een filter uit het rapport te verwijderen, klik je op het pictogram Verwijderen onder de kolom Opties. Om de volgorde van de filters op de pagina te wijzigen, klik je op de pijlen omhoog en omlaag. De filters verschijnen in het Filter op -vak in de volgorde waarin ze staan.

Rapporteer content

Hiermee kun je de algemene instellingen voor inhoudscontrole voor dit rapport selecteren:

• Alle records tonen: Elk beschikbaar record voor deze bron wordt getoond en er worden geen beperkingen opgelegd aan de beschikbare inhoud
• Toon records die voldoen aan één van de onderstaande criteria: Toon records die voldoen aan één van de onderstaande criteria
• Toon records die voldoen aan alle onderstaande criteria: Toon records die voldoen aan alle onderstaande criteria

Het is dan mogelijk om de criteria voor de bovenstaande rapportinhoudsinstellingen te configureren. De beschikbare criteria verschillen afhankelijk van de rapportbronnen en kunnen beperkingen bevatten op basis van gebruikers, posities of datums.

-

Toon door gebruiker

Indien geselecteerd, toont het rapport verschillende records, afhankelijk van de gebruiker die het rapport bekijkt en hun relatie met andere gebruikers.

-

Inclusief records van een bepaalde gebruiker

Beslis of een gebruiker alleen zijn eigen records of die van rapporten kan zien (kies uit direct, indirect en tijdelijk). 

-

Toon de huidige positie van de gebruiker 

Indien geselecteerd, toont het rapport de resultaten die afhankelijk zijn van de toegewezen positie van de gebruiker.

-

Inclusief records van onderliggende posities

Selecteer van welk niveau rapporten getoond moeten worden. Dit kan op of onder de positie van de gebruiker zijn. 

-

Toon door de huidige organisatie van de gebruiker

Indien geselecteerd, worden de resultaten weergegeven, afhankelijk van de organisatie waaraan de gebruiker is toegewezen.

-

Gegevens van onderliggende organisaties opnemen

Selecteer van welk niveau rapporten getoond moeten worden. Dit kan op of onder de organisatie van de gebruiker zijn. 

-

Toon door de organisatie wanneer voltooid

Indien geselecteerd, toont het rapport de resultaten, afhankelijk van de organisatie waaraan de gebruiker is toegewezen toen hij de cursus of competentie voltooide.

-

Toon records per doelgroep

Beperk rapportresultaten per doelgroep, zodat je alleen gegevens ziet voor die subgroep van gebruikers.

-

Toon aan de hand van de gemaakte tijd

Toon records op basis van de recorddatum. Indien geselecteerd, toont het rapport alleen records binnen het geselecteerde tijdsbestek.

-

Inclusief records van

Toon gegevens uit het verleden, de toekomst, de laatste 30 dagen, de volgende 30 dagen, het huidige boekjaar of het vorige boekjaar. Selecteer de optie 'Opnemen in record als datum ontbreekt' om records zonder datum in je rapport op te nemen.

-

Toon per uitvoeringsrol

Indien ingeschakeld kan de inhoud van het bijeenkomstrapport beperkt worden tot gebruikers met een bepaalde gebeurtenisrol. Een uitvoeringsrol moet zijn ingeschakeld op de algemene instellingen van de bijeenkomst om deze te kunnen selecteren als inhoudsbeperking.

-

Beperk toegang

Hiermee kun je selecteren of alle gebruikers dit rapport kunnen bekijken of dat alleen bepaalde gebruikers dit rapport kunnen bekijken op basis van de geselecteerde controles. 

-

Beperk toegang per rol

Stel de rolcriteria in voor toegang tot het rapport, met behulp van de context en de specifieke rol die een gebruiker heeft.

• Context: De locatie of het niveau binnen het systeem waartoe de gebruiker toegang heeft. Een systeembeheerder zou bijvoorbeeld toegang op systeemniveau hebben (context), terwijl een andere gebruiker alleen toegang op cursusniveau (context) mag hebben. Met Context kun je de context instellen waarin een gebruiker een rol toegewezen heeft gekregen om het rapport te bekijken.

• Rollen met toestemming om dit rapport te bekijken: Beperk de zichtbaarheid van een rapport tot specifieke systeemrollen. Alleen wanneer de gebruiker de juiste systeemrollen heeft op het moment dat het rapport wordt bekeken, wordt het tabblad Rapporten weergegeven in het Moodle-menu.

Let op dat de rol van Staff Manager gewoonlijk wordt toegewezen aan de gebruikerscontext in plaats van aan het systeemniveau. Als je medewerkersmanagers nodig hebt om het rapport te bekijken, dan moet je de gebruikers gebruiken die de rol kunnen hebben in elke context.

Beperk initiële weergave

Bepaalt hoe het rapport in eerste instantie wordt weergegeven en wordt aanbevolen voor grotere rapporten waarin je de resultaten filtert. Als deze instelling is ingeschakeld, wordt de snelheid van het rapport verhoogd door de gebruiker te vragen zoekfilters toe te passen en op de knop Zoeken te klikken voordat de rapportgegevens worden weergegeven.

Deze instelling wordt standaard ingeschakeld (aangevinkt) of uitgeschakeld (niet aangevinkt), afhankelijk van de algemene instelling. Beperk de initiële weergave in alle rapporten van de rapportbouwer.

Rapport cachen inschakelen

Indien ingeschakeld, wordt een kopie van dit rapport gegenereerd volgens een ingesteld schema en zullen gebruikers de resultaten van het opgeslagen of gecached versierapport zien. Dit maakt het weergeven en filteren van het rapport sneller omdat het niet elke keer dat het wordt geopend resultaten hoeft te genereren. Let op dat de weergegeven gegevens van de laatste keer zijn dat het rapport is gegenereerd, eerder dan 'live'-gegevens. We raden aan om deze instelling alleen in te schakelen indien nodig (het tonen van rapporten duurt te lang) en alleen voor specifieke rapporten waar dit een probleem is.

Om caching performance-opties in te stellen, moet het cachen van rapporten eerst ingeschakeld zijn op de pagina Configureer functies. 

Cache-schema

Bepaalt het schema dat wordt gebruikt om te controleren hoe vaak een nieuwe versie van het rapport wordt gegenereerd. Het rapport wordt gegenereerd door de achtergrondservertaak (ook wel cron-taak) die onmiddellijk de opgegeven tijd volgt. Als je bijvoorbeeld je cron hebt ingesteld om elke 20 minuten te lopen op 10, 30 en 50 minuten over het uur en je plant een rapport dat om middernacht loopt, dan zal het eigenlijk 10 minuten na middernacht lopen.

Gecachede rapporten worden na elkaar opgesteld, d.w.z. wanneer de eerste is voltooid, wordt de tweede gestart. Dit wordt gedaan in één stroom om overbelasting van de database te voorkomen. Als er meer dan één rapport is dat caching vereist, is een vertraging mogelijk, afhankelijk van de grootte van het rapport. De volgorde is niet gespecificeerd en het is niet gegarandeerd dat de rapportcaches elke keer in dezelfde volgorde ververst worden.

Huidige servertijd

Alle rapporten worden gecached op basis van de servertijd. Cache-status toont je huidige lokale tijd die anders kan zijn dan de servertijd. Zorg ervoor dat je rekening houdt met je servertijd bij het plannen van cache.

-

Nu genereren

Indien ingeschakeld, wordt de rapportcache onmiddellijk gegenereerd nadat de wijzigingen zijn opgeslagen.

Let op dat zowel de Beperk initiële weergave als de Schakel rapportcaching in op rapport-per-rapport basis en dat een rapport beide of één van deze opties niet hoeft te hebben ingeschakeld.

Gebruik databasekloon

Het is nu mogelijk om een tweede databankverbinding te configureren voor gebruik door de rapportbouwer. Het doel van deze secundaire connectie is dat je de query's van de hoofdrapportbouwer kunt richten op een alleen-lezen databasekloon om de performantie te verbeteren.

Deze instellingen moeten als zeer geavanceerd worden beschouwd. Ze moeten door sysadmin in config.php worden geconfigureerd en moeten handmatig worden ingeschakeld in individuele rapporten door een systeembeheerder via de rapportgenerator (deze instelling).

Het wordt aanbevolen dat sysadmins een aparte database-instantie maakt met een exacte kloon van de productiedatabank die automatisch gesynchroniseerd wordt gehouden.

Er kan geen ondersteuning worden geboden bij het configureren van een alleen-lezen slave en daarom heb je interne expertise nodig om dit te bereiken.

De enige technische vereiste voor de databases is dat de hoofddatabase moet voldoen aan de ACID-vereisten.

Degenen die de tweede databaseverbinding willen gebruiken, kunnen de instructies ervoor vinden in config-dist.php. Je kunt een alleen-lezen databasekloon gebruiken. Met deze instellingen kan de beheerder een tweede databank configureren:

// connectie die gebruikt zal worden voor geselecteerde Rapportgeneratorrapporten om de performance te verbeteren

// en verlaag de hoofdbelasting van de databank.
 //
 // $CFG->clone_dbname = 'xxx';
 // $CFG->clone_dbhost = $CFG->dbhost; // optioneel
 // $CFG->clone_dbuser = $CFG->dbuser; // optioneel
 // $CFG->clone_dbpass = $CFG->dbpass; // optioneel
 // $CFG->clone_dboptions = $CFG->dboptions; //optioneel