Tässä ohjeessa opit hallitsemaan valmistajien tietoja AI Commerce ‑alustalla CSV‑tiedoston avulla. Menetelmä nopeuttaa massamuokkauksia, vähentää manuaalisia klikkauksia ja ehkäisee virheitä, kun työ tehdään aina viennin tuottaman pohjan mukaisesti.

Mistä editoidaan

• Avaa Hallintapaneeli > Tuotteet > Valmistajat (Products > Brands).
• Yläpalkissa ovat painikkeet: Export CSV ja Import CSV. Katso lisävinkkejä.

1. CSV‑vienti (Export)

• Paina Export CSV. Järjestelmä lataa UTF‑8‑koodatun manufacturers.csv‑tiedoston, jossa kentät on eroteltu puolipisteellä ;.
• Vienti sisältää kaikki ydinkentät sekä jokaiselle aktiiviselle kielelle kaksi kuvaussaraketta (yläteksti + varsinainen kuvaus).
• Käytä tätä vientiä aina työpohjana – sarakkeiden järjestys vastaa täsmälleen tuonnin odotusta.

2. CSV‑sarakkeet (mitä mikäkin tarkoittaa)

Tunnisteet & tila

• manufacturers_code (ihmisen luettava avain)
• manufacturers_name (valmistajan nimi)
• status, display_frontpage, cms_description
  
  Käyttö: Valmistajat kohdistetaan manufactuers_code‑arvolla. Kaikki boolean‑kentät tulkitaan: 0 = Ei, mikä tahansa muu ≈ Kyllä.

Näyttö & kuvat

• sort_order, fit_value
• manufacturers_image, manufacturers_brand_page_image, manufacturers_listing_image
• Käyttö: Tyhjä = säilytä nykyinen kuva, DELETE = poista kuva, https://‑osoite = hae kuva automaattisesti mediakirjastoon.

Maa‑hyväksynnät

• country_approved_product hyväksyttyjen maiden lista pilkulla eroteltuna (ISO‑2‑koodit kuten FI,SE tai sisäiset ID:t). Viedessä arvot näytetään ISO‑koodeina; tuonnissa sekoitusta normalisoidaan talletusmuotoon.

Kielikohtaiset kuvaukset

• manufacturers_description_top[fi], manufacturers_description[fi] (ja vastaavat [...] jokaiselle kielelle).
• Tuonti päivittää vain täyttämäsi sarakkeet ja jättää muut koskematta. Uusille brändeille tyhjä jätetty kuvaus tallettuu tyhjänä merkkijonona.

3. Aineiston valmistelu (uudet vs. päivitykset)

Uudet brändit

• Vähimmäisvaatimus: manufacturers_name.
• Jos manufacturers_code jätetään tyhjäksi, järjestelmä muodostaa sen automaattisesti (pienet kirjaimet, erikoismerkit poistetaan, välilyönnit korvataan alaviivoilla).

Päivitykset

• Kohdennuksen avain: manufacturers_code.
• Toimitetut arvot ylikirjoittavat olemassa olevan tiedon. last_modified leimataan automaattisesti.
• Rivit ilman osumaa (ei ID:tä/Codea) käsitellään lisäyksinä. Jos lisäyksessä manufacturers_name puuttuu, rivi ohitetaan ja tuonti jatkuu.

4. CSV‑tuonti (Import)

Vaihe 1: Tarkistuslista näytöllä

• Varmista, että työskentelet tuoreimman viennin pohjalta.
• Pidä otsikkorivi ennallaan (sarakkeiden nimet ja järjestys).
• Muista erikoiskenttien säännöt (kuvat, ID:t, maat).

Vaihe 2: Lataa CSV

• Valitse tiedosto ja käynnistä tuonti. Muista UTF‑8 ja ;‑erotin.
• Jos otsikot eivät täsmää, lataa uusi vienti ja linjaa sarakkeet sen mukaan. Tuontiohje.

Tiedostovaatimukset

• Tiedostopäätteen oltava .csv.
• Odotettu erotin on puolipiste (;).

5. Mitä tapahtuu tuonnin jälkeen

• Tuonti hylkää tiedostot, joissa sarakemäärä ei täsmää, ja pysäyttää käsittelyn, jos otsikkorivi puuttuu/virheellinen — näin estetään puolivalmiiden rivien päätyminen kantaan.
• Valmistuttuaan järjestelmä näyttää yhteenvedon: montako riviä lisättiin, päivitettiin ja ohitettiin.

Tyypillinen virheilmoitus

• CSV ERROR on line X: found Y columns, expected Z columns. Tarkista, että erotin on ; ja arvoissa on tarvittaessa lainausmerkit. Varmista, että käytät ajantasaista vientipohjaa. Lisätietoja tuonnista.

6. Vinkit & vianetsintä

• Aloita viennistä. Käytä aina Export‑tiedostoa mallina – nopein ja varmin tapa välttää otsikko‑/järjestysvirheet. Lue vientiohje.
• Pidä otsikkorivi koskemattomana. Sarakenimien muuttaminen tai järjestyksen sekoittaminen johtaa sarake‑epäsuhta‑virheeseen.
• UTF‑8 + ;. Tallenna CSV UTF‑8‑muodossa ja käytä puolipistettä erottimena. Excelissä valitse CSV (erotin: puolipiste). Tuontiohje.
• Päivitä vain tarvittava. Tuonti muuttaa vain ne sarakkeet, joihin annat arvon; tyhjät solut eivät ylikirjoita olemassa olevaa tietoa.
• Kuvat URL:na: käytä pysyviä https‑osoitteita. Tyhjä = säilytä kuva, DELETE = poista, URL = lataa mediakirjastoon.
• Maat: käytä ensisijaisesti ISO‑2‑koodeja (FI, SE…), mutta myös sisäiset ID:t käyvät — tuonti normalisoi ne.
• Testaa pienellä erällä. Ennen isoa päivitystä tee nopea testi 1–5 rivillä, tarkista yhteenveto ja toista vasta sitten laajemmin. Yleiset CSV‑vinkit.

7. Suositeltu työnkulku (nopea muistilista)

1. Vie CSV Tuotteet > Brändit ‑näkymästä.
2. Muokkaa vain tarvittavat kentät (pidä otsikot ja järjestys).
3. Tuo CSV ja tarkista onnistumisviesti (lisätty/päivitetty/ohitettu).
4. Toista tarvittaessa seuraavalla erällä. Lisävinkit.

Yhteenveto

Brändien CSV‑hallinta on kaksisuuntainen (vienti ↔ tuonti). Käytä vientiä pohjana, pidä otsikot muuttumattomina ja muista erikoiskenttien (kuvat, maat) säännöt. Näin vältät virheet ja saat massapäivitykset maaliin nopeasti. Tutustu viennin parhaisiin käytäntöihin.

Avainsanat

• AI Commerce brändit
• CSV import export
• Products Brands hallinta
• Puolipiste erotin UTF‑8
• Kuvat URL DELETE
• ISO‑2 maat FI SE
• manufacturers_code
• Hallintapaneeli Tuotteet
• Massapäivitys brändit
• CSV virhe sarakemäärä