3. De casestudy

We willen een .NET-toepassing schrijven waarmee een gebruiker simulaties kan uitvoeren voor de loonberekening van de kinderopvangmedewerkers van de vereniging „Maison de la petite enfance“ in een gemeente. We zullen zowel aandacht besteden aan de opbouw van de code DotNet van de applicatie als aan de code zelf.

3.1. De database-

De statische gegevens die nodig zijn voor het opstellen van de loonstrook zijn opgeslagen in een SQL Server Express-database met de naam dbpam (pam = Paie Assistante Maternelle). Deze database heeft een beheerder met de naam sa en het wachtwoord msde.

De database bevat drie tabellen: EMPLOYES, COTISATIONS en INDEMNITES, met de volgende structuur:


Table EMPLOYES : rassemble des informations sur les différentes assistantes maternelles

Structuur:

`SS`	sofinummer van de werknemer – primaire sleutel
`NOM`	naam van de werknemer
`prenom`	zijn voornaam
`ADRESSE`	zijn adres
`VILLE`	zijn woonplaats
`CODEPOSTAL`	zijn postcode
`INDICE`	zijn salarisindex - externe sleutel op het veld [INDICE] van de tabel [INDEMNITES]

De inhoud zou als volgt kunnen zijn:


Table COTISATIONS : rassemble les taux des cotisations sociales prélevées sur le salaire

Structuur:

De inhoud zou als volgt kunnen zijn:

De sociale premiepercentages zijn onafhankelijk van de werknemer. De bovenstaande tabel bevat slechts één rij.


Table INDEMNITES : rassemble les différentes indemnités dépendant de l'indice de l'employé

`INDICE`	salarisindex - primaire sleutel
`BASEHEURE`	nettoprijs in euro's voor een uur kinderopvang
`ENTRETIENJOUR`	vergoeding voor levensonderhoud in euro per dag dienst
`REPASJOUR`	maaltijdvergoeding in euro per dag dienst
`INDEMNITESCP`	vergoeding voor betaald verlof. Dit is een percentage dat op het basisloon moet worden toegepast.

De inhoud zou als volgt kunnen zijn:

Er zij opgemerkt dat de vergoedingen kunnen variëren van kinderverzorgster tot kinderverzorgster. Ze zijn namelijk gekoppeld aan een specifieke kinderverzorgster via haar salarisindex. Zo heeft mevrouw Marie Jouveinal, die een salarisindex van 2 heeft (tabel EMPLOYES), een uurloon van 2,1 euro (tabel INDEMNITES).

De relaties tussen de drie tabellen zijn als volgt:

Er is een vreemde-sleutelrelatie tussen de kolom EMPLOYES (INDICE) en de kolom INDEMNITES (INDICE).

De zo aangemaakte database [dbpam] genereert twee bestanden in de map van SQL Server Express:

De [dbpam.mdf, dbpam_log.ldf]-bestanden kunnen naar een andere machine worden overgezet en opnieuw worden gekoppeld aan de SGBD SQL Server Express op die machine. Ga als volgt te werk:

de bestanden van de BD en [dbpam] worden gekopieerd naar een map

start u SQL Server Express
met de client SQL Server Management Studio Express, en koppel het bestand [dbpam.mdf] aan SGBD:

rechtsklikken op [Databases] / Toevoegen
kies het bestand [dbpam.mdf] via een knop [Add] (niet afgebeeld)
het bijgevoegde bestand leidt tot een BD dat nog niet mag bestaan. Hier, in het veld [Attach As], is de naam [dbpam2] gegeven aan de nieuwe BD.
We zien het nieuwe bestand BD en de bijbehorende tabellen

Deze techniek om een BD te koppelen is handig om een BD van de ene post naar de andere over te brengen en we zullen deze hier af en toe gebruiken.

3.2. Berekeningswijze van het salaris van een kinderoppas

We leggen nu uit hoe het maandsalaris van een kinderoppas wordt berekend. Als voorbeeld nemen we het salaris van mevrouw Marie Jouveinal, die in de te betalen maand 150 uur heeft gewerkt, verdeeld over 20 dagen.

