Tässä artikkelissa käydään läpi, kuinka AI Commerce -verkkokauppasi kategoriat voidaan sekä viedä että tuoda CSV-tiedoston avulla. Näin voit tehokkaasti luoda tai päivittää suuria määriä kategorioita, niiden kielikohtaisia tietoja ja muita asetuksia ilman, että sinun tarvitsee tehdä muutoksia yksitellen hallintapaneelissa. Prosessi on erityisen hyödyllinen, kun haluat säästää aikaa ja varmistaa tietojen yhdenmukaisuuden laajemmassa mittakaavassa.

1. CSV Export Categories (Kategorioiden vienti)

Vientitoiminnolla ("CSV Export Categories") saat järjestelmästä CSV-tiedoston, jossa jokaiselle kategorialle on oma rivi. Jokainen rivi sisältää:

• Kategorian omia kenttiä (esim. koodi, kuva, jne.)
• Kielikohtaisia sarakkeita (esim. nimi, kuvaus, meta-tiedot) kunkin kielikoodin mukaan

Esimerkki otsikoista
Oletuksena CSV-rivillä voi olla esimerkiksi seuraavia sarakkeita:

categories_id;parent_id;parent_code;categories_code;cat_front_page_img;categories_image;cat_front_page_img_enabled;google_feed;categories_index;categories_thumbnails_view;categories_name[fi];categories_description[fi];categories_description_top[fi];categories_path[fi];categories_url[fi];categories_meta_title[fi];categories_meta_description[fi];categories_name[en];...

(ja vastaavasti muille kielille [en], [sv], jne.)

Huom:

• categories_code on kategorian yksilöllinen koodi.
• parent_code on mahdollisen yläkategorian koodi.
• categories_id ja parent_id näkyvät viennissä, mutta tuonnissa käytetään yleensä categories_code- ja parent_code-kenttiä tunnisteina.

Esimerkkitaulukko HTML-muodossa

Alla on esimerkki taulukosta, jossa on kategorioiden sarakeotsikoita ja näyterivi. Säilytä sama sarakerakenne myös vienti- ja tuontitiedostossasi:

Exportin tuottama tiedosto on CSV-muotoinen, jossa sarakkeet on eroteltu puolipisteellä ; ja merkistönä esimerkiksi UTF-8.

2. CSV Import Categories (Kategorioiden tuonti)

Tuontitoiminnossa ("CSV Import Categories") järjestelmä lukee tiedoston rivi kerrallaan ja päivittää tai luo uusia kategorioita seuraavien sääntöjen mukaisesti:

categories_code

• Tunnistaa kategorian yksilöllisesti.
• Jos koodi on uusi, luodaan uusi kategoria.
• Jos koodi on jo olemassa, päivitetään olemassa olevaa kategoriaa.

parent_code (yläkategorian koodi)

• Jos arvo on annettu ja tunnistetaan, kategoriasta tulee tämän yläkategorian lapsi.
• Jos parent_code on annettu, mutta sitä ei löydy, järjestelmä luo myös yläkategorian tyhjin tiedoin (tai ohittaa arvon asetuksista riippuen).

Kielikohtaiset sarakkeet (esim. categories_name[fi], categories_name[en], …)

• Päivittävät TABLE_CATEGORIES_DESCRIPTION-taulua. Jos kieliriviä ei ole entuudestaan, se luodaan.

Muut sarakkeet (esim. cat_front_page_img, categories_index, categories_url[fi])

• Päivittävät vastaavat tietokentät, jos CSV-rivillä on niille annettu arvo.

Uusien kielirivien luonnista

Jos luodaan uusi kategoria, järjestelmä voi automaattisesti luoda tyhjät kielirivit TABLE_CATEGORIES_DESCRIPTION-tauluun jokaiselle kielelle. Tämän jälkeen vain CSV:ssä olevat kielet ylikirjoitetaan.

