Loikkaa: valikkoon, hakuun

Kustomoitujen lisätietokenttien käyttö

Versio hetkellä 14. elokuuta 2024 kello 11.25 – tehnyt Ajaswiki (keskustelu | muokkaukset)

Oletus -lisätietokenttä

Nettivaraus 6:n asiakkaan varauslomakkeella on oletuksena yksi lisätietokenttä "Lisätietoa".

Oletus-lisatietokentta.png

  • Kenttä on oletuksena vapaaehtoinen.
  • Sen voi asettaa pakolliseksi kohdassa: Ylläpito - Asetukset - Ajanvarauksen asetukset -valitse toimipiste - Käyttäytyminen-laatikko: Pakollinen lisätietokenttä -> Kyllä.
  • Asiakkaan kirjoittamat tiedot näkyvät Ajas Touchin varauslomakkeella kohdassa : Lisätiedot
  • Asiakkaan kirjoittamat tiedot voivat näkyä myös varausvahvistus -sähköpostissa, jos viestipohjassa on koodi:
 {lisatiedot}


Jos et halua näyttää oletuksena näkyvää "Lisätietoa" kenttää, sen voi piilottaa CSS-koodilla kohdassa: Ylläpito - Asetukset - Nettivarauksen käyttäytyminen - Luo oma teema . Teema-editoriin kirjoitetaan:

div.form-group.additional-info-group {display: none;}

Huom: Tarkista ennen kentän piilotusta, että kenttää ei ole asetettu pakolliseksi Ajanvarauksen asetuksissa. Jos pakollinen kenttä piilotetaan, asiakkaat eivät pysty tekemään varauksia nettisivuillasi, koska pakollinen tieto puuttuu.

Kustomoitu lisätietokenttä

Ajas Touchissa on ns. piilotettuja asetuksia, joita tilin pääkäyttäjä voi ottaa käyttöön. Toiminnot löytyvät Touchin config-extra -näkymästä, ja sen osoite on: https://hallinta.ajas.fi/#/dashboard/config-extra

Toiminnon käyttö edellyttää pääkäyttäjäkirjautumista, ja sivun muokkaamiseen tarvitaan oma salasana. Pääkäyttäjä voi pyytää salasanan : asiakaspalvelu (at) ajas.fi.

Ohjeet config-extra -sivun käyttöön kohdassa: LINKKI.

Kustomoidut lisätietokentät tallennetaan config-extra -sivulle json-koodilla.

  • Esimerkkejä valmiista koodista löytyy kohdassa: LINKKI.
  • Edistyneen käytön ohjeita koodin käytöstä dokumentissa: (YHTEISÖÖN?)

https://docs.google.com/document/d/17ZHSlnZmXSdfovZJxw4EvYiUZXT2J-JUO3yhmZ9cTe0/edit#heading=h.mvk6c2hpw9q1

Esimerkki: Otsikko ja lyhyt tekstikenttä

Json-lisatietokentta1.png

  • Esimerkissä on käytetty tyyppejä "heading" eli otsikko (Jos sinulla on tarjouskoodi, syötä se tähän:) ja "short-text" eli lyhyt vapaa teksti -kenttä (Alennus lasketaan paikan päällä.).
  • Vastauksen antamiskenttä on jälkimmäinen, ja sen ID-tunnukseksi on valittu: "kampanjakoodi". ID-tunnuksen voi itse määritellä, kunhan se on yksilöllinen. Erikoismerkkien käyttämistä kannattaa välttää.
  • Vastauskenttää ei ole määritelty pakolliseksi ("required": false). Jos se halutaan pakolliseksi, kirjoitetaan: "required": true
  • Käytetty koodi on:
