Tämä ohje kattaa mediatiedostojen hallinnan CSV-työkalulla AI Commercessa. Menetelmä sopii erityisesti laajamittaisiin päivityksiin. Ennen CSV-massahallintaa suosittelemme lukemaan erillisen artikkelin tuotteiden liitetiedostojen hallinnasta AI Commercessa (esim. sallitut tiedostotyypit ja esitystavat). Tässä artikkelissa keskitytään Export- ja Import-prosesseihin sekä mediatiedostojen kategorioiden hallintaan.

Mistä editoidaan (sijainnit)

• Avaa Hallintapaneeli ja siirry polkua Products > Media Categories.
• Sivulta löytyvät painikkeet: Category CSV Export, Category CSV Import, File CSV Export, File CSV Import.

Toimintojen yleiskuva

• Category CSV Export/Import hallinnoi mediakategorioita (nimi, koodi, järjestys, käännökset).
• File CSV Export/Import hallinnoi tuotteisiin liitettyjä mediatiedostoja (tiedostonimi, kategoria, järjestys, kuvaustekstit, ym.).

Mediakategoriat CSV:llä (Category CSV Export/Import)

1. Luo tai muokkaa kategoria käyttöliittymässä antamalla nimen, koodin ja järjestysnumeron.
2. Tee Category CSV Export. Näet sarakkeet: categories_code, sort, name[<kieli>]. Kielisarakkeet vastaavat kauppasi asennettuja kieliä, esim. name[fi], name[et].
3. Muokkaa CSV:tä ja päivitä nimiä, järjestystä ja käännöksiä. Jos categories_code on olemassa, rivi päivittää kyseisen kategorian. Jos koodia ei löydy, luodaan uusi kategoria.
4. Tuo CSV (Category CSV Import) käyttäen samaa sarakeformaattia kuin eksportissa.

Mediatiedostot CSV:llä (File CSV Export/Import)

1. Luo vientipohja nopeasti: lisää ensin käsin yhdelle tuotteelle mediatiedosto, tee sitten File CSV Export.
2. Tarkista sarakkeet: media_id, products_model, categories_code, filename, url, sort, media_type, media_size, description[<kieli>].
3. Filename vs. URL:
   • url on vain lukua ja tarkastelua varten (näyttää, missä tiedosto sijaitsee). Import ei lue url-saraketta.
   • filename on ainoa tiedostokenttä, jota import tulkitsee. Voit syöttää pelkän tiedostonimen tai täyden URL-osoitteen.
4. Tiedoston lähteet:
   • Filemanager-työkalu: uploadaa PDF:t ym. ensin uploads/-kansioon, viittaa niihin CSV:ssä syöttämällä pelkän filename-arvon.
   • Ulkoinen osoite: anna filename-kenttään täysi URL, jolloin järjestelmä noutaa tiedoston ja tallentaa sen uploads/-kansioon.
   • Ylikirjoitus: jos kansiossa on jo samanniminen tiedosto, nouto ylikirjoittaa olemassa olevan tiedoston.
5. Turvallinen metatietojen päivitys ilman tiedoston vaihtamista:
   • Kun haluat muokata vain esim. description[fi], sort tai kategorian, jätä filename tyhjäksi tai poista koko filename-sarake. Tällöin aiempi tiedostoviittaus säilyy.
6. Päivitä vai luo uutta?
   • Päivitys: käytä olemassa olevan rivin media_id-arvoa.
   • Uusi rivi: jätä media_id pois. Järjestelmä luo uuden rivin uudella vapaalla ID:llä.
7. Tee File CSV Import ja tarkista tulokset.
8. Jos haluat poistaa tiedoston viittauksen, kirjoita filename-sarakkeeseen DELETE. Kaikki kirjaimet isolla. Tällöin media_id-sarakkeen tulee olla annettu - muuten tapahtuma skipataan.

CSV-muodon vaatimukset ja parhaat käytännöt

• Käytä UTF-8-enkoodausta.
• Käytä samaa erotinta ja rivinvaihtoa kuin eksporttipohjassa.
• Vältä työkaluja, jotka muuttavat muotoilua (esim. automaattiset päivämäärä- tai numeroformaatit), jotta import ei hylkää CSV:tä.
• Muista, että import lukee vain tuetut sarakkeet; ylimääräiset tai väärin nimetyt sarakkeet voivat aiheuttaa virheitä.
• Testaa ensin pienellä otoksella ennen laajaa massatuontia.

Tiedostojen tallennus ja suorituskyky (S3)

• Tiedostot tallennetaan Amazon S3 -palveluun (AWS). S3 ei toimi perinteisenä kovalevyn hakemistona, joten yhden kansion tiedostomäärällä ei ole käytännön rajoitusta.
• Suosittelemme alakategoriarakennetta uploads/-kansiossa (esim. uploads/products/manuals/, uploads/products/images/) hallinnan selkeyttämiseksi.

Categories CSV – sarakkeet (esimerkki kahdelle kielelle)

Files CSV – sarakkeet

Vinkkejä onnistuneeseen työnkulkuun

• Luo aina eksporttipohja ensin (Category tai File), ja muokkaa sitä. Sama CSV käy suoraan importtiin.
• Pidä kielisarakkeet mukana vain kielille, joita tarvitset (kielivalikoima määräytyy kaupan kieliasetusten mukaan).
• Vältä duplikaattikategorioita; jos niitä syntyy, poista ne käsin käyttöliittymästä.
• Dokumentoi tiimillesi, että vain filename vaikuttaa tuonnissa tiedoston noutoon; url on informatiivinen.

Yhteenveto

CSV-työkalu tehostaa mediatiedostojen massahallintaa AI Commercessa. Etene aina eksportista muokkaukseen ja vasta sitten importtiin, pidä formaatti täsmälleen samana, ja hyödynnä media_id-kenttää päivityksiin sekä filename-kenttää tiedoston viittaamiseen tai noutoon (myös URL:sta). Suosittelemme aloittamaan pienellä testillä ja laajentamaan, kun rakenne on kunnossa.