Huom:

• Jos categories_code tai parent_code puuttuu kokonaan, rivi saatetaan ohittaa tai tallentaa default-arvot.

3. Tärkeät sarakkeet

• categories_code: Pakollinen, yksilöi kategorian.
• parent_code: Ei pakollinen, mutta määrittää yläkategorian koodin.
• categories_image, cat_front_page_img jne.: Päivitettävät kentät kategorioille.
• categories_name[fi], categories_description[fi] jne.: Monikieliset nimet ja kuvaukset. Käytä aina hakasulkusyntaksia [kielikoodi].

4. Validointi & yleiset ongelmat

Puuttuva categories_code

• Rivi ohitetaan, koska kategoriaa ei voi luoda ilman koodia.

Ei vastaavuutta parent_code

• Jos parent_code on annettu, mutta sitä ei löydy, järjestelmä voi luoda automaattisesti uuden yläkategorian tai jättää arvon huomiotta konfiguraation mukaan.

Sarakeotsikot

• CSV-tiedostossa pitää olla täsmälleen sama määrä sarakkeita jokaisella rivillä.
• Monikieliset kentät on merkittävä muodossa [fi], [en], [sv] jne.

Kielirivit

• Jos CSV:ssä on esim. categories_name[fi] mutta ei categories_name[en], vain suomenkielinen nimi päivittyy.
• Metatiedot, URLit ja polut (esim. categories_path) voivat myös olla kielikohtaisia.
   

5. Työnkulku

Export

• Käynnistä vienti "CSV Export Categories" -painikkeesta. Lataa kaikki (tai halutut) kategoriat CSV-muodossa.

Muokkaa

• Avaa CSV-tiedosto esimerkiksi Excelissä tai LibreOfficessa.
• Tee tarvittavat muutokset: categories_code, parent_code, kielikäännökset, kuvat jne.

Import

• Paina "CSV Import Categories" -painiketta ja lataa muokattu CSV-tiedosto.
• Järjestelmä päivittää olemassa olevat kategoriat tai luo uudet categories_code-kentän perusteella.
• parent_code liittää kategorian yläkategoriaan, jos se on määritelty.

Tarkista virheilmoitukset

• Kiinnitä huomiota puuttuviin koodeihin (categories_code), virheelliseen sarakemäärään tai muihin mahdollisiin ilmoituksiin.

6. Esimerkki CSV-rivi

categories_code;parent_code;cat_front_page_img;categories_image;cat_front_page_img_enabled;google_feed;categories_index;categories_thumbnails_view;categories_name[fi];categories_description[fi]
accessories;catalog;front_image.jpg;cat_image.jpg;1;1;1;grid;"Lisätarvikkeet";"Kaikki lisätarvikkeet ja tarviketiedot..."

Selitykset:

• categories_code=accessories: Koodi tälle kategorialle.
• parent_code=catalog: Yläkategoria on catalog. Jos sitä ei ole, se luodaan.
• categories_name[fi]: Suomenkielinen nimi “Lisätarvikkeet”.
• categories_description[fi]: Suomenkielinen kuvaus.

7. Yhteenveto

Kategorioiden vieminen ja tuonti CSV-tiedoston avulla antaa mahdollisuuden hallita kauppasi rakennetta tehokkaasti ja joustavasti:

• categories_code on aina pakollinen tunniste.
• parent_code on valinnainen, mutta määrittää yläkategorian.
• Kielikohtaiset kentät merkitään [fi], [en] jne.
• Suositus on aloittaa Export-toiminnolla, muokata CSV-tiedostoa, ja sitten Import-toiminnolla ladata muutokset. Näin sarakkeet pysyvät varmasti oikeina.

On hyvä tapa tehdä ensin testi pienellä CSV-tiedostolla ja varmistaa, että kaikki toimii odotetusti, ennen kuin muokkaa laajasti tuotantokategoriarunkoa.