OnsDB: selectie van gegevens

Deze categorie bevat instellingen gerelateerd aan de werking van OnsDB en kan ingericht worden met de volgende parameters:

1. De URL van de applicatie moet verplicht opgegeven worden. Voorbeeld:

   url = klantnaam.ioservice.net

   Voer hier alleen een URL in die eindigt op .ioservice.net. Overige URL's werken niet.

2. Start en end kunnen gebruikt worden om het begin en einde van een periode op te geven. Deze periode wordt gebruikt om de tabellen die dat ondersteunen, tijdsgebonden op te halen. Hiermee worden onnodig lange doorlooptijden voorkomen. De datums kunnen in het verleden en in de toekomst liggen.

   Een einddatum in de toekomst is bijvoorbeeld handig voor het ophalen van toekomstige roostertoewijzingen.

   • De waarde moet opgegevens worden volgens het format: jjjj-mm-dd. De einddatum is tot-en-met. Voorbeeld:

     start = 2019-01-01

     end = 2019-05-01

   • Er zijn een aantal speciale waardes die ook gebruikt kunnen worden:

     today

     yesterday

     Deze berekenen de huidige dag of gisteren op basis van het moment van starten van OnsDB.

   Als deze instellingen niet opgegeven worden, dan zal OnsDB de standaard waardes gebruiken. Voor start is dit 1 januari van het voorgaande jaar en voor end is dit yesterday. Als je dus niet expliciet een einddatum opgeeft, worden gegevens tot en met gisteren opgehaald.

    

3. Met include en exclude kan worden aangegeven welke tabellen juist wel of niet gedownload moeten worden. Beide parameters verwachten een komma-gescheiden lijst van tabelnamen.

   • Om bijvoorbeeld alleen de invoixes en invoice_rows te downloaden:

     include = invoices, invoice_rows

   • Om bijvoorbeeld alle tabellen behalve de presence_logs te downloaden:

     exclude = presence_logs

    

4. De schema-version parameter biedt de mogelijkheid om op eigen gelegenheid te migreren naar een nieuwere versie van het datamodel. Als deze instelling niet wordt opgegeven, zal altijd de meest recente versie van het datamodel gedownload worden. Voor meer informatie over deze parameter zie deze handleiding. Voorbeeld:

   schema-version = 4048

    

5. Met de threads instelling wordt aangegeven hoeveel systeem-threads gebruikt mogen worden tijdens het downloaden. De waarde van deze instelling kan invloed hebben op de doorlooptijd van OnsDB. De standaardwaarde van deze instelling is 4. De aanbevolen waarde is het aantal processoren die er beschikbaar zijn, maar nooit meer dan 4.

    

6. Mocht er gebruik gemaakt worden van een proxy-server, dan kan de URL van de proxy server aangegeven worden in de proxy parameter.

    

7. De email parameter kan eventueel gebruikt worden om een rapport te laten versturen naar een zelfgekozen emailadres. Dit rapport bevat een overzicht van de doorlooptijd en eventuele fouten die zijn tegengekomen. Voorbeeld:

   email = mail@example.com

Deze categorie bevat de verbindingsinstellingen van de lokale database en kan ingericht worden met de volgende parameters:

1. Het type van de lokale database moet verplicht opgegeven worden. Om verbinding te maken met een Microsoft SQL sever via ODBC:

   type = mssql

   Om verbinding te maken met een MySQL server:

   type = mysql

2. Om gebruik te maken van een Microsoft SQL Server database moet een ODBC koppeling gemaakt worden. De odbc instelling moet de naam van deze koppeling bevatten. Voorbeeld:

   odbc = onsdb4

3. De parameters username en password kunnen gebruikt worden indien een gebruikersnaam en wachtwoord nodig zijn om verbinding te kunnen maken met de lokale database. Voorbeeld:

   username = onsdb

   password = 123

4. Met de database instelling wordt de naam van de te gebruiken database opgegeven. Voorbeeld:

   database = onsdb

5. Mocht de databaseserver niet op de lokale machine draaien, dan kunnen de host en port parameters gebruikt worden om het IP-adres of de hostname en de poort van de databaseserver op te geven. Voorbeeld:

   host = 192.168.1.1

   port = 3308

6. Eventuele extra verbindingsopties kunnen opgegeven worden met behulp van de parameter options. Om de datum en tijd in de Nederlandse tijdzone op te slaan kan bijvoorbeeld de volgende optie gebruikt worden:

   opions = loc=local

Deze categorie bevat de contactgegevens van de persoon of persoonsgroep (bijvoorbeeld applicatiebeheer) die verantwoordelijk is voor het beheren van het toegangscertificaat. Deze gegevens kunnen worden gebruikt om contact op te nemen over de certificaataanvraag. De parameters name, email en tel moeten verplicht ingevuld worden. Voorbeeld:

name = Voornaam Achternaam

email = mail@example.com

tel = +31 6 12345678