In deze handleiding wordt beschreven op welke wijze er een Excel-Project dient te worden gedefinieerd om deze aan de functionaliteit van het importeren van Excell of het exporteren naar Excel toe te voegen. Het definiëren van Excel - projecten bestaat uit twee verschillende fasen, namelijk het opstellen van een stored procedure binnen uw database. Een stored procedure is een SQL-programma waarin is beschreven op welke wijze gegevens uit uw database dient te worden gehaald of wordt ingelezen. Vervolgens dient u met behulp van het XML-bestand de mapping tussen uw Excel - spreadsheet en de stored procedure te definiëren. De rest wordt door WTell voor u geregeld.

In deze handleiding wordt alleen het opstellen van de mapping met behulp van het XML - bestand beschreven. Dit omdat het opstellen van een stored procedure binnen uw database grotendeels database specifiek is.

Versie	Datum	Omschrijving
1.0.	10-3-2009	1e versie

Het definiëren van een Excel-Project om hiermee vanuit Excell een import en/of een export van een naar een software pakket te doen is binnen de module WTell-Excel middels een XML-bestand geregeld. Binnen dit XML-bestand, wordt de vertaling van het geselecteerde spreadsheet in een database query door middel van een stored procedure geregeld.

Hieronder volgt een korte omschrijving van een XML-schema welke wordt gebruikt om Excel-Projecten te definiëren. Bij het opstarten van de module WTell-Excel worden deze XML-files eenmalig door middel van DOM in Java-objecten vertaalt, welke u vervolgens kunt gebruiken om te gaan importeren of exporteren.

Binnen de wereld van XML is het gebruikelijk om een definitie te maken van het XML-bestand, zodat de gemaakte XML-bestanden kunnen worden gevalideerd en er tijdens de uitvoering geen fouten kunnen optreden. Bij het opstarten van WTell-Excel zal deze module de gemaakte Excel-Projecten valideren tegen een XML-schema. Indien u een nieuw project aanmaakt is het verstandig om eerst zelf uw gemaakte project te valideren tegen een XML-schema.

Deze handleiding is een globale omschrijving van het opstellen van een Excel-Project. Dit dient om te laten zien dat het vrij eenvoudig is om een nieuw Excel-Project op te stellen, echter dit vereist nog wel enige technische kennis. Het beste is om deze activiteiten door Wilhelm Tell te laten uitvoeren of deze aan uw IT-afdeling instructie te laten geven, zodat vrij vlot nieuwe projecten zonder problemen zijn te definiëren.

Het XML schema voor de Excel-Projecten ziet er als volgt uit:

Het XML-schema voor Excel - Projecten

Dit XML schema is gelaagd opgebouwd en bestaat uit 1 hoofdelement, namelijk: excelsettings. Dit hoofdelement is een zogenaamde complextype, hetgeen betekent dat deze is opgebouwd uit verschillende subelementen. De volgende 2 subelementen zijn herkenbaar, namelijk header en parameters. De header bevat alle algemene informatie over het Excel-Project en de parameters bevatten informatie over de wijze waarop de Excel-columns moeten worden omgezet in database parameters voor de stored procedures.

Het header element

Het header element heeft als type header en bestaat uit de volgende componenten, namelijk:

Element	Omschrijving
projectcode	Dit is de unieke code van het Excel-Project. Deze code wordt door WTell-Excel gebruikt om de excel-projecten van elkaar te onderscheiden.
projectdesc	Dit is de omschrijving van het project. Deze omschrijving krijgen gebruikers van WTell-Excel in hun schermen te zien
xmlfile	Dit is de bestandsnaam van het XML-bestand. Dit veld wordt gebruikt voor controle. Vul hier de naam van het XML-bestand in waaronder deze wordt opgeslagen. Dit kan zonder gegevens over de map dus test.xml en niet c:\webserver\excel\test.xml
version	Deze methode wordt door WTell-Excel gebruikt om te herkennen welke versie moet worden gebruikt. Vul hier de datum van het opstellen in en dit in de vorm van jaar- maand-dag, dus 5 april 2009 wordt 20090405. Hiermee is redelijk verzekerd dat bij updates van Wtell-Excel uw projecten nog goed blijven functioneren of u eenvoudig uw projecten kunt aanpassen.
importproc	De stored procedure welke het project moet aanroepen voor het uitvoeren van imports vanuit Excel naar uw softwarepakket, zoals ISAH van ISAH7
exportproc	De stored procedure welke het project moet aanroepen voor het uitvoeren van een export naar Excel vanuit uw softwarepakket, zoals Exact.

Het parameters element

Het parameters element bestaat uit verschillende parameters welke minimaal 1 keer en maximaal onbeperkt kunnen voortkomen. Iedere parameter is weer een complextype en heeft de volgende opbouw.

Element	Omschrijving
excelname	De naam van het parameter binnen Excel. Dit is de waarde welke als header in het Excel-column in de spreadsheet wordt meegegeven.
dbname	De naam van de parameter binnen de stored procedure.
javaclass	De java-class dat het element bij het importeren en exporteren dient te krijgen. Dit zijn voornamelijk de meeste primitieve types. Dit veld is toegevoegd om te voorkomen dat er fouten optreden door het automatisch aanmaken van het verkeerde java type
obliged	Bepaald of de parameter verplicht is voor een goede verwerking door de stored procedure. Bij het exporteren en importeren van artikelen is bijvoorbeeld het veld databaseveld dat de primaire sleutel van tabellen vormt handig om mee te geven, omdat anders de import/export niet goed zal functioneren. Andere velden zijn optioneel en hoeven alleen te worden gebruikt als deze aanwezig op de Excel-Sheet zijn. Voor deze optie is gekozen, omdat u op deze wijze binnen een Excel-Project meerdere soorten imports/exports kunt uitvoeren. Waarden zijn 1 voor verplicht en 0 voor niet verplicht.
exporttype	Dit veld geeft aan voor welke exporttype het veld wordt gebruikt. Velden kunnen namelijk alleen nodig zijn voor de import(I), export(E) of beide(B).

Voorbeeld

Hieronder ziet u een uitgewerkt Excel-Project welke wordt gebruikt om vanuit Excel naar een softwarepakket te importeren.

Voorbeeld van een eenvoudig Excel - project in XML

Prima u kunt nu eenvoudig nieuwe Excel-Projecten aanmaken om gebruik te kunnen maken van de module WTell-Excel