Tässä artikkelissa käsitellään valinta-attribuuttien vaihtoehtojen (Options) vientiä ja tuontia CSV-tiedoston avulla. Tämä on hyödyllistä, kun haluat hallita attribuuttien valintojen käännöksiä, lisätä uusia vaihtoehtoja tai päivittää olemassa olevia joustavasti. Ohje koskee attribuutteja, joiden syöttötyypiksi (frontend_input) on määritelty joko select tai multiselect. Esimerkkinä voisi olla brand-attribuutti, jossa valintoina ovat “sram”, “scott”, “bbb” jne.

Seuraavassa vaiheittainen ohjeistus vientiin (Export) ja tuontiin (Import) sekä esimerkkitiedostot, rakenteet ja tyypilliset virhetilanteet.

1. CSV Export Options (viennin logiikka)

1. Siirry kohtaan Products > Attributes > CSV Export Options.
2. Klikkaa painiketta "CSV Export Options".
3. Järjestelmä luo CSV-tiedoston kaikista niistä attribuuteista, joilla on select tai multiselect tyyppinen syöttö.

Tiedosto sisältää seuraavat kentät:

code

• Optionin koodi, jolla valinta tunnistetaan yksiselitteisesti.
• Pakollinen CSV-päivityksissä: tätä käytetään, kun järjestelmä päättää luoda uuden tai päivittää olemassa olevaa.

title[fi], title[en], ...

• Käännökset eri kielille. Jokainen kieli tuodaan sarakkeeseen title[xx], missä xx on kielikoodi (esim. fi, en, sv).
• CSV:ssä voi olla useita näitä sarakkeita, yksi kullekin kielelle.

attribute

• Sarake, joka kertoo, mille attribuutille valinta kuuluu (esim. brand).
• Vain attribuutit, joilla frontend_input on select tai multiselect, hyväksyvät optioita.

sort_order

• Kokonaisluku, joka määrittää valinnan järjestyksen pudotusvalikossa.

Esimerkki CSV:stä

CSV-tiedosto (erotin ;) voi näyttää tältä:

code;title[fi];title[en];attribute;sort_order
sram;SRAM;SRAM;brand;5
pro;Pro;Pro;brand;6
schwalbe;Schwalbe;Schwalbe;brand;7
ortlieb;Ortlieb;Ortlieb;brand;8

• code on aina yksilöllinen jokaiselle attribuutin valinnalle.
• attribute on se attribuutti, jota valinta koskee (tässä esimerkissä brand).

Muokkaa tiedostoa vapaasti Excelissä/LibreOfficessa, kunhan sarakkeiden nimet pysyvät täsmälleen samoina.

2. CSV Import Options (tuonnin logiikka)

1. Siirry kohtaan Products > Attributes > CSV Import Options ja valitse CSV-tiedostosi.
2. Järjestelmä avaa tiedoston ja validoi CSV-rakenteen (tarkistaa otsikot ja sarakemäärän).
3. Jokainen rivi käydään läpi seuraavalla logiikalla:
   • code => option_code
   • attribute => Järjestelmä hakee attribute_code-arvon. Jos attribuutin frontend_input ei ole select tai multiselect, rivi skipataan.
   • title[fi], title[en], … => Täyttää eri kieliversiot valinnan nimestä.
   • sort_order => Järjestysnumero.

Uuden optionin lisäys vs. päivitys

• Jos CSV-rivi sisältää code, jota ei löydy tietokannasta kyseiselle attribuutille, järjestelmä luo uuden optionin.
• Jos code jo löytyy samalle attribuutille, järjestelmä päivittää olemassa olevan optionin (mm. nimen/käännökset ja sort_order).

Pakollinen code

• Koska CSV-tiedosto käyttää code:a valinnan tunnistamiseen, code on aina oltava.
• Jos code puuttuu tai on tyhjä, rivi ohitetaan tai tuonti keskeytyy virheeseen.

3. Sarakkeiden selitys

Kielet [fi], [en], [de], ...
Voit käyttää haluamiasi kielikoodeja. Jos järjestelmän kieliasetuksissa on esimerkiksi suomi (fi) ja englanti (en), CSV voi sisältää title[fi] ja title[en]. Jos haluat ruotsin, lisää title[sv], jne.

4. Esimerkkitaulukko HTML-muodossa

Alla oleva HTML-taulukko havainnollistaa yhden mahdollisen CSV-rakenteen (erotin ;), jossa on neljä riviä. Attribuutti on brand, ja valinnoilla on code, suomi-/englanninkieliset nimet sekä sort_order-arvot.
 

5. Tyypillisiä virhetilanteita

Puuttuva code

• Riviä ei voi päivittää tai lisätä, koska code on ainoa tapa tunnistaa option.

Attribuuttia ei löydy tai se ei ole select/multiselect

• Rivi ohitetaan (tai raportoidaan virhe). Vain attribuutit, joiden frontend_input on select / multiselect, tukevat valintoja.

Sarakkeita puuttuu

• Jos CSV:ssä rivien sarakemäärä ei täsmää otsikkorivin kanssa, tuonti keskeytyy virheilmoitukseen tai ohittaa rivin.

title[fi] -sarakkeen puuttuminen

• Ei ole pakollinen, mutta jos haluat suomenkielisen nimen, sarake on oltava. Vastaavasti title[en] englannille jne.

6. Työnkulku pähkinänkuoressa

Vie (Export) olemassa olevat optiot

• Saat CSV-tiedoston, jossa on koodit ja käännökset valmiina.

Muokkaa tai lisää rivejä

• Pidä code aina uniikkina samassa attribuutissa.
• Käytä title[fi], title[en] ym. kielisarakkeita tarpeen mukaan.
• Aseta sort_order.

Tuo (Import) tiedosto takaisin

• Järjestelmä luo uudet optionit tai päivittää olemassa olevat code + attribute -kombon perusteella.

Tarkista mahdolliset virheilmoitukset

• Näin varmistat, että kaikki rivit on tuotu tai päivitetty onnistuneesti.

7. Yhteenveto

Options on lisätietorakenne niille attribuuteille, joiden syöttötyyppi on select tai multiselect. Jokaisella optionilla on oltava code (pakollinen) ja kohdeattribuutti attribute. Kielikohtaiset nimet tallennetaan sarakkeisiin title[xx]. sort_order määrittää valintojen järjestyksen valikoissa. Suosittelemme ottamaan ensin Export-tiedoston ja muokkaamaan sitä, jotta sarakkeiden rakenne on varmasti oikein. Kun code pysyy uniikkina attribuutti­kohtaisesti, päivitykset ja lisäykset onnistuvat luotettavasti.

Avainsanat

• CSV-tiedosto
• attribuuttien valinnat
• select ja multiselect
• tuoteattribuutit
• Import ja Export
• Options-hallinta
• sort_order
• title[fi], title[en]