FRACLADOC MAINTENANCE (C) HANDLEIDING
AUTEUR(S) DOCUMENTNUMMER VERSIE BRON STATUS DOCUMENTDATUM AANTAL PAGINA'S
: : : : : : :
Kris Bekkers 1.0.0 Kris Bekkers 12 juni 2006 75
© Copyright 2006, Kris Bekkers Alle rechten zijn gereserveerd. Reproductie, geheel of gedeeltelijk, zonder schriftelijke toestemming van de eigenaar is verboden. Indien u vragen of opmerkingen heeft over dit document, gelieve contact op te nemen met Kris Bekkers
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Inhoud 1
Inleiding................................................................................................................................ 6
2
Historiek ............................................................................................................................... 7
3
Systeem vereisten ................................................................................................................ 8
4
Algemene opmerkingen ........................................................................................................ 9 4.1 4.2 4.3 4.4
5
De notie Logische verwijdering .......................................................................................................... 9 Fout afhandeling ................................................................................................................................ 9 Wijzigingen aan gegevens (records) ................................................................................................. 10 Wizards............................................................................................................................................ 10
Installatie ............................................................................................................................ 12 5.1 Installatie van Mysql Database ......................................................................................................... 12 5.2 Installatie van de applicatie(s) .......................................................................................................... 19 5.2.1 Installatie van FraClaDoc Maintenance™......................................................................................... 19 5.2.2 Installatie van de database............................................................................................................... 23
6
De applicatie opstarten ....................................................................................................... 24 6.1 6.2
7
Start menu of snelkoppeling op het bureau-blad. ............................................................................. 24 Opstarten - inlogscherm .................................................................................................................. 24
Het hoofdscherm van FraCladoc maintenance..................................................................... 26 7.1 De delen van het hoofdscherm......................................................................................................... 26 7.2 Toegang tot de verschillende beheersfuncties.................................................................................. 27 7.3 Instellingen van FraClaDoc Maintenance .......................................................................................... 28 7.3.1 Algemene settings ........................................................................................................................... 28 7.3.2 Database instellingen....................................................................................................................... 29 7.3.3 Instellingen voor Foutafhandeling..................................................................................................... 30 7.3.4 Uitzicht van het programma............................................................................................................. 32
8
Applicaties beheren: Algemeen ........................................................................................... 33 8.1 Algemene informatie........................................................................................................................ 33 8.2 Applicatie parameters ...................................................................................................................... 34 8.2.1 Parameters wijzigen ........................................................................................................................ 34 8.2.2 Nieuwe parameter aanmaken. ......................................................................................................... 34
9
Applicaties beheren: Historiek (logging)............................................................................... 36
10
Applicaties beheren: Database backup & Restore................................................................ 38
10.1 Inleidende noties.............................................................................................................................. 38 10.1.1 “Smart” versus “script”.............................................................................................................. 38 10.1.2 Conflict afhandeling bij Smart Restore ........................................................................................ 38 10.2 Applicatie database beheren – Algemeen......................................................................................... 40 10.3 Database gebruikers beheren .......................................................................................................... 41
12 juni 2006
3 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
10.3.1 Beheren van gebruikers.............................................................................................................. 41 10.3.2 Rechten in Mysql databases. ...................................................................................................... 43 10.3.3 Rechten verreist voor FraCladoc applicaties................................................................................ 43 10.4 Een database backup nemen ........................................................................................................... 45 10.4.1 Het backup scherm. ................................................................................................................... 45 10.4.2 Het nemen van een backup ........................................................................................................ 46 10.5 Een database backup herstellen....................................................................................................... 47 10.5.1 Het herstel-scherm..................................................................................................................... 47 10.5.2 Het terugplaatsen van een backup: scripting .............................................................................. 48 10.5.3 Het terugplaatsen van een backup: Smart restore....................................................................... 48 10.5.4 Applicaties beheren: Profielen en gebruikers (Security)............................................................... 50 10.6 Profielen .......................................................................................................................................... 50 10.6.1 Profielen beheren ....................................................................................................................... 50 10.6.2 Nieuw profiel maken................................................................................................................... 52 10.6.3 Gebruikers toekennen aan een profiel......................................................................................... 53 10.7 Gebruikers ....................................................................................................................................... 54 10.7.1 Gebruikers beheren .................................................................................................................... 54 10.7.2 Nieuwe gebruiker maken............................................................................................................ 55 10.7.3 Profielen toekennen aan een gebruiker....................................................................................... 56
11
Applicaties beheren: Schermen........................................................................................... 57
11.1 Verzamelscherm “schermen”. ......................................................................................................... 58 11.2 Initiële installatie – schermen ophalen. ............................................................................................ 59 11.3 Schermen vertalen........................................................................................................................... 60 11.3.1 Taal keuze.................................................................................................................................. 60 11.3.2 Vertalen van het scherm............................................................................................................. 61 11.3.3 Vertalen van menu’s................................................................................................................... 61 11.4 Schermen beveiligen volgens profiel. ............................................................................................... 62 11.4.1 Keuzen van het profiel. ............................................................................................................... 62 11.4.2 Beveiliging van het scherm......................................................................................................... 63 11.4.3 Beveiliging van menu’s:.............................................................................................................. 63
12
Applicaties beheren: Talen .................................................................................................. 64
13
Applicaties beheren: Boodschappen (Messages) ................................................................. 65
13.1 Boodschappen ophalen en bewerken ............................................................................................... 66 13.2 Boodschappen in een nieuwe taal vertalen....................................................................................... 66
14
Database model:................................................................................................................. 67
15
Voorbeelden:....................................................................................................................... 68
15.1 Voorbeeld van script uitvoer ............................................................................................................. 68 15.2 Voorbeeld van smart uitvoer............................................................................................................. 71
12 juni 2006
4 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Lijst wijzigingen VERSIE
DATUM
OMSCHRIJVING
AUTEUR
1.0.0 1.1.0
2006-06-12 2006-12-04
Initiële versie Aanpassingen n.a.v. versie 7.1
KBE KBE
12 juni 2006
5 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
1
Inleiding De eerste versie van FraCladoc – wat staat voor Franciscus & Clara Documentatie – bestaat sedert 1998. Sindsdien is er van alles geëvolueerd. Niet alleen de taal waarin het geschreven is, van Access over Visual Basic naar .NET (c#), maar ook de gebruiksvriendelijkheid en de inhoud van het programma. De huidige versie van FraCladoc bevat naast de grondtekst van de (meeste) franciscaanse bronnen ook een vertaling in de meest gangbare Europese Talen (waaronder Nederlands, Frans, Engels, Italiaans en Spaans). Ook van de bijbel zijn verschillende transcripties opgenomen: de Wilibrord vertaling, een Vulgaat vertaling en de Bible de Jérusalem als één van de toonaangevende Franse vertalingen. Nieuw in de huidige versie is de opsplitsing van de applicatie in twee delen. Een eerste deel is het gedeelte dat gericht is op de Bronnen zelf. Het tweede gedeelte – waarvan je de handleiding nu voor je hebt – is dat deel dat gericht is op installatie en onderhoud van de applicatie. Dit was nodig omdat er meer en meer vraag kwam naar een eenvoudige netwerk installatie en de bijhorende mogelijkheid om de applicatie van “op afstand” te beheren.
12 juni 2006
6 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
2
Historiek Hieronder krijg je een overzicht van de wijzigingen. --------------------------------------------------------------------------------Date Versie Action --------------------------------------------------------------------------------2006-11-03 7.1.0.0 Bugfix waarbij het herstellen van een database-script case-sensitive is voor de command-terminators. Dit zorgde ervoor dat sql-commands die eindigden op "GO" of "go" anders geïnterpreteerd werden. 2006-11-03 7.1.0.0 Om te bepalen welk programma het maintenance programma is, worden de naam van de applicatie-executable zoals die gevonden wordt in de database (tabel app_applications) vergeleken met de naam van de executable van het maintenance programma. Deze vergelijking gebeurde case-sensitive zodat er geen maintenance programma gevonden werd als de naam verschilde. Dit zorgde ervoor dat de database niet meer hersteld of ge-backed-up kon 2006-12-04 7.1.0.0 Om de nieuwe schermen te backuppen zonder dat dit de bestaande in de database overschreef is er in het scherm om een back-up te maken een knop bijgeplaatst die u toelaat om een aantal criteria in te stellen
Wijzigingen aan de database: Date DB 2006-10-22 FraCladoc
Function Name Admin_GetParameter
Modification Added function to retrieve the parameter from the parameter table
12 juni 2006
7 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
3
Systeem vereisten De huidige applicatie van FraCladoc™ is geschreven in .NET Als dusdanig kunnen wij verwijzen naar wat Microsoft zelf erover zegt en kunnen wij ons daarmee tevreden stellen. Dit wil zeggen, alle pc’s waarop .NET geïnstalleerd kan worden voldoen voor de applicatie. Bemerk wel dat, hoe sterker de computer, hoe vlotter de applicatie zal werken. Verder heb je – afhankelijk van jouw keuze – een database nodig. Deze kan lokaal geïnstalleerd worden of op een pc (server) die daarvoor speciaal toe uitgerust is. Dit laatste is handig als je de applicatie wilt gebruiken in een bibliotheek, een kloostergemeenschap of een andere locatie waarbij verschillende gebruikers toegang moeten hebben tot dezelfde gegevens. Wij geven de voorkeur aan MySql (www.mysql.com) om verschillende redenen1. Vooreerst is de kost hierbij van belang. In tegenstelling tot andere databases kan MySql vrij gedownload worden. Verder heeft MySql – vanaf versie 5.0 – alle toeters en bellen die andere databases ook hebben.
1
Hoewel wij de voorkeur geven aan Mysql is FraCladoc zo ontwikkeld dat het met meerdere databases kan gebruikt worden. (sql server, Oracle etc). Hierbij is het wel van belang te vermelden dat de feitelijke conversie een taak is die nog uitgevoerd dient te worden.
12 juni 2006
8 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
4 4.1
Algemene opmerkingen De notie Logische verwijdering In sommige gevallen dien je gegevens te verwijderen. De applicatie zal hiertoe de mogelijkheid geven. Daar waar mogelijk is werd de notie van “logische verwijdering” geintroduceerd, dit in tegenstelling tot ‘fysische verwijdering’. Logische verwijdering: Dit wil zeggen dat de gegevens niet echt verwijderd worden uit de database. Er wordt in dit geval een “vlag” (flag) bijgehouden die op True (aan) gezet wordt om aan te duiden dat dit gegeven niet meer beschikbaar is. (Je kan bijvoorbeeld een profiel op deze manier verwijderen). Dit laat het tevens mogelijk om deze gegevens te herstellen en opnieuw beschikbaar te maken. Fysische verwijdering: Dit verwijderd de gegevens zodanig dat ze niet meer beschikbaar zijn.
4.2
Fout afhandeling In FraCladoc applicaties worden fouten altijd op dezelfde manier afgehandeld. (Wat er getoond moet worden kan je bij de kiezen bij de instellingen op applicatie niveau). Hoe het getoond wordt verdient enige verduidelijking. Een fout-boodschap bij FraCladoc applicaties ziet er altijd hetzelfde uit:
Veld Application Computer Code
Omschrijving Dit geeft de naam van de applicatie weer De naam van de computer van waarop je werkt. Dit geeft een fout-code. Het merendeel van deze codes zijn terug te vinden in de fout-boodschappen (messages). Volgende conventie wordt aangehouden. Als de code begint met “VALID” wil dat zeggen dat het om een valideringsfout gaat. Begint de code met “FRMWRK” wil dat zeggen dat het om een foutboodschap gaat die te maken heeft met het raamwerk van elke FraCladoc applicatie.
12 juni 2006
9 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
User Boodschap More Info
Close
4.3
Hiernaast kan elke applicatie nog zijn eigen codes ontwikkelen. De gebruiker die momenteel op het systeem is ingelogd. Bovenaan de boodschap vindt je telkens de datum en het uur waarop de fout is opgetreden. Hieronder staat een omschrijving van de fout. Als er meer informatie voorhanden is, wordt dat getoond als je op deze knop drukt. Meestal zal het gaan om “technische” informatie nodig om de fout te reproduceren Dit sluit het scherm.
Wijzigingen aan gegevens (records) Soms is het nuttig om te weten wanneer een record aangemaakt of gewijzigd is en door wie. Om dit te bekomen op een eenvoudige en eenduidige manier is er in de meeste tabellen op database niveau een aantal kolommen gecreëerd. Al deze kolommen worden automatisch opgevuld (tabel triggers) en de gebruiker moet zich hiervan niets aantrekken. Kolom Kolom CreUser
Omschrijving Dit is de gebruiker die het record heeft aangemaakt.
CreTime
Dit is het tijdstip waarop het record is aangemaakt. Dit is de gebruiker die het record het laatst heeft gewijzigd.
UpdUser
UpdTime
4.4
Dit is het tijdstip waarop het record het laatst is aangepast.
Actie Iedere keer als er een “insert” gedaan wordt op de tabel wordt deze waarde automatisch ingevuld met de gebruiker die momenteel is aangelogd in de applicatie of – als dit eerste niet achterhaalbaar is – de gebruiker die momenteel aangelogd is in de database. Iedere keer als er een “insert” gedaan wordt op de tabel. Iedere keer als er een wijziging (update) gedaan wordt op de tabel wordt deze waarde automatisch ingevuld met de gebruiker die momenteel is aangelogd in de applicatie of – als dit eerste niet achterhaalbaar is – de gebruiker die momenteel aangelogd is in de database. Iedere keer als er een wijziging gedaan wordt op de tabel.
Wizards Veel van de functionaliteiten binnen FraCladoc applicaties worden afgehandeld met behulp van zogenaamde “wizards”. In feite zijn dat een aantal stappen die je moet doorlopen om een bepaalde handeling tot een goed einde te brengen. (vb. Het toevoegen van een auteur, het vertalen van een scherm, etc.) Bij iedere stap hoort er een stukje validatie: de gegevens die ik heb ingegeven, zijn die correct of niet?
12 juni 2006
10 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Bovenaan iedere “wizard zal een korte omschrijving komen te staan:
Onderaan de wizard zullen steeds volgende knoppen ter beschikking staan:
“Volgende” gaat naar de volgende stap. “Vorige” gaat naar de vorige (indien toegestaan) “Annuleren” annuleert de wizard “Einde” enkel beschikbaar als je op het einde van de wizard komt.
12 juni 2006
11 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
5
Installatie De installatie dient in verschillende etappes te gebeuren. Vooreerst dient de database geïnstalleerd te worden. Vervolgens kunnen we de applicatie zelf installeren.
5.1
Installatie van Mysql Database Op de cd is versie 5.1 meegeleverd van Mysql. Heb je echter een (bedrijfs) netwerk dat met een recentere versie werkt is dat geen probleem en kan je deze stap overslaan. De installatie van de gegevens wordt verder uitgelegd onder punt Installatie van de applicatie(s) Zoek op de cd-rom naar de directory genaamd MySQL. Deze directory bevat maar een bestand Mysql_Setup.exe. Open dit gezipte bestand door er op te dubbelklikken. Na enkele seconden verschijnt dan het volgende scherm en kan het voorwerk voor de installatie van MySQL beginnen:
Kies in dit scherm voor Next. Het volgende scherm verschijnt:
12 juni 2006
12 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
In dit scherm wordt gevraagd wat er precies geïnstalleerd moet worden. We gaan er van uit dat u kiest voor de optie Complete. Klik deze optie dus aan. Vervolgens wordt gevraagd of u klaar bent voor de installatie. Zo ja, kies dan voor Next en het volgende scherm verschijnt:
Als u klaar bent voor de installatie, kies dan voor Install. De installatie begint dan:
12 juni 2006
13 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Na enkele seconden wordt de volgende vraag gesteld:
Kies voor Skip Sign-Up – tenzij u zich wilt registreren bij Mysql als gebruiker - en ga naar Next. De sign-up kan later uitgevoerd worden. De volgende boodschap verschijnt :
12 juni 2006
14 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Zorg dat het vinkje aan staat bij Configure the MySQL Server now en kies voor Finish:
Kies wederom voor Next en dit scherm verschijnt:
12 juni 2006
15 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Kies voor de optie Standard Configuration en daarna voor Next. In een later stadium, als u meer ervaring hebt met en kennis over MySQL, kunt u alsnog MySQL overnieuw installeren en voor de Detailed Configuration kiezen. Het volgende scherm verschijnt:
Kies in het bovenstaande scherm voor de optie Install As Windows Service en ga daarna naar Next. Het onderstaande scherm wordt getoond:
12 juni 2006
16 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
In het bovenstaande scherm moet het password (wachtwoord) van de door MySQL aangemaakte gebruiker ingevuld worden. De naam van deze gebruiker is root. Uiteraard mag u zelf een password bedenken maar wil er alstublieft voor zorgen dat u een password kiest dat enerzijds moeilijk te raden is en dat je anderzijds niet vergeet! Tik dit password tweemaal in. Uiteraard wordt tweemaal dit password als sterretjes getoond. Ga daarna naar Next. Dit scherm verschijnt nu:
Als u klaar bent om de configuratie van MySQL af te ronden, drukt u op Execute. De configuratie zal met vinkjes de status tonen. Dit proces hoort slechts enkele seconden te duren:
12 juni 2006
17 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Indien alles klaar is, wordt het volgende scherm getoond:
Als u nu op Finish drukt, bent u klaar en is de MySQL-databaseserver geïnstalleerd. Om te controleren of alles werkt, kunt u in het Configuratiescherm (Control Panel) kiezen voor Systeembeheer (Administrative Tools) en vervolgens op Services. Het volgende scherm verschijnt dan:
12 juni 2006
18 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Als MySQL in het bovenstaande rijtje als een service verschijnt (zie de achtste rij), dan draait de MySQL-databaseserver.
5.2
Installatie van de applicatie(s) Installatie van het onderhoud programma dient in een aantal stappen te gebeuren. Nieuw in de huidige versie is dat we onderscheid maken in de eigenlijke applicaties (Zoals FraCladoc om de bronnen te bestuderen) en het onderhoudsprogramma. Dit heeft ook gevolgen wat de database betreft, deze is nu opgesplitst om zoveel mogelijk uitbreidbaar te zijn. De set-up weerspiegelt dit. Zorg er voor de installatie voor dat je de nodige rechten hebt op database niveau om objecten aan te maken en te verwijderen. Bij een eerste (initiële installatie) is dit immers nodig. Typisch laat je dit – voor een “bedrijfs” netwerk – uitvoeren door de database administrator. Beschik je niet over een bedrijfsnetwerk opteer je er best voor om Mysql als gegevensdrager (database) te gebruiken. Bij de installatie van het onderhouds programma kan je dan als database gebruiker “root” name. (Zie hiervoor de sectie Installatie van Mysql Database).
5.2.1
Installatie van FraClaDoc Maintenance™ De software instaleren gebeurd door middel van een eenvoudige wizard. Deze vindt je op de cd of kan je downloaden via onze support website. Steek de cd in de cd-lezer. Normaal start het setup programma automatisch. Indien dit niet gebeurd, zoek dan naar het bestand “FCDOC_AppMaintenance_setup.exe” en klik er tweemaal op met de muis. Het introductie scherm wordt getoond.
Druk op “Volgende” om de installatie te starten.
12 juni 2006
19 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Op deze pagina vindt je informatie waar de mosterd vandaan komt. Verdere ondersteuning kan je dan vinden op onze website http://FraCladoc.Dyndns.org.2 Vink de checkbox aan en druk op “volgende” om verder te gaan. Je komt in het scherm waar je kunt kiezen wat je wilt installeren.
Het eerste item in de lijst is standaard aangevinkt en kan je niet de-selecteren. Dit is immers nodig om de software te kunnen draaien. 2
Bemerk dat deze website niet continue on-line is en momenteel nog in experimentele fase is.
12 juni 2006
20 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Verder heb je nog volgende mogelijkheden: Database Installatie: Als je dit aanvinkt wordt er voordat de setup afgesloten wordt een kleine applicatie gestart die de database gaat installeren. Hiervoor moet je wel een draaiende database hebben en de nodige rechten om een database aan te maken. Bemerk dat je dit niet iedere keer moet doen. Enkel als je FraCladoc Maintenance™ voor de eerste keer installeert dien je deze stap uit te voeren. De bestanden hiertoe worden in de {database} subfolder geplaatst. Documentatie: Dit zal twee documenten installeren op je harde schijf. Enerzijds de “technische documentatie”. Dit bevat een omschrijving van alle classes, interfaces en objecten van de applicatie. (gedocumenteerd via Ndoc, een tool die dit mogelijk maakt). Voor de geïnteresseerde “leek” kan dit een aanknopingspunt zijn om de applicatie uit te breiden met nieuwe mogelijkheden. Een tweede document dat geïnstalleerd wordt is het document dat je nu aan het lezen bent. Dit bevat de manier waarop je de software dient te installeren en te gebruiken. De bestanden hiertoe worden in de {Documentation} subfolder geplaatst. Desktop Desktop shortcut: Dit maakt een snelkoppeling aan op je bureau-blad zodat je niet lang hoeft te zoeken. De snelkoppeling naar het programma wordt automatisch gemaakt en hoef je niet afzonderlijk te selecteren. Nadat je de gewenste opties hebt aangevinkt druk je op “volgende” om verder te gaan met de installatie. Volgend scherm verschijnt:
Hier kan je kiezen waar het programma wordt geplaatst op harde schijf. Druk op volgende om te accepteren.
12 juni 2006
21 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Als je gekozen hebt om de database mee te installeren zal er op het einde van deze stap een hulp-programaatje opgestart worden die dat voor u in orde brengt. Zie verder onder Installatie van de database. Druk hier op afsluiten.
Als je wenst kan je meteen de applicatie opstarten. Vink hiertoe de checkbox aan en druk op “voltooien”.
12 juni 2006
22 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
5.2.2
Installatie van de database. Als je bij de setup koos voor de installatie van de database kom je op een gegeven moment op volgend scherm terecht:
Hier heb je – bij een initiale installatie bij de setup- enkel de mogelijkheid om het voorgestelde bestand in te lezen (“inlezen”) en de database te “herstellen”. Eenmaal alles functioneert kan je opteren om de database volledig te herstellen of slechts partieel. Op dit moment dienen we de database helemaal te installeren. Voor Mysql heb je een gebruiker nodig met minimaal volgende rechten: Op database niveau (*.*): SELECT, INDEX, SUPER, EXECUTE, CREATE VIEW, SHOW VIEW, CREATE ROUTINE, ALTER ROUTINE Op de Mysql database: (Mysql.*): SELECT
Druk eerst op “Inlezen”. Nadat het bestand is ingelezen kan je op het tabblad “Script Restore” de uit te voeren commando’s vinden. Eventuele fouten tijdens het inlezen zullen u gemeld worden. Nadat het bestand is ingelezen kan je op “Herstellen” drukken en wordt de database aangemaakt. Je zal onder het tabblad “Progress Info” de voortgang kunnen monitoren. Voor meer uitleg verwijzen we verder naar de sectie dit dit scherm specifiek behandeld.
12 juni 2006
23 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
6 6.1
De applicatie opstarten Start menu of snelkoppeling op het bureau-blad. Als je bij de installatie gekozen hebt om een snelkoppeling te plaatsen op het bureau-blad kan je dit gebruiken. De andere manier is om het start-menu te gebruiken. Volgende items werden daartoe aangemaakt:
FraClaDoc Maintenance: Het eerste item (‘FraCladoc Maintenance’) doet hetzelfde als een eventuele snelkoppeling op je bureau-bla. Dit zal de applicatie opstarten. FraCladoc Maintenance Handleiding: Handleiding Dit opent de handleiding die je nu aan het lezen bent. Technische Documentatie: Dit opent een windows help bestand met technische documentatie. Alle code die geschreven is voor dit programma is gedocumenteerd. Deze documentatie is vrij beschikbaar voor gebruikers van FraClaDoc applicaties. Uninstall Dit desinstalleert het programma.
6.2
Opstarten - inlogscherm Als je de applicatie opstart krijg je volgend scherm te zien.
Veld Gebruiker
Omschrijving Dit is de gebruiker waarmee je inlogt in de applicatie. Als je FraClaDoc Maintenance voor de eerste maal opstart (en in de veronderstelling dat de database reeds geïnstalleerd is) kan je inloggen
12 juni 2006
24 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Profiel Wachtwoord
met de gebruiker ‘FraClaDocMaint’ zonder wachtwoord. Hiermee bepaal je je rechten die je zal hebben als je de applicatie opstart. Hier vul je het wachtwoord in voor de applicatie.
Als je alle gegevens ingevuld hebt druk je op ‘OK’. De applicatie zal checken of enerzijds deze gebruiker gekend is en het correcte wachtwoord is meegegeven en anderzijds of deze gebruiker de nodige rechten heeft. Dit wil zeggen of het profiel dat geselecteerd is gemachtigd is om de applicatie op te starten. Indien dat niet het geval is, volgt de volgende foutboodschap:
(zie Fout afhandeling voor meer uitleg over de verschillende topics op het scherm). Opmerking: Tijdens het opstarten van de applicatie worden er een aantal zaken nagekeken. Eén van de zaken is of we kunnen beschikken over een geldige connectie (verbinding) naar de database. Is dat niet het geval dan wordt er een scherm getoond waar je de instellingen kunt wijzigen. Dit scherm staat beschreven onder het puntje Database instellingen
12 juni 2006
25 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
7 7.1
Het hoofdscherm van FraCladoc maintenance De delen van het hoofdscherm Eenmaal de applicatie gestart is krijg je onderstaand scherm te zien.
Dit scherm valt uiteen in drie delen. Menu: Er zijn “slechts” twee menu items. “Bestand” en “Help”. In het eerste menu (“bestand”) kan je verder kiezen om de applicatie-opties in te stellen en de applicatie af te sluiten. Het tweede menu-item (“Help”) geeft u wat algemene informatie over het programma zelf.
Navigatie: In de lijst die u aantreft op de linkerkant van het scherm ziet u een “Treeview”. Deze bevat de applicaties die momenteel geïnstalleerd zijn. (In ons voorbeeld gaat het over “FraClaDoc” en “FraClaDocMaint”. Als één van de items grijs is heb je met je profiel waarmee je ingelogd bent geen toegang om deze applicatie te beheren.
12 juni 2006
26 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Werkblad: Het grijze gedeelte op het scherm is het zogenaamde “werkblad”. Hierop zullen de verschillende beheersschermen getoond worden. Verschillende schermen kunnen gelijktijdig open zijn.
Op het bovenstaande werkblad (tabbed interface) zijn 5 schermen actief. Om plaats te maken zijn er echter 4 van de 5 “verborgen”. Door op de naam van één van de schermen te klikken zal dit scherm opnieuw geactiveerd worden en het huidige (actief) scherm wordt dan verborgen.
7.2
Toegang tot de verschillende beheersfuncties De navigatie-lijst fungeert als toegang tot de verschillende beheersmodaliteiten van de applicatie. We willen ze kort toelichten: General: Dit geeft toegang tot algemene informatie over het programma zoals naam, omschrijving en applicatieparameters. Application Log: In de loop van het programma kan je op fouten botsen. Dit kunnen gewone fouten zijn, maar ook programmeerfouten. Bij de instellingen kan je kiezen welke fouten je wegschrijft naar de database. Deze optie laat u toe om de fouten die geregistreerd zijn in de database te bekijken. Database: Dit laat u toe van een reserve-copy (backup) te nemen van de database en/of een reservecopy terug te zetten. Tevens kan je hiermee rechten aan de database-users toekennen. Deze optie is alleen beschikbaar voor gebruikers met het “support” profiel binnen FraCladoc maintenance. (en zal bv. Niet beschikbaar zijn bij de applicatie “FraCladoc”. Bemerk wel dat je hiermee alle databases kunt beheren !
Security: Onder deze hoofding wordt alles geregeld wat met toegangscontrole te maken heeft. Dit onderdeel valt verder uiteen in twee delen: - Application Profiles: dit laat u toe om profielen binnen de applicatie te beheren en gebruikers toe te kennen aan die profielen. - Application Users: Hiermee kan je gebruikers toevoegen en wijzigen en profielen toekennen aan die gebruikers.
12 juni 2006
27 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Application Forms: Alle schermen in FraClaDoc applicaties zijn database-driven. Dit wil zeggen dat een “copy” ervan bewaard wordt in de database. Deze werkwijze laat u toe om eenvoudig een aantal handelingen te verrichten op die schermen: - Enerzijds laat dit u toe om de schermen te vertalen naar eender welke taal. - Anderzijds laat dit u toe om op die schermen bepaalde objecten (een knop, een label, een checkbox etc.) voor een bepaald profiel beschikbaar te stellen of niet. Languages: Om een scherm (Form) te kunnen vertalen naar een “vreemde” taal dient deze eerst gedefinieerd te worden. Dit laat u toe om dat te doen. (Standaard zijn reeds het Engels, Nederlands, Frans en Duits gedefinieerd). Messages: De foutboodschappen die getoond worden, zijn ook allen opgenomen in de database. Hiermee kan je deze beheren (vertalen, wijzigen, verwijderen, etc.)
7.3
Instellingen van FraClaDoc Maintenance Via het menu bestand op het hoofdscherm kan je de instellingen voor FraCladoc maintenance beheren. Deze instellingen behelsen o.m. het uitzicht van de applicatie, de database connectie en de instellingen voor fout afhandeling.
7.3.1
Algemene settings Het eerste wat je te zien krijgt bij het opstarten van het instellingsscherm is het tabblad met algemene informatie. Hierop zie je de naam van de applicatie en een omschrijving. Verder zie je een dropdown lijst met de taal die gebruikt wordt voor de schermen.
Maintenance Database en Applicatie database zijn de databases waar respectievelijk de Common data en de applicatie data opgehaald worden. (enkel lezen)
12 juni 2006
28 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
7.3.2
Database instellingen Het tweede tab dat je kunt bekijken en wijzigen is de tab met instellingen voor de connectie naar de database.
Om deze gegevens te wijzigen druk je op de knop “Wijzigen”, volgend scherm verschijnt.3
Veld Provider
Omschrijving Hier kan je kiezen welke provider je kiest. Je hebt de keuze uit MySql, Sql Server (Microsoft), Oracle or Access. Voor deze applictie geldt (momenteel) dat enkel MySql ondersteund wordt. Migratie naar andere databases is voorzien voor in de toekomst.
3
Bemerk dat het scherm om de database connectie te wijzigen automatisch verschijnt als – bij het opstarten van de applicatie – er geen verbinding gelegd kon worden met de database.
12 juni 2006
29 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Host
UserName
Password Port
Timeout Connection Lifetime Databases
Connection Pooling
Use compression
7.3.3
Dit is de naam van de computer waarop de database geïnstalleerd is. Heb je geen bedrijfsnetwerk waarbij de database op een afzonderlijke pc is geinstalleerd dan is die wellicht lokaal geinstalleerd. In dit geval type je hier “localhost”. Dit is de naam van de gebruiker waarmee je de connectie naar de database legt. Opmerking: Dit is niet hetzelfde als de gebruiker waarmee je de applicatie opstart! Het wachtwoord van de gebruiker om de connectie te leggen. De “poort” waarop de database “luistert” om te antwoorden op vragen (queries). Dit is afhankelijk van de provider. Als je een andere provider kiest in de dropdown wordt dit automatisch aangepast. Voor Mysql (standaard installatie) geldt dat poort 3306 wordt gebruikt. Dit is de maximum tijd dat er gewacht wordt op “antwoorden” van de database. De tijd dat een verbinding naar de database “levend” blijft indien er een tijdje geen vragen meer gestuurd worden. De database waarnaar de connectie gelegd wordt. Standaard wordt FraCladoc Maintenance geïnstalleerd in de database met naam “FraClaDoc”. Aanduiding of er – in de mate van het mogelijke – gebruik gemaakt wordt van één en dezelfde database connectie bij het uitvoeren van vragen (queries). Dit kan de snelheid ten goede komen. Vlag om aan te duiden of we de gegevens comprimeren vooraleer ze te versturen naar de database. Indien de database op een afzonderlijke server is geïnstalleerd kan dit het netwerk ontlasten doordat er minder grote pakketten verstuurd dienen te worden. Als je de database lokaal (Localhost) hebt geïnstalleerd is het niet aan te raden om dit aan te zetten.
Instellingen voor Foutafhandeling Standaard is er in de applicatie drie mogelijkheden voorzien om fouten af te handelen.
12 juni 2006
30 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Scherm: De fouten die tegengekomen worden (zowel de “voorziene” als de onvoorziene”) worden getoond op het scherm m.b.v. een standaard informatie-scherm. Database: De fouten die tegengekomen worden (zowel de “voorziene” als de onvoorziene”) worden naar de database weggeschreven. Dit kan handig zijn als je een “historiek” wilt bijhouden van een aantal zaken. Om de fouten te bekijken die geregistreerd zijn in de database open je de bijhorende beheersfunctie (zie: Applicaties beheren: Historiek (logging) ) Bestand: De fouten die tegengekomen worden (zowel de “voorziene” als de onvoorziene”) worden weggeschreven in een bestand. Kies je voor deze optie moet je een bestandsnaam ingeven. Hiertoe druk je op “Zoeken”.
Naast de mogelijkheid om te tonen waar fouten afgehandeld worden (scherm, database, bestand of een combinatie van de drie) heb je telkens nog de mogelijkheid om te kiezen welke fouten er afgehandeld dienen te worden:
Bovenaan zijn een aantal “presets” te vinden. Door één van deze drie presets aan te vinken wordt er automatisch een selectie gemaakt in welke zaken of gebeurtenissen er gelogd worden. Preset Alles Minimaal Geen loggin
Omschrijving Omschrijving Alle fouten die tegengekomen worden worden gelogd. Het minimale aan fouten worden gelogd De optie om fouten te loggen wordt afgezet voor dit type van foutafhandeling.
Onder de lijn vindt je een aantal mogelijkheden van gebeurtenissen die gelogd kunnen worden op een (of een combinatie) van manieren (scherm, database, bestand) Optie Omschrijving Fouten De fouten die tegen gekomen worden Informatie Zogenaamde “informatie” punten. Dit kan bv. Zijn dat de lengte van een veld te lang is, of dat er gegevens ontbreken. Waarschuwing Een bepaalde handeling kan bv. Ernstige gevolgen hebben. Dit genereert een waarschuwing Debug mode Dit is een “speciale” optie waarbij elke significante uitvoering van code wordt gelogd. Dit is voornamelijk bedoeld voor het opsporen van fouten die moeilijk te reproduceren zijn.
12 juni 2006
31 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
7.3.4
Uitzicht van het programma Nieuw in de huidige versie is de mogelijkheid om het uitzicht van bepaalde elementen te wijzigen. Hiertoe dient dit scherm.
De dropdown geeft u een lijst met mogelijke instellingen. De knop “Herstel” herstelt de instelling naar “fabriekswaarde” of hetgeen bewaard was voor de wijzigingen.
12 juni 2006
32 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
8
Applicaties beheren: Algemeen Het merendeel van FraClaDoc applicatis is “database driven”. Dit wil zeggen dat – daar waar nodig en mogelijk was – alles als parameter in de database geplaatst wordt. Deze manier van werken zorgt ervoor dat kleine wijzigingen aan het programma eenvoudig gedaan kunnen worden. Verder zorgt dit er ook voor dat wijzigingen in een multi-user omgeving maar éénmaal aangebracht dient te worden. Het spreekt dan ook vanzelf dat we enkel algemene informatie en parameters in de database willen bewaren. Voorbeeld van wat we kunnen bewaren in de database is de url waar er hulp beschikbaar is. Een voorbeeld van wat we niet bewaren is hoe de gebruiker het uitzicht van zijn schermen wil hebben aangezien dit gebruiker afhankelijk is.
8.1
Algemene informatie Door in de menu-navigatie “general” (algemeen) te selecteren kom je op onderstaand scherm terecht. Hiermee kan je de omschrijving van een applicatie wijzigen en de parameters aanpassen.
Velden gerelateerd aan de algemene informatie. Veld Applicatie Omschrijving Bewaren
Omschrijving Dit is de naam van de applicatie. Deze kan je niet wijzigen Hier kan je (optioneel) een omschrijving plaatsen. Als je de wijzigingen aan de omschrijving gedaan hebt, kan je op “Bewaren drukken”.
12 juni 2006
33 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
8.2
Applicatie parameters Het middelste deel van het scherm toont de parameters die actief zijn voor deze applicatie. Onderaan het scherm heb je de mogelijkheid om een nieuwe parameter aan te maken. Bemerk echter dat dit maar zin heeft als er in de code van de applicatie rekening gehouden wordt met deze (nieuwe) parameter.
8.2.1
Parameters wijzigen Om bestaande parameters te wijzigen gebruik je het middelste deel van het scherm. Maak hier de nodige wijzigingen en druk vervolgens op “Bewaren” om de wijzigingen te bewaren.
Veld Name ParameterValue Description Fixed Deleted CreUser CreTime UpdUser UpdTime
Omschrijving Dit geeft de naam van de parameter. (alleen lezen) Hieronder komt de waarde van de parameter te staan. Dit geeft een korte omschrijving van de parameter. Dit geeft aan of deze parameter wijzigbaar is of niet. Zie De notie Logische verwijdering Hierin wordt bewaard wie de parameter aangemaakt heeft Hierin wordt bewaard op welk tijdstip de parameter aangemaakt is. Als de parameter-waarde of omschrijving of eender welk ander veld gewijzigd is wordt hierin bewaard wie dit gedaan heeft. Het tijdstip waarop de parameter het laatst gewijzigd is. Is dit of is de parameter nog nooit gewijzigd.
Deze waarden kan je wijzigen. Als je klaar bent met wijzigen druk dan op “Bewaren” om deze te bewaren.
8.2.2
Nieuwe parameter aanmaken. Om een nieuwe parameter aan te maken druk je op “Nieuw”. Onderstaand scherm verschijnt.
12 juni 2006
34 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Veld Naam Omschrijving Waarde Vast Verwijderd Annuleren Ok
Omschrijving Hier vul je de naam in van de parameter Geef hier een omschrijvende tekst voor de parameter in . Hier moet je een initiële parameter-waarde ingeven. Aanduiding of de parameter gewijzigd mag worden of niet. Zie De notie Logische verwijdering Dit annuleert de operatie; Als al de waardes correct zijn kan je hiermee de parameter bewaren.
12 juni 2006
35 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
9
Applicaties beheren: Historiek (logging) Bij de instellingen voor iedere applicatie kan je kiezen welke gebeurtenissen je wilt bewaren in een historiek in de database. Deze beheersfunctie laat u toe om deze zaken te bekijken. Als je op de optie “Application Log” klikt in de navigatie-menu krijg je het volgende scherm te zien:
Veld Applicatie Gebruiker
Log Type
Ophalen Verversen
Omschrijving Hier krijg je de naam van de applicatie te zien. Dit geeft een lijst van gebruikers die gekend zijn binnen de applicatie. Door één van de personen uit de lijst te kiezen en op “Ophalen” te drukken krijg je alle gebeurtenissen die deze persoon veroorzaakt hebben. Laat je dit leeg (null) krijg je alle gebeurtenissen van alle personen te zien. Hier krijg je een lijst te zien met type-gebeurtenissen. Deze zijn ook terug te vinden in de applicatie-settings. (zie: Instellingen voor Foutafhandeling) Volgende items kunnen geselecteerd worden: - Checkpoint: debugmode - Error: fouten - Informational: informatie - Warning: algemene waarschuwingen Dit haalt de gegevens op met de gekozen opties (gebruiker – type) Zie “Ophalen”.
12 juni 2006
36 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Op het moment dat je op “ophalen” of “verversen” drukt krijg je in het midden van het scherm een overzicht te zien van de gebeurtenissen die je geselecteerd hebt.
Veld ID Date Applicatie User Code Entry
Omschrijving Dit is een automatisch gegenereerd volgnummer. Hierin vindt je de datum waarop de gebeurtenis plaats had. Dit is de naam van de applicatie waarover het gaat. De gebruiker die de oorzaak was van de gebeurtenis. Hier krijg je een korte code te zien. Naast de code krijg je ook een omschrijving (vertaling) van de code.
12 juni 2006
37 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
10
Applicaties beheren: Database backup & Restore Naast het “raamwerk” (Framework) van FraCladoc applicaties kan het ook zijn dat de applicatie zelf gegevens bewaard in een database. Om niet afhankelijk te zijn van een database administrator, zijn er in FraCladoc maintenance functies ingebouwd die het beheren van de database(s) zou moeten mogelijk maken. Opmerking: Deze functie is enkel toegankelijk voor gebruikers die binnen de FraCladoc maintenance applicatie een profiel hebben dat een “support” profiel is, of gebruikers die rechtstreeks het “support” profiel toegekend gekregen hebben.
10.1 10.1.1
Inleidende noties “Smart” versus “script” Een reservecopy nemen of herstellen kan op twee manieren gebeuren: 1) Smart: Dit zal alle gegevens bewaren in een xml-bestand. Bij het herstellen van deze “backup” zullen de objecten die in deze xml bestand zitten vergeleken worden met de objecten in de database. Bij een conflict tussen beide (vb. een veld dat van een tabel verwijderd is) zal de gebruiker verwittigd worden en een aantal mogelijkheden gepresenteerd krijgen. (vb. gebruik de versie van het xml-bestandje, of negeer deze wijziging). Voordeel is dat dit “smart” is, nadeel is dat het bestand aanmaken langer duurt dan een script-uitvoer. (en het bijhorende vergelijken duurt ook langer). 2) Script: Hier zal er een één op één copy genomen worden van de database waarbij voor elk (geselecteerd) object de syntax om dit aan te maken bewaard wordt. Het herstellen van deze backup (restore) is het uitvoeren van deze commando’s. In dit opzicht is dit een actie waarop niet ingegrepen kan worden. Voordeel van dit systeem is dat het aangemaakt bestand kleiner is. Nadeel is dat er niet tussengekomen kan worden.
10.1.2
Conflict afhandeling bij Smart Restore Als er bij bij het herstellen (restore) van de database via de “smart” (slimme) restore een fout optreedt, zal de gebruiker de moglelijkheid krijgen om deze fout af te handelen. Standaard zijn hiervoor een aantal manieren voorzien:
Gebruik database: Dit wil zeggen dat we de versie zoals die momenteel in de database staat gebruiken en dat we bijgevolg de voorgestelde wijzigingen niet accepteren. Gebruik nieuwe versie: versie Dit zal trachten de versie van de database aan te passen aan de versie zoals die gevonden wordt in de xml-file. Altijd database versie gebruiken: Hierdoor zal bij een conflict altijd de database versie gebruikt worden (en krijg je het conflict-scherm voor dit type conflict niet meer te zien.)
12 juni 2006
38 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Altijd nieuwe versie (xml) gebruiken: Hierdoor zal bij een conflict altijd de nieuwe versie gebruikt worden (en krijg je het conflict scherm voor dit type conflict niet meer te zien.) Altijd nieuwe objecten maken: Hierdoor zullen objecten die in de xml-file bestaan maar (nog) niet in de database altijd automatisch aangemaakt worden. Altijd verwijderde objecten objecten verwijderen: Hierdoor zullen objecten die gevonden worden in de database, maar niet in de xml file automatisch verwijderd worden. Wijzigingen negeren: De voorgestelde wijziging zal genegeerd worden.
Deze manier van conflict afhandeling heeft betrekking op specifieke “onderdelen” van de database. Dit wil zeggen dat niet alle opties altijd beschikbaar zullen zijn. Onderstaand schema verhelderd dit enigszins. Optie/Object
Tabellen
Gebruik database Gebruik nieuwe versie Altijd database versie gebruiken Altijd nieuwe versie gebruiken Nieuwe objecten maken Altijd verwijderde objecten verwijderen
X X X X X Enkel op subobjecten X
Wijzigingen negeren
Stored Procedures X X X X X -
Views
X
X X X X X X
De optie om “altijd verwijderde objecten te verwijderen” is enkel beschikbaar op “sub objecten” van tabellen. Dit wil zeggen op volgende items van een tabel: - een kolom (field) - een Trigger - een index - een constraint
Opmerking: Bij het herstellen van de database via een “smart” restore zal er nooit vanuit gegaan worden dat objecten die in de de database zitten, maar niet in de output file (xml-file) verwijderd mogen worden. De optie om de verwijderde objecten te verwijderen is dus niet beschikbaar (van toepassing) op een stored procedure, een view of een tabel in zijn geheel.
12 juni 2006
39 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
10.2
Applicatie database beheren – Algemeen. Het beheren van de database is opgesplitst in drie delen. Een eerste is het beheren van de database gebruikers. Vervolgens heb je het nemen van een backup (reservecopy) en tenslotte heb je de optie om de database te herstellen. (restore).
Veld Applicatie Omschrijving
Omschrijving Dit geeft de naam van de applicatie zoals die gedefinieerd staat in de database. Dit geeft een korte omschrijving van het programma. Dit kan je wijzigen als je gaat naar Applicaties beheren: Algemeen
In he tmidden van het scherm vindt je een “grid” met informatie over de applicaties die momenteel geïnstalleerd zijn. Veld Omschrijving Application Dit geeft de naam van de applicatie weer Executable Hier zou de naam van uitvoerbestand moeten staan. Database Dit geeft de naam van de database weer. In ons voorbeeld zie je dat ‘FraCladocMaint’ in de database ‘FraClaDoc’ geïnstalleerd is. Bemerk dat dit tevens de database is die de algemene informatie bevat (schermen, boodschappen, etc.) en die dus gedeeld (kan) worden door de veschillende applicaties. Version Dit geeft de versie weer van de applicatie. Description Dit geeft een korte omschrijving van het programma. Dit kan je wijzigen als je gaat naar Applicaties beheren: Algemeen Deleted Vlag om aan te duiden of deze applicatie “verwijderd” is. (zie ook De notie Logische verwijdering )
12 juni 2006
40 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Al de velden op dit scherm zijn informatieve velden en kan je dus niet wijzigen. Naast deze velden vindt je op het scherm ook nog drie knoppen: “Db. Gebruikers”: Dit laat u toe om de database gebruikers te definiëren. Bemerk dat dit niet hetzelfde is als applicatie-gebruikers. Een database gebruiker heeft alle rechten op objecten van de database. Een applicatie-gebruiker kan de applicatie uitvoeren. De naam van beide kan hetzelfde zijn, de inhoud is het zeker niet. “Herstel Database”: Dit laat u toe om een database te herstellen. “Backup Database”: Dit laat u toe om een reservecopy te nemen van de database.
10.3
Database gebruikers beheren Vooraleer de applcatie gebruikt kan worden dienen er database gebruikers gedefiniëerd te worden. Deze gebruikers laten de applicatie toe om gegevens op te halen van - en weg te schrijven naar de database. Dit onderdeel laat u toe om deze gebruikers te beheren. Het eerste wat u te zien krijgt is een log-in scherm voor de database. Indien de gebruiker die voorgesteld wordt – de standaard gebruiker om in te loggen op de database – voldoende rechten heeft kan u het voorstel aanvaarden. Anders dient u een gebruiker in te geven die voldoende rechten heeft op de database om gebruikers te beheren.4 Voor uitleg over het inlogscherm verwijzen we naar Database instellingen.
10.3.1
Beheren van gebruikers
4
Voor een Mysql installatie is dit meestal het “root” account. Bij de installatie van Mysql hebt u dit ingesteld. (zie: Installatie van Mysql Database )
12 juni 2006
41 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Veld Registered Users
User Hostname/IP
Wachtwoord Use old pwd encryption Max Querys /Hour Max. Updates /Hour Max. Connections /Hour Lijst
Omschrijving Hier krijgt u een lijst te zien met gebruikers die toegang hebben tot de database. Deze lijst is opgebouwd top-down: Naam van de gebruiker Database Tabel Kolom Kolom Tabel Kolom Kolom Dit is de naam van de gebruiker Hier staat de host (pc) van waaruit de gebruiker de database verbinding legt. Hier kan ‘%’ gebruikt worden om aan te duiden dat de gebruiker vanaf eender welke pc connectie mag leggen naar de database Het wachtwoord voor de gebruiker Om compatibel te zijn met vroegere versies van mysql kan je dit aanvinken. (versies van voor 4.0) Het maximum aantal querys per uur die toegestaan zijn. Het maximum aantal update statements dat toegestaan is Het maximum aantal connecties die gelegd mogen worden per uur. In het midden staat de lijst met mogelijke rechten per object. Zo zullen de rechten op database-niveau anders zijn dan deze op tabel-niveau.
Nieuwe gebruiker gebruiker:: Om een nieuwe gebruiker te maken drukt u op de knop “Add User”. Hierdoor worden de velden “User” en “Hostname/ip” leeggemaakt en beschikbaar gesteld. Vul hierin respectievelijk de naam van de gebruiker en de host van waaruit de database connectie gelegd wordt. (of ‘%’ indien er geen restricties zijn) Druk vervolgens op “save” om deze te bewaren. De nieuwe gebruiker is aangemaakt. Rechten wijzigen: Om de rechten van een gebruiker te wijzigen selecteer je eerst deze gebruiker in de lijst en selecteer je vervolgens het object waarop deze rechten van toepassing zijn (database, tabel, kolom, globaal). Afhankelijk van het geselecteerde object zal de lijst met mogelijke rechten aangepast worden. De rechten die de gebruiker momenteel reeds heeft zijn aangevinkt. Om deze te ontnemen vink je dit recht opnieuw af. Om een recht toe te kennen vink je het aan. Als je klaar bent met de gebruiker druk je op “Grant”, dit zal de rechten toekennen aan de gebruiker. Nadat dit gebeurd is dient er nog op “Flush privileges” gedrukt te worden om deze wijzigingen meteen toe te kennen. Gebruiker verwijderen: Om een gebruiker te verwijderen selecteer je deze in de lijst en druk je op “Delete User”. Er zal om een bevestiging gevraagd worden.
12 juni 2006
42 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
10.3.2
Rechten in Mysql databases. Privileges in mysql databases kunnen zich op een aantal niveaus afspelen: Globale niveau: Dit zijn rechten die op het hoogste niveau toegekend worden. (vb. Grant usage)
Database niveau: Dit zijn rechten die enkel van toepassing zijn op de database waarop ze slaan.
Tabel niveau: Dit zijn rechten die enkel van toepassing zijn op de betreffende tabel in die welbepaalde database.
Kolom niveau: Dit zijn rechten die enkel van toepassing zijn op de betreffende kolom van die tabel in die welbepaalde database. Voorbeeld van rechten zijn: Create, alter, delete, update, select, show view, create view, etc.
10.3.3
Rechten verreist voor FraCladoc applicaties. Om FraCladoc applicaties goed te kunnen gebruiken is het nodig om een aantal gebruikers met specifieke rechten te definiëren. De rechten die nodig zijn, zijn afhankelijk van de taak die men dient uit te voeren. We onderscheiden volgende (database) gebruikers:5 FraClaDoc maintenance gebruiker: gebruiker Dit is de gebruiker die het support profiel heeft in FraCladoc maintenance. (FCDMAINT_SUPPORT) Deze gebruiker dient rechten te hebben op de FraClaDoc maintenance database en alle databases die in gebruik zijn door FraCladoc applicaties. Gewone applicatie gebruiker: Dit is de gebruiker die een applicatie mag gebruiken (vb. FraCladoc client applicatie) (FCDAPP_USER). Deze gebruiker dient enkel toegang te hebben tot zijn eigen (applicatie) database. Support voor de applicatieapplicatie-gebruiker: Dit is de gebruiker die binnen een gewone applicatie het support profiel heeft (en dus FraCladoc maintenance mag gebruiken.) (FCDAPP_Support) Naast toegang tot de eigen applicatie-database heeft deze gebruiker ook beperkte rechten op de FraCladoc maintenance database.
5
We gaan ervanuit dat er voor Mysql gekozen is als database. Voor andere databases gelden dezelfde – of gelijkaardige – privileges. Deze worden hier echter niet uit de doeken gedaan. De beheersfunctie om rechten toe te kennen en/of te verwijderen is enkel geïmplementeerd voor Mysql!
12 juni 2006
43 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Globaal niveau (*.*) Privilege/User Select Index Super Execute Create View Create Routine Alter Routine
FCDMAINT_SUPPORT X X X X X X X
FCDAPP_Support
FCDAPP_USER
Op de FraClaDoc Maintenance database (FraClaDoc.*) Privilege/User Select Insert Update Delete Create Drop Alter Execute Create View Show view Create Routine Alter routine
FCDMAINT_SUPPORT X X X X X X X X X X X X
FCDAPP_SUPPORT X X X X
FCDAPP_USER X
Op de applicatie niveau (FraCladocClient.*) (anders dan de maintenance database) Privilege/User Select Insert Update Delete Create Drop Alter Create View Show View Create Routine Alter Routine Execute
FCDMAINT_SUPPORT X X X X X X X X X X X
FCDAPP_SUPPORT FCDAPP_SUPPORT X X X X X X X X X X X
FCDAPP_USER X X X X
X
Privileges op de Mysql database Privilege/User Select
FCDMAINT_SUPPORT FCDMAINT_SUPPORT X
FCDAPP_SUPPORT X
12 juni 2006
FCDAPP_USER X
44 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
10.4
Een database backup nemen Het beheren van gegevens op hoog niveau gebeurd in twee fases. De eerste fase is het nemen van een backup. De volgende fase is het terugplaatsen van deze backup. Het nemen van een backup kan voor verschillende doeleinden goed zijn. Het kan nodig zijn om op regelmatige tijdstippen een backup te nemen zodat we steeds kunnen teruggaan naar een bepaald punt in de tijd. Verder is het nemen van een backup ook handig als je de database voor het eerst wil installeren. Zo is de versie die meegeleverd is bij de installatie een backup die genomen werd net voor het aanmaken van de setup-bestanden.
10.4.1
Het backup scherm.
Veld Applicatie Omschrijving Executable Database Versie Actief
Omschrijving Dit geeft de naam van de applicatie weer Dit geeft een korte omschrijving van de applicatie De naam van het uitvoerbestand Dit geeft de naam van de applicatie-database waarvan we een backup wensen te nemen. Dit is een versie-aanduiding. Aanduiding om te zien of deze applicatie “actief” is. (zie De notie Logische verwijdering )
Verder zie je op dit scherm nog drie lijsten met database objecten: tables, views en stored procedures. Helemaal rechts op het scherm zie je de opties die je hebt voor het maken van een backup.
12 juni 2006
45 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Nieuw in versie 7.1 In versie 7.1 is er de mogelijkheid toegevoegd om bij het nemen van een backup van de gemeenschappelijke data (common data) een aantal criteria in te stellen. Bedoeling is dat vb. enkel die schermen gebacke-uped worden die nieuw zijn in een bepaalde versie of die een wijziging ondergaan hebben. Volgende opties zijn beschikbaar: Created after Created By Updated after Updated by
De data aangemaakt na de gegeven datum Data aangemaakt door een bepaalde gebruiker De data die na een bepaalde datum is aangepast. Data die door een bepaalde gebruiker is aangepast.
Geef je in een van de velden een waarde mee, dan worden de gegevens op deze waarden gefilterd.
10.4.2
Het nemen van een backup Voordat je een backup kan nemen dient de applicatie eerst te weten welke objecten er allemaal in de database zitten. Hiertoe druk je op de knop “Ophalen” (Retrieve objects) Dit haalt de tabellen (tables) views en stored procedures op uit de database. Selectie maken maken:: Eenmaal je de objecten opgehaald hebt uit de database kan je selecteren welke je wilt invoegen in je backup-file. Hiertoe selecteer je het type object en druk je op de respectievelijke knoppen <, <<, >> of >) Type backup: Je kan kiezen voor 2 types backup. (zie ook: “Smart” versus “script” ) Als je opteert voor een “smart” output wordt er voor tabel-objecten automatisch gezocht naar afhankelijkheid. Tabellen die afhankelijk zijn van elkaar worden automatisch toegevoegd – indien ze nog niet manueel geselecteerd zijn. Dit wil zeggen als tabel A een reference (foreign key constraint) heeft naar tabel B zal tabel B automatisch toegevoegd worden mocht deze niet geselecteerd zijn. Opties instellen: Optie Tabel structuur
Backup Views
Backup Stored Procedures
Applicatie Data
Omschrijving Aanduiding of we de structuur van de tabel invoegen of niet. (als je een tabel selecteert wordt dit automatisch aangevinkt) Aanduiding of we een backup nemen van de (geselecteerde) views. Indien je er eentje selecteert wordt dit automatisch aangevinkt. Aanduiding of we een backup nemen van de (geselecteerde) stored procedures. Indien je er eentje selecteert wordt dit automatisch aangevinkt. Aanduiding of we de gegevens zelf backuppen. Bij een
12 juni 2006
46 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Common Data
script restore kan je ervoor opteren om de gegevens los van de tabel-structuur te exporteren. Bij een smart restore wordt automatisch de tabel structuur mee geëxporteerd indien de gegevens aangevinkt worden. Aanduiding of we de gemeenschappelijke data backuppen. (dit gaat over de messages, de schermen, de profielen etc. gegevens dus die niet eigen zijn aan de applicatie, maar aan de werking van het programma.)
Eenmaal je je keuze gemaakt hebt, kan je drukken op de knop “Copy Maken”. Dit zal het process in gang zetten om hetzij een xml-file hetzij een sql-script aan te maken. Je zal gevraagd worden om een bestandsnaam in te geven. Opteerde je voor het exporteren van de “common data” zal dit bewaard worden in een afzonderlijk bestandje in dezelfde directory (folder) waar je het ander bestandje bewaard wil hebben. Het tabblad “progress” toont u de voortgang van het process. Afhankelijk van de gekozen opties en de hoeveelheid data kan dit enige tijd in beslag nemen. MetaMeta-data: In het bewaard bestandje – of het nu een xml-bestand of een sql-script is – zal er telkens meta-data bewaard worden. Hieronder valt ondermeer - het tijdstip waarop dit aangemaakt is - De naam van de database - De provider - Een versie aanduiding
10.5 10.5.1
Een database backup herstellen. Het herstel-scherm
12 juni 2006
47 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Veld Bestand Provider Versie Database Datum Provider Doel database
Omschrijving Dit geeft je de mogelijkheid om een bestand te selecteren. Afhankelijk van het type-backup kan je kiezen voor een *.xml of een *.sql bestand. Dit geeft de provider aan zoals die bewaard werd in het bestand. Dit geeft de versie-aanduiding aan zoals die bewaard werd in het bestand. Dit geeft de naam van de oorspronkelijke database aan zoals die bewaard werd in het bestand. Dit geeft het tijdstip aan waarop de backup genomen werd. Dit geeft de provider aan zoals die bewaard werd in het bestand Indien verschillend dat de database zoals blijkt uit het bestandje kan je een nieuwe database aanmaken.
Verder zie je op dit scherm nog een aantal opties vermeld die verderop uitgelegd zullen worden.
10.5.2
Het terugplaatsen van een backup: scripting Voordat je een backup kan terugplaatsen dien je het bestand eerst in te lezen. Hiervoor druk je op de knop “Inlezen”. Het bestand zal worden ingelezen en de meta-data zal getoond worden op het scherm. Afhankelijk van het type-backup (xml of sql) heb je meer of minder opties. Heb je gekozen voor een script-backup dan heb je nu de opties om de backup terug te plaatsen. Het tabblad “voortgang” zal getoond worden waarop je de voortgang kan monitoren. Indien er fouten optreden bij het uitvoeren van de sql-commando’s krijg je een popup te zien met het commando, een fout-omschrijving en de mogelijkheid om de operatie te annuleren. Op het einde van het proces krijg je een overzicht te zien (in het voortgang scherm) van eventuele fouten die opgetreden zijn.
10.5.3
Het terugplaatsen van een backup: Smart restore Bij een smart-restore heb je meer mogelijkheden en flexibiliteit. Volgende opties zijn beschikbaar: Optie Alleen gegevens Alleen structuur Gegevens & Structuur Objecten verwijderen
Wijzigingen bevestigen Database aanmeken.
Omschrijving Dit zal alleen de gegevens importeren. Indien een tabel niet bestaat zal deze aangemaakt worden. Dit vergelijkt de structuur van objecten en past waar nodig de zaken aan. Dit importeert zowel de gegevens als de structuur. (Enkel voor sub-objecten van tabellen). Dit zal de objecten automatisch verwijderen als het niet meer in de database bestaat. Indien er aan de database wijzigingen dienen te gebeuren op zowel structureel als gegevens-niveau zal je om bevestiging gevraagd worden. (enkel smart restore) als de doel-database die je opgeeft anders is dan de database-naam zoals bewaard in het output
12 juni 2006
48 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
bestandje krijg je de mogelijkheid om deze database eerst aan te maken. Eenmaal je je keuze gemaakt hebt kan je drukken op “Herstellen”. De voortgang kan je monitoren op het tabblad “Voortgang”. Eventuele conflicten zullen getoond worden (afhankelijk van het feit of je deze optie geselecteerd hebt of niet). Voor conflict afhandeling verwijzen we naar: Conflict afhandeling bij Smart Restore
12 juni 2006
49 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
10.5.4
Applicaties beheren: Profielen en gebruikers (Security) Voor je aan de slag kunt met FraCladoc Maintenance – en alle andere applicaties – dien je een woordje uitleg te hebben over wat profielen zijn en hoe dit concept werkt. Een profiel (Profile) laat een gebruiker toe bepaalde handelingen te doen in de applicatie. Meteen kan de administrator – of de persoon die deze profielen kan aanpassen – beperkingen opleggen aan wat een gebruiker wel en niet kan. Een voorbeeld: Een bibliothecaris in een bibliotheek zal in zijn programma zowel boeken mogen raadplegen als nieuwe boeken toevoegen. Een gebruiker van de bibliotheek zal enkel mogen raadplegen, de optie om boeken toe te voegen zal voor deze laatste uitgeschakeld zijn. Om FraClaDoc Maintenance™ te gebruiken dien je een gebruiker te zijn met een profiel dat de optie “support” heeft.6 Deze support optie kan je op 2 manieren bekomen: 1. ofwel heeft jouw profiel deze optie (en dus hebben alle gebruikers onder dit profiel deze optie). In het voorbeeld hieronder heeft het profiel “Support” deze optie angevinkt. De gebruiker ‘BE03873’ heeft dus onrechtstreeks de “Support” optie. 2. Ofwel heb je als gebruiker dit recht toegekend (los van je profiel). (In het voorbeeld hieronder de gebruiker (User) ‘FraClaDocMaint’
10.6 10.6.1
Profielen Profielen beheren Je kan toegang tot het scherm om profielen te beheren door middel van het menu in de lijst die je vindt op je linkerkant. Onder het item “Security” staan twee sub-items. Met “Aplication profiles” beheers je de profielen en kan je gebruikers toekennen aan deze profielen. Met “Application Users” kan je gebruikers aanmaken en wijzigen en profielen toekennen aan gebruikers.
6
Bemerk dat de optie “support” enkel een rol speelt binnen FraCladoc Maintenance. Hierop wordt gechecked of een gebruiker deze applicatie mag gebruiken. In FraClaDoc zelf speelt dit geen rol en wordt er hierop niet gechecked. (D.w.z. dat een gebruiker die gekend is met een profiel de applicatie FraCladoc mag gebruiken).
12 juni 2006
50 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Als je twee maal klikt met de muis op de optie “Application Profiles” krijg je onderstaand scherm te zien. Van hieruit kan je nieuwe profielen maken en gebruikers toevoegen of verwijderen uit dat profiel.
Volgende is zichtbaar op het scherm: Applicatie en Omschrijving: Hier vindt je de naam van de applicatie (in ons geval FraClaDocMaint) zoals deze gedefinieerd staat in de database en zijn omschrijving. Verversen: Als je dit selecteert wordt de lijst in het midden van het scherm opnieuw opgebouwd. Nieuw profiel: Dit laat u toe om een nieuw profiel aan te maken. De toekenning van de rechten voor dit profiel dient te gebeuren in een afzonderlijk scherm. (Zie verder) Beheren: Deze optie laat u toe om aan een bestaand profiel gebruikers toe te kennen. Lijst met profielen: Dit geeft u een lijst met profielen. Het veld “Name” (naam) van het profiel kan je niet wijzigen. Alle andere velden zijn wijzigbaar. Als je tweemaal klikt op een profiel krijg je de lijst te zien met gebruikers die toegekend zijn aan dit profiel. Ok: Als je wijzigingen gamaakt hebt in de lijst met profielen laat dit u toe om de wijzigingen te bewaren.
12 juni 2006
51 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
10.6.2
Nieuw profiel maken Door op de knop “Nieuw profiel” te drukken kan je een nieuw profiel aanmaken.
De naam van de applicatie is reeds ingevuld en kan je niet wijzigen. Veld Veld Applicatie Profiel naam DB Login
Omschrijving Support Verwijderd Annuleren OK
Omschrijving Dit is de naam van de applicatie waarover het gaat. Dit kan je niet wijzigen. Hier dien je de naam van het profiel in te geven. Dit veld wordt gebruikt om aan te geven met welke gebruikers-naam de connectie naar de database gelegd wordt. Aan deze gebruiker kunnen (als extra beveiliging) rechten toegekend worden. Dit veld is voor toekomstig gebruik en wordt momenteel niet verder gebruikt. Hier kan je een omschrijving (vrije tekst) ingeven. Is dit profiel een “support” profiel. Dit heeft enkel invloed voor FraCladoc Maintenance. (Zie Profielen) Dit duidt aan of het profiel verwijderd is. (zie ook:De notie Logische verwijdering ) Dit annuleert de operatie. Dit zal trachten het nieuwe profiel te bewaren. Indien er een fout optreedt zal dit gemeld worden.
Opmerking: Dit scherm dient enkel om een profiel aan te maken. De instellingen over de mogelijkheden en beperkingen van dit profiel dienen gedaan te worden in het scherm dat daartoe ontworpen is. (Zie: Applicaties beheren: Schermen )
12 juni 2006
52 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
10.6.3
Gebruikers toekennen aan een profiel. Door in het scherm met de profielen de optie “Beheren” te selecteren kan je gebruikers toekennen aan het profiel dat je geselecteerd hebt. Volgend scherm verschijnt:
Veld Applicatie Profiel Actief Beschikbare gebruikers Geselecteerde gebruikers Annuleer OK > >> < <<
Omschrijving Dit geeft de naam van de applicatie Dit geeft het profiel waarover het gaat Of dit profiel actief is of niet. (verwijderd of niet) Dit geeft de lijst met gebruikers die (nog) niet toegekend zijn aan dit profiel. Dit geeft de lijst met profielen die toegekend zijn aan dit profiel. Annuleert de toekenning van gebruikers Indien je wijzigingen gemaakt hebt is deze knop beschikbaar. Door hierop te drukken worden de wijzigingen bewaard. Dit voegt de geselecteerde gebruiker toe aan de lijst Dit voegt alle beschikbare gebruikers toe aan de lijst met geselecteerde gebruikers. Dit verwijderd de geselecteerde gebruiker uit de lijst. Dit verwijderd alle gebruikers van de lijst met geselecteerde gebruikers zodanig dat niemand nog toegekend is aan dit profiel.
12 juni 2006
53 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
10.7 10.7.1
Gebruikers Gebruikers beheren Je kan toegang tot het scherm om gebruikers te beheren door middel van het menu in de lijst die je vindt op je linkerkant. Onder het item “Security” staan twee sub-items. Met “Aplication profiles” beheers je de profielen en kan je gebruikers toekennen aan deze profielen. Met “Application Users” kan je gebruikers aanmaken en wijzigen en profielen toekennen aan gebruikers. Als je twee maal klikt met de muis op de optie “Application Users” krijg je onderstaand scherm te zien. Van hieruit kan je nieuwe gebruikers maken en profielen toekennen aan gebruikers. Opmerking: Een (nieuwe) gebruiker staat in eerste instantie los van elke applicatie. Het is maar door aan een gebruiker profielen toe te kennen dat deze gebruiker gekend is in de applicatie en deze applicatie mag gebruiken.
Volgende is zichtbaar op het scherm: Applicatie Applicatie en Omschrijving: Hier vindt je de naam van de applicatie (in ons geval FraClaDocMaint) zoals deze gedefinieerd staat in de database en zijn omschrijving.
12 juni 2006
54 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
Verversen: Als je dit selecteert wordt de lijst in het midden van het scherm opnieuw opgebouwd. Nieuw: Dit laat u toe om een nieuwe gebruiker aan te maken. Profielen: Deze optie laat u toe om aan een bestaande gebruiker profielen toe te kennen. Lijst met gebruikers: Dit geeft u een lijst met gebruikers. Het veld “Name” (naam) van de gebruiker en de naam van het profiel kan je niet wijzigen. Alle andere velden zijn wijzigbaar. Als je tweemaal klikt op een profiel krijg je de lijst te zien met profielen die toegekend zijn aan deze gebruiker. Ok: Als je wijzigingen gamaakt hebt in de lijst met gebruikers laat dit u toe om de wijzigingen te bewaren.
10.7.2
Nieuwe gebruiker maken Door op de knop “Nieuw” te drukken kan je een nieuwe gebruiker definieren.
Veld Naam Wachtwoord
Actief
Verwijderd Annuleren OK
Omschrijving Hierin komt de naam van de gebruiker Hier kan je (optioneel, maar wel aan te raden) een wachtwoord instellen voor deze gebruiker. Dit wachtwoord kan de gebruiker zelf ten allen tijde veranderen. Vlag om aan te duiden of deze gebruiker actief is of niet. Door deze vlag af te zetten kan je tijdelijk (of definitief) verhinderen dat de gebruiker een applicatie opstart. Dit duidt aan of de gebruiker verwijderd is. (zie ook: De notie Logische verwijdering) Dit annuleert de operatie. Dit zal trachten de nieuwe gebruiker te bewaren. Indien er een fout optreedt zal dit gemeld worden.
12 juni 2006
55 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
10.7.3
Profielen toekennen aan een gebruiker. Door in het scherm met de gebruikers de optie “Profielen” te selecteren kan je profielen toekennen aan de gebruiker die je geselecteerd hebt. Volgend scherm verschijnt:
Veld Applicatie Gebruiker
Actief Beschikbare profielen
Geselecteerde profielen Annuleer OK > >> < <<
Omschrijving Dit geeft de naam van de applicatie waarover het gaat Dit geeft de gebruiker weer die in het vorige scherm geselecteerd werd. Het is aan deze gebruiker dat we profielen wensen toe te kennen. Of deze gebruiker actief is of niet.actief is of niet. Dit geeft de lijst met profielen die nog niet toegekend zijn aan deze gebruiker. Deze lijst bevat enkel de profielen die gekend zijn in de applicatie zelf. Dit geeft de lijst weer met profielen die reeds toegekend zijn aan deze gebruiker. Annuleert de toekenning van profielen Indien je wijzigingen gemaakt hebt is deze knop beschikbaar. Door hierop te drukken worden de wijzigingen bewaard. Dit voegt het geselecteerde profiel toe aan de lijst Dit voegt alle beschikbare profielen toe aan de lijst met geselecteerde profielen. Dit verwijderd het geselecteerde profiel uit de lijst. Dit verwijderd alle profielen van de lijst met geselecteerde profielen zodanig dat deze gebruiker geen enkel profiel meer heeft. (en dus geen applicatie meer kan opstarten.)
12 juni 2006
56 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
11
Applicaties beheren: Schermen Om het beheer van profielen en het beheer van de vertalingen eenvoudig te maken is er een optie voorzien die dit zou moeten vergemakkelijken. Om dit uit te leggen dienen we eerst uit te leggen hoe een scherm opgebouwd is.
Een scherm bevat steeds volgende elementen: Objecten: dit zijn de scherm-elementen. Voorbeeld hiervan is een knop (button) een selectie-lijst (dropdown), een label, een checkbox enz. Menu’s: Menu’s: Naast de objecten kan een scherm ook menu’s bevatten. Dit kunnen zowel schermmenu’s zijn (vast bovenaan het scherm) als context-menu’s, menu’s die maar tevoorschijn komen als je een object selecteert en met je rechtermuisknop erop klikt. In het logische database model kunnen verschillende objecten gegroepeerd worden tot een zogenaamde objecten-groep. Voorbeeld hiervan is een zogenaamde groupbox die bepaalde opties kan groeperen. Voorbeeld: In het onderstaand voorbeeld gaat het om het “MainForm” (hoofdscherm) van de applicatie FraCladoc maintenance. In deze applicatie heeft dat scherm 2 menu’s: file (bestand) en help. Verder zien we dat er nog een aantal form-elements zijn (objecten op het scherm) We onderscheiden een docking panel (werkgebied), een splitter (die het mogelijk maakt om schermen te splitsen) etc. Elk van deze elementen heeft een standaard vertaling, omschrijving, naam, type enzovoort.
12 juni 2006
57 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
11.1
Verzamelscherm “schermen”. Als je de beheersfunctie “schermen” aanklikt kom je op onderstaand scherm terecht. De hoofdfunctionaliteit willen we hier uitleggen.
Element Applicatie Omschrijving Verversen Ophalen
Beveiliging Vertalen Bewaren Lijst
Omschrijving Dit geeft de naam van de applicatie weer Hier vindt je een korte omschrijving van de applicatie. Dit haalt de schermen weer op uit de database Indien er (nog) geen schermen gedefinieerd zijn in de database kan je via deze functionaliteit alle schermen ophalen die in aanmerking komen om beheerd te worden.7 Dit laat u toe om voor bepaalde profielen, bepaalde objecten of menu-items al dan niet beschikbaar te stellen. Dit laat u toe om scherm-objecten en menu-items te vertalen in een taal naar keuze. Dit bewaard gemaakte wijzigingen. Dit geeft een lijst met alle beschikbare schermen in de database.
7
Deze functionaliteit is raar of zelfden nodig. Enkel in het (uitzonderlijke) geval dat je de database helemaal opnieuw moet installeren zonder initiële installatie-script. Dit gebruikt bovendien “reflection” wat in .NET problematisch is en niet zonder risico’s.
12 juni 2006
58 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
11.2
Initiële installatie – schermen ophalen. In het eerder uitzonderlijke geval dat je de schermen verwijderd zou hebben uit de database of dat je de applicatie wilt “exporteren” naar een andere database dien je de schermen opnieuw op te halen.8 Het onderstaand scherm dient hiervoor:
Veld Applicatie Executable Verversen Zoeken Verwijder schermen
Ok Annuleer
Omschrijving De naam van de applicatie Hier dien je via de knop de folder (directory) op te geven waar het uitvoerbestand (.exe) staat. Dit haalt opnieuw de gegevens op uit de database Dit zoekt naar de schermen m.b.v. reflection Dit zal eerst alle schermen uit de database verwijderen (let op, met het verwijderen van de schermen worden ook alle vertalingen en profielinstellingen voor die schermen verwijderd. Ok knop Annuleert de operatie.
Het ophalen van de schermen gebeurd door middel van reflection. Dit is een methode waarbij (vereenvoudigd gesteld) de ene applicatie aan een andere applicatie informatie vraagt over de inhoud ervan. Dit is een tijdrovend initiatief en niet zonder problemen.
8
Als je de schermen ophaalt dien je ook het profiel en alle vertalingen opnieuw in te stellen!
12 juni 2006
59 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
11.3
Schermen vertalen Om een scherm te vertalen (of een bepaald onderdeel van een scherm te wijzigen) druk je op de knop “Vertalen” in het hoofdscherm van de scherm-functionaliteit. Dit zal een wizard openen.9
De eerste maal dat je dit doet, zal je gevraagd worden om de locatie op te geven waar de desbetreffende applicatie geïnstalleerd is.
Eenmaal je de locatie opgegeven hebt zal er een wizard geopend worden die u zal begeleiden bij het vertalen van het geselecteerde scherm.
11.3.1
Taal keuze Het eerste dat dient te gebeuren is de keuze van de taal. De lijst met beschikbare talen is dezelfde als de talen die beschikbaar zijn in de applicatie. Nadat je je keuze gemaakt hebt druk je op “Volgende”.
9
Het dubbel-klikken op een scherm opent ook de wizard om het scherm te vertalen.
12 juni 2006
60 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
11.3.2
Vertalen van het scherm. Eenmaal je je keuze gemaakt hebt van taal, kan je het eigenlijke scherm gaan vertalen. Hetgeen je op je scherm ziet is een zo getrouw mogelijke weergave van het “echte” scherm. Om een element te vertalen selecteer je dat (vb. het labeltje “Gebruiker” en klik je tweemaal erop met je muis om het te vertalen. Als je het vertaald hebt druk je op “Enter” of klik je met je muis op een lege plaats op het scherm om de wijzigingen te bewaren. Als je gedaan hebt, druk je op <> om eventuele menuitems vertalen.
11.3.3
Vertalen van menu’s.
Als het scherm menu’s bevat zal, door het drukken op <> het scherm tevoorschijn komen om menu’s te vertalen. Druk met je rechtermuisknop op het menu-item om te vertalen.
De knop “Einde” zal de wijzigingen opslaan in de database.
12 juni 2006
61 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
11.4
Schermen beveiligen volgens profiel. Om een scherm te beveiligen en bepaalde functionaliteiten al dan niet beschikbaar te maken voor bepaalde profielen druk je op de knop “Security” in het overzichtsscherm. Dit zal een wizard openen.10
De eerste maal dat je dit doet, zal je gevraagd worden om de locatie op te geven waar de desbetreffende applicatie geïnstalleerd is.
Eenmaal je de locatie opgegeven hebt zal er een wizard geopend worden die u zal begeleiden bij het vertalen van het geselecteerde scherm.
11.4.1
Keuzen van het profiel. De eerste stap die je dient te voltooien is de keuze van het profiel dat je wilt bewerken. Nadat je je selectie gedaan hebt druk je op <>
10
Het dubbel-klikken op een scherm opent ook de wizard om het scherm te vertalen.
12 juni 2006
62 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
11.4.2
Beveiliging van het scherm. Eenmaal je op stap 3 bent van de wizard, kan je bepaalde elementen op het scherm al dan niet beschikbaar (enabled) zetten voor het geselecteerde profiel. Bemerk echter dat sommige elementen fixed zijn, dit wil zeggen dat zij programatorisch bepaald worden. De knop “vorige”, “volgende”, “einde” en annuleren op elke wizard zijn voorbeelden van zo’n “fixed” elementen. Deze elementen worden – afhankelijk van de gegevens op het scherm – al dan niet beschikbaar gesteld. Om een element voor dat profiel aan of af te zetten klik je erop met de muis.
11.4.3
Beveiliging van menu’s: Als het scherm dat je aan het bewerken bent menu’s bevat krijg je die te zien op het moment dat je op “volgende” drukt. Om een menu beschikbaar te stellen selecter je dat betreffende menu en vink je het aan of af.
Als je gedaan hebt met de wijzigingen aan te brengen, klik je op “Einde” om de wijzigingen te bewaren of “annuleren” om deze te annuleren.
12 juni 2006
63 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
12
Applicaties beheren: Talen De foutboodschappen evenals de labels op het scherm worden in FraClaDoc applicaties bewaard in de database. Dit geeft de mogelijkheid om verschillende talen aan te bieden aan de gebruiker, afhankelijk van de voorkeuren van deze gebruiker. Om dit echter mogelijk te maken moet de taal die je wilt aanbieden aan de gebruiker gedefinieerd zijn. Het volgende scherm maakt dit mogelijk.
Veld Taal Code Omschrijving Bewaren Nieuw Verwijderen Herstel
Sluiten
Omschrijving Dit is de ISO code om de taal aan te duiden. Een omschrijving van de taal. (Vrij te kiezen) Dit bewaart wijzigingen gemaakt aan de code of de omschrijving Dit voegt een nieuwe taal toe aan het systeem. Dit verwijderd een taal. (zie ook: De notie Logische verwijdering ) Indien een taal verwijderd is (logisch verwijderd) kan dit hiermee ongedaan gemaakt worden zodat de taal weer beschikbaar is om te gebruiken. Dit sluit het huidige scherm.
Opmerking: - Om een taal te wijzigen selecteer je deze in de lijst in het midden van het scherm. Indien deze taal in gebruik is (d.w.z. als er schermen of boodschappen zijn die in die taal vertaald zijn) dan kan je enkel de omschrijving ervan wijzigen. - Een taal verwijderen kan maar als ze niet meer in gebruik is.
12 juni 2006
64 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
13
Applicaties beheren: Boodschappen (Messages) Eenmaal je de taal gedefinieerd hebt kan je deze gebruiken om de boodschappen te vertalen in die taal. Deze beheersfunctie is toegankelijk via de lijst “Messages”.
Veld Applicatie Code Taal Boodschap Bewaren Nieuw Verwijderen Herstel
Sluiten Vast
Omschrijving Dit geeft de naam van de applicatie aan. Indien je een boodschap selecteert uit de lijst komt de “Code” hierin te staan. Dit is de taal waarin de boodschap vertaald is of dient vertaald te worden. Dit geeft de boodschap aan. Indien je wijzigingen gemaakt hebt kan je deze hiermee bewaren. Deze knop is niet toegankelijk. Dit verwijderd een boodschap. (zie ook: De notie Logische verwijdering ) Indien een boodschap verwijderd is (logisch verwijderd) kan dit hiermee ongedaan gemaakt worden zodat de taal weer beschikbaar is om te gebruiken. Dit sluit het huidige scherm. Aanduiding of deze boodschap verwijderd kan worden of niet. (systeem boodschap)
12 juni 2006
65 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
13.1
Boodschappen ophalen en bewerken De dropdown bevat een lijst met beschikbare talen. Kies eerst een taal uit deze lijst en druk vervolgens op “Ophalen”. Je zal nu een lijst te zien krijgen met de beschikbare boodschappen.
Hier zie je dezelfde elementen terugkomen die getoond worden bovenaan het scherm op het moment dat je een boodschap selecteert uit de lijst: Code, Boodschap, Vast. De andere opties hebben te maken met de historiek van gegevens (zie Wijzigingen aan gegevens (records) )
13.2
Boodschappen in een nieuwe taal vertalen. Als je een nieuwe taal hebt toegevoegd en je selecteert deze in de dropdown en drukt vervolgens op “Ophalen” zal de lijst leeg zijn. Op dit moment is de knop “aanmaken” beschikbaar en kan je de boodschappen “vertalen” in deze nieuwe taal. Dit wil zeggen dat er een copy genomen wordt van de engelse boodschappen en dat deze geplaatst worden in de database als zijnde boodchappen in de nieuwe taal. Op dit moment kan het (arbeidsintensieve) werk beginnen om de boodschapen te vertalen. Hiertoe selecteer je de boodschap uit de lijst en geef je een nieuwe vertaling in. Vervolgens druk je op “bewaren” om de wijzigingen definitief te maken.
12 juni 2006
66 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
14
Database model:
12 juni 2006
67 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
15 15.1
Voorbeelden: Voorbeeld van script uitvoer -- --------------------------------------------------- Script generated by FraClaDoc BackupScript (c) -- Provider : MySql -- Database : FraClaDoc -- Generated : 8/06/2006 12:29:41 -- Backup version : 1.0.0.0 --- -------------------------------------------------- -------------------------- Pre commands --- -----------------------SET FOREIGN_KEY_CHECKS=0 go -- --------------------------------------------------- Schema: FraClaDoc --- ------------------------------------------------Drop database if exists `FraClaDoc` go Create database `FraClaDoc` go Use FraClaDoc go -- --------------------------------------------------- Output of the Tables (19) --- -------------------------------------------------- -------------------------- Table: app_element_security --- -----------------------Drop table if exists `app_element_security` go Create Table `app_element_security` ( `app_name` VarChar(100) NOT NULL DEFAULT '', `profile` VarChar(75) NOT NULL DEFAULT '', `form_name` VarChar(50) NOT NULL DEFAULT '', `element_name` VarChar(50) NOT NULL DEFAULT '', `Allow` Enum('Y','N') NOT NULL DEFAULT 'Y', `DELETED` Enum('Y','N') NOT NULL DEFAULT 'N', `CRE_USER` VarChar(50) DEFAULT null, `CRE_TIME` DateTime DEFAULT null, `UPD_USER` VarChar(50) DEFAULT null, `UPD_TIME` DateTime DEFAULT null, PRIMARY KEY(`app_name`, `profile`, `form_name`, `element_name`) , KEY `app_name` (`app_name`), KEY `profile` (`profile`), KEY `form_name` (`form_name`), KEY `element_name` (`element_name`), KEY `CRE_USER` (`CRE_USER`), KEY `CRE_TIME` (`CRE_TIME`), KEY `UPD_USER` (`UPD_USER`), KEY `UPD_TIME` (`UPD_TIME`) ) ENGINE=InnoDB DEFAULT CHARSET=latin1 DEFAULT COLLATE=latin1_swedish_ci go
12 juni 2006
68 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
-- -------------------------- --> Constraints <--- -------------------------- -------------------------- --> Indexes <--- -------------------------- -------------------------- --> Foreign Keys <--- ------------------------Alter table `app_element_security` Add Constraint `app_element_security_ibfk_1` FOREIGN KEY(`profile`) REFERENCES `app_profiles`(`profile`) ON DELETE cascade ON UPDATE cascade go Alter table `app_element_security` Add Constraint `app_element_security_ibfk_2` FOREIGN KEY(`form_name`) REFERENCES `app_forms`(`form_name`) ON DELETE cascade ON UPDATE cascade go Alter table `app_element_security` Add Constraint `app_element_security_ibfk_3` FOREIGN KEY(`element_name`) REFERENCES `app_form_elements`(`element_name`) ON DELETE cascade ON UPDATE cascade go Alter table `app_element_security` Add Constraint `app_element_security_ibfk_4` FOREIGN KEY(`app_name`) REFERENCES `app_applications`(`app_name`) ON DELETE cascade ON UPDATE cascade go -- -------------------------- --> Triggers <--- ------------------------CREATE TRIGGER `BI_app_element_security` Before Insert on For Each Row BEGIN
`app_element_security`
if ((trim(new.CRE_USER) = '') or (new.CRE_USER is null)) then set new.CRE_USER := user(); end if; if ((new.CRE_TIME = '0000-00-00') or (new.CRE_TIME is null)) then set new.CRE_TIME = now(); end if;
set new.UPD_USER := null; set new.UPD_TIME := null; END go CREATE TRIGGER `BU_app_element_security` Before Update on For Each Row BEGIN if (new.app_name <> old.app_name or new.form_name <> old.form_name or new.profile <> old.profile or new.element_name <> old.element_name or new.Allow <> old.Allow or new.deleted <> old.deleted) then
`app_element_security`
if ((trim(new.UPD_USER) = '') or (new.UPD_USER is null)) then set new.UPD_USER := user(); end if; set new.UPD_TIME = now(); end if; END Go
12 juni 2006
69 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
-- -------------------------- Output data for : app_languages --- -----------------------Insert into app_languages(`CRE_TIME`,`friendly_name`,`Language`,`CRE_USER`,`DELETED`,`UPD_USER`,`UPD_TIME `) Values ('2006-05-18 12:56:51','Nederlands','NL','SYSTEM','N',null,null) go Insert into app_languages(`CRE_TIME`,`friendly_name`,`Language`,`CRE_USER`,`DELETED`,`UPD_USER`,`UPD_TIME `) Values ('2006-05-18 12:56:51','Français','FR','SYSTEM','N',null,null) go Insert into app_languages(`CRE_TIME`,`friendly_name`,`Language`,`CRE_USER`,`DELETED`,`UPD_USER`,`UPD_TIME `) Values ('2006-05-18 12:56:51','English','EN','SYSTEM','N',null,null) go -- -------------------------- Output data for : app_parameters --- -----------------------Insert into app_parameters(`CRE_TIME`,`Param`,`Fixed`,`Param_Val`,`DELETED`,`UPD_TIME`,`CRE_USER`,`Descri ption`,`UPD_USER`,`app_name`) Values ('2006-05-18 12:58:28','LoanDays','Y','30','N',null,'root@localhost','Het aantal dagen dat een gebruiker de beschikking heeft over geleende boeken.',null,'FraClaDoc') go Insert into app_parameters(`CRE_TIME`,`Param`,`Fixed`,`Param_Val`,`DELETED`,`UPD_TIME`,`CRE_USER`,`Descri ption`,`UPD_USER`,`app_name`) Values ('2006-05-18 12:56:51','BaseUrl','Y','http://Help.FraClaDoc.Dyndns.org/Maintenance','N',null,'SYSTEM','De basis url waar help ter beschikking staat.',null,'FraClaDocMaint') go Insert into app_parameters(`CRE_TIME`,`Param`,`Fixed`,`Param_Val`,`DELETED`,`UPD_TIME`,`CRE_USER`,`Descri ption`,`UPD_USER`,`app_name`) Values ('2006-05-18 12:56:51','AppCreated','Y','N','N',null,'SYSTEM','Vlag om aan te duiden of we de applicatie gecreeerd hebben. (app.forms)',null,'FraClaDocMaint') go
Insert into app_parameters(`CRE_TIME`,`Param`,`Fixed`,`Param_Val`,`DELETED`,`UPD_TIME`,`CRE_USER`,`Descri ption`,`UPD_USER`,`app_name`) Values ('2006-05-18 12:58:28','AppCreated','Y','N','N',null,'root@localhost','Vlag om aan te duiden of we de applicatie gecreeerd hebben. (app.forms)',null,'FraClaDoc') go -- -------------------------- Post commands --- -----------------------SET FOREIGN_KEY_CHECKS=1 Go
12 juni 2006
70 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
15.2
Voorbeeld van smart uitvoer <ApplicationConfig> <section name="General Information"> <entry name="Provider">MySql <entry name="Backup version">1.0.0.0 <entry name="Database name">FraClaDoc <entry name="Backup date">9/06/2006 7:46:07 <section name="FraClaDoc.Table.app_applications.Index.UPD_TIME"> <entry name="Fields">UPD_TIME <entry name="Name">UPD_TIME <entry name="Mysql_FullTextIndex">False <section name="FraClaDoc.Table.app_applications.Field.CRE_TIME"> <entry name="Type">6 <entry name="Nullable">True <entry name="Default">1 <entry name="Mysql_CharacterSet">0 <entry name="Precision">-1 <entry name="Length">-1 <entry name="Signed">2 <entry name="Mysql_AutoIncrement">False <entry name="Name">CRE_TIME <entry name="Mysql_Collation">0 <section name="FraClaDoc.Table.app_applications.RowData"> <entry name="Row_0_FieldName_9">Database_Name <entry name="Row_0_FieldName_2">description <entry name="Row_1_FieldName_2">description <entry name="Row_2_Value_4">root@localhost <entry name="Row_2_Value_5">FraCladoc.Client.Exe <entry name="Row_2_Value_2">FCDoc Test. <entry name="Row_0_FieldName_7">app_name <entry name="Row_2_Value_0">1/06/2006 13:45:06 <entry name="Row_2_Value_1">N <entry name="Row_0_Value_5">FraCladoc.Client.Exe <entry name="Row_0_Value_4">root@localhost <entry name="Row_0_Value_7">FraClaDoc <entry name="Row_2_Value_8">6.00.00 <entry name="Row_2_Value_9">test <entry name="FieldCount">10 <entry name="Row_0_Value_8">6.00.00 <entry name="Row_0_FieldName_3">UPD_USER <entry name="Row_0_FieldName_0">CRE_TIME <entry name="Row_0_FieldName_1">DELETED <entry name="Row_0_FieldName_6">UPD_TIME <entry name="Row_0_Value_0">18/05/2006 12:58:28 <entry name="Row_0_Value_1">N <entry name="Row_0_Value_2">Franciscus & Clara Documentatie. <entry name="Row_2_FieldName_8">app_Version <entry name="Row_2_FieldName_9">Database_Name <entry name="Row_0_Value_9">FraClaDocClient <entry name="Row_2_FieldName_7">app_name <entry name="Row_2_FieldName_0">CRE_TIME <entry name="Row_2_FieldName_1">DELETED <entry name="Row_2_Value_7">FraClaDocTest <entry name="Row_1_FieldName_9">Database_Name <entry name="Row_1_FieldName_8">app_Version <entry name="Row_2_FieldName_5">app_ExeName <entry name="Row_2_FieldName_6">UPD_TIME <entry name="Row_2_FieldName_3">UPD_USER <entry name="Row_2_FieldName_4">CRE_USER <entry name="Row_1_FieldName_3">UPD_USER <entry name="Row_2_FieldName_2">description <entry name="Row_1_FieldName_1">DELETED <entry name="Row_1_FieldName_0">CRE_TIME
12 juni 2006
71 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
<entry name="Row_1_FieldName_7">app_name <entry name="Row_1_FieldName_6">UPD_TIME <entry name="Row_1_FieldName_5">app_ExeName <entry name="Row_1_FieldName_4">CRE_USER <entry name="RowDataCount">3 <entry name="Row_1_Value_5">FraClaDoc.AppMaintenance.exe <entry name="Row_1_Value_4">SYSTEM <entry name="Row_1_Value_7">FraClaDocMaint <entry name="Row_1_Value_6">6/06/2006 7:14:46 <entry name="Row_1_Value_1">N <entry name="Row_1_Value_0">18/05/2006 12:56:51 <entry name="Row_1_Value_3">BE03873 <entry name="Row_1_Value_2">Programma om de meta-data van FraClaDoc (c) applicaties te onderhouden. <entry name="Row_0_FieldName_4">CRE_USER <entry name="Row_0_FieldName_5">app_ExeName <entry name="Row_1_Value_9">FraClaDoc <entry name="Row_1_Value_8">1.00.00 <entry name="Row_0_FieldName_8">app_Version <section name="FraClaDoc.Table.app_applications.Constraint.applicatie_name"> <entry name="Fields">app_name <entry name="Type">1 <entry name="Name">applicatie_name <section name="FraClaDoc.Table.app_applications.Index.UPD_USER"> <entry name="Fields">UPD_USER <entry name="Name">UPD_USER <entry name="Mysql_FullTextIndex">False <section name="FraClaDoc.Table.app_applications.ForeignKeys"> <entry name="Count">0 <section name="FraClaDoc.Table.app_applications.Field.UPD_USER"> <entry name="Type">3 <entry name="Nullable">True <entry name="Default">1 <entry name="Mysql_CharacterSet">6 <entry name="Precision">-1 <entry name="Length">50 <entry name="Signed">2 <entry name="Mysql_AutoIncrement">False <entry name="Name">UPD_USER <entry name="Mysql_Collation">12 <section name="FraClaDoc.Table.app_applications"> <entry name="Mysql_Engine">1 <entry name="Count of Indexes">4 <entry name="Mysql_CharacterSet">6 <entry name="Name">app_applications <entry name="Count of Fields">10 <entry name="Count of Foreign keys">0 <entry name="Count of Constraints">2 <entry name="Count of rows">3 <entry name="Mysql_Collation">12 <entry name="Count of Triggers">2 <section name="FraClaDoc.Table.app_applications.Trigger.BI_app_applications"> <entry name="Body">BEGIN if ((trim(new.CRE_USER) = '') or (new.CRE_USER is null)) then set new.CRE_USER := user(); end if; if ((new.CRE_TIME = '0000-00-00') or (new.CRE_TIME is null)) then set new.CRE_TIME = now(); end if;
12 juni 2006
72 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
set new.UPD_USER := null; set new.UPD_TIME := null; END <entry name="Name">BI_app_applications <entry name="Event">1 <section name="FraClaDoc.Table.app_applications.Field.CRE_USER"> <entry name="Type">3 <entry name="Nullable">True <entry name="Default">1 <entry name="Mysql_CharacterSet">6 <entry name="Precision">-1 <entry name="Length">50 <entry name="Signed">2 <entry name="Mysql_AutoIncrement">False <entry name="Name">CRE_USER <entry name="Mysql_Collation">12 <section name="FraClaDoc.Table.app_applications.Field.DELETED"> <entry name="Type">7 <entry name="Mysql_AutoIncrement">False <entry name="Nullable">False <entry name="Default">2 <entry name="Mysql_CharacterSet">6 <entry name="Precision">-1 <entry name="Length">-1 <entry name="Signed">2 <entry name="Mysql_SetValues">'Y'|'N' <entry name="Name">DELETED <entry name="Default_Value">'N' <entry name="Mysql_Collation">12 <section name="FraClaDoc.Table.app_applications.Field.description"> <entry name="Type">3 <entry name="Nullable">True <entry name="Default">1 <entry name="Mysql_CharacterSet">6 <entry name="Precision">-1 <entry name="Length">255 <entry name="Signed">2 <entry name="Mysql_AutoIncrement">False <entry name="Name">description <entry name="Mysql_Collation">12 <section name="FraClaDoc.Table.app_applications.Constraint.PRIMARY"> <entry name="Fields">app_name <entry name="Type">0 <entry name="Name">PRIMARY <section name="FraClaDoc"> <entry name="Terminator">go <entry name="Comment Marker">-- <entry name="Line Seperator"> <entry name="Count of Procs">0 <entry name="Parameter Marker">@ <entry name="Count of Tables">1 <entry name="Backtick">`|` <entry name="Schema Name">FraClaDoc <entry name="Count of views">0 <section name="FraClaDoc.Views"> <entry name="Count">0 <section name="FraClaDoc.Table.app_applications.Constraints"> <entry name="0">applicatie_name <entry name="1">PRIMARY <entry name="Count">2 <section name="FraClaDoc.Table.app_applications.Field.app_Version">
12 juni 2006
73 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
<entry name="Type">3 <entry name="Nullable">False <entry name="Default">0 <entry name="Mysql_CharacterSet">6 <entry name="Precision">-1 <entry name="Length">8 <entry name="Signed">2 <entry name="Mysql_AutoIncrement">False <entry name="Name">app_Version <entry name="Mysql_Collation">12 <section name="FraClaDoc.Table.app_applications.Indexes"> <entry name="2">CRE_TIME <entry name="3">UPD_TIME <entry name="0">UPD_USER <entry name="1">CRE_USER <entry name="Count">4 <section name="FraClaDoc.Table.app_applications.Triggers"> <entry name="0">BI_app_applications <entry name="1">BU_app_applications <entry name="Count">2 <section name="FraClaDoc.Table.app_applications.Field.app_name"> <entry name="Type">3 <entry name="Nullable">False <entry name="Default">2 <entry name="Mysql_CharacterSet">6 <entry name="Precision">-1 <entry name="Length">100 <entry name="Signed">2 <entry name="Mysql_AutoIncrement">False <entry name="Name">app_name <entry name="Default_Value">'' <entry name="Mysql_Collation">12 <section name="FraClaDoc.Table.app_applications.Index.CRE_TIME"> <entry name="Fields">CRE_TIME <entry name="Name">CRE_TIME <entry name="Mysql_FullTextIndex">False <section name="FraClaDoc.Table.app_applications.Field.Database_Name"> <entry name="Type">3 <entry name="Nullable">False <entry name="Default">0 <entry name="Mysql_CharacterSet">6 <entry name="Precision">-1 <entry name="Length">75 <entry name="Signed">2 <entry name="Mysql_AutoIncrement">False <entry name="Name">Database_Name <entry name="Mysql_Collation">12 <section name="FraClaDoc.Table.app_applications.FieldList"> <entry name="4">CRE_USER <entry name="3">UPD_USER <entry name="0">CRE_TIME <entry name="1">DELETED <entry name="6">UPD_TIME <entry name="7">app_name <entry name="Count">10 <entry name="5">app_ExeName <entry name="8">app_Version <entry name="2">description <entry name="9">Database_Name <section name="FraClaDoc.Tables"> <entry name="0">app_applications <entry name="Count">1
12 juni 2006
74 van 75
FraClaDoc Maintenance (c) Handleiding Versie: 1.0.0
<section name="FraClaDoc.Table.app_applications.Trigger.BU_app_applications"> <entry name="Body">BEGIN if (new.app_name <> old.app_name or new.description <> old.Description or new.deleted <> old.deleted) then if ((trim(new.UPD_USER) = '') or (new.UPD_USER is null)) then set new.UPD_USER := user(); end if; set new.UPD_TIME = now(); end if; END <entry name="Name">BU_app_applications <entry name="Event">0 <section name="FraClaDoc.Table.app_applications.Field.app_ExeName"> <entry name="Type">3 <entry name="Nullable">False <entry name="Default">0 <entry name="Mysql_CharacterSet">6 <entry name="Precision">-1 <entry name="Length">75 <entry name="Signed">2 <entry name="Mysql_AutoIncrement">False <entry name="Name">app_ExeName <entry name="Mysql_Collation">12 <section name="FraClaDoc.StoredProcedures"> <entry name="Count">0 <section name="FraClaDoc.Table.app_applications.Index.CRE_USER"> <entry name="Fields">CRE_USER <entry name="Name">CRE_USER <entry name="Mysql_FullTextIndex">False <section name="FraClaDoc.Table.app_applications.Field.UPD_TIME"> <entry name="Type">6 <entry name="Nullable">True <entry name="Default">1 <entry name="Mysql_CharacterSet">0 <entry name="Precision">-1 <entry name="Length">-1 <entry name="Signed">2 <entry name="Mysql_AutoIncrement">False <entry name="Name">UPD_TIME <entry name="Mysql_Collation">0
12 juni 2006
75 van 75