Tässä artikkelissa käydään läpi, miten AI Commerce -verkkokaupan kategoriat voidaan viedä ja tuoda CSV-tiedoston avulla. Ohje käsittelee sort_order-kentän sekä muut CSV-viennin ja -tuonnin tukemat kategoriakentät.

1. CSV Export Categories (Kategorioiden vienti)

Vientitoiminto tuottaa yhden CSV-rivin per kategoria. Jokainen rivi sisältää:

• Kategorian yhteiset kentät, kuten koodin, järjestyksen, kuvakentät, Google-/AI-asetukset ja FAQ-liitokset.
• Kielikohtaiset kentät jokaiselle aktiiviselle kielelle, esimerkiksi nimen, kuvauksen, URL:n ja banneritekstit.

Huom: CSV-template ei sisällä sarakkeita categories_id tai parent_id. Tuonnissa tunnisteina käytetään categories_code- ja parent_code-kenttiä.

Oletussarakkeet:

• parent_code
• categories_code
• sort_order
• position
• cat_front_page_img
• categories_image
• categories_banner
• cat_products_top_image
• cat_front_page_img_enabled
• categories_group_id
• categories_gallery_id
• categories_volume
• google_product_category
• tariff_code
• google_feed
• cms_description
• categories_index
• categories_thumbnails_view
• categories_button_color
• categories_button_position
• openai_product_description_enabled
• openai_product_description_instructions
• svg_icon
• faq_categories
• faq_questions
• categories_name[fi]
• categories_description[fi]
• stripped_categories_description[fi] (read only)
• categories_description_top[fi]
• stripped_categories_description_top[fi] (read only)
• categories_path[fi]
• categories_url[fi]
• categories_meta_title[fi]
• categories_meta_description[fi]
• categories_banner_text[fi]
• categories_banner_button[fi]
• categories_banner_url[fi]
• categories_name[en]
• ...

Samat kielikohtaiset sarakkeet toistuvat kaikille aktiivisille kielille, esimerkiksi [fi], [en] ja [sv].

Yhteiset kategoriakentät

Kielikohtaiset kentät

Vaihda esimerkeissä oleva kielikoodi fi tarvittaessa esimerkiksi muotoon en, sv tai muu aktiivinen kieli.

2. CSV Import Categories (Kategorioiden tuonti)

Tuonti käsittelee tiedoston rivi kerrallaan ja toimii seuraavasti:

• categories_code tunnistaa kategorian yksilöllisesti. Jos koodi on uusi, järjestelmä luo uuden kategorian.
• parent_code liittää kategorian yläkategoriaan. Jos annettua yläkategoriaa ei ole vielä olemassa, järjestelmä luo sen minimirakenteella.
• Kaikki CSV:ssä mukana olevat yhteiset kategoriakentät päivitetään suoraan categories-tauluun.
• Kaikki muodossa kentta[kieli] annetut kentät päivitetään categories_description-tauluun kyseiselle kielelle.
• Jos sarake puuttuu kokonaan CSV:stä, olemassa oleva arvo jää ennalleen.
• Jos sarake on mukana mutta solu on tyhjä, tuonti päivittää kentän tyhjäksi tai oletusarvoiseksi taulun tyypin mukaan.
• Viennin stripped_...-sarakkeet ovat vain luettavia. Tuonti ei käytä niitä.

Tärkeää: sort_order toimii samalla tavalla kuin muutkin yhteiset kentät. Jos sarake on mukana CSV:ssä, tuonti päivittää kategorian järjestysarvon.

3. Huomioita sarakerakenteesta

• sort_order on mukana CSV-rakenteessa ja sitä käytetään kategorioiden järjestämiseen.
• CSV-rakenne käyttää tunnisteina categories_code- ja parent_code-kenttiä eikä sisällä sarakkeita categories_id tai parent_id.
• Yhteisiin kenttiin kuuluvat esimerkiksi position, categories_banner, cat_products_top_image, tariff_code, faq_categories, faq_questions sekä AI- ja banneriasetukset.
• Kielikohtaisiin kenttiin kuuluvat myös banneri- ja metakentät. stripped_...-sarakkeet ovat vain lukua varten.

4. Validointi ja yleiset ongelmat

Puuttuva categories_code

• Rivi ohitetaan, koska ilman kategorian koodia tuonti ei voi tunnistaa tai luoda kategoriaa.

Virheellinen sarakemäärä

• Jokaisella CSV-rivillä pitää olla sama määrä sarakkeita kuin otsikkorivillä.
• Käytä erotinmerkkinä puolipistettä ;. Jos solu sisältää puolipisteitä tai rivinvaihtoja, arvo pitää ympäröidä lainausmerkeillä ".
• Turvallisin tapa on aloittaa aina exportista ja muokata juuri sitä pohjaa.

Kielikohtaiset kentät

• Monikieliset sarakkeet pitää kirjoittaa muodossa kentta[fi], kentta[en], kentta[sv] jne.
• Jos CSV:ssä on vain esimerkiksi categories_name[fi], vain suomenkielinen nimi päivittyy.

5. Työnkulku

1. Export

• Lataa kategoriat toiminnolla CSV Export Categories.

2. Muokkaa CSV:tä

• Tee muutokset samaan sarakerakenteeseen. Voit päivittää esimerkiksi sort_order-arvot, yläkategoriat, kuvat, meta-arvot, banneritekstit ja kielikohtaiset kuvaukset.

3. Import

• Lataa muokattu tiedosto toiminnolla CSV Import Categories.
• Järjestelmä päivittää olemassa olevat kategoriat categories_code-kentän perusteella tai luo uudet kategoriat tarvittaessa.

4. Tarkista lopputulos

• Varmista erityisesti järjestys (sort_order), yläkategoriat (parent_code) ja kielikohtaiset nimet/URL:t.

6. Esimerkkirivi

parent_code;categories_code;sort_order
catalog;accessories;20

Tässä esimerkissä:

• parent_code=catalog asettaa yläkategoriaksi catalog.
• categories_code=accessories on kategorian yksilöllinen koodi.
• sort_order=20 määrittää kategorian järjestyspaikan listauksissa.

Tämä on tarkoituksella lyhyt esimerkki. Todellisessa CSV:ssä voi olla mukana paljon enemmän yhteisiä ja kielikohtaisia sarakkeita.

7. Yhteenveto

• categories_code on aina tuonnin pakollinen tunniste.
• parent_code määrittää kategorian paikan kategoriapuussa.
• sort_order on tuettu sekä viennissä että tuonnissa.
• CSV tukee myös muita hallinnan käyttämiä kenttiä, kuten banneri-, AI-, FAQ-, tariffi- ja järjestyskenttiä.
• Aloita aina exportista, jotta sarakkeet ja otsikot pysyvät varmasti oikeina.