Prettylib-tuoteratkaisut - Wiki

Toisen tietokannan lisääminen hakulomakkeineen

Instanssit

Huom: On myös mahdollista tehdä PrettyLibServeristä ns. uusi instanssi, joka on täysin erillinen palvelimella toimiva palvelu. Tällainen voi tulla kyseeseen, jos useisiin tietokantoihin pääsy halutaan rajata erikseen. Tutustu erillisiin artikkeleihin instansseista.

PrettyLibServer tukee samanaikaisesti useita tietokantoja ja useita kieliä. Tämä tuki on toteutettu ns. profiileilla

Yksittäinen profiili on sidottu kieleen ja tietokantaan. Lisäksi profiili voidaan sitoa edellämainittujen lisäksi myös yksittäisen tietokannan toimipisteeseen.

Tässä artikkelissa käydään läpi toisen tietokannan lisääminen ja sen profiilin käyttöönotto.

Tietokannan lisääminen

Tässä artikkelissa ei käydä läpi tietokannan palauttamista tai luomista, katso PrettyLib-artikkeleista.

Uuden tietokannan lisääminen PrettyLibServeriin käy seuraavasti:

  1. Avaa PrettyBitServer-palvelimella asetusohjelma "Search Settings for PrettyLib 4".
  2. Valitse sen välilehti "Global".
  3. Valitse "Databases" valintalistan vierestä "New".
  4. Syötä tietokantapalvelimen ja tietokannan nimi.
  5. Valitse tarvittavat sisäänkirjautumis yms. toiminnot
  6. Valitse "Test connection", jotta näet että tietokanta toimii.
  7. Valitse "Ok"

Katso "Databases" listasta uuden luomasi tietokannan vieressä oleva järjestysnumero, tarvitset sitä myöhemmin.

Uuden profiilin lisääminen toista tietokantaa varten

Toista tietokantaa varten tulee yleensä tehdä täysin oma hakulomakkeensa ja siihen liittyvät muut profiili-tiedostot (ns. template-tiedostot).

Hakulomakkeen luominen


Tässä osiossa otamme kopion olemassaolevasta hakulomakkeesta.

  1. Avaa tiedostohallinta ja mene PrettyLibServerin kansioon wwwroot.
  2. Kopioi jokin olemassaolevista hakulomakepoluista (esimerkiksi "fin", jos olet tekemässä Suomenkielistä)
  3. Tee kopiosta jokin selkeästi nimetty. Tässä esimerkissä luo kopio wwwroot kansion alle kansioon "fin2"

Palaamme hakulomakkeen muokkaamiseen uudelleen profiilin luonnin jälkeen.

Uuden profiilin lisääminen

Tässä luomme uuden profiilin.

  1. Valitse "Search Settings for PrettyLib 4" ohjelman välilehti "Profiles"
  2. Valitse "Edit profiles"
  3. Valitse "New"
  4. Kirjoita "Profilename" kohtaan 4-kirjaiminen tunnus profiilille. Tässä esimerkissä "FIN2".
  5. Valitse "Copy from" kohtaan valinta "FIN" (teemme esimerkissä kopiota perus suomenkielisestä profiilista FIN)
  6. Valitse "Ok"
  7. Valitse "Close"
  8. Valitse "Save"

Hakulomakkeen muokkaaminen

Muokkaamme hakulomaketta uutta profiilia varten.

  1. Avaa tiedostonhallinnassa PrettyLibServerin kansio wwwroot
  2. Avaa tiedostonhallinnassa "fin2" kansio, poista mahdollisesti tarpeettomia tiedostoja.
  3. Avaa kansion hakulomake (oletuksena "search.htm") esimerkiki "Notepad"-ohjelmaan
  4. Etsi sivun yläosasta linkkejä, joissa lukee alussa "/lib4/src" (vanhoissa alkuperäisasennuksissa myös /src pelkästään)
  5. Muokkaa jokaisesta linkista seuraavat parametrit
    1. DATABASE=1 -> DATABASE=2 (olettaen että tietokannan lisäysvaiheessa uuden tietokannan järjestysnumeroksi tuli 2)
    2. PROFILESET=FIN -> PROFILESET=FIN2
  6. katso onko sivun ylälaidassa muita linkkejä, jotka osoittaisivat polkuun "/fin/", muuta ne osoittamaan polkuun "/fin2/"
  7. Etsi hakulomakkeelta kohta "FORM".
  8. Muuta FORM-elementin sisältä seuraavia piilotettuja (HIDDEN) INPUT-kenttiä.
    1. DATABASE - muuta kentän arvona oleva numero numeroksi, jonka otit ylös tietokannan lisäämisvaiheessa (esim 2).
    2. PROFILESET - muuta kentän arvona oleva profiilitunnus luomaksesi uudeksi profiiliksi "FIN2".
  9. Tallenna muutokset

Profiilin templatetiedostojen muokkaaminen

Muokkaamme hakuprofiilin tiedostoja.

  1. Avaa tiedostonhallinnassa PrettyLibServerin kansio HTML
  2. Avaa alikansio FIN2
  3. Avaa tiedosto lib_headers.inc
  4. Suorita tiedostoon samat linkkien muutokset, jotka teit hakulomakkeelle
  5. Tallenna muutokset
  6. Tarkista avaamalla esim. start1.htm, että se tosiaan käyttää ylläolevaa lib_headers.inc tiedostoa, eli tiedostosta löytyy sellainen rivi, jossa näkyy tuo "lib_headers.inc" teksti tietyn kommenttimuotoilun sisällä:
  7. Mikäli lib_headers.inc tiedostoa EI käytetä, vaan linkit ovat jokaisessa start-alkuisessa tiedostossa kiinteästi sisällä, joudut muuttamaan jokaisen erikseen alkaen start1.htm ja päätyen start10.htm tiedostoon.

Haun testaaminen

Avaa selaimeen http://prettybitserverinosoite:portti/fin2/search.htm ja tee haku. Varmista, että haku toimii ja tekee haun oikeasta tietokannasta.

Asetusten muokkaaminen

  1. Avaa Search Settings for PrettyLib 4
  2. Valitse "Profile" valinnasta "FIN2".
  3. Muuta astuksia tarpeen mukaan. Voit esim pakottaa tämän profiilin käyttämään tietokantaa 2 vaikka yllä muutetuissa linkeissä jotain muuta määritettäisiin. Toimi seuraavasti:
    1. Valitse välilehti "Security"
    2. Muokkaa kenttää "Force database" kohdan "Restrictions" alta. Laita siihen tietokannan numero, esimerkissämme "2".
  4. Tallenna asetukset