Haza-21 Handleiding
technische documentatie
versie 3.3
16 maart 2008
Copyright © 2003-2008 J.A.Diebrink te Burdaard. Alle rechten voorbehouden.
In deze handleiding worden enkele technische onderwerpen bij het programma Haza-21 besproken.
Zie Handleiding - uitvoer
voor de beschrijvingen van de uitvoermogelijkheden.
Zie Handleiding - functioneel
voor de beschrijvingen wat het programma allemaal kan.
Zie Handleiding - kookboek
voor de beschrijvingen hoe iets te doen.
Zie Handleiding - kaart tekenen
voor de beschrijvingen hoe kaarten te tekenen.
Zie Handleiding - technische documentatie
voor de installatie van de software en de netwerkfuncties.
Zie Flexpoint basisfuncties
voor de beschrijving van de algemene functies van de Flexpoint database.
Zie Flexpoint rapportdefinities
voor de beschrijving van de algemene functies om met Flexpoint eigen rapporten te maken.
Gebruik binnen het programma altijd het contextmenu, dat altijd en overal alle actueel beschikbare functies toont.
Een contextmenu roept u op via de rechter muisknop of via de menu-toets op uw toetsenbord.
Deze handleiding wordt geleverd in de vorm van een PDF-document en is ontworpen om op het beeldscherm te bekijken. Daarom worden vrij grote letters gebruikt. Als u deze handleiding (of een deel daarvan) wilt printen, kunt u heel goed de pagina’s naar A5-formaat verkleinen. Bij de meeste printers heeft u daartoe de mogelijkheid via Eigenschappen om meerdere pagina’s op 1 A4 af te drukken. Als u daar voor 2 pagina’s kiest, krijgt u een nog goed leesbare tekst.
Inhoudsopgave
Vereiste Windows database componenten
De mogelijkheden van Adobe Reader
Automatische update (‘live update’)
Kopiëren of verplaatsen van Haza-21
Werken met meerdere PC’s - live update
toegang via Universal Data Link
Internet Backup (proef-)abonnement bestellen
Foute soorten vermelding corrigeren
Eigen soorten vermeldingen opruimen
Dubbele soorten vermelding samenvoegen
De enige functie van het installeren (vanaf CD of vanaf Internet) is het plaatsen van de software in de map c:\haza21v3 - en verder dus helemaal niets.
Download het live update programma
Als geregistreerde gebruiker van de Internetversie heeft u recht om gebruik te maken van het 'live update' programma Haza21. Dit programma dient u zelf eenmalig te downloaden en te installeren. De zelf-uitpakkende zip file 'liveupdate.exe' bevat het programma Haza21.exe en UnzDll.dll die beiden in de map c:\Haza21v3 moeten komen te staan.
• Afhankelijk van de door u gebruikte Internet browser kunt u dit programma direct uitvoeren, of moet u het eerst opslaan en dan openen.
• Klik op de knop Setup om het installatieprogramma Installpoint te starten. Vervolgens moet u nu de map kiezen waarin u Haza-21 wilt installeren. Doe dat bij voorkeur in de map c:\haza21v3.
• Selecteer de disk waarop u Haza-21 wilt plaatsen, dus bij voorkeur C.
• Klik op het + teken om de mappen op de gekozen disk te tonen.
• Als de map haza21v3 nog niet bestaat, klik dan op het knopje 'Nieuwe map'. Laat daar bij voorkeur de naam haza21v3 staan en klik op OK.
• Laat het vinkje staan om een snelkoppeling te laten maken.
• Klik op de knop 'Installeer'.
Installeer uw licentiesleutel
Uw licentiesleutel wordt u per e-mail gestuurd. In de bijlage van dat bericht vindt u een zip-file met daarin uw sleutel 'Flexpoint.BIN'. Kopieer deze zip-file uit de bijlage naar de map c:\haza21v3 waar u die zip-file naar keuze zelf mag uitpakken, of zo laten staan. Als u de zip-file niet zelf uitpakt, zal dat automatisch gebeuren door het 'live update' programma Haza21 (vanaf de versie van 23 mei 2003).
Vanaf het moment dat uw sleutel is uitgepakt, functioneert de eventueel eerder geïnstalleerde probeerversie als geregistreerde versie. Het zal openen met uw gegevens op het scherm.
Het automatisch uitpakken van de licentie-file gebeurt vanaf de versie van 23 mei 2003.
Voer de eerste keer live update uit
Start het live update programma via de snelkoppeling die op het bureaublad is geplaatst. Haza21.exe kijkt naar de geldigheidsdatum van uw sleutel. Daarom werkt het uitsluitend als het wordt gestart in de map 'c:\Haza21v3'. Als uw sleutel nog niet is uitgepakt uit de zip-file, zal dat nu automatisch gebeuren.
Het programma Haza21 haalt de eerste keer het volledige programma op. U krijgt dan de vraag of u ca. 16 MB nu wilt downloaden. Dat is heel Haza-21.
Nadat alles is gedownload, zal vervolgens automatisch Haza-21 worden gestart (het programma Flexpoint). U hoort dan een deurbel omdat het Haza-21 venster mogelijk achter andere vensters verborgen is. Haza-21 zal vervolgens iedere keer dat u het start eerst eventuele nieuwe versies van Internet ophalen en installeren en daarna Flexpoint starten. Dat kan een nieuwe versie van het programma zijn, maar ook nieuwe documentatie. Indien nodig zal het programma uw database automatisch converteren.
U ziet nu een grijs venster met bovenin Haza-21 met versienummer en -datum. Daaronder staan uw naam, adres en de aangeschafte versie.
U heeft hiervoor geen probeerversie gebruikt
Als eerste moet u in het venster "Database" de naam voor uw database kiezen. Standaard zal daar "Mijn database" staan (dat mag u uiteraard wijzigen). Klik op OK.
Hierna verschijnt er nog een venster "Database pad", waar u een map kunt invullen waar de database moet komen, standaard is dat de map waarin alle onderdelen van Haza-21 staan.
- Dubbelklik op de regel met de map of druk op Enter om die map te bevestigen.
- Druk op de Insert-toets om desgewenst een eigen map te kiezen.
Vervolgens wordt de database opgebouwd, dat duurt even, waarna een venstertje in beeld komt met de datum van uitgifte en de geldigheid van het onderhoudscontract. Zodra de database geopend is, zal de achtergrond met een oud schrift worden getoond, als u nu op OK klikt, zal dat venstertje verdwijnen en kunt u beginnen.
U heeft hiervoor wel een probeerversie gebruikt
Haza-21 zal automatisch uw database DEMONSTRATIE.MDB openen omdat dit nog de enige database is.
Als u een nieuwe database wilt gaan gebruiken, kiest u in de menubalk het Bestanden-menu en dan Andere database.
Haza-21 zal dan opnieuw starten en het Database venster tonen, met de Insert-toets kan een nieuwe database worden toegevoegd.
Als eerste moet u in het venster "Database" de naam voor uw database kiezen. Standaard zal daar "Mijn database" staan (dat mag u uiteraard wijzigen). Klik op OK.
Hierna verschijnt er nog een venster "Database pad", waar u een map kunt invullen waar de database moet komen, standaard is dat de map waarin alle onderdelen van Haza-21 staan.
- Dubbelklik op de regel met de map of druk op Enter om die map te bevestigen.
- Druk op de Insert-toets om desgewenst een eigen map te kiezen.
Vervolgens wordt de nieuwe database opgebouwd, dat duurt even, waarna een venstertje in beeld komt met de datum van uitgifte en de geldigheid van het onderhoudscontract.
Zodra de database geopend is, zal de achtergrond met een oud schrift worden getoond, als u nu op OK klikt, zal dat venstertje verdwijnen en kunt u beginnen.
Als u geen Windows Vista gebruikt, zal het programma controleren of op uw PC een juiste versie van MDAC aanwezig is; zo niet, dan krijgt u daar een melding over. Zie het hoofdstuk “Vereiste Windows database componenten” verderop in deze handleiding.
Zie het document LeesMij.txt dat op de installatie CD staat.
Herinstallatie van de software is altijd mogelijk. Kopieer daartoe eerst uw database(s) - de files met de extensie .MDB - en uw licentiesleutel Flexpoint.bin naar een andere map.
- Maak de map c:\haza21v3 leeg
- Kopieer de database(s) en de licentiesleutel terug.
- Voer de installatieprocedure uit, zoals hierboven beschreven.
Haza-21 is zo ontworpen, dat alle benodigde software in één map wordt geïnstalleerd. Standaard is dat de map c:\haza21v3 - maar u bent geheel vrij om de map een andere naam te geven en op een andere plaats te zetten.
Haza-21 bestaat uit 2 programma’s: het live update programma Haza21.exe en het eigenlijke programma Flexpoint.exe. Het programma Flexpoint kan naar keuze rechtstreeks worden gestart, of indirect via het live update programma Haza21. Als u geen permanente verbinding met Internet heeft, kunt u dan standaard zonder live update starten en incidenteel via live update. Om Haza-21 eenvoudig te kunnen starten, kunt u voor de beide programma’s zelf snelkoppelingen op het bureaublad zetten of aan het menu Start vastmaken.
Gebruikers van de CD-versie en van de probeerversie kunnen het live update programma niet gebruiken. Zij moeten dus altijd het programma Flexpoint starten.
Applicatie-definitiebestand DATABASE
Het programma Flexpoint is een algemeen databaseprogramma, dat niet kan functioneren zonder het applicatie-definitiebestand DATABASE. Dit bestand is een verborgen systeembestand, dat gewoonlijk niet getoond wordt als u de map c:\haza21v3 opent. De versie van deze DATABASE vindt u terug als de Haza-21 versiedatum (zie hieronder).
Versienummers
Op de standaard achtergrond vindt u o.a. de volgende informatie:
Deze bestaat uit 3 delen:
- Flexpoint versie (bijvoorbeeld 3.2.0.1673)
- Haza-21 database-versiedatum (bijvoorbeeld 20050729)
- MDAC versie (bijvoorbeeld 2.71)
In het openingsvenster wordt bovendien nog de versiedatum getoond (bijvoorbeeld 28 september 2006). Dit is de feitelijke datum van publicatie. Hert is mogelijk dat een versie wordt uitgegeven, waarbij uitsluitend deze datum geactualiseerd is en de bovengenoemde 3 versies niet.
Wel of geen database-conversie nodig
Bij een nieuwe versie is alleen een database-conversie nodig als de structuur van de database is gewijzigd. Daartoe wordt Haza-21 database-versiedatum vergeleken met de database-versiedatum in de geopende database.
Om Flexpoint te kunnen gebruiken, moet dit bestand aanwezig zijn. Dit is uw licentiesleutel waarin o.a. uw naam en adres staan.
Dit is de afbeelding op de standaard achtergrond.
Hierin worden uw instellingen bewaard. Dit bestand wordt automatisch gegenereerd als het er niet is.
Het geluidsbestand dat bij het starten van flexpoint wordt afgespeeld. Dit bestand mag worden verwijderd of vervangen door een geluid naar keuze.
Om Flexpoint te kunnen gebruiken, moet deze dll aanwezig zijn.
Om het live update programma Haza21 te kunnen gebruiken, moet deze dll aanwezig zijn.
Om de Internet Backup Dienst te kunnen gebruiken, moet deze dll aanwezig zijn.
In deze bestanden worden uw wijzigingen ten opzichte van de standaard versie van het programma opgeslagen. Na installatie van een nieuwe versie zullen deze wijzigingen automatisch worden aangebracht over de geïnstalleerde nieuwe versie.
Dit is een automatisch onderhouden database waarin van iedere database de daarin voorkomende familienamen en het aantal voorkomens daarvan worden opgeslagen.
Het log-bestand waarin het programma Flexpoint allerlei meldingen schrijft. Deze informatie kan voor medewerkers van Pointware Automatisering nodig zijn in geval van problemen.
Alle in deze map aanwezige PDF-documenten zullen onder Help worden getoond. U kunt hier dus ook eigen PDF-documenten aan toevoegen, die dan automatisch onder Help zijn te vinden.
Vereiste Windows database componenten
Flexpoint maakt gebruik van standaard Windows database componenten om de MS Jet database te benaderen.
Dat heet MDAC, wat staat voor Microsoft Data Access Components. Deze software wordt ook steeds verbeterd en er komen regelmatig nieuwe versies beschikbaar. Voor Haza-21 is minimaal versie 2.7 vereist. Haza-21 zal dat zelf controleren. Als er een juiste versie is gevonden, kunt u het versienummer zien op het hoofdscherm van Haza-21.
Als u geen Windows XP gebruikt, zal het meestal nodig zijn om een recente versie van MDAC te installeren. Als er geen juiste versie is gevonden, zal het programma dat melden en dient een nieuwe versie te worden gedownload van de Microsoft website. De benodigde informatie vindt u op de FAQ-pagina op onze website (www.hazadata.com) onder Foutmeldingen. Voor de gebruikers van de CD-versie van Haza-21 staat de benodigde MDAC update ook op de CD.
Als Flexpoint geen melding geeft over een verouderde MDAC-versie, maar toch direct na het opstarten stuklooopt, dan is de kans groot dat dit komt door problemen met MDAC. In dergelijke gevallen is het raadzaam om de nieuwste versie van MDAC te installeren.
Als wel een juiste MDAC aanwezig is, maar Flexpoint in de log.txt de melding “Database connection failed on MDAC version ” geeft, dan heeft u waarschijnlijk als Windows-gebruiker geen toegang tot MDAC. De oplossing is dan om de commandline parameter /NOMDAC toe te voegen in de snelkoppeling naar Flexpoint en/of in de file hz21.ini (zie hieronder bij Live Update). Daardoor zal dan de check op MDAC-versie worden overgeslagen.
Windows Vista
Vanaf versie 3.3.0.209 van 21 december 2006 wordt de controle op de MDAC-versie niet meer uitgevoerd onder Windows Vista.
Oudere versies zullen onder Windows Vista namelijk ten onrechte melden dat minimaal versie 2.70 vereist is of de toegang weigeren als Haza-21 vanuit een gebruikers-account wordt gestart. De oplossing is dan om de commandline parameter /NOMDAC toe te voegen in de snelkoppeling naar Flexpoint en/of in de file hz21.ini (zie hieronder bij Live Update).
Ondanks de installatie van MDAC 2.7 of hoger kan het soms gebeuren dat Haza-21 na de start stukloopt, vaak met de melding "Klasse niet geregistreerd". Dat zal dan meestal het gevolg zijn van een te oude versie of incomplete van MS Jet en dient een nieuwe versie te worden gedownload van de Microsoft website. De benodigde informatie vindt u op de FAQ- pagina op onze website (www.hazadata.com) onder Foutmeldingen. Voor de gebruikers van de CD-versie van Haza-21 staat de MS Jet update ook op de CD.
De handleidingen vindt u onder Help in de menubalk. Dit zijn PDF-documenten, die gelezen kunnen worden met Adobe Reader of Acrobat Reader. Op de meeste PC’s zal dit programma wel aanwezig zijn. Zo niet, dan kunt u de actuele versie downloaden bij www.adobe.nl (dit programma is gratis).
De mogelijkheden van Adobe Reader
Adobe Reader biedt de mogelijkheid om op ieder gewenst woord te zoeken; daarom zult u in de handleidingen geen index of trefwoordenregister aantreffen. Het is ook mogelijk om met één zoekopdracht alle PDF-documenten te doorzoeken.
Bij gebruik van Adobe Reader vanaf versie 6 kan de foutmelding komen dat na de laatste zoekopdracht het bestand is gewijzigd en is zoeken niet meer mogelijk. Dat gebeurt nadat u een nieuwe versie van een document heeft geïnstalleerd.
Dit is als volgt op te lossen:
1. Menubalk: Bewerken
2. Optie: Voorkeuren
3. Categorie: Search
4. In het dan geopende optieveld 'snelzoeken inschakelen' uitschakelen en daarna de cache-inhoud wissen.
Automatische update (‘live update’)
Bij de Internet-versie van Haza-21 is het mogelijk om nieuwe versies van de software en van de documentatie automatisch te laten downloaden en installeren. (Dit is dus niet mogelijk met een licentie voor de CD-versie.) Als de structuur van de database is veranderd, zal een database automatisch worden gereorganiseerd bij de eerste keer openen met de nieuwe versie van het programma.
Het live update programma dient u zelf eenmalig te downloaden van de website www.hazadata.com. U krijgt dan een zelf-uitpakkend programma liveupdate.exe en als u dat programma start, dan worden de programma’s haza21.exe en UnzDll.dll standaard uitgepakt naar de map c:\haza21v3.
Het automatisch downloaden en het installeren van nieuwe programmaversies en nieuwe documentatie gebeurt door het ‘live update’ programma haza21.exe in combinatie met UnzDll.dll voor het uitpakken van zip-files. Daarbij worden de onderstaande files worden gebruikt.
Nadat de nieuwe files van Internet zijn opgehaald en eventueel uitgepakt zal het programma Flexpoint.exe worden gestart.
Deze wordt automatisch gemaakt door haza21.exe als deze nog niet bestaat. Hierin staan de volgende parameters:
Het te starten applicatieprogramma na het downloaden.
Eventuele commandline parameters voor het applicatieprogramma.
De map waarin het applicatieprogramma staat.
De datum waarop de laatste keer op Internet is gezocht naar eventuele updates.
Hierin staat informatie over de laatste sessie (en wordt dus iedere sessie overschreven). Deze informatie kan voor medewerkers van Pointware Automatisering nodig zijn in geval van problemen.
Deze wordt bij iedere sessie van Internet opgehaald en bevat een overzicht van de actueel beschikbare files.
Hierin staat de historie van de opgehaalde files.
Bij eventuele problemen mogen de bovenstaande vier files allemaal worden verwijderd, waarna alle beschikbare actuele files van Internet zullen worden opgehaald.
Het ‘live update’ programma Haza-21 werkt alleen bij een geldig onderhoudscontract, dus ook niet bij de probeerversie.
De geïnstalleerde versie van het programma Flexpoint blijft voor een onbeperkte duur gewoon werken met een verlopen onderhoudscontract, maar nieuwere versies zullen als een probeerversie gaan functioneren.
Een onderhoudscontract kan rechtstreeks vanuit Haza-21 worden besteld. Dat gaat via Onderhoud in de menubalk.
Een onderhoudscontract geeft recht op alle nieuwe versies gedurende één jaar. Het kan op ieder gewenst moment ingaan. Het hoeft dus niet aansluitend te zijn aan een voorgaande onderhoudsperiode.
Haza-21 kan sinds 23 mei 2003 ook automatisch uw licentie zip-file uitpakken. Dus kunt u bij een verlenging van uw onderhoudscontract volstaan met het plaatsen van de u per e-mail gezonden licentie zip-file in de map c:\haza21v3 (of welke andere map u voor Haza-21 gebruikt).
Haza-21 kan ook zonder automatische update worden gestart. Daartoe start u zelf het programma Flexpoint.exe (via een snelkoppeling of het Start menu).
Kopiëren of verplaatsen van Haza-21
Omdat alle software in één map staat, is het kopiëren of verplaatsen van Haza-21 heel eenvoudig: u hoeft slechts die ene map te kopiëren of te verplaatsen. Daarbij moet u wel even op het volgende letten:
Omdat het applicatie-definitiebestand DATABASE meestal niet getoond zal worden (afhankelijk van uw Map opties), wordt die niet mee gekopieerd als u alle bestanden in de map selecteert. Dit probleem is heel eenvoudig te voorkomen door niet de files, maar de gehele map te kopiëren.
Deze wordt automatisch gemaakt door het live update programma haza21.exe als deze nog niet bestaat. Hierin staat o.a. de parameter WORKDIR met de naam van de map waarin het programma Flexpoint staat. Dit dient u aan te passen. Nog eenvoudiger is het verwijderen van het bestand hz21.ini (waarna die automatisch zal worden gemaakt met de juiste waarden).
Als u uw database(s) ook heeft verplaatst, dan moet u zelf wel de parameter Database_Pad aanpassen.
Werken met meerdere PC’s - live update
Als u Haza-21 op een andere PC gebruikt dan die waarop u via het live update programma uitvoert om nieuwe versies van Internet op te halen, moet u rekening houden met het volgende.
Iedere keer wanneer u Haza-21 afsluit, worden uw eigen instellingen, verstekwaarden, lay-outs en rapporten automatisch opgeslagen in Configuration.SDF en Configuration.BLB en na een live update worden die instellingen automatisch in de nieuwe versie aangebracht de eerste keer dat het programma Flexpoint start (dit gebeurt dus standaard nadat een live update is uitgevoerd).
U kunt voorkomen dat Flexpoint wordt gestart door in de file hz21.ini de parameters APPLICATION en WORKDIR leeg te maken. Daarna kunt u de nieuwe files naar de PC kopiëren waar u met Haza-21 werkt.
In de huidige versie 3.3 is het mogelijk om binnen een lokaal netwerk vanaf meerdere werkstations gelijktijdig in eenzelfde database te werken. Hierbij zijn er voorlopig nog geen beperkingen aan het aantal werkstations.
In een volgende versie zal de functionaliteit worden uitgebreid met o.a. functies voor beheer en beperkte toegang via Internet.