Lataa vienti varmuuskopioksi ja tuontipohja muokkaukseen

Kategorioita käsitellään CSV-tiedostoina avaamalla Tiedonsiirto. Ohje kertoo, miten muutokset tehdään, kun päivitettäviä kategorioita on paljon. Suorita ensin Kategorioiden vienti, jotta saat koko nykyisen kategoriapuun talteen ennen laajaa muutosta. Lataa muokattavaa aineistoa varten erikseen Kategorioiden tuontipohja. Tuontipohja sisältää juuri ne sarakkeet, jotka Kategorioiden tuonti hyväksyy, sekä kaikkien aktiivisten datakielten kielisarakkeet oikeassa järjestyksessä.

Älä lataa vientitiedostoa sellaisenaan tuontiin. Vienti sisältää vain luettavat stripped_categories_description[kieli] (read only)- ja stripped_categories_description_top[kieli] (read only) -sarakkeet, joita tuontipohjassa ei ole. Se voi sisältää myös arvoja kentissä, joita nykyinen tuonti ei kirjoita. Käytä vientiä lähdetietona, mutta kopioi muutettavat arvot tuontipohjan vastaaviin tuettuihin sarakkeisiin. Tallenna tiedosto UTF-8-koodattuna tavallisena pilkuin eroteltuna CSV:nä.

Säilytä tuontipohjan kaikki otsikot ja niiden järjestys

Tuontipohjan koko otsikkorivi tarkistetaan aktiivisten datakielten perusteella muodostettua mallia vasten. Älä poista, lisää, nimeä uudelleen tai järjestä sarakkeita. Yhteiset sarakkeet alkavat kentillä parent_code, categories_code, sort_order ja position. Niitä seuraavat kuva-, näkyvyys-, ryhmä-, galleria-, Google-, tariffi-, CMS-, indeksointi-, banneri-, AI- ja FAQ-kentät. Lopussa ovat kunkin aktiivisen kielen kentät, esimerkiksi 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_banner_text[fi], categories_banner_button[fi] ja categories_banner_url[fi].

categories_id ja parent_id eivät kuulu tuontiin. categories_code on kategorian pakollinen vakaa tunniste, ja parent_code viittaa yläkategorian koodiin. Sama categories_code saa esiintyä tiedostossa vain kerran. Aktiivisten kielten kaikki sarakkeet kuuluvat otsikkoriviin myös silloin, kun jonkin kielen solut jätetään tyhjiksi. Esimerkiksi en- ja sv-sarakkeita ei saa poistaa kaupasta, jossa ne ovat aktiivisia datakieliä.

Täytä hierarkia, järjestys ja yhteiset asetukset

Hierarkia muodostuu categories_code- ja parent_code-kentistä: ensimmäinen päivittää samalla koodilla löytyvän kategorian tai luo uuden. parent_code saa olla tyhjä juuritason kategorialla, viitata jo olemassa olevaan kategoriaan tai toiseen samassa tiedostossa luotavaan kategoriaan. Tuntematon yläkategorian koodi ei luo automaattisesti minimikategoriaa, vaan aiheuttaa esikatseluvirheen. Kategoria ei voi olla oma yläkategoriansa, eikä tuonnilla voi muodostaa syklistä kategoriapuuta.

sort_order ja position hyväksyvät kokonaisluvun; tyhjä arvo muuttuu nollaksi. Näkyvyys- ja käyttötilakentät, kuten cat_front_page_img_enabled, categories_thumbnails_view, google_feed, cms_description, categories_index ja openai_product_description_enabled, hyväksyvät arvot 1/true ja 0/false; tyhjä tarkoittaa arvoa epätosi. categories_group_id ja categories_gallery_id ovat kokonaislukutunnisteita. categories_button_color hyväksyy kuusimerkkisen hex-värin, haluttaessa #-etuliitteellä. faq_categories sisältää pilkuin erotetut positiiviset FAQ-kategoria-ID:t.

Käsittele kuvat ja tuetut kentät oikein

Kuvat annetaan sarakkeissa cat_front_page_img, categories_image, categories_banner ja cat_products_top_image. Anna niihin turvallinen tiedostonimi ilman hakemistopolkua, vinoviivaa tai ..-osaa. CSV-tuonti ei siirrä binäärikuvaa, joten tiedoston on oltava käytettävissä erillisen mediaprosessin kautta. Tyhjä kuvasolu ei poista olemassa olevaa kuvaa, sillä tuonti kirjoittaa vain ei-tyhjät kuvatiedostonimet.

