Erota tiedosto ja sen metatietorivi

Mediatiedostojen ja PDF-liitteiden hallinta CSV:llä käsittelee nykyisessä tietojenvaihdossa mediakategorioita ja tuotteiden mediatiedostojen metatietorivejä. CSV ei lataa PDF-tiedostoa ulkoisesta URL-osoitteesta eikä siirrä tiedostoa objektitallennukseen. Varmista siis erikseen, että viitattu tiedosto on jo hyväksytyssä tallennuspaikassa.

CSV sopii suuren mediatiedosto- ja mediakategoriamäärän metatietojen hallintaan yhdellä kertaa. Se ei kuitenkaan todista vanhoissa ohjeissa mainittujen uploads/, uploads/products/manuals/, uploads/products/images/, Amazon S3- tai AWS-tallennuspolkujen nykyistä toimintaa; ne vahvistetaan erillisestä tallennussopimuksesta.

Työ tehdään viemällä nykyinen CSV-tiedosto, muokkaamalla sitä taulukkolaskentaohjelmassa ja tuomalla se takaisin. Samalla tiedostolla voidaan käsitellä useita tuotteisiin liitettyjä PDF-käyttöohjeita, kuvia ja muita mediarivejä, mutta varsinaiset tiedostot pitää hallita hyväksytyssä latausprosessissa.

Käytä kahta profiiliparia: Mediakategorioiden vienti/tuonti ja Mediatiedostojen vienti/tuonti. Tee aina vienti ennen muokkausta. Vientipohja sisältää nykyiset tunnisteet, sallitut otsakkeet ja asennettujen datakielten sarakkeet.

Vie ja muokkaa mediakategorioita

Mediatiedostojen ja PDF-liitteiden hallinta CSV:llä käyttää mediakategorioissa sarakkeita categories_code, sort, delete ja name[<kieli>]. Esimerkiksi suomen ja viron sarakkeet ovat name[fi] ja name[et]. categories_code on tuonnin pakollinen otsake ja rivin tunniste.

Olemassa oleva koodi päivittää kategorian järjestyksen ja mukana olevat kielinimet. Tuntematon koodi luo uuden kategorian. Otsakkeesta puuttuva kieli säilyttää olemassa olevan nimen, mutta mukana oleva tyhjä kielisolu asettaa kyseisen arvon tyhjäksi. Tarkista siksi vientipohjan kielisarakkeet ennen tuontia.

Poista mediakategoria vain esikatselun kautta

Mediatiedostojen ja PDF-liitteiden hallinta CSV:llä poistaa olemassa olevan mediakategorian, kun delete-sarakkeessa lukee täsmälleen CONFIRM. Tyhjä arvo tarkoittaa luontia tai päivitystä; muu ei-tyhjä arvo on virhe. Tuntematonta kategoriakoodia ei voi poistaa.

categories_code,sort,delete,name[fi],name[et]
manuals,10,,Käyttöohjeet,Juhendid
old-manuals,0,CONFIRM,,

Poiston vaikutus kategoriaan liitettyihin mediariveihin pitää tarkistaa esikatselusta ja erillisestä omistajuussopimuksesta. Älä päättele pelkästä CSV-rivistä, poistetaanko tiedosto, viittaus vai vain kategoria.

Vie mediatiedostojen metatiedot

Mediatiedostojen ja PDF-liitteiden hallinta CSV:llä käyttää mediatiedostoissa perusotsakkeita media_id, products_model, categories_code, filename, url, sort, media_type, media_size ja delete. Lisäksi mukana ovat saatavilla olevien datakielten description[<kieli>]-sarakkeet, esimerkiksi description[fi].

Tuontitiedostossa pitää olla vähintään otsakkeet products_model ja filename. Tuntemattomia tai kahteen kertaan esiintyviä otsakkeita ei hyväksytä. url on sallittu vienti-/tuontiotsake, mutta nykyinen prosessori ei käytä sitä muutoksen muodostamiseen; vienti jättää sen tyhjäksi.

Päivitä olemassa oleva mediarivi

Mediatiedostojen ja PDF-liitteiden hallinta CSV:llä löytää olemassa olevan rivin ensisijaisesti positiivisella media_id-arvolla. Ilman ID:tä se voi löytää rivin tuotteen ja täsmälleen saman filename-arvon yhdistelmällä. Tuntematon annettu media_id tai products_model on virhe.

filename-otsake ja ei-tyhjä arvo ovat pakollisia myös metatietojen päivityksessä. Älä jätä solua tyhjäksi kuvauksen, järjestyksen tai kategorian päivitystä varten. Säilytä viennistä saatu tiedostonimi ja muuta vain tarkoitetut categories_code, sort, media_type, media_size tai description[<kieli>] -arvot.

