Johdannossa käymme läpi, miten CSV-tuonti toimii AI Commercessa ja miten varmistat tuotteiden tietojen oikeellisuuden käyttämällä UTF-8-koodausta ja tarvittaessa ulkoisia PIM-työkaluja (kuten Akeneo). Opit myös, mitkä sarakkeet voit valita tuontiin ja kuinka rajaaminen ainoastaan tarvitsemiisi kenttiin helpottaa sekä nopeuttaa työtäsi. Artikkeli antaa vinkkejä virheiden välttämiseen ja suosittelee aloittamaan pienellä testitiedostolla.

Vaiheittainen ohjeistus

Valmistele CSV-tiedosto

• Vähimmäisvaatimus on products_model-kenttä (SKU), joka yksilöi tuotteen.
• Lisää vain ne sarakkeet, joita haluat päivittää tai luoda (esim. products_price hinnan päivitykseen tai type_id päivittäminen arvoon ”hidden” piilottaaksesi tuotteita).
• Voit ladata täydellisen CSV import pohjan CSV Import Products -painikkeen takaa aukeavalta sivulta. 
   

Käytä UTF-8-koodausta

• Tallenna CSV-tiedosto aina UTF-8-muodossa.
• Avattaessa varmista, että ohjelma (esim. Excel tai tekstieditori) käsittelee tiedoston UTF-8:na.
• Näin estät merkistöongelmia, joissa ääkköset tai muut erikoismerkit rikkoutuvat.

Hyödynnä tuotuja kenttiä

• Tuetut sarakkeet: Esimerkiksi products_name[fi], products_description[fi], products_image jne.
• Järjestelmä ohittaa kentät, joita ei ole CSV:ssä. Jos sarake on mukana mutta tyhjä, kyseinen tieto tyhjennetään tietokannasta.

Huomioi tiedoston kokoraja

• CSV-tuonnin sallittu rivimäärä ei ole aina kiinteä, vaan riippuu myös tuotavan tiedoston sarakemäärästä.
• Mitä vähemmän sarakkeita tuot kerralla, sitä suuremman tiedoston järjestelmä sallii.
• Jos tiedosto ylittää sallitun rajan, jaa tuonti useampaan erään tai tuo vähemmän sarakkeita kerralla.

Hyödynnä PIM-työkaluja (esim. Akeneo)

• Akeneo integroidaan AI Commerceen natiivisti.
• Akeneolla voit hallita ja muotoilla CSV-dataa joustavammin workflow’ssasi.

Tee testisiirto ennen laajempaa päivitystä

• Vie ensin pieni määrä tuotetietoja CSV:llä.
• Vahvista, että tiedot ovat oikein ja että prosessi toimii.
• Tämän jälkeen voit turvallisesti tuoda laajemman datamäärän.
   

Ryhmätuotteisiin liittyvät kentät eivät ole täysin itsenäisiä

Kentät products_group, type_id ja hide_grouped_products vaikuttavat osittain samaan kokonaisuuteen, mutta ne eivät ohjaa samaa asiaa.

• products_group liittää tuotteen ryhmään nimen perusteella.
• type_id määrittää tuotteen tyypin.
• hide_grouped_products ohjaa vain näkyvyyttä listauksissa.

Suositus on tehdä ryhmän rakenne ja päätuote ensin Groups-näkymässä tai ryhmien CSV:llä ja käyttää Product CSV:tä vasta sen jälkeen yksittäisten tuotetietojen ylläpitoon.

CSV-dokumentaatio
Seuraavassa taulukossa on kuvattu yleisimmin käytetyt CSV-sarakkeet, niiden käyttötarkoitus sekä tyypillinen syöttömuoto. Voit CSV-tiedostoa rakentaessasi sisällyttää vain ne sarakkeet, joita haluat päivittää (esim. pelkän hinnan päivitykseen riittää products_model ja products_price).

Huom. Sarakkeet, joissa näkyy kielikoodi hakasulkeissa (esim. products_name[fi]), ovat kielispesifisiä. fi = Suomi, sv = Ruotsi, en = Englanti. Voit lisätä tai jättää pois kielisarakkeita tarpeen mukaan.

Tuonti tukee myös muita sarakkeita kaupan asetuksista ja käytössä olevista moduuleista riippuen. Näitä ovat esimerkiksi products_quantity, products_date_available, products_date_in_stock, products_date_discontinued, products_package_unit, allowed_customers, google_feed, country_approved_product, country_approved_product_type, shipping_restriction_groups, tabs ja display_profile.

display_profile asettaa tuotteelle oman Display Profile -arvon. Käytä saraketta, kun yksittäisen tuotteen tuotesivun näyttöprofiili halutaan hallita tuotetason tietona.

Yksi tuote vain kerran per tiedosto

• Jos käytät products_model-kohdistusta, sama SKU saa olla tiedostossa vain kerran.
• Jos käytät products_id-kohdistusta, sama ID saa olla tiedostossa vain kerran.
• Jos sama tuote esiintyy tiedostossa kahdesti, tuonti keskeytyy.

Mistä editoidaan?

• Voit tuoda CSV-tiedostosi AI Commerce hallintapaneelissa esimerkiksi kohdassa: Tools > Import (nimike voi vaihdella kaupan asetuksista riippuen).
• Valitse tiedostoksi oma UTF-8-koodattu CSV ja suorita tuonti.
• Tarkista, että halutut sarakkeet (kuten products_price tai products_name[fi]) vastaavat kaupan odottamia kenttiä.

Yhteenveto

CSV-tuonti AI Commercessa on joustava ja nopea tapa päivittää tuotteiden perustietoja, hintoja tai kieliversioita. Kun noudatat UTF-8-koodausta ja aloitat pienellä testitiedostolla, minimoit virheet. Tarvittaessa voit laajentaa käyttöä PIM-järjestelmillä, jolloin CSV:n hallinta helpottuu merkittävästi.