Tässä ohjeessa käydään läpi, miten voit viedä ja tuoda attribuutteja (esimerkiksi brand, color, brakel_levers) CSV-tiedoston avulla. Tämän ansiosta vältät manuaalisen klikkailun ja säästät huomattavasti aikaa ylläpitäessäsi kauppasi attribuutteja. Ohje sisältää myös validointiin ja tyypillisiin virhetilanteisiin liittyviä huomioita sekä selventää, miten select- ja multiselect-tyyppien optioita käsitellään erillisellä CSV:llä.

1. CSV Export Attributes (Attribuuttien vienti)

• Mistä editoidaan: Käytä hallintapaneelin Products > Attributes > CSV Export Attributes -painiketta.
• Tämä generoi ;-erottimella varustetun CSV-tiedoston, joka sisältää seuraavan kaltaisen rakenteen:

attribute_code;title[fi];title[en];is_filterable;is_comparable;is_listable;is_visible_on_front;is_html_allowed_on_front;sort_order;frontend_input
brand;Merkki;Brand;1;1;1;1;0;5;select

Vinkki: Aloita aina viemällä olemassa olevat attribuutit, jotta saat varmimman pohjan mahdollisille muutoksille.

2. CSV Import Attributes (Attribuuttien tuonti)

Muokkaa tai luo uusi CSV

• Voit muokata edellisessä vaiheessa luotua CSV-tiedostoa (esim. product_attributes.csv) tai luoda aivan uuden samanlaisella rakenteella.

Sarakkeiden vaatimukset

• attribute_code
  • Pakollinen sarake. Asetetaan olemassa olevan attribuutin päivitykseen tai uuden lisäämiseen.
• title[fi], title[en], …
  • Monikieliset nimet. Voit lisätä halutessasi kieliä, kuten title[sv], jos järjestelmä tuntee ne.
• is_filterable, is_comparable, is_listable, is_visible_on_front, is_html_allowed_on_front
  • 0 tai 1 -arvoiset kentät.
• sort_order
  • Kokonaisluku, joka vaikuttaa attribuutin järjestykseen käyttöliittymässä.
• frontend_input
  • Sallittuja arvoja ovat mm. select, multiselect, decimal, text, textarea ja boolean.
  • Muu arvo hylätään tai käsitellään varauksella.

Validointi
Järjestelmä tarkistaa CSV-tiedoston ennen tallennusta:

• Sarakeotsikot ovat oikein (esim. title[fi] – ei title_fi).
• Jokaisella rivillä on yhtä monta saraketta kuin otsikkorivillä.
• Jokaisen rivin tiedot kelpaavat (esim. attribute_code ei puutu).
• Mikäli virheitä löytyy, rivi joko ohitetaan tai tuonti keskeytyy.

Jos validointi menee läpi, CSV-rakenne on ok.

Yleisimpiä virheitä

• CSV missing header row: otsikkorivi puuttuu tai on tyhjä.
• expected X columns, got Y: erotinvirhe (esim. väärä määrä sarakkeita).
• Attribute already exists!: attribute_code on jo käytössä; päätä päivitätkö vai muutatko koodin.
• frontend_input puuttuu: oletuksena käytetään esim. text.

Tuo CSV

• Mistä editoidaan: Käytä hallintapaneelin Products > Attributes > CSV Import Attributes -painiketta.
• Järjestelmä näyttää ilmoituksen (“Import Complete” tms.) kun prosessi on onnistunut.

3. Options CSV

Jos attribuutti on tyyppiä select tai multiselect, siihen liittyvät option-arvot (kuten brand -> sram, scott, bbb) käsitellään erillisellä CSV Import/Export Options -toiminnolla.

• Mistä editoidaan: Löydät vastaavat painikkeet admin panelin CSV Export Options ja CSV Import Options -kohdista.
• Sarakkeet ovat esimerkiksi code;title[fi];attribute;sort_order.
• Huomioi, että nämä optiot eivät vaikuta itse attribuutin perusasetuksiin, vaan ainoastaan valintoihin (select/multiselect).

4. Mitä tyyppejä hyväksytään?

frontend_input -kentän tuetut arvot:

• select
• multiselect
• decimal
• text
• textarea
• boolean

Kaikki is_filterable, is_comparable, jne. -kentät ovat booleaneja arvoilla 0 tai 1.

5. Suositeltu työnkulku

1. Vie (Export) olemassa olevat attribuutit painamalla CSV Export Attributes.
2. Avaa CSV (esim. product_attributes.csv) Excelissä, Google Sheetsissä tai muussa taulukkolaskentaohjelmassa.
3. Tee halutut muutokset
   • Vaihda esimerkiksi title[fi] -solun sisältöä.
   • Nosta sort_order -arvoa tai päivitä is_filterable -kenttää.
   • Lisää uusia rivejä, jos luot kokonaan uusia attribuutteja (muista uusi attribute_code).
4. Tuo (Import) CSV admin panelin CSV Import Attributes -painikkeella.
5. Varmista onnistuminen
   • Järjestelmän tulisi ilmoittaa “Import Complete” ilman virheilmoituksia.

Yhteenveto

• Attribuuttien CSV-hallinta on kaksisuuntaista: voit viedä (Export) ja tuoda (Import) samoja attribuutteja.
• Sarakkeiden nimet tulee kirjoittaa täsmälleen oikein (attribute_code, title[fi], jne.).
• Validointi varmistaa, että jokaisella rivillä on oikea määrä sarakkeita ja että pakolliset tiedot löytyvät.
• Järjestelmä joko päivittää olemassa olevan attribuutin tai luo uuden, riippuen attribute_code-kentästä.
• Select- ja multiselect-tyyppien option-arvot lisätään tai päivitetään erillisellä CSV:llä.

Kun noudatat näitä ohjeita, hallitset attribuutteja helposti ilman tarvetta manuaaliselle konfiguroinnille. Suosittelemme aina testaamaan prosessia ensin pienemmällä CSV-tiedostolla, jotta varmistut oikeasta rakenteesta ja vältät mahdolliset virheet.