Az Analitika adóadatainak újraépítése

Ez a fejezet fejlesztői szintű hátteret ír le: az Analitika adókeresési rekordjainak átalakítását és a WooCommerce → Állapot → Eszközök oldalon található adóadat-újraépítő eszközt. Akkor hasznos, ha ellenőrizni szeretnéd az átalakítás állapotát, vagy ki akarod vizsgálni egy olyan rendelést, amelynek adóadatai nem épültek újra. Az adatbázist közvetlenül nem ajánlott módosítani.

Teendők előtt:

• a WooCommerce 11.2.0-s vagy újabb változata kell;
• olyan fiókkal lépj be, amelyik eléri a WooCommerce → Állapot → Eszközök oldalt (ehhez a manage_woocommerce jogosultság kell);
• a jelentéses ellenőrzéshez nyisd meg az Analitika → Adók oldalt.

Mi változott

A WooCommerce 11.2.0 előtt az adókeresési tábla egy rendeléshez és adókulcshoz egyetlen sort tárolhatott akkor is, ha a rendelésnek több, azonos kulcsú adósora volt. Az újabb szerkezet külön azonosítót ad az adótételeknek, és minden adótételhez külön sort ír, így az Analitika minden adósort pontosan elszámol.

Egy meglévő táblához az új oszlop alapértéke 0. Az ilyen régebbi sorok addig a régi módon szerepelnek a jelentésben, amíg a háttérben futó újraépítés fel nem dolgozza a rendelésüket. Ez alatt a jelentés a régi és az újraépített sorokat is képes olvasni.

A 11.2.0-s adatbázis-frissítés egy háttérátalakítást ütemez, amely újra szinkronizálja azokat a rendeléseket, amelyeknek még régi szerkezetű adókeresési soruk van. Az eszköz a WooCommerce → Állapot → Eszközök oldalon van, és mutatja, hány rendelés van hátra. Ha legalább ezer függő rendelés van, a megjelenített szám „1000+”.

Az eszköz állapotai

• Újraépítés: elindítja a háttérfolyamatot, ha van még feldolgozandó rendelés.
• Újraépítés leállítása: törli a sorban álló folyamatot. A már feldolgozott rendelések újraépítve maradnak, a többi később folytatható.
• Nincs újraépítendő rendelés: ilyenkor az eszköz le van tiltva. Ez az állapot nem zárja ki, hogy egy rendelés sikertelen Analitika-importként legyen rögzítve; ezt az Analitika → Beállítások oldalon ellenőrizheted.
• Hiányzó adatbázis-módosítás: az eszköz le van tiltva, ha a tábla nincs az adótétel szerint kulcsolva. Futtasd az alap adatbázistáblák ellenőrzését az Eszközök oldalon, térj vissza az oldalra, és nézd meg újra az eszközt.

Ellenőrzés az újraépítés után

1. Az Eszközök oldalon ellenőrizd, hogy az újraépítés már nem jelez feldolgozandó rendelést.
2. Az Analitika → Beállítások oldalon próbáld újra az átalakításhoz kapcsolódó sikertelen importokat.
3. Az Analitika → Adók oldalon nézd át azokat a rendeléseket, amelyeknek több, azonos kulcsú adósora van. Az adóösszegek adósoronként egyszer szerepeljenek, és az oldal az újraépítés után is nyíljon meg.

Hibák

Ha egy rendelés újraszinkronizálásakor olvasási vagy írási hiba lép fel, a WooCommerce megtartja a rendelés meglévő adókeresési sorait, és a rendelést sikertelen Analitika-importként rögzíti. Próbáld újra az importot az Analitika → Beállítások oldalon, ez újra szinkronizálja a rendelés adóadatait.

Kiszolgálói vizsgálathoz keresd a WooCommerce naplóiban a wc-order-tax-lookup-migration forrást. A keresési sorokat és az átalakítás kurzorát ne módosítsd közvetlenül. Ha a tábla szerkezetéből hiányzik az adótétel szerinti kulcs, használd az alap adatbázistáblák ellenőrzését, mielőtt újra megpróbálod az újraépítést.