Er wordt rekening gehouden met de volgende elementen:	`[TOTALHEURES]: total des heures travaillées dans le mois` `[TOTALJOURS]: total des jours travaillés dans le mois`	`[TOTALHEURES]=150 [TOTALJOURS]= 20`
Het basissalaris van de kinderopvangmedewerkster wordt berekend aan de hand van de volgende formule:	`[SALAIREBASE]=([TOTALHEURES]* [BASEHEURE])*(1+ [INDEMNITESCP]/100)`	`[SALAIREBASE]=(150[2.1])(1+0.15)= 362,25`
Op dit basisloon moeten een aantal sociale premies worden ingehouden:	`Contribution sociale généralisée et contribution au remboursement de la dette sociale : [SALAIREBASE][CSGRDS/100]` `Contribution sociale généralisée déductible : [SALAIREBASE][CSGD/100]` `Sécurité sociale, veuvage, vieillesse : [SALAIREBASE][SECU/100]` `Retraite Complémentaire + AGPF + Assurance Chômage : [SALAIREBASE][RETRAITE/100]`	`CSGRDS : 12,64` `CSGD : 22,28` `Sécurité sociale : 34,02` `Retraite : 28,55`
Totaal aan sociale premies:	`[COTISATIONSSOCIALES]=[SALAIR EBASE]*(CSGRDS+CSGD+SECU+RETR`	`[COTISATIONSSOCIALES]=97,48`
Bovendien heeft de kinderopvangmedewerkster voor elke gewerkte dag recht op een verblijfsvergoeding en een maaltijdvergoeding. In dit kader ontvangt zij de volgende vergoedingen:	`[Indemnités]=[TOTALJOURS]*(EN TRETIENJOUR+REPASJOUR)`	`[INDEMNITES]=104`
Uiteindelijk bedraagt het aan de kinderopvangmedewerkster uit te betalen nettoloon:	`[SALAIREBASE]- [COTISATIONSSOCIALES]+ [INDEMNITÉS]`	`[salaire NET]=368,77`

3.3. Herinneringen ADO.NET

De applicatie voor loonberekening heeft de gegevens uit de database [dbpam] nodig. De architectuur ervan zal als volgt zijn:

in [1] dient de gebruiker een verzoek in
in [2] verwerkt de salarisapplicatie deze aanvraag.
de applicatie kan dan gegevens uit de database nodig hebben. Vervolgens doet de applicatie een verzoek aan de provider ADO.NET van de door SGBD gebruikte [4].
Deze raadpleegt de database [5] en stuurt de resultaten terug naar de provider ADO.NET, die ze op zijn beurt doorgeeft aan de applicatie
deze verwerkt deze resultaten en stelt een antwoord [5] op voor de gebruiker

We zullen nu de belangrijkste interfaces bespreken die een leverancier ADO.NET aan zijn klanten [3] aanbiedt.

In de verbonden modus doet de applicatie het volgende:

een verbinding met de gegevensbron
werkt met de gegevensbron in lees-/schrijfmodus
sluit de verbinding af

Drie ADO.NET-interfaces zijn voornamelijk betrokken bij deze bewerkingen:

IDbConnection, die de eigenschappen en methoden van de verbinding omvat.
IDbCommand, dat de eigenschappen en methoden van de uitgevoerde opdracht SQL omvat.
IDataReader, dat de eigenschappen en methoden van het resultaat van een SQL Select-opdracht omvat.

De interface IDbConnection

Wordt gebruikt om de verbinding met de database te beheren. Tot de methoden M en eigenschappen P van deze interface behoren onder andere de volgende:

Naam	Type	Rol
`ConnectionString`	P	verbindingsstring naar de database. Deze bevat alle parameters die nodig zijn om verbinding te maken met een specifieke database.
`Open`	M	opent de verbinding met de database die is gedefinieerd door ConnectionString
`Close`	M	sluit de verbinding
`BeginTransaction`	M	start een transactie.
`State`	P	verbindingsstatus: ConnectionState.Closed, ConnectionState.Open, ConnectionState.Connecting, ConnectionState.Executing, ConnectionState.Fetching, ConnectionState.Broken

Als Connection een klasse is die de interface IDbConnection implementeert, kan de verbinding als volgt tot stand worden gebracht:

1
2
3

IDbConnection connexion=new Connection();
connexion.ConnectionString=...;
connexion.Open();

De interface IDbCommand

Wordt gebruikt om een opdracht SQL of een opgeslagen procedure uit te voeren. Tot de methoden M en eigenschappen P van deze interface behoren onder meer de volgende:

