DT: 2bcj23S. Ministerie van Verkeer en Waterstaat. Rijkswaterstaat

DT: 2bcj23S

Ministerie van Verkeer en Waterstaat

Rijkswaterstaat

BIBLIOTHEEK

RljkSWateTStaat

MinisterievanVerkeerenWaterstaat

Bouwdiensi Rijkswatefst Post bus 20.000 3502 LA Utrecht

BIBLIOTHEEK BOUWDIENST RIJKSWATERSTAAT

NR. ...TiQSiiMXA

Kennisbank Beheer en Onderhoud Technische documentatie

24 november 2004

Documentnummer Status Datum Opsteller

: KBO-04020 : Definitief : 3 december 2004 : A.J.H. Kraakman (Infocus Management Consultants bv)

Functionaris

Naam

Opdrachtgever 1

J.P. Kottenhagen

Opdrachtgever 2

W . van Schelt

Bevoegd gezag

J.P. Kottenhagen

Projectleider

A. Heutink

Datum

Geaccepteerd

Inhoudsopgave

1.

Inleiding 4

2.

Technische gegevens 5

3.

Hosting & Support 7

3.1 3.2 3.3 3.4 3.5

Hosting 7 Support 7 BAS 7 PPS 7 Troubleshooting 8

4. 4.1 4.2 4.3 4.4 4.5 4.5.1. 4.5.2. 4.5.3. 4.5.4. 4.5.5. 4.6 4.6.1. 4.6.2. 4.6.3. 4.7 4.8 4.9 4.10

Structuur van de site 9 Directory structuur 9 Database 9 Login en privacy 10 Persoonlijke gegevens 11 Invalshoeken 11 Medewerkers 11 Projecten 12 Organisatie 12 Netwerk12 Werkproces 12 Invalshoek kennistermen 13 Woordenwolk 13 Kennistermen 13 Hulpmiddelen 14 Tellers 14 Menustructuur en opmaak 14 Informatiemenu 15 Hulpmiddelen 15

4.11

Beheer16

Bijlage A

Linkstructuur 17

Bijlage B

Databasemodel 19

3

Technische documentatie KBO

1.Inleiding Als onderdeel van het gebruikersonderzoek is een intranetsite ontwikkeld voor het beheren en ontsluiten van kennis op het gebied van Beheer en Onderhoud. In dit rapport wordt beknopt aangegeven waar de sources gevonden kunnen worden, hoe de site is opgebouwd e.d. Voor de ontwikkeling van de kennisbank is gebruik gemaakt van de prototyping methode. Dit houdt in dat telkens op aangeven van wensen en voorkeuren van de focusgroep een verbeterde versie werd opgeleverd en vervolgens uitgetest en beoordeeld. O m dit mogelijk te maken is gebruik gemaakt van eenvoudige hulpmiddelen die snel resultaten opleveren, zoals de tool VbsDb waarbij met een paar definitieregels al een complete databasebrowse pagina wordt verkregen. Deze tool heeft echter ook beperkingen waardoor in de definitieve versie toch ook afwijkende ASP-pagina's zijn gemaakt. Voor de rest is voornamelijk gebruik gemaakt veel gebruikte ontwikkeltalen zoals HTML, ASP, JavaScript, VBscript, CSS. Ten behoeve van de woordenwolk is een Flash object ontwikkeld die diverse parameters meekrijgt voor de aansturing (bgcolor, keyword, keywordcolor, keywordurl, keywordtarget, textsize, keyworddecoration, keywordovercolor)

4


2.Technische gegevens Specificaties van de site: • Microsoft Access 2000 database • HTML • ASP • JavaScript (client) • CSS • Flash 6 of 7 (client) • CDONTS (mail vanuit site versturen) De site draait op een webserver van Consortis met de volgende door hen opgegeven specificaties: • • • • • • • •

Microsoft W2000, Service Pack 3 SQL Server 2000, Service Pack 3 Frontpage Server Extensions 2000 M D A C 2.70.0.9001 Perl (Activestate, laatste versie is 5.8.0.806), anders build 631 IIS 5.0 lexplore 6.0 Coldfusion M X Professional Edition