[
  {
        "id": "lisatiedot_otsikko",
        "name": {
            "fi": "Jos sinulla on tarjouskoodi, syötä se tähän:",
            "en": "If you have a promo code, enter it here:",
            "sv": "Om du har en kampanjkod, ange den här:"
        },
        "type": "heading"
    },
  
  {
    "id": "kampanjakoodi",
    "name": {
      "fi": "Alennus lasketaan paikan päällä.",
      "en": "The discount is calculated on the spot.",
      "sv": "Rabatten beräknas på plats."
    },
    "type": "short-text",
    "required": false
  }    

]

Jos englannin ("en") tai ruotsin ("sv") -kielistä käännöstä ei ole määritelty, asiakasnäkymä käyttää näissäkin kieliversioissa suomen ("fi") kielistä tekstiä.

Jos asiakkaan kirjoittama vastaus halututaan tulostuvaksi ilmoitus-, vahvistus- tai muistutus -viesteihin, "id": "kampanjakoodi" -lisätietokenttään viitataan viestipohjassa seuraavasti:

Kampanjakoodi:

{#kampanjakoodi}


Ajas Touchin varauslomakkeelle tallentunut vastaus:

Json-lisatietokentta2.png

Esimerkki: Hallivaraus

Hallivaraustoimintojen käyttöönotto:

  • Hallivarauksiin käytetään asiakasnäkymän tyyppiä: Taulukko.
  • Sitä voi käyttää normaali asetusvalinnoilla, mutta hallivaraksia varten on saatavana muutamia lisätoimintoja.
Varausnäkymän julkinen tieto
  • Asiakkaan varausnäkymään voi asettaa julkiseksi tiedoksi, että aika on "Varattu".

Jos haluat näyttää julkista tietoa asiakasnäkymässä, ota yhteyttä: asiakaspalvelu (at) ajas.fi.

  • Edellisen lisäksi, asiaksnäkymässä voi näyttää kustomoituihin lisätietokenttiin kirjoitettuja tietoja. Nämä lisäkentät tehdään JSON-koodilla.
  • Kun julkisen tiedon ominaisuus on kytketty päälle, varausnäkymässä lukee "Varattu", jos asiakas ei ole vastannut varauslomakkeella julkisiin lisätietokenttiin. Tai siinä voi lukea asiakkaan valitsema vastaus.

Hallivaraus-nakyvat.png

1) Asiakas on vastannut lisätietoon: "Julkinen nimi" ja rastittanut kohdan "Yleisölle avoin tapahtuma".
2) Asiakas on vastannut lisätietoon: "Julkinen nimi".
3) Asiakas ei ole vastannut julkisiin tietoihin.
4) Aika ei ole varattavissa vuoron, aukiolon, menneen ajan tms. vuoksi..
5) Aika on varattavissa.

Esimerkki varauslomakkeesta
Esimerkkiin on lisätty julkisen tiedon lisäksi erilaisia muita vaihtoehtoja, jotta koodiesimerkeistä tulee monipuolisemmat.

Halli-julkinen-muut1.png

1) Varaajan julkinen nimi: vapaaehtoinen, lyhyt tekstikenttä.

  • Tekstikentän pituus on rajattu 2 ja 10 merkin välille koodissa näkyvillä "maxlength" ja "minlenght" -arvoilla.
  • Lisätietokenttä on rajattu "officeIds" -määrityksellä näkymään vain toimipiseessä, jonka ID-tunnus on 68.
  • Julkiseksi, eli kaikille varaajille näkyväksi sen tekee koodi: "visibleCustomerBookingView": true,

2) Yleisölle avoin tapahtuma: vapaaehtoinen, rastitettava kenttä.

  • Lisätietokenttä on rajattu "officeIds" -määrityksellä näkymään vain toimipiseessä, jonka ID-tunnus on 68.
  • Julkiseksi, eli kaikille varaajille näkyväksi sen tekee koodi: "visibleCustomerBookingView": true,

