Attributeiden CSV-tuonti ja -vienti tuotteiden massahallintaan

Attribuuttien vienti ja tuonti CSV-tiedostojen avulla AI Commerce:ssä nopeuttaa merkittävästi tuotteiden ominaisuuksien hallintaa. Tämän ominaisuuden ansiosta voit lisätä, muokata ja järjestellä tuoteattribuutteja kuten brändi, väri tai jarrukahvat ilman käyttöliittymässä tapahtuvaa manuaalista klikkailua. Tämä säästää aikaa ja vähentää virheiden riskiä erityisesti suurissa tuotemäärissä.

1. CSV-vienti (Attribuuttien vienti)

Attribuutit voi viedä CSV-muodossa seuraavasti: Tuotteet → Attribuutit → CSV-vienti.

Vientitiedosto sisältää kentät kuten:

attribute_code;title[fi];title[en]

Esimerkki:

Vinkki: Vie aina ensin olemassa olevat attribuutit CSV-muodossa, jotta saat muokkaamiseen varmimman pohjan oikeassa muodossa.

2. CSV-tuonti (Attribuuttien tuonti)

Voit tuoda attribuutit takaisin muokattuna käyttäen samaa rakennetta. CSV-tiedoston tulee sisältää vähintään:

• attribute_code (pakollinen kenttä, joka määrittää lisätäänkö uusi vai päivitetäänkö olemassa oleva attribuutti)

• title[fi], title[en], jne. (monikieliset nimet, lisättävissä järjestelmän tukemilla kielikoodeilla)

• is_filterable, is_comparable, is_listable, is_visible_on_front, is_html_allowed_on_front (arvot 0 tai 1)

• sort_order (kokonaisluku, joka määrittää attribuutin järjestyksen käyttöliittymässä)

• frontend_input (sallittuja arvoja ovat esimerkiksi: select, multiselect, desimaali, teksti, tekstikenttä, boolean)

Tuonti tapahtuu kohdassa Tuotteet → Attribuutit → CSV-tuonti. Onnistuneesta tuonnista näytetään järjestelmässä ilmoitus, kuten “Import Complete”.

3. Validointi ja virheiden hallinta

Tuonnin yhteydessä järjestelmä tarkistaa:

• Ovatko sarakeotsikot oikein (esim. title[fi], ei title_fi)

• Vastaavatko sarakemäärät otsikkorivin määrää

• Löytyvätkö pakolliset kentät jokaiselta riviltä

  
  

Jos virheitä löytyy, rivi joko ohitetaan tai koko tuonti keskeytyy. Tyypillisiä virheilmoituksia ovat:

• “CSV missing header row”: otsikkorivi puuttuu tai on tyhjä

• “expected X columns, got Y”: sarakkeiden määrä ei täsmää

• “Attribute already exists!”: attribute_code on jo käytössä

• Puuttuva tai väärä frontend_input: järjestelmä käyttää oletusarvoa tai hylkää rivin

  
  

4. Select- ja multiselect-optioiden käsittely

Jos attribuutti on tyyppiä select tai multiselect, siihen liittyvät valinnat (esim. brändi: Sram, Shimano, BBB) käsitellään erillisellä CSV:llä. Tuonti ja vienti onnistuu kohdissa CSV-vienti optiot ja CSV-tuonti optiot.

CSV-tiedoston rakenne esimerkiksi:

code;title[fi]

Huomioi, että nämä optiot eivät vaikuta attribuutin perusasetuksiin, vaan pelkästään valintoihin.

5. Tuetut frontend_input-tyypit

Attribuuteille tuetut kenttätyypit:

• select

• multiselect

• desimaali

• teksti

• tekstikenttä

• boolean

Boolean-tyyppiset kentät (kuten is_filterable) saavat arvot 0 tai 1.

6. Suositeltu työnkulku

1. Vie olemassa olevat attribuutit CSV:ksi hallintapaneelista

2. Avaa CSV-tiedosto (esim. Excelissä tai Google Sheetsissä)

3. Tee tarvittavat muokkaukset, kuten:

   
   

   • Päivitä title[fi] tai muuta sort_order

   • Lisää uusia rivejä uusille attribuuteille (muista yksilöllinen attribute_code)

   
   

4. Tuo CSV takaisin järjestelmään

5. Tarkista, että tuonti onnistui ilman virheilmoituksia

   
   

Yhteenveto

Attribuuttien CSV-hallinta AI Commerce:ssä on tehokas tapa hallita laajoja tuotetietoja. Samat CSV-tiedostot käyvät sekä vientiin että tuontiin. Toiminto mahdollistaa kieliversioiden, valintojen ja teknisten ominaisuuksien hallinnan keskitetysti. Suosittelemme testaamaan prosessia ensin pienellä tiedostolla ennen laajempia päivityksiä.