Mikä debug-näkymä on?

Debug-näkymä on ylläpidolle tarkoitettu lisänäkymä, joka näyttää taustatietoa suoraan siinä käyttöliittymässä, jossa ilmiö näkyy. Sen tarkoitus on nopeuttaa selvitystyötä silloin, kun tavallinen näkymä ei vielä kerro miksi hinta, toimitustapa tai maksutapa käyttäytyy tietyllä tavalla.

Tällä hetkellä debug-tietoa on käytössä sekä tuotesivulla että kassalla. Molemmissa näkymissä tieto näytetään vain admin-käyttäjälle.

Missä debug-näkymä näkyy nyt?

• Tuotesivulla Admin Debug: näyttää tuotteen hinnoitteluun liittyviä lisätietoja.
• Kassalla Admin Debug: näyttää toimitustapojen sääntöjä sekä ostoskorin paino- ja kokolaskentaa.

Mitä tuotesivun debug näyttää?

Tuotesivun debug-näkymässä näkyy tällä hetkellä ainakin seuraavat osiot:

• Discount Types, joka näyttää tuotteen aktiiviset alennustyypit
• History, joka näyttää tuotteen hintahistorian

Tämä auttaa selvittämään, miksi tuotteen hinta tai alennus näyttää eri tilanteissa erilaiselta, ja millaisia muutoksia hinnassa on ollut ajan yli.

Mitä checkoutin debug näyttää?

Kassan Admin Debug: -taulukko näyttää riveittäin ainakin seuraavat tiedot:

• Shipment setEnable: mitkä toimitustapamoduulit olivat aluksi käytössä ja mitkä jäivät pois jo lähtötilanteessa
• Shipment shippingDetails.isUnderWeight: mitkä toimitustavat estyvät, jos ostoskori jää alle minipainon
• Shipment shippingDetails.isOverWeight: mitkä toimitustavat estyvät, jos ostoskori ylittää maksimipainon
• Shipment shippingDetails.isOverSized: mitkä toimitustavat estyvät, jos paketin koko ylittää sallitun rajan
• Shipment weightLimitSource: mitä painoperustetta vertailussa käytetään
• Cart weight: ostoskorin real-, volume- ja max-painot
• Cart size: ostoskorin pituus, leveys, korkeus ja laskettu pakettikoko
• Cart items: rivikohtainen määrä, koko ja laskettu painoperuste

Toimitustapojen debug-riveillä näkyy sekä moduulin nimi että moduulikoodi. Näin voit tunnistaa tarkasti, mikä toimitustapa tai sääntö estää valinnan.

Admin-istunnossa kassasivun taustadata sisältää erilliset debug.shipment- ja debug.cart-osiot, joista käyttöliittymä rakentaa tämän taulukon. Tarvittaessa Cart size voi sisältää myös pakkauslaskennan lisätietoja, kuten laskentatavan ja pakkaussäännöt.

Näkyvyys ja käyttöoikeudet

Debug-tieto ei näy tavallisille asiakkaille. Se näkyy vain admin-istunnossa.

Sama rajaus koskee myös kassaa: adminille palautetaan sivudatan mukana erillinen debug-osio, jota normaali asiakasistunto ei saa.

Näin käytät checkoutin debug-näkymää

1. Kirjaudu sisään admin-oikeuksilla ja avaa kassa samassa tilanteessa, jossa ongelma näkyy.
2. Varmista, että ostoskorissa on samat tuotteet, määrät, asiakastyyppi, maa ja postinumero kuin ongelmatilanteessa.
3. Tarkista ensin Shipment setEnable, jotta näet mitkä toimitustapamoduulit olivat alun perin käytössä.
4. Tarkista sen jälkeen Shipment shippingDetails.isUnderWeight, Shipment shippingDetails.isOverWeight ja Shipment shippingDetails.isOverSized, jotta näet mikä sääntö pudottaa toimitustavan pois.
5. Vertaa Cart weight- ja Cart size -rivejä toimitustavan rajoihin. Näin näet nopeasti liittyykö ongelma painoon, tilavuuspainoon vai paketin kokoon.
6. Jos ongelma liittyy yksittäiseen tuotteeseen, avaa Cart items ja tarkista rivikohtaiset määrät, koot ja laskettu painoperuste.

Mitä maksutavoista näkee tällä hetkellä?

Kassan debug-näkymässä ei tällä hetkellä ole erillistä Payment-osiota, joka listaisi maksutapojen hylkäyssyyt samalla tarkkuudella kuin toimitustavat.

Maksutavoista näkee kuitenkin jo nyt käytännössä seuraavia asioita kassan puolella:

• maksutapa voi näkyä kassassa mutta olla harmaana, jos sitä ei voi valita
• maksutapa voi jäädä kokonaan pois, jos moduuli ei ole aktiivinen, alue ei täsmää, asiakastyyppi ei täsmää tai tilauksen arvo ei osu maksutavan rajoihin
• maksutapa voi estää tiettyjä toimitustapoja, jolloin checkout näyttää yhdistelmästä erillisen virheilmoituksen
• osa maksutavoista käyttää lisäksi omaa lisälogiikkaansa, joten näkyvyys ei aina riipu vain yleisistä checkout-säännöistä

Jos haluat maksutavoille saman tasoisen syylistan kuin toimitustavoille, se vaatii erillisen maksutapojen debug-laajennuksen kassan admin-näkymään.

Milloin debug-näkymää kannattaa laajentaa?

Laajennus on hyödyllinen erityisesti silloin, kun sama ongelma toistuu eri asiakkailla tai eri toimitus- ja maksutapayhdistelmillä.

• Tuotesivulla laajennus auttaa, jos hinnan, alennuksen tai historiatiedon tulkinta vaatii lisää näkyvyyttä.
• Kassalla laajennus auttaa, jos toimitustapojen rajoituksia tai maksutapojen näkyvyyttä pitää selittää tarkemmin ylläpidolle.

Debug-elementtejä voidaan lisätä muihinkin näkymiin samalla periaatteella: tieto näytetään vain adminille siinä kohdassa, jossa ongelma syntyy.

Mitä tietoja kannattaa kirjata talteen?

Kun selvität ongelmaa debug-näkymän avulla, kirjaa talteen ainakin:

• kuvakaappaus kyseisestä Admin Debug: -näkymästä
• ostoskorin tuotteet ja määrät
• asiakastyyppi, maa ja postinumero
• puuttuva tai estyvä toimitustapa tai maksutapa
• Cart weight- ja Cart size -rivien arvot
• ne moduulit, joiden kohdalla debug näyttää estävän säännön

Näillä tiedoilla jatkoselvitys on huomattavasti nopeampaa kuin pelkän ongelmakuvauksen perusteella.