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
- Hae digitalbooker.pas ja digitalbookerconfig.pas tiedosto käyttöösi (saat nämä tilauksen yhteydessä) ja tallenna tiedostot winskj-hakemistoon
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
- SKJ-tietokannan nimi määritellään käyttäjän ympäristön mukaan
- bookingsurl, user ja pass -tiedot saat DigitalBookerilta:
- bookingsurl on siis API-osoite ilman https://varaaheti.fi -alkua
- user on tunniste
- pass on salasana
- Määritä kuinka monen päivän tiedot aina kerralla haetaan
- 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
- Tallenna tiedosto
...
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
Ensimmäinen nappi siis suorittaa varsinaisen liittymän ja toisesta napista saadaan lokitiedostot näkyviin (mm. vikatilanteiden selvittämistä varten)
- Napit näkyvät seuraavasti päävalikossa:
Show if | ||
---|---|---|
| ||
Näkyy vain skj-developers: https://stash.skj.fi/projects/SKRIP/repos/viralliset/browse/digitalbooker |