Miten tuoteattribuuttien valintojen vienti ja tuonti CSV-tiedostolla onnistuu?
Hyödynnä CSV-tiedostoa massamuokkauksiin ja säästä aikaa, kun et joudu päivittämään jokaisen tuotteen yksittäisiä attribuutteja erikseen.
Sisällysluettelo
Tässä artikkelissa opit, miten voit viedä ja tuoda tuoteattribuuttien arvoja (kuten battery_capacity tai color[fi]) CSV-tiedoston avulla AI Commerce -alustalla. Menetelmä mahdollistaa nopean massamuokkauksen ilman, että sinun tarvitsee päivittää jokaista tuotetta erikseen käyttöliittymässä. Artikkeli on erityisen hyödyllinen, jos haluat käsitellä satoja tuotteita kerrallaan tai ylläpitää monikielisiä attribuutteja.
1. CSV Export (Tuoteattribuuttien vienti)
- Export-toiminto (esim. painike "CSV Export Product Attributes") generoi CSV-tiedoston, jossa jokainen rivi vastaa yhtä tuotetta ja sen attribuuttikenttiä.
-
Ensimmäinen sarake on aina
sku
, jonka avulla tuote tunnistetaan (esim.products_model
). -
Seuraavat sarakkeet kuvaavat attribuutteja (
attribute_code
).- Jos attribuutti on monikielinen (ts.
backend_type = 'varchar'
tai'text'
), jokainen kieli saa oman sarakkeen tyyliinattribute_code[fi]
,attribute_code[en]
jne. - Jos attribuutti on numeerinen (esim.
int
,decimal
), saat vain yhden sarakkeen.
- Jos attribuutti on monikielinen (ts.
Esimerkki CSV-rakenteesta
Jos attribuutit ovat color
(monikielinen) ja battery_capacity
(numeerinen), exportin ensimmäinen rivi (header) voi näyttää tältä:
sku;color[fi];color[en];battery_capacity
Seuraavat rivit voivat sisältää tuotteita seuraavasti:
SCOTT_001;Sininen;Blue;500
SCOTT_002;Punainen;Red;625
2. CSV Import (Tuoteattribuuttien tuonti)
Tuonnin avulla voit päivittää tai luoda attribuuttien arvoja ladatun CSV:n perusteella.
- Import-skripti lukee tiedoston rivi kerrallaan ja tunnistaa tuotteet
sku
-sarakkeen perusteella (esim.products_model
). - Se päivittää tai poistaa olemassa olevia attribuuttien arvoja:
- Mikäli
sku
-arvo ei vastaa yhtäkään tuotetta, rivi ohitetaan.
- Mikäli
Attribuuttikoodin ja kielikoodin tulkinta
- Sarakkeen otsikko määrittää, onko kyse
attribute_code[fi]
(kielikohtainen) vaiattribute_code
(yksikielinen / numeerinen). - Jos attribuuttikoodia ei tunneta, sarake ohitetaan.
- Monikielisessä sarakkeessa importti etsii vastaavan
lang_id
-koodin järjestelmästä (esim.[fi]
tarkoittaa suomen kieltä).
Arvon tyhjentäminen
- Jos arvokenttä on tyhjä (esim.
""
tainull
), järjestelmä poistaa kyseisen attribuuttirivin (DELETE). Näin poistat helposti virheellisiä tai vanhentuneita tietoja.
Multi-select-esimerkki
- Jos attribuutti on multiselect-tyyppinen, syöte voi sisältää pilkulla eroteltuja ID-arvoja (tai valintakoodeja). Skripti muuntaa nämä järjestelmälle sopivaan tallennusmuotoon.
3. CSV-tiedoston rakenne
Sarake | Kuvaus |
---|---|
sku | Tuotteen tunniste (esim. products_model ). Pakollinen. |
attribute_code tai attribute_code[fi] |
Jokainen attribuutti omana sarakkeena, esim. color[fi] , battery_capacity . |
(lisää attribuutteja) | Jokaiselle attribuutille omat sarakkeet. |
- Käytettävissä olevat attribuutit luetaan eav_attribute-taulusta.
- Jos attribuutin
backend_type
on'varchar'
tai'text'
, exportissa ja importissa on kielikohtaiset sarakkeet. - Jos
backend_type
on'int'
tai'decimal'
, on vain yksi sarake.
Esimerkkitaulukko HTML-muodossa
Oletetaan, että attribuutit ovat color
(monikielinen) ja battery_capacity
(numeerinen). Export voisi tuottaa CSV:n, jonka HTML-vastine näyttää tältä:
sku | color[fi] | color[en] | battery_capacity |
---|---|---|---|
SCOTT_001 | Sininen | Blue | 500 |
SCOTT_002 | Punainen | Red | 625 |
Vastaava CSV-tiedosto olisi:
sku;color[fi];color[en];battery_capacity
SCOTT_001;Sininen;Blue;500
SCOTT_002;Punainen;Red;625
Kentät on erotettu puolipisteellä ;
. Jos arvossa on puolipisteitä, se kannattaa ympäröidä lainausmerkeillä.
4. Validointi & yleiset ongelmat
-
Sarakemäärä
Jokaisella rivillä on oltava sama määrä sarakkeita kuin otsikkorivillä. Muuten importti keskeytyy tai ohittaa rivin. -
Puuttuva sku
Rivi skipataan, koska tuotetta ei voi yhdistää. -
Tuntematon attribute_code
Jos sarakeotsikko ei vastaa järjestelmän attribuuttia, sitä ei päivitetä. -
Kielikoodi
Jos merkintä[xx]
ei vastaa järjestelmän tuntemaa koodia (esim.[fi]
,[en]
), kielikohtainen arvo skipataan.
Mahdolliset virheilmoitukset:
-
"No CSV file uploaded."
Tiedostoa ei ladattu ollenkaan. -
"Cannot open CSV file."
Tiedoston avaamisessa ongelma. -
"CSV missing header row."
CSV-tiedostosta puuttuu otsikkorivi. -
"expected X columns, got Y"
Rivillä on eri määrä sarakkeita kuin otsikossa.
5. Työnkulku pähkinänkuoressa
-
Export – Lataa CSV, jossa on
sku
+ attribuuttisarakkeet. - Muokkaa – Avaa CSV editorissa (esim. Excel, LibreOffice). Vaihda, lisää tai poista arvoja.
-
Import – Lataa CSV takaisin.
- Jos arvo on tyhjä, se poistetaan.
- Jos se on numero- tai tekstiarvo, päivitetään tai luodaan rivi.
- Testaa ensin pienellä CSV:llä ennen isoja massapäivityksiä. Tarkista mahdolliset virheilmoitukset.
6. Yhteenveto
- Tuoteattribuuttien arvot voi viedä ja tuoda CSV:n avulla – tämä on erittäin nopea ja tehokas tapa hallinnoida suuria tuotelistoja.
- Otsikkorivillä on
sku
ja kullekin attribuutille omat sarakkeet. Monikieliset attribuutit näkyvät useampana sarakkeena. - Tyhjä arvo poistaa tiedon, täytetty arvo päivittää tai lisää sen.
-
sku
yhdistää CSV-rivin oikeaan tuotteeseen jaattribute_code
oikeaan kenttään. - Sarakkeiden on vastattava exportin rakennetta sarakemäärää ja nimiä myöten.
Suosittelemme lopuksi testaamaan pienellä aineistolla: näin varmistat, että CSV-tiedosto ja tarvittavat attribuutit toimivat oikein. Kun tulokset ovat halutunlaiset, voit tehdä laajemmat massapäivitykset luottavaisin mielin.