Attribuuttien CSV-tuonti ja -vienti tuotteiden massahallintaan

Attribuuttien vienti ja tuonti CSV-tiedostojen avulla AI Commercessa nopeuttaa merkittävästi tuotteiden ominaisuuksien hallintaa. Tämän ominaisuuden avulla voit esimerkiksi lisätä, muokata ja järjestellä tuoteattribuutteja kuten brand, color tai brake_levers ilman käyttöliittymässä tapahtuvaa manuaalista klikkailua. Tämä säästää aikaa ja vähentää virheiden riskiä etenkin suurissa tuotemäärissä.

1. CSV Export Attributes (Attribuuttien vienti)

Attribuutit voi viedä CSV-muodossa kohdasta: Products → Attributes → CSV Export Attributes.

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 Import Attributes (Attribuuttien tuonti)

Voit tuoda attribuutit takaisin muokattuna käyttämällä samaa rakennetta. CSV 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, decimal, text, textarea, boolean)

Tuonti tapahtuu kohdassa Products → Attributes → CSV Import Attributes. 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. brand: Sram, Shimano, BBB) käsitellään erillisellä CSV:llä. Tuonti ja vienti onnistuu kohdissa CSV Export Options ja CSV Import Options.

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

• decimal

• text

• textarea

• 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 Commercessa 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ä.