Vereisten clientside met site op webserver: • IE 5.5 of hoger • Flash 6 of hoger • JavaScript Extra vereisten clientside standalone: • IIS 5.0 • Access 2000 of hoger (of MS Access drivers onder ODBC) • Webeditor (gebruikt is Frontpage) Aangezien het een pilot betreft is er voor gekozen om eenmalig een dump uit de adressengids en PPS te importeren en wordt geen verbinding met bestaande databases gelegd. In de applicatie wordt op verschillende plaatsen gebruik gemaakt van de tool VbsDb waarmee eenvoudig functionaliteit verkregen wordt voor het browsen en muteren van databases. Op een aantal plaatsen wordt echter ook gebruik gemaakt van afwijkende scripts waar VbsDb geen oplossingen bood. Voor documentatie met betrekking tot het gebruik van VbsDb verwijs ik naar de site van desbetreffende leverancier: http://www.vbsdb.com/sources/pages/documentation/default.asp Alle broncode is opgeslagen op de webserver van Consortis, inclusief de database. Voor de directory structuur wordt verwezen naar hoofdstuk 4. De database kan na downloaden van de webserver geopend worden d.m.v. MS Access (minimaal versie 2000).

5


Een gebruiker met beheerder rechten kan in de site zelf de servervariabelen opvragen onder de optie Informatie/Beheer/ServerVariabelen.

6


3.Hosting & Support 3.1

Hosting

De site wordt gehost door Consortis op een Windows2000 server. Er is een account beschikbaar gesteld waarmee via FTP de site gepubliceerd kan worden op de webserver. Het account is: UserlD: Password:

HEUTI500 tra999

Met een FTP applicatie kan verbinding gemaakt worden met de site door middel van het hostadres: intral .venwnet.minvenw.nl/rws/kbo

3.2

Support

Support calls dienen altijd via het iiloket van bureau Inter- en Intranet plaats te vinden: Bll Supportdesk , tel: 0800-0900123 [email protected] Bureau Inter- en Intranet. http://www.venwnet.minvenw.nl/rws/iiloket/ Die spelen de vraag dan weer door naar de supportdesk van Consortis:

3.3

BAS

Het adressenbestand is eenmalig (handmatig) t.b.v. het gebruikersonderzoek geimporteerd in de kennisbank. Het adressenbestand is verkregen via de helpdesk van de Bouwdienst, alsmede de beschikbare foto's. Het originele adressenbestand is een Access database en wordt op CD meegeleverd. Contactpersonen: De heer H. Boer

3.4

PPS

O m een goede aanzet te krijgen voor koppeling van medewerkers aan projecten is er een dump vanuit PPS beschikbaar gesteld met als selectiecriterium " P D " . De dump is via Excel handmatig geimporteerd in de kennisbank. De originele dump uit PPS/UVS is een Excel bestand en wordt op C D meegeleverd.

7


Contactpersonen: De heer S.E. (Stanley) Galistan De heer R.P.J. (Rob) van Rijn

3.5

Troubleshooting

1. Soms ligt de ASP-service er uit door overbelasting van de database (muteren) wanneer meerdere gebruikers gelijktijdig bezig zijn. Advies is om naar MSSQL over te stappen in een definitieve versie van de kennisbank. Vooralsnog herstart men dan de IIS service. Voor dit probleem kan rechtstreeks gecommuniceerd worden met de supportdesk van Consortis. 2. "Paarse schermen": storing m.b.t. de verbinding met of opvraging uit de database. Contact opnemen met de applicatiebeheerder.

8


4.Structuur van de site 4.1

Directory structuur

/kbo /db_onderhoud /flash /aquabrowser /include /asp /classes /kennis /fpdb /hitcounters /hoofdmenu /images /informatie /inhoudsopgave /login /medewerkers /netwerk /onderzoek /organisatie /producten [niet meer gebruikt] /projecten /start /vbsdb /vbsdb2002-7 /werkproces /zoeken [niet meer gebruikt]

4.2

Database

De database is een Access 2000 database die onder directory /fpdb staat. Het bevat de volgende hoofdtabellen: 3. Personen 4. Kennisvelden 5. KennisveldRelaties (onderlinge relaties tussen kennisvelden) 6. KennisveldTrefwoorden (thesaurus: gelijkende termen) 7. Projecten 8. Overleggen (diverse gremia) 9. Processen Verder zijn er de relatietabellen waarin de kennis en ervaring van medewerkers is vastgelegd: 1. Medewerkerkennis 2. MedewerkersProcessen 3. OverlegDeelnemers 4. ProjectBetrokkenen

9