3) Tarvitsen esteettömän kulkuväylän pyörätuolille: vapaaehtoinen, rastitettava kenttä. Kenttä ei ole julkinen ja se näkyy kaikissa toimipisteissä.
4) Asiakaskysely (valinnainen): Otsikko, tyyppiä "type": "heading"
5) Vapaaehtoinen lyhyt tekstikenttä.
6) Vapaaehtoinen pudotusvalikko.
7) Vapaaehtoinen pudotusvalikko.

Käytetty koodi on:

[
    {
        "id": "publicName",
        "name": {
            "fi": "Julkinen nimi (2-10 merkkiä)",
            "en": "Public name (2-10 characters)",
            "sv": "Offentligt namn (2-10 tecken)"
        },
        "type": "short-text",
        "required": false,
        "visibleCustomerBookingForm": true,
        "visibleCustomerBookingSuccessful": true,
        "visibleCustomerBookingView": true,
        "visibleTouchBookingForm": true,
        "showOnInvoice": true,
        "maxlength": 10,
        "minlength": 2,
        "officeIds": [68]
    },

    {
        "id": "publicEvent",
        "name": {
            "fi": "Yleisölle avoin tapahtuma",
            "en": "Event open to the public",
            "sv": "Öppen för allmänheten"
        },
        "type": "checkbox",
        "required": false,
        "visibleCustomerBookingForm": true,
        "visibleCustomerBookingSuccessful": true,
        "visibleCustomerBookingView": true,
        "visibleTouchBookingForm": true,
        "officeIds": [68]
    },
    
    {
        "id": "wheelchairAccess",
        "name": {
            "fi": "Tarvitsen esteettömän kulkuväylän pyörätuolille.",
            "en": "I need wheelchair access.",
            "sv": "Jag behöver rullstols tillträde."
        },
        "type": "checkbox",
        "required": false,
        "visibleCustomerBookingForm": true,
        "visibleCustomerBookingView": false,
        "visibleTouchBookingForm": true,
        "showOnInvoice": false
    },
    
    {
        "id": "customerSurveyHeading",
        "name": {
            "fi": "Asiakaskysely (valinnainen)",
            "en": "Customer survey (optional)",
            "sv": "Kundundersökning (frivillig)"
        },
        "type": "heading"
    },
    {
        "id": "heardAboutUs",
        "name": {
            "fi": "Miten kuulit meistä?",
            "en": "How did you hear about us?",
            "sv": "Hur hörde du talas om oss?"
        },
        "type": "short-text",
        "required": false,
        "visibleCustomerBookingForm": true,
        "visibleCustomerBookingView": false,
        "visibleTouchBookingForm": true,
        "showOnInvoice": false
    },
    
        {
        "id": "visitedBefore",
        "name": {
            "fi": "Montako kertaa olet käynyt meillä aiemmin?",
            "en": "How many times have you visited us before?",
            "sv": "Hur många gånger har du besökt oss tidigare?"
        },
        "type": "select",
        "required": false,
        "visibleCustomerBookingForm": true,
        "visibleCustomerBookingView": false,
        "visibleTouchBookingForm": true,
        "options": [
            "0",
            "1-3",
            "4-10",
            "10+"
        ]
    },
    {
        "id": "arrival",
        "name": {
            "fi": "Miten saavut toimipisteellemme?",
            "en": "How will you arrive at our office?",
            "sv": "Hur kommer du fram till vårt anstalten?"
        },
        "type": "select",
        "required": false,
        "visibleCustomerBookingForm": true,
        "visibleCustomerBookingView": false,
        "visibleTouchBookingForm": true,
        "options": [
            {
                "id": "walking",
                "name": {
                    "fi": "Kävellen tai pyöräillen",
                    "en": "By walking or cycling",
                    "sv": "Genom att gå eller cykla"
                }
            },
            {
                "id": "car",
                "name": {
                    "fi": "Yksityisautolla tai -moottoripyörällä",
                    "en": "With a private car or motorcycle",
                    "sv": "Med en privat bil eller motorcykel"
                }
            },
            {
                "id": "bus",
                "name": {
                    "fi": "Bussilla tai mulla julkisella kulkuneuvolla",
                    "en": "By bus or other public transport",
                    "sv": "Med buss eller annan kollektivtrafik"
                }
            },
            {
                "id": "someone",
                "name": {
                    "fi": "Jonkun kyydillä tai taksilla",
                    "en": "Someone will take me or with taxi",
                    "sv": "Någon tar mig eller med taxi"
                }
            }
        ]
    }
]


