Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Vaatimukset

DigitalBooker -integraatio Sähköinen ajanvarausjärjestelmä DigitalBooker.
Integraatio vaatii seuraavat komponentit käyttöönsä:

  • SKJScript -lisenssi
  • Uudehko (05/2017) SKJ-versio
  • DigitalBooker tunnukset (api-avaimien tekemiseen)
  • DigitalBooker -apiavaimet
    • Mene DigitalBookerissa hallintaan
    • Ota sieltä API-avaimet
    • Näet tässä API-osoitteen, ota se talteen
    • Lisää uusi API-avain ja anna tälle kuvaava nimi
    • Ota tunniste ja salasana talteen

Toiminta

Liittymä hakee DigitalBookerista DigitalBookerin APIa käyttäen varauksia ja niiden sisältämiä asiakastietoja.

...

Tämän jälkeen löydetylle (tai perustetulle) asiakkaalle lisätään asiakasteksteihin uusi otsikko muodolla YYYY-MM-DD HH:MM - Tuote eli esimerkiksi '2017-05-02 13:00 - Palvelutyö'. Tämän jälkeen tuon tekstiotsikon alle voidaan syöttää käynnin muistiinpanot.

Käyttöönotto

  1. Hae digitalbooker.pas ja digitalbookerconfig.pas tiedosto käyttöösi (saat nämä tilauksen yhteydessä) ja tallenna tiedostot winskj-hakemistoon
  2. Muokkaa digitalbookerconfig.pas -tiedostoa esim notepadillä ja aseta sinne asetukset:

    Code Block
      dbname := 'TIETOKANTA'; // Tietokanta, johon tietoja päivitetään
      bookingsurl := '/ZZZ/fi/api/bookings'; // apin tarkempi endpoint
      getdays := 10; // kuinka monen päivän ajalta haetaan tietoja
      user := 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'; // api user
      pass := 'YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY'; // api pass


    1. SKJ-tietokannan nimi määritellään käyttäjän ympäristön mukaan
    2. bookingsurl, user ja pass -tiedot saat DigitalBookerilta:
      1. bookingsurl on siis API-osoite ilman https://varaaheti.fi -alkua
      2. user on tunniste
      3. pass on salasana
    3. Määritä kuinka monen päivän tiedot aina kerralla haetaan
      1. Jos tietoja haetaan esim päivittäin, teoriassa tähän riittäisi 1 päivä, mutta vikasietoisuuden takia se kannattaa olla hieman enemmän
  3. Tallenna tiedosto

...

  1. Lisää skj.ini-tiedostoon seuraavat rivit:

    Code Block
    [PAINIKE1]
    Tyyppi=SUORITA
    Otsikko=Hae$Digital$Booker
    Parametri=c:\winskj\skjscript.exe;/F:digitalbooker.pas /RUN
    Fonttinimi=Arial
    Fonttikoko=8
    
    [PAINIKE2]
    Tyyppi=SUORITA
    Otsikko=Digital$Booker$loki
    Parametri=c:\winskj\tail.exe;-f -n 50 skjscript.log
    Fonttinimi=Arial
    Fonttikoko=8
  2. Ensimmäinen nappi siis suorittaa varsinaisen liittymän ja toisesta napista saadaan lokitiedostot näkyviin (mm. vikatilanteiden selvittämistä varten)

  3. Napit näkyvät seuraavasti päävalikossa:



Show if
groupskj-developers

Näkyy vain skj-developers: https://stash.skj.fi/projects/SKRIP/repos/viralliset/browse/digitalbooker