Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Ota yhteyttä
Finnish
US English (US)
FI Finnish
  • Koti
  • AI Commerce
  • Tuotteet

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.

Written by Petro Mäntylä

Updated at March 6th, 2025

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • AI Commerce
    Hallinnan etusivu Asiakkuudet Tilaukset Tilausten hallinta Kategoriat Tarjoustyökalu Tuotteet Konfiguraatiot Moduulit Raportit Paikallisasetukset ja verot Arvostelut Etusivu FAQ -työkalu Kuvagalleria Työkalut Kassa Lisätoiminnot Svelte
  • Akeneo
  • WordPress
  • Builder.io
  • Algolia
  • phpList
  • Google
  • Meta
  • Tuki
  • Tehden
  • Partnerit
  • Microsoft
  • Integraatiot
+ Lisää

Sisällysluettelo

1. CSV Export (Tuoteattribuuttien vienti) 2. CSV Import (Tuoteattribuuttien tuonti) 3. CSV-tiedoston rakenne Esimerkkitaulukko HTML-muodossa 4. Validointi & yleiset ongelmat 5. Työnkulku pähkinänkuoressa 6. Yhteenveto

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 tyyliin attribute_code[fi], attribute_code[en] jne.
    • Jos attribuutti on numeerinen (esim. int, decimal), saat vain yhden sarakkeen.

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.

Attribuuttikoodin ja kielikoodin tulkinta

  • Sarakkeen otsikko määrittää, onko kyse attribute_code[fi] (kielikohtainen) vai attribute_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. "" tai null), 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

  1. Export – Lataa CSV, jossa on sku + attribuuttisarakkeet.
  2. Muokkaa – Avaa CSV editorissa (esim. Excel, LibreOffice). Vaihda, lisää tai poista arvoja.
  3. Import – Lataa CSV takaisin.
    • Jos arvo on tyhjä, se poistetaan.
    • Jos se on numero- tai tekstiarvo, päivitetään tai luodaan rivi.
  4. 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 ja attribute_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.

tuoteominaisuuksien vienti csv-tuonti csv-vienti tuoteattribuutit monikieliset kentät massamuokkaus multi-select-attribuutit attribuuttien poistaminen eav_attribute-konfiguraatio

Oliko artikkeli hyödyllinen?

Kyllä
Ei
Anna palautetta tästä artikkelista

Yhteenkuuluvat artikkelit

  • Attribuuttien vienti ja tuonti CSV:llä AI Commercessa
  • Miten tuoda tuotedata CSV-tiedostolla AI Commerceen?
AI Commerce Logo
GDPR badge AWS badge Plus icon

Future-proof eCommerce, built in the EU

AI Commerce Cloud is developed and hosted within the EU, fully compliant with GDPR and all relevant regulations.

Solutions

Service packages Features Integrations Customers

About us

About us Support Vision Contact us

Development

Changelog Blog Implementation Partners System status
🌐 English AI Commerce Cloud FI0818073-0 Ranta-Tampellan Katu 17, 33180 Tampere, Finland info@aicommerce.fi
LinkedIn Itewiki
Privacy Policy Licensing Rights Terms of Use
© 2025 AI Commerce Cloud. All rights reserved.
Expand