Naam	Type	Rol
`CommandType`	P	geeft aan wat er moet worden uitgevoerd – haalt zijn waarden uit een opsomming: - CommandType.Text: voert de opdracht SQL uit die is gedefinieerd in de eigenschap CommandText. Dit is de standaardwaarde. - CommandType.StoredProcedure: voert een opgeslagen procedure uit in de database
`CommandText`	P	- de tekst van de uit te voeren opdracht SQL als CommandType = CommandType.Text - de naam van de opgeslagen procedure die moet worden uitgevoerd als CommandType = CommandType.StoredProcedure
`Connection`	P	de verbinding IDbConnection die moet worden gebruikt om de opdracht SQL uit te voeren
`Transaction`	P	de transactie IDbTransaction waarin de opdracht SQL moet worden uitgevoerd
`Parameters`	P	de lijst met parameters van een geconfigureerde opdracht SQL. De opdracht update articles set price=price1.1 where id=@id* heeft de parameter @id.
`ExecuteReader`	M	om een opdracht SQL Select uit te voeren. We krijgen een object IDataReader dat het resultaat van Select weergeeft.
`ExecuteNonQuery`	M	om een opdracht SQL (Update, Insert, Delete) uit te voeren. Dit levert het aantal rijen op dat door de bewerking is beïnvloed (bijgewerkt, ingevoegd, verwijderd).
`ExecuteScalar`	M	om een opdracht SQL Select uit te voeren die slechts één resultaat oplevert, zoals in: select count() from articles*.
`CreateParameter`	M	om de parameters IDbParameter aan te maken voor een geconfigureerde opdracht SQL.
`Prepare`	M	maakt het mogelijk de uitvoering van een geparametriseerde query te optimaliseren wanneer deze meerdere keren met verschillende parameters wordt uitgevoerd.

Als Command een klasse is die de interface IDbCommand implementeert, ziet de uitvoering van een opdracht SQL zonder transactie er als volgt uit:

// verbinding openen 
IDbConnection connexion=...
connexion.Open();
// opdracht voorbereiden
IDbCommand commande=new Command();
commande.Connection=connexion;
// select-opdracht uitvoeren
commande.CommandText="select ...";
IDbDataReader reader=commande.ExecuteReader();
...
// update-, insert- en delete-opdracht uitvoeren
commande.CommandText="insert ...";
int nbLignesInsérées=commande.ExecuteNonQuery();
...
// verbinding afsluiten
connexion.Close();

De interface IDataReader

wordt gebruikt om de resultaten van een opdracht SQL Select in te kapselen. Een object IDataReader vertegenwoordigt een tabel met rijen en kolommen, die achtereenvolgens worden verwerkt: eerst de eerste rij, dan de tweede, ... Onder de methoden M en eigenschappen P van deze interface bevinden zich de volgende:

Naam	Type	Rol
`FieldCount`	P	het aantal kolommen in de tabel IDataReader
`GetName`	M	GetName(i) geeft de naam weer van kolom nr. i van de tabel IDataReader.
`Item`	P	Item[i] vertegenwoordigt kolom nr. i van de huidige rij in de tabel IDataReader.
`Read`	M	gaat naar de volgende regel van de tabel IDataReader. Geeft de booleaanse waarde True terug als het lezen is gelukt, False anders.
`Close`	M	sluit de tabel IDataReader.
`GetBoolean`	M	GetBoolean(i): geeft de booleaanse waarde weer van kolom nr. i van de huidige rij in de tabel IDataReader. De andere, vergelijkbare methoden zijn: GetDateTime, GetDecimal, GetDouble, GetFloat, GetInt16, GetInt32, GetInt64, GetString.
`Getvalue`	M	Getvalue(i): geeft de waarde van kolom nr. i van de huidige rij van de tabel IDataReader weer als type object.
`IsDBNull`	M	IsDBNull(i) levert True op als kolom nr. i van de huidige rij in de tabel IDataReader geen waarde heeft, wat wordt aangeduid met de waarde SQL NULL.

De verwerking van een object IDataReader ziet er vaak als volgt uit:

// verbinding openen 
IDbConnection connexion=...
connexion.Open();
// opdracht voorbereiden
IDbCommand commande=new Command();
commande.Connection=connexion;
// uitvoering van een SELECT-opdracht
commande.CommandText="select ...";
IDataReader reader=commande.ExecuteReader();
// verwerking van resultaten
while(reader.Read()){
     // huidige regel verwerken
        ...
}
// reader afsluiten
reader.Close();
// verbinding afsluiten
connexion.Close();