"visibleCustomerBookingView": true
Visible-varaus2.png

"visibleTouchBookingForm": true
Julkinen-varaus-ajas.png

"visibleCustomerBookingSuccessful": true
Julkinen-onnistui.png

"showOnInvoice": true
Lasku-julkinen.png

"visibleCustomerBookingForm": true

  • Sama kuin ohjeen esimerkki varauslomakkeesta.
  • Käyttö ei ole pakollinen. Tehdyt lisäkentät näkyvät asiakkaan varauslomakkeella.
  • Koodiesimerkki on mukana siksi, että arvon voisi asettaa myös olemaan : false. Jos esimerkiksi haluaisi käyttää samaa koodia niin, että yksi lisäkentistä olisikin vain hallinnan kautta tehtävien varausten käytettävissä, kun taas muut kentät ovat myös asiakkaan varauslomakkeella käytettävissä.
 "visibleCustomerBookingForm": false,
        "visibleTouchBookingForm": true


Koko kenttä - Puoli kenttää:

lyhyesti se menee niin, että jos on puolikkaat kentät A ja B, tehdään oma työntekijä A ja B molemmille puolikkaille, ja samoin omat palvelut A ja B kummallekin puolikkaalle... sitten tehdään erillinen palvelu "Koko kenttä", joka liitetään työntekijään A, ja siihen liitetään moniresurssivarauksella palvelu B... näin "koko kenttä" varaa molemmat A:n ja B:n

Config-extra -sivun käyttö

Uusi piilotettu "Edistyneet toiminnot" -sivu avautuu

  • Sivun yläosassa on lukon kuva. Kirjoittakaa siihen salasana ja avatkaa lukko painamalla "Avaa asetukset".
  • Pääkäyttäjän on oltava yhteydessä: asiakaspalvelu (at) ajas.fi, jotta hän saa käyttöönsä kyseisen tilin config-extra -salasanan. Se ei ole sama kuin kirjautumis-salasana.

Siirtykää kohtaan: "Edistyneen käytön asetukset" - "Varauksen lisätietokenttien pohja".

  • Pohjaan kirjoitetaan / tallennetaan haluttujen lisätietokenttien rakenne json-koodilla.
  • Esimerkkejä valmiista koodista löytyy kohdassa: LINKKI.
  • Edistyneen käytön ohjeita koodin käytöstä dokumentissa: (YHTEISÖÖN?)

https://docs.google.com/document/d/17ZHSlnZmXSdfovZJxw4EvYiUZXT2J-JUO3yhmZ9cTe0/edit#heading=h.mvk6c2hpw9q1

Jos koodi halutaan poistaa sen jälkeen, kun se on tallennettu, editoriin kirjoitetaan pelkästään:
[ ]
ja tallennetaan.

Config-extra -sivun lukon voi tämän jälkeen sulkea. Sivulta poistutaan klikkaamalla jotain muuta sivua päävalikossa.

  • Nyt lisätietokentät on käytössä Nettivaraus 6 -asiakasnäkymän varauslomakkeella ja Ajas Touchin varauslomakkeella.
  • Asiakkaan antamat vastaukset näkyvät Ajas Touchin varauslomakkeella.


Huom: Jos jostain syystä ette pääse edistyneiden asetusten sivulle, kokeilkaa toista selainta. Chrome ja Firefox ovat toimivia ainakin.

Huom: Älkää tehkö mitään muutoksia mihinkään muuhun config-extra -sivulla näkyvään asetukseen.