Jätä svg_icon, faq_questions ja kaikki categories_path[kieli]-solut tyhjiksi: otsikot kuuluvat pohjaan, mutta nykyinen tuonti estyy, jos näissä kentissä on arvo. categories_url[kieli] sen sijaan on tuettu. Myös categories_volume, google_product_category, tariff_code, openai_product_description_instructions, banneritekstit ja metatiedot kuuluvat pohjan kautta tuotaviin tietoihin. Älä lisää viennin stripped_... (read only) -sarakkeita tuontipohjaan.

Suojaa nykyiset tiedot ennen tyhjien solujen tuontia

Nykyiset tiedot eivät säily automaattisesti, sillä CSV-tuontipohja kuvaa kokonaisen kategoriarivin eikä vain valinnaista osapäivitystä. Useimmat tyhjät solut kirjoittuvat tyhjinä, nollana tai epätotena: tämä koskee yhteisiä asetuksia ja jokaisen aktiivisen datakielen nimiä, kuvauksia, URL-osoitteita, metatietoja sekä banneritekstejä. Poikkeuksena tyhjät kuvasolut eivät tyhjennä nykyisiä kuvatiedostonimiä. Täytä siksi päivitettävän kategorian kaikki säilytettävät arvot tuontipohjaan myös silloin, kun haluat muuttaa vain sort_order- tai parent_code-arvoa.

Vertaa tuontipohjaa ennen latausta ottamaasi Kategorioiden vienti -varmuuskopioon. Kopioi esimerkiksi suomen categories_name[fi]- ja categories_description[fi]-arvot sekä muiden aktiivisten kielten vastaavat arvot mukaan. Jos käsittelet HTML-kuvausta, anna CSV-editorin lainata solu oikein pilkkujen, lainausmerkkien ja rivinvaihtojen ympäriltä. Älä muuta sarakerakennetta käsin Excelissä tai LibreOfficessa.

Esikatsele pienellä aineistolla

Kategorioiden CSV-tuonti tarkistetaan lataamalla valmis tuontipohja profiiliin Kategorioiden tuonti ja käynnistämällä Esikatsele. Tarkista jokaisen rivin luokitus: uusi koodi näkyy luotavana ja olemassa oleva päivitettävänä. Korjaa kaikki kenttävirheet, kuten puuttuva tai toistuva categories_code, tuntematon parent_code, omaan itseensä viittaava yläkategoria, virheellinen kokonaisluku tai käyttötila, väärä hex-väri, vaarallinen kuvatiedostonimi sekä arvo kentässä, jota tuonti ei tue.

Esikatselu estää koko suorituksen, jos kenttävirheitä jää. Väärä erotinmerkki, puuttuva CSV-lainaus tai muuttunut sarakemäärä voi rikkoa otsikon tai tietorivin jäsennyksen; palaa silloin alkuperäiseen tuontipohjaan ja korjaa tiedosto. Esimerkkirivillä catalog voi olla accessories-kategorian parent_code, accessories sen categories_code ja 20 sen sort_order, mutta rivillä pitää silti olla kaikki tuontipohjan sarakkeet oikeassa järjestyksessä.

Vahvista suoritus ja tarkista kategoriapuu

Suoritus vahvistetaan vasta onnistuneen esikatselun jälkeen, jolloin CSV-tuonti kirjoittaa kategoriapuun tiedot. Vahvista vasta, kun luotavien ja päivitettävien rivien määrät sekä jokaisen aktiivisen kielen arvot vastaavat suunnitelmaa. Suoritus käsittelee yläkategoriat ennen niihin viittaavia uusia alakategorioita mahdollisuuksien mukaan. Toteutuksen aikana havaittu käyttöoikeus-, kenttä-, sykli- tai yläkategoriavirhe näkyy suoritusraportissa epäonnistuneena rivinä.

Tarkista raportin jälkeen Kategoriat-näkymästä erityisesti categories_code-kohdistus, kategoriapuun vanhempi-lapsi-suhteet, sort_order, näkyvyysmerkinnät, kuvat, nimet, URL-osoitteet, metatiedot ja bannerisisällöt kaikilla aktiivisilla kielillä. Vertaa lopputulosta vientivarmuuskopioon. Jos tulos poikkeaa suunnitelmasta, älä aja suurempaa aineistoa ennen kuin pieni testitiedosto tuottaa odotetun puun ja sisällön.