Stamtabellen bevatten basisgegevens die op diverse plaatsen gebruikt worden: 1. Adressen 2. Afdelingen 3. Directie 4. Hoofdafdelingen 5. EnumErvaring 6. EnumSoort 7. KennisHoofdvelden 8. LeeftijdsCategorien 9. OverlegRollen 10.OverlegTypen 11.ProjectStatussen Voor het gebruikersonderzoek zijn de volgende tabellen in gebruik: 1. CebruikersOnderzoek 2. GebruikersOnderzoekAntwoorden 3. OnderzoeksRubrieken 4. OnderzoeksVragen 5. EnumAntwoorden 6. Berichten Tenslotte t.b.v. het registreren en meten van de bezoekende gebruikers: 1. tbIHitCount 2. tbIHitCountUsers 3. tbIHitCountUsersLog Verder zijn er diverse voorgedefinieerde query's aanwezig die in verschillende ASP pagina's gebruikt worden. In bijlage B is een datamodel opgenomen waarin de belangrijkste entiteiten zijn weergegeven.

4.3

Login en privacy

Het gebruik van de kennisbank staat een ieder vrij. Het invullen van je kenniskaart en meedoen aan het gebruikersonderzoek kan echter alleen na het inloggen m.b.v. een uitgegeven gebruikersnaam en wachtwoord. Na het inloggen worden een aantal session variabelen ingesteld die in de site gebruikt worden om de gebruiker zijn eigen gegevens te tonen of als default aan te bieden bij het koppelen van kennis en ervaring. De eerste keer wordt na het inloggen een statement getoond over privacy. Hier dient de gebruiker aan te geven of hij of zij akkoord is. Zo nee, dan wordt de gebruiker weer uitgelogd. Session variabelen: SessionC'usr")

10


gebruikersnaam

SessionC'PersID") SessionC'mgr") SessionC'blnlsUserGood") SessionC'privOk") SessionC'privOkFoto")

unieke ID in tabel Personen beheerder (true/false) correct ingelogd (true/false) akkoord privacy statement akkoord tonen foto

Wanneer een gebruiker niet in de database is opgenomen kan hij of zij zich als een nieuwe gebruiker aanmelden. Indien iemand aangeeft bij PD te horen is het ook mogelijk aan het gebruikersonderzoek mee te doen. De gebruikte pagina's zijn: /start/home.asp /Login/check_user.asp /Login/check_user_new.asp /Login/newlogin.asp /Login/PrivacyStatement.asp /Medewerkers/medewerkerAdd.asp /lnformatie/toevoegen_onderzoeker.asp

4.4

Persoonlijke gegevens

Onder deze knop kan de gebruiker zijn gegevens uit de adressengids (BAS) aanvullen met kennis en ervaring waarbij een aantal blokken onderscheiden worden, te weten: kennistermen, projecten, producten, netwerk, onderdelen en werkproces. Er zijn 2 invoermethoden beschikbaar: 1. De lijstmethode waarbij alle beschikbare kennistermen worden getoond en aangepast kunnen worden. 2. De recordmethode waarbij 66n enkel gegeven aangepast wordt. De gebruikte pagina's zijn: /Medewerkers/medewerkerWijzig.asp /Medewerkers/lnvullenKennistermen.asp /Medewerkers/lnvullenKennistermenUpdate.asp /Medewerkers/kennistermen_help.asp /Medewerkers/netwerkjielp.asp /Medewerkers/onderdelen_help.asp /Medewerkers/producten_help.asp /Medewerkers/projecten_help.asp /Medewerkers/werkprocesjielp.asp

4.5

Invalshoeken

4.5.1. Medewerkers In de database zijn (eenmalig) alle PD medewerkers geimporteerd. Ook zijn de foto's gekoppeld aan de medewerkers.

11


