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

...