Luo uusi mediarivi

Mediatiedostojen ja PDF-liitteiden hallinta CSV:llä luo uuden metatietorivin, kun media_id puuttuu eikä tuotteen ja tiedostonimen yhdistelmä vastaa olemassa olevaa riviä. products_model-arvon pitää löytää tuote ja filename-arvon pitää olla ei-tyhjä.

Sarakkeet ovat järjestyksessä media_id, products_model, categories_code, filename, url, sort, media_type, media_size, delete ja description[fi]. Uusi rivi näyttää tältä:

,SKU-123,manuals,manual-fi.pdf,,10,pdf,0.00,,Suomenkielinen käyttöohje

Jos media_type on tyhjä, prosessori johtaa sen tiedostonimen päätteestä. media_size normalisoidaan kahden desimaalin ei-negatiiviseksi arvoksi ja oletus on 0.00. CSV ei tarkista tiedoston todellista MIME-tyyppiä tai kokoa.

Älä käytä etä-URL:ää tiedostonimenä

Mediatiedostojen ja PDF-liitteiden hallinta CSV:llä hylkää filename-arvon, joka alkaa http:// tai https://. Se ei nouda etätiedostoa, tallenna sitä uploads/-kansioon eikä ylikirjoita samannimistä tiedostoa. url-sarakkeeseen kirjoittaminen ei myöskään käynnistä noutoa.

Siirrä PDF tai muu sallittu tiedosto ensin nykyisellä Tiedostonhallinta- tai hyväksytyllä mediaprosessilla. Käytä CSV:ssä vain tallennussopimuksen mukaista tiedostonimeä. Tiedostotyypit, koko, haittaohjelmatarkistus, käyttöoikeus ja julkinen URL vahvistetaan varsinaisessa latausprosessissa.

Poista mediatiedoston metatietorivi

Mediatiedostojen ja PDF-liitteiden hallinta CSV:llä hyväksyy poiston kahdella tavalla: delete=CONFIRM tai filename=DELETE. Poisto vaatii olemassa olevan mediarivin. Turvallisin muoto käyttää viennistä saatua media_id-arvoa ja delete=CONFIRM-merkintää.

media_id,products_model,filename,delete
123,SKU-123,manual-fi.pdf,CONFIRM

filename=DELETE vaatii käytännössä media_id-tunnisteen, koska sana DELETE ei löydä olemassa olevaa riviä tuotteen ja alkuperäisen tiedostonimen yhdistelmällä. Nykyinen CSV-poisto poistaa tietokannan mediarivin; objektitiedoston fyysinen poistuminen ei käy ilmi tästä prosessorista.

Esikatsele ja vahvista suoritus

Mediatiedostojen ja PDF-liitteiden hallinta CSV:llä tehdään UTF-8-muodossa vientipohjan erotinta ja otsakkeita muuttamatta. Tarkista esikatselusta luotavat, päivitettävät, poistettavat, ohitettavat ja virheelliset rivit. Korjaa kaikki virheet ennen suorituksen vahvistamista.

Aloita pienellä otoksella. Suorituksen jälkeen tarkista mediatiedostorivit, kategoriat, järjestys, kielikuvaukset ja PDF-linkin toimivuus storefrontissa. Säilytä lähtöaineisto ja suoritusraportti hyväksytyn palautus- ja auditointikäytännön mukaisesti.

Sarakeyhteenveto

Mediatiedostojen ja PDF-liitteiden hallinta CSV:llä käyttää seuraavia sopimuksia:

• Mediakategoriat: categories_code, sort, delete, name[fi], name[et] ja muut saatavilla olevat kielet.

• Mediatiedostot: media_id, products_model, categories_code, filename, url, sort, media_type, media_size, delete, description[fi] ja muut saatavilla olevat kielet.

• Kategorian poisto: olemassa oleva categories_code ja delete=CONFIRM.

• Mediarivin poisto: olemassa oleva rivi ja delete=CONFIRM tai filename=DELETE.

• Etätiedoston nouto: ei tuettu mediatiedostojen CSV-tuonnissa.

Pidä alkuperäinen vienti varmuuskopiona ja palautuspisteenä, älä muuta tunnisteita tarpeettomasti ja tarkista lopuksi sekä metatiedot että asiakkaalle näkyvä PDF-linkki. Kun muokkaat tiedostoa Excelissä tai muussa taulukkolaskentaohjelmassa, estä tuotetunnusten, koodien ja numeroiden automaattinen muotoilu. Näin laajamittainen CSV-muokkaus pysyy rajattuna, auditoitavana ja palautettavana.