/Medewerkers/medewerkers.asp Filteren en zoeken van medewerkers op alfabet of op andere zoekargumenten. Resultaat in lijstvorm. /Medewerkers/medewerkerDetail.asp Data- en kenniskaart van de gevonden/geselecteerde medewerker. 4.5.2. Projecten In de database zijn (eenmalig) alle PPS projecten voor PD geimporteerd. Er kan gezocht en gefilterd worden op naam, dienst enz. waarna het zoekresultaat bestaat uit gevonden projecten. Door op het project te klikken worden de details getoond. /Projecten/projecten.asp /Projecten/projectdetail.asp 4.5.3. Organisatie Via organogrammen kunnen gebruikers via hotspots doorklikken naar een volgend onderdeel waarna als zoekresultaat alle medewerkers worden getoond van die afdeling. /Organisatie/organisatie.asp /Organisatie/organisatieBS.asp /Organisatie/organisatieDl.asp /Organisatie/organisatieNl.asp /Organisatie/organisatiePD.asp /Organisatie/organisatieWB.asp /Organisatie/medewerkers.asp /Organisatie/*.gif

4.5.4. Netwerk Zoeken, aanmaken en wijzigen van overleggremia. Per item worden de medewerkers getoond die daar een rol in hebben Overleggen.asp 4.5.5. Werkproces Via processchema's kunnen gebruikers via hotspots doorklikken naar een volgende onderdeel waarna als zoekresultaat alle medewerkers worden getoond die ervaring hebben op het betreffende gebied. /Werkproces/werkproces.asp /Werkproces/werkprocesJA.asp /Werkproces/werkproces_OAO.asp /Werkproces/werkproces_OBO.asp /Werkproces/medewerkers.asp /Werkproces/*.jpg

12


4.6

Invalshoek kennistermen

In de database zijn initieel een 100-tal kennistermen ingebracht die door gebruikers aangevuld kunnen worden. Voor het zoeken naar kennis wordt gebruik gemaakt van een woordenwolk, een flashapplicatie die gegevens uit de database haalt. 4.6.1. Woordenwolk /Flash/aquabrowser/aqua.asp Gedeelte waarin de flashapplicatie draait en geinitialiseerd wordt. /Flash/aquabrowser/browser.swf /Flash/aquabrowser/browser_SysFonts.swf Twee varianten voor de flashapplicatie zelf: een met schaalbare lettertypen en €en met systemfonts. /Flash/aquabrowser/dataObj.asp Deze pagina wordt aangeroepen vanuit de flashapplicatie om gegevens uit de database te halen nadat de gebruiker een actie word heeft aangeklikt. /Flash/aquabrowser/index.asp Frameset met aqua, links, rechts en page /Flash/aquabrowser/links.asp Middenbalk links: zoekterm typen of uit lijst selecteren /Flash/aquabrowser/page.asp Zoekresultaat medewerkers /Flash/aquabrowser/rechts.asp Weergave zoekhistorie woordenwolk. De laatste 5 zoekstappen worden getoond. O p elk van die stappen kan weer geklikt worden. 4.6.2. Kennistermen Een gebruiker kan zelf kennistermen die ontbreken toevoegen in: /Flash/kennis/kennisveldrelaties.asp Hierin kunnen nieuwe kennistermen aangemaakt worden, relaties met andere kennistermen worden gelegd en synoniemen worden ingevoerd. Deze zijn zonder tussenkomst van de beheerder echter alleen voor hemzelf zichtbaar.

13


4.6.3. Hulpmiddelen /Flash/include/asp/adovbs.inc /Flash/include/classes/DbClass.asp

4.7

Tellers

Een aantal relevante pagina's zijn voorzien van tellers om het gebruik van de site te kunnen meten en analyseren. Er wordt op 3 niveaus geregistreerd: 1. Aantal hits per pagina 2. Aantal hits per pagina per gebruiker 3. Totale log van de ingelogde gebruiker /Hitcounters/hit_count.inc /Hitcounters/admin.asp /Hitcounters/reset_counter.asp De tellers zoals genoemd onder 2 en 3 zijn vooral bedoeld voor metingen t.b.v. het gebruikersonderzoek. Bij een definitieve versie van de kennisbank kunnen deze beter uitgezet worden i.v.m. de belasting van de server.

4.8

Menustructuur en opmaak

/Default.htm /bovenbalk.htm /mainset.html /startO.htm /startl.htm /start/home.asp /start/zoek.asp /Hoofdmenu/vaandel.asp /Hoofdmenu/vaandel.htm

kruimelpad bouwdienst menu

/lnhoudsopgaven/inhoudsopgave_beheer.htm speciaal menu alleen toegankelijk voor gebruikers in de database die aangemerkt zijn als beheerder /lnhoudsopgaven/inhoudsopgave_zoek.asp /Inhoudsopgaven/inhoudstart.htm /Inhoudsopgaven/startBeheer.asp controle en opstarten beheergedeelte van de kennisbank /Inhoudsopgaven/startGO.asp controle en opstarten gebruikersonderzoek kennisbank

14


/opmaak.css /opmaak_inhoud.css /opmaak_bovenbalk.css /opmaak_vaandel.css cascade style sheets waarin de layout van de site wordt vastgelegd

4.9

Informatiemenu

/Informatie/contactinformatie.asp informatiepagina projectbetrokkenen /Informatie/faq.asp /lnformatie/faq_vraag.asp gestelde vragen via het systeem kunnen door een beheerder aangemerkt worden als geschikt voor de faq waarna ze voor alle bezoekers zichtbaar zullen zijn. /Informatie/help.asp beschrijving van de werking van de algemene onderdelen van de kennisbank. /Informatie/intro.asp korte introductie doel van de kennisbank

4.10

Hulpmiddelen

/global.asa Database connectiestring (bij laden van de site) /frameset.js /framesetO.js /frameset2.js /frameset_beheer.js Laden juiste en gehele frameset bij aanroep subpagina. /vbsdb Hulpmiddel voor databasebrowsing, laatste versie /vbsdb2002-7 Hulpmiddel voor databasebrowsing, voorlaatste versie ook nog nodig in verband met bug in laatste versie bij add single mode.

15


4.11

Beheer

/db_onderhoud/berichten.asp Pagina voor het aanmaken van berichten (via email) voor deelnemers aan het gebruikersonderzoek, batch of persoonlijk. Maakt gebruik van CDONTS. /db_onderhoud/faq_onderhoud.asp Onderhoud binnengekomen vragen en eventueel beschikbaar stellen voor F A Q . /db_onderhoud/onderzoekWijzig.asp Onderhouden van de rubrieken en vragen van het gebruikersonderzoek. Tevens weergave antwoorden gebruikers bij de betreffende vragen. /db_onderhoud/personen_onderzoek.asp Statusoverzicht gebruikersonderzoek per deelnemer, overzicht beantwoording vragen. /db_onderhoud/personen_wijzigen.asp Onderhouden van de medewerkertabel. O . a . toestaan deelname aan gebruikersonderzoek en wijzigen wachtwoord.

16


Bijlage A

Linkstructuur

Bij het opstarten van de site wordt onderstaande set geactiveerd: /Default.htm {Frameset} /Bovenbalk.htm /StartO.htm {Frameset} /Hoofdmenu/vaandel.htm {Frameset} /lnhoudsopgaven/inhoudsopgave_zoek.asp mainset.html start/home.asp Vanuit de menubalk aan de linkerzijde kunnen de volgende links gevolgd worden: /lnhoudsopgaven/inhoudsopgave_zoek.asp /Medewerkers/medewerkers.asp /Flash/aquabrowser/index.asp /Organisatie/organisatie.asp /Projecten/projecten.asp /Netwerk/overleggen.asp /Werkproces/werkproces.asp /Medewerkers/medewerkerWijzig.asp /startGO.asp /start/home.asp of /afmelden.asp /Inhoudsopgaven/inhoudstart.htm + /Informatie/intro.asp /Informatie/help.asp Wanneer op informatie is geklikt komt er een nieuwe keuzekolom: /Inhoudsopgaven/inhoudstart.htm /Informatie/intro.asp /Informatie/contactinformatie.asp /Login/PrivacyStatement.asp /I nf ormatie/f aq .asp /Inhoudsopgaven/startBeheer.asp /lnformatie/faq_vraag.asp /Inhoudsopgaven/inhoudsopgave zoek.asp /Informatie/help.asp Bij keuze voor "beheer" in bovenstaand menu een nieuwe keuzekolom: /Inhoudsopgaven/startBeheer.asp /db_onderhoud/Rubrieken.asp /db_onderhoud/faq_onderhoud.asp /db_onderhoud/personen_wijzigen.asp /db_onderhoud/project_wijzigen.asp /Hitcounters/admin.asp /db_onderhoud/ServerVariables.asp

17


/db_onderhoud/onderzoekWijzig.asp /db_onderhoud/personen_onderzoek.asp /db_onderhoud/berichten.asp /Inhoudsopgaven/inhoudstart.htm + /Informatie/intro.asp

18


Bijlage B

Databasemodel

Projecten

Afdelingen

Processen

Projectbetrokkenen

Personen

Medewerkerprocessen

Overlegdeelnemers

Medewerkerkennis 7R

Kennisniveau

JT Kennissoort

Overle;ggen

Kennisvelden

•> Trefwoorden

ii

Overlegtypen

Kennishoofdvelden

Onderlinge relaties KV

Gebruikersonderzoek

Onderzoek Antwoorden

Onderzoeksvragen

Onderzoeksrubrieken

19


DT: 2bcj23S. Ministerie van Verkeer en Waterstaat. Rijkswaterstaat

Recommend Documents